@mastra/factory 0.27.0 → 0.28.0-alpha.1

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 (426) hide show
  1. package/README.md +215 -41
  2. package/dist/boards/board-events.d.ts +34 -0
  3. package/dist/boards/board-events.d.ts.map +1 -0
  4. package/dist/boards/board-events.js +50 -0
  5. package/dist/boards/board-events.js.map +1 -0
  6. package/dist/boards/board-writes.d.ts +86 -0
  7. package/dist/boards/board-writes.d.ts.map +1 -0
  8. package/dist/boards/board-writes.js +252 -0
  9. package/dist/boards/board-writes.js.map +1 -0
  10. package/dist/boards/define-board.d.ts +16 -5
  11. package/dist/boards/define-board.d.ts.map +1 -1
  12. package/dist/boards/define-board.js +30 -8
  13. package/dist/boards/define-board.js.map +1 -1
  14. package/dist/boards/index.js +1 -1
  15. package/dist/boards/intake-routing.d.ts +30 -6
  16. package/dist/boards/intake-routing.d.ts.map +1 -1
  17. package/dist/boards/intake-routing.js +43 -5
  18. package/dist/boards/intake-routing.js.map +1 -1
  19. package/dist/boards/legacy-plan-role.d.ts.map +1 -1
  20. package/dist/boards/legacy-plan-role.js +8 -4
  21. package/dist/boards/legacy-plan-role.js.map +1 -1
  22. package/dist/boards/phase-automation.d.ts.map +1 -1
  23. package/dist/boards/phase-automation.js +7 -2
  24. package/dist/boards/phase-automation.js.map +1 -1
  25. package/dist/boards/project-boards.d.ts +18 -7
  26. package/dist/boards/project-boards.d.ts.map +1 -1
  27. package/dist/boards/project-boards.js +79 -15
  28. package/dist/boards/project-boards.js.map +1 -1
  29. package/dist/boards/stored-board.d.ts +59 -1
  30. package/dist/boards/stored-board.d.ts.map +1 -1
  31. package/dist/boards/stored-board.js +219 -7
  32. package/dist/boards/stored-board.js.map +1 -1
  33. package/dist/boards/work.js +1 -1
  34. package/dist/dispatch-wake.d.ts +13 -0
  35. package/dist/dispatch-wake.d.ts.map +1 -0
  36. package/dist/dispatch-wake.js +30 -0
  37. package/dist/dispatch-wake.js.map +1 -0
  38. package/dist/environment/build-runner.d.ts +1 -1
  39. package/dist/environment/build-runner.d.ts.map +1 -1
  40. package/dist/environment/build-runner.js +2 -2
  41. package/dist/environment/build-workflow.d.ts +1 -1
  42. package/dist/environment/build-workflow.d.ts.map +1 -1
  43. package/dist/environment/build-workflow.js +1 -1
  44. package/dist/environment/build.js +1 -1
  45. package/dist/factory.d.ts +63 -9
  46. package/dist/factory.d.ts.map +1 -1
  47. package/dist/factory.js +237 -59
  48. package/dist/factory.js.map +1 -1
  49. package/dist/index.d.ts +3 -1
  50. package/dist/index.d.ts.map +1 -1
  51. package/dist/index.js +10 -9
  52. package/dist/integrations/base.d.ts +6 -0
  53. package/dist/integrations/base.d.ts.map +1 -1
  54. package/dist/integrations/channel-thread-announcements.d.ts +5 -0
  55. package/dist/integrations/channel-thread-announcements.d.ts.map +1 -1
  56. package/dist/integrations/channel-thread-announcements.js +24 -2
  57. package/dist/integrations/channel-thread-announcements.js.map +1 -1
  58. package/dist/integrations/github/acceptance-labels.d.ts +4 -0
  59. package/dist/integrations/github/acceptance-labels.d.ts.map +1 -1
  60. package/dist/integrations/github/acceptance-labels.js +1 -1
  61. package/dist/integrations/github/acceptance-labels.js.map +1 -1
  62. package/dist/integrations/github/default-rules.d.ts +2 -9
  63. package/dist/integrations/github/default-rules.d.ts.map +1 -1
  64. package/dist/integrations/github/default-rules.js +7 -6
  65. package/dist/integrations/github/default-rules.js.map +1 -1
  66. package/dist/integrations/github/integration.js +2 -2
  67. package/dist/integrations/github/issue-reconciler.d.ts.map +1 -1
  68. package/dist/integrations/github/issue-reconciler.js +17 -1
  69. package/dist/integrations/github/issue-reconciler.js.map +1 -1
  70. package/dist/integrations/github/review-status-comment.d.ts +61 -0
  71. package/dist/integrations/github/review-status-comment.d.ts.map +1 -0
  72. package/dist/integrations/github/review-status-comment.js +217 -0
  73. package/dist/integrations/github/review-status-comment.js.map +1 -0
  74. package/dist/integrations/github/review-status-reporter.d.ts +42 -0
  75. package/dist/integrations/github/review-status-reporter.d.ts.map +1 -0
  76. package/dist/integrations/github/review-status-reporter.js +100 -0
  77. package/dist/integrations/github/review-status-reporter.js.map +1 -0
  78. package/dist/integrations/github/review-status.d.ts +28 -0
  79. package/dist/integrations/github/review-status.d.ts.map +1 -0
  80. package/dist/integrations/github/review-status.js +95 -0
  81. package/dist/integrations/github/review-status.js.map +1 -0
  82. package/dist/integrations/github/routes.d.ts.map +1 -1
  83. package/dist/integrations/github/routes.js +19 -21
  84. package/dist/integrations/github/routes.js.map +1 -1
  85. package/dist/integrations/github/rules.d.ts +13 -1
  86. package/dist/integrations/github/rules.d.ts.map +1 -1
  87. package/dist/integrations/github/rules.js +80 -9
  88. package/dist/integrations/github/rules.js.map +1 -1
  89. package/dist/integrations/github/sandbox.js +1 -1
  90. package/dist/integrations/github/session-subscriptions.js +3 -3
  91. package/dist/integrations/github/webhook.js +2 -2
  92. package/dist/integrations/gitlab/default-rules.d.ts +24 -9
  93. package/dist/integrations/gitlab/default-rules.d.ts.map +1 -1
  94. package/dist/integrations/gitlab/default-rules.js +4 -4
  95. package/dist/integrations/gitlab/default-rules.js.map +1 -1
  96. package/dist/integrations/gitlab/integration.js +2 -2
  97. package/dist/integrations/gitlab/issue-reconciler.js +1 -1
  98. package/dist/integrations/gitlab/merge-request-reconciler.js +2 -2
  99. package/dist/integrations/gitlab/routes.d.ts.map +1 -1
  100. package/dist/integrations/gitlab/routes.js +2 -4
  101. package/dist/integrations/gitlab/routes.js.map +1 -1
  102. package/dist/integrations/gitlab/rules.d.ts +16 -0
  103. package/dist/integrations/gitlab/rules.d.ts.map +1 -1
  104. package/dist/integrations/gitlab/rules.js +71 -6
  105. package/dist/integrations/gitlab/rules.js.map +1 -1
  106. package/dist/integrations/gitlab/session-subscriptions.js +1 -1
  107. package/dist/integrations/gitlab/webhook-dispatch.js +1 -1
  108. package/dist/integrations/incidentio/default-rules.d.ts +1 -9
  109. package/dist/integrations/incidentio/default-rules.d.ts.map +1 -1
  110. package/dist/integrations/incidentio/default-rules.js +3 -4
  111. package/dist/integrations/incidentio/default-rules.js.map +1 -1
  112. package/dist/integrations/incidentio/integration.js +3 -3
  113. package/dist/integrations/incidentio/routes.d.ts.map +1 -1
  114. package/dist/integrations/incidentio/routes.js +1 -4
  115. package/dist/integrations/incidentio/routes.js.map +1 -1
  116. package/dist/integrations/incidentio/rules.d.ts +7 -0
  117. package/dist/integrations/incidentio/rules.d.ts.map +1 -1
  118. package/dist/integrations/incidentio/rules.js +37 -5
  119. package/dist/integrations/incidentio/rules.js.map +1 -1
  120. package/dist/integrations/jira/default-rules.d.ts +1 -9
  121. package/dist/integrations/jira/default-rules.d.ts.map +1 -1
  122. package/dist/integrations/jira/default-rules.js +3 -4
  123. package/dist/integrations/jira/default-rules.js.map +1 -1
  124. package/dist/integrations/jira/integration.js +2 -2
  125. package/dist/integrations/jira/routes.d.ts.map +1 -1
  126. package/dist/integrations/jira/routes.js +2 -5
  127. package/dist/integrations/jira/routes.js.map +1 -1
  128. package/dist/integrations/jira/rules.d.ts +7 -0
  129. package/dist/integrations/jira/rules.d.ts.map +1 -1
  130. package/dist/integrations/jira/rules.js +37 -5
  131. package/dist/integrations/jira/rules.js.map +1 -1
  132. package/dist/integrations/linear/default-rules.d.ts +1 -9
  133. package/dist/integrations/linear/default-rules.d.ts.map +1 -1
  134. package/dist/integrations/linear/default-rules.js +3 -4
  135. package/dist/integrations/linear/default-rules.js.map +1 -1
  136. package/dist/integrations/linear/integration.js +2 -2
  137. package/dist/integrations/linear/routes.d.ts +21 -1
  138. package/dist/integrations/linear/routes.d.ts.map +1 -1
  139. package/dist/integrations/linear/routes.js +21 -6
  140. package/dist/integrations/linear/routes.js.map +1 -1
  141. package/dist/integrations/linear/rules.d.ts +7 -0
  142. package/dist/integrations/linear/rules.d.ts.map +1 -1
  143. package/dist/integrations/linear/rules.js +37 -5
  144. package/dist/integrations/linear/rules.js.map +1 -1
  145. package/dist/integrations/platform/connect/routes.d.ts +7 -1
  146. package/dist/integrations/platform/connect/routes.d.ts.map +1 -1
  147. package/dist/integrations/platform/connect/routes.js +42 -5
  148. package/dist/integrations/platform/connect/routes.js.map +1 -1
  149. package/dist/integrations/platform/connect/session-tools.d.ts +7 -0
  150. package/dist/integrations/platform/connect/session-tools.d.ts.map +1 -0
  151. package/dist/integrations/platform/connect/session-tools.js +30 -0
  152. package/dist/integrations/platform/connect/session-tools.js.map +1 -0
  153. package/dist/integrations/platform/github/event-worker.js +1 -1
  154. package/dist/integrations/platform/github/integration.d.ts.map +1 -1
  155. package/dist/integrations/platform/github/integration.js +9 -8
  156. package/dist/integrations/platform/github/integration.js.map +1 -1
  157. package/dist/integrations/platform/gitlab/event-worker.js +1 -1
  158. package/dist/integrations/platform/gitlab/integration.js +2 -2
  159. package/dist/integrations/platform/incidentio/integration.js +5 -5
  160. package/dist/integrations/platform/jira/agent-tools.js +1 -1
  161. package/dist/integrations/platform/jira/integration.js +2 -2
  162. package/dist/integrations/platform/jira/routes.d.ts.map +1 -1
  163. package/dist/integrations/platform/jira/routes.js +2 -5
  164. package/dist/integrations/platform/jira/routes.js.map +1 -1
  165. package/dist/integrations/platform/linear/event-worker.d.ts +1 -1
  166. package/dist/integrations/platform/linear/event-worker.d.ts.map +1 -1
  167. package/dist/integrations/platform/linear/event-worker.js +9 -0
  168. package/dist/integrations/platform/linear/event-worker.js.map +1 -1
  169. package/dist/integrations/platform/linear/integration.d.ts.map +1 -1
  170. package/dist/integrations/platform/linear/integration.js +150 -48
  171. package/dist/integrations/platform/linear/integration.js.map +1 -1
  172. package/dist/integrations/slack/channel-reply-processor.d.ts +2 -0
  173. package/dist/integrations/slack/channel-reply-processor.d.ts.map +1 -1
  174. package/dist/integrations/slack/channel-reply-processor.js +6 -1
  175. package/dist/integrations/slack/channel-reply-processor.js.map +1 -1
  176. package/dist/integrations/slack/chat-tools.d.ts +16 -0
  177. package/dist/integrations/slack/chat-tools.d.ts.map +1 -0
  178. package/dist/integrations/slack/chat-tools.js +215 -0
  179. package/dist/integrations/slack/chat-tools.js.map +1 -0
  180. package/dist/integrations/slack/connect-route.d.ts.map +1 -1
  181. package/dist/integrations/slack/connect-route.js +1 -1
  182. package/dist/integrations/slack/connect-route.js.map +1 -1
  183. package/dist/integrations/slack/integration.d.ts +19 -3
  184. package/dist/integrations/slack/integration.d.ts.map +1 -1
  185. package/dist/integrations/slack/integration.js +27 -8
  186. package/dist/integrations/slack/integration.js.map +1 -1
  187. package/dist/integrations/slack/run-error-card.js +1 -1
  188. package/dist/integrations/slack/share-file-tool.d.ts +8 -0
  189. package/dist/integrations/slack/share-file-tool.d.ts.map +1 -1
  190. package/dist/integrations/slack/share-file-tool.js +13 -4
  191. package/dist/integrations/slack/share-file-tool.js.map +1 -1
  192. package/dist/integrations/slack/slack.d.ts +12 -10
  193. package/dist/integrations/slack/slack.d.ts.map +1 -1
  194. package/dist/integrations/slack/slack.js +113 -46
  195. package/dist/integrations/slack/slack.js.map +1 -1
  196. package/dist/integrations/slack/tool-settings.d.ts +26 -0
  197. package/dist/integrations/slack/tool-settings.d.ts.map +1 -0
  198. package/dist/integrations/slack/tool-settings.js +35 -0
  199. package/dist/integrations/slack/tool-settings.js.map +1 -0
  200. package/dist/integrations/slack/voice-clips.d.ts +32 -0
  201. package/dist/integrations/slack/voice-clips.d.ts.map +1 -0
  202. package/dist/integrations/slack/voice-clips.js +201 -0
  203. package/dist/integrations/slack/voice-clips.js.map +1 -0
  204. package/dist/integrations/workos/integration.d.ts.map +1 -1
  205. package/dist/integrations/workos/integration.js +1 -3
  206. package/dist/integrations/workos/integration.js.map +1 -1
  207. package/dist/mcp/events.js +1 -1
  208. package/dist/mcp/routes.js +2 -2
  209. package/dist/packages/_internals/workspace/dist/index.js +1 -1
  210. package/dist/routes/attention-activity.js +1 -1
  211. package/dist/routes/attention-providers.js +2 -2
  212. package/dist/routes/attention.js +2 -2
  213. package/dist/routes/automation-runs.d.ts.map +1 -1
  214. package/dist/routes/automation-runs.js +2 -5
  215. package/dist/routes/automation-runs.js.map +1 -1
  216. package/dist/routes/boards.d.ts +8 -6
  217. package/dist/routes/boards.d.ts.map +1 -1
  218. package/dist/routes/boards.js +73 -143
  219. package/dist/routes/boards.js.map +1 -1
  220. package/dist/routes/config.d.ts.map +1 -1
  221. package/dist/routes/config.js +6 -11
  222. package/dist/routes/config.js.map +1 -1
  223. package/dist/routes/contracts.d.ts +162 -2
  224. package/dist/routes/contracts.d.ts.map +1 -1
  225. package/dist/routes/contracts.js +98 -33
  226. package/dist/routes/contracts.js.map +1 -1
  227. package/dist/routes/fs.d.ts.map +1 -1
  228. package/dist/routes/fs.js +2 -5
  229. package/dist/routes/fs.js.map +1 -1
  230. package/dist/routes/intake-routes.d.ts.map +1 -1
  231. package/dist/routes/intake-routes.js +19 -12
  232. package/dist/routes/intake-routes.js.map +1 -1
  233. package/dist/routes/intake.d.ts.map +1 -1
  234. package/dist/routes/intake.js +4 -6
  235. package/dist/routes/intake.js.map +1 -1
  236. package/dist/routes/knowledge.d.ts.map +1 -1
  237. package/dist/routes/knowledge.js +1 -4
  238. package/dist/routes/knowledge.js.map +1 -1
  239. package/dist/routes/oauth.d.ts.map +1 -1
  240. package/dist/routes/oauth.js +1 -4
  241. package/dist/routes/oauth.js.map +1 -1
  242. package/dist/routes/projects.d.ts +3 -0
  243. package/dist/routes/projects.d.ts.map +1 -1
  244. package/dist/routes/projects.js +42 -28
  245. package/dist/routes/projects.js.map +1 -1
  246. package/dist/routes/provider-credentials.d.ts.map +1 -1
  247. package/dist/routes/provider-credentials.js +6 -0
  248. package/dist/routes/provider-credentials.js.map +1 -1
  249. package/dist/routes/route.d.ts +2 -0
  250. package/dist/routes/route.d.ts.map +1 -1
  251. package/dist/routes/route.js +5 -1
  252. package/dist/routes/route.js.map +1 -1
  253. package/dist/routes/skills.d.ts.map +1 -1
  254. package/dist/routes/skills.js +2 -5
  255. package/dist/routes/skills.js.map +1 -1
  256. package/dist/routes/source-control-sessions.d.ts.map +1 -1
  257. package/dist/routes/source-control-sessions.js +3 -5
  258. package/dist/routes/source-control-sessions.js.map +1 -1
  259. package/dist/routes/source-control-settings.d.ts.map +1 -1
  260. package/dist/routes/source-control-settings.js +3 -2
  261. package/dist/routes/source-control-settings.js.map +1 -1
  262. package/dist/routes/surface.d.ts +3 -1
  263. package/dist/routes/surface.d.ts.map +1 -1
  264. package/dist/routes/surface.js +27 -17
  265. package/dist/routes/surface.js.map +1 -1
  266. package/dist/routes/telemetry.js +1 -1
  267. package/dist/routes/voice.d.ts +48 -0
  268. package/dist/routes/voice.d.ts.map +1 -0
  269. package/dist/routes/voice.js +248 -0
  270. package/dist/routes/voice.js.map +1 -0
  271. package/dist/routes/work-items.d.ts.map +1 -1
  272. package/dist/routes/work-items.js +9 -12
  273. package/dist/routes/work-items.js.map +1 -1
  274. package/dist/rules/decision-applicability.js +1 -1
  275. package/dist/rules/dispatcher.d.ts +42 -0
  276. package/dist/rules/dispatcher.d.ts.map +1 -1
  277. package/dist/rules/dispatcher.js +522 -136
  278. package/dist/rules/dispatcher.js.map +1 -1
  279. package/dist/rules/event-rules.d.ts +40 -1
  280. package/dist/rules/event-rules.d.ts.map +1 -1
  281. package/dist/rules/event-rules.js +59 -1
  282. package/dist/rules/event-rules.js.map +1 -1
  283. package/dist/rules/index.js +1 -1
  284. package/dist/rules/processor.d.ts +2 -0
  285. package/dist/rules/processor.d.ts.map +1 -1
  286. package/dist/rules/processor.js +5 -4
  287. package/dist/rules/processor.js.map +1 -1
  288. package/dist/rules/start-coordinator.js +2 -2
  289. package/dist/rules/terminal-cleanup.js.map +1 -1
  290. package/dist/rules/tools.js +5 -5
  291. package/dist/rules/transition-service.d.ts +9 -0
  292. package/dist/rules/transition-service.d.ts.map +1 -1
  293. package/dist/rules/transition-service.js +9 -7
  294. package/dist/rules/transition-service.js.map +1 -1
  295. package/dist/rules/types.d.ts +54 -3
  296. package/dist/rules/types.d.ts.map +1 -1
  297. package/dist/rules/types.js +2 -0
  298. package/dist/rules/types.js.map +1 -1
  299. package/dist/rules/validation.d.ts.map +1 -1
  300. package/dist/rules/validation.js +57 -2
  301. package/dist/rules/validation.js.map +1 -1
  302. package/dist/sandbox/session-retirement.js +2 -2
  303. package/dist/sandbox/session-sandbox.js +1 -1
  304. package/dist/session/credential-policy.d.ts +2 -2
  305. package/dist/session/credential-policy.d.ts.map +1 -1
  306. package/dist/session/credential-policy.js +4 -4
  307. package/dist/session/credential-policy.js.map +1 -1
  308. package/dist/session/default-model-hydration.d.ts +2 -2
  309. package/dist/session/default-model-hydration.d.ts.map +1 -1
  310. package/dist/session/default-model-hydration.js +4 -4
  311. package/dist/session/default-model-hydration.js.map +1 -1
  312. package/dist/session/factory-session.js +3 -3
  313. package/dist/session/self-review-gate.js +1 -1
  314. package/dist/session/session-threads.d.ts +8 -0
  315. package/dist/session/session-threads.d.ts.map +1 -1
  316. package/dist/session/session-threads.js +11 -1
  317. package/dist/session/session-threads.js.map +1 -1
  318. package/dist/session/source-control-tools.js +3 -3
  319. package/dist/skills/catalog.js +1 -1
  320. package/dist/storage/domains/audit/actions.d.ts +1 -1
  321. package/dist/storage/domains/audit/actions.d.ts.map +1 -1
  322. package/dist/storage/domains/audit/actions.js +2 -1
  323. package/dist/storage/domains/audit/actions.js.map +1 -1
  324. package/dist/storage/domains/audit/domain.d.ts.map +1 -1
  325. package/dist/storage/domains/audit/domain.js +2 -4
  326. package/dist/storage/domains/audit/domain.js.map +1 -1
  327. package/dist/storage/domains/boards/base.d.ts +32 -1
  328. package/dist/storage/domains/boards/base.d.ts.map +1 -1
  329. package/dist/storage/domains/boards/base.js +155 -8
  330. package/dist/storage/domains/boards/base.js.map +1 -1
  331. package/dist/storage/domains/boards/schemas.d.ts.map +1 -1
  332. package/dist/storage/domains/boards/schemas.js +13 -1
  333. package/dist/storage/domains/boards/schemas.js.map +1 -1
  334. package/dist/storage/domains/comments/base.js +3 -3
  335. package/dist/storage/domains/comments/domain.js +3 -3
  336. package/dist/storage/domains/comments/routes.d.ts.map +1 -1
  337. package/dist/storage/domains/comments/routes.js +2 -4
  338. package/dist/storage/domains/comments/routes.js.map +1 -1
  339. package/dist/storage/domains/memory-settings/base.d.ts +0 -8
  340. package/dist/storage/domains/memory-settings/base.d.ts.map +1 -1
  341. package/dist/storage/domains/memory-settings/base.js +1 -11
  342. package/dist/storage/domains/memory-settings/base.js.map +1 -1
  343. package/dist/storage/domains/projects/base.d.ts +6 -0
  344. package/dist/storage/domains/projects/base.d.ts.map +1 -1
  345. package/dist/storage/domains/projects/base.js +9 -1
  346. package/dist/storage/domains/projects/base.js.map +1 -1
  347. package/dist/storage/domains/source-control/base.d.ts +20 -0
  348. package/dist/storage/domains/source-control/base.d.ts.map +1 -1
  349. package/dist/storage/domains/source-control/base.js +42 -0
  350. package/dist/storage/domains/source-control/base.js.map +1 -1
  351. package/dist/storage/domains/source-control/inmemory.d.ts +5 -1
  352. package/dist/storage/domains/source-control/inmemory.d.ts.map +1 -1
  353. package/dist/storage/domains/source-control/inmemory.js +23 -0
  354. package/dist/storage/domains/source-control/inmemory.js.map +1 -1
  355. package/dist/storage/domains/voice-settings/base.d.ts +31 -0
  356. package/dist/storage/domains/voice-settings/base.d.ts.map +1 -0
  357. package/dist/storage/domains/voice-settings/base.js +81 -0
  358. package/dist/storage/domains/voice-settings/base.js.map +1 -0
  359. package/dist/storage/domains/work-items/base.d.ts +47 -7
  360. package/dist/storage/domains/work-items/base.d.ts.map +1 -1
  361. package/dist/storage/domains/work-items/base.js +251 -115
  362. package/dist/storage/domains/work-items/base.js.map +1 -1
  363. package/dist/storage/domains/work-items/cards.d.ts +6 -1
  364. package/dist/storage/domains/work-items/cards.d.ts.map +1 -1
  365. package/dist/storage/domains/work-items/cards.js +55 -5
  366. package/dist/storage/domains/work-items/cards.js.map +1 -1
  367. package/dist/storage/domains/work-items/claimable-work.d.ts +15 -0
  368. package/dist/storage/domains/work-items/claimable-work.d.ts.map +1 -0
  369. package/dist/storage/domains/work-items/claimable-work.js +51 -0
  370. package/dist/storage/domains/work-items/claimable-work.js.map +1 -0
  371. package/dist/storage/domains/work-items/work-item-schema.d.ts +2 -0
  372. package/dist/storage/domains/work-items/work-item-schema.d.ts.map +1 -1
  373. package/dist/storage/domains/work-items/work-item-schema.js +24 -1
  374. package/dist/storage/domains/work-items/work-item-schema.js.map +1 -1
  375. package/dist/timing.d.ts +1 -0
  376. package/dist/timing.d.ts.map +1 -1
  377. package/dist/timing.js +1 -1
  378. package/dist/timing.js.map +1 -1
  379. package/dist/tools/index.js +2 -2
  380. package/dist/tools/messaging-tools.js +1 -1
  381. package/dist/tools/read-tools.d.ts +2 -2
  382. package/dist/tools/read-tools.d.ts.map +1 -1
  383. package/dist/tools/read-tools.js +10 -9
  384. package/dist/tools/read-tools.js.map +1 -1
  385. package/dist/tools/scope.js +1 -1
  386. package/dist/tools/session-tools.d.ts +1 -1
  387. package/dist/tools/session-tools.d.ts.map +1 -1
  388. package/dist/tools/session-tools.js +9 -9
  389. package/dist/tools/session-tools.js.map +1 -1
  390. package/dist/tools/sessions-state-processor.d.ts +1 -1
  391. package/dist/tools/sessions-state-processor.d.ts.map +1 -1
  392. package/dist/tools/sessions-state-processor.js +9 -2
  393. package/dist/tools/sessions-state-processor.js.map +1 -1
  394. package/dist/tools/work-item-tools.js +4 -4
  395. package/dist/voice/rate-limit.d.ts +13 -0
  396. package/dist/voice/rate-limit.d.ts.map +1 -0
  397. package/dist/voice/rate-limit.js +36 -0
  398. package/dist/voice/rate-limit.js.map +1 -0
  399. package/dist/voice/realtime.d.ts +13 -0
  400. package/dist/voice/realtime.d.ts.map +1 -0
  401. package/dist/voice/realtime.js +56 -0
  402. package/dist/voice/realtime.js.map +1 -0
  403. package/dist/voice/transcription.d.ts +51 -0
  404. package/dist/voice/transcription.d.ts.map +1 -0
  405. package/dist/voice/transcription.js +112 -0
  406. package/dist/voice/transcription.js.map +1 -0
  407. package/dist/work-items/create-work-item.js +2 -2
  408. package/dist/work-items/decision-actions.js +2 -2
  409. package/dist/work-items/providers/gitlab.js +1 -1
  410. package/dist/work-items/providers/incidentio.js +1 -1
  411. package/dist/work-items/providers/index.js +1 -1
  412. package/dist/work-items/providers/jira.js +1 -1
  413. package/dist/work-items/providers/linear.js +1 -1
  414. package/dist/work-items/split-backfill.d.ts +13 -0
  415. package/dist/work-items/split-backfill.d.ts.map +1 -0
  416. package/dist/work-items/split-backfill.js +32 -0
  417. package/dist/work-items/split-backfill.js.map +1 -0
  418. package/dist/work-items/split-migration.d.ts +39 -2
  419. package/dist/work-items/split-migration.d.ts.map +1 -1
  420. package/dist/work-items/split-migration.js +171 -63
  421. package/dist/work-items/split-migration.js.map +1 -1
  422. package/dist/workspace.d.ts +2 -0
  423. package/dist/workspace.d.ts.map +1 -1
  424. package/dist/workspace.js +12 -9
  425. package/dist/workspace.js.map +1 -1
  426. package/package.json +10 -9
