@mastra/factory 0.28.0-alpha.0 → 0.28.0-alpha.10

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 (746) hide show
  1. package/README.md +528 -161
  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 +54 -0
  6. package/dist/boards/board-events.d.ts.map +1 -0
  7. package/dist/boards/board-events.js +87 -0
  8. package/dist/boards/board-events.js.map +1 -0
  9. package/dist/boards/board-writes.d.ts +86 -0
  10. package/dist/boards/board-writes.d.ts.map +1 -0
  11. package/dist/boards/board-writes.js +266 -0
  12. package/dist/boards/board-writes.js.map +1 -0
  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 +56 -23
  22. package/dist/boards/define-board.d.ts.map +1 -1
  23. package/dist/boards/define-board.js +89 -45
  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 +55 -11
  29. package/dist/boards/intake-routing.d.ts.map +1 -1
  30. package/dist/boards/intake-routing.js +109 -19
  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 +14 -5
  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 +19 -3
  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 +65 -8
  44. package/dist/boards/project-boards.d.ts.map +1 -1
  45. package/dist/boards/project-boards.js +217 -26
  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 +73 -1
  64. package/dist/boards/stored-board.d.ts.map +1 -1
  65. package/dist/boards/stored-board.js +157 -11
  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/environment/build-runner.d.ts.map +1 -1
  84. package/dist/environment/build-runner.js +2 -2
  85. package/dist/environment/build-runner.js.map +1 -1
  86. package/dist/environment/build-workflow.d.ts.map +1 -1
  87. package/dist/environment/build-workflow.js +6 -5
  88. package/dist/environment/build-workflow.js.map +1 -1
  89. package/dist/environment/build.d.ts +15 -2
  90. package/dist/environment/build.d.ts.map +1 -1
  91. package/dist/environment/build.js +32 -9
  92. package/dist/environment/build.js.map +1 -1
  93. package/dist/factory.d.ts +90 -9
  94. package/dist/factory.d.ts.map +1 -1
  95. package/dist/factory.js +334 -141
  96. package/dist/factory.js.map +1 -1
  97. package/dist/feed-events.d.ts +4 -4
  98. package/dist/feed-events.d.ts.map +1 -1
  99. package/dist/feed-events.js +6 -6
  100. package/dist/feed-events.js.map +1 -1
  101. package/dist/index.d.ts +10 -3
  102. package/dist/index.d.ts.map +1 -1
  103. package/dist/index.js +7 -4
  104. package/dist/integrations/base.d.ts +12 -13
  105. package/dist/integrations/base.d.ts.map +1 -1
  106. package/dist/integrations/closing-references.d.ts +15 -0
  107. package/dist/integrations/closing-references.d.ts.map +1 -0
  108. package/dist/integrations/closing-references.js +69 -0
  109. package/dist/integrations/closing-references.js.map +1 -0
  110. package/dist/integrations/github/acceptance-labels.d.ts +4 -0
  111. package/dist/integrations/github/acceptance-labels.d.ts.map +1 -1
  112. package/dist/integrations/github/acceptance-labels.js +1 -1
  113. package/dist/integrations/github/acceptance-labels.js.map +1 -1
  114. package/dist/integrations/github/default-rules.d.ts +17 -75
  115. package/dist/integrations/github/default-rules.d.ts.map +1 -1
  116. package/dist/integrations/github/default-rules.js +134 -77
  117. package/dist/integrations/github/default-rules.js.map +1 -1
  118. package/dist/integrations/github/integration.d.ts.map +1 -1
  119. package/dist/integrations/github/integration.js +7 -3
  120. package/dist/integrations/github/integration.js.map +1 -1
  121. package/dist/integrations/github/issue-reconciler.d.ts.map +1 -1
  122. package/dist/integrations/github/issue-reconciler.js +21 -3
  123. package/dist/integrations/github/issue-reconciler.js.map +1 -1
  124. package/dist/integrations/github/provenance.js +1 -1
  125. package/dist/integrations/github/provenance.js.map +1 -1
  126. package/dist/integrations/github/pull-request-source.d.ts +8 -0
  127. package/dist/integrations/github/pull-request-source.d.ts.map +1 -0
  128. package/dist/integrations/github/pull-request-source.js +17 -0
  129. package/dist/integrations/github/pull-request-source.js.map +1 -0
  130. package/dist/integrations/github/reconcile-worker.d.ts +5 -1
  131. package/dist/integrations/github/reconcile-worker.d.ts.map +1 -1
  132. package/dist/integrations/github/reconcile-worker.js +39 -6
  133. package/dist/integrations/github/reconcile-worker.js.map +1 -1
  134. package/dist/integrations/github/review-status-comment.d.ts +61 -0
  135. package/dist/integrations/github/review-status-comment.d.ts.map +1 -0
  136. package/dist/integrations/github/review-status-comment.js +217 -0
  137. package/dist/integrations/github/review-status-comment.js.map +1 -0
  138. package/dist/integrations/github/review-status-reporter.d.ts +42 -0
  139. package/dist/integrations/github/review-status-reporter.d.ts.map +1 -0
  140. package/dist/integrations/github/review-status-reporter.js +104 -0
  141. package/dist/integrations/github/review-status-reporter.js.map +1 -0
  142. package/dist/integrations/github/review-status.d.ts +28 -0
  143. package/dist/integrations/github/review-status.d.ts.map +1 -0
  144. package/dist/integrations/github/review-status.js +95 -0
  145. package/dist/integrations/github/review-status.js.map +1 -0
  146. package/dist/integrations/github/routes.d.ts +4 -3
  147. package/dist/integrations/github/routes.d.ts.map +1 -1
  148. package/dist/integrations/github/routes.js +11 -91
  149. package/dist/integrations/github/routes.js.map +1 -1
  150. package/dist/integrations/github/rules.d.ts +92 -8
  151. package/dist/integrations/github/rules.d.ts.map +1 -1
  152. package/dist/integrations/github/rules.js +498 -103
  153. package/dist/integrations/github/rules.js.map +1 -1
  154. package/dist/integrations/github/sandbox.d.ts +10 -2
  155. package/dist/integrations/github/sandbox.d.ts.map +1 -1
  156. package/dist/integrations/github/sandbox.js +20 -4
  157. package/dist/integrations/github/sandbox.js.map +1 -1
  158. package/dist/integrations/github/session-subscriptions.js +2 -2
  159. package/dist/integrations/github/session-subscriptions.js.map +1 -1
  160. package/dist/integrations/github/token-refresh.d.ts +2 -1
  161. package/dist/integrations/github/token-refresh.d.ts.map +1 -1
  162. package/dist/integrations/github/token-refresh.js.map +1 -1
  163. package/dist/integrations/gitlab/agent-tools.js +1 -1
  164. package/dist/integrations/gitlab/default-rules.d.ts +96 -39
  165. package/dist/integrations/gitlab/default-rules.d.ts.map +1 -1
  166. package/dist/integrations/gitlab/default-rules.js +109 -46
  167. package/dist/integrations/gitlab/default-rules.js.map +1 -1
  168. package/dist/integrations/gitlab/issue-reconciler.d.ts.map +1 -1
  169. package/dist/integrations/gitlab/issue-reconciler.js +2 -1
  170. package/dist/integrations/gitlab/issue-reconciler.js.map +1 -1
  171. package/dist/integrations/gitlab/merge-request-reconciler.d.ts.map +1 -1
  172. package/dist/integrations/gitlab/merge-request-reconciler.js +12 -5
  173. package/dist/integrations/gitlab/merge-request-reconciler.js.map +1 -1
  174. package/dist/integrations/gitlab/routes.d.ts.map +1 -1
  175. package/dist/integrations/gitlab/routes.js +2 -6
  176. package/dist/integrations/gitlab/routes.js.map +1 -1
  177. package/dist/integrations/gitlab/rules.d.ts +22 -1
  178. package/dist/integrations/gitlab/rules.d.ts.map +1 -1
  179. package/dist/integrations/gitlab/rules.js +188 -34
  180. package/dist/integrations/gitlab/rules.js.map +1 -1
  181. package/dist/integrations/gitlab/session-subscriptions.js +1 -1
  182. package/dist/integrations/incidentio/agent-tools.js +6 -6
  183. package/dist/integrations/incidentio/agent-tools.js.map +1 -1
  184. package/dist/integrations/incidentio/default-rules.d.ts +1 -9
  185. package/dist/integrations/incidentio/default-rules.d.ts.map +1 -1
  186. package/dist/integrations/incidentio/default-rules.js +6 -7
  187. package/dist/integrations/incidentio/default-rules.js.map +1 -1
  188. package/dist/integrations/incidentio/issue-reconciler.d.ts.map +1 -1
  189. package/dist/integrations/incidentio/issue-reconciler.js +2 -1
  190. package/dist/integrations/incidentio/issue-reconciler.js.map +1 -1
  191. package/dist/integrations/incidentio/routes.d.ts +2 -2
  192. package/dist/integrations/incidentio/routes.d.ts.map +1 -1
  193. package/dist/integrations/incidentio/routes.js +11 -17
  194. package/dist/integrations/incidentio/routes.js.map +1 -1
  195. package/dist/integrations/incidentio/rules.d.ts +11 -4
  196. package/dist/integrations/incidentio/rules.d.ts.map +1 -1
  197. package/dist/integrations/incidentio/rules.js +52 -16
  198. package/dist/integrations/incidentio/rules.js.map +1 -1
  199. package/dist/integrations/issue-reconciler.js +1 -1
  200. package/dist/integrations/issue-reconciler.js.map +1 -1
  201. package/dist/integrations/jira/agent-tools.js +1 -1
  202. package/dist/integrations/jira/binding-scope.d.ts +5 -6
  203. package/dist/integrations/jira/binding-scope.d.ts.map +1 -1
  204. package/dist/integrations/jira/binding-scope.js +9 -11
  205. package/dist/integrations/jira/binding-scope.js.map +1 -1
  206. package/dist/integrations/jira/default-rules.d.ts +1 -9
  207. package/dist/integrations/jira/default-rules.d.ts.map +1 -1
  208. package/dist/integrations/jira/default-rules.js +6 -7
  209. package/dist/integrations/jira/default-rules.js.map +1 -1
  210. package/dist/integrations/jira/issue-reconciler.d.ts.map +1 -1
  211. package/dist/integrations/jira/issue-reconciler.js +2 -1
  212. package/dist/integrations/jira/issue-reconciler.js.map +1 -1
  213. package/dist/integrations/jira/routes.d.ts.map +1 -1
  214. package/dist/integrations/jira/routes.js +4 -9
  215. package/dist/integrations/jira/routes.js.map +1 -1
  216. package/dist/integrations/jira/rules.d.ts +11 -4
  217. package/dist/integrations/jira/rules.d.ts.map +1 -1
  218. package/dist/integrations/jira/rules.js +52 -16
  219. package/dist/integrations/jira/rules.js.map +1 -1
  220. package/dist/integrations/linear/agent-tools.d.ts +9 -1
  221. package/dist/integrations/linear/agent-tools.d.ts.map +1 -1
  222. package/dist/integrations/linear/agent-tools.js +81 -3
  223. package/dist/integrations/linear/agent-tools.js.map +1 -1
  224. package/dist/integrations/linear/default-rules.d.ts +1 -9
  225. package/dist/integrations/linear/default-rules.d.ts.map +1 -1
  226. package/dist/integrations/linear/default-rules.js +6 -7
  227. package/dist/integrations/linear/default-rules.js.map +1 -1
  228. package/dist/integrations/linear/integration.d.ts +4 -1
  229. package/dist/integrations/linear/integration.d.ts.map +1 -1
  230. package/dist/integrations/linear/integration.js +21 -1
  231. package/dist/integrations/linear/integration.js.map +1 -1
  232. package/dist/integrations/linear/issue-reconciler.d.ts.map +1 -1
  233. package/dist/integrations/linear/issue-reconciler.js +2 -1
  234. package/dist/integrations/linear/issue-reconciler.js.map +1 -1
  235. package/dist/integrations/linear/routes.d.ts +2 -1
  236. package/dist/integrations/linear/routes.d.ts.map +1 -1
  237. package/dist/integrations/linear/routes.js +16 -21
  238. package/dist/integrations/linear/routes.js.map +1 -1
  239. package/dist/integrations/linear/rules.d.ts +11 -4
  240. package/dist/integrations/linear/rules.d.ts.map +1 -1
  241. package/dist/integrations/linear/rules.js +50 -17
  242. package/dist/integrations/linear/rules.js.map +1 -1
  243. package/dist/integrations/platform/connect/routes.d.ts +7 -1
  244. package/dist/integrations/platform/connect/routes.d.ts.map +1 -1
  245. package/dist/integrations/platform/connect/routes.js +42 -5
  246. package/dist/integrations/platform/connect/routes.js.map +1 -1
  247. package/dist/integrations/platform/connect/session-tools.d.ts +12 -0
  248. package/dist/integrations/platform/connect/session-tools.d.ts.map +1 -0
  249. package/dist/integrations/platform/connect/session-tools.js +35 -0
  250. package/dist/integrations/platform/connect/session-tools.js.map +1 -0
  251. package/dist/integrations/platform/github/event-worker.d.ts +4 -1
  252. package/dist/integrations/platform/github/event-worker.d.ts.map +1 -1
  253. package/dist/integrations/platform/github/event-worker.js +39 -3
  254. package/dist/integrations/platform/github/event-worker.js.map +1 -1
  255. package/dist/integrations/platform/github/integration.d.ts +8 -0
  256. package/dist/integrations/platform/github/integration.d.ts.map +1 -1
  257. package/dist/integrations/platform/github/integration.js +132 -90
  258. package/dist/integrations/platform/github/integration.js.map +1 -1
  259. package/dist/integrations/platform/jira/agent-tools.js +1 -1
  260. package/dist/integrations/platform/jira/routes.d.ts.map +1 -1
  261. package/dist/integrations/platform/jira/routes.js +4 -9
  262. package/dist/integrations/platform/jira/routes.js.map +1 -1
  263. package/dist/integrations/platform/linear/event-worker.d.ts +1 -1
  264. package/dist/integrations/platform/linear/event-worker.d.ts.map +1 -1
  265. package/dist/integrations/platform/linear/event-worker.js +10 -1
  266. package/dist/integrations/platform/linear/event-worker.js.map +1 -1
  267. package/dist/integrations/platform/linear/integration.d.ts +1 -1
  268. package/dist/integrations/platform/linear/integration.d.ts.map +1 -1
  269. package/dist/integrations/platform/linear/integration.js +7 -8
  270. package/dist/integrations/platform/linear/integration.js.map +1 -1
  271. package/dist/integrations/slack/channel-reply-processor.d.ts +2 -0
  272. package/dist/integrations/slack/channel-reply-processor.d.ts.map +1 -1
  273. package/dist/integrations/slack/channel-reply-processor.js +6 -1
  274. package/dist/integrations/slack/channel-reply-processor.js.map +1 -1
  275. package/dist/integrations/slack/chat-tools.js +1 -1
  276. package/dist/integrations/slack/connect-route.d.ts.map +1 -1
  277. package/dist/integrations/slack/connect-route.js +1 -1
  278. package/dist/integrations/slack/connect-route.js.map +1 -1
  279. package/dist/integrations/slack/integration.d.ts +0 -2
  280. package/dist/integrations/slack/integration.d.ts.map +1 -1
  281. package/dist/integrations/slack/integration.js +2 -5
  282. package/dist/integrations/slack/integration.js.map +1 -1
  283. package/dist/integrations/slack/reply-tool.js +1 -1
  284. package/dist/integrations/slack/run-error-card.js +1 -0
  285. package/dist/integrations/slack/run-error-card.js.map +1 -1
  286. package/dist/integrations/slack/share-file-tool.js +1 -1
  287. package/dist/integrations/slack/slack.d.ts +23 -30
  288. package/dist/integrations/slack/slack.d.ts.map +1 -1
  289. package/dist/integrations/slack/slack.js +131 -125
  290. package/dist/integrations/slack/slack.js.map +1 -1
  291. package/dist/integrations/slack/voice-clips.d.ts +32 -0
  292. package/dist/integrations/slack/voice-clips.d.ts.map +1 -0
  293. package/dist/integrations/slack/voice-clips.js +201 -0
  294. package/dist/integrations/slack/voice-clips.js.map +1 -0
  295. package/dist/integrations/workos/integration.d.ts.map +1 -1
  296. package/dist/integrations/workos/integration.js +1 -3
  297. package/dist/integrations/workos/integration.js.map +1 -1
  298. package/dist/links.d.ts +1 -2
  299. package/dist/links.d.ts.map +1 -1
  300. package/dist/links.js +4 -4
  301. package/dist/links.js.map +1 -1
  302. package/dist/mcp/routes.js +2 -2
  303. package/dist/mcp/routes.js.map +1 -1
  304. package/dist/packages/_internals/workspace/dist/index.js +1 -1
  305. package/dist/provider-display-name.d.ts.map +1 -1
  306. package/dist/provider-display-name.js +1 -0
  307. package/dist/provider-display-name.js.map +1 -1
  308. package/dist/routes/attention-parked.d.ts +1 -0
  309. package/dist/routes/attention-parked.d.ts.map +1 -1
  310. package/dist/routes/attention-parked.js +2 -2
  311. package/dist/routes/attention-parked.js.map +1 -1
  312. package/dist/routes/attention-providers.d.ts +0 -25
  313. package/dist/routes/attention-providers.d.ts.map +1 -1
  314. package/dist/routes/attention-providers.js +3 -151
  315. package/dist/routes/attention-providers.js.map +1 -1
  316. package/dist/routes/attention.d.ts +0 -2
  317. package/dist/routes/attention.d.ts.map +1 -1
  318. package/dist/routes/attention.js +2 -13
  319. package/dist/routes/attention.js.map +1 -1
  320. package/dist/routes/automation-runs.d.ts +5 -1
  321. package/dist/routes/automation-runs.d.ts.map +1 -1
  322. package/dist/routes/automation-runs.js +16 -4
  323. package/dist/routes/automation-runs.js.map +1 -1
  324. package/dist/routes/board-snapshot.d.ts +15 -0
  325. package/dist/routes/board-snapshot.d.ts.map +1 -0
  326. package/dist/routes/board-snapshot.js +41 -0
  327. package/dist/routes/board-snapshot.js.map +1 -0
  328. package/dist/routes/boards.d.ts +9 -7
  329. package/dist/routes/boards.d.ts.map +1 -1
  330. package/dist/routes/boards.js +59 -145
  331. package/dist/routes/boards.js.map +1 -1
  332. package/dist/routes/config.d.ts +11 -1
  333. package/dist/routes/config.d.ts.map +1 -1
  334. package/dist/routes/config.js +122 -29
  335. package/dist/routes/config.js.map +1 -1
  336. package/dist/routes/contracts.d.ts +366 -34
  337. package/dist/routes/contracts.d.ts.map +1 -1
  338. package/dist/routes/contracts.js +179 -51
  339. package/dist/routes/contracts.js.map +1 -1
  340. package/dist/routes/feed-events.d.ts +15 -0
  341. package/dist/routes/feed-events.d.ts.map +1 -0
  342. package/dist/routes/feed-events.js +68 -0
  343. package/dist/routes/feed-events.js.map +1 -0
  344. package/dist/routes/fs.d.ts +4 -0
  345. package/dist/routes/fs.d.ts.map +1 -1
  346. package/dist/routes/fs.js +9 -8
  347. package/dist/routes/fs.js.map +1 -1
  348. package/dist/routes/intake-routes.d.ts.map +1 -1
  349. package/dist/routes/intake-routes.js +25 -13
  350. package/dist/routes/intake-routes.js.map +1 -1
  351. package/dist/routes/intake.d.ts +0 -23
  352. package/dist/routes/intake.d.ts.map +1 -1
  353. package/dist/routes/intake.js +16 -314
  354. package/dist/routes/intake.js.map +1 -1
  355. package/dist/routes/knowledge.d.ts.map +1 -1
  356. package/dist/routes/knowledge.js +2 -5
  357. package/dist/routes/knowledge.js.map +1 -1
  358. package/dist/routes/mastra-gateway.d.ts +19 -0
  359. package/dist/routes/mastra-gateway.d.ts.map +1 -0
  360. package/dist/routes/mastra-gateway.js +120 -0
  361. package/dist/routes/mastra-gateway.js.map +1 -0
  362. package/dist/routes/oauth.d.ts.map +1 -1
  363. package/dist/routes/oauth.js +1 -4
  364. package/dist/routes/oauth.js.map +1 -1
  365. package/dist/routes/projects.d.ts +3 -0
  366. package/dist/routes/projects.d.ts.map +1 -1
  367. package/dist/routes/projects.js +80 -61
  368. package/dist/routes/projects.js.map +1 -1
  369. package/dist/routes/provider-credentials.d.ts +6 -1
  370. package/dist/routes/provider-credentials.d.ts.map +1 -1
  371. package/dist/routes/provider-credentials.js +44 -3
  372. package/dist/routes/provider-credentials.js.map +1 -1
  373. package/dist/routes/route.d.ts +8 -0
  374. package/dist/routes/route.d.ts.map +1 -1
  375. package/dist/routes/route.js +5 -1
  376. package/dist/routes/route.js.map +1 -1
  377. package/dist/routes/running-packages.d.ts +13 -0
  378. package/dist/routes/running-packages.d.ts.map +1 -0
  379. package/dist/routes/running-packages.js +45 -0
  380. package/dist/routes/running-packages.js.map +1 -0
  381. package/dist/routes/sandbox-envs.d.ts +26 -0
  382. package/dist/routes/sandbox-envs.d.ts.map +1 -0
  383. package/dist/routes/sandbox-envs.js +180 -0
  384. package/dist/routes/sandbox-envs.js.map +1 -0
  385. package/dist/routes/session-access.d.ts.map +1 -1
  386. package/dist/routes/session-access.js +12 -3
  387. package/dist/routes/session-access.js.map +1 -1
  388. package/dist/routes/skills.d.ts.map +1 -1
  389. package/dist/routes/skills.js +1 -4
  390. package/dist/routes/skills.js.map +1 -1
  391. package/dist/routes/source-control-sessions.d.ts.map +1 -1
  392. package/dist/routes/source-control-sessions.js +1 -3
  393. package/dist/routes/source-control-sessions.js.map +1 -1
  394. package/dist/routes/source-control-settings.d.ts.map +1 -1
  395. package/dist/routes/source-control-settings.js +3 -2
  396. package/dist/routes/source-control-settings.js.map +1 -1
  397. package/dist/routes/surface.d.ts +13 -9
  398. package/dist/routes/surface.d.ts.map +1 -1
  399. package/dist/routes/surface.js +116 -43
  400. package/dist/routes/surface.js.map +1 -1
  401. package/dist/routes/tenant-credentials.d.ts.map +1 -1
  402. package/dist/routes/tenant-credentials.js +5 -1
  403. package/dist/routes/tenant-credentials.js.map +1 -1
  404. package/dist/routes/voice.d.ts +48 -0
  405. package/dist/routes/voice.d.ts.map +1 -0
  406. package/dist/routes/voice.js +248 -0
  407. package/dist/routes/voice.js.map +1 -0
  408. package/dist/routes/work-items.d.ts +0 -3
  409. package/dist/routes/work-items.d.ts.map +1 -1
  410. package/dist/routes/work-items.js +39 -14
  411. package/dist/routes/work-items.js.map +1 -1
  412. package/dist/rules/binding-context.d.ts.map +1 -1
  413. package/dist/rules/binding-context.js +1 -0
  414. package/dist/rules/binding-context.js.map +1 -1
  415. package/dist/rules/decision-applicability.js +1 -1
  416. package/dist/rules/dispatcher.d.ts +28 -9
  417. package/dist/rules/dispatcher.d.ts.map +1 -1
  418. package/dist/rules/dispatcher.js +734 -143
  419. package/dist/rules/dispatcher.js.map +1 -1
  420. package/dist/rules/event-rules.d.ts +71 -1
  421. package/dist/rules/event-rules.d.ts.map +1 -1
  422. package/dist/rules/event-rules.js +94 -1
  423. package/dist/rules/event-rules.js.map +1 -1
  424. package/dist/rules/index.d.ts +2 -4
  425. package/dist/rules/index.d.ts.map +1 -1
  426. package/dist/rules/index.js +2 -3
  427. package/dist/rules/phase-goal.d.ts +54 -0
  428. package/dist/rules/phase-goal.d.ts.map +1 -0
  429. package/dist/rules/phase-goal.js +70 -0
  430. package/dist/rules/phase-goal.js.map +1 -0
  431. package/dist/rules/phase-tools.d.ts +11 -0
  432. package/dist/rules/phase-tools.d.ts.map +1 -0
  433. package/dist/rules/phase-tools.js +19 -0
  434. package/dist/rules/phase-tools.js.map +1 -0
  435. package/dist/rules/processor.d.ts.map +1 -1
  436. package/dist/rules/processor.js +116 -15
  437. package/dist/rules/processor.js.map +1 -1
  438. package/dist/rules/review-source-tool.d.ts +4 -1
  439. package/dist/rules/review-source-tool.d.ts.map +1 -1
  440. package/dist/rules/review-source-tool.js +24 -4
  441. package/dist/rules/review-source-tool.js.map +1 -1
  442. package/dist/rules/rule-group.d.ts +1 -1
  443. package/dist/rules/rule-group.d.ts.map +1 -1
  444. package/dist/rules/rule-group.js +15 -6
  445. package/dist/rules/rule-group.js.map +1 -1
  446. package/dist/rules/start-coordinator.d.ts +5 -1
  447. package/dist/rules/start-coordinator.d.ts.map +1 -1
  448. package/dist/rules/start-coordinator.js +9 -3
  449. package/dist/rules/start-coordinator.js.map +1 -1
  450. package/dist/rules/tools.d.ts.map +1 -1
  451. package/dist/rules/tools.js +39 -28
  452. package/dist/rules/tools.js.map +1 -1
  453. package/dist/rules/transition-service.d.ts +10 -7
  454. package/dist/rules/transition-service.d.ts.map +1 -1
  455. package/dist/rules/transition-service.js +63 -55
  456. package/dist/rules/transition-service.js.map +1 -1
  457. package/dist/rules/types.d.ts +140 -39
  458. package/dist/rules/types.d.ts.map +1 -1
  459. package/dist/rules/types.js +7 -41
  460. package/dist/rules/types.js.map +1 -1
  461. package/dist/rules/validation.d.ts.map +1 -1
  462. package/dist/rules/validation.js +89 -4
  463. package/dist/rules/validation.js.map +1 -1
  464. package/dist/run-error.d.ts +1 -1
  465. package/dist/run-error.d.ts.map +1 -1
  466. package/dist/run-error.js +38 -5
  467. package/dist/run-error.js.map +1 -1
  468. package/dist/sandbox/sandbox-env-cache.d.ts +33 -0
  469. package/dist/sandbox/sandbox-env-cache.d.ts.map +1 -0
  470. package/dist/sandbox/sandbox-env-cache.js +140 -0
  471. package/dist/sandbox/sandbox-env-cache.js.map +1 -0
  472. package/dist/sandbox/sandbox-env.d.ts +77 -0
  473. package/dist/sandbox/sandbox-env.d.ts.map +1 -0
  474. package/dist/sandbox/sandbox-env.js +130 -0
  475. package/dist/sandbox/sandbox-env.js.map +1 -0
  476. package/dist/secret-encryption.d.ts +21 -0
  477. package/dist/secret-encryption.d.ts.map +1 -1
  478. package/dist/secret-encryption.js +31 -4
  479. package/dist/secret-encryption.js.map +1 -1
  480. package/dist/session/credential-policy.d.ts +2 -2
  481. package/dist/session/credential-policy.d.ts.map +1 -1
  482. package/dist/session/credential-policy.js +3 -3
  483. package/dist/session/credential-policy.js.map +1 -1
  484. package/dist/session/default-model-hydration.d.ts +2 -2
  485. package/dist/session/default-model-hydration.d.ts.map +1 -1
  486. package/dist/session/default-model-hydration.js +4 -4
  487. package/dist/session/default-model-hydration.js.map +1 -1
  488. package/dist/session/live-sessions.d.ts +11 -4
  489. package/dist/session/live-sessions.d.ts.map +1 -1
  490. package/dist/session/live-sessions.js +31 -10
  491. package/dist/session/live-sessions.js.map +1 -1
  492. package/dist/session/self-review-gate.d.ts +6 -4
  493. package/dist/session/self-review-gate.d.ts.map +1 -1
  494. package/dist/session/self-review-gate.js +9 -12
  495. package/dist/session/self-review-gate.js.map +1 -1
  496. package/dist/session/session-threads.d.ts +10 -3
  497. package/dist/session/session-threads.d.ts.map +1 -1
  498. package/dist/session/session-threads.js +11 -1
  499. package/dist/session/session-threads.js.map +1 -1
  500. package/dist/session/source-control-tools.d.ts +39 -13
  501. package/dist/session/source-control-tools.d.ts.map +1 -1
  502. package/dist/session/source-control-tools.js +55 -61
  503. package/dist/session/source-control-tools.js.map +1 -1
  504. package/dist/session/work-item-state-processor.d.ts +24 -0
  505. package/dist/session/work-item-state-processor.d.ts.map +1 -0
  506. package/dist/session/work-item-state-processor.js +275 -0
  507. package/dist/session/work-item-state-processor.js.map +1 -0
  508. package/dist/skills/catalog.js +1 -1
  509. package/dist/storage/domains/audit/actions.d.ts +3 -2
  510. package/dist/storage/domains/audit/actions.d.ts.map +1 -1
  511. package/dist/storage/domains/audit/actions.js +7 -5
  512. package/dist/storage/domains/audit/actions.js.map +1 -1
  513. package/dist/storage/domains/audit/domain.d.ts.map +1 -1
  514. package/dist/storage/domains/audit/domain.js +1 -3
  515. package/dist/storage/domains/audit/domain.js.map +1 -1
  516. package/dist/storage/domains/boards/base.d.ts +107 -23
  517. package/dist/storage/domains/boards/base.d.ts.map +1 -1
  518. package/dist/storage/domains/boards/base.js +201 -65
  519. package/dist/storage/domains/boards/base.js.map +1 -1
  520. package/dist/storage/domains/boards/schemas.d.ts.map +1 -1
  521. package/dist/storage/domains/boards/schemas.js +25 -1
  522. package/dist/storage/domains/boards/schemas.js.map +1 -1
  523. package/dist/storage/domains/channel-identity/base.d.ts +0 -4
  524. package/dist/storage/domains/channel-identity/base.d.ts.map +1 -1
  525. package/dist/storage/domains/channel-identity/base.js +0 -7
  526. package/dist/storage/domains/channel-identity/base.js.map +1 -1
  527. package/dist/storage/domains/intake/base.d.ts +5 -45
  528. package/dist/storage/domains/intake/base.d.ts.map +1 -1
  529. package/dist/storage/domains/intake/base.js +11 -89
  530. package/dist/storage/domains/intake/base.js.map +1 -1
  531. package/dist/storage/domains/memory-settings/base.d.ts +0 -8
  532. package/dist/storage/domains/memory-settings/base.d.ts.map +1 -1
  533. package/dist/storage/domains/memory-settings/base.js +1 -11
  534. package/dist/storage/domains/memory-settings/base.js.map +1 -1
  535. package/dist/storage/domains/projects/base.d.ts +23 -9
  536. package/dist/storage/domains/projects/base.d.ts.map +1 -1
  537. package/dist/storage/domains/projects/base.js +24 -8
  538. package/dist/storage/domains/projects/base.js.map +1 -1
  539. package/dist/storage/domains/sandbox-envs/base.d.ts +70 -0
  540. package/dist/storage/domains/sandbox-envs/base.d.ts.map +1 -0
  541. package/dist/storage/domains/sandbox-envs/base.js +227 -0
  542. package/dist/storage/domains/sandbox-envs/base.js.map +1 -0
  543. package/dist/storage/domains/voice-settings/base.d.ts +31 -0
  544. package/dist/storage/domains/voice-settings/base.d.ts.map +1 -0
  545. package/dist/storage/domains/voice-settings/base.js +81 -0
  546. package/dist/storage/domains/voice-settings/base.js.map +1 -0
  547. package/dist/storage/domains/work-items/base.d.ts +93 -24
  548. package/dist/storage/domains/work-items/base.d.ts.map +1 -1
  549. package/dist/storage/domains/work-items/base.js +413 -188
  550. package/dist/storage/domains/work-items/base.js.map +1 -1
  551. package/dist/storage/domains/work-items/board-version.d.ts +6 -2
  552. package/dist/storage/domains/work-items/board-version.d.ts.map +1 -1
  553. package/dist/storage/domains/work-items/board-version.js +20 -9
  554. package/dist/storage/domains/work-items/board-version.js.map +1 -1
  555. package/dist/storage/domains/work-items/cards.d.ts +33 -5
  556. package/dist/storage/domains/work-items/cards.d.ts.map +1 -1
  557. package/dist/storage/domains/work-items/cards.js +208 -25
  558. package/dist/storage/domains/work-items/cards.js.map +1 -1
  559. package/dist/storage/domains/work-items/legacy-review.d.ts +63 -0
  560. package/dist/storage/domains/work-items/legacy-review.d.ts.map +1 -0
  561. package/dist/storage/domains/work-items/legacy-review.js +109 -0
  562. package/dist/storage/domains/work-items/legacy-review.js.map +1 -0
  563. package/dist/storage/domains/work-items/metrics.d.ts +12 -4
  564. package/dist/storage/domains/work-items/metrics.d.ts.map +1 -1
  565. package/dist/storage/domains/work-items/metrics.js +14 -32
  566. package/dist/storage/domains/work-items/metrics.js.map +1 -1
  567. package/dist/storage/domains/work-items/work-item-schema.d.ts +6 -2
  568. package/dist/storage/domains/work-items/work-item-schema.d.ts.map +1 -1
  569. package/dist/storage/domains/work-items/work-item-schema.js +83 -27
  570. package/dist/storage/domains/work-items/work-item-schema.js.map +1 -1
  571. package/dist/timing.d.ts +1 -0
  572. package/dist/timing.d.ts.map +1 -1
  573. package/dist/timing.js +1 -1
  574. package/dist/timing.js.map +1 -1
  575. package/dist/tools/approval-tools.d.ts.map +1 -1
  576. package/dist/tools/approval-tools.js +28 -9
  577. package/dist/tools/approval-tools.js.map +1 -1
  578. package/dist/tools/index.d.ts +1 -1
  579. package/dist/tools/index.js +1 -1
  580. package/dist/tools/index.js.map +1 -1
  581. package/dist/tools/messaging-tools.d.ts +3 -0
  582. package/dist/tools/messaging-tools.d.ts.map +1 -1
  583. package/dist/tools/messaging-tools.js +2 -1
  584. package/dist/tools/messaging-tools.js.map +1 -1
  585. package/dist/tools/read-tools.d.ts +10 -6
  586. package/dist/tools/read-tools.d.ts.map +1 -1
  587. package/dist/tools/read-tools.js +89 -39
  588. package/dist/tools/read-tools.js.map +1 -1
  589. package/dist/tools/reports.d.ts +1 -0
  590. package/dist/tools/reports.d.ts.map +1 -1
  591. package/dist/tools/reports.js +2 -1
  592. package/dist/tools/reports.js.map +1 -1
  593. package/dist/tools/run-watch.d.ts +1 -1
  594. package/dist/tools/run-watch.d.ts.map +1 -1
  595. package/dist/tools/run-watch.js +1 -0
  596. package/dist/tools/run-watch.js.map +1 -1
  597. package/dist/tools/sandbox-tools.js +1 -1
  598. package/dist/tools/session-tools.d.ts +1 -1
  599. package/dist/tools/session-tools.d.ts.map +1 -1
  600. package/dist/tools/session-tools.js +1 -1
  601. package/dist/tools/session-tools.js.map +1 -1
  602. package/dist/tools/sessions-state-processor.d.ts +3 -1
  603. package/dist/tools/sessions-state-processor.d.ts.map +1 -1
  604. package/dist/tools/sessions-state-processor.js +13 -4
  605. package/dist/tools/sessions-state-processor.js.map +1 -1
  606. package/dist/tools/side-sessions.d.ts +2 -0
  607. package/dist/tools/side-sessions.d.ts.map +1 -1
  608. package/dist/tools/side-sessions.js +2 -1
  609. package/dist/tools/side-sessions.js.map +1 -1
  610. package/dist/tools/work-item-tools.d.ts +0 -3
  611. package/dist/tools/work-item-tools.d.ts.map +1 -1
  612. package/dist/tools/work-item-tools.js +10 -20
  613. package/dist/tools/work-item-tools.js.map +1 -1
  614. package/dist/voice/rate-limit.d.ts +13 -0
  615. package/dist/voice/rate-limit.d.ts.map +1 -0
  616. package/dist/voice/rate-limit.js +36 -0
  617. package/dist/voice/rate-limit.js.map +1 -0
  618. package/dist/voice/realtime.d.ts +13 -0
  619. package/dist/voice/realtime.d.ts.map +1 -0
  620. package/dist/voice/realtime.js +56 -0
  621. package/dist/voice/realtime.js.map +1 -0
  622. package/dist/voice/transcription.d.ts +51 -0
  623. package/dist/voice/transcription.d.ts.map +1 -0
  624. package/dist/voice/transcription.js +112 -0
  625. package/dist/voice/transcription.js.map +1 -0
  626. package/dist/work-item-branch.d.ts +13 -0
  627. package/dist/work-item-branch.d.ts.map +1 -1
  628. package/dist/work-item-branch.js +16 -1
  629. package/dist/work-item-branch.js.map +1 -1
  630. package/dist/work-items/create-work-item.d.ts +6 -0
  631. package/dist/work-items/create-work-item.d.ts.map +1 -1
  632. package/dist/work-items/create-work-item.js +28 -3
  633. package/dist/work-items/create-work-item.js.map +1 -1
  634. package/dist/work-items/description-context.d.ts +5 -0
  635. package/dist/work-items/description-context.d.ts.map +1 -0
  636. package/dist/work-items/description-context.js +17 -0
  637. package/dist/work-items/description-context.js.map +1 -0
  638. package/dist/work-items/providers/base.d.ts +4 -1
  639. package/dist/work-items/providers/base.d.ts.map +1 -1
  640. package/dist/work-items/providers/base.js +6 -1
  641. package/dist/work-items/providers/base.js.map +1 -1
  642. package/dist/work-items/providers/github.d.ts.map +1 -1
  643. package/dist/work-items/providers/github.js +2 -1
  644. package/dist/work-items/providers/github.js.map +1 -1
  645. package/dist/work-items/providers/gitlab.d.ts.map +1 -1
  646. package/dist/work-items/providers/gitlab.js +2 -1
  647. package/dist/work-items/providers/gitlab.js.map +1 -1
  648. package/dist/work-items/providers/jira.d.ts.map +1 -1
  649. package/dist/work-items/providers/jira.js +3 -2
  650. package/dist/work-items/providers/jira.js.map +1 -1
  651. package/dist/work-items/providers/linear.d.ts.map +1 -1
  652. package/dist/work-items/providers/linear.js +3 -2
  653. package/dist/work-items/providers/linear.js.map +1 -1
  654. package/dist/work-items/providers/types.d.ts +6 -0
  655. package/dist/work-items/providers/types.d.ts.map +1 -1
  656. package/dist/work-items/split-backfill.d.ts +13 -0
  657. package/dist/work-items/split-backfill.d.ts.map +1 -0
  658. package/dist/work-items/split-backfill.js +32 -0
  659. package/dist/work-items/split-backfill.js.map +1 -0
  660. package/dist/work-items/split-migration.d.ts +39 -2
  661. package/dist/work-items/split-migration.d.ts.map +1 -1
  662. package/dist/work-items/split-migration.js +178 -70
  663. package/dist/work-items/split-migration.js.map +1 -1
  664. package/dist/workspace.d.ts +3 -1
  665. package/dist/workspace.d.ts.map +1 -1
  666. package/dist/workspace.js +118 -34
  667. package/dist/workspace.js.map +1 -1
  668. package/factory-skills/configure-factory-rules/SKILL.md +13 -11
  669. package/factory-skills/factory-build/SKILL.md +64 -0
  670. package/factory-skills/factory-gitlab-rereview/SKILL.md +4 -4
  671. package/factory-skills/factory-gitlab-review/SKILL.md +6 -6
  672. package/factory-skills/factory-plan/SKILL.md +8 -10
  673. package/factory-skills/factory-rereview/SKILL.md +74 -28
  674. package/factory-skills/factory-review/SKILL.md +85 -29
  675. package/factory-skills/factory-self-review/SKILL.md +32 -13
  676. package/factory-skills/factory-triage/SKILL.md +36 -32
  677. package/package.json +12 -11
  678. package/dist/boards/index.js.map +0 -1
  679. package/dist/boards/pull-request-review.d.ts +0 -14
  680. package/dist/boards/pull-request-review.d.ts.map +0 -1
  681. package/dist/boards/pull-request-review.js +0 -81
  682. package/dist/boards/pull-request-review.js.map +0 -1
  683. package/dist/boards/work-tool-rules.d.ts +0 -8
  684. package/dist/boards/work-tool-rules.d.ts.map +0 -1
  685. package/dist/boards/work-tool-rules.js +0 -19
  686. package/dist/boards/work-tool-rules.js.map +0 -1
  687. package/dist/integrations/slack/emoji-shortcodes.generated.d.ts +0 -8
  688. package/dist/integrations/slack/emoji-shortcodes.generated.d.ts.map +0 -1
  689. package/dist/integrations/slack/emoji-shortcodes.generated.js +0 -1984
  690. package/dist/integrations/slack/emoji-shortcodes.generated.js.map +0 -1
  691. package/dist/integrations/slack/emoji.d.ts +0 -3
  692. package/dist/integrations/slack/emoji.d.ts.map +0 -1
  693. package/dist/integrations/slack/emoji.js +0 -11
  694. package/dist/integrations/slack/emoji.js.map +0 -1
  695. package/dist/integrations/slack/feed-publisher.d.ts +0 -26
  696. package/dist/integrations/slack/feed-publisher.d.ts.map +0 -1
  697. package/dist/integrations/slack/feed-publisher.js +0 -43
  698. package/dist/integrations/slack/feed-publisher.js.map +0 -1
  699. package/dist/routes/attention-activity.d.ts +0 -23
  700. package/dist/routes/attention-activity.d.ts.map +0 -1
  701. package/dist/routes/attention-activity.js +0 -154
  702. package/dist/routes/attention-activity.js.map +0 -1
  703. package/dist/rules/resolve.d.ts +0 -15
  704. package/dist/rules/resolve.d.ts.map +0 -1
  705. package/dist/rules/resolve.js +0 -22
  706. package/dist/rules/resolve.js.map +0 -1
  707. package/dist/storage/domains/comments/activity.d.ts +0 -40
  708. package/dist/storage/domains/comments/activity.d.ts.map +0 -1
  709. package/dist/storage/domains/comments/activity.js +0 -93
  710. package/dist/storage/domains/comments/activity.js.map +0 -1
  711. package/dist/storage/domains/comments/actor.d.ts +0 -51
  712. package/dist/storage/domains/comments/actor.d.ts.map +0 -1
  713. package/dist/storage/domains/comments/actor.js +0 -37
  714. package/dist/storage/domains/comments/actor.js.map +0 -1
  715. package/dist/storage/domains/comments/base.d.ts +0 -245
  716. package/dist/storage/domains/comments/base.d.ts.map +0 -1
  717. package/dist/storage/domains/comments/base.js +0 -539
  718. package/dist/storage/domains/comments/base.js.map +0 -1
  719. package/dist/storage/domains/comments/domain.d.ts +0 -135
  720. package/dist/storage/domains/comments/domain.d.ts.map +0 -1
  721. package/dist/storage/domains/comments/domain.js +0 -284
  722. package/dist/storage/domains/comments/domain.js.map +0 -1
  723. package/dist/storage/domains/comments/feed-context.d.ts +0 -22
  724. package/dist/storage/domains/comments/feed-context.d.ts.map +0 -1
  725. package/dist/storage/domains/comments/feed-context.js +0 -88
  726. package/dist/storage/domains/comments/feed-context.js.map +0 -1
  727. package/dist/storage/domains/comments/feed-sync.d.ts +0 -21
  728. package/dist/storage/domains/comments/feed-sync.d.ts.map +0 -1
  729. package/dist/storage/domains/comments/feed-sync.js +0 -1
  730. package/dist/storage/domains/comments/parse.d.ts +0 -23
  731. package/dist/storage/domains/comments/parse.d.ts.map +0 -1
  732. package/dist/storage/domains/comments/parse.js +0 -89
  733. package/dist/storage/domains/comments/parse.js.map +0 -1
  734. package/dist/storage/domains/comments/routes.d.ts +0 -24
  735. package/dist/storage/domains/comments/routes.d.ts.map +0 -1
  736. package/dist/storage/domains/comments/routes.js +0 -301
  737. package/dist/storage/domains/comments/routes.js.map +0 -1
  738. package/dist/storage/domains/comments/schema.d.ts +0 -5
  739. package/dist/storage/domains/comments/schema.d.ts.map +0 -1
  740. package/dist/storage/domains/comments/schema.js +0 -178
  741. package/dist/storage/domains/comments/schema.js.map +0 -1
  742. package/dist/storage/domains/comments/wire.d.ts +0 -40
  743. package/dist/storage/domains/comments/wire.d.ts.map +0 -1
  744. package/dist/storage/domains/comments/wire.js +0 -36
  745. package/dist/storage/domains/comments/wire.js.map +0 -1
  746. package/factory-skills/factory-complete-issue/SKILL.md +0 -24
