@mastra/factory 0.28.0 → 0.29.0-alpha.0

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 (224) hide show
  1. package/README.md +6 -4
  2. package/dist/boards/reroute.d.ts +31 -0
  3. package/dist/boards/reroute.d.ts.map +1 -0
  4. package/dist/boards/reroute.js +71 -0
  5. package/dist/boards/reroute.js.map +1 -0
  6. package/dist/environment/repository-access.d.ts +2 -0
  7. package/dist/environment/repository-access.d.ts.map +1 -1
  8. package/dist/environment/repository-access.js +9 -4
  9. package/dist/environment/repository-access.js.map +1 -1
  10. package/dist/factory.d.ts.map +1 -1
  11. package/dist/factory.js +9 -6
  12. package/dist/factory.js.map +1 -1
  13. package/dist/integrations/base.d.ts +8 -0
  14. package/dist/integrations/base.d.ts.map +1 -1
  15. package/dist/integrations/dependabot/default-rules.d.ts +38 -0
  16. package/dist/integrations/dependabot/default-rules.d.ts.map +1 -0
  17. package/dist/integrations/dependabot/default-rules.js +63 -0
  18. package/dist/integrations/dependabot/default-rules.js.map +1 -0
  19. package/dist/integrations/dependabot/rules.d.ts +42 -0
  20. package/dist/integrations/dependabot/rules.d.ts.map +1 -0
  21. package/dist/integrations/dependabot/rules.js +187 -0
  22. package/dist/integrations/dependabot/rules.js.map +1 -0
  23. package/dist/integrations/dependabot/sync.d.ts +76 -0
  24. package/dist/integrations/dependabot/sync.d.ts.map +1 -0
  25. package/dist/integrations/dependabot/sync.js +111 -0
  26. package/dist/integrations/dependabot/sync.js.map +1 -0
  27. package/dist/integrations/github/routes.d.ts.map +1 -1
  28. package/dist/integrations/github/routes.js +7 -2
  29. package/dist/integrations/github/routes.js.map +1 -1
  30. package/dist/integrations/github/sandbox.d.ts +12 -0
  31. package/dist/integrations/github/sandbox.d.ts.map +1 -1
  32. package/dist/integrations/github/sandbox.js +22 -1
  33. package/dist/integrations/github/sandbox.js.map +1 -1
  34. package/dist/integrations/platform/connect/routes.d.ts.map +1 -1
  35. package/dist/integrations/platform/connect/routes.js +4 -0
  36. package/dist/integrations/platform/connect/routes.js.map +1 -1
  37. package/dist/integrations/platform/github/event-worker.d.ts +5 -0
  38. package/dist/integrations/platform/github/event-worker.d.ts.map +1 -1
  39. package/dist/integrations/platform/github/event-worker.js +33 -2
  40. package/dist/integrations/platform/github/event-worker.js.map +1 -1
  41. package/dist/integrations/platform/github/integration.d.ts +19 -1
  42. package/dist/integrations/platform/github/integration.d.ts.map +1 -1
  43. package/dist/integrations/platform/github/integration.js +46 -0
  44. package/dist/integrations/platform/github/integration.js.map +1 -1
  45. package/dist/integrations/platform/vanta/integration.d.ts +33 -0
  46. package/dist/integrations/platform/vanta/integration.d.ts.map +1 -0
  47. package/dist/integrations/platform/vanta/integration.js +133 -0
  48. package/dist/integrations/platform/vanta/integration.js.map +1 -0
  49. package/dist/integrations/vanta/default-rules.d.ts +34 -0
  50. package/dist/integrations/vanta/default-rules.d.ts.map +1 -0
  51. package/dist/integrations/vanta/default-rules.js +61 -0
  52. package/dist/integrations/vanta/default-rules.js.map +1 -0
  53. package/dist/integrations/vanta/rules.d.ts +40 -0
  54. package/dist/integrations/vanta/rules.d.ts.map +1 -0
  55. package/dist/integrations/vanta/rules.js +208 -0
  56. package/dist/integrations/vanta/rules.js.map +1 -0
  57. package/dist/integrations/vanta/sync.d.ts +36 -0
  58. package/dist/integrations/vanta/sync.d.ts.map +1 -0
  59. package/dist/integrations/vanta/sync.js +73 -0
  60. package/dist/integrations/vanta/sync.js.map +1 -0
  61. package/dist/mcp/routes.d.ts.map +1 -1
  62. package/dist/mcp/routes.js +1 -1
  63. package/dist/mcp/routes.js.map +1 -1
  64. package/dist/routes/board-snapshot.d.ts +8 -1
  65. package/dist/routes/board-snapshot.d.ts.map +1 -1
  66. package/dist/routes/board-snapshot.js +23 -2
  67. package/dist/routes/board-snapshot.js.map +1 -1
  68. package/dist/routes/contracts.d.ts +205 -0
  69. package/dist/routes/contracts.d.ts.map +1 -1
  70. package/dist/routes/contracts.js +159 -5
  71. package/dist/routes/contracts.js.map +1 -1
  72. package/dist/routes/intake-routes.d.ts +3 -0
  73. package/dist/routes/intake-routes.d.ts.map +1 -1
  74. package/dist/routes/intake-routes.js +44 -0
  75. package/dist/routes/intake-routes.js.map +1 -1
  76. package/dist/routes/knowledge.d.ts.map +1 -1
  77. package/dist/routes/knowledge.js +3 -2
  78. package/dist/routes/knowledge.js.map +1 -1
  79. package/dist/routes/source-control-sessions.d.ts +1 -1
  80. package/dist/routes/source-control-sessions.d.ts.map +1 -1
  81. package/dist/routes/source-control-sessions.js +109 -3
  82. package/dist/routes/source-control-sessions.js.map +1 -1
  83. package/dist/routes/surface.d.ts +6 -1
  84. package/dist/routes/surface.d.ts.map +1 -1
  85. package/dist/routes/surface.js +72 -9
  86. package/dist/routes/surface.js.map +1 -1
  87. package/dist/routes/work-item-selection.d.ts +0 -4
  88. package/dist/routes/work-item-selection.d.ts.map +1 -1
  89. package/dist/routes/work-item-selection.js +4 -21
  90. package/dist/routes/work-item-selection.js.map +1 -1
  91. package/dist/routes/work-item-starters.d.ts.map +1 -1
  92. package/dist/routes/work-item-starters.js +4 -21
  93. package/dist/routes/work-item-starters.js.map +1 -1
  94. package/dist/routes/work-items.d.ts.map +1 -1
  95. package/dist/routes/work-items.js +112 -36
  96. package/dist/routes/work-items.js.map +1 -1
  97. package/dist/rules/dispatch-errors.d.ts +3 -0
  98. package/dist/rules/dispatch-errors.d.ts.map +1 -1
  99. package/dist/rules/dispatch-errors.js +5 -0
  100. package/dist/rules/dispatch-errors.js.map +1 -1
  101. package/dist/rules/dispatcher.d.ts +2 -0
  102. package/dist/rules/dispatcher.d.ts.map +1 -1
  103. package/dist/rules/dispatcher.js +39 -18
  104. package/dist/rules/dispatcher.js.map +1 -1
  105. package/dist/rules/index.d.ts +2 -2
  106. package/dist/rules/index.d.ts.map +1 -1
  107. package/dist/rules/index.js +2 -2
  108. package/dist/rules/start-coordinator.d.ts +6 -1
  109. package/dist/rules/start-coordinator.d.ts.map +1 -1
  110. package/dist/rules/start-coordinator.js +6 -2
  111. package/dist/rules/start-coordinator.js.map +1 -1
  112. package/dist/rules/transition-service.d.ts.map +1 -1
  113. package/dist/rules/transition-service.js +3 -2
  114. package/dist/rules/transition-service.js.map +1 -1
  115. package/dist/rules/types.d.ts +71 -3
  116. package/dist/rules/types.d.ts.map +1 -1
  117. package/dist/rules/types.js +10 -2
  118. package/dist/rules/types.js.map +1 -1
  119. package/dist/rules/validation.d.ts.map +1 -1
  120. package/dist/rules/validation.js +5 -0
  121. package/dist/rules/validation.js.map +1 -1
  122. package/dist/session/factory-session.d.ts +20 -5
  123. package/dist/session/factory-session.d.ts.map +1 -1
  124. package/dist/session/factory-session.js +20 -6
  125. package/dist/session/factory-session.js.map +1 -1
  126. package/dist/storage/domains/audit/actions.d.ts +1 -1
  127. package/dist/storage/domains/audit/actions.d.ts.map +1 -1
  128. package/dist/storage/domains/audit/actions.js +2 -1
  129. package/dist/storage/domains/audit/actions.js.map +1 -1
  130. package/dist/storage/domains/audit/actors.d.ts.map +1 -1
  131. package/dist/storage/domains/audit/actors.js +1 -1
  132. package/dist/storage/domains/audit/actors.js.map +1 -1
  133. package/dist/storage/domains/intake/base.d.ts +1 -1
  134. package/dist/storage/domains/intake/base.js +2 -2
  135. package/dist/storage/domains/intake/base.js.map +1 -1
  136. package/dist/storage/domains/projects/base.d.ts +8 -0
  137. package/dist/storage/domains/projects/base.d.ts.map +1 -1
  138. package/dist/storage/domains/projects/base.js +11 -1
  139. package/dist/storage/domains/projects/base.js.map +1 -1
  140. package/dist/storage/domains/work-items/base.d.ts +15 -4
  141. package/dist/storage/domains/work-items/base.d.ts.map +1 -1
  142. package/dist/storage/domains/work-items/base.js +19 -1
  143. package/dist/storage/domains/work-items/base.js.map +1 -1
  144. package/dist/tools/approval-tools.d.ts +20 -0
  145. package/dist/tools/approval-tools.d.ts.map +1 -1
  146. package/dist/tools/approval-tools.js +79 -30
  147. package/dist/tools/approval-tools.js.map +1 -1
  148. package/dist/tools/audit-events-tool.d.ts +1 -1
  149. package/dist/tools/messaging-tools.d.ts.map +1 -1
  150. package/dist/tools/messaging-tools.js +1 -1
  151. package/dist/tools/messaging-tools.js.map +1 -1
  152. package/dist/tools/read-tools.d.ts +0 -2
  153. package/dist/tools/read-tools.d.ts.map +1 -1
  154. package/dist/tools/read-tools.js +2 -7
  155. package/dist/tools/read-tools.js.map +1 -1
  156. package/dist/tools/reports.d.ts +3 -0
  157. package/dist/tools/reports.d.ts.map +1 -1
  158. package/dist/tools/reports.js +3 -3
  159. package/dist/tools/reports.js.map +1 -1
  160. package/dist/tools/run-watch.d.ts +14 -2
  161. package/dist/tools/run-watch.d.ts.map +1 -1
  162. package/dist/tools/run-watch.js +24 -4
  163. package/dist/tools/run-watch.js.map +1 -1
  164. package/dist/tools/session-tools.d.ts.map +1 -1
  165. package/dist/tools/session-tools.js +17 -6
  166. package/dist/tools/session-tools.js.map +1 -1
  167. package/dist/tools/side-sessions.d.ts.map +1 -1
  168. package/dist/tools/side-sessions.js +1 -1
  169. package/dist/tools/side-sessions.js.map +1 -1
  170. package/dist/tools/work-item-tools.d.ts.map +1 -1
  171. package/dist/tools/work-item-tools.js +12 -2
  172. package/dist/tools/work-item-tools.js.map +1 -1
  173. package/dist/work-item-branch.d.ts +1 -1
  174. package/dist/work-item-branch.d.ts.map +1 -1
  175. package/dist/work-item-branch.js +2 -0
  176. package/dist/work-item-branch.js.map +1 -1
  177. package/dist/work-items/board-filter-options.d.ts +5 -0
  178. package/dist/work-items/board-filter-options.d.ts.map +1 -0
  179. package/dist/work-items/board-filter-options.js +27 -0
  180. package/dist/work-items/board-filter-options.js.map +1 -0
  181. package/dist/work-items/board-phases.d.ts +28 -0
  182. package/dist/work-items/board-phases.d.ts.map +1 -0
  183. package/dist/work-items/board-phases.js +165 -0
  184. package/dist/work-items/board-phases.js.map +1 -0
  185. package/dist/work-items/card-facts.d.ts +24 -0
  186. package/dist/work-items/card-facts.d.ts.map +1 -0
  187. package/dist/work-items/card-facts.js +75 -0
  188. package/dist/work-items/card-facts.js.map +1 -0
  189. package/dist/work-items/card-labels.d.ts +5 -0
  190. package/dist/work-items/card-labels.d.ts.map +1 -0
  191. package/dist/work-items/card-labels.js +13 -0
  192. package/dist/work-items/card-labels.js.map +1 -0
  193. package/dist/work-items/card-number.d.ts +10 -0
  194. package/dist/work-items/card-number.d.ts.map +1 -0
  195. package/dist/work-items/card-number.js +15 -0
  196. package/dist/work-items/card-number.js.map +1 -0
  197. package/dist/work-items/card-people.d.ts +25 -0
  198. package/dist/work-items/card-people.d.ts.map +1 -0
  199. package/dist/work-items/card-people.js +100 -0
  200. package/dist/work-items/card-people.js.map +1 -0
  201. package/dist/work-items/card-search-text.d.ts +4 -0
  202. package/dist/work-items/card-search-text.d.ts.map +1 -0
  203. package/dist/work-items/card-search-text.js +15 -0
  204. package/dist/work-items/card-search-text.js.map +1 -0
  205. package/dist/work-items/card-source-filters.d.ts +23 -0
  206. package/dist/work-items/card-source-filters.d.ts.map +1 -0
  207. package/dist/work-items/card-source-filters.js +25 -0
  208. package/dist/work-items/card-source-filters.js.map +1 -0
  209. package/dist/work-items/create-work-item.d.ts +0 -6
  210. package/dist/work-items/create-work-item.d.ts.map +1 -1
  211. package/dist/work-items/create-work-item.js +2 -7
  212. package/dist/work-items/create-work-item.js.map +1 -1
  213. package/dist/work-items/list-related-cards.d.ts +4 -0
  214. package/dist/work-items/list-related-cards.d.ts.map +1 -0
  215. package/dist/work-items/list-related-cards.js +24 -0
  216. package/dist/work-items/list-related-cards.js.map +1 -0
  217. package/dist/work-items/search-words.d.ts +5 -0
  218. package/dist/work-items/search-words.d.ts.map +1 -0
  219. package/dist/work-items/search-words.js +12 -0
  220. package/dist/work-items/search-words.js.map +1 -0
  221. package/dist/workspace.d.ts.map +1 -1
  222. package/dist/workspace.js +92 -47
  223. package/dist/workspace.js.map +1 -1
  224. package/package.json +6 -5