@@ -0,0 +1,201 @@
1
+ import { tenantOrgId } from "../../routes/provider-credentials.js";
2
+ import { effectiveModelScope } from "../../storage/domains/projects/base.js";
3
+ import { chooseSTTModel, savedSTTModel, tenantVoiceCaller, transcribeAudio, transcriptionFailureReason, voicePolicy } from "../../voice/transcription.js";
4
+ import { voiceSettingsLink } from "./channel-reply-processor.js";
5
+ import { z } from "zod";
6
+ import { classifyProviderError } from "@mastra/core/error";
7
+ import { Actions, Card, CardText, LinkButton } from "chat";
8
+ // src/integrations/slack/voice-clips.ts
9
+ /** Download plus provider call, per clip. The provider call isn't cancelled; a late result is dropped. */
10
+ const VOICE_CLIP_TIMEOUT_MS = 6e4;
11
+ const DOWNLOAD_FAILED = {
12
+ reason: "The clip could not be downloaded.",
13
+ fix: "retry"
14
+ };
15
+ const TOO_LONG = {
16
+ reason: "The clip is too long.",
17
+ fix: "shorter"
18
+ };
19
+ const slackEventFiles = z.object({ files: z.array(z.object({
20
+ subtype: z.string().optional(),
21
+ url_private: z.string().optional()
22
+ })) });
23
+ /** Slack marks composer recordings with `subtype: 'slack_audio'` and names them `audio_message.*`; other audio is an upload. */
24
+ function recordedClipUrls(message) {
25
+ const event = slackEventFiles.safeParse(message.raw);
26
+ if (!event.success) return /* @__PURE__ */ new Set();
27
+ return new Set(event.data.files.flatMap((file) => file.subtype === "slack_audio" && file.url_private ? [file.url_private] : []));
28
+ }
29
+ function voiceClips(message) {
30
+ const recorded = recordedClipUrls(message);
31
+ return message.attachments.filter((attachment) => attachment.url !== void 0 && recorded.has(attachment.url) || (attachment.type === "audio" || attachment.type === "video") && (attachment.name?.startsWith("audio_message") ?? false));
32
+ }
33
+ function say(message, text) {
34
+ message.text = message.text ? `${message.text}\n\n${text}` : text;
35
+ message.formatted.children.push({
36
+ type: "paragraph",
37
+ children: [{
38
+ type: "text",
39
+ value: text
40
+ }]
41
+ });
42
+ }
43
+ function detach(message, clip) {
44
+ message.attachments = message.attachments.filter((attachment) => attachment !== clip);
45
+ }
46
+ function sentence(fragment) {
47
+ return `${fragment.charAt(0).toUpperCase()}${fragment.slice(1)}.`;
48
+ }
49
+ const SETUP_FAILURES = /* @__PURE__ */ new Set([
50
+ "auth",
51
+ "quota",
52
+ "model_rejected"
53
+ ]);
54
+ function providerFailure(error) {
55
+ return {
56
+ reason: sentence(transcriptionFailureReason(error)),
57
+ fix: SETUP_FAILURES.has(classifyProviderError(error)) ? "settings" : "retry"
58
+ };
59
+ }
60
+ async function transcribeClip(selection, fetchData, mimeType) {
61
+ const data = await fetchData().catch((error) => {
62
+ console.warn("[slack] voice clip download failed", { error });
63
+ });
64
+ if (data === void 0) return DOWNLOAD_FAILED;
65
+ const audio = data instanceof ArrayBuffer ? Buffer.from(data) : data;
66
+ if (audio.byteLength > 8388608) return TOO_LONG;
67
+ const transcript = await transcribeAudio(selection, audio, mimeType);
68
+ return transcript ? { transcript } : {
69
+ reason: "No speech was detected in the clip.",
70
+ fix: "rerecord"
71
+ };
72
+ }
73
+ async function withinTimeout(work) {
74
+ let timer;
75
+ const timedOut = new Promise((resolve) => {
76
+ timer = setTimeout(() => resolve({
77
+ reason: `Transcription timed out after ${VOICE_CLIP_TIMEOUT_MS / 1e3} seconds.`,
78
+ fix: "retry"
79
+ }), VOICE_CLIP_TIMEOUT_MS);
80
+ });
81
+ try {
82
+ return await Promise.race([work, timedOut]);
83
+ } finally {
84
+ clearTimeout(timer);
85
+ }
86
+ }
87
+ async function resolveSettingsFactory(run, home) {
88
+ if (run) return run.id;
89
+ const factory = await home?.().catch((error) => {
90
+ console.warn("[slack] voice clip settings Factory lookup failed", { error });
91
+ });
92
+ return factory && effectiveModelScope(factory.modelScope, "session") !== "factory" ? factory.id : void 0;
93
+ }
94
+ async function transcribeAll(clips, sender, modelCredentials, voiceSettings, factory) {
95
+ const failEvery = (failure) => clips.map(() => failure);
96
+ const orgId = tenantOrgId(sender);
97
+ let choice;
98
+ try {
99
+ const records = await modelCredentials.listCredentials(orgId, sender.userId);
100
+ const policy = voicePolicy(tenantVoiceCaller(records, orgId, sender.userId), factory);
101
+ const saved = voiceSettings ? await savedSTTModel(voiceSettings, policy.settingsKey) : void 0;
102
+ choice = chooseSTTModel(policy, saved);
103
+ } catch (error) {
104
+ console.warn("[slack] voice clip settings lookup failed", { error });
105
+ return failEvery({
106
+ reason: "Speech-to-text settings could not be loaded.",
107
+ fix: "retry"
108
+ });
109
+ }
110
+ if ("error" in choice) return failEvery({
111
+ reason: choice.error,
112
+ fix: "settings"
113
+ });
114
+ const failures = [];
115
+ for (const { message, clip } of clips) {
116
+ const outcome = await transcribeAttachment(choice, message, clip);
117
+ if ("transcript" in outcome) say(message, outcome.transcript);
118
+ else failures.push(outcome);
119
+ }
120
+ return failures;
121
+ }
122
+ async function transcribeVoiceClips(messages, sender, deps, factories = {}) {
123
+ const clips = messages.flatMap((message) => voiceClips(message).map((clip) => ({
124
+ message,
125
+ clip
126
+ })));
127
+ if (clips.length === 0) return {
128
+ transcribed: 0,
129
+ failures: []
130
+ };
131
+ if (!sender || !deps.modelCredentials) {
132
+ for (const { message, clip } of clips) detach(message, clip);
133
+ const failure = {
134
+ reason: "Voice clips need a linked Mastra account with a speech-to-text API key.",
135
+ fix: "none"
136
+ };
137
+ return {
138
+ transcribed: 0,
139
+ failures: clips.map(() => failure)
140
+ };
141
+ }
142
+ const factory = await factories.run?.();
143
+ const failures = await transcribeAll(clips, sender, deps.modelCredentials, deps.voiceSettings, factory);
144
+ for (const { message, clip } of clips) detach(message, clip);
145
+ const transcribed = clips.length - failures.length;
146
+ if (!failures.some((failure) => failure.fix === "settings")) return {
147
+ transcribed,
148
+ failures
149
+ };
150
+ const settingsFactoryId = await resolveSettingsFactory(factory, factories.home);
151
+ return settingsFactoryId ? {
152
+ transcribed,
153
+ failures,
154
+ settingsFactoryId
155
+ } : {
156
+ transcribed,
157
+ failures
158
+ };
159
+ }
160
+ async function transcribeAttachment(selection, message, clip) {
161
+ if (!clip.fetchData) return DOWNLOAD_FAILED;
162
+ if (clip.size !== void 0 && clip.size > 8388608) return TOO_LONG;
163
+ try {
164
+ return await withinTimeout(transcribeClip(selection, clip.fetchData, clip.mimeType ?? "audio/mp4"));
165
+ } catch (error) {
166
+ console.warn("[slack] voice clip transcription failed", {
167
+ messageId: message.id,
168
+ error
169
+ });
170
+ return providerFailure(error);
171
+ }
172
+ }
173
+ function nextStep(fix, retryHint) {
174
+ switch (fix) {
175
+ case "settings": return `Once that's fixed, ${retryHint} with the clip.`;
176
+ case "retry": return `Wait a moment, then ${retryHint} with the clip.`;
177
+ case "shorter": return "Record a shorter clip, or type your message instead.";
178
+ case "rerecord": return "Record the clip again.";
179
+ case "none": return;
180
+ }
181
+ }
182
+ function voiceClipFailureCard({ failures, settingsFactoryId }, retryHint) {
183
+ const reasons = [...new Set(failures.map((failure) => failure.reason))];
184
+ const fixes = [...new Set(failures.map((failure) => failure.fix))];
185
+ const steps = fixes.flatMap((fix) => nextStep(fix, retryHint) ?? []);
186
+ const settingsUrl = fixes.includes("settings") && settingsFactoryId ? voiceSettingsLink(settingsFactoryId) : void 0;
187
+ return Card({
188
+ title: failures.length === 1 ? "Voice clip not transcribed" : `${failures.length} voice clips not transcribed`,
189
+ children: [
190
+ CardText(reasons.join("\n")),
191
+ ...steps.length > 0 ? [CardText(steps.join(" "))] : [],
192
+ ...settingsUrl ? [Actions([LinkButton({
193
+ url: settingsUrl,
194
+ label: "Open voice settings"
195
+ })])] : []
196
+ ]
197
+ });
198
+ }
199
+ export { VOICE_CLIP_TIMEOUT_MS, transcribeVoiceClips, voiceClipFailureCard };
200
+
201
+ //# sourceMappingURL=voice-clips.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"voice-clips.js","names":[],"sources":["../../../src/integrations/slack/voice-clips.ts"],"sourcesContent":["import type { ChannelHandler } from '@mastra/core/channels';\nimport { classifyProviderError } from '@mastra/core/error';\nimport type { ProviderFailureKind } from '@mastra/core/error';\nimport { Actions, Card, CardText, LinkButton } from 'chat';\nimport { z } from 'zod';\n\nimport { tenantOrgId } from '../../routes/provider-credentials.js';\nimport type { ModelCredentialsStorage } from '../../storage/domains/credentials/base.js';\nimport { effectiveModelScope } from '../../storage/domains/projects/base.js';\nimport type { VoiceSettingsStorage } from '../../storage/domains/voice-settings/base.js';\nimport type { STTChoice, STTSelection, VoiceFactory } from '../../voice/transcription.js';\nimport {\n chooseSTTModel,\n MAX_TRANSCRIBE_AUDIO_BYTES,\n savedSTTModel,\n tenantVoiceCaller,\n transcribeAudio,\n transcriptionFailureReason,\n voicePolicy,\n} from '../../voice/transcription.js';\nimport { voiceSettingsLink } from './channel-reply-processor.js';\n\ntype HandlerMessage = Parameters<ChannelHandler>[1];\ntype HandlerAttachment = HandlerMessage['attachments'][number];\n\n/** Download plus provider call, per clip. The provider call isn't cancelled; a late result is dropped. */\nexport const VOICE_CLIP_TIMEOUT_MS = 60_000;\n\ntype VoiceClipFix = 'settings' | 'retry' | 'shorter' | 'rerecord' | 'none';\n\nexport interface VoiceClipFailure {\n reason: string;\n fix: VoiceClipFix;\n}\n\nexport interface VoiceClipReport {\n transcribed: number;\n failures: VoiceClipFailure[];\n settingsFactoryId?: string;\n}\n\nexport interface VoiceClipFactories {\n run?: () => Promise<VoiceFactory | undefined>;\n home?: () => Promise<VoiceFactory | undefined>;\n}\n\ntype ClipOutcome = { transcript: string } | VoiceClipFailure;\n\nconst DOWNLOAD_FAILED: VoiceClipFailure = { reason: 'The clip could not be downloaded.', fix: 'retry' };\nconst TOO_LONG: VoiceClipFailure = { reason: 'The clip is too long.', fix: 'shorter' };\n\nexport interface VoiceClipDeps {\n modelCredentials?: ModelCredentialsStorage;\n voiceSettings?: VoiceSettingsStorage;\n}\n\nconst slackEventFiles = z.object({\n files: z.array(z.object({ subtype: z.string().optional(), url_private: z.string().optional() })),\n});\n\n/** Slack marks composer recordings with `subtype: 'slack_audio'` and names them `audio_message.*`; other audio is an upload. */\nfunction recordedClipUrls(message: HandlerMessage): Set<string> {\n const event = slackEventFiles.safeParse(message.raw);\n if (!event.success) return new Set();\n return new Set(\n event.data.files.flatMap(file => (file.subtype === 'slack_audio' && file.url_private ? [file.url_private] : [])),\n );\n}\n\nfunction voiceClips(message: HandlerMessage): HandlerAttachment[] {\n const recorded = recordedClipUrls(message);\n return message.attachments.filter(\n attachment =>\n (attachment.url !== undefined && recorded.has(attachment.url)) ||\n ((attachment.type === 'audio' || attachment.type === 'video') &&\n (attachment.name?.startsWith('audio_message') ?? false)),\n );\n}\n\nfunction say(message: HandlerMessage, text: string): void {\n message.text = message.text ? `${message.text}\\n\\n${text}` : text;\n message.formatted.children.push({ type: 'paragraph', children: [{ type: 'text', value: text }] });\n}\n\nfunction detach(message: HandlerMessage, clip: HandlerAttachment): void {\n message.attachments = message.attachments.filter(attachment => attachment !== clip);\n}\n\nfunction sentence(fragment: string): string {\n return `${fragment.charAt(0).toUpperCase()}${fragment.slice(1)}.`;\n}\n\nconst SETUP_FAILURES = new Set<ProviderFailureKind>(['auth', 'quota', 'model_rejected']);\n\nfunction providerFailure(error: unknown): VoiceClipFailure {\n return {\n reason: sentence(transcriptionFailureReason(error)),\n fix: SETUP_FAILURES.has(classifyProviderError(error)) ? 'settings' : 'retry',\n };\n}\n\nasync function transcribeClip(\n selection: STTSelection,\n fetchData: () => Promise<Buffer | ArrayBuffer>,\n mimeType: string,\n): Promise<ClipOutcome> {\n const data = await fetchData().catch((error: unknown) => {\n console.warn('[slack] voice clip download failed', { error });\n return undefined;\n });\n if (data === undefined) return DOWNLOAD_FAILED;\n const audio = data instanceof ArrayBuffer ? Buffer.from(data) : data;\n if (audio.byteLength > MAX_TRANSCRIBE_AUDIO_BYTES) return TOO_LONG;\n const transcript = await transcribeAudio(selection, audio, mimeType);\n return transcript ? { transcript } : { reason: 'No speech was detected in the clip.', fix: 'rerecord' };\n}\n\nasync function withinTimeout(work: Promise<ClipOutcome>): Promise<ClipOutcome> {\n let timer: NodeJS.Timeout | undefined;\n const timedOut = new Promise<ClipOutcome>(resolve => {\n timer = setTimeout(\n () => resolve({ reason: `Transcription timed out after ${VOICE_CLIP_TIMEOUT_MS / 1000} seconds.`, fix: 'retry' }),\n VOICE_CLIP_TIMEOUT_MS,\n );\n });\n try {\n return await Promise.race([work, timedOut]);\n } finally {\n clearTimeout(timer);\n }\n}\n\nasync function resolveSettingsFactory(\n run: VoiceFactory | undefined,\n home: VoiceClipFactories['home'],\n): Promise<string | undefined> {\n if (run) return run.id;\n const factory = await home?.().catch((error: unknown) => {\n console.warn('[slack] voice clip settings Factory lookup failed', { error });\n return undefined;\n });\n return factory && effectiveModelScope(factory.modelScope, 'session') !== 'factory' ? factory.id : undefined;\n}\n\nasync function transcribeAll(\n clips: { message: HandlerMessage; clip: HandlerAttachment }[],\n sender: { orgId?: string; userId: string },\n modelCredentials: ModelCredentialsStorage,\n voiceSettings: VoiceSettingsStorage | undefined,\n factory: VoiceFactory | undefined,\n): Promise<VoiceClipFailure[]> {\n const failEvery = (failure: VoiceClipFailure) => clips.map(() => failure);\n const orgId = tenantOrgId(sender);\n let choice: STTChoice;\n try {\n const records = await modelCredentials.listCredentials(orgId, sender.userId);\n const policy = voicePolicy(tenantVoiceCaller(records, orgId, sender.userId), factory);\n const saved = voiceSettings ? await savedSTTModel(voiceSettings, policy.settingsKey) : undefined;\n choice = chooseSTTModel(policy, saved);\n } catch (error) {\n console.warn('[slack] voice clip settings lookup failed', { error });\n return failEvery({ reason: 'Speech-to-text settings could not be loaded.', fix: 'retry' });\n }\n if ('error' in choice) return failEvery({ reason: choice.error, fix: 'settings' });\n\n const failures: VoiceClipFailure[] = [];\n for (const { message, clip } of clips) {\n const outcome = await transcribeAttachment(choice, message, clip);\n if ('transcript' in outcome) say(message, outcome.transcript);\n else failures.push(outcome);\n }\n return failures;\n}\n\nexport async function transcribeVoiceClips(\n messages: readonly HandlerMessage[],\n sender: { orgId?: string; userId: string } | undefined,\n deps: VoiceClipDeps,\n factories: VoiceClipFactories = {},\n): Promise<VoiceClipReport> {\n const clips = messages.flatMap(message => voiceClips(message).map(clip => ({ message, clip })));\n if (clips.length === 0) return { transcribed: 0, failures: [] };\n\n if (!sender || !deps.modelCredentials) {\n for (const { message, clip } of clips) detach(message, clip);\n const failure: VoiceClipFailure = {\n reason: 'Voice clips need a linked Mastra account with a speech-to-text API key.',\n fix: 'none',\n };\n return { transcribed: 0, failures: clips.map(() => failure) };\n }\n\n // Routing failures stay fatal: the message must not run under the wrong Factory.\n const factory = await factories.run?.();\n const failures = await transcribeAll(clips, sender, deps.modelCredentials, deps.voiceSettings, factory);\n for (const { message, clip } of clips) detach(message, clip);\n const transcribed = clips.length - failures.length;\n if (!failures.some(failure => failure.fix === 'settings')) return { transcribed, failures };\n const settingsFactoryId = await resolveSettingsFactory(factory, factories.home);\n return settingsFactoryId ? { transcribed, failures, settingsFactoryId } : { transcribed, failures };\n}\n\nasync function transcribeAttachment(\n selection: STTSelection,\n message: HandlerMessage,\n clip: HandlerAttachment,\n): Promise<ClipOutcome> {\n if (!clip.fetchData) return DOWNLOAD_FAILED;\n if (clip.size !== undefined && clip.size > MAX_TRANSCRIBE_AUDIO_BYTES) return TOO_LONG;\n try {\n return await withinTimeout(transcribeClip(selection, clip.fetchData, clip.mimeType ?? 'audio/mp4'));\n } catch (error) {\n console.warn('[slack] voice clip transcription failed', { messageId: message.id, error });\n return providerFailure(error);\n }\n}\n\nfunction nextStep(fix: VoiceClipFix, retryHint: string): string | undefined {\n switch (fix) {\n case 'settings':\n return `Once that's fixed, ${retryHint} with the clip.`;\n case 'retry':\n return `Wait a moment, then ${retryHint} with the clip.`;\n case 'shorter':\n return 'Record a shorter clip, or type your message instead.';\n case 'rerecord':\n return 'Record the clip again.';\n case 'none':\n return undefined;\n }\n}\n\nexport function voiceClipFailureCard({ failures, settingsFactoryId }: VoiceClipReport, retryHint: string) {\n const reasons = [...new Set(failures.map(failure => failure.reason))];\n const fixes = [...new Set(failures.map(failure => failure.fix))];\n const steps = fixes.flatMap(fix => nextStep(fix, retryHint) ?? []);\n const settingsUrl = fixes.includes('settings') && settingsFactoryId ? voiceSettingsLink(settingsFactoryId) : undefined;\n return Card({\n title: failures.length === 1 ? 'Voice clip not transcribed' : `${failures.length} voice clips not transcribed`,\n children: [\n CardText(reasons.join('\\n')),\n ...(steps.length > 0 ? [CardText(steps.join(' '))] : []),\n ...(settingsUrl ? [Actions([LinkButton({ url: settingsUrl, label: 'Open voice settings' })])] : []),\n ],\n });\n}\n"],"mappings":";;;;;;;;;AA0BA,MAAa,wBAAwB;AAsBrC,MAAM,kBAAoC;CAAE,QAAQ;CAAqC,KAAK;AAAQ;AACtG,MAAM,WAA6B;CAAE,QAAQ;CAAyB,KAAK;AAAU;AAOrF,MAAM,kBAAkB,EAAE,OAAO,EAC/B,OAAO,EAAE,MAAM,EAAE,OAAO;CAAE,SAAS,EAAE,OAAO,CAAC,CAAC,SAAS;CAAG,aAAa,EAAE,OAAO,CAAC,CAAC,SAAS;AAAE,CAAC,CAAC,EACjG,CAAC;;AAGD,SAAS,iBAAiB,SAAsC;CAC9D,MAAM,QAAQ,gBAAgB,UAAU,QAAQ,GAAG;CACnD,IAAI,CAAC,MAAM,SAAS,uBAAO,IAAI,IAAI;CACnC,OAAO,IAAI,IACT,MAAM,KAAK,MAAM,SAAQ,SAAS,KAAK,YAAY,iBAAiB,KAAK,cAAc,CAAC,KAAK,WAAW,IAAI,CAAC,CAAE,CACjH;AACF;AAEA,SAAS,WAAW,SAA8C;CAChE,MAAM,WAAW,iBAAiB,OAAO;CACzC,OAAO,QAAQ,YAAY,QACzB,eACG,WAAW,QAAQ,KAAA,KAAa,SAAS,IAAI,WAAW,GAAG,MAC1D,WAAW,SAAS,WAAW,WAAW,SAAS,aAClD,WAAW,MAAM,WAAW,eAAe,KAAK,MACvD;AACF;AAEA,SAAS,IAAI,SAAyB,MAAoB;CACxD,QAAQ,OAAO,QAAQ,OAAO,GAAG,QAAQ,KAAK,MAAM,SAAS;CAC7D,QAAQ,UAAU,SAAS,KAAK;EAAE,MAAM;EAAa,UAAU,CAAC;GAAE,MAAM;GAAQ,OAAO;EAAK,CAAC;CAAE,CAAC;AAClG;AAEA,SAAS,OAAO,SAAyB,MAA+B;CACtE,QAAQ,cAAc,QAAQ,YAAY,QAAO,eAAc,eAAe,IAAI;AACpF;AAEA,SAAS,SAAS,UAA0B;CAC1C,OAAO,GAAG,SAAS,OAAO,CAAC,CAAC,CAAC,YAAY,IAAI,SAAS,MAAM,CAAC,EAAE;AACjE;AAEA,MAAM,iCAAiB,IAAI,IAAyB;CAAC;CAAQ;CAAS;AAAgB,CAAC;AAEvF,SAAS,gBAAgB,OAAkC;CACzD,OAAO;EACL,QAAQ,SAAS,2BAA2B,KAAK,CAAC;EAClD,KAAK,eAAe,IAAI,sBAAsB,KAAK,CAAC,IAAI,aAAa;CACvE;AACF;AAEA,eAAe,eACb,WACA,WACA,UACsB;CACtB,MAAM,OAAO,MAAM,UAAU,CAAC,CAAC,OAAO,UAAmB;EACvD,QAAQ,KAAK,sCAAsC,EAAE,MAAM,CAAC;CAE9D,CAAC;CACD,IAAI,SAAS,KAAA,GAAW,OAAO;CAC/B,MAAM,QAAQ,gBAAgB,cAAc,OAAO,KAAK,IAAI,IAAI;CAChE,IAAI,MAAM,aAAA,SAAyC,OAAO;CAC1D,MAAM,aAAa,MAAM,gBAAgB,WAAW,OAAO,QAAQ;CACnE,OAAO,aAAa,EAAE,WAAW,IAAI;EAAE,QAAQ;EAAuC,KAAK;CAAW;AACxG;AAEA,eAAe,cAAc,MAAkD;CAC7E,IAAI;CACJ,MAAM,WAAW,IAAI,SAAqB,YAAW;EACnD,QAAQ,iBACA,QAAQ;GAAE,QAAQ,iCAAiC,wBAAwB,IAAK;GAAY,KAAK;EAAQ,CAAC,GAChH,qBACF;CACF,CAAC;CACD,IAAI;EACF,OAAO,MAAM,QAAQ,KAAK,CAAC,MAAM,QAAQ,CAAC;CAC5C,UAAU;EACR,aAAa,KAAK;CACpB;AACF;AAEA,eAAe,uBACb,KACA,MAC6B;CAC7B,IAAI,KAAK,OAAO,IAAI;CACpB,MAAM,UAAU,MAAM,OAAO,CAAC,CAAC,OAAO,UAAmB;EACvD,QAAQ,KAAK,qDAAqD,EAAE,MAAM,CAAC;CAE7E,CAAC;CACD,OAAO,WAAW,oBAAoB,QAAQ,YAAY,SAAS,MAAM,YAAY,QAAQ,KAAK,KAAA;AACpG;AAEA,eAAe,cACb,OACA,QACA,kBACA,eACA,SAC6B;CAC7B,MAAM,aAAa,YAA8B,MAAM,UAAU,OAAO;CACxE,MAAM,QAAQ,YAAY,MAAM;CAChC,IAAI;CACJ,IAAI;EACF,MAAM,UAAU,MAAM,iBAAiB,gBAAgB,OAAO,OAAO,MAAM;EAC3E,MAAM,SAAS,YAAY,kBAAkB,SAAS,OAAO,OAAO,MAAM,GAAG,OAAO;EACpF,MAAM,QAAQ,gBAAgB,MAAM,cAAc,eAAe,OAAO,WAAW,IAAI,KAAA;EACvF,SAAS,eAAe,QAAQ,KAAK;CACvC,SAAS,OAAO;EACd,QAAQ,KAAK,6CAA6C,EAAE,MAAM,CAAC;EACnE,OAAO,UAAU;GAAE,QAAQ;GAAgD,KAAK;EAAQ,CAAC;CAC3F;CACA,IAAI,WAAW,QAAQ,OAAO,UAAU;EAAE,QAAQ,OAAO;EAAO,KAAK;CAAW,CAAC;CAEjF,MAAM,WAA+B,CAAC;CACtC,KAAK,MAAM,EAAE,SAAS,UAAU,OAAO;EACrC,MAAM,UAAU,MAAM,qBAAqB,QAAQ,SAAS,IAAI;EAChE,IAAI,gBAAgB,SAAS,IAAI,SAAS,QAAQ,UAAU;OACvD,SAAS,KAAK,OAAO;CAC5B;CACA,OAAO;AACT;AAEA,eAAsB,qBACpB,UACA,QACA,MACA,YAAgC,CAAC,GACP;CAC1B,MAAM,QAAQ,SAAS,SAAQ,YAAW,WAAW,OAAO,CAAC,CAAC,KAAI,UAAS;EAAE;EAAS;CAAK,EAAE,CAAC;CAC9F,IAAI,MAAM,WAAW,GAAG,OAAO;EAAE,aAAa;EAAG,UAAU,CAAC;CAAE;CAE9D,IAAI,CAAC,UAAU,CAAC,KAAK,kBAAkB;EACrC,KAAK,MAAM,EAAE,SAAS,UAAU,OAAO,OAAO,SAAS,IAAI;EAC3D,MAAM,UAA4B;GAChC,QAAQ;GACR,KAAK;EACP;EACA,OAAO;GAAE,aAAa;GAAG,UAAU,MAAM,UAAU,OAAO;EAAE;CAC9D;CAGA,MAAM,UAAU,MAAM,UAAU,MAAM;CACtC,MAAM,WAAW,MAAM,cAAc,OAAO,QAAQ,KAAK,kBAAkB,KAAK,eAAe,OAAO;CACtG,KAAK,MAAM,EAAE,SAAS,UAAU,OAAO,OAAO,SAAS,IAAI;CAC3D,MAAM,cAAc,MAAM,SAAS,SAAS;CAC5C,IAAI,CAAC,SAAS,MAAK,YAAW,QAAQ,QAAQ,UAAU,GAAG,OAAO;EAAE;EAAa;CAAS;CAC1F,MAAM,oBAAoB,MAAM,uBAAuB,SAAS,UAAU,IAAI;CAC9E,OAAO,oBAAoB;EAAE;EAAa;EAAU;CAAkB,IAAI;EAAE;EAAa;CAAS;AACpG;AAEA,eAAe,qBACb,WACA,SACA,MACsB;CACtB,IAAI,CAAC,KAAK,WAAW,OAAO;CAC5B,IAAI,KAAK,SAAS,KAAA,KAAa,KAAK,OAAA,SAAmC,OAAO;CAC9E,IAAI;EACF,OAAO,MAAM,cAAc,eAAe,WAAW,KAAK,WAAW,KAAK,YAAY,WAAW,CAAC;CACpG,SAAS,OAAO;EACd,QAAQ,KAAK,2CAA2C;GAAE,WAAW,QAAQ;GAAI;EAAM,CAAC;EACxF,OAAO,gBAAgB,KAAK;CAC9B;AACF;AAEA,SAAS,SAAS,KAAmB,WAAuC;CAC1E,QAAQ,KAAR;EACE,KAAK,YACH,OAAO,sBAAsB,UAAU;EACzC,KAAK,SACH,OAAO,uBAAuB,UAAU;EAC1C,KAAK,WACH,OAAO;EACT,KAAK,YACH,OAAO;EACT,KAAK,QACH;CACJ;AACF;AAEA,SAAgB,qBAAqB,EAAE,UAAU,qBAAsC,WAAmB;CACxG,MAAM,UAAU,CAAC,GAAG,IAAI,IAAI,SAAS,KAAI,YAAW,QAAQ,MAAM,CAAC,CAAC;CACpE,MAAM,QAAQ,CAAC,GAAG,IAAI,IAAI,SAAS,KAAI,YAAW,QAAQ,GAAG,CAAC,CAAC;CAC/D,MAAM,QAAQ,MAAM,SAAQ,QAAO,SAAS,KAAK,SAAS,KAAK,CAAC,CAAC;CACjE,MAAM,cAAc,MAAM,SAAS,UAAU,KAAK,oBAAoB,kBAAkB,iBAAiB,IAAI,KAAA;CAC7G,OAAO,KAAK;EACV,OAAO,SAAS,WAAW,IAAI,+BAA+B,GAAG,SAAS,OAAO;EACjF,UAAU;GACR,SAAS,QAAQ,KAAK,IAAI,CAAC;GAC3B,GAAI,MAAM,SAAS,IAAI,CAAC,SAAS,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC;GACtD,GAAI,cAAc,CAAC,QAAQ,CAAC,WAAW;IAAE,KAAK;IAAa,OAAO;GAAsB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;EACnG;CACF,CAAC;AACH"}
@@ -1 +1 @@
1
- {"version":3,"file":"integration.d.ts","sourceRoot":"","sources":["../../../src/integrations/workos/integration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAIpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEzE,KAAK,YAAY,GAAG,qBAAqB,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;AAyBvE,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,IAAI,CAAC;IACjB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5D,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CACrD,CAgBA;AAED,sFAAsF;AACtF,qBAAa,sBAAuB,YAAW,kBAAkB;;IAC/D,QAAQ,CAAC,EAAE,YAAY;IAIvB,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE;QAAE,MAAM,EAAE,YAAY,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAG7E;IAEK,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE;QAAE,KAAK,EAAE,aAAa,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAS9D;IAED,MAAM,CAAC,GAAG,EAAE,kBAAkB,GAAG,QAAQ,EAAE,CA8B1C;IAED,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAErC;CACF"}
1
+ {"version":3,"file":"integration.d.ts","sourceRoot":"","sources":["../../../src/integrations/workos/integration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAIpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEzE,KAAK,YAAY,GAAG,qBAAqB,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;AAqBvE,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,IAAI,CAAC;IACjB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5D,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CACrD,CAgBA;AAED,sFAAsF;AACtF,qBAAa,sBAAuB,YAAW,kBAAkB;;IAC/D,QAAQ,CAAC,EAAE,YAAY;IAIvB,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE;QAAE,MAAM,EAAE,YAAY,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAG7E;IAEK,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE;QAAE,KAAK,EAAE,aAAa,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAS9D;IAED,MAAM,CAAC,GAAG,EAAE,kBAAkB,GAAG,QAAQ,EAAE,CA8B1C;IAED,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAErC;CACF"}
@@ -1,10 +1,8 @@
1
+ import { loose } from "../../routes/route.js";
1
2
  import { WorkOSAdminPortal } from "@mastra/auth-workos";
2
3
  import { registerApiRoute } from "@mastra/core/server";
3
4
  // src/integrations/workos/integration.ts
4
5
  const UNKNOWN_LOCATION = "unknown";
5
- function loose(c) {
6
- return c;
7
- }
8
6
  function flattenMetadata(metadata) {
9
7
  const flat = {};
10
8
  for (const [key, value] of Object.entries(metadata)) {
@@ -1 +1 @@
1
- {"version":3,"file":"integration.js","names":[],"sources":["../../../src/integrations/workos/integration.ts"],"sourcesContent":["import { WorkOSAdminPortal } from '@mastra/auth-workos';\nimport type { ApiRoute } from '@mastra/core/server';\nimport { registerApiRoute } from '@mastra/core/server';\nimport type { Context } from 'hono';\n\nimport type { AuditEventRow } from '../../storage/domains/audit/base.js';\nimport type { FactoryIntegration, IntegrationContext } from '../base.js';\n\ntype WorkOSClient = ConstructorParameters<typeof WorkOSAdminPortal>[0];\n\nconst UNKNOWN_LOCATION = 'unknown';\n\nfunction loose(c: unknown): Context {\n return c as Context;\n}\n\nfunction flattenMetadata(metadata: Record<string, unknown>): Record<string, string | number | boolean> {\n const flat: Record<string, string | number | boolean> = {};\n for (const [key, value] of Object.entries(metadata)) {\n if (value === undefined || value === null) continue;\n if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {\n flat[key] = value;\n continue;\n }\n try {\n flat[key] = JSON.stringify(value);\n } catch {\n // Drop unserializable metadata rather than the event.\n }\n }\n return flat;\n}\n\nexport function toWorkOSEvent(event: AuditEventRow): {\n action: string;\n occurredAt: Date;\n actor: { type: string; id: string };\n targets: Array<{ type: string; id: string; name?: string }>;\n context: { location: string; userAgent?: string };\n metadata: Record<string, string | number | boolean>;\n} {\n return {\n action: event.action,\n occurredAt: event.occurredAt,\n actor: { type: event.actorType === 'human' ? 'user' : event.actorType, id: event.actorId },\n targets: event.targets.map(target => ({\n type: target.type,\n id: target.id,\n ...(target.name !== undefined ? { name: target.name } : {}),\n })),\n context: {\n location: event.context.location ?? UNKNOWN_LOCATION,\n ...(event.context.userAgent !== undefined ? { userAgent: event.context.userAgent } : {}),\n },\n metadata: flattenMetadata(event.metadata),\n };\n}\n\n/** Optional WorkOS mirror and Admin Portal route, independent of the auth adapter. */\nexport class WorkOSAuditIntegration implements FactoryIntegration {\n readonly id = 'workos';\n readonly #client: WorkOSClient;\n readonly #returnUrl: string;\n\n constructor({ client, returnUrl }: { client: WorkOSClient; returnUrl: string }) {\n this.#client = client;\n this.#returnUrl = returnUrl;\n }\n\n async audit({ event }: { event: AuditEventRow }): Promise<void> {\n try {\n await this.#client.auditLogs.createEvent(event.orgId, toWorkOSEvent(event));\n } catch (err) {\n console.warn('[Audit] Failed to forward audit event to WorkOS', {\n action: event.action,\n error: err instanceof Error ? err.message : String(err),\n });\n }\n }\n\n routes(ctx: IntegrationContext): ApiRoute[] {\n const { auth } = ctx;\n return [\n registerApiRoute('/web/audit/portal-link', {\n method: 'GET',\n handler: async cc => {\n const c = loose(cc);\n await auth.ensureUser(c);\n const tenant = auth.tenant(c);\n if (!tenant) return c.json({ error: 'unauthorized' }, 401);\n if (!tenant.orgId) {\n return c.json(\n { error: 'organization_required', message: 'The audit trail requires a WorkOS organization.' },\n 403,\n );\n }\n\n try {\n const portal = new WorkOSAdminPortal(this.#client, { returnUrl: this.#returnUrl });\n const url = await portal.getPortalLink(tenant.orgId, 'audit_logs');\n return c.json({ url });\n } catch (err) {\n console.warn('[Audit] Failed to generate WorkOS Admin Portal link', {\n error: err instanceof Error ? err.message : String(err),\n });\n return c.json({ error: 'portal_link_failed' }, 502);\n }\n },\n }),\n ];\n }\n\n diagnostics(): Record<string, unknown> {\n return { configured: true };\n }\n}\n"],"mappings":";;;AAUA,MAAM,mBAAmB;AAEzB,SAAS,MAAM,GAAqB;CAClC,OAAO;AACT;AAEA,SAAS,gBAAgB,UAA8E;CACrG,MAAM,OAAkD,CAAC;CACzD,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,GAAG;EACnD,IAAI,UAAU,KAAA,KAAa,UAAU,MAAM;EAC3C,IAAI,OAAO,UAAU,YAAY,OAAO,UAAU,YAAY,OAAO,UAAU,WAAW;GACxF,KAAK,OAAO;GACZ;EACF;EACA,IAAI;GACF,KAAK,OAAO,KAAK,UAAU,KAAK;EAClC,QAAQ,CAER;CACF;CACA,OAAO;AACT;AAEA,SAAgB,cAAc,OAO5B;CACA,OAAO;EACL,QAAQ,MAAM;EACd,YAAY,MAAM;EAClB,OAAO;GAAE,MAAM,MAAM,cAAc,UAAU,SAAS,MAAM;GAAW,IAAI,MAAM;EAAQ;EACzF,SAAS,MAAM,QAAQ,KAAI,YAAW;GACpC,MAAM,OAAO;GACb,IAAI,OAAO;GACX,GAAI,OAAO,SAAS,KAAA,IAAY,EAAE,MAAM,OAAO,KAAK,IAAI,CAAC;EAC3D,EAAE;EACF,SAAS;GACP,UAAU,MAAM,QAAQ,YAAY;GACpC,GAAI,MAAM,QAAQ,cAAc,KAAA,IAAY,EAAE,WAAW,MAAM,QAAQ,UAAU,IAAI,CAAC;EACxF;EACA,UAAU,gBAAgB,MAAM,QAAQ;CAC1C;AACF;;AAGA,IAAa,yBAAb,MAAkE;CAChE,KAAc;CACd;CACA;CAEA,YAAY,EAAE,QAAQ,aAA0D;EAC9E,KAAK,UAAU;EACf,KAAK,aAAa;CACpB;CAEA,MAAM,MAAM,EAAE,SAAkD;EAC9D,IAAI;GACF,MAAM,KAAK,QAAQ,UAAU,YAAY,MAAM,OAAO,cAAc,KAAK,CAAC;EAC5E,SAAS,KAAK;GACZ,QAAQ,KAAK,mDAAmD;IAC9D,QAAQ,MAAM;IACd,OAAO,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;GACxD,CAAC;EACH;CACF;CAEA,OAAO,KAAqC;EAC1C,MAAM,EAAE,SAAS;EACjB,OAAO,CACL,iBAAiB,0BAA0B;GACzC,QAAQ;GACR,SAAS,OAAM,OAAM;IACnB,MAAM,IAAI,MAAM,EAAE;IAClB,MAAM,KAAK,WAAW,CAAC;IACvB,MAAM,SAAS,KAAK,OAAO,CAAC;IAC5B,IAAI,CAAC,QAAQ,OAAO,EAAE,KAAK,EAAE,OAAO,eAAe,GAAG,GAAG;IACzD,IAAI,CAAC,OAAO,OACV,OAAO,EAAE,KACP;KAAE,OAAO;KAAyB,SAAS;IAAkD,GAC7F,GACF;IAGF,IAAI;KAEF,MAAM,MAAM,MAAM,IADC,kBAAkB,KAAK,SAAS,EAAE,WAAW,KAAK,WAAW,CACzD,CAAC,CAAC,cAAc,OAAO,OAAO,YAAY;KACjE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC;IACvB,SAAS,KAAK;KACZ,QAAQ,KAAK,uDAAuD,EAClE,OAAO,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,EACxD,CAAC;KACD,OAAO,EAAE,KAAK,EAAE,OAAO,qBAAqB,GAAG,GAAG;IACpD;GACF;EACF,CAAC,CACH;CACF;CAEA,cAAuC;EACrC,OAAO,EAAE,YAAY,KAAK;CAC5B;AACF"}
1
+ {"version":3,"file":"integration.js","names":[],"sources":["../../../src/integrations/workos/integration.ts"],"sourcesContent":["import { WorkOSAdminPortal } from '@mastra/auth-workos';\nimport type { ApiRoute } from '@mastra/core/server';\nimport { registerApiRoute } from '@mastra/core/server';\n\nimport { loose } from '../../routes/route.js';\nimport type { AuditEventRow } from '../../storage/domains/audit/base.js';\nimport type { FactoryIntegration, IntegrationContext } from '../base.js';\n\ntype WorkOSClient = ConstructorParameters<typeof WorkOSAdminPortal>[0];\n\nconst UNKNOWN_LOCATION = 'unknown';\n\nfunction flattenMetadata(metadata: Record<string, unknown>): Record<string, string | number | boolean> {\n const flat: Record<string, string | number | boolean> = {};\n for (const [key, value] of Object.entries(metadata)) {\n if (value === undefined || value === null) continue;\n if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {\n flat[key] = value;\n continue;\n }\n try {\n flat[key] = JSON.stringify(value);\n } catch {\n // Drop unserializable metadata rather than the event.\n }\n }\n return flat;\n}\n\nexport function toWorkOSEvent(event: AuditEventRow): {\n action: string;\n occurredAt: Date;\n actor: { type: string; id: string };\n targets: Array<{ type: string; id: string; name?: string }>;\n context: { location: string; userAgent?: string };\n metadata: Record<string, string | number | boolean>;\n} {\n return {\n action: event.action,\n occurredAt: event.occurredAt,\n actor: { type: event.actorType === 'human' ? 'user' : event.actorType, id: event.actorId },\n targets: event.targets.map(target => ({\n type: target.type,\n id: target.id,\n ...(target.name !== undefined ? { name: target.name } : {}),\n })),\n context: {\n location: event.context.location ?? UNKNOWN_LOCATION,\n ...(event.context.userAgent !== undefined ? { userAgent: event.context.userAgent } : {}),\n },\n metadata: flattenMetadata(event.metadata),\n };\n}\n\n/** Optional WorkOS mirror and Admin Portal route, independent of the auth adapter. */\nexport class WorkOSAuditIntegration implements FactoryIntegration {\n readonly id = 'workos';\n readonly #client: WorkOSClient;\n readonly #returnUrl: string;\n\n constructor({ client, returnUrl }: { client: WorkOSClient; returnUrl: string }) {\n this.#client = client;\n this.#returnUrl = returnUrl;\n }\n\n async audit({ event }: { event: AuditEventRow }): Promise<void> {\n try {\n await this.#client.auditLogs.createEvent(event.orgId, toWorkOSEvent(event));\n } catch (err) {\n console.warn('[Audit] Failed to forward audit event to WorkOS', {\n action: event.action,\n error: err instanceof Error ? err.message : String(err),\n });\n }\n }\n\n routes(ctx: IntegrationContext): ApiRoute[] {\n const { auth } = ctx;\n return [\n registerApiRoute('/web/audit/portal-link', {\n method: 'GET',\n handler: async cc => {\n const c = loose(cc);\n await auth.ensureUser(c);\n const tenant = auth.tenant(c);\n if (!tenant) return c.json({ error: 'unauthorized' }, 401);\n if (!tenant.orgId) {\n return c.json(\n { error: 'organization_required', message: 'The audit trail requires a WorkOS organization.' },\n 403,\n );\n }\n\n try {\n const portal = new WorkOSAdminPortal(this.#client, { returnUrl: this.#returnUrl });\n const url = await portal.getPortalLink(tenant.orgId, 'audit_logs');\n return c.json({ url });\n } catch (err) {\n console.warn('[Audit] Failed to generate WorkOS Admin Portal link', {\n error: err instanceof Error ? err.message : String(err),\n });\n return c.json({ error: 'portal_link_failed' }, 502);\n }\n },\n }),\n ];\n }\n\n diagnostics(): Record<string, unknown> {\n return { configured: true };\n }\n}\n"],"mappings":";;;;AAUA,MAAM,mBAAmB;AAEzB,SAAS,gBAAgB,UAA8E;CACrG,MAAM,OAAkD,CAAC;CACzD,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,GAAG;EACnD,IAAI,UAAU,KAAA,KAAa,UAAU,MAAM;EAC3C,IAAI,OAAO,UAAU,YAAY,OAAO,UAAU,YAAY,OAAO,UAAU,WAAW;GACxF,KAAK,OAAO;GACZ;EACF;EACA,IAAI;GACF,KAAK,OAAO,KAAK,UAAU,KAAK;EAClC,QAAQ,CAER;CACF;CACA,OAAO;AACT;AAEA,SAAgB,cAAc,OAO5B;CACA,OAAO;EACL,QAAQ,MAAM;EACd,YAAY,MAAM;EAClB,OAAO;GAAE,MAAM,MAAM,cAAc,UAAU,SAAS,MAAM;GAAW,IAAI,MAAM;EAAQ;EACzF,SAAS,MAAM,QAAQ,KAAI,YAAW;GACpC,MAAM,OAAO;GACb,IAAI,OAAO;GACX,GAAI,OAAO,SAAS,KAAA,IAAY,EAAE,MAAM,OAAO,KAAK,IAAI,CAAC;EAC3D,EAAE;EACF,SAAS;GACP,UAAU,MAAM,QAAQ,YAAY;GACpC,GAAI,MAAM,QAAQ,cAAc,KAAA,IAAY,EAAE,WAAW,MAAM,QAAQ,UAAU,IAAI,CAAC;EACxF;EACA,UAAU,gBAAgB,MAAM,QAAQ;CAC1C;AACF;;AAGA,IAAa,yBAAb,MAAkE;CAChE,KAAc;CACd;CACA;CAEA,YAAY,EAAE,QAAQ,aAA0D;EAC9E,KAAK,UAAU;EACf,KAAK,aAAa;CACpB;CAEA,MAAM,MAAM,EAAE,SAAkD;EAC9D,IAAI;GACF,MAAM,KAAK,QAAQ,UAAU,YAAY,MAAM,OAAO,cAAc,KAAK,CAAC;EAC5E,SAAS,KAAK;GACZ,QAAQ,KAAK,mDAAmD;IAC9D,QAAQ,MAAM;IACd,OAAO,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;GACxD,CAAC;EACH;CACF;CAEA,OAAO,KAAqC;EAC1C,MAAM,EAAE,SAAS;EACjB,OAAO,CACL,iBAAiB,0BAA0B;GACzC,QAAQ;GACR,SAAS,OAAM,OAAM;IACnB,MAAM,IAAI,MAAM,EAAE;IAClB,MAAM,KAAK,WAAW,CAAC;IACvB,MAAM,SAAS,KAAK,OAAO,CAAC;IAC5B,IAAI,CAAC,QAAQ,OAAO,EAAE,KAAK,EAAE,OAAO,eAAe,GAAG,GAAG;IACzD,IAAI,CAAC,OAAO,OACV,OAAO,EAAE,KACP;KAAE,OAAO;KAAyB,SAAS;IAAkD,GAC7F,GACF;IAGF,IAAI;KAEF,MAAM,MAAM,MAAM,IADC,kBAAkB,KAAK,SAAS,EAAE,WAAW,KAAK,WAAW,CACzD,CAAC,CAAC,cAAc,OAAO,OAAO,YAAY;KACjE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC;IACvB,SAAS,KAAK;KACZ,QAAQ,KAAK,uDAAuD,EAClE,OAAO,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,EACxD,CAAC;KACD,OAAO,EAAE,KAAK,EAAE,OAAO,qBAAqB,GAAG,GAAG;IACpD;GACF;EACF,CAAC,CACH;CACF;CAEA,cAAuC;EACrC,OAAO,EAAE,YAAY,KAAK;CAC5B;AACF"}
@@ -1,7 +1,7 @@
1
- import { ACTOR_PROFILE_METADATA_KEY, auditCursorAt, decodeAuditAfterCursor, encodeAuditCursor } from "../storage/domains/audit/base.js";
2
1
  import { canViewSourceControlSession } from "../routes/session-access.js";
3
2
  import { parseAuditAction } from "../storage/domains/audit/actions.js";
4
3
  import { AUDIT_ACTOR_TYPES } from "../storage/domains/audit/actors.js";
4
+ import { ACTOR_PROFILE_METADATA_KEY, auditCursorAt, decodeAuditAfterCursor, encodeAuditCursor } from "../storage/domains/audit/base.js";
5
5
  import { z } from "zod";
6
6
  import { defineEvent } from "@mastra/mcp";
7
7
  // src/mcp/events.ts
@@ -1,5 +1,5 @@
1
- import "../platform-auth-host.js";
2
1
  import { getFactoryAuthUser } from "../auth.js";
2
+ import "../platform-auth-host.js";
3
3
  import { FactorySourceSessionResolutionError, ensureFactorySourceSession } from "../session/factory-session.js";
4
4
  import { auditActorProfile } from "../storage/domains/audit/base.js";
5
5
  import { FACTORY_TOOL_ANNOTATIONS } from "../tools/annotations.js";
@@ -7,8 +7,8 @@ import { createFactoryTools } from "../tools/index.js";
7
7
  import { propagateClientDisconnect } from "./disconnect.js";
8
8
  import { factoryActivityEvent } from "./events.js";
9
9
  import { registerApiRoute } from "@mastra/core/server";
10
- import { z } from "zod";
11
10
  import { createHash } from "crypto";
11
+ import { z } from "zod";
12
12
  import { createTool } from "@mastra/core/tools";
13
13
  import { MCPServer } from "@mastra/mcp";
14
14
  import { toFetchResponse, toReqRes } from "fetch-to-node";
@@ -1,6 +1,6 @@
1
1
  import "@mastra/core/workspace";
2
- import { createHash } from "crypto";
3
2
  import "path";
3
+ import { createHash } from "crypto";
4
4
  // ../../packages/_internals/workspace/dist/index.js
5
5
  /** Directory, relative to the template's build cwd, that holds every marker below. */
6
6
  const SETUP_MARKER_DIR = ".mastra-sandbox";
@@ -1,6 +1,6 @@
1
- import { factoryActivityAttentionIdentity, factoryAttentionKey } from "../storage/domains/work-items/base.js";
2
1
  import { boardForWorkItem } from "../boards/semantics.js";
3
2
  import "../boards/index.js";
3
+ import { factoryActivityAttentionIdentity, factoryAttentionKey } from "../storage/domains/work-items/base.js";
4
4
  import { collectPage, markScanRead, matchesView, receiptScope, scanBatches } from "./attention-providers.js";
5
5
  // src/routes/attention-activity.ts
6
6
  /** Projects `activity.ts` fan-out rows. */
@@ -1,9 +1,9 @@
1
- import { factoryDispatchFailureMetadata } from "../rules/dispatch-errors.js";
2
- import { factoryAttentionKey, factoryDecisionAttentionIdentity, factoryMentionAttentionIdentity } from "../storage/domains/work-items/base.js";
3
1
  import { boardForWorkItem } from "../boards/semantics.js";
4
2
  import "../boards/index.js";
5
3
  import { toBoardSource } from "../boards/project-boards.js";
6
4
  import { decisionRetryable, overtakenDecisionIds } from "../rules/decision-applicability.js";
5
+ import { factoryDispatchFailureMetadata } from "../rules/dispatch-errors.js";
6
+ import { factoryAttentionKey, factoryDecisionAttentionIdentity, factoryMentionAttentionIdentity } from "../storage/domains/work-items/base.js";
7
7
  // src/routes/attention-providers.ts
8
8
  /**
9
9
  * Per-kind attention providers. Each kind owns its counts, its bounded page
@@ -1,9 +1,9 @@
1
1
  import { factoryAttentionKey } from "../storage/domains/work-items/base.js";
2
- import { FACTORY_ROUTE_CONTRACTS } from "./contracts.js";
3
- import { DecisionAttentionProvider, MentionAttentionProvider, factoryDecisionType, failedDecisionAttentionSpec } from "./attention-providers.js";
4
2
  import { ActivityAttentionProvider } from "./attention-activity.js";
5
3
  import { ParkedRunAttentionProvider } from "./attention-parked.js";
6
4
  import { proposedDecisionAttentionSpec } from "./attention-proposed.js";
5
+ import { DecisionAttentionProvider, MentionAttentionProvider, factoryDecisionType, failedDecisionAttentionSpec } from "./attention-providers.js";
6
+ import { FACTORY_ROUTE_CONTRACTS } from "./contracts.js";
7
7
  import { registerApiRoute } from "@mastra/core/server";
8
8
  // src/routes/attention.ts
9
9
  function encodeAttentionCursor(cursors) {
@@ -1 +1 @@
1
- {"version":3,"file":"automation-runs.d.ts","sourceRoot":"","sources":["../../src/routes/automation-runs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAMpD,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAEtF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAE9E,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AA6CpD,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,KAAK,EAAE,YAAY,GAAG,aAAa,CAAC;IACpC,yFAAyF;IACzF,QAAQ,EAAE,sBAAsB,CAAC;IACjC,wDAAwD;IACxD,SAAS,EAAE,gBAAgB,CAAC;IAC5B,+DAA+D;IAC/D,aAAa,EAAE,MAAM,CAAC;CACvB;AASD,qBAAa,mBAAoB,SAAQ,KAAK,CAAC,uBAAuB,CAAC;;IAmFrE,MAAM,IAAI,QAAQ,EAAE,CAyHnB;CACF;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,uBAAuB,GAAG,QAAQ,EAAE,CAElF"}
1
+ {"version":3,"file":"automation-runs.d.ts","sourceRoot":"","sources":["../../src/routes/automation-runs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAMpD,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAEtF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAE9E,OAAO,EAAS,KAAK,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAyCpD,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,KAAK,EAAE,YAAY,GAAG,aAAa,CAAC;IACpC,yFAAyF;IACzF,QAAQ,EAAE,sBAAsB,CAAC;IACjC,wDAAwD;IACxD,SAAS,EAAE,gBAAgB,CAAC;IAC5B,+DAA+D;IAC/D,aAAa,EAAE,MAAM,CAAC;CACvB;AASD,qBAAa,mBAAoB,SAAQ,KAAK,CAAC,uBAAuB,CAAC;;IAmFrE,MAAM,IAAI,QAAQ,EAAE,CAyHnB;CACF;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,uBAAuB,GAAG,QAAQ,EAAE,CAElF"}
@@ -1,11 +1,8 @@
1
- import { FACTORY_ROUTE_CONTRACTS } from "./contracts.js";
2
- import { Route } from "./route.js";
3
1
  import { auditRequestContext } from "../storage/domains/audit/domain.js";
2
+ import { FACTORY_ROUTE_CONTRACTS } from "./contracts.js";
3
+ import { Route, loose } from "./route.js";
4
4
  import { registerApiRoute } from "@mastra/core/server";
5
5
  // src/routes/automation-runs.ts
6
- function loose(c) {
7
- return c;
8
- }
9
6
  /**
10
7
  * Whether a replayed rule-evaluation record describes the SAME operation as the
11
8
  * current request. `commitRuleEvaluation` keys idempotency on `(org, project,
@@ -1 +1 @@
1
- {"version":3,"file":"automation-runs.js","names":[],"sources":["../../src/routes/automation-runs.ts"],"sourcesContent":["/**\n * Mastra `apiRoutes` for trusted external orchestrators to enqueue an\n * idempotent, deferred skill dispatch against a Factory work item.\n *\n * The endpoint is a constrained ingress in front of\n * `WorkItemsStorage.commitRuleEvaluation()`: it commits exactly one\n * `invokeSkill` decision, stamps a non-human system actor, and leaves\n * execution (session creation, auto-run/approval policy, retry, restart\n * recovery) to the `FactoryDecisionDispatcher`.\n *\n * Idempotency: the `requestId` becomes the ingress identity, so replaying the\n * same request returns the prior result without inserting a second decision.\n * Tenant-mode callers must administer the organization; local (no-auth)\n * deployments run under the shared `local` storage scope without inventing a\n * tenant user.\n */\n\nimport type { ApiRoute } from '@mastra/core/server';\nimport { registerApiRoute } from '@mastra/core/server';\nimport type { Context } from 'hono';\n\nimport type { AuditAction } from '../storage/domains/audit/actions.js';\nimport type { AuditTarget } from '../storage/domains/audit/base.js';\nimport type { AuditEmitter, AuditRecorder } from '../storage/domains/audit/domain.js';\nimport { auditRequestContext } from '../storage/domains/audit/domain.js';\nimport type { FactoryProjectsStorage } from '../storage/domains/projects/base.js';\nimport type { WorkItemsStorage } from '../storage/domains/work-items/base.js';\nimport { FACTORY_ROUTE_CONTRACTS } from './contracts.js';\nimport { Route } from './route.js';\nimport type { RouteDependencies } from './route.js';\n\nfunction loose(c: unknown): Context {\n return c as Context;\n}\n\n/** The invokeSkill payload this route commits, matched against a prior replay. */\ninterface AutomationInvokeSkillDecision {\n type: 'invokeSkill';\n idempotencyKey: string;\n role: string;\n skillName: string;\n arguments?: string;\n}\n\n/**\n * Whether a replayed rule-evaluation record describes the SAME operation as the\n * current request. `commitRuleEvaluation` keys idempotency on `(org, project,\n * ingress identity)` alone, so a reused `requestId` replays regardless of the\n * work item or decision payload. We reconstruct the prior `invokeSkill`\n * decision from the stored result and compare the item id, role, skill, and\n * arguments; any divergence is a collision, not a legitimate retry.\n */\nfunction replayMatchesRequest(\n result: { itemId?: string | null; decisions?: unknown[] },\n itemId: string,\n request: AutomationInvokeSkillDecision,\n): boolean {\n if (result.itemId != null && result.itemId !== itemId) return false;\n const decisions = Array.isArray(result.decisions) ? result.decisions : [];\n const prior = decisions.find(\n (candidate): candidate is Record<string, unknown> =>\n typeof candidate === 'object' &&\n candidate !== null &&\n (candidate as Record<string, unknown>).type === 'invokeSkill' &&\n (candidate as Record<string, unknown>).idempotencyKey === request.idempotencyKey,\n );\n if (!prior) return false;\n return (\n prior.role === request.role &&\n prior.skillName === request.skillName &&\n (prior.arguments ?? undefined) === (request.arguments ?? undefined)\n );\n}\n\nexport interface AutomationRunRoutesDeps extends RouteDependencies {\n audit: AuditEmitter & AuditRecorder;\n /** Factory projects domain — validates the `:id` project belongs to the caller's org. */\n projects: FactoryProjectsStorage;\n /** Work-items domain backing `commitRuleEvaluation`. */\n workItems: WorkItemsStorage;\n /** Config version stamped on the committed rule evaluation. */\n configVersion: string;\n}\n\n/** Resolved ingress scope for an automation-run request. */\ninterface AutomationRunScope {\n orgId: string;\n userId: string;\n factoryProjectId: string;\n}\n\nexport class AutomationRunRoutes extends Route<AutomationRunRoutesDeps> {\n /**\n * Resolve the `(orgId, userId)` ingress scope. Tenant mode requires a\n * signed-in organization administrator; local (no-auth) mode runs under the\n * shared `local` scope without inventing a user.\n */\n async #resolveScope(c: Context): Promise<{ orgId: string; userId: string } | { response: Response }> {\n const { auth } = this.deps;\n if (!auth.enabled()) {\n return { orgId: 'local', userId: 'local' };\n }\n await auth.ensureUser(c);\n const tenant = auth.tenant(c);\n if (!tenant) return { response: c.json({ error: 'unauthorized' }, 401) };\n if (!tenant.orgId) {\n return {\n response: c.json(\n { error: 'organization_required', message: 'The Factory board requires an organization.' },\n 403,\n ),\n };\n }\n if (!(await auth.isOrganizationAdmin(c, tenant.orgId))) {\n return {\n response: c.json(\n { error: 'forbidden', message: 'Organization administrator access is required for automation ingress.' },\n 403,\n ),\n };\n }\n return { orgId: tenant.orgId, userId: tenant.userId };\n }\n\n /** Resolve the ingress scope AND the org-owned project from the `:id` param. */\n async #resolveProject(c: Context): Promise<AutomationRunScope | { response: Response }> {\n const scope = await this.#resolveScope(c);\n if ('response' in scope) return scope;\n\n const parsedPath = FACTORY_ROUTE_CONTRACTS.projectGet.pathSchema.safeParse({ id: c.req.param('id') });\n if (!parsedPath.success) {\n return { response: c.json({ error: 'Project not found' }, 404) };\n }\n const { projects } = this.deps;\n await projects.ensureReady();\n const project = await projects.get({ orgId: scope.orgId, id: parsedPath.data.id });\n if (!project) {\n return { response: c.json({ error: 'Project not found' }, 404) };\n }\n return { ...scope, factoryProjectId: parsedPath.data.id };\n }\n\n /**\n * Persist an audit event under the ingress-resolved scope. This route can run\n * under the synthetic `local` no-auth scope, where the tenant-gated\n * `audit.emit()` derives no org from the request and drops the event; writing\n * through `record()` with the explicit org + system actor keeps traceability\n * in every deployment mode.\n *\n * The `idempotencyKey` (`<action>:<requestId>`) makes the audit write itself\n * idempotent: replaying the same request re-enters this path, but the trail\n * keeps a single event per requestId instead of one duplicate per retry.\n */\n async #writeAudit(\n c: Context,\n scope: AutomationRunScope,\n action: AuditAction,\n requestId: string,\n targets: AuditTarget[],\n metadata: Record<string, unknown>,\n ): Promise<void> {\n await this.deps.audit.record({\n idempotencyKey: `${action}:${requestId}`,\n orgId: scope.orgId,\n actorId: 'factory-external-orchestrator',\n actorType: 'system',\n action,\n targets,\n metadata,\n factoryProjectId: scope.factoryProjectId,\n context: auditRequestContext(c),\n });\n }\n\n routes(): ApiRoute[] {\n const { workItems, configVersion } = this.deps;\n const contract = FACTORY_ROUTE_CONTRACTS.workItemAutomationRun;\n\n return [\n registerApiRoute(contract.path, {\n method: contract.method,\n handler: async c => {\n const context = loose(c);\n const resolved = await this.#resolveProject(context);\n if ('response' in resolved) return resolved.response;\n\n const parsedPath = contract.pathSchema.safeParse({\n id: c.req.param('id'),\n workItemId: c.req.param('workItemId'),\n });\n if (!parsedPath.success) return c.json({ error: 'Work item not found' }, 404);\n\n const body = await c.req.json().catch(() => undefined);\n if (body === undefined) return c.json({ error: 'Invalid JSON body' }, 400);\n const parsed = contract.bodySchema.safeParse(body);\n if (!parsed.success) return c.json({ error: 'invalid_automation_run_request' }, 400);\n const request = parsed.data as {\n requestId: string;\n expectedRevision: number;\n role: string;\n skillName: string;\n arguments?: string;\n };\n\n const item = await workItems.getForProject(\n resolved.orgId,\n resolved.factoryProjectId,\n (parsedPath.data as { workItemId: string }).workItemId,\n );\n if (!item) return c.json({ error: 'Work item not found' }, 404);\n\n const idempotencyKey = `external-orchestrator:${request.requestId}`;\n const decision = {\n type: 'invokeSkill' as const,\n idempotencyKey,\n role: request.role,\n skillName: request.skillName,\n ...(request.arguments !== undefined ? { arguments: request.arguments } : {}),\n };\n\n const now = new Date();\n const commit = await workItems.commitRuleEvaluation({\n orgId: resolved.orgId,\n factoryProjectId: resolved.factoryProjectId,\n workItemId: item.id,\n ingress: { identity: idempotencyKey, triggerType: 'external-orchestrator.invoke-skill' },\n configVersion,\n expectedRevision: request.expectedRevision,\n actor: { type: 'system', id: 'factory-external-orchestrator' },\n outcome: { status: 'accepted' },\n decisions: [decision],\n causalChain: [],\n now,\n });\n\n if (commit.status === 'missing') return c.json({ error: 'Work item not found' }, 404);\n\n // A stale commit persists nothing, so the caller can retry the same\n // requestId once it has re-read the work item's revision.\n const result = (commit.status === 'stale' ? { status: 'rejected', code: 'stale' } : commit.result) as {\n status?: string;\n code?: string;\n itemId?: string | null;\n decisions?: unknown[];\n };\n const resultStatus = result.status ?? 'accepted';\n const code = typeof result.code === 'string' ? result.code : undefined;\n const targets = [{ type: 'work_item' as const, id: item.id, name: item.title }];\n\n const auditMetadata = {\n requestId: request.requestId,\n role: request.role,\n skillName: request.skillName,\n commitStatus: commit.status,\n resultStatus,\n ...(code ? { code } : {}),\n };\n\n // A replay only means \"this request was already committed\" — it must\n // be the SAME operation. If the caller reused a requestId against a\n // different work item, role, skill, or arguments, returning\n // `replayed` would report durable success for work that was never\n // enqueued. Reject the collision instead of silently swallowing it.\n if (commit.status === 'replayed' && !replayMatchesRequest(result, item.id, decision)) {\n await this.#writeAudit(context, resolved, 'factory.run.rejected', request.requestId, targets, {\n ...auditMetadata,\n resultStatus: 'rejected',\n code: 'request_id_conflict',\n });\n return c.json(\n {\n status: 'rejected',\n code: 'request_id_conflict',\n requestId: request.requestId,\n },\n 409,\n );\n }\n\n if (resultStatus === 'accepted') {\n await this.#writeAudit(context, resolved, 'factory.run.queued', request.requestId, targets, auditMetadata);\n return c.json(\n { status: commit.status === 'replayed' ? 'replayed' : 'committed', requestId: request.requestId },\n commit.status === 'replayed' ? 200 : 202,\n );\n }\n\n await this.#writeAudit(context, resolved, 'factory.run.rejected', request.requestId, targets, auditMetadata);\n return c.json(\n { status: 'rejected', ...(code ? { code } : {}), requestId: request.requestId },\n code === 'stale' ? 409 : 422,\n );\n },\n }),\n ];\n }\n}\n\nexport function buildAutomationRunRoutes(deps: AutomationRunRoutesDeps): ApiRoute[] {\n return new AutomationRunRoutes(deps).routes();\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"automation-runs.js","names":[],"sources":["../../src/routes/automation-runs.ts"],"sourcesContent":["/**\n * Mastra `apiRoutes` for trusted external orchestrators to enqueue an\n * idempotent, deferred skill dispatch against a Factory work item.\n *\n * The endpoint is a constrained ingress in front of\n * `WorkItemsStorage.commitRuleEvaluation()`: it commits exactly one\n * `invokeSkill` decision, stamps a non-human system actor, and leaves\n * execution (session creation, auto-run/approval policy, retry, restart\n * recovery) to the `FactoryDecisionDispatcher`.\n *\n * Idempotency: the `requestId` becomes the ingress identity, so replaying the\n * same request returns the prior result without inserting a second decision.\n * Tenant-mode callers must administer the organization; local (no-auth)\n * deployments run under the shared `local` storage scope without inventing a\n * tenant user.\n */\n\nimport type { ApiRoute } from '@mastra/core/server';\nimport { registerApiRoute } from '@mastra/core/server';\nimport type { Context } from 'hono';\n\nimport type { AuditAction } from '../storage/domains/audit/actions.js';\nimport type { AuditTarget } from '../storage/domains/audit/base.js';\nimport type { AuditEmitter, AuditRecorder } from '../storage/domains/audit/domain.js';\nimport { auditRequestContext } from '../storage/domains/audit/domain.js';\nimport type { FactoryProjectsStorage } from '../storage/domains/projects/base.js';\nimport type { WorkItemsStorage } from '../storage/domains/work-items/base.js';\nimport { FACTORY_ROUTE_CONTRACTS } from './contracts.js';\nimport { loose, Route } from './route.js';\nimport type { RouteDependencies } from './route.js';\n\n/** The invokeSkill payload this route commits, matched against a prior replay. */\ninterface AutomationInvokeSkillDecision {\n type: 'invokeSkill';\n idempotencyKey: string;\n role: string;\n skillName: string;\n arguments?: string;\n}\n\n/**\n * Whether a replayed rule-evaluation record describes the SAME operation as the\n * current request. `commitRuleEvaluation` keys idempotency on `(org, project,\n * ingress identity)` alone, so a reused `requestId` replays regardless of the\n * work item or decision payload. We reconstruct the prior `invokeSkill`\n * decision from the stored result and compare the item id, role, skill, and\n * arguments; any divergence is a collision, not a legitimate retry.\n */\nfunction replayMatchesRequest(\n result: { itemId?: string | null; decisions?: unknown[] },\n itemId: string,\n request: AutomationInvokeSkillDecision,\n): boolean {\n if (result.itemId != null && result.itemId !== itemId) return false;\n const decisions = Array.isArray(result.decisions) ? result.decisions : [];\n const prior = decisions.find(\n (candidate): candidate is Record<string, unknown> =>\n typeof candidate === 'object' &&\n candidate !== null &&\n (candidate as Record<string, unknown>).type === 'invokeSkill' &&\n (candidate as Record<string, unknown>).idempotencyKey === request.idempotencyKey,\n );\n if (!prior) return false;\n return (\n prior.role === request.role &&\n prior.skillName === request.skillName &&\n (prior.arguments ?? undefined) === (request.arguments ?? undefined)\n );\n}\n\nexport interface AutomationRunRoutesDeps extends RouteDependencies {\n audit: AuditEmitter & AuditRecorder;\n /** Factory projects domain — validates the `:id` project belongs to the caller's org. */\n projects: FactoryProjectsStorage;\n /** Work-items domain backing `commitRuleEvaluation`. */\n workItems: WorkItemsStorage;\n /** Config version stamped on the committed rule evaluation. */\n configVersion: string;\n}\n\n/** Resolved ingress scope for an automation-run request. */\ninterface AutomationRunScope {\n orgId: string;\n userId: string;\n factoryProjectId: string;\n}\n\nexport class AutomationRunRoutes extends Route<AutomationRunRoutesDeps> {\n /**\n * Resolve the `(orgId, userId)` ingress scope. Tenant mode requires a\n * signed-in organization administrator; local (no-auth) mode runs under the\n * shared `local` scope without inventing a user.\n */\n async #resolveScope(c: Context): Promise<{ orgId: string; userId: string } | { response: Response }> {\n const { auth } = this.deps;\n if (!auth.enabled()) {\n return { orgId: 'local', userId: 'local' };\n }\n await auth.ensureUser(c);\n const tenant = auth.tenant(c);\n if (!tenant) return { response: c.json({ error: 'unauthorized' }, 401) };\n if (!tenant.orgId) {\n return {\n response: c.json(\n { error: 'organization_required', message: 'The Factory board requires an organization.' },\n 403,\n ),\n };\n }\n if (!(await auth.isOrganizationAdmin(c, tenant.orgId))) {\n return {\n response: c.json(\n { error: 'forbidden', message: 'Organization administrator access is required for automation ingress.' },\n 403,\n ),\n };\n }\n return { orgId: tenant.orgId, userId: tenant.userId };\n }\n\n /** Resolve the ingress scope AND the org-owned project from the `:id` param. */\n async #resolveProject(c: Context): Promise<AutomationRunScope | { response: Response }> {\n const scope = await this.#resolveScope(c);\n if ('response' in scope) return scope;\n\n const parsedPath = FACTORY_ROUTE_CONTRACTS.projectGet.pathSchema.safeParse({ id: c.req.param('id') });\n if (!parsedPath.success) {\n return { response: c.json({ error: 'Project not found' }, 404) };\n }\n const { projects } = this.deps;\n await projects.ensureReady();\n const project = await projects.get({ orgId: scope.orgId, id: parsedPath.data.id });\n if (!project) {\n return { response: c.json({ error: 'Project not found' }, 404) };\n }\n return { ...scope, factoryProjectId: parsedPath.data.id };\n }\n\n /**\n * Persist an audit event under the ingress-resolved scope. This route can run\n * under the synthetic `local` no-auth scope, where the tenant-gated\n * `audit.emit()` derives no org from the request and drops the event; writing\n * through `record()` with the explicit org + system actor keeps traceability\n * in every deployment mode.\n *\n * The `idempotencyKey` (`<action>:<requestId>`) makes the audit write itself\n * idempotent: replaying the same request re-enters this path, but the trail\n * keeps a single event per requestId instead of one duplicate per retry.\n */\n async #writeAudit(\n c: Context,\n scope: AutomationRunScope,\n action: AuditAction,\n requestId: string,\n targets: AuditTarget[],\n metadata: Record<string, unknown>,\n ): Promise<void> {\n await this.deps.audit.record({\n idempotencyKey: `${action}:${requestId}`,\n orgId: scope.orgId,\n actorId: 'factory-external-orchestrator',\n actorType: 'system',\n action,\n targets,\n metadata,\n factoryProjectId: scope.factoryProjectId,\n context: auditRequestContext(c),\n });\n }\n\n routes(): ApiRoute[] {\n const { workItems, configVersion } = this.deps;\n const contract = FACTORY_ROUTE_CONTRACTS.workItemAutomationRun;\n\n return [\n registerApiRoute(contract.path, {\n method: contract.method,\n handler: async c => {\n const context = loose(c);\n const resolved = await this.#resolveProject(context);\n if ('response' in resolved) return resolved.response;\n\n const parsedPath = contract.pathSchema.safeParse({\n id: c.req.param('id'),\n workItemId: c.req.param('workItemId'),\n });\n if (!parsedPath.success) return c.json({ error: 'Work item not found' }, 404);\n\n const body = await c.req.json().catch(() => undefined);\n if (body === undefined) return c.json({ error: 'Invalid JSON body' }, 400);\n const parsed = contract.bodySchema.safeParse(body);\n if (!parsed.success) return c.json({ error: 'invalid_automation_run_request' }, 400);\n const request = parsed.data as {\n requestId: string;\n expectedRevision: number;\n role: string;\n skillName: string;\n arguments?: string;\n };\n\n const item = await workItems.getForProject(\n resolved.orgId,\n resolved.factoryProjectId,\n (parsedPath.data as { workItemId: string }).workItemId,\n );\n if (!item) return c.json({ error: 'Work item not found' }, 404);\n\n const idempotencyKey = `external-orchestrator:${request.requestId}`;\n const decision = {\n type: 'invokeSkill' as const,\n idempotencyKey,\n role: request.role,\n skillName: request.skillName,\n ...(request.arguments !== undefined ? { arguments: request.arguments } : {}),\n };\n\n const now = new Date();\n const commit = await workItems.commitRuleEvaluation({\n orgId: resolved.orgId,\n factoryProjectId: resolved.factoryProjectId,\n workItemId: item.id,\n ingress: { identity: idempotencyKey, triggerType: 'external-orchestrator.invoke-skill' },\n configVersion,\n expectedRevision: request.expectedRevision,\n actor: { type: 'system', id: 'factory-external-orchestrator' },\n outcome: { status: 'accepted' },\n decisions: [decision],\n causalChain: [],\n now,\n });\n\n if (commit.status === 'missing') return c.json({ error: 'Work item not found' }, 404);\n\n // A stale commit persists nothing, so the caller can retry the same\n // requestId once it has re-read the work item's revision.\n const result = (commit.status === 'stale' ? { status: 'rejected', code: 'stale' } : commit.result) as {\n status?: string;\n code?: string;\n itemId?: string | null;\n decisions?: unknown[];\n };\n const resultStatus = result.status ?? 'accepted';\n const code = typeof result.code === 'string' ? result.code : undefined;\n const targets = [{ type: 'work_item' as const, id: item.id, name: item.title }];\n\n const auditMetadata = {\n requestId: request.requestId,\n role: request.role,\n skillName: request.skillName,\n commitStatus: commit.status,\n resultStatus,\n ...(code ? { code } : {}),\n };\n\n // A replay only means \"this request was already committed\" — it must\n // be the SAME operation. If the caller reused a requestId against a\n // different work item, role, skill, or arguments, returning\n // `replayed` would report durable success for work that was never\n // enqueued. Reject the collision instead of silently swallowing it.\n if (commit.status === 'replayed' && !replayMatchesRequest(result, item.id, decision)) {\n await this.#writeAudit(context, resolved, 'factory.run.rejected', request.requestId, targets, {\n ...auditMetadata,\n resultStatus: 'rejected',\n code: 'request_id_conflict',\n });\n return c.json(\n {\n status: 'rejected',\n code: 'request_id_conflict',\n requestId: request.requestId,\n },\n 409,\n );\n }\n\n if (resultStatus === 'accepted') {\n await this.#writeAudit(context, resolved, 'factory.run.queued', request.requestId, targets, auditMetadata);\n return c.json(\n { status: commit.status === 'replayed' ? 'replayed' : 'committed', requestId: request.requestId },\n commit.status === 'replayed' ? 200 : 202,\n );\n }\n\n await this.#writeAudit(context, resolved, 'factory.run.rejected', request.requestId, targets, auditMetadata);\n return c.json(\n { status: 'rejected', ...(code ? { code } : {}), requestId: request.requestId },\n code === 'stale' ? 409 : 422,\n );\n },\n }),\n ];\n }\n}\n\nexport function buildAutomationRunRoutes(deps: AutomationRunRoutesDeps): ApiRoute[] {\n return new AutomationRunRoutes(deps).routes();\n}\n"],"mappings":"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"}
@@ -1,10 +1,12 @@
1
1
  /**
2
2
  * Mastra `apiRoutes` for managing a project's stored boards.
3
3
  *
4
- * Reads need project membership; writes need an organization admin in tenant mode. Built-in and
5
- * app boards are defined in code and read-only here. Every write to a stored board is checked
6
- * against the rules `defineBoard()` enforces and the cards sitting on it, then invalidates the
7
- * project's board cache.
4
+ * Reads need project membership; writes need an organization admin in tenant mode. Factory stores
5
+ * the built-in Work board and app boards in each project once, and they are edited under their own
6
+ * key; their code behaviour stays attached, so an edit it can't honour is refused
7
+ * (`code_behaviour`), and reset rewrites Factory's current definition at the next revision. They
8
+ * can't be created over, and Work can't be deleted. The legacy Review board stays read-only. The
9
+ * writes themselves are `BoardWrites`.
8
10
  */
9
11
  import type { ApiRoute } from '@mastra/core/server';
10
12
  import type { ProjectBoardCache } from '../boards/project-boards.js';
@@ -20,8 +22,8 @@ export interface BoardRoutesDeps extends RouteDependencies {
20
22
  /** Read to refuse edits that would strand cards. */
21
23
  workItems: Pick<WorkItemsStorage, 'list'>;
22
24
  storage: StoredBoardsStorage;
23
- /** The per-project boards: the read-only code boards, skills, and the cache to invalidate. */
24
- boards: Pick<ProjectBoardCache, 'describe' | 'invalidate' | 'codeRegistry' | 'codeSkills'>;
25
+ /** The per-project boards: the code boards and their seeds, skills, and the cache to invalidate. */
26
+ boards: Pick<ProjectBoardCache, 'describe' | 'invalidate' | 'codeRegistry' | 'codeSkills' | 'seedFor'>;
25
27
  }
26
28
  export declare class BoardRoutes extends Route<BoardRoutesDeps> {
27
29
  #private;
@@ -1 +1 @@
1
- {"version":3,"file":"boards.d.ts","sourceRoot":"","sources":["../../src/routes/boards.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAKpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAKrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAEvE,OAAO,KAAK,EAIV,mBAAmB,EAEpB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAE9E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,MAAM,WAAW,eAAgB,SAAQ,iBAAiB;IACxD,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,sBAAsB,CAAC;IACjC,oDAAoD;IACpD,SAAS,EAAE,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;IAC1C,OAAO,EAAE,mBAAmB,CAAC;IAC7B,8FAA8F;IAC9F,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,UAAU,GAAG,YAAY,GAAG,cAAc,GAAG,YAAY,CAAC,CAAC;CAC5F;AAwBD,qBAAa,WAAY,SAAQ,KAAK,CAAC,eAAe,CAAC;;IA2LrD,MAAM,IAAI,QAAQ,EAAE,CAkEnB;CACF"}
1
+ {"version":3,"file":"boards.d.ts","sourceRoot":"","sources":["../../src/routes/boards.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAMpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,KAAK,EAAoB,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAC/F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAE9E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAS,KAAK,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,WAAW,eAAgB,SAAQ,iBAAiB;IACxD,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,sBAAsB,CAAC;IACjC,oDAAoD;IACpD,SAAS,EAAE,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;IAC1C,OAAO,EAAE,mBAAmB,CAAC;IAC7B,oGAAoG;IACpG,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,UAAU,GAAG,YAAY,GAAG,cAAc,GAAG,YAAY,GAAG,SAAS,CAAC,CAAC;CACxG;AAYD,qBAAa,WAAY,SAAQ,KAAK,CAAC,eAAe,CAAC;;IA2HrD,MAAM,IAAI,QAAQ,EAAE,CAgEnB;CACF"}