@@ -1 +1 @@
1
- {"version":3,"file":"tenant-credentials.js","names":[],"sources":["../../src/routes/tenant-credentials.ts"],"sourcesContent":["/**\n * Per-tenant credential store for model resolution (deployed mode).\n *\n * The SDK's `resolveModel` asks the registered `CredentialStoreProvider` for a\n * store synchronously, so this module keeps a small per-tenant **snapshot** of\n * credentials from one exclusive scope hydrated from the `model-credentials`\n * domain. The snapshot serves the gateway's synchronous\n * path-selection reads (`get` / `getStoredApiKey`); the fetch-time\n * `getApiKey` is authoritative — it re-resolves against the domain and\n * refreshes expired OAuth tokens under the domain's row lock, so a slightly\n * stale snapshot can never send an expired token upstream.\n *\n * Snapshots are primed per request by `createTenantCredentialPrimer` (mounted\n * after the web auth gate) so the first model call of a request already sees\n * the caller's credentials. This store explicitly disables the SDK's\n * environment fallback so server-shell credentials never leak into tenants.\n */\n\nimport type {\n CredentialTenant as SdkCredentialTenant,\n CredentialTenantResolver,\n} from '@mastra/code-sdk/agents/credential-resolver';\nimport {\n prepareCredentialTenant,\n resolveTenantFromRequestContext,\n setCredentialStoreProvider,\n} from '@mastra/code-sdk/agents/credential-resolver';\nimport { getOAuthProvider, PROVIDER_DEFAULT_MODELS } from '@mastra/code-sdk/auth/storage';\nimport type { AuthCredential, CredentialStore, OAuthCredential } from '@mastra/code-sdk/auth/types';\nimport type { RequestContext } from '@mastra/core/request-context';\nimport type { MiddlewareHandler } from 'hono';\n\nimport { isOAuthCredentialExpired } from '../storage/domains/credentials/base.js';\nimport type { ModelCredentialsStorage } from '../storage/domains/credentials/base.js';\nimport { getAuthProviderId, getTenantCredentialsStorage, tenantOrgId } from './provider-credentials.js';\nimport type { RouteAuth } from './route.js';\n\n/** How long a hydrated snapshot is considered fresh. */\nconst SNAPSHOT_TTL_MS = 15_000;\n\n/** Cap on cached tenant stores; oldest-inserted evicted beyond this. */\nconst MAX_CACHED_TENANTS = 1000;\n\nexport class TenantCredentialStore implements CredentialStore {\n readonly allowEnvironmentFallback = false;\n readonly #orgId: string;\n readonly #userId: string;\n readonly #scope: SdkCredentialTenant['credentialScope'];\n readonly #credentials: ModelCredentialsStorage | undefined;\n readonly #deploymentProviders: ReadonlySet<string>;\n #snapshot = new Map<string, AuthCredential>();\n #fetchedAt = 0;\n #hydrating: Promise<void> | undefined;\n\n constructor(\n orgId: string,\n userId: string,\n credentials: ModelCredentialsStorage | undefined,\n scope: SdkCredentialTenant['credentialScope'],\n deploymentProviders: ReadonlySet<string> = new Set(),\n ) {\n this.#orgId = orgId;\n this.#userId = userId;\n this.#credentials = credentials;\n this.#scope = scope;\n this.#deploymentProviders = deploymentProviders;\n }\n\n /** Providers the operator opted in to run on the server process's own credentials. */\n allowsDeploymentCredentials(provider: string): boolean {\n return this.#deploymentProviders.has(provider);\n }\n\n /** Hydrate the snapshot when stale; coalesces concurrent callers. */\n async ensureFresh(now = Date.now()): Promise<void> {\n if (now - this.#fetchedAt < SNAPSHOT_TTL_MS) return;\n this.#hydrating ??= this.#hydrate().finally(() => {\n this.#hydrating = undefined;\n });\n await this.#hydrating;\n }\n\n async #hydrate(): Promise<void> {\n const storage = await getTenantCredentialsStorage(this.#credentials);\n if (!storage) return; // Keep the last tenant-scoped snapshot.\n const records = await storage.listCredentials(this.#orgId, this.#userId);\n const next = new Map<string, AuthCredential>();\n const storageScope = this.#scope === 'factory' ? 'org' : 'user';\n for (const record of records.filter(r => r.scope === storageScope)) {\n next.set(record.provider, record.credential);\n }\n this.#snapshot = next;\n this.#fetchedAt = Date.now();\n }\n\n /** Sync by contract; kicks a background re-hydrate when the snapshot is stale. */\n reload(): void {\n if (Date.now() - this.#fetchedAt >= SNAPSHOT_TTL_MS) {\n void this.ensureFresh().catch(() => {});\n }\n }\n\n get(provider: string): AuthCredential | undefined {\n return this.#snapshot.get(provider);\n }\n\n getStoredApiKey(provider: string): string | undefined {\n const cred = this.#snapshot.get(provider);\n return cred?.type === 'api_key' ? cred.key : undefined;\n }\n\n /**\n * Authoritative fetch-time resolution: re-reads only the selected scope and\n * refreshes expired OAuth tokens under the domain's row lock. Mirrors\n * `AuthStorage.getApiKey` semantics: `undefined` on missing credential or\n * failed refresh (caller surfaces a re-login error).\n */\n async getApiKey(provider: string): Promise<string | undefined> {\n const storage = await getTenantCredentialsStorage(this.#credentials);\n if (!storage) {\n // Domain unavailable: best effort from the snapshot; expired OAuth\n // tokens cannot be refreshed without the domain's lock.\n const cred = this.#snapshot.get(provider);\n if (cred?.type === 'api_key') return cred.key;\n if (cred?.type === 'oauth' && !isOAuthCredentialExpired(cred)) {\n return getOAuthProvider(provider)?.getApiKey(cred);\n }\n return undefined;\n }\n\n const resolved = await storage.resolveCredential(\n this.#orgId,\n this.#userId,\n provider,\n this.#scope === 'factory' ? 'org' : 'user',\n );\n if (!resolved) {\n this.#snapshot.delete(provider);\n return undefined;\n }\n this.#snapshot.set(provider, resolved.credential);\n\n if (resolved.credential.type === 'api_key') {\n return resolved.credential.key;\n }\n\n const oauthProvider = getOAuthProvider(provider);\n if (!oauthProvider) return undefined;\n\n if (!isOAuthCredentialExpired(resolved.credential)) {\n return oauthProvider.getApiKey(resolved.credential);\n }\n\n return this.#refreshOAuth(storage, resolved.scope, provider, isOAuthCredentialExpired);\n }\n\n /**\n * Refresh the OAuth credential even though it hasn't expired. The\n * account-rotation processor calls this once when the provider rejects the\n * token (401/403): providers can revoke an access token before the expiry\n * recorded at sign-in. Only the token this store last served is replaced, so\n * when another session or replica already refreshed it the newer token is\n * reused instead of rotating the refresh token again.\n */\n async forceRefreshActiveAccount(provider: string): Promise<string | undefined> {\n const storage = await getTenantCredentialsStorage(this.#credentials);\n if (!storage) return undefined;\n const served = this.#snapshot.get(provider);\n const resolved = await storage.resolveCredential(\n this.#orgId,\n this.#userId,\n provider,\n this.#scope === 'factory' ? 'org' : 'user',\n );\n if (resolved?.credential.type !== 'oauth') return undefined;\n const rejectedAccess = served?.type === 'oauth' ? served.access : resolved.credential.access;\n return this.#refreshOAuth(\n storage,\n resolved.scope,\n provider,\n current => isOAuthCredentialExpired(current) || current.access === rejectedAccess,\n );\n }\n\n async #refreshOAuth(\n storage: ModelCredentialsStorage,\n scope: 'user' | 'org',\n provider: string,\n needsRefresh: (current: OAuthCredential) => boolean,\n ): Promise<string | undefined> {\n const oauthProvider = getOAuthProvider(provider);\n if (!oauthProvider) return undefined;\n // Refresh at the scope the credential actually lives at (OAuth rows are\n // user-scoped by policy, but resolve defensively from the record).\n const rowTenant = scope === 'user' ? { orgId: this.#orgId, userId: this.#userId } : { orgId: this.#orgId };\n try {\n const refreshed = await storage.refreshOAuth(\n rowTenant,\n provider,\n async current => ({\n type: 'oauth' as const,\n ...(await oauthProvider.refreshToken(current)),\n }),\n needsRefresh,\n );\n if (!refreshed) return undefined;\n this.#snapshot.set(provider, refreshed);\n return oauthProvider.getApiKey(refreshed);\n } catch {\n // Refresh failed — user needs to re-login (same posture as AuthStorage).\n return undefined;\n }\n }\n}\n\nconst tenantStores = new Map<string, TenantCredentialStore>();\nlet registeredCredentials: ModelCredentialsStorage | undefined;\nlet registeredDeploymentProviders: ReadonlySet<string> = new Set();\n\nfunction storeFor(tenant: SdkCredentialTenant, credentials: ModelCredentialsStorage): TenantCredentialStore {\n const orgId = tenantOrgId(tenant);\n const key = `${orgId}\\u0000${tenant.userId}\\u0000${tenant.credentialScope}`;\n let store = tenantStores.get(key);\n if (!store) {\n if (tenantStores.size >= MAX_CACHED_TENANTS) {\n const oldest = tenantStores.keys().next().value;\n if (oldest !== undefined) tenantStores.delete(oldest);\n }\n store = new TenantCredentialStore(\n orgId,\n tenant.userId,\n credentials,\n tenant.credentialScope,\n registeredDeploymentProviders,\n );\n tenantStores.set(key, store);\n }\n return store;\n}\n\n/**\n * Register the web tenant credential store provider with the SDK. Called by\n * the factory after storage init with the `model-credentials` domain handle;\n * from then on `resolveModel` uses per-tenant credentials and the SDK skips\n * the `loadStoredApiKeysIntoEnv` env side-channel. `deploymentProviders` are\n * the providers the operator opted in to authenticate with the server\n * process's own credentials (see `MastraFactoryConfig.deploymentModelProviders`).\n */\nexport function registerTenantCredentialResolver(\n credentials: ModelCredentialsStorage,\n deploymentProviders: ReadonlySet<string> = new Set(),\n resolveTenant?: CredentialTenantResolver,\n): void {\n registeredCredentials = credentials;\n registeredDeploymentProviders = deploymentProviders;\n tenantStores.clear();\n setCredentialStoreProvider(\n tenant => storeFor(tenant, credentials),\n resolveTenant\n ? async requestContext => {\n const tenant = await resolveTenant(requestContext);\n if (tenant) await storeFor(tenant, credentials).ensureFresh();\n return tenant;\n }\n : undefined,\n );\n}\n\n/**\n * Prime the tenant stores for a request context built outside the web layer,\n * such as a webhook-triggered session run. The auth middleware does this for\n * HTTP requests; a run that starts without one would otherwise resolve its\n * model against an empty snapshot and fail closed. No-op before registration.\n */\nexport async function primeTenantCredentialsForRequestContext(requestContext: RequestContext): Promise<void> {\n if (!registeredCredentials) return;\n await prepareCredentialTenant(requestContext);\n const tenant = resolveTenantFromRequestContext(requestContext);\n if (!tenant) return;\n await storeFor(tenant, registeredCredentials).ensureFresh();\n}\n\n/** Prime one already-resolved Factory session tenant before entering the agent run. */\nexport async function primeTenantCredentialsForTenant(tenant: SdkCredentialTenant): Promise<void> {\n if (!registeredCredentials) return;\n try {\n await storeFor(tenant, registeredCredentials).ensureFresh();\n } catch (error) {\n console.warn('[factory] Failed to prime scoped tenant model credentials', {\n orgId: tenant.orgId,\n userId: tenant.userId,\n credentialScope: tenant.credentialScope,\n error,\n });\n }\n}\n\n/**\n * The model a session should fall back to when its scope has no chosen default:\n * the provider default (`PROVIDER_DEFAULT_MODELS`) of the first provider the\n * tenant is connected to. Returns `undefined` when `currentModelId` is already\n * usable, when no connected provider has a default, or before registration.\n */\nexport async function resolveTenantProviderDefaultModel(\n tenant: SdkCredentialTenant,\n currentModelId: string | undefined,\n): Promise<string | undefined> {\n if (!registeredCredentials) return undefined;\n const store = storeFor(tenant, registeredCredentials);\n await store.ensureFresh();\n const usable = (modelId: string) => {\n const provider = modelId.split('/')[0] ?? '';\n return store.get(getAuthProviderId(provider)) !== undefined || store.allowsDeploymentCredentials(provider);\n };\n if (currentModelId && usable(currentModelId)) return undefined;\n return Object.entries(PROVIDER_DEFAULT_MODELS).find(([provider]) => store.get(provider) !== undefined)?.[1];\n}\n\n/** Test hook: clear registration and cached tenant snapshots. */\nexport function resetTenantCredentialResolverForTests(): void {\n setCredentialStoreProvider(undefined);\n registeredCredentials = undefined;\n registeredDeploymentProviders = new Set();\n tenantStores.clear();\n}\n\n/**\n * Drop cached snapshots after a credential write so the change is visible to\n * the next model call immediately instead of after the snapshot TTL. An org\n * write affects every member's resolved view, so all stores under the org are\n * invalidated; a user write only drops that user's store.\n */\nexport function invalidateTenantCredentialSnapshots(tenant: { orgId: string; userId?: string }): void {\n if (tenant.userId) {\n tenantStores.delete(`${tenant.orgId}\\u0000${tenant.userId}\\u0000user`);\n tenantStores.delete(`${tenant.orgId}\\u0000${tenant.userId}\\u0000factory`);\n return;\n }\n for (const key of tenantStores.keys()) {\n if (key.startsWith(`${tenant.orgId}\\u0000`)) tenantStores.delete(key);\n }\n}\n\n/**\n * Middleware mounted after the web auth gate: primes both exclusive credential\n * scopes because the HTTP principal is known before the controller session is.\n * Cheap when fresh because each store has a TTL.\n */\nexport async function primeTenantCredentials({\n tenant,\n credentials,\n}: {\n tenant: Pick<SdkCredentialTenant, 'orgId' | 'userId'> & Partial<Pick<SdkCredentialTenant, 'credentialScope'>>;\n credentials: ModelCredentialsStorage;\n}): Promise<void> {\n await Promise.all([\n storeFor({ ...tenant, credentialScope: 'user' }, credentials).ensureFresh(),\n storeFor({ ...tenant, credentialScope: 'factory' }, credentials).ensureFresh(),\n ]);\n}\n\nexport function createTenantCredentialPrimer({\n auth,\n credentials,\n}: {\n auth: RouteAuth;\n credentials: ModelCredentialsStorage;\n}): MiddlewareHandler {\n return async (c, next) => {\n const tenant = auth.tenant(c);\n if (tenant) {\n try {\n await primeTenantCredentials({ tenant, credentials });\n } catch (error) {\n console.warn('[factory] Failed to prime tenant model credentials', {\n orgId: tenant.orgId,\n userId: tenant.userId,\n error,\n });\n }\n }\n await next();\n };\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"tenant-credentials.js","names":[],"sources":["../../src/routes/tenant-credentials.ts"],"sourcesContent":["/**\n * Per-tenant credential store for model resolution (deployed mode).\n *\n * The SDK's `resolveModel` asks the registered `CredentialStoreProvider` for a\n * store synchronously, so this module keeps a small per-tenant **snapshot** of\n * credentials from one exclusive scope hydrated from the `model-credentials`\n * domain. The snapshot serves the gateway's synchronous\n * path-selection reads (`get` / `getStoredApiKey`); the fetch-time\n * `getApiKey` is authoritative — it re-resolves against the domain and\n * refreshes expired OAuth tokens under the domain's row lock, so a slightly\n * stale snapshot can never send an expired token upstream.\n *\n * Snapshots are primed per request by `createTenantCredentialPrimer` (mounted\n * after the web auth gate) so the first model call of a request already sees\n * the caller's credentials. This store explicitly disables the SDK's\n * environment fallback so server-shell credentials never leak into tenants.\n */\n\nimport type {\n CredentialTenant as SdkCredentialTenant,\n CredentialTenantResolver,\n} from '@mastra/code-sdk/agents/credential-resolver';\nimport {\n prepareCredentialTenant,\n resolveTenantFromRequestContext,\n setCredentialStoreProvider,\n} from '@mastra/code-sdk/agents/credential-resolver';\nimport { getOAuthProvider, PROVIDER_DEFAULT_MODELS } from '@mastra/code-sdk/auth/storage';\nimport type { AuthCredential, CredentialStore, OAuthCredential } from '@mastra/code-sdk/auth/types';\nimport { MASTRA_GATEWAY_PROVIDER } from '@mastra/code-sdk/onboarding/settings';\nimport { MASTRA_GATEWAY_PREFIX } from '@mastra/code-sdk/providers/model-ids';\nimport type { RequestContext } from '@mastra/core/request-context';\nimport type { MiddlewareHandler } from 'hono';\n\nimport { isOAuthCredentialExpired } from '../storage/domains/credentials/base.js';\nimport type { ModelCredentialsStorage } from '../storage/domains/credentials/base.js';\nimport { getAuthProviderId, getTenantCredentialsStorage, tenantOrgId } from './provider-credentials.js';\nimport type { RouteAuth } from './route.js';\n\n/** How long a hydrated snapshot is considered fresh. */\nconst SNAPSHOT_TTL_MS = 15_000;\n\n/** Cap on cached tenant stores; oldest-inserted evicted beyond this. */\nconst MAX_CACHED_TENANTS = 1000;\n\nexport class TenantCredentialStore implements CredentialStore {\n readonly allowEnvironmentFallback = false;\n readonly #orgId: string;\n readonly #userId: string;\n readonly #scope: SdkCredentialTenant['credentialScope'];\n readonly #credentials: ModelCredentialsStorage | undefined;\n readonly #deploymentProviders: ReadonlySet<string>;\n #snapshot = new Map<string, AuthCredential>();\n #fetchedAt = 0;\n #hydrating: Promise<void> | undefined;\n\n constructor(\n orgId: string,\n userId: string,\n credentials: ModelCredentialsStorage | undefined,\n scope: SdkCredentialTenant['credentialScope'],\n deploymentProviders: ReadonlySet<string> = new Set(),\n ) {\n this.#orgId = orgId;\n this.#userId = userId;\n this.#credentials = credentials;\n this.#scope = scope;\n this.#deploymentProviders = deploymentProviders;\n }\n\n /** Providers the operator opted in to run on the server process's own credentials. */\n allowsDeploymentCredentials(provider: string): boolean {\n return this.#deploymentProviders.has(provider);\n }\n\n /** Hydrate the snapshot when stale; coalesces concurrent callers. */\n async ensureFresh(now = Date.now()): Promise<void> {\n if (now - this.#fetchedAt < SNAPSHOT_TTL_MS) return;\n this.#hydrating ??= this.#hydrate().finally(() => {\n this.#hydrating = undefined;\n });\n await this.#hydrating;\n }\n\n async #hydrate(): Promise<void> {\n const storage = await getTenantCredentialsStorage(this.#credentials);\n if (!storage) return; // Keep the last tenant-scoped snapshot.\n const records = await storage.listCredentials(this.#orgId, this.#userId);\n const next = new Map<string, AuthCredential>();\n const storageScope = this.#scope === 'factory' ? 'org' : 'user';\n for (const record of records.filter(r => r.scope === storageScope)) {\n next.set(record.provider, record.credential);\n }\n this.#snapshot = next;\n this.#fetchedAt = Date.now();\n }\n\n /** Sync by contract; kicks a background re-hydrate when the snapshot is stale. */\n reload(): void {\n if (Date.now() - this.#fetchedAt >= SNAPSHOT_TTL_MS) {\n void this.ensureFresh().catch(() => {});\n }\n }\n\n get(provider: string): AuthCredential | undefined {\n return this.#snapshot.get(provider);\n }\n\n getStoredApiKey(provider: string): string | undefined {\n const cred = this.#snapshot.get(provider);\n return cred?.type === 'api_key' ? cred.key : undefined;\n }\n\n /**\n * Authoritative fetch-time resolution: re-reads only the selected scope and\n * refreshes expired OAuth tokens under the domain's row lock. Mirrors\n * `AuthStorage.getApiKey` semantics: `undefined` on missing credential or\n * failed refresh (caller surfaces a re-login error).\n */\n async getApiKey(provider: string): Promise<string | undefined> {\n const storage = await getTenantCredentialsStorage(this.#credentials);\n if (!storage) {\n // Domain unavailable: best effort from the snapshot; expired OAuth\n // tokens cannot be refreshed without the domain's lock.\n const cred = this.#snapshot.get(provider);\n if (cred?.type === 'api_key') return cred.key;\n if (cred?.type === 'oauth' && !isOAuthCredentialExpired(cred)) {\n return getOAuthProvider(provider)?.getApiKey(cred);\n }\n return undefined;\n }\n\n const resolved = await storage.resolveCredential(\n this.#orgId,\n this.#userId,\n provider,\n this.#scope === 'factory' ? 'org' : 'user',\n );\n if (!resolved) {\n this.#snapshot.delete(provider);\n return undefined;\n }\n this.#snapshot.set(provider, resolved.credential);\n\n if (resolved.credential.type === 'api_key') {\n return resolved.credential.key;\n }\n\n const oauthProvider = getOAuthProvider(provider);\n if (!oauthProvider) return undefined;\n\n if (!isOAuthCredentialExpired(resolved.credential)) {\n return oauthProvider.getApiKey(resolved.credential);\n }\n\n return this.#refreshOAuth(storage, resolved.scope, provider, isOAuthCredentialExpired);\n }\n\n /**\n * Refresh the OAuth credential even though it hasn't expired. The\n * account-rotation processor calls this once when the provider rejects the\n * token (401/403): providers can revoke an access token before the expiry\n * recorded at sign-in. Only the token this store last served is replaced, so\n * when another session or replica already refreshed it the newer token is\n * reused instead of rotating the refresh token again.\n */\n async forceRefreshActiveAccount(provider: string): Promise<string | undefined> {\n const storage = await getTenantCredentialsStorage(this.#credentials);\n if (!storage) return undefined;\n const served = this.#snapshot.get(provider);\n const resolved = await storage.resolveCredential(\n this.#orgId,\n this.#userId,\n provider,\n this.#scope === 'factory' ? 'org' : 'user',\n );\n if (resolved?.credential.type !== 'oauth') return undefined;\n const rejectedAccess = served?.type === 'oauth' ? served.access : resolved.credential.access;\n return this.#refreshOAuth(\n storage,\n resolved.scope,\n provider,\n current => isOAuthCredentialExpired(current) || current.access === rejectedAccess,\n );\n }\n\n async #refreshOAuth(\n storage: ModelCredentialsStorage,\n scope: 'user' | 'org',\n provider: string,\n needsRefresh: (current: OAuthCredential) => boolean,\n ): Promise<string | undefined> {\n const oauthProvider = getOAuthProvider(provider);\n if (!oauthProvider) return undefined;\n // Refresh at the scope the credential actually lives at (OAuth rows are\n // user-scoped by policy, but resolve defensively from the record).\n const rowTenant = scope === 'user' ? { orgId: this.#orgId, userId: this.#userId } : { orgId: this.#orgId };\n try {\n const refreshed = await storage.refreshOAuth(\n rowTenant,\n provider,\n async current => ({\n type: 'oauth' as const,\n ...(await oauthProvider.refreshToken(current)),\n }),\n needsRefresh,\n );\n if (!refreshed) return undefined;\n this.#snapshot.set(provider, refreshed);\n return oauthProvider.getApiKey(refreshed);\n } catch {\n // Refresh failed — user needs to re-login (same posture as AuthStorage).\n return undefined;\n }\n }\n}\n\nconst tenantStores = new Map<string, TenantCredentialStore>();\nlet registeredCredentials: ModelCredentialsStorage | undefined;\nlet registeredDeploymentProviders: ReadonlySet<string> = new Set();\n\nfunction storeFor(tenant: SdkCredentialTenant, credentials: ModelCredentialsStorage): TenantCredentialStore {\n const orgId = tenantOrgId(tenant);\n const key = `${orgId}\\u0000${tenant.userId}\\u0000${tenant.credentialScope}`;\n let store = tenantStores.get(key);\n if (!store) {\n if (tenantStores.size >= MAX_CACHED_TENANTS) {\n const oldest = tenantStores.keys().next().value;\n if (oldest !== undefined) tenantStores.delete(oldest);\n }\n store = new TenantCredentialStore(\n orgId,\n tenant.userId,\n credentials,\n tenant.credentialScope,\n registeredDeploymentProviders,\n );\n tenantStores.set(key, store);\n }\n return store;\n}\n\n/**\n * Register the web tenant credential store provider with the SDK. Called by\n * the factory after storage init with the `model-credentials` domain handle;\n * from then on `resolveModel` uses per-tenant credentials and the SDK skips\n * the `loadStoredApiKeysIntoEnv` env side-channel. `deploymentProviders` are\n * the providers the operator opted in to authenticate with the server\n * process's own credentials (see `MastraFactoryConfig.deploymentModelProviders`).\n */\nexport function registerTenantCredentialResolver(\n credentials: ModelCredentialsStorage,\n deploymentProviders: ReadonlySet<string> = new Set(),\n resolveTenant?: CredentialTenantResolver,\n): void {\n registeredCredentials = credentials;\n registeredDeploymentProviders = deploymentProviders;\n tenantStores.clear();\n setCredentialStoreProvider(\n tenant => storeFor(tenant, credentials),\n resolveTenant\n ? async requestContext => {\n const tenant = await resolveTenant(requestContext);\n if (tenant) await storeFor(tenant, credentials).ensureFresh();\n return tenant;\n }\n : undefined,\n );\n}\n\n/**\n * Prime the tenant stores for a request context built outside the web layer,\n * such as a webhook-triggered session run. The auth middleware does this for\n * HTTP requests; a run that starts without one would otherwise resolve its\n * model against an empty snapshot and fail closed. No-op before registration.\n */\nexport async function primeTenantCredentialsForRequestContext(requestContext: RequestContext): Promise<void> {\n if (!registeredCredentials) return;\n await prepareCredentialTenant(requestContext);\n const tenant = resolveTenantFromRequestContext(requestContext);\n if (!tenant) return;\n await storeFor(tenant, registeredCredentials).ensureFresh();\n}\n\n/** Prime one already-resolved Factory session tenant before entering the agent run. */\nexport async function primeTenantCredentialsForTenant(tenant: SdkCredentialTenant): Promise<void> {\n if (!registeredCredentials) return;\n try {\n await storeFor(tenant, registeredCredentials).ensureFresh();\n } catch (error) {\n console.warn('[factory] Failed to prime scoped tenant model credentials', {\n orgId: tenant.orgId,\n userId: tenant.userId,\n credentialScope: tenant.credentialScope,\n error,\n });\n }\n}\n\n/**\n * The model a session should fall back to when its scope has no chosen default:\n * the provider default (`PROVIDER_DEFAULT_MODELS`) of the first provider the\n * tenant is connected to. Returns `undefined` when `currentModelId` is already\n * usable, when no connected provider has a default, or before registration.\n */\nexport async function resolveTenantProviderDefaultModel(\n tenant: SdkCredentialTenant,\n currentModelId: string | undefined,\n): Promise<string | undefined> {\n if (!registeredCredentials) return undefined;\n const store = storeFor(tenant, registeredCredentials);\n await store.ensureFresh();\n const usable = (modelId: string) => {\n const provider = modelId.split('/')[0] ?? '';\n return store.get(getAuthProviderId(provider)) !== undefined || store.allowsDeploymentCredentials(provider);\n };\n if (currentModelId && usable(currentModelId)) return undefined;\n const providerDefault = Object.entries(PROVIDER_DEFAULT_MODELS).find(\n ([provider]) => store.get(provider) !== undefined,\n )?.[1];\n if (providerDefault) return providerDefault;\n return store.get(MASTRA_GATEWAY_PROVIDER) ? `${MASTRA_GATEWAY_PREFIX}anthropic/claude-opus-5.5` : undefined;\n}\n\n/** Test hook: clear registration and cached tenant snapshots. */\nexport function resetTenantCredentialResolverForTests(): void {\n setCredentialStoreProvider(undefined);\n registeredCredentials = undefined;\n registeredDeploymentProviders = new Set();\n tenantStores.clear();\n}\n\n/**\n * Drop cached snapshots after a credential write so the change is visible to\n * the next model call immediately instead of after the snapshot TTL. An org\n * write affects every member's resolved view, so all stores under the org are\n * invalidated; a user write only drops that user's store.\n */\nexport function invalidateTenantCredentialSnapshots(tenant: { orgId: string; userId?: string }): void {\n if (tenant.userId) {\n tenantStores.delete(`${tenant.orgId}\\u0000${tenant.userId}\\u0000user`);\n tenantStores.delete(`${tenant.orgId}\\u0000${tenant.userId}\\u0000factory`);\n return;\n }\n for (const key of tenantStores.keys()) {\n if (key.startsWith(`${tenant.orgId}\\u0000`)) tenantStores.delete(key);\n }\n}\n\n/**\n * Middleware mounted after the web auth gate: primes both exclusive credential\n * scopes because the HTTP principal is known before the controller session is.\n * Cheap when fresh because each store has a TTL.\n */\nexport async function primeTenantCredentials({\n tenant,\n credentials,\n}: {\n tenant: Pick<SdkCredentialTenant, 'orgId' | 'userId'> & Partial<Pick<SdkCredentialTenant, 'credentialScope'>>;\n credentials: ModelCredentialsStorage;\n}): Promise<void> {\n await Promise.all([\n storeFor({ ...tenant, credentialScope: 'user' }, credentials).ensureFresh(),\n storeFor({ ...tenant, credentialScope: 'factory' }, credentials).ensureFresh(),\n ]);\n}\n\nexport function createTenantCredentialPrimer({\n auth,\n credentials,\n}: {\n auth: RouteAuth;\n credentials: ModelCredentialsStorage;\n}): MiddlewareHandler {\n return async (c, next) => {\n const tenant = auth.tenant(c);\n if (tenant) {\n try {\n await primeTenantCredentials({ tenant, credentials });\n } catch (error) {\n console.warn('[factory] Failed to prime tenant model credentials', {\n orgId: tenant.orgId,\n userId: tenant.userId,\n error,\n });\n }\n }\n await next();\n };\n}\n"],"mappings":"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"}
@@ -0,0 +1,48 @@
1
+ import type { AuthStorage } from '@mastra/code-sdk/auth/storage';
2
+ import type { ModelCredentialsStorage } from '../storage/domains/credentials/base.js';
3
+ import type { FactoryProjectsStorage } from '../storage/domains/projects/base.js';
4
+ import type { VoiceSettingsStorage } from '../storage/domains/voice-settings/base.js';
5
+ import type { RealtimeSession } from '../voice/realtime.js';
6
+ import type { VoicePolicy } from '../voice/transcription.js';
7
+ import { Route } from './route.js';
8
+ import type { RouteDependencies } from './route.js';
9
+ export interface VoiceRoutesDeps extends RouteDependencies {
10
+ authStorage?: AuthStorage;
11
+ modelCredentials?: ModelCredentialsStorage;
12
+ voiceSettings: VoiceSettingsStorage;
13
+ factoryProjects: FactoryProjectsStorage;
14
+ }
15
+ type ModelChoice = {
16
+ provider: string;
17
+ model: string;
18
+ };
19
+ export interface VoiceSettingsResponse {
20
+ scope: VoicePolicy['scope'];
21
+ selected: ModelChoice | null;
22
+ canEdit: boolean;
23
+ effective: ModelChoice | null;
24
+ models: Array<ModelChoice & {
25
+ label: string;
26
+ }>;
27
+ /** `fromEnv`: local mode reads the key from the server environment, so it cannot be updated or removed here. */
28
+ keys: Array<{
29
+ provider: string;
30
+ envVar: string | undefined;
31
+ saved: boolean;
32
+ fromEnv: boolean;
33
+ }>;
34
+ }
35
+ export type TranscribeResponse = ModelChoice & {
36
+ text: string;
37
+ };
38
+ export type LiveSessionResponse = {
39
+ mode: 'batch';
40
+ } | ({
41
+ mode: 'live';
42
+ } & RealtimeSession);
43
+ export declare class VoiceRoutes extends Route<VoiceRoutesDeps> {
44
+ #private;
45
+ routes(): import("@mastra/core/server").ApiRoute[];
46
+ }
47
+ export {};
48
+ //# sourceMappingURL=voice.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"voice.d.ts","sourceRoot":"","sources":["../../src/routes/voice.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AASjE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACtF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAGtF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAW5D,OAAO,KAAK,EAA2C,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAEtG,OAAO,EAAS,KAAK,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAoBpD,MAAM,WAAW,eAAgB,SAAQ,iBAAiB;IACxD,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;IAC3C,aAAa,EAAE,oBAAoB,CAAC;IACpC,eAAe,EAAE,sBAAsB,CAAC;CACzC;AASD,KAAK,WAAW,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAMvD,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC5B,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,WAAW,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,KAAK,CAAC,WAAW,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,gHAAgH;IAChH,IAAI,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACjG;AAED,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhE,MAAM,MAAM,mBAAmB,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,CAAC,CAAC;AA+B3F,qBAAa,WAAY,SAAQ,KAAK,CAAC,eAAe,CAAC;;IA8DrD,MAAM,6CA0GL;CACF"}
@@ -0,0 +1,248 @@
1
+ import { voiceRateLimiter } from "../voice/rate-limit.js";
2
+ import { keyCannotTranscribe, mintRealtimeSession } from "../voice/realtime.js";
3
+ import { MAX_TRANSCRIBE_AUDIO_BYTES, chooseSTTModel, localVoiceCaller, savedSTTModel, tenantVoiceCaller, transcribeAudio, transcriptionFailureReason, voicePolicy } from "../voice/transcription.js";
4
+ import { resolveCredentialContext } from "./provider-credentials.js";
5
+ import { Route, loose } from "./route.js";
6
+ import { registerApiRoute } from "@mastra/core/server";
7
+ import { z } from "zod";
8
+ import { STT_MODELS, findSTTModel, sttProviders } from "@mastra/code-sdk/voice/stt-registry";
9
+ import { sttApiKeyEnvVar } from "@mastra/code-sdk/voice/transcribe";
10
+ import { bodyLimit } from "hono/body-limit";
11
+ // src/routes/voice.ts
12
+ const factoryIdSchema = z.string().min(1).optional();
13
+ const settingsBodySchema = z.union([z.object({
14
+ factoryId: factoryIdSchema,
15
+ provider: z.null()
16
+ }).transform(({ factoryId }) => ({
17
+ factoryId,
18
+ entry: null
19
+ })), z.object({
20
+ factoryId: factoryIdSchema,
21
+ provider: z.string().min(1),
22
+ model: z.string().min(1)
23
+ }).transform(({ factoryId, provider, model }, ctx) => {
24
+ const entry = findSTTModel(provider, model);
25
+ if (!entry) {
26
+ ctx.addIssue({
27
+ code: "custom",
28
+ message: `${provider}/${model} is not a supported speech-to-text model.`
29
+ });
30
+ return z.NEVER;
31
+ }
32
+ return {
33
+ factoryId,
34
+ entry
35
+ };
36
+ })]);
37
+ function choice(entry) {
38
+ return entry ? {
39
+ provider: entry.provider,
40
+ model: entry.model
41
+ } : null;
42
+ }
43
+ function settingsResponse(request, policy, saved, canEdit, authStorage) {
44
+ const effective = chooseSTTModel(policy, saved);
45
+ return {
46
+ scope: policy.scope,
47
+ selected: choice(saved),
48
+ canEdit,
49
+ effective: "error" in effective ? null : choice(effective.entry),
50
+ models: STT_MODELS.map((m) => ({
51
+ provider: m.provider,
52
+ model: m.model,
53
+ label: m.label
54
+ })),
55
+ keys: sttProviders().map((provider) => {
56
+ const envVar = sttApiKeyEnvVar(provider);
57
+ const envKey = envVar ? process.env[envVar]?.trim() : void 0;
58
+ return {
59
+ provider,
60
+ envVar,
61
+ saved: policy.keyFor(provider) !== void 0,
62
+ fromEnv: !request.orgId && Boolean(envKey) && envKey !== authStorage?.getStoredApiKey(provider)?.trim()
63
+ };
64
+ })
65
+ };
66
+ }
67
+ var VoiceRoutes = class extends Route {
68
+ #rateLimiter = voiceRateLimiter();
69
+ async #request(c, factoryId) {
70
+ const ctx = await resolveCredentialContext({
71
+ c,
72
+ auth: this.deps.auth,
73
+ credentials: this.deps.modelCredentials
74
+ });
75
+ if ("response" in ctx) return ctx;
76
+ const caller = ctx.mode === "tenant" ? tenantVoiceCaller(await ctx.storage.listCredentials(ctx.orgId, ctx.userId), ctx.orgId, ctx.userId) : localVoiceCaller(this.deps.authStorage);
77
+ const orgId = ctx.mode === "tenant" ? ctx.orgId : void 0;
78
+ if (!factoryId) return {
79
+ caller,
80
+ orgId
81
+ };
82
+ const projects = this.deps.factoryProjects;
83
+ await projects.ensureReady();
84
+ const project = orgId ? await projects.get({
85
+ orgId,
86
+ id: factoryId
87
+ }) : await projects.getById({ id: factoryId });
88
+ if (!project) return { response: c.json({ error: "factory_project_not_found" }, 404) };
89
+ return {
90
+ caller,
91
+ orgId,
92
+ factory: project
93
+ };
94
+ }
95
+ /** A named 503 rather than a generic 500, and never a silent fall back to auto. */
96
+ async #voiceSettings(c) {
97
+ try {
98
+ await this.deps.voiceSettings.ensureReady();
99
+ return this.deps.voiceSettings;
100
+ } catch {
101
+ return { response: c.json({
102
+ error: "voice_settings_unavailable",
103
+ message: "Voice settings storage is unavailable — the app database is not configured or failed to start."
104
+ }, 503) };
105
+ }
106
+ }
107
+ async #canEdit(c, request, policy) {
108
+ if (policy.scope === "user" || !request.orgId) return true;
109
+ return this.deps.auth.isOrganizationAdmin(c, request.orgId);
110
+ }
111
+ #overLimit(c, caller, use) {
112
+ const { orgId, userId } = caller.settingsKey;
113
+ const verdict = this.#rateLimiter[use](`${orgId}:${userId}`);
114
+ if (verdict.allowed) return void 0;
115
+ return c.json({ error: "voice_rate_limited" }, 429, { "Retry-After": String(verdict.retryAfterSeconds) });
116
+ }
117
+ async #selection(c) {
118
+ const request = await this.#request(c, c.req.query("factoryId") || void 0);
119
+ if ("response" in request) return request;
120
+ const storage = await this.#voiceSettings(c);
121
+ if ("response" in storage) return storage;
122
+ const policy = voicePolicy(request.caller, request.factory);
123
+ const chosen = chooseSTTModel(policy, await savedSTTModel(storage, policy.settingsKey));
124
+ if ("error" in chosen) return { response: c.json({ error: chosen.error }, 400) };
125
+ return {
126
+ chosen,
127
+ caller: request.caller
128
+ };
129
+ }
130
+ routes() {
131
+ const limitBody = bodyLimit({
132
+ maxSize: MAX_TRANSCRIBE_AUDIO_BYTES,
133
+ onError: (c) => c.json({ error: "Recording is too long to transcribe." }, 413)
134
+ });
135
+ return [
136
+ registerApiRoute("/web/voice/settings", {
137
+ method: "GET",
138
+ requiresAuth: false,
139
+ handler: async (context) => {
140
+ const c = loose(context);
141
+ const request = await this.#request(c, c.req.query("factoryId") || void 0);
142
+ if ("response" in request) return request.response;
143
+ const storage = await this.#voiceSettings(c);
144
+ if ("response" in storage) return storage.response;
145
+ const policy = voicePolicy(request.caller, request.factory);
146
+ const saved = await savedSTTModel(storage, policy.settingsKey);
147
+ return c.json(settingsResponse(request, policy, saved, await this.#canEdit(c, request, policy), this.deps.authStorage));
148
+ }
149
+ }),
150
+ registerApiRoute("/web/voice/settings", {
151
+ method: "PUT",
152
+ requiresAuth: false,
153
+ handler: async (context) => {
154
+ const c = loose(context);
155
+ const parsed = settingsBodySchema.safeParse(await c.req.json().catch(() => void 0));
156
+ if (!parsed.success) {
157
+ const custom = parsed.error.issues.find((issue) => issue.code === "custom");
158
+ return c.json({ error: custom?.message ?? "Expected { provider, model }." }, 400);
159
+ }
160
+ const { factoryId, entry } = parsed.data;
161
+ const request = await this.#request(c, factoryId);
162
+ if ("response" in request) return request.response;
163
+ const policy = voicePolicy(request.caller, request.factory);
164
+ const canEdit = await this.#canEdit(c, request, policy);
165
+ if (!canEdit) return c.json({ error: "organization_admin_required" }, 403);
166
+ const storage = await this.#voiceSettings(c);
167
+ if ("response" in storage) return storage.response;
168
+ if (entry) await storage.set({
169
+ ...policy.settingsKey,
170
+ provider: entry.provider,
171
+ model: entry.model
172
+ });
173
+ else await storage.clear(policy.settingsKey);
174
+ return c.json(settingsResponse(request, policy, entry ?? void 0, canEdit, this.deps.authStorage));
175
+ }
176
+ }),
177
+ registerApiRoute("/web/voice/transcribe", {
178
+ method: "POST",
179
+ requiresAuth: false,
180
+ handler: async (context) => {
181
+ const c = loose(context);
182
+ const mimeType = c.req.header("content-type") ?? "";
183
+ if (!mimeType.trim().toLowerCase().startsWith("audio/")) return c.json({ error: "Expected an audio recording." }, 415);
184
+ const selection = await this.#selection(c);
185
+ if ("response" in selection) return selection.response;
186
+ const overLimit = this.#overLimit(c, selection.caller, "take");
187
+ if (overLimit) return overLimit;
188
+ const { chosen } = selection;
189
+ let audio;
190
+ const limited = await limitBody(c, async () => {
191
+ audio = Buffer.from(await c.req.arrayBuffer());
192
+ });
193
+ if (limited) return limited;
194
+ if (!audio || audio.length === 0) return c.json({ error: "Recording is empty." }, 400);
195
+ try {
196
+ const body = {
197
+ text: await transcribeAudio(chosen, audio, mimeType),
198
+ provider: chosen.entry.provider,
199
+ model: chosen.entry.model
200
+ };
201
+ return c.json(body);
202
+ } catch (error) {
203
+ console.warn("[voice] transcription failed", {
204
+ provider: chosen.entry.provider,
205
+ error
206
+ });
207
+ return c.json({ error: `Transcription failed: ${transcriptionFailureReason(error)}.` }, 502);
208
+ }
209
+ }
210
+ }),
211
+ registerApiRoute("/web/voice/live-session", {
212
+ method: "POST",
213
+ requiresAuth: false,
214
+ handler: async (context) => {
215
+ const c = loose(context);
216
+ const selection = await this.#selection(c);
217
+ if ("response" in selection) return selection.response;
218
+ const { chosen } = selection;
219
+ const { realtimeModel } = chosen.entry;
220
+ const overLimit = this.#overLimit(c, selection.caller, "check");
221
+ if (overLimit) return overLimit;
222
+ if (!realtimeModel) return c.json({ mode: "batch" });
223
+ let session;
224
+ try {
225
+ session = await mintRealtimeSession(chosen.apiKey, realtimeModel);
226
+ } catch (error) {
227
+ console.warn("[voice] realtime session request failed", {
228
+ provider: chosen.entry.provider,
229
+ error
230
+ });
231
+ if (keyCannotTranscribe(error)) return c.json({ error: `Transcription failed: ${transcriptionFailureReason(error)}.` }, 502);
232
+ return c.json({ mode: "batch" });
233
+ }
234
+ const overLimitAfterMint = this.#overLimit(c, selection.caller, "take");
235
+ if (overLimitAfterMint) return overLimitAfterMint;
236
+ const body = {
237
+ mode: "live",
238
+ ...session
239
+ };
240
+ return c.json(body, 200, { "Cache-Control": "no-store" });
241
+ }
242
+ })
243
+ ];
244
+ }
245
+ };
246
+ export { VoiceRoutes };
247
+
248
+ //# sourceMappingURL=voice.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"voice.js","names":[],"sources":["../../src/routes/voice.ts"],"sourcesContent":["import type { AuthStorage } from '@mastra/code-sdk/auth/storage';\nimport { findSTTModel, STT_MODELS, sttProviders } from '@mastra/code-sdk/voice/stt-registry';\nimport type { STTModel } from '@mastra/code-sdk/voice/stt-registry';\nimport { sttApiKeyEnvVar } from '@mastra/code-sdk/voice/transcribe';\nimport { registerApiRoute } from '@mastra/core/server';\nimport type { Context } from 'hono';\nimport { bodyLimit } from 'hono/body-limit';\nimport { z } from 'zod';\n\nimport type { ModelCredentialsStorage } from '../storage/domains/credentials/base.js';\nimport type { FactoryProjectsStorage } from '../storage/domains/projects/base.js';\nimport type { VoiceSettingsStorage } from '../storage/domains/voice-settings/base.js';\nimport { voiceRateLimiter } from '../voice/rate-limit.js';\nimport { keyCannotTranscribe, mintRealtimeSession } from '../voice/realtime.js';\nimport type { RealtimeSession } from '../voice/realtime.js';\nimport {\n chooseSTTModel,\n localVoiceCaller,\n MAX_TRANSCRIBE_AUDIO_BYTES,\n savedSTTModel,\n tenantVoiceCaller,\n transcribeAudio,\n transcriptionFailureReason,\n voicePolicy,\n} from '../voice/transcription.js';\nimport type { STTSelection, VoiceCaller, VoiceFactory, VoicePolicy } from '../voice/transcription.js';\nimport { resolveCredentialContext } from './provider-credentials.js';\nimport { loose, Route } from './route.js';\nimport type { RouteDependencies } from './route.js';\n\nconst factoryIdSchema = z.string().min(1).optional();\n\nconst settingsBodySchema = z.union([\n z\n .object({ factoryId: factoryIdSchema, provider: z.null() })\n .transform(({ factoryId }) => ({ factoryId, entry: null })),\n z\n .object({ factoryId: factoryIdSchema, provider: z.string().min(1), model: z.string().min(1) })\n .transform(({ factoryId, provider, model }, ctx) => {\n const entry = findSTTModel(provider, model);\n if (!entry) {\n ctx.addIssue({ code: 'custom', message: `${provider}/${model} is not a supported speech-to-text model.` });\n return z.NEVER;\n }\n return { factoryId, entry };\n }),\n]);\n\nexport interface VoiceRoutesDeps extends RouteDependencies {\n authStorage?: AuthStorage;\n modelCredentials?: ModelCredentialsStorage;\n voiceSettings: VoiceSettingsStorage;\n factoryProjects: FactoryProjectsStorage;\n}\n\ninterface VoiceRequest {\n caller: VoiceCaller;\n factory?: VoiceFactory;\n /** Absent in local mode, where there is no org admin to check. */\n orgId?: string;\n}\n\ntype ModelChoice = { provider: string; model: string };\n\nfunction choice(entry: STTModel | undefined): ModelChoice | null {\n return entry ? { provider: entry.provider, model: entry.model } : null;\n}\n\nexport interface VoiceSettingsResponse {\n scope: VoicePolicy['scope'];\n selected: ModelChoice | null;\n canEdit: boolean;\n effective: ModelChoice | null;\n models: Array<ModelChoice & { label: string }>;\n /** `fromEnv`: local mode reads the key from the server environment, so it cannot be updated or removed here. */\n keys: Array<{ provider: string; envVar: string | undefined; saved: boolean; fromEnv: boolean }>;\n}\n\nexport type TranscribeResponse = ModelChoice & { text: string };\n\nexport type LiveSessionResponse = { mode: 'batch' } | ({ mode: 'live' } & RealtimeSession);\n\nfunction settingsResponse(\n request: VoiceRequest,\n policy: VoicePolicy,\n saved: STTModel | undefined,\n canEdit: boolean,\n authStorage: AuthStorage | undefined,\n): VoiceSettingsResponse {\n const effective = chooseSTTModel(policy, saved);\n return {\n scope: policy.scope,\n selected: choice(saved),\n canEdit,\n effective: 'error' in effective ? null : choice(effective.entry),\n models: STT_MODELS.map(m => ({ provider: m.provider, model: m.model, label: m.label })),\n keys: sttProviders().map(provider => {\n const envVar = sttApiKeyEnvVar(provider);\n const envKey = envVar ? process.env[envVar]?.trim() : undefined;\n return {\n provider,\n envVar,\n saved: policy.keyFor(provider) !== undefined,\n // Tenant mode never reads deployment env keys for transcription. Saving a key in local mode also copies it\n // into process.env, so an env value equal to the stored key is the stored key, not an environment one.\n fromEnv: !request.orgId && Boolean(envKey) && envKey !== authStorage?.getStoredApiKey(provider)?.trim(),\n };\n }),\n };\n}\n\nexport class VoiceRoutes extends Route<VoiceRoutesDeps> {\n readonly #rateLimiter = voiceRateLimiter();\n\n async #request(c: Context, factoryId: string | undefined): Promise<VoiceRequest | { response: Response }> {\n const ctx = await resolveCredentialContext({ c, auth: this.deps.auth, credentials: this.deps.modelCredentials });\n if ('response' in ctx) return ctx;\n const caller =\n ctx.mode === 'tenant'\n ? tenantVoiceCaller(await ctx.storage.listCredentials(ctx.orgId, ctx.userId), ctx.orgId, ctx.userId)\n : localVoiceCaller(this.deps.authStorage);\n const orgId = ctx.mode === 'tenant' ? ctx.orgId : undefined;\n if (!factoryId) return { caller, orgId };\n\n const projects = this.deps.factoryProjects;\n await projects.ensureReady();\n // Local mode is single-user; tenants only ever see their own org's Factories.\n const project = orgId ? await projects.get({ orgId, id: factoryId }) : await projects.getById({ id: factoryId });\n if (!project) return { response: c.json({ error: 'factory_project_not_found' }, 404) };\n return { caller, orgId, factory: project };\n }\n\n /** A named 503 rather than a generic 500, and never a silent fall back to auto. */\n async #voiceSettings(c: Context): Promise<VoiceSettingsStorage | { response: Response }> {\n try {\n await this.deps.voiceSettings.ensureReady();\n return this.deps.voiceSettings;\n } catch {\n return {\n response: c.json(\n {\n error: 'voice_settings_unavailable',\n message: 'Voice settings storage is unavailable — the app database is not configured or failed to start.',\n },\n 503,\n ),\n };\n }\n }\n\n async #canEdit(c: Context, request: VoiceRequest, policy: VoicePolicy): Promise<boolean> {\n if (policy.scope === 'user' || !request.orgId) return true;\n return this.deps.auth.isOrganizationAdmin(c, request.orgId);\n }\n\n #overLimit(c: Context, caller: VoiceCaller, use: 'check' | 'take'): Response | undefined {\n const { orgId, userId } = caller.settingsKey;\n const verdict = this.#rateLimiter[use](`${orgId}:${userId}`);\n if (verdict.allowed) return undefined;\n return c.json({ error: 'voice_rate_limited' }, 429, { 'Retry-After': String(verdict.retryAfterSeconds) });\n }\n\n async #selection(c: Context): Promise<{ chosen: STTSelection; caller: VoiceCaller } | { response: Response }> {\n const request = await this.#request(c, c.req.query('factoryId') || undefined);\n if ('response' in request) return request;\n const storage = await this.#voiceSettings(c);\n if ('response' in storage) return storage;\n const policy = voicePolicy(request.caller, request.factory);\n const chosen = chooseSTTModel(policy, await savedSTTModel(storage, policy.settingsKey));\n if ('error' in chosen) return { response: c.json({ error: chosen.error }, 400) };\n return { chosen, caller: request.caller };\n }\n\n routes() {\n const limitBody = bodyLimit({\n maxSize: MAX_TRANSCRIBE_AUDIO_BYTES,\n onError: c => c.json({ error: 'Recording is too long to transcribe.' }, 413),\n });\n return [\n registerApiRoute('/web/voice/settings', {\n method: 'GET',\n requiresAuth: false,\n handler: async context => {\n const c = loose(context);\n const request = await this.#request(c, c.req.query('factoryId') || undefined);\n if ('response' in request) return request.response;\n const storage = await this.#voiceSettings(c);\n if ('response' in storage) return storage.response;\n const policy = voicePolicy(request.caller, request.factory);\n const saved = await savedSTTModel(storage, policy.settingsKey);\n return c.json(\n settingsResponse(request, policy, saved, await this.#canEdit(c, request, policy), this.deps.authStorage),\n );\n },\n }),\n registerApiRoute('/web/voice/settings', {\n method: 'PUT',\n requiresAuth: false,\n handler: async context => {\n const c = loose(context);\n const parsed = settingsBodySchema.safeParse(await c.req.json().catch(() => undefined));\n if (!parsed.success) {\n const custom = parsed.error.issues.find(issue => issue.code === 'custom');\n return c.json({ error: custom?.message ?? 'Expected { provider, model }.' }, 400);\n }\n const { factoryId, entry } = parsed.data;\n\n const request = await this.#request(c, factoryId);\n if ('response' in request) return request.response;\n const policy = voicePolicy(request.caller, request.factory);\n const canEdit = await this.#canEdit(c, request, policy);\n if (!canEdit) return c.json({ error: 'organization_admin_required' }, 403);\n const storage = await this.#voiceSettings(c);\n if ('response' in storage) return storage.response;\n if (entry) await storage.set({ ...policy.settingsKey, provider: entry.provider, model: entry.model });\n else await storage.clear(policy.settingsKey);\n return c.json(settingsResponse(request, policy, entry ?? undefined, canEdit, this.deps.authStorage));\n },\n }),\n registerApiRoute('/web/voice/transcribe', {\n method: 'POST',\n requiresAuth: false,\n handler: async context => {\n const c = loose(context);\n const mimeType = c.req.header('content-type') ?? '';\n if (!mimeType.trim().toLowerCase().startsWith('audio/')) {\n return c.json({ error: 'Expected an audio recording.' }, 415);\n }\n const selection = await this.#selection(c);\n if ('response' in selection) return selection.response;\n const overLimit = this.#overLimit(c, selection.caller, 'take');\n if (overLimit) return overLimit;\n const { chosen } = selection;\n\n let audio: Buffer | undefined;\n const limited = await limitBody(c, async () => {\n audio = Buffer.from(await c.req.arrayBuffer());\n });\n if (limited) return limited;\n if (!audio || audio.length === 0) return c.json({ error: 'Recording is empty.' }, 400);\n try {\n const text = await transcribeAudio(chosen, audio, mimeType);\n const body: TranscribeResponse = { text, provider: chosen.entry.provider, model: chosen.entry.model };\n return c.json(body);\n } catch (error) {\n console.warn('[voice] transcription failed', { provider: chosen.entry.provider, error });\n return c.json({ error: `Transcription failed: ${transcriptionFailureReason(error)}.` }, 502);\n }\n },\n }),\n registerApiRoute('/web/voice/live-session', {\n method: 'POST',\n requiresAuth: false,\n handler: async context => {\n const c = loose(context);\n const selection = await this.#selection(c);\n if ('response' in selection) return selection.response;\n const { chosen } = selection;\n const { realtimeModel } = chosen.entry;\n const overLimit = this.#overLimit(c, selection.caller, 'check');\n if (overLimit) return overLimit;\n if (!realtimeModel) return c.json({ mode: 'batch' } satisfies LiveSessionResponse);\n let session: RealtimeSession;\n try {\n session = await mintRealtimeSession(chosen.apiKey, realtimeModel);\n } catch (error) {\n console.warn('[voice] realtime session request failed', { provider: chosen.entry.provider, error });\n if (keyCannotTranscribe(error)) {\n return c.json({ error: `Transcription failed: ${transcriptionFailureReason(error)}.` }, 502);\n }\n return c.json({ mode: 'batch' } satisfies LiveSessionResponse);\n }\n const overLimitAfterMint = this.#overLimit(c, selection.caller, 'take');\n if (overLimitAfterMint) return overLimitAfterMint;\n const body: LiveSessionResponse = { mode: 'live', ...session };\n return c.json(body, 200, { 'Cache-Control': 'no-store' });\n },\n }),\n ];\n }\n}\n"],"mappings":"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"}
@@ -14,7 +14,6 @@ import type { FactoryStartCoordinator } from '../rules/start-coordinator.js';
14
14
  import type { FactoryTransitionService } from '../rules/transition-service.js';
15
15
  import type { LiveSessions } from '../session/live-sessions.js';
16
16
  import type { AuditEmitter } from '../storage/domains/audit/domain.js';
17
- import type { WorkItemCommentsStorage } from '../storage/domains/comments/base.js';
18
17
  import type { FactoryProjectsStorage } from '../storage/domains/projects/base.js';
19
18
  import type { QueueHealthStorage } from '../storage/domains/queue-health/base.js';
20
19
  import type { CreateWorkItemInput, UpdateWorkItemInput, WorkItemsStorage } from '../storage/domains/work-items/base.js';
@@ -31,8 +30,6 @@ export interface WorkItemRoutesDeps extends RouteDependencies {
31
30
  boardRegistry?: BoardRegistry | ProjectBoardSource;
32
31
  /** The project's intake routes, which place a card filed without a board. */
33
32
  intakeRoutes?: IntakeRoutesReader;
34
- /** Comments domain — backs the mention attention provider. */
35
- comments: WorkItemCommentsStorage;
36
33
  /** Per-project queue-health threshold config. */
37
34
  queueHealth: QueueHealthStorage;
38
35
  /** Governed stage-transition service. Stage moves 503 when absent. */
@@ -1 +1 @@
1
- {"version":3,"file":"work-items.d.ts","sourceRoot":"","sources":["../../src/routes/work-items.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAIpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,OAAO,KAAK,EAAE,kBAAkB,EAAsB,MAAM,6BAA6B,CAAC;AAG1F,OAAO,KAAK,EACV,uBAAuB,EAGxB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAA4B,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAEzG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEhE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAEnF,OAAO,KAAK,EAAuB,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AACvG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAElF,OAAO,KAAK,EACV,mBAAmB,EAEnB,mBAAmB,EAEnB,gBAAgB,EACjB,MAAM,uCAAuC,CAAC;AAY/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,KAAK,EAAE,YAAY,CAAC;IACpB,yFAAyF;IACzF,QAAQ,EAAE,sBAAsB,CAAC;IACjC,kDAAkD;IAClD,SAAS,EAAE,gBAAgB,CAAC;IAC5B,kDAAkD;IAClD,oFAAoF;IACpF,aAAa,CAAC,EAAE,aAAa,GAAG,kBAAkB,CAAC;IACnD,6EAA6E;IAC7E,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,8DAA8D;IAC9D,QAAQ,EAAE,uBAAuB,CAAC;IAClC,iDAAiD;IACjD,WAAW,EAAE,kBAAkB,CAAC;IAChC,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,IAAI,CAAC,wBAAwB,EAAE,YAAY,GAAG,eAAe,CAAC,CAAC;IACnF,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,IAAI,CAAC,uBAAuB,EAAE,SAAS,CAAC,CAAC;IAC5D,2GAA2G;IAC3G,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC,CAAC;CACvE;AAwCD,mEAAmE;AACnE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,mBAAmB,GAAG,IAAI,CAG7E;AAED,kEAAkE;AAClE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,mBAAmB,GAAG,IAAI,CAG7E;AAyFD,qBAAa,cAAe,SAAQ,KAAK,CAAC,kBAAkB,CAAC;;IAoH3D,gEAAgE;IAChE,MAAM,IAAI,QAAQ,EAAE,CAyanB;CACF"}
1
+ {"version":3,"file":"work-items.d.ts","sourceRoot":"","sources":["../../src/routes/work-items.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAKpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,OAAO,KAAK,EAAE,kBAAkB,EAAsB,MAAM,6BAA6B,CAAC;AAG1F,OAAO,KAAK,EACV,uBAAuB,EAGxB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAA4B,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAEzG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEhE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAEvE,OAAO,KAAK,EAAuB,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AACvG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAElF,OAAO,KAAK,EACV,mBAAmB,EAEnB,mBAAmB,EAEnB,gBAAgB,EACjB,MAAM,uCAAuC,CAAC;AAa/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAS,KAAK,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,KAAK,EAAE,YAAY,CAAC;IACpB,yFAAyF;IACzF,QAAQ,EAAE,sBAAsB,CAAC;IACjC,kDAAkD;IAClD,SAAS,EAAE,gBAAgB,CAAC;IAC5B,kDAAkD;IAClD,oFAAoF;IACpF,aAAa,CAAC,EAAE,aAAa,GAAG,kBAAkB,CAAC;IACnD,6EAA6E;IAC7E,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,iDAAiD;IACjD,WAAW,EAAE,kBAAkB,CAAC;IAChC,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,IAAI,CAAC,wBAAwB,EAAE,YAAY,GAAG,eAAe,CAAC,CAAC;IACnF,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,IAAI,CAAC,uBAAuB,EAAE,SAAS,CAAC,CAAC;IAC5D,2GAA2G;IAC3G,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC,CAAC;CACvE;AAoCD,mEAAmE;AACnE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,mBAAmB,GAAG,IAAI,CAG7E;AAED,kEAAkE;AAClE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,mBAAmB,GAAG,IAAI,CAG7E;AAyFD,qBAAa,cAAe,SAAQ,KAAK,CAAC,kBAAkB,CAAC;;IAoH3D,gEAAgE;IAChE,MAAM,IAAI,QAAQ,EAAE,CA+bnB;CACF"}
@@ -1,18 +1,21 @@
1
+ import { boardFlow, boardPhaseOutcomes } from "../boards/semantics.js";
2
+ import "../boards/index.js";
1
3
  import { toBoardSource } from "../boards/project-boards.js";
2
4
  import { EXTERNAL_SOURCE_MISSING_KEY } from "../integrations/issue-reconciler.js";
3
5
  import { decisionRetryable, overtakenDecisionIds } from "../rules/decision-applicability.js";
4
6
  import { FactoryStartTransitionError, WorkItemRepositoryError } from "../rules/start-coordinator.js";
5
7
  import { auditRequestOrigin } from "../storage/domains/audit/domain.js";
8
+ import { factoryDecisionType } from "./attention-providers.js";
6
9
  import { effectiveModelScope } from "../storage/domains/projects/base.js";
7
10
  import { thresholdsOrDefault } from "../storage/domains/queue-health/base.js";
8
11
  import { FACTORY_PULL_REQUEST_RECONCILIATION_KEY, FACTORY_RULE_MATERIALIZATION_KEY, WorkItemRelationError, WorkItemUpdateConflictError } from "../storage/domains/work-items/base.js";
9
- import { factoryDecisionType } from "./attention-providers.js";
10
12
  import { computeFactoryMetrics, parseMetricsRange } from "../storage/domains/work-items/metrics.js";
11
13
  import { createFactoryWorkItem } from "../work-items/create-work-item.js";
12
14
  import { resolveFactoryProposal, retryFactoryDecision } from "../work-items/decision-actions.js";
13
15
  import { buildAttentionRoutes } from "./attention.js";
16
+ import { boardSnapshot, matchesEtag } from "./board-snapshot.js";
14
17
  import { FACTORY_ROUTE_CONTRACTS } from "./contracts.js";
15
- import { Route } from "./route.js";
18
+ import { Route, loose } from "./route.js";
16
19
  import { registerApiRoute } from "@mastra/core/server";
17
20
  // src/routes/work-items.ts
18
21
  /** The card as clients see it, without the dispatcher's internal bookkeeping. */
@@ -35,9 +38,6 @@ function sessionIdsWhere(items, predicate) {
35
38
  for (const item of items) for (const { sessionId } of Object.values(item.sessions)) if (predicate(sessionId)) picked.add(sessionId);
36
39
  return [...picked];
37
40
  }
38
- function loose(c) {
39
- return c;
40
- }
41
41
  function publicWorkItemMetadata(value) {
42
42
  if (value === null) return null;
43
43
  const { [FACTORY_RULE_MATERIALIZATION_KEY]: _materialization, [FACTORY_PULL_REQUEST_RECONCILIATION_KEY]: _reconciliation, [EXTERNAL_SOURCE_MISSING_KEY]: _externalSourceMissingAt, ...metadata } = value;
@@ -240,6 +240,7 @@ var WorkItemRoutes = class extends Route {
240
240
  title: board.name,
241
241
  ...board.description !== void 0 ? { description: board.description } : {},
242
242
  initialPhase: board.initialPhase,
243
+ flow: catalogFlow(boardFlow(board)),
243
244
  phases: Object.entries(board.phases).map(([phaseId, phase]) => ({
244
245
  id: phaseId,
245
246
  name: phase.name,
@@ -251,13 +252,15 @@ var WorkItemRoutes = class extends Route {
251
252
  role: phase.runner.context,
252
253
  context: phase.runner.context,
253
254
  ...phase.runner.skill ? { skill: phase.runner.skill } : {},
255
+ ...phase.runner.goal ? { goal: { ...phase.runner.goal } } : {},
254
256
  autoStart: phase.autoStart === true,
255
257
  ...phase.autoStartWhen ? { autoStartWhen: phase.autoStartWhen } : {},
256
258
  ...phase.exitTool ? { exitTool: {
257
259
  id: phase.exitTool.id,
258
260
  autoApprove: phase.exitTool.autoApprove,
259
261
  ...phase.exitTool.autoApproveWhen ? { autoApproveWhen: phase.exitTool.autoApproveWhen } : {}
260
- } } : {}
262
+ } } : {},
263
+ ...phase.tools ? { tools: [...phase.tools] } : {}
261
264
  } : {},
262
265
  transitions: (board.transitions[phaseId] ?? []).map(({ outcome, to }) => ({
263
266
  outcome,
@@ -280,11 +283,19 @@ var WorkItemRoutes = class extends Route {
280
283
  orgId: resolved.orgId,
281
284
  factoryProjectId: resolved.factoryProjectId
282
285
  });
283
- return c.json({
284
- workItems: items.map(toWireWorkItem),
285
- runningSessionIds: sessionIdsWhere(items, (sessionId) => liveSessions.isRunning(sessionId)),
286
- parkedSessionIds: sessionIdsWhere(items, (sessionId) => liveSessions.parked(sessionId) !== void 0)
287
- });
286
+ const snapshot = boardSnapshot(items, toWireWorkItem, sessionIdsWhere(items, (sessionId) => liveSessions.isRunning(sessionId)), sessionIdsWhere(items, (sessionId) => liveSessions.parked(sessionId) !== void 0));
287
+ const headers = {
288
+ ETag: snapshot.etag,
289
+ "Cache-Control": "private, no-cache",
290
+ Vary: "Accept-Encoding"
291
+ };
292
+ if (matchesEtag(c.req.header("if-none-match"), snapshot.etag)) return c.body(null, 304, headers);
293
+ headers["Content-Type"] = "application/json; charset=UTF-8";
294
+ if (/\bgzip\b/.test(c.req.header("accept-encoding") ?? "")) {
295
+ headers["Content-Encoding"] = "gzip";
296
+ return c.body(new Uint8Array(await snapshot.gzipped()), 200, headers);
297
+ }
298
+ return c.body(snapshot.json, 200, headers);
288
299
  }
289
300
  }),
290
301
  registerApiRoute(FACTORY_ROUTE_CONTRACTS.metricsGet.path, {
@@ -301,14 +312,18 @@ var WorkItemRoutes = class extends Route {
301
312
  if (!query.success) return c.json({ error: "invalid_metrics_range" }, 400);
302
313
  const { windowStart, windowEnd } = parseMetricsRange(query.data.from, query.data.to, /* @__PURE__ */ new Date());
303
314
  await workItems.ensureReady();
304
- const items = await workItems.list({
315
+ const items = await workItems.listShared({
316
+ orgId: resolved.orgId,
317
+ factoryProjectId: resolved.factoryProjectId
318
+ });
319
+ const boards = await this.#boards.load({
305
320
  orgId: resolved.orgId,
306
321
  factoryProjectId: resolved.factoryProjectId
307
322
  });
308
323
  return c.json({ metrics: computeFactoryMetrics(items, {
309
324
  windowStart,
310
325
  windowEnd
311
- }) });
326
+ }, boardPhaseOutcomes(boards)) });
312
327
  }
313
328
  }),
314
329
  registerApiRoute(FACTORY_ROUTE_CONTRACTS.healthThresholdsGet.path, {
@@ -358,7 +373,6 @@ var WorkItemRoutes = class extends Route {
358
373
  ...buildAttentionRoutes({
359
374
  workItems,
360
375
  boards: this.#boards,
361
- comments: this.deps.comments,
362
376
  liveSessions,
363
377
  resolveProject: (context) => this.#resolveProject(loose(context))
364
378
  }),
@@ -606,6 +620,17 @@ var WorkItemRoutes = class extends Route {
606
620
  ];
607
621
  }
608
622
  };
623
+ /** A board's loop parts, by phase key, as the catalog reports them. */
624
+ function catalogFlow(flow) {
625
+ return {
626
+ ...flow.triage ? { triage: flow.triage } : {},
627
+ ...flow.build ? { build: flow.build } : {},
628
+ ...flow.selfReview ? { selfReview: flow.selfReview } : {},
629
+ ...flow.pullRequestReview ? { pullRequestReview: flow.pullRequestReview } : {},
630
+ ...flow.completed ? { completed: flow.completed.phase } : {},
631
+ ...flow.canceled ? { canceled: flow.canceled.phase } : {}
632
+ };
633
+ }
609
634
  export { WorkItemRoutes, parseCreateWorkItem, parseUpdateWorkItem };
610
635
 
611
636
  //# sourceMappingURL=work-items.js.map