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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (646) hide show
  1. package/README.md +361 -162
  2. package/dist/auth.d.ts.map +1 -1
  3. package/dist/auth.js +12 -6
  4. package/dist/auth.js.map +1 -1
  5. package/dist/boards/board-events.d.ts +23 -3
  6. package/dist/boards/board-events.d.ts.map +1 -1
  7. package/dist/boards/board-events.js +44 -7
  8. package/dist/boards/board-events.js.map +1 -1
  9. package/dist/boards/board-writes.d.ts +2 -2
  10. package/dist/boards/board-writes.d.ts.map +1 -1
  11. package/dist/boards/board-writes.js +23 -9
  12. package/dist/boards/board-writes.js.map +1 -1
  13. package/dist/boards/card-facts.d.ts +3 -1
  14. package/dist/boards/card-facts.d.ts.map +1 -1
  15. package/dist/boards/card-facts.js +30 -4
  16. package/dist/boards/card-facts.js.map +1 -1
  17. package/dist/boards/default-board.d.ts +7 -0
  18. package/dist/boards/default-board.d.ts.map +1 -0
  19. package/dist/boards/default-board.js +10 -0
  20. package/dist/boards/default-board.js.map +1 -0
  21. package/dist/boards/define-board.d.ts +40 -18
  22. package/dist/boards/define-board.d.ts.map +1 -1
  23. package/dist/boards/define-board.js +64 -42
  24. package/dist/boards/define-board.js.map +1 -1
  25. package/dist/boards/index.d.ts +6 -9
  26. package/dist/boards/index.d.ts.map +1 -1
  27. package/dist/boards/index.js +6 -20
  28. package/dist/boards/intake-routing.d.ts +29 -9
  29. package/dist/boards/intake-routing.d.ts.map +1 -1
  30. package/dist/boards/intake-routing.js +72 -20
  31. package/dist/boards/intake-routing.js.map +1 -1
  32. package/dist/boards/legacy-plan-role.d.ts.map +1 -1
  33. package/dist/boards/legacy-plan-role.js +7 -2
  34. package/dist/boards/legacy-plan-role.js.map +1 -1
  35. package/dist/boards/phase-automation.d.ts +7 -0
  36. package/dist/boards/phase-automation.d.ts.map +1 -1
  37. package/dist/boards/phase-automation.js +16 -5
  38. package/dist/boards/phase-automation.js.map +1 -1
  39. package/dist/boards/phase-runner.d.ts +18 -10
  40. package/dist/boards/phase-runner.d.ts.map +1 -1
  41. package/dist/boards/phase-runner.js +39 -34
  42. package/dist/boards/phase-runner.js.map +1 -1
  43. package/dist/boards/project-boards.d.ts +57 -11
  44. package/dist/boards/project-boards.d.ts.map +1 -1
  45. package/dist/boards/project-boards.js +161 -34
  46. package/dist/boards/project-boards.js.map +1 -1
  47. package/dist/boards/registry.d.ts +7 -1
  48. package/dist/boards/registry.d.ts.map +1 -1
  49. package/dist/boards/registry.js +19 -4
  50. package/dist/boards/registry.js.map +1 -1
  51. package/dist/boards/relocate.d.ts +1 -1
  52. package/dist/boards/relocate.d.ts.map +1 -1
  53. package/dist/boards/relocate.js +3 -2
  54. package/dist/boards/relocate.js.map +1 -1
  55. package/dist/boards/review.d.ts +5 -2
  56. package/dist/boards/review.d.ts.map +1 -1
  57. package/dist/boards/review.js +12 -11
  58. package/dist/boards/review.js.map +1 -1
  59. package/dist/boards/semantics.d.ts +160 -20
  60. package/dist/boards/semantics.d.ts.map +1 -1
  61. package/dist/boards/semantics.js +255 -23
  62. package/dist/boards/semantics.js.map +1 -1
  63. package/dist/boards/stored-board.d.ts +32 -18
  64. package/dist/boards/stored-board.d.ts.map +1 -1
  65. package/dist/boards/stored-board.js +31 -97
  66. package/dist/boards/stored-board.js.map +1 -1
  67. package/dist/boards/work-migrations.d.ts +43 -0
  68. package/dist/boards/work-migrations.d.ts.map +1 -0
  69. package/dist/boards/work-migrations.js +353 -0
  70. package/dist/boards/work-migrations.js.map +1 -0
  71. package/dist/boards/work-routes.d.ts +58 -0
  72. package/dist/boards/work-routes.d.ts.map +1 -0
  73. package/dist/boards/work-routes.js +270 -0
  74. package/dist/boards/work-routes.js.map +1 -0
  75. package/dist/boards/work-seeds.d.ts +9 -0
  76. package/dist/boards/work-seeds.d.ts.map +1 -0
  77. package/dist/boards/work-seeds.js +56 -0
  78. package/dist/boards/work-seeds.js.map +1 -0
  79. package/dist/boards/work.d.ts +8 -19
  80. package/dist/boards/work.d.ts.map +1 -1
  81. package/dist/boards/work.js +33 -281
  82. package/dist/boards/work.js.map +1 -1
  83. package/dist/environment/build-runner.d.ts.map +1 -1
  84. package/dist/environment/build-runner.js +2 -2
  85. package/dist/environment/build-runner.js.map +1 -1
  86. package/dist/environment/build-workflow.d.ts.map +1 -1
  87. package/dist/environment/build-workflow.js +6 -5
  88. package/dist/environment/build-workflow.js.map +1 -1
  89. package/dist/environment/build.d.ts +15 -2
  90. package/dist/environment/build.d.ts.map +1 -1
  91. package/dist/environment/build.js +32 -9
  92. package/dist/environment/build.js.map +1 -1
  93. package/dist/factory.d.ts +34 -7
  94. package/dist/factory.d.ts.map +1 -1
  95. package/dist/factory.js +161 -133
  96. package/dist/factory.js.map +1 -1
  97. package/dist/feed-events.d.ts +4 -4
  98. package/dist/feed-events.d.ts.map +1 -1
  99. package/dist/feed-events.js +6 -6
  100. package/dist/feed-events.js.map +1 -1
  101. package/dist/index.d.ts +7 -2
  102. package/dist/index.d.ts.map +1 -1
  103. package/dist/index.js +5 -3
  104. package/dist/integrations/base.d.ts +6 -13
  105. package/dist/integrations/base.d.ts.map +1 -1
  106. package/dist/integrations/closing-references.d.ts +15 -0
  107. package/dist/integrations/closing-references.d.ts.map +1 -0
  108. package/dist/integrations/closing-references.js +69 -0
  109. package/dist/integrations/closing-references.js.map +1 -0
  110. package/dist/integrations/github/default-rules.d.ts +15 -66
  111. package/dist/integrations/github/default-rules.d.ts.map +1 -1
  112. package/dist/integrations/github/default-rules.js +129 -73
  113. package/dist/integrations/github/default-rules.js.map +1 -1
  114. package/dist/integrations/github/integration.d.ts.map +1 -1
  115. package/dist/integrations/github/integration.js +7 -3
  116. package/dist/integrations/github/integration.js.map +1 -1
  117. package/dist/integrations/github/issue-reconciler.d.ts.map +1 -1
  118. package/dist/integrations/github/issue-reconciler.js +5 -3
  119. package/dist/integrations/github/issue-reconciler.js.map +1 -1
  120. package/dist/integrations/github/provenance.js +1 -1
  121. package/dist/integrations/github/provenance.js.map +1 -1
  122. package/dist/integrations/github/pull-request-source.d.ts +8 -0
  123. package/dist/integrations/github/pull-request-source.d.ts.map +1 -0
  124. package/dist/integrations/github/pull-request-source.js +17 -0
  125. package/dist/integrations/github/pull-request-source.js.map +1 -0
  126. package/dist/integrations/github/reconcile-worker.d.ts +5 -1
  127. package/dist/integrations/github/reconcile-worker.d.ts.map +1 -1
  128. package/dist/integrations/github/reconcile-worker.js +39 -6
  129. package/dist/integrations/github/reconcile-worker.js.map +1 -1
  130. package/dist/integrations/github/review-status-reporter.d.ts.map +1 -1
  131. package/dist/integrations/github/review-status-reporter.js +7 -3
  132. package/dist/integrations/github/review-status-reporter.js.map +1 -1
  133. package/dist/integrations/github/routes.d.ts +4 -3
  134. package/dist/integrations/github/routes.d.ts.map +1 -1
  135. package/dist/integrations/github/routes.js +10 -87
  136. package/dist/integrations/github/routes.js.map +1 -1
  137. package/dist/integrations/github/rules.d.ts +79 -7
  138. package/dist/integrations/github/rules.d.ts.map +1 -1
  139. package/dist/integrations/github/rules.js +426 -102
  140. package/dist/integrations/github/rules.js.map +1 -1
  141. package/dist/integrations/github/sandbox.d.ts +10 -2
  142. package/dist/integrations/github/sandbox.d.ts.map +1 -1
  143. package/dist/integrations/github/sandbox.js +20 -4
  144. package/dist/integrations/github/sandbox.js.map +1 -1
  145. package/dist/integrations/github/session-subscriptions.js +2 -2
  146. package/dist/integrations/github/session-subscriptions.js.map +1 -1
  147. package/dist/integrations/github/token-refresh.d.ts +2 -1
  148. package/dist/integrations/github/token-refresh.d.ts.map +1 -1
  149. package/dist/integrations/github/token-refresh.js.map +1 -1
  150. package/dist/integrations/gitlab/agent-tools.js +1 -1
  151. package/dist/integrations/gitlab/default-rules.d.ts +73 -31
  152. package/dist/integrations/gitlab/default-rules.d.ts.map +1 -1
  153. package/dist/integrations/gitlab/default-rules.js +106 -43
  154. package/dist/integrations/gitlab/default-rules.js.map +1 -1
  155. package/dist/integrations/gitlab/issue-reconciler.d.ts.map +1 -1
  156. package/dist/integrations/gitlab/issue-reconciler.js +2 -1
  157. package/dist/integrations/gitlab/issue-reconciler.js.map +1 -1
  158. package/dist/integrations/gitlab/merge-request-reconciler.d.ts.map +1 -1
  159. package/dist/integrations/gitlab/merge-request-reconciler.js +12 -5
  160. package/dist/integrations/gitlab/merge-request-reconciler.js.map +1 -1
  161. package/dist/integrations/gitlab/routes.d.ts.map +1 -1
  162. package/dist/integrations/gitlab/routes.js +1 -3
  163. package/dist/integrations/gitlab/routes.js.map +1 -1
  164. package/dist/integrations/gitlab/rules.d.ts +6 -1
  165. package/dist/integrations/gitlab/rules.d.ts.map +1 -1
  166. package/dist/integrations/gitlab/rules.js +119 -30
  167. package/dist/integrations/gitlab/rules.js.map +1 -1
  168. package/dist/integrations/gitlab/session-subscriptions.js +1 -1
  169. package/dist/integrations/incidentio/agent-tools.js +6 -6
  170. package/dist/integrations/incidentio/agent-tools.js.map +1 -1
  171. package/dist/integrations/incidentio/default-rules.d.ts.map +1 -1
  172. package/dist/integrations/incidentio/default-rules.js +3 -3
  173. package/dist/integrations/incidentio/default-rules.js.map +1 -1
  174. package/dist/integrations/incidentio/issue-reconciler.d.ts.map +1 -1
  175. package/dist/integrations/incidentio/issue-reconciler.js +2 -1
  176. package/dist/integrations/incidentio/issue-reconciler.js.map +1 -1
  177. package/dist/integrations/incidentio/routes.d.ts +2 -2
  178. package/dist/integrations/incidentio/routes.d.ts.map +1 -1
  179. package/dist/integrations/incidentio/routes.js +10 -13
  180. package/dist/integrations/incidentio/routes.js.map +1 -1
  181. package/dist/integrations/incidentio/rules.d.ts +4 -4
  182. package/dist/integrations/incidentio/rules.d.ts.map +1 -1
  183. package/dist/integrations/incidentio/rules.js +18 -14
  184. package/dist/integrations/incidentio/rules.js.map +1 -1
  185. package/dist/integrations/issue-reconciler.js +1 -1
  186. package/dist/integrations/issue-reconciler.js.map +1 -1
  187. package/dist/integrations/jira/agent-tools.js +1 -1
  188. package/dist/integrations/jira/binding-scope.d.ts +5 -6
  189. package/dist/integrations/jira/binding-scope.d.ts.map +1 -1
  190. package/dist/integrations/jira/binding-scope.js +9 -11
  191. package/dist/integrations/jira/binding-scope.js.map +1 -1
  192. package/dist/integrations/jira/default-rules.d.ts.map +1 -1
  193. package/dist/integrations/jira/default-rules.js +3 -3
  194. package/dist/integrations/jira/default-rules.js.map +1 -1
  195. package/dist/integrations/jira/issue-reconciler.d.ts.map +1 -1
  196. package/dist/integrations/jira/issue-reconciler.js +2 -1
  197. package/dist/integrations/jira/issue-reconciler.js.map +1 -1
  198. package/dist/integrations/jira/routes.d.ts.map +1 -1
  199. package/dist/integrations/jira/routes.js +3 -5
  200. package/dist/integrations/jira/routes.js.map +1 -1
  201. package/dist/integrations/jira/rules.d.ts +4 -4
  202. package/dist/integrations/jira/rules.d.ts.map +1 -1
  203. package/dist/integrations/jira/rules.js +18 -14
  204. package/dist/integrations/jira/rules.js.map +1 -1
  205. package/dist/integrations/linear/agent-tools.d.ts +9 -1
  206. package/dist/integrations/linear/agent-tools.d.ts.map +1 -1
  207. package/dist/integrations/linear/agent-tools.js +81 -3
  208. package/dist/integrations/linear/agent-tools.js.map +1 -1
  209. package/dist/integrations/linear/default-rules.d.ts.map +1 -1
  210. package/dist/integrations/linear/default-rules.js +3 -3
  211. package/dist/integrations/linear/default-rules.js.map +1 -1
  212. package/dist/integrations/linear/integration.d.ts +4 -1
  213. package/dist/integrations/linear/integration.d.ts.map +1 -1
  214. package/dist/integrations/linear/integration.js +21 -1
  215. package/dist/integrations/linear/integration.js.map +1 -1
  216. package/dist/integrations/linear/issue-reconciler.d.ts.map +1 -1
  217. package/dist/integrations/linear/issue-reconciler.js +2 -1
  218. package/dist/integrations/linear/issue-reconciler.js.map +1 -1
  219. package/dist/integrations/linear/routes.d.ts +2 -1
  220. package/dist/integrations/linear/routes.d.ts.map +1 -1
  221. package/dist/integrations/linear/routes.js +15 -17
  222. package/dist/integrations/linear/routes.js.map +1 -1
  223. package/dist/integrations/linear/rules.d.ts +4 -4
  224. package/dist/integrations/linear/rules.d.ts.map +1 -1
  225. package/dist/integrations/linear/rules.js +16 -15
  226. package/dist/integrations/linear/rules.js.map +1 -1
  227. package/dist/integrations/platform/connect/session-tools.d.ts +5 -0
  228. package/dist/integrations/platform/connect/session-tools.d.ts.map +1 -1
  229. package/dist/integrations/platform/connect/session-tools.js +5 -0
  230. package/dist/integrations/platform/connect/session-tools.js.map +1 -1
  231. package/dist/integrations/platform/github/event-worker.d.ts +4 -1
  232. package/dist/integrations/platform/github/event-worker.d.ts.map +1 -1
  233. package/dist/integrations/platform/github/event-worker.js +39 -3
  234. package/dist/integrations/platform/github/event-worker.js.map +1 -1
  235. package/dist/integrations/platform/github/integration.d.ts +8 -0
  236. package/dist/integrations/platform/github/integration.d.ts.map +1 -1
  237. package/dist/integrations/platform/github/integration.js +131 -87
  238. package/dist/integrations/platform/github/integration.js.map +1 -1
  239. package/dist/integrations/platform/jira/agent-tools.js +1 -1
  240. package/dist/integrations/platform/jira/routes.d.ts.map +1 -1
  241. package/dist/integrations/platform/jira/routes.js +3 -5
  242. package/dist/integrations/platform/jira/routes.js.map +1 -1
  243. package/dist/integrations/platform/linear/event-worker.d.ts +1 -1
  244. package/dist/integrations/platform/linear/event-worker.d.ts.map +1 -1
  245. package/dist/integrations/platform/linear/event-worker.js +1 -1
  246. package/dist/integrations/platform/linear/event-worker.js.map +1 -1
  247. package/dist/integrations/platform/linear/integration.d.ts +1 -1
  248. package/dist/integrations/platform/linear/integration.d.ts.map +1 -1
  249. package/dist/integrations/platform/linear/integration.js +6 -5
  250. package/dist/integrations/platform/linear/integration.js.map +1 -1
  251. package/dist/integrations/slack/chat-tools.js +1 -1
  252. package/dist/integrations/slack/integration.d.ts +0 -2
  253. package/dist/integrations/slack/integration.d.ts.map +1 -1
  254. package/dist/integrations/slack/integration.js +0 -5
  255. package/dist/integrations/slack/integration.js.map +1 -1
  256. package/dist/integrations/slack/reply-tool.js +1 -1
  257. package/dist/integrations/slack/run-error-card.js +1 -0
  258. package/dist/integrations/slack/run-error-card.js.map +1 -1
  259. package/dist/integrations/slack/share-file-tool.js +1 -1
  260. package/dist/integrations/slack/slack.d.ts +13 -22
  261. package/dist/integrations/slack/slack.d.ts.map +1 -1
  262. package/dist/integrations/slack/slack.js +22 -83
  263. package/dist/integrations/slack/slack.js.map +1 -1
  264. package/dist/links.d.ts +1 -2
  265. package/dist/links.d.ts.map +1 -1
  266. package/dist/links.js +4 -4
  267. package/dist/links.js.map +1 -1
  268. package/dist/mcp/routes.js +3 -3
  269. package/dist/mcp/routes.js.map +1 -1
  270. package/dist/provider-display-name.d.ts.map +1 -1
  271. package/dist/provider-display-name.js +1 -0
  272. package/dist/provider-display-name.js.map +1 -1
  273. package/dist/routes/attention-parked.d.ts +1 -0
  274. package/dist/routes/attention-parked.d.ts.map +1 -1
  275. package/dist/routes/attention-parked.js +2 -2
  276. package/dist/routes/attention-parked.js.map +1 -1
  277. package/dist/routes/attention-providers.d.ts +0 -25
  278. package/dist/routes/attention-providers.d.ts.map +1 -1
  279. package/dist/routes/attention-providers.js +2 -150
  280. package/dist/routes/attention-providers.js.map +1 -1
  281. package/dist/routes/attention.d.ts +0 -2
  282. package/dist/routes/attention.d.ts.map +1 -1
  283. package/dist/routes/attention.js +2 -13
  284. package/dist/routes/attention.js.map +1 -1
  285. package/dist/routes/automation-runs.d.ts +5 -1
  286. package/dist/routes/automation-runs.d.ts.map +1 -1
  287. package/dist/routes/automation-runs.js +15 -0
  288. package/dist/routes/automation-runs.js.map +1 -1
  289. package/dist/routes/board-snapshot.d.ts +15 -0
  290. package/dist/routes/board-snapshot.d.ts.map +1 -0
  291. package/dist/routes/board-snapshot.js +41 -0
  292. package/dist/routes/board-snapshot.js.map +1 -0
  293. package/dist/routes/boards.d.ts +2 -2
  294. package/dist/routes/boards.d.ts.map +1 -1
  295. package/dist/routes/boards.js +1 -17
  296. package/dist/routes/boards.js.map +1 -1
  297. package/dist/routes/config.d.ts +11 -1
  298. package/dist/routes/config.d.ts.map +1 -1
  299. package/dist/routes/config.js +120 -22
  300. package/dist/routes/config.js.map +1 -1
  301. package/dist/routes/contracts.d.ts +251 -51
  302. package/dist/routes/contracts.d.ts.map +1 -1
  303. package/dist/routes/contracts.js +120 -40
  304. package/dist/routes/contracts.js.map +1 -1
  305. package/dist/routes/feed-events.d.ts +15 -0
  306. package/dist/routes/feed-events.d.ts.map +1 -0
  307. package/dist/routes/feed-events.js +68 -0
  308. package/dist/routes/feed-events.js.map +1 -0
  309. package/dist/routes/fs.d.ts +4 -0
  310. package/dist/routes/fs.d.ts.map +1 -1
  311. package/dist/routes/fs.js +8 -4
  312. package/dist/routes/fs.js.map +1 -1
  313. package/dist/routes/intake-routes.d.ts.map +1 -1
  314. package/dist/routes/intake-routes.js +6 -1
  315. package/dist/routes/intake-routes.js.map +1 -1
  316. package/dist/routes/intake.d.ts +0 -23
  317. package/dist/routes/intake.d.ts.map +1 -1
  318. package/dist/routes/intake.js +13 -309
  319. package/dist/routes/intake.js.map +1 -1
  320. package/dist/routes/knowledge.js +1 -1
  321. package/dist/routes/mastra-gateway.d.ts +19 -0
  322. package/dist/routes/mastra-gateway.d.ts.map +1 -0
  323. package/dist/routes/mastra-gateway.js +120 -0
  324. package/dist/routes/mastra-gateway.js.map +1 -0
  325. package/dist/routes/projects.d.ts +1 -1
  326. package/dist/routes/projects.d.ts.map +1 -1
  327. package/dist/routes/projects.js +74 -58
  328. package/dist/routes/projects.js.map +1 -1
  329. package/dist/routes/provider-credentials.d.ts +6 -1
  330. package/dist/routes/provider-credentials.d.ts.map +1 -1
  331. package/dist/routes/provider-credentials.js +42 -7
  332. package/dist/routes/provider-credentials.js.map +1 -1
  333. package/dist/routes/route.d.ts +6 -0
  334. package/dist/routes/route.d.ts.map +1 -1
  335. package/dist/routes/route.js.map +1 -1
  336. package/dist/routes/running-packages.d.ts +13 -0
  337. package/dist/routes/running-packages.d.ts.map +1 -0
  338. package/dist/routes/running-packages.js +45 -0
  339. package/dist/routes/running-packages.js.map +1 -0
  340. package/dist/routes/sandbox-envs.d.ts +26 -0
  341. package/dist/routes/sandbox-envs.d.ts.map +1 -0
  342. package/dist/routes/sandbox-envs.js +180 -0
  343. package/dist/routes/sandbox-envs.js.map +1 -0
  344. package/dist/routes/session-access.d.ts.map +1 -1
  345. package/dist/routes/session-access.js +12 -3
  346. package/dist/routes/session-access.js.map +1 -1
  347. package/dist/routes/surface.d.ts +10 -8
  348. package/dist/routes/surface.d.ts.map +1 -1
  349. package/dist/routes/surface.js +105 -42
  350. package/dist/routes/surface.js.map +1 -1
  351. package/dist/routes/tenant-credentials.d.ts.map +1 -1
  352. package/dist/routes/tenant-credentials.js +5 -1
  353. package/dist/routes/tenant-credentials.js.map +1 -1
  354. package/dist/routes/work-items.d.ts +0 -3
  355. package/dist/routes/work-items.d.ts.map +1 -1
  356. package/dist/routes/work-items.js +38 -10
  357. package/dist/routes/work-items.js.map +1 -1
  358. package/dist/rules/binding-context.d.ts.map +1 -1
  359. package/dist/rules/binding-context.js +1 -0
  360. package/dist/rules/binding-context.js.map +1 -1
  361. package/dist/rules/dispatcher.d.ts +0 -9
  362. package/dist/rules/dispatcher.d.ts.map +1 -1
  363. package/dist/rules/dispatcher.js +362 -69
  364. package/dist/rules/dispatcher.js.map +1 -1
  365. package/dist/rules/event-rules.d.ts +33 -2
  366. package/dist/rules/event-rules.d.ts.map +1 -1
  367. package/dist/rules/event-rules.js +46 -11
  368. package/dist/rules/event-rules.js.map +1 -1
  369. package/dist/rules/index.d.ts +2 -4
  370. package/dist/rules/index.d.ts.map +1 -1
  371. package/dist/rules/index.js +2 -3
  372. package/dist/rules/phase-goal.d.ts +54 -0
  373. package/dist/rules/phase-goal.d.ts.map +1 -0
  374. package/dist/rules/phase-goal.js +70 -0
  375. package/dist/rules/phase-goal.js.map +1 -0
  376. package/dist/rules/phase-tools.d.ts +11 -0
  377. package/dist/rules/phase-tools.d.ts.map +1 -0
  378. package/dist/rules/phase-tools.js +19 -0
  379. package/dist/rules/phase-tools.js.map +1 -0
  380. package/dist/rules/processor.d.ts.map +1 -1
  381. package/dist/rules/processor.js +116 -15
  382. package/dist/rules/processor.js.map +1 -1
  383. package/dist/rules/review-source-tool.d.ts +4 -1
  384. package/dist/rules/review-source-tool.d.ts.map +1 -1
  385. package/dist/rules/review-source-tool.js +24 -4
  386. package/dist/rules/review-source-tool.js.map +1 -1
  387. package/dist/rules/rule-group.d.ts +1 -1
  388. package/dist/rules/rule-group.d.ts.map +1 -1
  389. package/dist/rules/rule-group.js +15 -6
  390. package/dist/rules/rule-group.js.map +1 -1
  391. package/dist/rules/start-coordinator.d.ts +5 -1
  392. package/dist/rules/start-coordinator.d.ts.map +1 -1
  393. package/dist/rules/start-coordinator.js +9 -3
  394. package/dist/rules/start-coordinator.js.map +1 -1
  395. package/dist/rules/tools.d.ts.map +1 -1
  396. package/dist/rules/tools.js +39 -28
  397. package/dist/rules/tools.js.map +1 -1
  398. package/dist/rules/transition-service.d.ts +4 -10
  399. package/dist/rules/transition-service.d.ts.map +1 -1
  400. package/dist/rules/transition-service.js +61 -55
  401. package/dist/rules/transition-service.js.map +1 -1
  402. package/dist/rules/types.d.ts +86 -36
  403. package/dist/rules/types.d.ts.map +1 -1
  404. package/dist/rules/types.js +5 -41
  405. package/dist/rules/types.js.map +1 -1
  406. package/dist/rules/validation.d.ts.map +1 -1
  407. package/dist/rules/validation.js +32 -2
  408. package/dist/rules/validation.js.map +1 -1
  409. package/dist/run-error.d.ts +1 -1
  410. package/dist/run-error.d.ts.map +1 -1
  411. package/dist/run-error.js +38 -5
  412. package/dist/run-error.js.map +1 -1
  413. package/dist/sandbox/sandbox-env-cache.d.ts +33 -0
  414. package/dist/sandbox/sandbox-env-cache.d.ts.map +1 -0
  415. package/dist/sandbox/sandbox-env-cache.js +140 -0
  416. package/dist/sandbox/sandbox-env-cache.js.map +1 -0
  417. package/dist/sandbox/sandbox-env.d.ts +77 -0
  418. package/dist/sandbox/sandbox-env.d.ts.map +1 -0
  419. package/dist/sandbox/sandbox-env.js +130 -0
  420. package/dist/sandbox/sandbox-env.js.map +1 -0
  421. package/dist/secret-encryption.d.ts +21 -0
  422. package/dist/secret-encryption.d.ts.map +1 -1
  423. package/dist/secret-encryption.js +31 -4
  424. package/dist/secret-encryption.js.map +1 -1
  425. package/dist/session/live-sessions.d.ts +11 -4
  426. package/dist/session/live-sessions.d.ts.map +1 -1
  427. package/dist/session/live-sessions.js +31 -10
  428. package/dist/session/live-sessions.js.map +1 -1
  429. package/dist/session/self-review-gate.d.ts +6 -4
  430. package/dist/session/self-review-gate.d.ts.map +1 -1
  431. package/dist/session/self-review-gate.js +9 -12
  432. package/dist/session/self-review-gate.js.map +1 -1
  433. package/dist/session/session-threads.d.ts +2 -3
  434. package/dist/session/session-threads.d.ts.map +1 -1
  435. package/dist/session/session-threads.js.map +1 -1
  436. package/dist/session/source-control-tools.d.ts +39 -13
  437. package/dist/session/source-control-tools.d.ts.map +1 -1
  438. package/dist/session/source-control-tools.js +55 -61
  439. package/dist/session/source-control-tools.js.map +1 -1
  440. package/dist/session/work-item-state-processor.d.ts +24 -0
  441. package/dist/session/work-item-state-processor.d.ts.map +1 -0
  442. package/dist/session/work-item-state-processor.js +275 -0
  443. package/dist/session/work-item-state-processor.js.map +1 -0
  444. package/dist/storage/domains/audit/actions.d.ts +2 -1
  445. package/dist/storage/domains/audit/actions.d.ts.map +1 -1
  446. package/dist/storage/domains/audit/actions.js +5 -4
  447. package/dist/storage/domains/audit/actions.js.map +1 -1
  448. package/dist/storage/domains/boards/base.d.ts +85 -32
  449. package/dist/storage/domains/boards/base.d.ts.map +1 -1
  450. package/dist/storage/domains/boards/base.js +120 -131
  451. package/dist/storage/domains/boards/base.js.map +1 -1
  452. package/dist/storage/domains/boards/schemas.d.ts.map +1 -1
  453. package/dist/storage/domains/boards/schemas.js +12 -0
  454. package/dist/storage/domains/boards/schemas.js.map +1 -1
  455. package/dist/storage/domains/channel-identity/base.d.ts +0 -4
  456. package/dist/storage/domains/channel-identity/base.d.ts.map +1 -1
  457. package/dist/storage/domains/channel-identity/base.js +0 -7
  458. package/dist/storage/domains/channel-identity/base.js.map +1 -1
  459. package/dist/storage/domains/intake/base.d.ts +5 -45
  460. package/dist/storage/domains/intake/base.d.ts.map +1 -1
  461. package/dist/storage/domains/intake/base.js +11 -89
  462. package/dist/storage/domains/intake/base.js.map +1 -1
  463. package/dist/storage/domains/projects/base.d.ts +17 -9
  464. package/dist/storage/domains/projects/base.d.ts.map +1 -1
  465. package/dist/storage/domains/projects/base.js +15 -7
  466. package/dist/storage/domains/projects/base.js.map +1 -1
  467. package/dist/storage/domains/sandbox-envs/base.d.ts +70 -0
  468. package/dist/storage/domains/sandbox-envs/base.d.ts.map +1 -0
  469. package/dist/storage/domains/sandbox-envs/base.js +227 -0
  470. package/dist/storage/domains/sandbox-envs/base.js.map +1 -0
  471. package/dist/storage/domains/work-items/base.d.ts +62 -22
  472. package/dist/storage/domains/work-items/base.d.ts.map +1 -1
  473. package/dist/storage/domains/work-items/base.js +218 -146
  474. package/dist/storage/domains/work-items/base.js.map +1 -1
  475. package/dist/storage/domains/work-items/board-version.d.ts +6 -2
  476. package/dist/storage/domains/work-items/board-version.d.ts.map +1 -1
  477. package/dist/storage/domains/work-items/board-version.js +20 -9
  478. package/dist/storage/domains/work-items/board-version.js.map +1 -1
  479. package/dist/storage/domains/work-items/cards.d.ts +28 -5
  480. package/dist/storage/domains/work-items/cards.d.ts.map +1 -1
  481. package/dist/storage/domains/work-items/cards.js +156 -23
  482. package/dist/storage/domains/work-items/cards.js.map +1 -1
  483. package/dist/storage/domains/work-items/legacy-review.d.ts +63 -0
  484. package/dist/storage/domains/work-items/legacy-review.d.ts.map +1 -0
  485. package/dist/storage/domains/work-items/legacy-review.js +109 -0
  486. package/dist/storage/domains/work-items/legacy-review.js.map +1 -0
  487. package/dist/storage/domains/work-items/metrics.d.ts +12 -4
  488. package/dist/storage/domains/work-items/metrics.d.ts.map +1 -1
  489. package/dist/storage/domains/work-items/metrics.js +14 -32
  490. package/dist/storage/domains/work-items/metrics.js.map +1 -1
  491. package/dist/storage/domains/work-items/work-item-schema.d.ts +4 -2
  492. package/dist/storage/domains/work-items/work-item-schema.d.ts.map +1 -1
  493. package/dist/storage/domains/work-items/work-item-schema.js +59 -26
  494. package/dist/storage/domains/work-items/work-item-schema.js.map +1 -1
  495. package/dist/tools/approval-tools.d.ts.map +1 -1
  496. package/dist/tools/approval-tools.js +28 -9
  497. package/dist/tools/approval-tools.js.map +1 -1
  498. package/dist/tools/index.d.ts +1 -1
  499. package/dist/tools/index.js +1 -1
  500. package/dist/tools/index.js.map +1 -1
  501. package/dist/tools/messaging-tools.d.ts +3 -0
  502. package/dist/tools/messaging-tools.d.ts.map +1 -1
  503. package/dist/tools/messaging-tools.js +2 -1
  504. package/dist/tools/messaging-tools.js.map +1 -1
  505. package/dist/tools/read-tools.d.ts +8 -4
  506. package/dist/tools/read-tools.d.ts.map +1 -1
  507. package/dist/tools/read-tools.js +86 -37
  508. package/dist/tools/read-tools.js.map +1 -1
  509. package/dist/tools/reports.d.ts +1 -0
  510. package/dist/tools/reports.d.ts.map +1 -1
  511. package/dist/tools/reports.js +2 -1
  512. package/dist/tools/reports.js.map +1 -1
  513. package/dist/tools/run-watch.d.ts +1 -1
  514. package/dist/tools/run-watch.d.ts.map +1 -1
  515. package/dist/tools/run-watch.js +1 -0
  516. package/dist/tools/run-watch.js.map +1 -1
  517. package/dist/tools/sandbox-tools.js +1 -1
  518. package/dist/tools/session-tools.js +1 -1
  519. package/dist/tools/sessions-state-processor.d.ts +2 -0
  520. package/dist/tools/sessions-state-processor.d.ts.map +1 -1
  521. package/dist/tools/sessions-state-processor.js +4 -2
  522. package/dist/tools/sessions-state-processor.js.map +1 -1
  523. package/dist/tools/side-sessions.d.ts +2 -0
  524. package/dist/tools/side-sessions.d.ts.map +1 -1
  525. package/dist/tools/side-sessions.js +2 -1
  526. package/dist/tools/side-sessions.js.map +1 -1
  527. package/dist/tools/work-item-tools.d.ts +0 -3
  528. package/dist/tools/work-item-tools.d.ts.map +1 -1
  529. package/dist/tools/work-item-tools.js +10 -20
  530. package/dist/tools/work-item-tools.js.map +1 -1
  531. package/dist/work-item-branch.d.ts +13 -0
  532. package/dist/work-item-branch.d.ts.map +1 -1
  533. package/dist/work-item-branch.js +16 -1
  534. package/dist/work-item-branch.js.map +1 -1
  535. package/dist/work-items/create-work-item.d.ts +6 -0
  536. package/dist/work-items/create-work-item.d.ts.map +1 -1
  537. package/dist/work-items/create-work-item.js +28 -3
  538. package/dist/work-items/create-work-item.js.map +1 -1
  539. package/dist/work-items/description-context.d.ts +5 -0
  540. package/dist/work-items/description-context.d.ts.map +1 -0
  541. package/dist/work-items/description-context.js +17 -0
  542. package/dist/work-items/description-context.js.map +1 -0
  543. package/dist/work-items/providers/base.d.ts +4 -1
  544. package/dist/work-items/providers/base.d.ts.map +1 -1
  545. package/dist/work-items/providers/base.js +6 -1
  546. package/dist/work-items/providers/base.js.map +1 -1
  547. package/dist/work-items/providers/github.d.ts.map +1 -1
  548. package/dist/work-items/providers/github.js +2 -1
  549. package/dist/work-items/providers/github.js.map +1 -1
  550. package/dist/work-items/providers/gitlab.d.ts.map +1 -1
  551. package/dist/work-items/providers/gitlab.js +2 -1
  552. package/dist/work-items/providers/gitlab.js.map +1 -1
  553. package/dist/work-items/providers/jira.d.ts.map +1 -1
  554. package/dist/work-items/providers/jira.js +3 -2
  555. package/dist/work-items/providers/jira.js.map +1 -1
  556. package/dist/work-items/providers/linear.d.ts.map +1 -1
  557. package/dist/work-items/providers/linear.js +3 -2
  558. package/dist/work-items/providers/linear.js.map +1 -1
  559. package/dist/work-items/providers/types.d.ts +6 -0
  560. package/dist/work-items/providers/types.d.ts.map +1 -1
  561. package/dist/work-items/split-migration.d.ts.map +1 -1
  562. package/dist/work-items/split-migration.js +8 -8
  563. package/dist/work-items/split-migration.js.map +1 -1
  564. package/dist/workspace.d.ts +3 -1
  565. package/dist/workspace.d.ts.map +1 -1
  566. package/dist/workspace.js +116 -32
  567. package/dist/workspace.js.map +1 -1
  568. package/factory-skills/configure-factory-rules/SKILL.md +13 -11
  569. package/factory-skills/factory-build/SKILL.md +64 -0
  570. package/factory-skills/factory-gitlab-rereview/SKILL.md +4 -4
  571. package/factory-skills/factory-gitlab-review/SKILL.md +6 -6
  572. package/factory-skills/factory-plan/SKILL.md +8 -10
  573. package/factory-skills/factory-rereview/SKILL.md +74 -28
  574. package/factory-skills/factory-review/SKILL.md +85 -29
  575. package/factory-skills/factory-self-review/SKILL.md +32 -13
  576. package/factory-skills/factory-triage/SKILL.md +36 -32
  577. package/package.json +12 -12
  578. package/dist/boards/index.js.map +0 -1
  579. package/dist/boards/pull-request-review.d.ts +0 -14
  580. package/dist/boards/pull-request-review.d.ts.map +0 -1
  581. package/dist/boards/pull-request-review.js +0 -81
  582. package/dist/boards/pull-request-review.js.map +0 -1
  583. package/dist/boards/work-tool-rules.d.ts +0 -8
  584. package/dist/boards/work-tool-rules.d.ts.map +0 -1
  585. package/dist/boards/work-tool-rules.js +0 -19
  586. package/dist/boards/work-tool-rules.js.map +0 -1
  587. package/dist/integrations/slack/emoji-shortcodes.generated.d.ts +0 -8
  588. package/dist/integrations/slack/emoji-shortcodes.generated.d.ts.map +0 -1
  589. package/dist/integrations/slack/emoji-shortcodes.generated.js +0 -1984
  590. package/dist/integrations/slack/emoji-shortcodes.generated.js.map +0 -1
  591. package/dist/integrations/slack/emoji.d.ts +0 -3
  592. package/dist/integrations/slack/emoji.d.ts.map +0 -1
  593. package/dist/integrations/slack/emoji.js +0 -11
  594. package/dist/integrations/slack/emoji.js.map +0 -1
  595. package/dist/integrations/slack/feed-publisher.d.ts +0 -26
  596. package/dist/integrations/slack/feed-publisher.d.ts.map +0 -1
  597. package/dist/integrations/slack/feed-publisher.js +0 -43
  598. package/dist/integrations/slack/feed-publisher.js.map +0 -1
  599. package/dist/routes/attention-activity.d.ts +0 -23
  600. package/dist/routes/attention-activity.d.ts.map +0 -1
  601. package/dist/routes/attention-activity.js +0 -154
  602. package/dist/routes/attention-activity.js.map +0 -1
  603. package/dist/rules/resolve.d.ts +0 -15
  604. package/dist/rules/resolve.d.ts.map +0 -1
  605. package/dist/rules/resolve.js +0 -22
  606. package/dist/rules/resolve.js.map +0 -1
  607. package/dist/storage/domains/comments/activity.d.ts +0 -40
  608. package/dist/storage/domains/comments/activity.d.ts.map +0 -1
  609. package/dist/storage/domains/comments/activity.js +0 -93
  610. package/dist/storage/domains/comments/activity.js.map +0 -1
  611. package/dist/storage/domains/comments/actor.d.ts +0 -51
  612. package/dist/storage/domains/comments/actor.d.ts.map +0 -1
  613. package/dist/storage/domains/comments/actor.js +0 -37
  614. package/dist/storage/domains/comments/actor.js.map +0 -1
  615. package/dist/storage/domains/comments/base.d.ts +0 -245
  616. package/dist/storage/domains/comments/base.d.ts.map +0 -1
  617. package/dist/storage/domains/comments/base.js +0 -539
  618. package/dist/storage/domains/comments/base.js.map +0 -1
  619. package/dist/storage/domains/comments/domain.d.ts +0 -135
  620. package/dist/storage/domains/comments/domain.d.ts.map +0 -1
  621. package/dist/storage/domains/comments/domain.js +0 -284
  622. package/dist/storage/domains/comments/domain.js.map +0 -1
  623. package/dist/storage/domains/comments/feed-context.d.ts +0 -22
  624. package/dist/storage/domains/comments/feed-context.d.ts.map +0 -1
  625. package/dist/storage/domains/comments/feed-context.js +0 -88
  626. package/dist/storage/domains/comments/feed-context.js.map +0 -1
  627. package/dist/storage/domains/comments/feed-sync.d.ts +0 -21
  628. package/dist/storage/domains/comments/feed-sync.d.ts.map +0 -1
  629. package/dist/storage/domains/comments/feed-sync.js +0 -1
  630. package/dist/storage/domains/comments/parse.d.ts +0 -23
  631. package/dist/storage/domains/comments/parse.d.ts.map +0 -1
  632. package/dist/storage/domains/comments/parse.js +0 -89
  633. package/dist/storage/domains/comments/parse.js.map +0 -1
  634. package/dist/storage/domains/comments/routes.d.ts +0 -24
  635. package/dist/storage/domains/comments/routes.d.ts.map +0 -1
  636. package/dist/storage/domains/comments/routes.js +0 -299
  637. package/dist/storage/domains/comments/routes.js.map +0 -1
  638. package/dist/storage/domains/comments/schema.d.ts +0 -5
  639. package/dist/storage/domains/comments/schema.d.ts.map +0 -1
  640. package/dist/storage/domains/comments/schema.js +0 -178
  641. package/dist/storage/domains/comments/schema.js.map +0 -1
  642. package/dist/storage/domains/comments/wire.d.ts +0 -40
  643. package/dist/storage/domains/comments/wire.d.ts.map +0 -1
  644. package/dist/storage/domains/comments/wire.js +0 -36
  645. package/dist/storage/domains/comments/wire.js.map +0 -1
  646. package/factory-skills/factory-complete-issue/SKILL.md +0 -24
