@mastra/factory 0.29.0-alpha.7 → 0.29.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 (147) hide show
  1. package/README.md +50 -20
  2. package/dist/boards/board-events.d.ts +23 -0
  3. package/dist/boards/board-events.d.ts.map +1 -1
  4. package/dist/boards/board-events.js +37 -3
  5. package/dist/boards/board-events.js.map +1 -1
  6. package/dist/boards/board-writes.d.ts +6 -4
  7. package/dist/boards/board-writes.d.ts.map +1 -1
  8. package/dist/boards/board-writes.js +9 -6
  9. package/dist/boards/board-writes.js.map +1 -1
  10. package/dist/boards/intake-routing.d.ts +30 -16
  11. package/dist/boards/intake-routing.d.ts.map +1 -1
  12. package/dist/boards/intake-routing.js +41 -28
  13. package/dist/boards/intake-routing.js.map +1 -1
  14. package/dist/boards/project-boards.d.ts +15 -0
  15. package/dist/boards/project-boards.d.ts.map +1 -1
  16. package/dist/boards/project-boards.js +43 -7
  17. package/dist/boards/project-boards.js.map +1 -1
  18. package/dist/factory.d.ts +4 -14
  19. package/dist/factory.d.ts.map +1 -1
  20. package/dist/factory.js +22 -15
  21. package/dist/factory.js.map +1 -1
  22. package/dist/integrations/github/integration.d.ts.map +1 -1
  23. package/dist/integrations/github/integration.js +101 -0
  24. package/dist/integrations/github/integration.js.map +1 -1
  25. package/dist/integrations/github/rules.d.ts.map +1 -1
  26. package/dist/integrations/github/rules.js +7 -3
  27. package/dist/integrations/github/rules.js.map +1 -1
  28. package/dist/integrations/github/sandbox.d.ts +7 -1
  29. package/dist/integrations/github/sandbox.d.ts.map +1 -1
  30. package/dist/integrations/github/sandbox.js +15 -1
  31. package/dist/integrations/github/sandbox.js.map +1 -1
  32. package/dist/integrations/github/session-subscriptions.js +1 -1
  33. package/dist/integrations/github/session-subscriptions.js.map +1 -1
  34. package/dist/integrations/gitlab/rules.d.ts.map +1 -1
  35. package/dist/integrations/gitlab/rules.js +2 -1
  36. package/dist/integrations/gitlab/rules.js.map +1 -1
  37. package/dist/integrations/gitlab/session-subscriptions.js +1 -1
  38. package/dist/integrations/gitlab/session-subscriptions.js.map +1 -1
  39. package/dist/integrations/slack/channel-reply-processor.d.ts +1 -0
  40. package/dist/integrations/slack/channel-reply-processor.d.ts.map +1 -1
  41. package/dist/integrations/slack/channel-reply-processor.js +4 -1
  42. package/dist/integrations/slack/channel-reply-processor.js.map +1 -1
  43. package/dist/integrations/slack/run-error-card.js +6 -1
  44. package/dist/integrations/slack/run-error-card.js.map +1 -1
  45. package/dist/links.d.ts +4 -2
  46. package/dist/links.d.ts.map +1 -1
  47. package/dist/links.js +5 -3
  48. package/dist/links.js.map +1 -1
  49. package/dist/routes/boards.d.ts +1 -1
  50. package/dist/routes/boards.d.ts.map +1 -1
  51. package/dist/routes/boards.js.map +1 -1
  52. package/dist/routes/contracts.d.ts +32 -5
  53. package/dist/routes/contracts.d.ts.map +1 -1
  54. package/dist/routes/contracts.js +36 -9
  55. package/dist/routes/contracts.js.map +1 -1
  56. package/dist/routes/intake-check.d.ts.map +1 -1
  57. package/dist/routes/intake-check.js +3 -1
  58. package/dist/routes/intake-check.js.map +1 -1
  59. package/dist/routes/intake-routes.d.ts +0 -3
  60. package/dist/routes/intake-routes.d.ts.map +1 -1
  61. package/dist/routes/intake-routes.js +1 -1
  62. package/dist/routes/intake-routes.js.map +1 -1
  63. package/dist/routes/skills.d.ts +1 -1
  64. package/dist/routes/skills.d.ts.map +1 -1
  65. package/dist/routes/skills.js +92 -28
  66. package/dist/routes/skills.js.map +1 -1
  67. package/dist/routes/surface.d.ts +0 -3
  68. package/dist/routes/surface.d.ts.map +1 -1
  69. package/dist/routes/surface.js +0 -1
  70. package/dist/routes/surface.js.map +1 -1
  71. package/dist/rules/dispatch-errors.d.ts +6 -0
  72. package/dist/rules/dispatch-errors.d.ts.map +1 -1
  73. package/dist/rules/dispatch-errors.js +10 -1
  74. package/dist/rules/dispatch-errors.js.map +1 -1
  75. package/dist/rules/dispatcher.d.ts.map +1 -1
  76. package/dist/rules/dispatcher.js +74 -32
  77. package/dist/rules/dispatcher.js.map +1 -1
  78. package/dist/rules/event-rules.d.ts +3 -2
  79. package/dist/rules/event-rules.d.ts.map +1 -1
  80. package/dist/rules/event-rules.js +5 -3
  81. package/dist/rules/event-rules.js.map +1 -1
  82. package/dist/rules/public-failure-reason.d.ts +11 -0
  83. package/dist/rules/public-failure-reason.d.ts.map +1 -0
  84. package/dist/rules/public-failure-reason.js +136 -0
  85. package/dist/rules/public-failure-reason.js.map +1 -0
  86. package/dist/rules/transition-service.d.ts +13 -0
  87. package/dist/rules/transition-service.d.ts.map +1 -1
  88. package/dist/rules/transition-service.js +5 -1
  89. package/dist/rules/transition-service.js.map +1 -1
  90. package/dist/rules/types.d.ts +12 -0
  91. package/dist/rules/types.d.ts.map +1 -1
  92. package/dist/rules/types.js.map +1 -1
  93. package/dist/rules/validation.d.ts.map +1 -1
  94. package/dist/rules/validation.js +11 -2
  95. package/dist/rules/validation.js.map +1 -1
  96. package/dist/run-error.d.ts +1 -1
  97. package/dist/run-error.d.ts.map +1 -1
  98. package/dist/run-error.js +21 -12
  99. package/dist/run-error.js.map +1 -1
  100. package/dist/session/environment-state-processor.d.ts.map +1 -1
  101. package/dist/session/environment-state-processor.js +6 -2
  102. package/dist/session/environment-state-processor.js.map +1 -1
  103. package/dist/session/source-control-tools.d.ts.map +1 -1
  104. package/dist/session/source-control-tools.js +5 -3
  105. package/dist/session/source-control-tools.js.map +1 -1
  106. package/dist/skills/app-skills.d.ts +3 -2
  107. package/dist/skills/app-skills.d.ts.map +1 -1
  108. package/dist/skills/app-skills.js +5 -3
  109. package/dist/skills/app-skills.js.map +1 -1
  110. package/dist/skills/catalog.d.ts +23 -4
  111. package/dist/skills/catalog.d.ts.map +1 -1
  112. package/dist/skills/catalog.js +61 -28
  113. package/dist/skills/catalog.js.map +1 -1
  114. package/dist/storage/domains/audit/actions.d.ts +1 -1
  115. package/dist/storage/domains/audit/actions.d.ts.map +1 -1
  116. package/dist/storage/domains/audit/actions.js +6 -1
  117. package/dist/storage/domains/audit/actions.js.map +1 -1
  118. package/dist/storage/domains/boards/base.d.ts +12 -0
  119. package/dist/storage/domains/boards/base.d.ts.map +1 -1
  120. package/dist/storage/domains/boards/base.js +3 -0
  121. package/dist/storage/domains/boards/base.js.map +1 -1
  122. package/dist/storage/domains/boards/schemas.d.ts.map +1 -1
  123. package/dist/storage/domains/boards/schemas.js +4 -0
  124. package/dist/storage/domains/boards/schemas.js.map +1 -1
  125. package/dist/storage/domains/skill-overrides/base.d.ts +28 -4
  126. package/dist/storage/domains/skill-overrides/base.d.ts.map +1 -1
  127. package/dist/storage/domains/skill-overrides/base.js +54 -1
  128. package/dist/storage/domains/skill-overrides/base.js.map +1 -1
  129. package/dist/storage/domains/work-items/base.d.ts +2 -0
  130. package/dist/storage/domains/work-items/base.d.ts.map +1 -1
  131. package/dist/storage/domains/work-items/base.js +13 -5
  132. package/dist/storage/domains/work-items/base.js.map +1 -1
  133. package/dist/tools/audit-events-tool.d.ts +1 -1
  134. package/dist/tools/read-tools.d.ts.map +1 -1
  135. package/dist/tools/read-tools.js +0 -1
  136. package/dist/tools/read-tools.js.map +1 -1
  137. package/dist/tools/work-item-tools.d.ts.map +1 -1
  138. package/dist/tools/work-item-tools.js +0 -3
  139. package/dist/tools/work-item-tools.js.map +1 -1
  140. package/dist/work-items/create-work-item.d.ts.map +1 -1
  141. package/dist/work-items/create-work-item.js +2 -1
  142. package/dist/work-items/create-work-item.js.map +1 -1
  143. package/dist/workspace.d.ts +5 -1
  144. package/dist/workspace.d.ts.map +1 -1
  145. package/dist/workspace.js +69 -9
  146. package/dist/workspace.js.map +1 -1
  147. package/package.json +13 -13