@@ -88,7 +88,8 @@ function reviewSeatSkill(decision) {
88
88
  return value.type === "invokeSkill" && value.role === "review" ? value : void 0;
89
89
  }
90
90
  function isTerminalFailure(attempts, failureCode) {
91
- return attempts >= (failureCode === "run_incomplete" ? 2 : MAX_ATTEMPTS) || !factoryDispatchFailureMetadata(failureCode).canRetry;
91
+ const failure = factoryDispatchFailureMetadata(failureCode);
92
+ return attempts >= (failureCode === "run_incomplete" ? 2 : MAX_ATTEMPTS) || !failure.canRetry || failure.autoRetry === false;
92
93
  }
93
94
  /**
94
95
  * Conservative check for observational-memory failures that a retry cannot fix:
@@ -101,12 +102,14 @@ function isPermanentProviderRejection(error) {
101
102
  const normalized = error.toLowerCase();
102
103
  return /\bhttp(?:\/\d(?:\.\d)?)?\s*400\b/.test(normalized) || /\bstatus(?:\s*code)?\s*[:=]?\s*400\b/.test(normalized) || /\b400\s*(?:bad request|status)\b/.test(normalized) || normalized.includes("model not supported") || normalized.includes("model is not supported") || normalized.includes("unsupported model") || normalized.includes("not supported with") || normalized.includes("unauthorized") || normalized.includes("authentication") || normalized.includes("invalid") && normalized.includes("model");
103
104
  }
104
- function watchRun(session, { timeoutMs, approvePlans, requestContext, onAgentEnd, label, runStillActive }) {
105
+ function watchRun(session, { timeoutMs, autoApprovedTool, autoApproving, requestContext, onAgentEnd, label, runStillActive }) {
105
106
  let resolveAgentEnd;
106
107
  let agentEnd;
107
108
  let endReason;
108
109
  let supersededAtEnd;
109
110
  let parked;
111
+ let approvals = 0;
112
+ const announced = /* @__PURE__ */ new Set();
110
113
  let omFailure;