@@ -1 +1 @@
1
- {"version":3,"file":"messaging-tools.js","names":[],"sources":["../../src/tools/messaging-tools.ts"],"sourcesContent":["/**\n * Messages between Factory sessions. A user session can message any session in\n * its Factory it can see; the receiver answers that exact message. Both\n * directions are `factory-session` notifications on the receiver's stored thread.\n */\n\nimport type {\n NotificationPriority,\n NotificationRecord,\n NotificationsStorage,\n SendNotificationSignalInput,\n} from '@mastra/core/notifications';\nimport { createTool } from '@mastra/core/tools';\nimport { z } from 'zod';\n\nimport type { IntegrationTools } from '../integrations/base.js';\nimport type { SourceControlSessionLookup } from '../session/factory-session.js';\nimport type { AuditRecorder } from '../storage/domains/audit/domain.js';\nimport type { SourceControlSession } from '../storage/domains/source-control/base.js';\nimport type { WorkItemsStorage } from '../storage/domains/work-items/base.js';\nimport {\n FACTORY_SESSION_NOTIFICATION_SOURCE,\n deliverFactorySessionNotification,\n resolveSessionThread,\n} from './deliver.js';\nimport type { FactoryDeliveryController, FactoryDeliveryResult } from './deliver.js';\nimport { workItemNumber } from './read-tools.js';\nimport { reportNotification, workItemReportAttributes, workItemReportRecipients } from './reports.js';\nimport { requirePerson } from './scope.js';\nimport type { FactoryToolScope } from './scope.js';\nimport { listSideSessions, sessionModel } from './side-sessions.js';\n\n/** Messages plus replies, per sender session, per target thread, per window. */\nexport const SIGNAL_RATE_LIMIT = 10;\nexport const SIGNAL_RATE_WINDOW_MS = 10 * 60 * 1000;\n/** How many recent `factory-session` notifications on a thread the rate and duplicate checks read. */\nconst RECENT_SCAN = 100;\n/** How often a waiting queue is reconsidered. Delivery still waits for a free slot in the window. */\nconst QUEUE_FLUSH_MS = 1000;\n\n/** A message accepted past the delivery cap, held until the window has a free slot. */\ninterface PendingMessage {\n notification: Omit<SendNotificationSignalInput, 'source'>;\n /** When the sender handed it over. Oldest goes first. */\n acceptedAt: number;\n actor: { actorId: string; actorType: 'human' | 'agent' };\n}\n\ninterface QueuedDelivery extends PendingMessage {\n /** The moment a slot in the window is expected to free. Set once, when it joins the queue. */\n deliverAt: number;\n target: { sessionId: string; threadId: string };\n}\n\n/**\n * Waiting messages, per sender session and target thread, oldest first.\n * Process-local: a restart drops what was still waiting, the same as a message\n * that had not been handed to the tool yet. Delivered messages live in the\n * notification store and are unaffected.\n */\nconst pendingQueues = new Map<string, QueuedDelivery[]>();\nconst flushTimers = new Map<string, ReturnType<typeof setTimeout>>();\n\nconst queueOwners = new WeakMap<object, number>();\nlet nextQueueOwnerId = 0;\n\nconst queueKey = (owner: object, senderSessionId: string, threadId: string): string => {\n let id = queueOwners.get(owner);\n if (id === undefined) {\n nextQueueOwnerId += 1;\n id = nextQueueOwnerId;\n queueOwners.set(owner, id);\n }\n return `${id}\\0${senderSessionId}\\0${threadId}`;\n};\nexport interface FactoryMessaging {\n controller: FactoryDeliveryController;\n notifications: Pick<NotificationsStorage, 'listNotifications' | 'getNotification'>;\n}\n\nexport interface FactoryMessagingToolDependencies {\n sessions: Pick<SourceControlSessionLookup, 'getBySessionId' | 'listByOrigin' | 'setOriginMuted'>;\n workItems: Pick<\n WorkItemsStorage,\n | 'findActiveRunBindingForSession'\n | 'getForProject'\n | 'hasRunBindingForSession'\n | 'listSessionSubscriptions'\n | 'listRunBindings'\n | 'listWorkItemSubscribers'\n >;\n auditRecorder: AuditRecorder;\n /** The live controller and notifications store; resolved per call because they exist only once the mount is up. */\n messaging: () => Promise<FactoryMessaging | null>;\n}\n\nconst message = z.string().trim().min(1).max(4000);\n\nfunction senderAttributes(scope: FactoryToolScope) {\n return {\n 'from-session': scope.sessionId,\n 'from-thread': scope.threadId,\n 'from-user': scope.userId,\n };\n}\n\nfunction unavailable(result: Extract<FactoryDeliveryResult, { delivered: 'skipped' }>) {\n return new Error(`The session is not available (${result.reason}).`);\n}\n\nexport function createFactoryMessagingTools(\n scope: FactoryToolScope,\n deps: FactoryMessagingToolDependencies,\n): IntegrationTools {\n const requireMessaging = async () => {\n const messaging = await deps.messaging();\n if (!messaging) throw new Error('Session messaging is not available on this server.');\n return messaging;\n };\n // Only a user-session turn the person started is the person's act. Workers\n // (even when someone types into one) and turns nobody signed in started\n // (wakes, webhooks) act as the thread's agent.\n const human = scope.kind === 'user' && scope.interactive;\n const audit = (input: { targetSessionId: string; priority: NotificationPriority; kind: string; delivery: string }) =>\n deps.auditRecorder.record({\n orgId: scope.orgId,\n actorId: human ? scope.userId : `agent:${scope.threadId}`,\n actorType: human ? 'human' : 'agent',\n action: 'factory.agent.signaled',\n factoryProjectId: scope.factoryProjectId,\n targets: [{ type: 'session', id: input.targetSessionId }],\n metadata: {\n targetSessionId: input.targetSessionId,\n priority: input.priority,\n kind: input.kind,\n delivery: input.delivery,\n },\n });\n /** Why this session can't reach `row`, or null when it can: the rule for message targets and reply targets alike. */\n const unreachable = (row: SourceControlSession | null): 'not-found' | 'private' | null => {\n if (!row || row.orgId !== scope.orgId || row.factoryProjectId !== scope.factoryProjectId) return 'not-found';\n if (row.visibility === 'private' && row.userId !== scope.userId) return 'private';\n return null;\n };\n const overRateLimit = (records: NotificationRecord[]) => countedInWindow(records).length >= SIGNAL_RATE_LIMIT;\n /** This session's delivered messages on the thread that still sit inside the window, oldest first. */\n const countedInWindow = (records: NotificationRecord[]): NotificationRecord[] => {\n const since = Date.now() - SIGNAL_RATE_WINDOW_MS;\n return records\n .filter(\n record =>\n // Everything this session sends counts except coalescing progress updates.\n record.kind !== 'progress' &&\n record.kind !== 'stage' &&\n record.attributes?.['from-session'] === scope.sessionId &&\n record.createdAt.getTime() >= since,\n )\n .sort((a, b) => a.createdAt.getTime() - b.createdAt.getTime());\n };\n /**\n * When the next message can be delivered: one window after the oldest message\n * that has to age out to free a slot, given how many are already waiting.\n */\n const nextDeliveryAt = (counted: NotificationRecord[], waiting: number): number => {\n const blocking = counted[counted.length + waiting - SIGNAL_RATE_LIMIT];\n return (blocking ? blocking.createdAt.getTime() : Date.now()) + SIGNAL_RATE_WINDOW_MS;\n };\n const queuedResult = (deliverAt: number) => ({\n delivered: 'queued' as const,\n deliverAt: new Date(deliverAt).toISOString(),\n note: `Queued; it will be delivered at about ${new Date(deliverAt).toISOString()}. Do not send it again.`,\n });\n const recent = (notifications: FactoryMessaging['notifications'], threadId: string) =>\n notifications.listNotifications({ threadId, source: FACTORY_SESSION_NOTIFICATION_SOURCE, limit: RECENT_SCAN });\n\n const actor = (): QueuedDelivery['actor'] => ({\n actorId: human ? scope.userId : `agent:${scope.threadId}`,\n actorType: human ? 'human' : 'agent',\n });\n\n /**\n * Deliver now, or hold until the window has a slot. The cap limits how fast\n * messages are delivered, not whether they are accepted.\n */\n const accept = async (\n messaging: FactoryMessaging,\n target: { sessionId: string; threadId: string },\n notification: Omit<SendNotificationSignalInput, 'source'>,\n ): Promise<\n { notificationId: string; delivered: FactoryDeliveryResult['delivered'] } | ReturnType<typeof queuedResult>\n > => {\n const counted = countedInWindow(await recent(messaging.notifications, target.threadId));\n if (counted.length < SIGNAL_RATE_LIMIT) {\n const result = await deliverFactorySessionNotification({\n controller: messaging.controller,\n sessions: deps.sessions,\n runs: deps.workItems,\n target,\n notification,\n });\n if (result.delivered === 'skipped') throw unavailable(result);\n await audit({\n targetSessionId: target.sessionId,\n priority: notification.priority ?? 'medium',\n kind: notification.kind,\n delivery: result.delivered,\n });\n return { notificationId: result.notificationId, delivered: result.delivered };\n }\n const key = queueKey(deps, scope.sessionId, target.threadId);\n const waiting = pendingQueues.get(key)?.length ?? 0;\n const deliverAt = nextDeliveryAt(counted, waiting);\n enqueue(key, {\n notification,\n acceptedAt: Date.now(),\n actor: actor(),\n deliverAt,\n target,\n });\n return queuedResult(deliverAt);\n };\n\n const enqueue = (key: string, delivery: QueuedDelivery): void => {\n const queue = pendingQueues.get(key) ?? [];\n queue.push(delivery);\n queue.sort((a, b) => a.acceptedAt - b.acceptedAt);\n pendingQueues.set(key, queue);\n scheduleFlush(key);\n };\n\n /**\n * Deliver the oldest waiting message once the window has a free slot, then\n * the next, in the order they were accepted. A target that is gone by then\n * is dropped and recorded, the same way an undeliverable live message is.\n */\n const flush = async (key: string): Promise<void> => {\n flushTimers.delete(key);\n const queue = pendingQueues.get(key);\n if (!queue || queue.length === 0) {\n pendingQueues.delete(key);\n return;\n }\n const messaging = await deps.messaging();\n if (!messaging) {\n scheduleFlush(key);\n return;\n }\n const head = queue[0];\n if (!head || head.deliverAt > Date.now()) {\n scheduleFlush(key);\n return;\n }\n const counted = countedInWindow(await recent(messaging.notifications, head.target.threadId));\n if (counted.length >= SIGNAL_RATE_LIMIT) {\n scheduleFlush(key);\n return;\n }\n queue.shift();\n if (queue.length === 0) pendingQueues.delete(key);\n const result = await deliverFactorySessionNotification({\n controller: messaging.controller,\n sessions: deps.sessions,\n runs: deps.workItems,\n target: head.target,\n notification: head.notification,\n });\n await deps.auditRecorder.record({\n orgId: scope.orgId,\n actorId: head.actor.actorId,\n actorType: head.actor.actorType,\n action: 'factory.agent.signaled',\n factoryProjectId: scope.factoryProjectId,\n targets: [{ type: 'session', id: head.target.sessionId }],\n metadata: {\n targetSessionId: head.target.sessionId,\n priority: head.notification.priority ?? 'medium',\n kind: head.notification.kind,\n delivery: result.delivered === 'skipped' ? 'dropped' : result.delivered,\n ...(result.delivered === 'skipped' ? { reason: result.reason } : {}),\n },\n });\n if (queue.length > 0) scheduleFlush(key);\n };\n\n function scheduleFlush(key: string): void {\n if (flushTimers.has(key)) return;\n if (!pendingQueues.get(key)?.[0]) return;\n const timer = setTimeout(() => {\n flushTimers.delete(key);\n void flush(key).catch(() => {\n // A failed flush leaves the rest of the queue waiting; the next tick retries the head.\n if ((pendingQueues.get(key)?.length ?? 0) > 0) scheduleFlush(key);\n });\n }, QUEUE_FLUSH_MS);\n // Keep the wait on the real clock. A fake clock that jumps the window would\n // skip a timer scheduled for the old deadline, and the message would sit.\n timer.unref?.();\n flushTimers.set(key, timer);\n }\n\n /** On turns nobody signed in started, only sessions working on items this session follows. */\n const followedWorkers = async () => {\n const project = { orgId: scope.orgId, factoryProjectId: scope.factoryProjectId };\n const follows = await deps.workItems.listSessionSubscriptions({ ...project, sessionId: scope.sessionId });\n const bindings = await Promise.all(\n follows.map(follow => deps.workItems.listRunBindings(scope.orgId, scope.factoryProjectId, follow.workItemId)),\n );\n const sideSessions = await deps.sessions.listByOrigin({ orgId: scope.orgId, originSessionId: scope.sessionId });\n return new Set([\n ...bindings\n .flat()\n .filter(binding => binding.status === 'active')\n .map(binding => binding.sessionId),\n ...sideSessions.map(session => session.sessionId),\n ]);\n };\n\n const workItemAttribute = async (sessionId: string, orgId: string, factoryProjectId: string) => {\n const binding = await deps.workItems.findActiveRunBindingForSession({ orgId, factoryProjectId, sessionId });\n if (!binding) return {};\n const item = await deps.workItems.getForProject(orgId, factoryProjectId, binding.workItemId);\n if (!item) return {};\n const number = workItemNumber(item);\n return { 'work-item': number === null ? item.id : `#${number}` };\n };\n\n const signal = createTool({\n id: 'factory_signal_session',\n description: [\n 'Send a message to another session in this Factory: a work item role session, or a teammate session you can see.',\n 'Replies come back to this session as `factory-session` notifications with kind `reply` and an `in-reply-to` attribute naming your message.',\n 'Priority `medium` (default) wakes an idle session and waits for a busy one to finish its step; use `urgent` only to make it stop and change course.',\n '`delivered` is `woken` when the session was idle and is now running, `mid-run` when it was already busy and will read the message when its run next checks in.',\n ...(scope.interactive\n ? []\n : ['On this turn you can only message your side sessions and sessions working on items this session follows.']),\n ].join(' '),\n inputSchema: z\n .object({\n sessionId: z.string().trim().min(1).max(200).describe('The session to message.'),\n message: message.describe('What to say. It arrives as-is, so make it self-contained.'),\n priority: z.enum(['low', 'medium', 'high', 'urgent']).default('medium'),\n })\n .strict(),\n execute: async ({ sessionId, message: text, priority }) => {\n if (sessionId === scope.sessionId) throw new Error(\"You can't message your own session.\");\n const row = await deps.sessions.getBySessionId(sessionId);\n const blocked = unreachable(row);\n if (blocked === 'not-found' || !row) throw new Error(`No session ${sessionId} was found in this Factory.`);\n if (blocked === 'private') throw new Error(`Session ${sessionId} is private to its owner.`);\n if (!scope.interactive && !(await followedWorkers()).has(sessionId)) {\n throw new Error(\n `On this turn you can only message this session's side sessions and sessions working on items it follows; ${sessionId} isn't one.`,\n );\n }\n\n const messaging = await requireMessaging();\n const threadId = await resolveSessionThread({\n controller: messaging.controller,\n sessions: deps.sessions,\n workItems: deps.workItems,\n sessionId,\n });\n if (!threadId) throw new Error('The session is not available (thread-not-found).');\n\n return accept(\n messaging,\n { sessionId, threadId },\n {\n kind: 'message',\n priority,\n summary: text,\n payload: { message: text },\n sourceId: scope.sessionId,\n attributes: {\n ...(await workItemAttribute(sessionId, row.orgId, scope.factoryProjectId)),\n ...senderAttributes(scope),\n },\n },\n );\n },\n });\n\n const reply = createTool({\n id: 'factory_message_origin',\n description: [\n 'Answer a message another Factory session sent you, or report on your work.',\n 'With `inReplyTo` (the id of a `factory-session` notification of kind `message`) the answer goes back to the session and thread that sent it; each message can be answered once.',\n 'Without it, the report goes to whoever follows your work: the session that started you, or everyone following your work item.',\n \"Set `status`: `progress` for an update, `blocked` when you need an answer to go on, `done` when finished, `failed` when you can't finish. Send one `done` or `failed` when you finish.\",\n ].join(' '),\n inputSchema: z\n .object({\n message: message.describe('Your answer.'),\n inReplyTo: z\n .string()\n .trim()\n .min(1)\n .max(200)\n .optional()\n .describe('Id of the message notification you are answering.'),\n status: z.enum(['progress', 'blocked', 'done', 'failed']).optional(),\n })\n .strict(),\n execute: async ({ message: text, inReplyTo, status }) => {\n if (!inReplyTo) return report(text, status);\n const messaging = await requireMessaging();\n // Only a message that reached this session's own thread can be answered,\n // and the answer goes where that message came from: never to an address\n // the model supplies.\n const original: NotificationRecord | null = await messaging.notifications.getNotification({\n threadId: scope.threadId,\n id: inReplyTo,\n });\n if (!original || original.source !== FACTORY_SESSION_NOTIFICATION_SOURCE) {\n throw new Error(`No message ${inReplyTo} was sent to this session.`);\n }\n if (original.kind !== 'message') {\n throw new Error(`Only messages can be answered; ${inReplyTo} is a ${original.kind}.`);\n }\n const fromSession = original.attributes?.['from-session'];\n const fromThread = original.attributes?.['from-thread'];\n if (typeof fromSession !== 'string' || typeof fromThread !== 'string' || original.sourceId !== fromSession) {\n throw new Error(`Message ${inReplyTo} doesn't say which session sent it.`);\n }\n // Notification records can be written outside these tools, so the\n // sender they name gets the same checks a message to it would.\n const blocked = unreachable(await deps.sessions.getBySessionId(fromSession));\n if (blocked === 'not-found') throw new Error(`Message ${inReplyTo} didn't come from a session in this Factory.`);\n if (blocked === 'private') {\n throw new Error(`Message ${inReplyTo} came from a private session this session can't answer.`);\n }\n const onSenderThread = await recent(messaging.notifications, fromThread);\n // Replies count toward the same cap as messages, so records written to\n // this session can't turn it into an unlimited high-priority sender.\n const answered = onSenderThread.some(\n record =>\n record.kind === 'reply' &&\n record.attributes?.['in-reply-to'] === inReplyTo &&\n record.attributes?.['from-session'] === scope.sessionId,\n );\n if (answered) throw new Error(`You already answered ${inReplyTo}.`);\n\n return accept(\n messaging,\n { sessionId: fromSession, threadId: fromThread },\n {\n kind: 'reply',\n priority: 'high',\n summary: text,\n payload: { message: text },\n sourceId: scope.sessionId,\n attributes: {\n ...senderAttributes(scope),\n 'in-reply-to': inReplyTo,\n ...(status ? { status } : {}),\n },\n },\n );\n },\n });\n\n /** A report with no message to answer: to the origin, else to the item's followers. */\n async function report(text: string, status: 'progress' | 'blocked' | 'done' | 'failed' | undefined) {\n const sender = { sessionId: scope.sessionId, threadId: scope.threadId, userId: scope.userId };\n let recipients: Array<{ sessionId: string; threadId: string }>;\n let attributes: Record<string, string> = {};\n if (scope.origin) {\n // The origin can mute this side session; the session keeps working, its reports just stop.\n // Blocked reports still go through, since the session cannot go on until the origin answers.\n const row = await deps.sessions.getBySessionId(scope.sessionId);\n if (row?.originMutedAt && status !== 'blocked') {\n return { delivered: 0, recipients: [], muted: true, note: 'Your origin muted your reports; keep working.' };\n }\n recipients = [scope.origin];\n } else {\n const binding = await deps.workItems.findActiveRunBindingForSession({\n orgId: scope.orgId,\n factoryProjectId: scope.factoryProjectId,\n sessionId: scope.sessionId,\n });\n if (!binding) throw new Error('Nothing started this session; pass inReplyTo to answer a message.');\n recipients = await workItemReportRecipients(deps.workItems, {\n orgId: scope.orgId,\n workItemId: binding.workItemId,\n senderSessionId: scope.sessionId,\n });\n ({ attributes } = await workItemReportAttributes(deps.workItems, {\n orgId: scope.orgId,\n factoryProjectId: scope.factoryProjectId,\n workItemId: binding.workItemId,\n role: binding.role,\n }));\n }\n if (recipients.length === 0) return { delivered: 0, recipients: [] };\n\n const messaging = await requireMessaging();\n const notification = reportNotification({ sender, status, message: text, attributes });\n const results: Array<{\n sessionId: string;\n delivered: FactoryDeliveryResult['delivered'] | 'queued';\n reason?: string;\n deliverAt?: string;\n }> = [];\n for (const recipient of recipients) {\n // Progress replaces itself while unread; anything else can wake a follower, so it counts.\n if (status !== 'progress' && overRateLimit(await recent(messaging.notifications, recipient.threadId))) {\n const counted = countedInWindow(await recent(messaging.notifications, recipient.threadId));\n const key = queueKey(deps, scope.sessionId, recipient.threadId);\n const waiting = pendingQueues.get(key)?.length ?? 0;\n const at = nextDeliveryAt(counted, waiting);\n enqueue(key, {\n notification,\n acceptedAt: Date.now(),\n actor: actor(),\n deliverAt: at,\n target: recipient,\n });\n results.push({\n sessionId: recipient.sessionId,\n delivered: 'queued',\n deliverAt: new Date(at).toISOString(),\n });\n continue;\n }\n const result = await deliverFactorySessionNotification({\n controller: messaging.controller,\n sessions: deps.sessions,\n runs: deps.workItems,\n target: recipient,\n notification,\n });\n results.push({ sessionId: recipient.sessionId, delivered: result.delivered });\n if (result.delivered === 'skipped') continue;\n await audit({\n targetSessionId: recipient.sessionId,\n priority: notification.priority ?? 'high',\n kind: notification.kind,\n delivery: result.delivered,\n });\n }\n const delivered = results.filter(result => result.delivered !== 'skipped' && result.delivered !== 'queued').length;\n const queued = results.filter(result => result.delivered === 'queued').length;\n return {\n delivered,\n recipients: results,\n ...(queued > 0\n ? {\n queued,\n note: 'Queued past the delivery cap. It will be delivered when the window allows. Do not send it again.',\n }\n : {}),\n };\n }\n\n const listSide = createTool({\n id: 'factory_list_side_sessions',\n description: [\n 'List the side sessions this session started with factory_start_session: state (running, parked waiting on an answer, idle), last report, whether you muted it, its model, and the work item it works on.',\n 'Use the session ids with factory_signal_session and factory_switch_session_model. On a turn a person started, also with factory_answer_approval, factory_unsubscribe_session and factory_subscribe_session.',\n ].join(' '),\n inputSchema: z\n .object({\n state: z.enum(['running', 'parked', 'idle']).optional().describe('Only sessions in this state.'),\n muted: z.boolean().optional().describe('true for only muted sessions, false for only unmuted ones.'),\n })\n .strict(),\n execute: async ({ state, muted }) => {\n const messaging = await deps.messaging();\n const sessions = await listSideSessions(\n {\n sessions: deps.sessions,\n workItems: deps.workItems,\n notifications: messaging?.notifications ?? null,\n isRunning: async sessionId => (await messaging?.controller.getSession(sessionId))?.stream.isActive() ?? false,\n model: messaging\n ? sessionId => sessionModel(messaging.controller, deps.sessions, deps.workItems, sessionId)\n : undefined,\n },\n scope,\n );\n return {\n sessions: sessions.filter(\n row => (!state || row.state === state) && (muted === undefined || (row.mutedAt !== null) === muted),\n ),\n };\n },\n });\n\n /** A side session this session started, or an error naming why it isn't one. */\n const ownSideSession = async (sessionId: string) => {\n const row = await deps.sessions.getBySessionId(sessionId);\n if (\n !row ||\n row.orgId !== scope.orgId ||\n row.factoryProjectId !== scope.factoryProjectId ||\n row.originSessionId !== scope.sessionId\n ) {\n throw new Error(`Session ${sessionId} is not a side session you started; see factory_list_side_sessions.`);\n }\n return row;\n };\n const sideSessionId = z\n .string()\n .trim()\n .min(1)\n .max(200)\n .describe('The side session, from factory_list_side_sessions.');\n\n const unsubscribe = createTool({\n id: 'factory_unsubscribe_session',\n description:\n \"Mute a side session you started: its reports and run-end notices stop reaching you, but it keeps working. Approval requests and blocked reports still arrive, since the session can't go on without an answer. Undo with factory_subscribe_session. Only on a turn a person started.\",\n inputSchema: z.object({ sessionId: sideSessionId }).strict(),\n execute: async ({ sessionId }) => {\n requirePerson(scope, 'mute a side session');\n const row = await ownSideSession(sessionId);\n if (row.originMutedAt) return { sessionId, muted: true, mutedAt: row.originMutedAt.toISOString() };\n await deps.sessions.setOriginMuted({ sessionId, muted: true });\n const updated = await deps.sessions.getBySessionId(sessionId);\n return { sessionId, muted: true, mutedAt: updated?.originMutedAt?.toISOString() ?? null };\n },\n });\n\n const subscribe = createTool({\n id: 'factory_subscribe_session',\n description:\n 'Unmute a side session you muted with factory_unsubscribe_session, so its reports reach you again. Reports it sent while muted are not replayed. Only on a turn a person started.',\n inputSchema: z.object({ sessionId: sideSessionId }).strict(),\n execute: async ({ sessionId }) => {\n requirePerson(scope, 'unmute a side session');\n const row = await ownSideSession(sessionId);\n if (row.originMutedAt) await deps.sessions.setOriginMuted({ sessionId, muted: false });\n return { sessionId, muted: false };\n },\n });\n\n if (scope.kind === 'worker') return { factory_message_origin: reply };\n return {\n factory_signal_session: signal,\n factory_message_origin: reply,\n factory_list_side_sessions: listSide,\n factory_unsubscribe_session: unsubscribe,\n factory_subscribe_session: subscribe,\n };\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"messaging-tools.js","names":[],"sources":["../../src/tools/messaging-tools.ts"],"sourcesContent":["/**\n * Messages between Factory sessions. A user session can message any session in\n * its Factory it can see; the receiver answers that exact message. Both\n * directions are `factory-session` notifications on the receiver's stored thread.\n */\n\nimport type {\n NotificationPriority,\n NotificationRecord,\n NotificationsStorage,\n SendNotificationSignalInput,\n} from '@mastra/core/notifications';\nimport { createTool } from '@mastra/core/tools';\nimport { z } from 'zod';\n\nimport type { IntegrationTools } from '../integrations/base.js';\nimport type { SourceControlSessionLookup } from '../session/factory-session.js';\nimport type { LiveSessions } from '../session/live-sessions.js';\nimport type { AuditRecorder } from '../storage/domains/audit/domain.js';\nimport type { SourceControlSession } from '../storage/domains/source-control/base.js';\nimport type { WorkItemsStorage } from '../storage/domains/work-items/base.js';\nimport {\n FACTORY_SESSION_NOTIFICATION_SOURCE,\n deliverFactorySessionNotification,\n resolveSessionThread,\n} from './deliver.js';\nimport type { FactoryDeliveryController, FactoryDeliveryResult } from './deliver.js';\nimport { workItemNumber } from './read-tools.js';\nimport { reportNotification, workItemReportAttributes, workItemReportRecipients } from './reports.js';\nimport { requirePerson } from './scope.js';\nimport type { FactoryToolScope } from './scope.js';\nimport { listSideSessions, sessionModel } from './side-sessions.js';\n\n/** Messages plus replies, per sender session, per target thread, per window. */\nexport const SIGNAL_RATE_LIMIT = 10;\nexport const SIGNAL_RATE_WINDOW_MS = 10 * 60 * 1000;\n/** How many recent `factory-session` notifications on a thread the rate and duplicate checks read. */\nconst RECENT_SCAN = 100;\n/** How often a waiting queue is reconsidered. Delivery still waits for a free slot in the window. */\nconst QUEUE_FLUSH_MS = 1000;\n\n/** A message accepted past the delivery cap, held until the window has a free slot. */\ninterface PendingMessage {\n notification: Omit<SendNotificationSignalInput, 'source'>;\n /** When the sender handed it over. Oldest goes first. */\n acceptedAt: number;\n actor: { actorId: string; actorType: 'human' | 'agent' };\n}\n\ninterface QueuedDelivery extends PendingMessage {\n /** The moment a slot in the window is expected to free. Set once, when it joins the queue. */\n deliverAt: number;\n target: { sessionId: string; threadId: string };\n}\n\n/**\n * Waiting messages, per sender session and target thread, oldest first.\n * Process-local: a restart drops what was still waiting, the same as a message\n * that had not been handed to the tool yet. Delivered messages live in the\n * notification store and are unaffected.\n */\nconst pendingQueues = new Map<string, QueuedDelivery[]>();\nconst flushTimers = new Map<string, ReturnType<typeof setTimeout>>();\n\nconst queueOwners = new WeakMap<object, number>();\nlet nextQueueOwnerId = 0;\n\nconst queueKey = (owner: object, senderSessionId: string, threadId: string): string => {\n let id = queueOwners.get(owner);\n if (id === undefined) {\n nextQueueOwnerId += 1;\n id = nextQueueOwnerId;\n queueOwners.set(owner, id);\n }\n return `${id}\\0${senderSessionId}\\0${threadId}`;\n};\nexport interface FactoryMessaging {\n controller: FactoryDeliveryController;\n notifications: Pick<NotificationsStorage, 'listNotifications' | 'getNotification'>;\n}\n\nexport interface FactoryMessagingToolDependencies {\n sessions: Pick<SourceControlSessionLookup, 'getBySessionId' | 'listByOrigin' | 'setOriginMuted'>;\n workItems: Pick<\n WorkItemsStorage,\n | 'findActiveRunBindingForSession'\n | 'getForProject'\n | 'hasRunBindingForSession'\n | 'listSessionSubscriptions'\n | 'listRunBindings'\n | 'listWorkItemSubscribers'\n >;\n auditRecorder: AuditRecorder;\n /** The live controller and notifications store; resolved per call because they exist only once the mount is up. */\n messaging: () => Promise<FactoryMessaging | null>;\n /** Which live sessions are parked on a tool prompt; absent before the mount is up. */\n liveSessions?: () => Pick<LiveSessions, 'parked' | 'parkedIn'> | undefined;\n}\n\nconst message = z.string().trim().min(1).max(4000);\n\nfunction senderAttributes(scope: FactoryToolScope) {\n return {\n 'from-session': scope.sessionId,\n 'from-thread': scope.threadId,\n 'from-user': scope.userId,\n };\n}\n\nfunction unavailable(result: Extract<FactoryDeliveryResult, { delivered: 'skipped' }>) {\n return new Error(`The session is not available (${result.reason}).`);\n}\n\nexport function createFactoryMessagingTools(\n scope: FactoryToolScope,\n deps: FactoryMessagingToolDependencies,\n): IntegrationTools {\n const requireMessaging = async () => {\n const messaging = await deps.messaging();\n if (!messaging) throw new Error('Session messaging is not available on this server.');\n return messaging;\n };\n // Only a user-session turn the person started is the person's act. Workers\n // (even when someone types into one) and turns nobody signed in started\n // (wakes, webhooks) act as the thread's agent.\n const human = scope.kind === 'user' && scope.interactive;\n const audit = (input: { targetSessionId: string; priority: NotificationPriority; kind: string; delivery: string }) =>\n deps.auditRecorder.record({\n orgId: scope.orgId,\n actorId: human ? scope.userId : `agent:${scope.threadId}`,\n actorType: human ? 'human' : 'agent',\n action: 'factory.agent.signaled',\n factoryProjectId: scope.factoryProjectId,\n targets: [{ type: 'session', id: input.targetSessionId }],\n metadata: {\n targetSessionId: input.targetSessionId,\n priority: input.priority,\n kind: input.kind,\n delivery: input.delivery,\n },\n });\n /** Why this session can't reach `row`, or null when it can: the rule for message targets and reply targets alike. */\n const unreachable = (row: SourceControlSession | null): 'not-found' | 'private' | null => {\n if (!row || row.orgId !== scope.orgId || row.factoryProjectId !== scope.factoryProjectId) return 'not-found';\n if (row.visibility === 'private' && row.userId !== scope.userId) return 'private';\n return null;\n };\n const overRateLimit = (records: NotificationRecord[]) => countedInWindow(records).length >= SIGNAL_RATE_LIMIT;\n /** This session's delivered messages on the thread that still sit inside the window, oldest first. */\n const countedInWindow = (records: NotificationRecord[]): NotificationRecord[] => {\n const since = Date.now() - SIGNAL_RATE_WINDOW_MS;\n return records\n .filter(\n record =>\n // Everything this session sends counts except coalescing progress updates.\n record.kind !== 'progress' &&\n record.kind !== 'stage' &&\n record.attributes?.['from-session'] === scope.sessionId &&\n record.createdAt.getTime() >= since,\n )\n .sort((a, b) => a.createdAt.getTime() - b.createdAt.getTime());\n };\n /**\n * When the next message can be delivered: one window after the oldest message\n * that has to age out to free a slot, given how many are already waiting.\n */\n const nextDeliveryAt = (counted: NotificationRecord[], waiting: number): number => {\n const blocking = counted[counted.length + waiting - SIGNAL_RATE_LIMIT];\n return (blocking ? blocking.createdAt.getTime() : Date.now()) + SIGNAL_RATE_WINDOW_MS;\n };\n const queuedResult = (deliverAt: number) => ({\n delivered: 'queued' as const,\n deliverAt: new Date(deliverAt).toISOString(),\n note: `Queued; it will be delivered at about ${new Date(deliverAt).toISOString()}. Do not send it again.`,\n });\n const recent = (notifications: FactoryMessaging['notifications'], threadId: string) =>\n notifications.listNotifications({ threadId, source: FACTORY_SESSION_NOTIFICATION_SOURCE, limit: RECENT_SCAN });\n\n const actor = (): QueuedDelivery['actor'] => ({\n actorId: human ? scope.userId : `agent:${scope.threadId}`,\n actorType: human ? 'human' : 'agent',\n });\n\n /**\n * Deliver now, or hold until the window has a slot. The cap limits how fast\n * messages are delivered, not whether they are accepted.\n */\n const accept = async (\n messaging: FactoryMessaging,\n target: { sessionId: string; threadId: string },\n notification: Omit<SendNotificationSignalInput, 'source'>,\n ): Promise<\n { notificationId: string; delivered: FactoryDeliveryResult['delivered'] } | ReturnType<typeof queuedResult>\n > => {\n const counted = countedInWindow(await recent(messaging.notifications, target.threadId));\n if (counted.length < SIGNAL_RATE_LIMIT) {\n const result = await deliverFactorySessionNotification({\n controller: messaging.controller,\n sessions: deps.sessions,\n runs: deps.workItems,\n target,\n notification,\n });\n if (result.delivered === 'skipped') throw unavailable(result);\n await audit({\n targetSessionId: target.sessionId,\n priority: notification.priority ?? 'medium',\n kind: notification.kind,\n delivery: result.delivered,\n });\n return { notificationId: result.notificationId, delivered: result.delivered };\n }\n const key = queueKey(deps, scope.sessionId, target.threadId);\n const waiting = pendingQueues.get(key)?.length ?? 0;\n const deliverAt = nextDeliveryAt(counted, waiting);\n enqueue(key, {\n notification,\n acceptedAt: Date.now(),\n actor: actor(),\n deliverAt,\n target,\n });\n return queuedResult(deliverAt);\n };\n\n const enqueue = (key: string, delivery: QueuedDelivery): void => {\n const queue = pendingQueues.get(key) ?? [];\n queue.push(delivery);\n queue.sort((a, b) => a.acceptedAt - b.acceptedAt);\n pendingQueues.set(key, queue);\n scheduleFlush(key);\n };\n\n /**\n * Deliver the oldest waiting message once the window has a free slot, then\n * the next, in the order they were accepted. A target that is gone by then\n * is dropped and recorded, the same way an undeliverable live message is.\n */\n const flush = async (key: string): Promise<void> => {\n flushTimers.delete(key);\n const queue = pendingQueues.get(key);\n if (!queue || queue.length === 0) {\n pendingQueues.delete(key);\n return;\n }\n const messaging = await deps.messaging();\n if (!messaging) {\n scheduleFlush(key);\n return;\n }\n const head = queue[0];\n if (!head || head.deliverAt > Date.now()) {\n scheduleFlush(key);\n return;\n }\n const counted = countedInWindow(await recent(messaging.notifications, head.target.threadId));\n if (counted.length >= SIGNAL_RATE_LIMIT) {\n scheduleFlush(key);\n return;\n }\n queue.shift();\n if (queue.length === 0) pendingQueues.delete(key);\n const result = await deliverFactorySessionNotification({\n controller: messaging.controller,\n sessions: deps.sessions,\n runs: deps.workItems,\n target: head.target,\n notification: head.notification,\n });\n await deps.auditRecorder.record({\n orgId: scope.orgId,\n actorId: head.actor.actorId,\n actorType: head.actor.actorType,\n action: 'factory.agent.signaled',\n factoryProjectId: scope.factoryProjectId,\n targets: [{ type: 'session', id: head.target.sessionId }],\n metadata: {\n targetSessionId: head.target.sessionId,\n priority: head.notification.priority ?? 'medium',\n kind: head.notification.kind,\n delivery: result.delivered === 'skipped' ? 'dropped' : result.delivered,\n ...(result.delivered === 'skipped' ? { reason: result.reason } : {}),\n },\n });\n if (queue.length > 0) scheduleFlush(key);\n };\n\n function scheduleFlush(key: string): void {\n if (flushTimers.has(key)) return;\n if (!pendingQueues.get(key)?.[0]) return;\n const timer = setTimeout(() => {\n flushTimers.delete(key);\n void flush(key).catch(() => {\n // A failed flush leaves the rest of the queue waiting; the next tick retries the head.\n if ((pendingQueues.get(key)?.length ?? 0) > 0) scheduleFlush(key);\n });\n }, QUEUE_FLUSH_MS);\n // Keep the wait on the real clock. A fake clock that jumps the window would\n // skip a timer scheduled for the old deadline, and the message would sit.\n timer.unref?.();\n flushTimers.set(key, timer);\n }\n\n /** On turns nobody signed in started, only sessions working on items this session follows. */\n const followedWorkers = async () => {\n const project = { orgId: scope.orgId, factoryProjectId: scope.factoryProjectId };\n const follows = await deps.workItems.listSessionSubscriptions({ ...project, sessionId: scope.sessionId });\n const bindings = await Promise.all(\n follows.map(follow => deps.workItems.listRunBindings(scope.orgId, scope.factoryProjectId, follow.workItemId)),\n );\n const sideSessions = await deps.sessions.listByOrigin({ orgId: scope.orgId, originSessionId: scope.sessionId });\n return new Set([\n ...bindings\n .flat()\n .filter(binding => binding.status === 'active')\n .map(binding => binding.sessionId),\n ...sideSessions.map(session => session.sessionId),\n ]);\n };\n\n const workItemAttribute = async (sessionId: string, orgId: string, factoryProjectId: string) => {\n const binding = await deps.workItems.findActiveRunBindingForSession({ orgId, factoryProjectId, sessionId });\n if (!binding) return {};\n const item = await deps.workItems.getForProject(orgId, factoryProjectId, binding.workItemId);\n if (!item) return {};\n const number = workItemNumber(item);\n return { 'work-item': number === null ? item.id : `#${number}` };\n };\n\n const signal = createTool({\n id: 'factory_signal_session',\n description: [\n 'Send a message to another session in this Factory: a work item role session, or a teammate session you can see.',\n 'Replies come back to this session as `factory-session` notifications with kind `reply` and an `in-reply-to` attribute naming your message.',\n 'Priority `medium` (default) wakes an idle session and waits for a busy one to finish its step; use `urgent` only to make it stop and change course.',\n '`delivered` is `woken` when the session was idle and is now running, `mid-run` when it was already busy and will read the message when its run next checks in.',\n ...(scope.interactive\n ? []\n : ['On this turn you can only message your side sessions and sessions working on items this session follows.']),\n ].join(' '),\n inputSchema: z\n .object({\n sessionId: z.string().trim().min(1).max(200).describe('The session to message.'),\n message: message.describe('What to say. It arrives as-is, so make it self-contained.'),\n priority: z.enum(['low', 'medium', 'high', 'urgent']).default('medium'),\n })\n .strict(),\n execute: async ({ sessionId, message: text, priority }) => {\n if (sessionId === scope.sessionId) throw new Error(\"You can't message your own session.\");\n const row = await deps.sessions.getBySessionId(sessionId);\n const blocked = unreachable(row);\n if (blocked === 'not-found' || !row) throw new Error(`No session ${sessionId} was found in this Factory.`);\n if (blocked === 'private') throw new Error(`Session ${sessionId} is private to its owner.`);\n if (!scope.interactive && !(await followedWorkers()).has(sessionId)) {\n throw new Error(\n `On this turn you can only message this session's side sessions and sessions working on items it follows; ${sessionId} isn't one.`,\n );\n }\n\n const messaging = await requireMessaging();\n const threadId = await resolveSessionThread({\n controller: messaging.controller,\n sessions: deps.sessions,\n workItems: deps.workItems,\n sessionId,\n });\n if (!threadId) throw new Error('The session is not available (thread-not-found).');\n\n return accept(\n messaging,\n { sessionId, threadId },\n {\n kind: 'message',\n priority,\n summary: text,\n payload: { message: text },\n sourceId: scope.sessionId,\n attributes: {\n ...(await workItemAttribute(sessionId, row.orgId, scope.factoryProjectId)),\n ...senderAttributes(scope),\n },\n },\n );\n },\n });\n\n const reply = createTool({\n id: 'factory_message_origin',\n description: [\n 'Answer a message another Factory session sent you, or report on your work.',\n 'With `inReplyTo` (the id of a `factory-session` notification of kind `message`) the answer goes back to the session and thread that sent it; each message can be answered once.',\n 'Without it, the report goes to whoever follows your work: the session that started you, or everyone following your work item.',\n \"Set `status`: `progress` for an update, `blocked` when you need an answer to go on, `done` when finished, `failed` when you can't finish. Send one `done` or `failed` when you finish.\",\n ].join(' '),\n inputSchema: z\n .object({\n message: message.describe('Your answer.'),\n inReplyTo: z\n .string()\n .trim()\n .min(1)\n .max(200)\n .optional()\n .describe('Id of the message notification you are answering.'),\n status: z.enum(['progress', 'blocked', 'done', 'failed']).optional(),\n })\n .strict(),\n execute: async ({ message: text, inReplyTo, status }) => {\n if (!inReplyTo) return report(text, status);\n const messaging = await requireMessaging();\n // Only a message that reached this session's own thread can be answered,\n // and the answer goes where that message came from: never to an address\n // the model supplies.\n const original: NotificationRecord | null = await messaging.notifications.getNotification({\n threadId: scope.threadId,\n id: inReplyTo,\n });\n if (!original || original.source !== FACTORY_SESSION_NOTIFICATION_SOURCE) {\n throw new Error(`No message ${inReplyTo} was sent to this session.`);\n }\n if (original.kind !== 'message') {\n throw new Error(`Only messages can be answered; ${inReplyTo} is a ${original.kind}.`);\n }\n const fromSession = original.attributes?.['from-session'];\n const fromThread = original.attributes?.['from-thread'];\n if (typeof fromSession !== 'string' || typeof fromThread !== 'string' || original.sourceId !== fromSession) {\n throw new Error(`Message ${inReplyTo} doesn't say which session sent it.`);\n }\n // Notification records can be written outside these tools, so the\n // sender they name gets the same checks a message to it would.\n const blocked = unreachable(await deps.sessions.getBySessionId(fromSession));\n if (blocked === 'not-found') throw new Error(`Message ${inReplyTo} didn't come from a session in this Factory.`);\n if (blocked === 'private') {\n throw new Error(`Message ${inReplyTo} came from a private session this session can't answer.`);\n }\n const onSenderThread = await recent(messaging.notifications, fromThread);\n // Replies count toward the same cap as messages, so records written to\n // this session can't turn it into an unlimited high-priority sender.\n const answered = onSenderThread.some(\n record =>\n record.kind === 'reply' &&\n record.attributes?.['in-reply-to'] === inReplyTo &&\n record.attributes?.['from-session'] === scope.sessionId,\n );\n if (answered) throw new Error(`You already answered ${inReplyTo}.`);\n\n return accept(\n messaging,\n { sessionId: fromSession, threadId: fromThread },\n {\n kind: 'reply',\n priority: 'high',\n summary: text,\n payload: { message: text },\n sourceId: scope.sessionId,\n attributes: {\n ...senderAttributes(scope),\n 'in-reply-to': inReplyTo,\n ...(status ? { status } : {}),\n },\n },\n );\n },\n });\n\n /** A report with no message to answer: to the origin, else to the item's followers. */\n async function report(text: string, status: 'progress' | 'blocked' | 'done' | 'failed' | undefined) {\n const sender = { sessionId: scope.sessionId, threadId: scope.threadId, userId: scope.userId };\n let recipients: Array<{ sessionId: string; threadId: string }>;\n let attributes: Record<string, string> = {};\n if (scope.origin) {\n // The origin can mute this side session; the session keeps working, its reports just stop.\n // Blocked reports still go through, since the session cannot go on until the origin answers.\n const row = await deps.sessions.getBySessionId(scope.sessionId);\n if (row?.originMutedAt && status !== 'blocked') {\n return { delivered: 0, recipients: [], muted: true, note: 'Your origin muted your reports; keep working.' };\n }\n recipients = [scope.origin];\n } else {\n const binding = await deps.workItems.findActiveRunBindingForSession({\n orgId: scope.orgId,\n factoryProjectId: scope.factoryProjectId,\n sessionId: scope.sessionId,\n });\n if (!binding) throw new Error('Nothing started this session; pass inReplyTo to answer a message.');\n recipients = await workItemReportRecipients(deps.workItems, {\n orgId: scope.orgId,\n workItemId: binding.workItemId,\n senderSessionId: scope.sessionId,\n });\n ({ attributes } = await workItemReportAttributes(deps.workItems, {\n orgId: scope.orgId,\n factoryProjectId: scope.factoryProjectId,\n workItemId: binding.workItemId,\n role: binding.role,\n }));\n }\n if (recipients.length === 0) return { delivered: 0, recipients: [] };\n\n const messaging = await requireMessaging();\n const notification = reportNotification({ sender, status, message: text, attributes });\n const results: Array<{\n sessionId: string;\n delivered: FactoryDeliveryResult['delivered'] | 'queued';\n reason?: string;\n deliverAt?: string;\n }> = [];\n for (const recipient of recipients) {\n // Progress replaces itself while unread; anything else can wake a follower, so it counts.\n if (status !== 'progress' && overRateLimit(await recent(messaging.notifications, recipient.threadId))) {\n const counted = countedInWindow(await recent(messaging.notifications, recipient.threadId));\n const key = queueKey(deps, scope.sessionId, recipient.threadId);\n const waiting = pendingQueues.get(key)?.length ?? 0;\n const at = nextDeliveryAt(counted, waiting);\n enqueue(key, {\n notification,\n acceptedAt: Date.now(),\n actor: actor(),\n deliverAt: at,\n target: recipient,\n });\n results.push({\n sessionId: recipient.sessionId,\n delivered: 'queued',\n deliverAt: new Date(at).toISOString(),\n });\n continue;\n }\n const result = await deliverFactorySessionNotification({\n controller: messaging.controller,\n sessions: deps.sessions,\n runs: deps.workItems,\n target: recipient,\n notification,\n });\n results.push({ sessionId: recipient.sessionId, delivered: result.delivered });\n if (result.delivered === 'skipped') continue;\n await audit({\n targetSessionId: recipient.sessionId,\n priority: notification.priority ?? 'high',\n kind: notification.kind,\n delivery: result.delivered,\n });\n }\n const delivered = results.filter(result => result.delivered !== 'skipped' && result.delivered !== 'queued').length;\n const queued = results.filter(result => result.delivered === 'queued').length;\n return {\n delivered,\n recipients: results,\n ...(queued > 0\n ? {\n queued,\n note: 'Queued past the delivery cap. It will be delivered when the window allows. Do not send it again.',\n }\n : {}),\n };\n }\n\n const listSide = createTool({\n id: 'factory_list_side_sessions',\n description: [\n 'List the side sessions this session started with factory_start_session: state (running, parked waiting on an answer, idle), last report, whether you muted it, its model, and the work item it works on.',\n 'Use the session ids with factory_signal_session and factory_switch_session_model. On a turn a person started, also with factory_answer_approval, factory_unsubscribe_session and factory_subscribe_session.',\n ].join(' '),\n inputSchema: z\n .object({\n state: z.enum(['running', 'parked', 'idle']).optional().describe('Only sessions in this state.'),\n muted: z.boolean().optional().describe('true for only muted sessions, false for only unmuted ones.'),\n })\n .strict(),\n execute: async ({ state, muted }) => {\n const messaging = await deps.messaging();\n const sessions = await listSideSessions(\n {\n sessions: deps.sessions,\n workItems: deps.workItems,\n notifications: messaging?.notifications ?? null,\n isRunning: async sessionId => (await messaging?.controller.getSession(sessionId))?.stream.isActive() ?? false,\n isParked: sessionId => deps.liveSessions?.()?.parked(sessionId) !== undefined,\n model: messaging\n ? sessionId => sessionModel(messaging.controller, deps.sessions, deps.workItems, sessionId)\n : undefined,\n },\n scope,\n );\n return {\n sessions: sessions.filter(\n row => (!state || row.state === state) && (muted === undefined || (row.mutedAt !== null) === muted),\n ),\n };\n },\n });\n\n /** A side session this session started, or an error naming why it isn't one. */\n const ownSideSession = async (sessionId: string) => {\n const row = await deps.sessions.getBySessionId(sessionId);\n if (\n !row ||\n row.orgId !== scope.orgId ||\n row.factoryProjectId !== scope.factoryProjectId ||\n row.originSessionId !== scope.sessionId\n ) {\n throw new Error(`Session ${sessionId} is not a side session you started; see factory_list_side_sessions.`);\n }\n return row;\n };\n const sideSessionId = z\n .string()\n .trim()\n .min(1)\n .max(200)\n .describe('The side session, from factory_list_side_sessions.');\n\n const unsubscribe = createTool({\n id: 'factory_unsubscribe_session',\n description:\n \"Mute a side session you started: its reports and run-end notices stop reaching you, but it keeps working. Approval requests and blocked reports still arrive, since the session can't go on without an answer. Undo with factory_subscribe_session. Only on a turn a person started.\",\n inputSchema: z.object({ sessionId: sideSessionId }).strict(),\n execute: async ({ sessionId }) => {\n requirePerson(scope, 'mute a side session');\n const row = await ownSideSession(sessionId);\n if (row.originMutedAt) return { sessionId, muted: true, mutedAt: row.originMutedAt.toISOString() };\n await deps.sessions.setOriginMuted({ sessionId, muted: true });\n const updated = await deps.sessions.getBySessionId(sessionId);\n return { sessionId, muted: true, mutedAt: updated?.originMutedAt?.toISOString() ?? null };\n },\n });\n\n const subscribe = createTool({\n id: 'factory_subscribe_session',\n description:\n 'Unmute a side session you muted with factory_unsubscribe_session, so its reports reach you again. Reports it sent while muted are not replayed. Only on a turn a person started.',\n inputSchema: z.object({ sessionId: sideSessionId }).strict(),\n execute: async ({ sessionId }) => {\n requirePerson(scope, 'unmute a side session');\n const row = await ownSideSession(sessionId);\n if (row.originMutedAt) await deps.sessions.setOriginMuted({ sessionId, muted: false });\n return { sessionId, muted: false };\n },\n });\n\n if (scope.kind === 'worker') return { factory_message_origin: reply };\n return {\n factory_signal_session: signal,\n factory_message_origin: reply,\n factory_list_side_sessions: listSide,\n factory_unsubscribe_session: unsubscribe,\n factory_subscribe_session: subscribe,\n };\n}\n"],"mappings":"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"}
@@ -2,8 +2,9 @@ import { z } from 'zod';
2
2
  import type { BoardRegistry } from '../boards/index.js';
3
3
  import type { ProjectBoardSource } from '../boards/project-boards.js';
4
4
  import type { IntegrationTools } from '../integrations/base.js';
5
+ import type { SourceControlSessionLookup } from '../session/factory-session.js';
6
+ import type { LiveSessions } from '../session/live-sessions.js';
5
7
  import type { AuditStorage } from '../storage/domains/audit/base.js';
6
- import type { WorkItemCommentsStorage } from '../storage/domains/comments/base.js';
7
8
  import type { Card, WorkItemsStorage } from '../storage/domains/work-items/base.js';
8
9
  import type { FactoryMessaging } from './messaging-tools.js';
9
10
  import type { FactoryToolScope } from './scope.js';
@@ -12,16 +13,19 @@ export declare const MAX_ERROR = 400;
12
13
  export declare const MAX_LIST = 50;
13
14
  export interface FactoryReadToolDependencies {
14
15
  workItems: Pick<WorkItemsStorage, 'listShared' | 'getForProject' | 'listRunBindings' | 'listDeferredDecisions' | 'listByIds' | 'listDecisionsForEvaluations' | 'listWorkItemSubscribers' | 'listSessionSubscriptions'>;
15
- comments: Pick<WorkItemCommentsStorage, 'listRecent'>;
16
16
  audit: Pick<AuditStorage, 'list'>;
17
17
  /** A fixed registry, or the per-project boards. */
18
18
  boards: BoardRegistry | ProjectBoardSource;
19
19
  /** The live controller, for whether a session is mid-run and when it last moved; absent before the mount is up. */
20
20
  messaging?: () => Promise<Pick<FactoryMessaging, 'controller'> | null>;
21
+ /** Finds the caller session's source-control provider, to tell which cards can't pick a repository. */
22
+ sessions?: Pick<SourceControlSessionLookup, 'getSourceControlBySessionId'>;
23
+ /** Which live sessions are parked on a tool prompt; absent before the mount is up. */
24
+ liveSessions?: () => Pick<LiveSessions, 'parked' | 'parkedIn'> | undefined;
21
25
  }
22
26
  export declare function truncate(text: string, max: number): string;
23
- /** The number a person sees on the card: the issue or PR number the item was filed from. */
24
- export declare function workItemNumber(item: Pick<Card, 'workItem'>): number | null;
27
+ /** The number a person sees on the card: the issue or PR number the item was filed from, or the project's own number for a card filed by hand. */
28
+ export declare function workItemNumber(item: Pick<Card, 'workItem' | 'metadata'>): number | null;
25
29
  export declare function workItemStage(item: Pick<Card, 'stages'>): string;
26
30
  /** A work item id or its card number; anything else can't name an item. */
27
31
  export declare const workItemRefSchema: z.ZodString;
@@ -1 +1 @@
1
- {"version":3,"file":"read-tools.d.ts","sourceRoot":"","sources":["../../src/tools/read-tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAKhE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AACnF,OAAO,KAAK,EAGV,IAAI,EACJ,gBAAgB,EACjB,MAAM,uCAAuC,CAAC;AAG/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,eAAO,MAAM,QAAQ,MAAM,CAAC;AAC5B,eAAO,MAAM,SAAS,MAAM,CAAC;AAC7B,eAAO,MAAM,QAAQ,KAAK,CAAC;AAG3B,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,IAAI,CACb,gBAAgB,EACd,YAAY,GACZ,eAAe,GACf,iBAAiB,GACjB,uBAAuB,GACvB,WAAW,GACX,6BAA6B,GAC7B,yBAAyB,GACzB,0BAA0B,CAC7B,CAAC;IACF,QAAQ,EAAE,IAAI,CAAC,uBAAuB,EAAE,YAAY,CAAC,CAAC;IACtD,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAClC,mDAAmD;IACnD,MAAM,EAAE,aAAa,GAAG,kBAAkB,CAAC;IAC3C,mHAAmH;IACnH,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,YAAY,CAAC,GAAG,IAAI,CAAC,CAAC;CACxE;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE1D;AAQD,4FAA4F;AAC5F,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,GAAG,MAAM,GAAG,IAAI,CAM1E;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,MAAM,CAEhE;AAED,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB,aAOyB,CAAC;AAExD,+GAA+G;AAC/G,wBAAsB,YAAY,CAChC,SAAS,EAAE,IAAI,CAAC,gBAAgB,EAAE,YAAY,GAAG,eAAe,CAAC,EACjE,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,kBAAkB,CAAC,EAC3D,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAStB;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAEnD;AAsFD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,2BAA2B,GAAG,gBAAgB,CA2NnH"}
1
+ {"version":3,"file":"read-tools.d.ts","sourceRoot":"","sources":["../../src/tools/read-tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAMhE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAChF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEhE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,KAAK,EAGV,IAAI,EACJ,gBAAgB,EACjB,MAAM,uCAAuC,CAAC;AAI/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,eAAO,MAAM,QAAQ,MAAM,CAAC;AAC5B,eAAO,MAAM,SAAS,MAAM,CAAC;AAC7B,eAAO,MAAM,QAAQ,KAAK,CAAC;AAG3B,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,IAAI,CACb,gBAAgB,EACd,YAAY,GACZ,eAAe,GACf,iBAAiB,GACjB,uBAAuB,GACvB,WAAW,GACX,6BAA6B,GAC7B,yBAAyB,GACzB,0BAA0B,CAC7B,CAAC;IACF,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAClC,mDAAmD;IACnD,MAAM,EAAE,aAAa,GAAG,kBAAkB,CAAC;IAC3C,mHAAmH;IACnH,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,YAAY,CAAC,GAAG,IAAI,CAAC,CAAC;IACvE,uGAAuG;IACvG,QAAQ,CAAC,EAAE,IAAI,CAAC,0BAA0B,EAAE,6BAA6B,CAAC,CAAC;IAC3E,sFAAsF;IACtF,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC,YAAY,EAAE,QAAQ,GAAG,UAAU,CAAC,GAAG,SAAS,CAAC;CAC5E;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE1D;AAQD,kJAAkJ;AAClJ,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAAC,GAAG,MAAM,GAAG,IAAI,CAOvF;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,MAAM,CAEhE;AAED,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB,aAOyB,CAAC;AAExD,+GAA+G;AAC/G,wBAAsB,YAAY,CAChC,SAAS,EAAE,IAAI,CAAC,gBAAgB,EAAE,YAAY,GAAG,eAAe,CAAC,EACjE,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,kBAAkB,CAAC,EAC3D,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAmBtB;AAQD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAEnD;AAyFD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,2BAA2B,GAAG,gBAAgB,CA4PnH"}
@@ -1,13 +1,16 @@
1
1
  import "../boards/index.js";
2
- import { boardForWorkItem } from "../boards/semantics.js";
2
+ import { awaitsAcceptance, boardFlow, boardForWorkItem, isTerminalWorkItem, pullRequestSourceNumber, pullRequestSources } from "../boards/semantics.js";
3
3
  import { toBoardSource } from "../boards/project-boards.js";
4
4
  import { factorySessionUrl, factoryWorkItemUrl } from "../links.js";
5
+ import { parkedRunLabel } from "../routes/attention-parked.js";
5
6
  import { decisionRetryable, overtakenDecisionIds } from "../rules/decision-applicability.js";
6
7
  import { factoryDispatchFailureMetadata } from "../rules/dispatch-errors.js";
7
8
  import { needsApproval } from "../rules/types.js";
9
+ import { resolveWorkItemRepository } from "../session/work-item-repository.js";
10
+ import "../work-items/create-work-item.js";
8
11
  import { sessionActivity } from "./deliver.js";
9
- import { z } from "zod";
10
12
  import { createTool } from "@mastra/core/tools";
13
+ import { z } from "zod";
11
14
  // src/tools/read-tools.ts
12
15
  const MAX_TEXT = 600;
13
16
  const MAX_ERROR = 400;
@@ -21,9 +24,9 @@ function iso(value) {
21
24
  const date = value instanceof Date ? value : new Date(value);
22
25
  return Number.isFinite(date.getTime()) ? date.toISOString() : null;
23
26
  }
24
- /** The number a person sees on the card: the issue or PR number the item was filed from. */
27
+ /** The number a person sees on the card: the issue or PR number the item was filed from, or the project's own number for a card filed by hand. */
25
28
  function workItemNumber(item) {
26
- const number = item.workItem.metadata?.number ?? item.workItem.metadata?.githubIssueNumber ?? item.workItem.metadata?.githubPullRequestNumber;
29
+ const number = item.workItem.metadata?.number ?? item.workItem.metadata?.githubIssueNumber ?? item.workItem.metadata?.githubPullRequestNumber ?? item.metadata?.["cardNumber"];
27
30
  return typeof number === "number" ? number : null;
28
31
  }
29
32
  function workItemStage(item) {
@@ -36,9 +39,20 @@ async function findWorkItem(workItems, scope, ref) {
36
39
  const trimmed = ref.trim();
37
40
  const number = /^#?(\d+)$/.exec(trimmed)?.[1];
38
41
  if (number === void 0) return workItems.getForProject(scope.orgId, scope.factoryProjectId, trimmed);
39
- const matches = (await workItems.listShared(scope)).filter((item) => workItemNumber(item) === Number(number));
40
- const match = matches.find((item) => item.externalSource?.type !== "pull-request") ?? matches[0];
41
- return match ? structuredClone(match) : null;
42
+ const items = await workItems.listShared(scope);
43
+ const matches = items.filter((item) => workItemNumber(item) === Number(number));
44
+ const workCards = matches.filter((item) => item.externalSource?.type !== "pull-request");
45
+ refuseAmbiguous(number, workCards);
46
+ const match = workCards[0] ?? matches[0];
47
+ if (match) return structuredClone(match);
48
+ const carriers = items.filter((item) => pullRequestSources(item).some((source) => pullRequestSourceNumber(source) === Number(number)));
49
+ refuseAmbiguous(number, carriers);
50
+ return carriers[0] ? structuredClone(carriers[0]) : null;
51
+ }
52
+ function refuseAmbiguous(number, items) {
53
+ if (items.length <= 1) return;
54
+ const candidates = items.map((item) => `${item.id} (${item.title})`).join(", ");
55
+ throw new Error(`#${number} matches more than one work item; use its id instead: ${candidates}.`);
42
56
  }
43
57
  function workItemNotFound(ref) {
44
58
  return /* @__PURE__ */ new Error(`No work item ${ref} was found in this Factory.`);
@@ -89,20 +103,20 @@ function summarizeDecision(decision, overtaken = false) {
89
103
  updatedAt: iso(decision.updatedAt)
90
104
  };
91
105
  }
92
- const PAST_TRIAGE = /* @__PURE__ */ new Set([
93
- "planning",
94
- "execute",
95
- "review"
96
- ]);
97
106
  /**
98
- * Held: a Work card triage left in Intake (or whose source asks for approval), until a person
99
- * moves it on. A card that has been past Triage since (parked by self-review, or dragged back)
100
- * resumes instead, matching the board's held state.
107
+ * Held: a card triage left resting (or whose source asks for approval), until a person moves it
108
+ * on. A card that has been past triage since (parked by self-review, or dragged back) resumes
109
+ * instead, matching the board's held state.
101
110
  */
102
- function isHeld(item) {
103
- if (boardForWorkItem(item) !== "work" || item.stages[0] !== "intake") return false;
104
- if (needsApproval(item)) return true;
105
- return item.sessions.triage !== void 0 && !item.stageHistory.some((entry) => PAST_TRIAGE.has(entry.stage));
111
+ function isHeld(boards, item) {
112
+ const board = boards.get(boardForWorkItem(item));
113
+ const stage = item.stages.length === 1 ? item.stages[0] : void 0;
114
+ if (!board || !stage || board.phaseKind(stage) !== "resting") return false;
115
+ if (needsApproval(item, (phase) => awaitsAcceptance(board, phase))) return true;
116
+ const triage = boardFlow(board).triage;
117
+ const triageRole = triage ? board.roleForPhase(triage) : void 0;
118
+ if (!triageRole || item.sessions[triageRole] === void 0) return false;
119
+ return !item.stageHistory.some((entry) => entry.stage !== triage && board.isWorking(entry.stage));
106
120
  }
107
121
  const listInputSchema = z.object({
108
122
  query: z.string().trim().min(1).max(200).optional().describe("Case-insensitive text in the title, or an exact card number like \"#123\"."),
@@ -119,6 +133,37 @@ function createFactoryReadTools(scope, deps) {
119
133
  orgId: scope.orgId,
120
134
  factoryProjectId: scope.factoryProjectId
121
135
  };
136
+ /**
137
+ * Of `cards` filed by hand, those that name no repository while the Factory
138
+ * links several, so a run on them refuses to start until someone picks one.
139
+ */
140
+ const cardsWithoutRepository = async (cards) => {
141
+ const unnamed = cards.filter((card) => typeof card.metadata?.repository !== "string");
142
+ if (unnamed.length === 0 || !deps.sessions) return {
143
+ items: [],
144
+ candidates: []
145
+ };
146
+ const sourceControl = await deps.sessions.getSourceControlBySessionId(scope.sessionId);
147
+ if (!sourceControl) return {
148
+ items: [],
149
+ candidates: []
150
+ };
151
+ const resolution = await resolveWorkItemRepository({
152
+ sourceControl,
153
+ ...project,
154
+ item: {
155
+ metadata: null,
156
+ workItem: { metadata: null }
157
+ }
158
+ });
159
+ return resolution.status === "ambiguous" ? {
160
+ items: unnamed,
161
+ candidates: resolution.candidates
162
+ } : {
163
+ items: [],
164
+ candidates: []
165
+ };
166
+ };
122
167
  return {
123
168
  factory_list_work_items: createTool({
124
169
  id: "factory_list_work_items",
@@ -166,23 +211,18 @@ function createFactoryReadTools(scope, deps) {
166
211
  }),
167
212
  factory_inspect_work_item: createTool({
168
213
  id: "factory_inspect_work_item",
169
- description: "Everything the Factory knows about one work item: stage history, sessions by role (with whether each is mid-run and when its thread last moved), decisions with errors, recent audit events, recent feed comments, labels, linked items and the sessions following it. Use it to explain why an item is where it is.",
214
+ description: "Everything the Factory knows about one work item: its description, stage history, sessions by role (with whether each is mid-run and when its thread last moved), decisions with errors, recent audit events, labels, linked items and the sessions following it. Use it to explain why an item is where it is.",
170
215
  inputSchema: z.object({ workItem: workItemRefSchema }).strict(),
171
216
  execute: async ({ workItem }) => {
172
217
  const item = await findWorkItem(deps.workItems, scope, workItem);
173
218
  if (!item) throw workItemNotFound(workItem);
174
- const [bindings, decisions, audit, feed, all, subscribers] = await Promise.all([
219
+ const [bindings, decisions, audit, all, subscribers] = await Promise.all([
175
220
  deps.workItems.listRunBindings(scope.orgId, scope.factoryProjectId, item.id),
176
221
  deps.workItems.listDeferredDecisions(scope.orgId, scope.factoryProjectId, { workItemId: item.id }),
177
222
  deps.audit.list({
178
223
  ...project,
179
224
  limit: 200
180
225
  }),
181
- deps.comments.listRecent({
182
- ...project,
183
- workItemId: item.id,
184
- limit: 10
185
- }),
186
226
  deps.workItems.listShared(project),
187
227
  deps.workItems.listWorkItemSubscribers({
188
228
  orgId: scope.orgId,
@@ -215,6 +255,7 @@ function createFactoryReadTools(scope, deps) {
215
255
  return {
216
256
  item: {
217
257
  ...summarizeItem(item, bindings),
258
+ description: item.description,
218
259
  source: item.externalSource ? `${item.externalSource.integrationId}:${item.externalSource.type}` : "manual",
219
260
  sourceUrl: typeof item.workItem.url === "string" ? item.workItem.url : null,
220
261
  revision: item.revision
@@ -234,13 +275,6 @@ function createFactoryReadTools(scope, deps) {
234
275
  actorType: event.actorType,
235
276
  occurredAt: iso(event.occurredAt)
236
277
  })),
237
- feed: feed.map((comment) => ({
238
- id: comment.id,
239
- kind: comment.kind,
240
- author: comment.author,
241
- occurredAt: iso(comment.occurredAt),
242
- body: truncate(comment.body, 600)
243
- })),
244
278
  parent: parent ? summarizeItem(parent, bindings) : null,
245
279
  children: children.slice(0, 50).map((child) => summarizeItem(child, bindings)),
246
280
  subscribers: subscribers.slice(0, 50).map((subscription) => ({
@@ -253,7 +287,7 @@ function createFactoryReadTools(scope, deps) {
253
287
  }),
254
288
  factory_list_attention: createTool({
255
289
  id: "factory_list_attention",
256
- description: "What in this Factory needs a person: failed decisions grouped by failure code and error (one incident per group), proposals waiting for approval, and Work cards triage left in Intake for a person to move on.",
290
+ description: "What in this Factory needs a person: failed decisions grouped by failure code and error (one incident per group), proposals waiting for approval, runs parked on a tool prompt (a plan to review, a question to answer) while still in flight, Work cards triage left in Intake for a person to move on, and open cards filed by hand that need a repository set (factory_update_work_item) before a run can start.",
257
291
  inputSchema: z.object({ limit: z.number().int().min(1).max(50).optional() }).strict(),
258
292
  execute: async ({ limit = DEFAULT_LIST }) => {
259
293
  const [decisions, items] = await Promise.all([deps.workItems.listDeferredDecisions(scope.orgId, scope.factoryProjectId, { statuses: ["failed", "proposed"] }), deps.workItems.listShared(project)]);
@@ -285,9 +319,13 @@ function createFactoryReadTools(scope, deps) {
285
319
  ...group,
286
320
  shown: group.decisions.slice(0, limit)
287
321
  }));
288
- const overtaken = await overtakenDecisionIds(deps.workItems, await toBoardSource(deps.boards).load(project), project, incidents.flatMap((group) => group.shown));
322
+ const boards = await toBoardSource(deps.boards).load(project);
323
+ const overtaken = await overtakenDecisionIds(deps.workItems, boards, project, incidents.flatMap((group) => group.shown));
289
324
  const proposals = decisions.filter((decision) => decision.status === "proposed");
290
- const held = items.filter(isHeld);
325
+ const held = items.filter((item) => isHeld(boards, item));
326
+ const unplaced = await cardsWithoutRepository(items.filter((item) => !item.externalSource && !isTerminalWorkItem(boards, item)));
327
+ const needsRepository = unplaced.items;
328
+ const waiting = (deps.liveSessions?.()?.parkedIn(scope.factoryProjectId) ?? []).sort((a, b) => a.run.suspendedAt - b.run.suspendedAt);
291
329
  return {
292
330
  incidents: incidents.map((group) => ({
293
331
  failureCode: group.failureCode,
@@ -305,11 +343,22 @@ function createFactoryReadTools(scope, deps) {
305
343
  ...summarizeDecision(decision),
306
344
  ...ref(decision.workItemId)
307
345
  })),
346
+ waiting: waiting.slice(0, limit).map(({ sessionId, run }) => ({
347
+ sessionId,
348
+ toolName: run.toolName,
349
+ label: parkedRunLabel(run.toolName),
350
+ waitingSince: new Date(run.suspendedAt).toISOString()
351
+ })),
308
352
  held: held.slice(0, limit).map((item) => ({
309
353
  ...ref(item.id),
310
354
  stage: workItemStage(item)
311
355
  })),
312
- truncated: allIncidents.length > limit || incidents.some((group) => group.shown.length < group.decisions.length) || proposals.length > limit || held.length > limit
356
+ needsRepository: needsRepository.slice(0, limit).map((item) => ({
357
+ ...ref(item.id),
358
+ stage: workItemStage(item)
359
+ })),
360
+ ...needsRepository.length > 0 ? { linkedRepositories: unplaced.candidates } : {},
361
+ truncated: allIncidents.length > limit || incidents.some((group) => group.shown.length < group.decisions.length) || proposals.length > limit || waiting.length > limit || held.length > limit || needsRepository.length > limit
313
362
  };
314
363
  }
315
364
  })