@@ -117,7 +117,9 @@ const intakeRouteInputSchema = z.object({
117
117
  target: intakeRouteFields.target,
118
118
  on: intakeRouteFields.on.optional(),
119
119
  /** Restores a route read with `pullRequestOpenedMovesOnly` as it was: moving cards on `pull_request.opened`, filing none. */
120
- pullRequestOpenedMovesOnly: z.literal(true).optional()
120
+ pullRequestOpenedMovesOnly: z.literal(true).optional(),
121
+ /** Restores a route read with `outsiderPullRequestsGated` as it was: its card moves skipping outside authors' pull requests. */
122
+ outsiderPullRequestsGated: z.literal(true).optional()
121
123
  }).strict();
122
124
  /** Changes the named fields; send the `revision` you read so a concurrent edit is not overwritten. */
123
125
  const intakeRoutePatchSchema = z.object({
@@ -126,6 +128,12 @@ const intakeRoutePatchSchema = z.object({
126
128
  when: intakeRouteFields.when.optional(),
127
129
  target: intakeRouteFields.target.optional(),
128
130
  on: intakeRouteFields.on.optional(),
131
+ /**
132
+ * `false` lets outside authors' pull requests match an older rule's card moves, like every rule
133
+ * written since rules decided them. No other edit changes it, so an edit and its Undo can't
134
+ * quietly widen the rule.
135
+ */
136
+ outsiderPullRequestsGated: z.literal(false).optional(),
129
137
  expectedRevision: boardRevisionSchema
130
138
  }).strict().refine(({ expectedRevision: _revision, ...fields }) => Object.values(fields).some((value) => value !== void 0), { message: "Change at least one field." });
131
139
  /** Bounds a whole-project reorder, which names every rule of every board. */
@@ -158,6 +166,12 @@ const intakeRouteSchema = z.object({
158
166
  * files no pull request, through every edit. Add a route to file pull requests.
159
167
  */
160
168
  pullRequestOpenedMovesOnly: z.literal(true).optional(),
169
+ /**
170
+ * True on a route stored before card-move rules decided outsiders' pull requests: its card moves
171
+ * skip an outside author's pull request unless its conditions test `pullRequest.trusted`. Edits
172
+ * keep it; only an explicit `outsiderPullRequestsGated: false` patch clears it.
173
+ */
174
+ outsiderPullRequestsGated: z.literal(true).optional(),
161
175
  /** Send it back as `expectedRevision` when editing or deleting. */
162
176
  revision: z.number().int(),
163
177
  createdBy: z.string(),
@@ -202,12 +216,10 @@ const intakeOrderResponseSchema = z.object({
202
216
  /** Which evaluator places the project's new items now: `route-list` (the old one) or `intake-order`. */
203
217
  evaluator: z.enum(["route-list", "intake-order"]),
204
218
  /**
205
- * What decided `evaluator`: the Factory's `intake.evaluator` option or `FACTORY_INTAKE_EVALUATOR`
206
- * (forced on every project), the project's own setting, or none (a project from before the
207
- * setting, on `route-list`).
219
+ * What decided `evaluator`: `FACTORY_INTAKE_EVALUATOR` (forced on every project), the project's
220
+ * own setting, or none (a project from before the setting, on `route-list`).
208
221
  */
209
222
  evaluatorSource: z.enum([
210
- "option",
211
223
  "env",
212
224
  "project",
213
225
  "legacy"
@@ -1296,6 +1308,8 @@ const skillPathSchema = z.object({
1296
1308
  name: skillNameSchema
1297
1309
  });
1298
1310
  const skillResponseSchema = z.object({ skill: entitySchema });
1311
+ /** `skill` is null when the request deleted a skill the project created. */
1312
+ const skillRevertResponseSchema = z.object({ skill: entitySchema.nullable() });
1299
1313
  /** Adds the runtime's SKILL.md validation errors, checking the frontmatter name against `directoryName` when given. */
1300
1314
  function refineSkillContent(content, context, directoryName) {
1301
1315
  const result = validateSkillContent({
@@ -1315,6 +1329,11 @@ const skillOverrideBodySchema = z.object({ content: skillContentSchema }).strict
1315
1329
  * name, exactly as the runtime validates it.
1316
1330
  */
1317
1331
  const skillOverrideSaveRequestSchema = skillPathSchema.extend({ content: skillContentSchema }).superRefine((input, context) => refineSkillContent(input.content, context, input.name));
1332
+ /** A new skill's SKILL.md must load under the name it is created with, exactly as the runtime validates it. */
1333
+ const skillCreateBodySchema = z.object({
1334
+ name: skillNameSchema,
1335
+ content: skillContentSchema
1336
+ }).strict().superRefine((input, context) => refineSkillContent(input.content, context, input.name));
1318
1337
  const FACTORY_ROUTE_CONTRACTS = {
1319
1338
  projectList: {
1320
1339
  method: "GET",
@@ -1907,10 +1926,18 @@ const FACTORY_ROUTE_CONTRACTS = {
1907
1926
  canEdit: z.boolean().optional()
1908
1927
  })
1909
1928
  },
1929
+ skillCreate: {
1930
+ method: "POST",
1931
+ path: "/web/factory/projects/:id/skills",
1932
+ description: "Create a skill for one Factory project",
1933
+ pathSchema: projectPathSchema,
1934
+ bodySchema: skillCreateBodySchema,
1935
+ responseSchema: skillResponseSchema
1936
+ },
1910
1937
  skillOverrideSave: {
1911
1938
  method: "PUT",
1912
1939
  path: "/web/factory/projects/:id/skills/:name",
1913
- description: "Save a project's edited SKILL.md for a Factory skill",
1940
+ description: "Save a project's SKILL.md for a Factory skill: an edit of an app skill, or a skill it created",
1914
1941
  pathSchema: skillPathSchema,
1915
1942
  bodySchema: skillOverrideBodySchema,
1916
1943
  responseSchema: skillResponseSchema
@@ -1918,11 +1945,11 @@ const FACTORY_ROUTE_CONTRACTS = {
1918
1945
  skillOverrideRevert: {
1919
1946
  method: "DELETE",
1920
1947
  path: "/web/factory/projects/:id/skills/:name",
1921
- description: "Revert a project's edited Factory skill to its original SKILL.md",
1948
+ description: "Revert a project's edited Factory skill to its original SKILL.md, or delete a skill the project created",
1922
1949
  pathSchema: skillPathSchema,
1923
- responseSchema: skillResponseSchema
1950
+ responseSchema: skillRevertResponseSchema
1924
1951
  }
1925
1952
  };
1926
- export { BOARD_PHASES_SORTS, FACTORY_ROUTE_CONTRACTS, MAX_SANDBOX_ENV_VALUE_LENGTH, MAX_SKILL_OVERRIDE_LENGTH, RESERVED_SANDBOX_ENV_NAMES, THINKING_LEVELS, UUID_PATTERN, attentionQuerySchema, automationRunStartBodySchema, boardDeleteQuerySchema, boardPhasesQuerySchema, boardPhasesResponseSchema, boardResetBodySchema, createProjectBodySchema, createWorkItemBodySchema, decisionQuerySchema, environmentBuildResponseSchema, environmentBuildSchema, environmentBuildStartResponseSchema, environmentBuildTriggersSchema, environmentBuildsResponseSchema, environmentLastBuildSchema, environmentSandboxSchema, intakeDryRunBodySchema, intakeOrderBodySchema, intakeRouteInputSchema, intakeRoutePatchSchema, intakeRouteReorderBodySchema, intakeTestBodySchema, metricsQuerySchema, projectEnvironmentResponseSchema, projectListRepositorySchema, replaceBoardBodySchema, runQueueResponseSchema, sandboxEnvAppliesToSchema, sandboxEnvNameSchema, sandboxEnvSetBodySchema, sandboxEnvUpdateBodySchema, sessionActivityResponseSchema, sessionRowsQuerySchema, sessionRowsResponseSchema, skillOverrideBodySchema, skillOverrideSaveRequestSchema, startWorkItemBodySchema, transitionBodySchema, updateProjectBodySchema, updateProjectEnvironmentBodySchema, updateWorkItemBodySchema, workItemActivityQuerySchema, workItemActivityResponseSchema, workItemFilterOptionsResponseSchema, workItemSessionRepositoryResponseSchema, workItemStartersResponseSchema };
1953
+ export { BOARD_PHASES_SORTS, FACTORY_ROUTE_CONTRACTS, MAX_SANDBOX_ENV_VALUE_LENGTH, MAX_SKILL_OVERRIDE_LENGTH, RESERVED_SANDBOX_ENV_NAMES, THINKING_LEVELS, UUID_PATTERN, attentionQuerySchema, automationRunStartBodySchema, boardDeleteQuerySchema, boardPhasesQuerySchema, boardPhasesResponseSchema, boardResetBodySchema, createProjectBodySchema, createWorkItemBodySchema, decisionQuerySchema, environmentBuildResponseSchema, environmentBuildSchema, environmentBuildStartResponseSchema, environmentBuildTriggersSchema, environmentBuildsResponseSchema, environmentLastBuildSchema, environmentSandboxSchema, intakeDryRunBodySchema, intakeOrderBodySchema, intakeRouteInputSchema, intakeRoutePatchSchema, intakeRouteReorderBodySchema, intakeTestBodySchema, metricsQuerySchema, projectEnvironmentResponseSchema, projectListRepositorySchema, replaceBoardBodySchema, runQueueResponseSchema, sandboxEnvAppliesToSchema, sandboxEnvNameSchema, sandboxEnvSetBodySchema, sandboxEnvUpdateBodySchema, sessionActivityResponseSchema, sessionRowsQuerySchema, sessionRowsResponseSchema, skillCreateBodySchema, skillOverrideBodySchema, skillOverrideSaveRequestSchema, startWorkItemBodySchema, transitionBodySchema, updateProjectBodySchema, updateProjectEnvironmentBodySchema, updateWorkItemBodySchema, workItemActivityQuerySchema, workItemActivityResponseSchema, workItemFilterOptionsResponseSchema, workItemSessionRepositoryResponseSchema, workItemStartersResponseSchema };
1927
1954
 
1928
1955
  //# sourceMappingURL=contracts.js.map