@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,86 @@
1
+ /**
2
+ * Writes to a project's stored boards, shared by the boards API and `MastraFactory#upsertBoard()`.
3
+ *
4
+ * Every write is checked against the rules `defineBoard()` enforces, the skills its runners name,
5
+ * the code behaviour of a code board's copy, and the cards sitting on the board. It then
6
+ * invalidates the project's board cache and records an audit event.
7
+ */
8
+ import type { z } from 'zod';
9
+ import type { EmitAuditInput } from '../storage/domains/audit/domain.js';
10
+ import type { StoredBoardInput, StoredBoardRecord, StoredBoardScope, StoredBoardsStorage } from '../storage/domains/boards/base.js';
11
+ import type { WorkItemsStorage } from '../storage/domains/work-items/base.js';
12
+ import type { ProjectBoardCache } from './project-boards.js';
13
+ export interface BoardWritesDeps {
14
+ storage: StoredBoardsStorage;
15
+ /** The per-project boards: the code boards and their seeds, skills, and the cache to invalidate. */
16
+ boards: Pick<ProjectBoardCache, 'describe' | 'invalidate' | 'codeRegistry' | 'codeSkills' | 'seedFor'>;
17
+ /** Read to refuse edits that would strand cards. */
18
+ workItems: Pick<WorkItemsStorage, 'list'>;
19
+ }
20
+ /** Who writes: stored as the board's author, and the audit event's actor. */
21
+ export interface BoardWriter {
22
+ id: string;
23
+ audit(input: EmitAuditInput): Promise<void>;
24
+ }
25
+ /** A refused board write. `status` and `body` are what the boards API answers with. */
26
+ export declare class BoardWriteError extends Error {
27
+ readonly status: 404 | 409 | 422;
28
+ readonly body: {
29
+ error: string;
30
+ message?: string;
31
+ } & Record<string, unknown>;
32
+ name: string;
33
+ constructor(status: 404 | 409 | 422, body: {
34
+ error: string;
35
+ message?: string;
36
+ } & Record<string, unknown>);
37
+ get code(): string;
38
+ }
39
+ export declare function issueMessage(issues: readonly z.core.$ZodIssue[]): string;
40
+ export declare class BoardWrites {
41
+ #private;
42
+ private readonly deps;
43
+ constructor(deps: BoardWritesDeps);
44
+ /**
45
+ * Code boards can't be created over, and Work can't be deleted while its code handlers run by its
46
+ * key; the legacy Review board can't be changed at all.
47
+ */
48
+ refuseCodeBoard(key: string, action: 'create' | 'edit' | 'delete'): void;
49
+ existing(scope: StoredBoardScope, key: string): Promise<StoredBoardRecord>;
50
+ /**
51
+ * Validates a definition the way `defineBoard()` does, plus the skills its runners name. A code
52
+ * board's copy is also checked against the code behaviour of its board and phase keys.
53
+ */
54
+ validate(input: unknown): StoredBoardInput;
55
+ /** Creates a board under a key no code board uses. */
56
+ create(scope: StoredBoardScope, input: unknown, writer: BoardWriter): Promise<StoredBoardRecord>;
57
+ /**
58
+ * Stores a validated board in a project, after its first load stored Factory's boards: creates
59
+ * it when the project has none under its key, and otherwise replaces the project's board, edited
60
+ * or not, at its current revision, with the same checks as an edit. A write that loses a race
61
+ * with another one rereads and tries again.
62
+ */
63
+ upsert(scope: StoredBoardScope, board: StoredBoardInput, writer: BoardWriter): Promise<'inserted' | 'updated' | 'unchanged'>;
64
+ /**
65
+ * Replaces a board's definition at `expectedRevision`. Saving it unchanged writes nothing;
66
+ * `written` says whether anything was stored.
67
+ */
68
+ replace(scope: StoredBoardScope, key: string, definition: Omit<StoredBoardInput, 'key'>, { expectedRevision, writer }: {
69
+ expectedRevision: number;
70
+ writer: BoardWriter;
71
+ }): Promise<{
72
+ row: StoredBoardRecord;
73
+ written: boolean;
74
+ }>;
75
+ /** Deletes a stored board that no card sits on. */
76
+ remove(scope: StoredBoardScope, key: string, { expectedRevision, writer }: {
77
+ expectedRevision: number;
78
+ writer: BoardWriter;
79
+ }): Promise<void>;
80
+ /** Rewrites a board Factory stores to Factory's current definition of it, at the next revision. */
81
+ reset(scope: StoredBoardScope, key: string, { expectedRevision, writer }: {
82
+ expectedRevision: number;
83
+ writer: BoardWriter;
84
+ }): Promise<StoredBoardRecord>;
85
+ }
86
+ //# sourceMappingURL=board-writes.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"board-writes.d.ts","sourceRoot":"","sources":["../../src/boards/board-writes.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,252 @@
1
+ import { findBoardSkillProblems } from "../skills/app-skills.js";
2
+ import { StoredBoardError } from "../storage/domains/boards/base.js";
3
+ import { codeBoardOf } from "./define-board.js";
4
+ import { createBoardRegistry } from "./registry.js";
5
+ import { boardForWorkItem } from "./semantics.js";
6
+ import { codeBehaviourConflicts, compileStoredBoard, sameBoardDefinition, storedBoardInputSchema } from "./stored-board.js";
7
+ import { workBoard } from "./work.js";
8
+ // src/boards/board-writes.ts
9
+ /** A refused board write. `status` and `body` are what the boards API answers with. */
10
+ var BoardWriteError = class extends Error {
11
+ status;
12
+ body;
13
+ name = "BoardWriteError";
14
+ constructor(status, body) {
15
+ super(body.message ?? body.error);
16
+ this.status = status;
17
+ this.body = body;
18
+ }
19
+ get code() {
20
+ return this.body.error;
21
+ }
22
+ };
23
+ function issueMessage(issues) {
24
+ return issues.map((issue) => issue.path.length > 0 ? `${issue.path.join(".")}: ${issue.message}` : issue.message).join("; ");
25
+ }
26
+ const UNKNOWN_SKILL = "but no such skill exists";
27
+ const UPSERT_ATTEMPTS = 3;
28
+ /** Storage refusals (a stale revision, a missing or existing board) as board write errors. */
29
+ async function stored(write) {
30
+ try {
31
+ return await write();
32
+ } catch (error) {
33
+ if (error instanceof StoredBoardError) throw new BoardWriteError(error.code === "board_not_found" ? 404 : 409, {
34
+ error: error.code,
35
+ message: error.message
36
+ });
37
+ throw error;
38
+ }
39
+ }
40
+ var BoardWrites = class {
41
+ deps;
42
+ constructor(deps) {
43
+ this.deps = deps;
44
+ }
45
+ /**
46
+ * Code boards can't be created over, and Work can't be deleted while its code handlers run by its
47
+ * key; the legacy Review board can't be changed at all.
48
+ */
49
+ refuseCodeBoard(key, action) {
50
+ const { boards } = this.deps;
51
+ const code = boards.codeRegistry.get(key);
52
+ if (!code) return;
53
+ const stored = boards.seedFor(key) !== void 0;
54
+ if (action === "edit" && stored) return;
55
+ if (action === "delete" && stored && codeBoardOf(code) !== workBoard) return;
56
+ throw new BoardWriteError(409, {
57
+ error: "code_board",
58
+ message: action === "delete" && stored ? `Board "${key}" is defined in code and can't be deleted; reset it to its default instead.` : `Board "${key}" is defined in code and can't be ${action === "create" ? "created over" : "changed"} here.`
59
+ });
60
+ }
61
+ async existing(scope, key) {
62
+ const row = await this.deps.storage.get(scope, key);
63
+ if (!row) throw new BoardWriteError(404, {
64
+ error: "board_not_found",
65
+ message: `Board "${key}" does not exist.`
66
+ });
67
+ return row;
68
+ }
69
+ /**
70
+ * Validates a definition the way `defineBoard()` does, plus the skills its runners name. A code
71
+ * board's copy is also checked against the code behaviour of its board and phase keys.
72
+ */
73
+ validate(input) {
74
+ const { boards } = this.deps;
75
+ const parsed = storedBoardInputSchema.safeParse(input);
76
+ if (!parsed.success) throw new BoardWriteError(422, {
77
+ error: "invalid_board",
78
+ message: issueMessage(parsed.error.issues)
79
+ });
80
+ const code = boards.seedFor(parsed.data.key) && boards.codeRegistry.get(parsed.data.key);
81
+ if (code) {
82
+ const conflicts = codeBehaviourConflicts(parsed.data, code);
83
+ if (conflicts.length > 0) throw new BoardWriteError(422, {
84
+ error: "code_behaviour",
85
+ message: conflicts.join(" "),
86
+ conflicts
87
+ });
88
+ }
89
+ const board = code ? compileStoredBoard(parsed.data, code) : compileStoredBoard(parsed.data);
90
+ const unknown = findBoardSkillProblems(createBoardRegistry({
91
+ boards: [board],
92
+ includeDefaultBoards: false
93
+ }), boards.codeSkills).filter((problem) => problem.includes(UNKNOWN_SKILL));
94
+ if (unknown.length > 0) throw new BoardWriteError(422, {
95
+ error: "unknown_skill",
96
+ message: unknown.join(" ")
97
+ });
98
+ return parsed.data;
99
+ }
100
+ /** Creates a board under a key no code board uses. */
101
+ async create(scope, input, writer) {
102
+ const key = input?.key;
103
+ if (typeof key === "string") this.refuseCodeBoard(key, "create");
104
+ const board = this.validate(input);
105
+ const row = await stored(() => this.deps.storage.create(scope, board, writer.id));
106
+ this.deps.boards.invalidate(scope);
107
+ await this.#audit(scope, writer, "created", board);
108
+ return row;
109
+ }
110
+ /**
111
+ * Stores a validated board in a project, after its first load stored Factory's boards: creates
112
+ * it when the project has none under its key, and otherwise replaces the project's board, edited
113
+ * or not, at its current revision, with the same checks as an edit. A write that loses a race
114
+ * with another one rereads and tries again.
115
+ */
116
+ async upsert(scope, board, writer) {
117
+ const { storage, boards } = this.deps;
118
+ await boards.describe(scope);
119
+ for (let attempt = 1;; attempt++) {
120
+ const row = await storage.get(scope, board.key);
121
+ try {
122
+ if (!row) {
123
+ if (!await storage.insertIfMissing(scope, board, writer.id)) throw new BoardWriteError(409, {
124
+ error: "revision_mismatch",
125
+ message: `Board "${board.key}" was stored by another write; try again.`
126
+ });
127
+ boards.invalidate(scope);
128
+ await this.#audit(scope, writer, "created", board);
129
+ return "inserted";
130
+ }
131
+ const { key, ...definition } = board;
132
+ const { written } = await this.replace(scope, key, definition, {
133
+ expectedRevision: row.revision,
134
+ writer
135
+ });
136
+ return written ? "updated" : "unchanged";
137
+ } catch (error) {
138
+ if (!(error instanceof BoardWriteError && (error.code === "revision_mismatch" || error.code === "board_not_found")) || attempt >= UPSERT_ATTEMPTS) throw error;
139
+ }
140
+ }
141
+ }
142
+ /**
143
+ * Replaces a board's definition at `expectedRevision`. Saving it unchanged writes nothing;
144
+ * `written` says whether anything was stored.
145
+ */
146
+ async replace(scope, key, definition, { expectedRevision, writer }) {
147
+ const { storage, boards } = this.deps;
148
+ this.refuseCodeBoard(key, "edit");
149
+ if (boards.seedFor(key)) await boards.describe(scope);
150
+ const row = await this.existing(scope, key);
151
+ const input = this.validate({
152
+ key,
153
+ ...definition
154
+ });
155
+ if (row.revision === expectedRevision && sameBoardDefinition(row, input)) return {
156
+ row,
157
+ written: false
158
+ };
159
+ await this.#checkPhasesFree(scope, row, input.phases);
160
+ const { key: _key, ...replacement } = input;
161
+ const replaced = await stored(() => storage.replace(scope, key, replacement, {
162
+ expectedRevision,
163
+ actor: writer.id
164
+ }));
165
+ boards.invalidate(scope);
166
+ await this.#audit(scope, writer, "updated", input);
167
+ return {
168
+ row: replaced,
169
+ written: true
170
+ };
171
+ }
172
+ /** Deletes a stored board that no card sits on. */
173
+ async remove(scope, key, { expectedRevision, writer }) {
174
+ this.refuseCodeBoard(key, "delete");
175
+ if (this.deps.boards.seedFor(key)) await this.deps.boards.describe(scope);
176
+ const row = await this.existing(scope, key);
177
+ const { cards } = await this.#occupancy(scope, key);
178
+ if (cards > 0) throw new BoardWriteError(409, {
179
+ error: "board_in_use",
180
+ message: `Board "${key}" still has cards; move or delete them first.`,
181
+ cards
182
+ });
183
+ await stored(() => this.deps.storage.delete(scope, key, { expectedRevision }));
184
+ this.deps.boards.invalidate(scope);
185
+ await this.#audit(scope, writer, "deleted", row);
186
+ }
187
+ /** Rewrites a board Factory stores to Factory's current definition of it, at the next revision. */
188
+ async reset(scope, key, { expectedRevision, writer }) {
189
+ const { storage, boards } = this.deps;
190
+ const seed = boards.seedFor(key);
191
+ if (!seed) {
192
+ this.refuseCodeBoard(key, "edit");
193
+ await this.existing(scope, key);
194
+ throw new BoardWriteError(409, {
195
+ error: "not_code_board",
196
+ message: `Board "${key}" was created in this project and has no default to reset to.`
197
+ });
198
+ }
199
+ await boards.describe(scope);
200
+ const row = await this.existing(scope, key);
201
+ await this.#checkPhasesFree(scope, row, seed.phases);
202
+ const reset = await stored(() => storage.resetTo(scope, key, seed, {
203
+ expectedRevision,
204
+ actor: writer.id
205
+ }));
206
+ boards.invalidate(scope);
207
+ await this.#audit(scope, writer, "reset", row);
208
+ return reset;
209
+ }
210
+ /** The cards on a board, and how many sit in each phase. */
211
+ async #occupancy(scope, key) {
212
+ const phases = /* @__PURE__ */ new Map();
213
+ let cards = 0;
214
+ for (const item of await this.deps.workItems.list(scope)) {
215
+ if (boardForWorkItem(item) !== key) continue;
216
+ cards++;
217
+ for (const stage of new Set(item.stages)) phases.set(stage, (phases.get(stage) ?? 0) + 1);
218
+ }
219
+ return {
220
+ cards,
221
+ phases
222
+ };
223
+ }
224
+ /** Refuses a change that removes, or changes the kind of, a phase cards sit in. */
225
+ async #checkPhasesFree(scope, row, next) {
226
+ const kinds = new Map(next.map((phase) => [phase.key, phase.kind]));
227
+ const changed = row.phases.filter((phase) => kinds.get(phase.key) !== phase.kind).map((phase) => phase.key);
228
+ if (changed.length === 0) return;
229
+ const occupancy = (await this.#occupancy(scope, row.key)).phases;
230
+ const inUse = Object.fromEntries(changed.flatMap((key) => occupancy.get(key) ? [[key, occupancy.get(key)]] : []));
231
+ if (Object.keys(inUse).length === 0) return;
232
+ throw new BoardWriteError(409, {
233
+ error: "phase_in_use",
234
+ message: `Cards sit in ${Object.entries(inUse).map(([key, count]) => `"${key}" (${count})`).join(", ")}; move them before removing those phases or changing their kind.`,
235
+ phases: inUse
236
+ });
237
+ }
238
+ async #audit(scope, writer, action, board) {
239
+ await writer.audit({
240
+ action: `factory.board.${action}`,
241
+ factoryProjectId: scope.factoryProjectId,
242
+ targets: [{
243
+ type: "board",
244
+ id: board.key,
245
+ name: board.name
246
+ }]
247
+ });
248
+ }
249
+ };
250
+ export { BoardWriteError, BoardWrites, issueMessage };
251
+
252
+ //# sourceMappingURL=board-writes.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"board-writes.js","names":[],"sources":["../../src/boards/board-writes.ts"],"sourcesContent":["/**\n * Writes to a project's stored boards, shared by the boards API and `MastraFactory#upsertBoard()`.\n *\n * Every write is checked against the rules `defineBoard()` enforces, the skills its runners name,\n * the code behaviour of a code board's copy, and the cards sitting on the board. It then\n * invalidates the project's board cache and records an audit event.\n */\n\nimport type { z } from 'zod';\n\nimport { findBoardSkillProblems } from '../skills/app-skills.js';\nimport type { EmitAuditInput } from '../storage/domains/audit/domain.js';\nimport { StoredBoardError } from '../storage/domains/boards/base.js';\nimport type {\n StoredBoardInput,\n StoredBoardRecord,\n StoredBoardScope,\n StoredBoardsStorage,\n StoredPhaseInput,\n} from '../storage/domains/boards/base.js';\nimport type { WorkItemsStorage } from '../storage/domains/work-items/base.js';\nimport { codeBoardOf } from './define-board.js';\nimport type { ProjectBoardCache } from './project-boards.js';\nimport { createBoardRegistry } from './registry.js';\nimport { boardForWorkItem } from './semantics.js';\nimport {\n codeBehaviourConflicts,\n compileStoredBoard,\n sameBoardDefinition,\n storedBoardInputSchema,\n} from './stored-board.js';\nimport { workBoard } from './work.js';\n\nexport interface BoardWritesDeps {\n storage: StoredBoardsStorage;\n /** The per-project boards: the code boards and their seeds, skills, and the cache to invalidate. */\n boards: Pick<ProjectBoardCache, 'describe' | 'invalidate' | 'codeRegistry' | 'codeSkills' | 'seedFor'>;\n /** Read to refuse edits that would strand cards. */\n workItems: Pick<WorkItemsStorage, 'list'>;\n}\n\n/** Who writes: stored as the board's author, and the audit event's actor. */\nexport interface BoardWriter {\n id: string;\n audit(input: EmitAuditInput): Promise<void>;\n}\n\n/** A refused board write. `status` and `body` are what the boards API answers with. */\nexport class BoardWriteError extends Error {\n override name = 'BoardWriteError';\n constructor(\n readonly status: 404 | 409 | 422,\n readonly body: { error: string; message?: string } & Record<string, unknown>,\n ) {\n super(body.message ?? body.error);\n }\n\n get code(): string {\n return this.body.error;\n }\n}\n\nexport function issueMessage(issues: readonly z.core.$ZodIssue[]): string {\n return issues\n .map(issue => (issue.path.length > 0 ? `${issue.path.join('.')}: ${issue.message}` : issue.message))\n .join('; ');\n}\n\nconst UNKNOWN_SKILL = 'but no such skill exists';\nconst UPSERT_ATTEMPTS = 3;\n\n/** Storage refusals (a stale revision, a missing or existing board) as board write errors. */\nasync function stored<T>(write: () => Promise<T>): Promise<T> {\n try {\n return await write();\n } catch (error) {\n if (error instanceof StoredBoardError) {\n throw new BoardWriteError(error.code === 'board_not_found' ? 404 : 409, {\n error: error.code,\n message: error.message,\n });\n }\n throw error;\n }\n}\n\nexport class BoardWrites {\n constructor(private readonly deps: BoardWritesDeps) {}\n\n /**\n * Code boards can't be created over, and Work can't be deleted while its code handlers run by its\n * key; the legacy Review board can't be changed at all.\n */\n refuseCodeBoard(key: string, action: 'create' | 'edit' | 'delete'): void {\n const { boards } = this.deps;\n const code = boards.codeRegistry.get(key);\n if (!code) return;\n const stored = boards.seedFor(key) !== undefined;\n if (action === 'edit' && stored) return;\n if (action === 'delete' && stored && codeBoardOf(code) !== workBoard) return;\n throw new BoardWriteError(409, {\n error: 'code_board',\n message:\n action === 'delete' && stored\n ? `Board \"${key}\" is defined in code and can't be deleted; reset it to its default instead.`\n : `Board \"${key}\" is defined in code and can't be ${action === 'create' ? 'created over' : 'changed'} here.`,\n });\n }\n\n async existing(scope: StoredBoardScope, key: string): Promise<StoredBoardRecord> {\n const row = await this.deps.storage.get(scope, key);\n if (!row) throw new BoardWriteError(404, { error: 'board_not_found', message: `Board \"${key}\" does not exist.` });\n return row;\n }\n\n /**\n * Validates a definition the way `defineBoard()` does, plus the skills its runners name. A code\n * board's copy is also checked against the code behaviour of its board and phase keys.\n */\n validate(input: unknown): StoredBoardInput {\n const { boards } = this.deps;\n const parsed = storedBoardInputSchema.safeParse(input);\n if (!parsed.success) {\n throw new BoardWriteError(422, { error: 'invalid_board', message: issueMessage(parsed.error.issues) });\n }\n const code = boards.seedFor(parsed.data.key) && boards.codeRegistry.get(parsed.data.key);\n if (code) {\n const conflicts = codeBehaviourConflicts(parsed.data, code);\n if (conflicts.length > 0) {\n throw new BoardWriteError(422, { error: 'code_behaviour', message: conflicts.join(' '), conflicts });\n }\n }\n const board = code ? compileStoredBoard(parsed.data, code) : compileStoredBoard(parsed.data);\n const problems = findBoardSkillProblems(\n createBoardRegistry({ boards: [board], includeDefaultBoards: false }),\n boards.codeSkills,\n );\n const unknown = problems.filter(problem => problem.includes(UNKNOWN_SKILL));\n if (unknown.length > 0) throw new BoardWriteError(422, { error: 'unknown_skill', message: unknown.join(' ') });\n return parsed.data;\n }\n\n /** Creates a board under a key no code board uses. */\n async create(scope: StoredBoardScope, input: unknown, writer: BoardWriter): Promise<StoredBoardRecord> {\n const key = (input as { key?: unknown } | null)?.key;\n if (typeof key === 'string') this.refuseCodeBoard(key, 'create');\n const board = this.validate(input);\n const row = await stored(() => this.deps.storage.create(scope, board, writer.id));\n this.deps.boards.invalidate(scope);\n await this.#audit(scope, writer, 'created', board);\n return row;\n }\n\n /**\n * Stores a validated board in a project, after its first load stored Factory's boards: creates\n * it when the project has none under its key, and otherwise replaces the project's board, edited\n * or not, at its current revision, with the same checks as an edit. A write that loses a race\n * with another one rereads and tries again.\n */\n async upsert(\n scope: StoredBoardScope,\n board: StoredBoardInput,\n writer: BoardWriter,\n ): Promise<'inserted' | 'updated' | 'unchanged'> {\n const { storage, boards } = this.deps;\n await boards.describe(scope);\n for (let attempt = 1; ; attempt++) {\n const row = await storage.get(scope, board.key);\n try {\n if (!row) {\n if (!(await storage.insertIfMissing(scope, board, writer.id))) {\n throw new BoardWriteError(409, {\n error: 'revision_mismatch',\n message: `Board \"${board.key}\" was stored by another write; try again.`,\n });\n }\n boards.invalidate(scope);\n await this.#audit(scope, writer, 'created', board);\n return 'inserted';\n }\n const { key, ...definition } = board;\n const { written } = await this.replace(scope, key, definition, { expectedRevision: row.revision, writer });\n return written ? 'updated' : 'unchanged';\n } catch (error) {\n const lost =\n error instanceof BoardWriteError && (error.code === 'revision_mismatch' || error.code === 'board_not_found');\n if (!lost || attempt >= UPSERT_ATTEMPTS) throw error;\n }\n }\n }\n\n /**\n * Replaces a board's definition at `expectedRevision`. Saving it unchanged writes nothing;\n * `written` says whether anything was stored.\n */\n async replace(\n scope: StoredBoardScope,\n key: string,\n definition: Omit<StoredBoardInput, 'key'>,\n { expectedRevision, writer }: { expectedRevision: number; writer: BoardWriter },\n ): Promise<{ row: StoredBoardRecord; written: boolean }> {\n const { storage, boards } = this.deps;\n this.refuseCodeBoard(key, 'edit');\n const seed = boards.seedFor(key);\n // The project's first load stores Factory's boards.\n if (seed) await boards.describe(scope);\n const row = await this.existing(scope, key);\n const input = this.validate({ key, ...definition });\n if (row.revision === expectedRevision && sameBoardDefinition(row, input)) {\n return { row, written: false };\n }\n await this.#checkPhasesFree(scope, row, input.phases);\n const { key: _key, ...replacement } = input;\n const replaced = await stored(() =>\n storage.replace(scope, key, replacement, { expectedRevision, actor: writer.id }),\n );\n boards.invalidate(scope);\n await this.#audit(scope, writer, 'updated', input);\n return { row: replaced, written: true };\n }\n\n /** Deletes a stored board that no card sits on. */\n async remove(\n scope: StoredBoardScope,\n key: string,\n { expectedRevision, writer }: { expectedRevision: number; writer: BoardWriter },\n ): Promise<void> {\n this.refuseCodeBoard(key, 'delete');\n // The project's first load stores Factory's boards.\n if (this.deps.boards.seedFor(key)) await this.deps.boards.describe(scope);\n const row = await this.existing(scope, key);\n const { cards } = await this.#occupancy(scope, key);\n if (cards > 0) {\n throw new BoardWriteError(409, {\n error: 'board_in_use',\n message: `Board \"${key}\" still has cards; move or delete them first.`,\n cards,\n });\n }\n await stored(() => this.deps.storage.delete(scope, key, { expectedRevision }));\n this.deps.boards.invalidate(scope);\n await this.#audit(scope, writer, 'deleted', row);\n }\n\n /** Rewrites a board Factory stores to Factory's current definition of it, at the next revision. */\n async reset(\n scope: StoredBoardScope,\n key: string,\n { expectedRevision, writer }: { expectedRevision: number; writer: BoardWriter },\n ): Promise<StoredBoardRecord> {\n const { storage, boards } = this.deps;\n const seed = boards.seedFor(key);\n if (!seed) {\n this.refuseCodeBoard(key, 'edit');\n await this.existing(scope, key);\n throw new BoardWriteError(409, {\n error: 'not_code_board',\n message: `Board \"${key}\" was created in this project and has no default to reset to.`,\n });\n }\n await boards.describe(scope);\n const row = await this.existing(scope, key);\n await this.#checkPhasesFree(scope, row, seed.phases);\n const reset = await stored(() => storage.resetTo(scope, key, seed, { expectedRevision, actor: writer.id }));\n boards.invalidate(scope);\n await this.#audit(scope, writer, 'reset', row);\n return reset;\n }\n\n /** The cards on a board, and how many sit in each phase. */\n async #occupancy(scope: StoredBoardScope, key: string): Promise<{ cards: number; phases: Map<string, number> }> {\n const phases = new Map<string, number>();\n let cards = 0;\n for (const item of await this.deps.workItems.list(scope)) {\n if (boardForWorkItem(item) !== key) continue;\n cards++;\n for (const stage of new Set(item.stages)) phases.set(stage, (phases.get(stage) ?? 0) + 1);\n }\n return { cards, phases };\n }\n\n /** Refuses a change that removes, or changes the kind of, a phase cards sit in. */\n async #checkPhasesFree(\n scope: StoredBoardScope,\n row: StoredBoardRecord,\n next: readonly StoredPhaseInput[],\n ): Promise<void> {\n const kinds = new Map(next.map(phase => [phase.key, phase.kind]));\n const changed = row.phases.filter(phase => kinds.get(phase.key) !== phase.kind).map(phase => phase.key);\n if (changed.length === 0) return;\n const occupancy = (await this.#occupancy(scope, row.key)).phases;\n const inUse = Object.fromEntries(changed.flatMap(key => (occupancy.get(key) ? [[key, occupancy.get(key)!]] : [])));\n if (Object.keys(inUse).length === 0) return;\n throw new BoardWriteError(409, {\n error: 'phase_in_use',\n message: `Cards sit in ${Object.entries(inUse)\n .map(([key, count]) => `\"${key}\" (${count})`)\n .join(', ')}; move them before removing those phases or changing their kind.`,\n phases: inUse,\n });\n }\n\n async #audit(\n scope: StoredBoardScope,\n writer: BoardWriter,\n action: 'created' | 'updated' | 'deleted' | 'reset',\n board: { key: string; name: string },\n ): Promise<void> {\n await writer.audit({\n action: `factory.board.${action}`,\n factoryProjectId: scope.factoryProjectId,\n targets: [{ type: 'board', id: board.key, name: board.name }],\n });\n }\n}\n"],"mappings":"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"}
@@ -215,14 +215,25 @@ export declare class BoardDefinitionError extends Error {
215
215
  /**
216
216
  * Declares a board in code.
217
217
  *
218
- * @deprecated Boards are stored per project; manage them with `/web/factory/projects/:id/boards`
219
- * (README § Stored boards). Code boards are read-only and served alongside each project's stored
220
- * boards.
218
+ * @deprecated Write the board's definition into projects with `factory.upsertBoard()`, or manage
219
+ * it through the boards API
220
+ * (`/web/factory/projects/:id/boards`, README "Stored boards"); removal is tracked in
221
+ * mastra-ai/mastra#28920. A board defined here still works: each project stores it once and is
222
+ * served from its row, with the code behaviour it declares.
221
223
  */
222
224
  export declare function defineBoard<const BoardId extends string, const Phases extends Record<string, BoardPhaseDefinition<keyof Phases & string>>>(config: BoardConfig<BoardId, Phases>): BoardDefinition<BoardId, keyof Phases & string>;
223
225
  /** Whether an app declared the board with the deprecated `defineBoard()`. */
224
226
  export declare function isDefinedBoard(board: object): boolean;
225
- /** Validates and resolves a board declaration. Factory's own boards use this directly. */
226
- export declare function compileBoardDefinition<const BoardId extends string, const Phases extends Record<string, BoardPhaseDefinition<keyof Phases & string>>>(config: BoardConfig<BoardId, Phases>): BoardDefinition<BoardId, keyof Phases & string>;
227
+ /** A board declaration as `defineBoard()` takes it, with any phase keys. */
228
+ export type AnyBoardConfig = BoardConfig<string, Record<string, BoardPhaseDefinition<string>>>;
229
+ /** The declaration a board was built from; undefined for an object that was not built as a board. */
230
+ export declare function declarationOf(board: object): AnyBoardConfig | undefined;
231
+ /** The code board a board takes its behaviour from: itself unless it was built from a stored definition. */
232
+ export declare function codeBoardOf<Board extends object>(board: Board): Board;
233
+ /**
234
+ * Validates and resolves a board declaration. Factory's own boards use this directly. A board
235
+ * built from a stored definition names the code board whose behaviour it carries.
236
+ */
237
+ export declare function compileBoardDefinition<const BoardId extends string, const Phases extends Record<string, BoardPhaseDefinition<keyof Phases & string>>>(config: BoardConfig<BoardId, Phases>, codeBoard?: object): BoardDefinition<BoardId, keyof Phases & string>;
227
238
  export {};
228
239
  //# sourceMappingURL=define-board.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"define-board.d.ts","sourceRoot":"","sources":["../../src/boards/define-board.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"define-board.d.ts","sourceRoot":"","sources":["../../src/boards/define-board.ts"],"names":[],"mappings":"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"}
@@ -196,9 +196,11 @@ const DEFINED_BOARD = Symbol("DefinedBoard");
196
196
  /**
197
197
  * Declares a board in code.
198
198
  *
199
- * @deprecated Boards are stored per project; manage them with `/web/factory/projects/:id/boards`
200
- * (README § Stored boards). Code boards are read-only and served alongside each project's stored
201
- * boards.
199
+ * @deprecated Write the board's definition into projects with `factory.upsertBoard()`, or manage
200
+ * it through the boards API
201
+ * (`/web/factory/projects/:id/boards`, README "Stored boards"); removal is tracked in
202
+ * mastra-ai/mastra#28920. A board defined here still works: each project stores it once and is
203
+ * served from its row, with the code behaviour it declares.
202
204
  */
203
205
  function defineBoard(config) {
204
206
  return buildBoard(config, true);
@@ -207,11 +209,29 @@ function defineBoard(config) {
207
209
  function isDefinedBoard(board) {
208
210
  return DEFINED_BOARD in board;
209
211
  }
210
- /** Validates and resolves a board declaration. Factory's own boards use this directly. */
211
- function compileBoardDefinition(config) {
212
- return buildBoard(config, false);
212
+ /**
213
+ * The declaration a board was built from. A resolved board's `onEnter` handlers already carry its
214
+ * runner's skill and instructions, so a board with other runner fields is rebuilt from this.
215
+ */
216
+ const BOARD_DECLARATION = Symbol("BoardDeclaration");
217
+ /** On a board built from a stored definition, the code board that gave it its behaviour. */
218
+ const CODE_BOARD = Symbol("CodeBoard");
219
+ /** The declaration a board was built from; undefined for an object that was not built as a board. */
220
+ function declarationOf(board) {
221
+ return board[BOARD_DECLARATION];
222
+ }
223
+ /** The code board a board takes its behaviour from: itself unless it was built from a stored definition. */
224
+ function codeBoardOf(board) {
225
+ return board[CODE_BOARD] ?? board;
226
+ }
227
+ /**
228
+ * Validates and resolves a board declaration. Factory's own boards use this directly. A board
229
+ * built from a stored definition names the code board whose behaviour it carries.
230
+ */
231
+ function compileBoardDefinition(config, codeBoard) {
232
+ return buildBoard(config, false, codeBoard);
213
233
  }
214
- function buildBoard(config, defined) {
234
+ function buildBoard(config, defined, codeBoard) {
215
235
  validateBoardIdentifier(config.id, "Board id");
216
236
  const boardName = resolveName(config.name, config.title, `Board "${config.id}"`);
217
237
  const boardDescription = optionalText(config.description, `Board "${config.id}" description`, MAX_DESCRIPTION_LENGTH);
@@ -323,8 +343,10 @@ function buildBoard(config, defined) {
323
343
  }
324
344
  };
325
345
  if (defined) Object.defineProperty(board, DEFINED_BOARD, { value: true });
346
+ Object.defineProperty(board, BOARD_DECLARATION, { value: config });
347
+ if (codeBoard) Object.defineProperty(board, CODE_BOARD, { value: codeBoardOf(codeBoard) });
326
348
  return Object.freeze(board);
327
349
  }
328
- export { BoardDefinitionError, DEFAULT_PHASE_CONTEXT, FACTORY_AGENT_ID, compileBoardDefinition, defineBoard, isDefinedBoard };
350
+ export { BoardDefinitionError, DEFAULT_PHASE_CONTEXT, FACTORY_AGENT_ID, codeBoardOf, compileBoardDefinition, declarationOf, defineBoard, isDefinedBoard };
329
351
 
330
352
  //# sourceMappingURL=define-board.js.map