111
114
  let runError;
112
115
  const arm = () => {
@@ -139,6 +142,10 @@ function watchRun(session, { timeoutMs, approvePlans, requestContext, onAgentEnd
139
142
  toolName: event.toolName,
140
143
  toolCallId: event.toolCallId
141
144
  };
145
+ if (event.toolName === autoApprovedTool && approvals < MAX_PLAN_APPROVALS) {
146
+ announced.add(event.toolCallId);
147
+ autoApproving?.add(event.toolCallId);
148
+ }
142
149
  return;
143
150
  }
144
151
  if (event.type === "tool_suspension_cancelled" && parked?.toolCallId === event.toolCallId) parked = void 0;
@@ -159,19 +166,27 @@ function watchRun(session, { timeoutMs, approvePlans, requestContext, onAgentEnd
159
166
  endReason: () => endReason,
160
167
  /** The tool the run is parked on, when it ended suspended. */
161
168
  parked: () => parked,
162
- close: unsubscribe,
169
+ close: () => {
170
+ for (const toolCallId of announced) autoApproving?.delete(toolCallId);
171
+ unsubscribe();
172
+ },
163
173
  /** The run's own verdict, thrown as what the dispatcher should record. */
164
174
  async settle() {
165
175
  let observed = await wait();
166
- if (approvePlans) for (let approvals = 0; parked?.toolName === "submit_plan" && approvals < MAX_PLAN_APPROVALS; approvals += 1) {
176
+ while (autoApprovedTool && parked?.toolName === autoApprovedTool && approvals < MAX_PLAN_APPROVALS) {
167
177
  const { toolCallId } = parked;
168
178
  parked = void 0;
179
+ approvals += 1;
169
180
  arm();
170
- await session.respondToToolSuspension({
171
- resumeData: { action: "approved" },
172
- toolCallId,
173
- requestContext
174
- });
181
+ try {
182
+ await session.respondToToolSuspension({
183
+ resumeData: { action: "approved" },
184
+ toolCallId,
185
+ requestContext
186
+ });
187
+ } finally {
188
+ autoApproving?.delete(toolCallId);
189
+ }
175
190
  observed = await wait();
176
191
  }
177
192
  if (!observed) throw new FactoryDispatchError("run_terminal_event_missing", `${label} terminal event was not observed before timeout.`);
@@ -321,6 +336,7 @@ var FactoryDecisionDispatcher = class {
321
336
  #intakeRoutes;
322
337
  #storage;
323
338
  #ownerId;
339
+ #autoApproving = /* @__PURE__ */ new Set();
324
340
  #reconcileToolResults;
325
341
  #reconcileRunBinding;
326
342
  #prepareBinding;
@@ -663,7 +679,6 @@ var FactoryDecisionDispatcher = class {
663
679
  if (runStillActive()) {
664
680
  const run = watchRun(session, {
665
681
  timeoutMs: this.#skillCompletionObservationTimeoutMs,
666
- approvePlans: false,
667
682
  label: "Factory skill run",
668
683
  runStillActive
669
684
  });
@@ -1014,7 +1029,8 @@ var FactoryDecisionDispatcher = class {
1014
1029
  })).map((card) => card.id));
1015
1030
  const run = watchRun(session, {
1016
1031
  timeoutMs: this.#skillCompletionObservationTimeoutMs,
1017
- approvePlans: await this.#plansAreAutoApproved(record),
1032
+ autoApprovedTool: await this.#autoApprovedExitTool(record),
1033
+ autoApproving: this.#autoApproving,
1018
1034
  requestContext,
1019
1035
  onAgentEnd: () => this.#roleSuperseded(record, decision.role),
1020
1036
  label: "Factory skill run",
@@ -1259,6 +1275,7 @@ var FactoryDecisionDispatcher = class {
1259
1275
  externalSource: externalSourceForDecision(decision),
1260
1276
  parentWorkItemId,
1261
1277
  title: decision.title,
1278
+ ...decision.description ? { description: decision.description } : {},
1262
1279
  board: decision.board,
1263
1280
  stages: [entryStage],
1264
1281
  sessions: {},
@@ -1860,18 +1877,22 @@ var FactoryDecisionDispatcher = class {
1860
1877
  return session;
1861
1878
  }
1862
1879
  /**
1863
- * Whether the run answers its plan approvals itself: the card's phase ends with an auto-approved
1864
- * `submit_plan`. Otherwise a plan waits for a person.
1880
+ * The tool whose pauses the run answers itself: the exit tool of the card's phase, where the
1881
+ * board approves it without a person for this card. Any other pause waits for a person.
1865
1882
  */
1866
- async #plansAreAutoApproved({ orgId, factoryProjectId, workItemId }) {
1883
+ async #autoApprovedExitTool({ orgId, factoryProjectId, workItemId }) {
1867
1884
  const item = workItemId ? await this.#storage.get({
1868
1885
  orgId,
1869
1886
  id: workItemId
1870
1887
  }) : null;
1871
- return item !== null && autoApprovedExitTool(await this.#boards.load({
1888
+ return item ? autoApprovedExitTool(await this.#boards.load({
1872
1889
  orgId,
1873
1890
  factoryProjectId
1874
- }), item) === "submit_plan";
1891
+ }), item) : void 0;
1892
+ }
1893
+ /** Whether a run this dispatcher watches is about to approve `toolCallId` itself, so no person needs asking. */
1894
+ autoApproves(toolCallId) {
1895
+ return this.#autoApproving.has(toolCallId);
1875
1896
  }
1876
1897
  /**
1877
1898
  * Whether a run is in flight on `binding`: live here, or live on another dispatcher. An open-run
@@ -1889,7 +1910,6 @@ var FactoryDecisionDispatcher = class {
1889
1910
  while (true) {
1890
1911
  const openRun = watchRun(session, {
1891
1912
  timeoutMs: this.#skillCompletionObservationTimeoutMs,
1892
- approvePlans: false,
1893
1913
  label,
1894
1914
  runStillActive
1895
1915
  });
@@ -2056,10 +2076,11 @@ var FactoryDecisionDispatcher = class {
2056
2076
  const since = /* @__PURE__ */ new Date();
2057
2077
  const run = watchRun(session, {
2058
2078
  timeoutMs: this.#skillCompletionObservationTimeoutMs,
2059
- approvePlans: await this.#plansAreAutoApproved({
2079
+ autoApprovedTool: await this.#autoApprovedExitTool({
2060
2080
  ...record,
2061
2081
  workItemId: binding.workItemId
2062
2082
  }),
2083
+ autoApproving: this.#autoApproving,
2063
2084
  requestContext,
2064
2085
  label: "Factory kickoff run",
2065
2086
  runStillActive: () => this.#controller.listActiveThreadRuns().some((active) => active.threadId === binding.threadId)