@mastra/factory 0.0.0-fix-thread-subscription-multi-instance-redis-streams-20260730204150

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 (313) hide show
  1. package/CHANGELOG.md +695 -0
  2. package/LICENSE.md +30 -0
  3. package/README.md +27 -0
  4. package/dist/auth.d.ts +181 -0
  5. package/dist/auth.d.ts.map +1 -0
  6. package/dist/auth.js +505 -0
  7. package/dist/auth.js.map +1 -0
  8. package/dist/capabilities/connection.d.ts +9 -0
  9. package/dist/capabilities/connection.d.ts.map +1 -0
  10. package/dist/capabilities/connection.js +1 -0
  11. package/dist/capabilities/intake.d.ts +140 -0
  12. package/dist/capabilities/intake.d.ts.map +1 -0
  13. package/dist/capabilities/intake.js +1 -0
  14. package/dist/capabilities/version-control.d.ts +245 -0
  15. package/dist/capabilities/version-control.d.ts.map +1 -0
  16. package/dist/capabilities/version-control.js +1 -0
  17. package/dist/factory.d.ts +156 -0
  18. package/dist/factory.d.ts.map +1 -0
  19. package/dist/factory.js +483 -0
  20. package/dist/factory.js.map +1 -0
  21. package/dist/index.d.ts +14 -0
  22. package/dist/index.d.ts.map +1 -0
  23. package/dist/index.js +7 -0
  24. package/dist/integrations/base.d.ts +210 -0
  25. package/dist/integrations/base.d.ts.map +1 -0
  26. package/dist/integrations/base.js +1 -0
  27. package/dist/integrations/github/config.d.ts +60 -0
  28. package/dist/integrations/github/config.d.ts.map +1 -0
  29. package/dist/integrations/github/config.js +42 -0
  30. package/dist/integrations/github/config.js.map +1 -0
  31. package/dist/integrations/github/factory-session.d.ts +12 -0
  32. package/dist/integrations/github/factory-session.d.ts.map +1 -0
  33. package/dist/integrations/github/factory-session.js +37 -0
  34. package/dist/integrations/github/factory-session.js.map +1 -0
  35. package/dist/integrations/github/integration.d.ts +191 -0
  36. package/dist/integrations/github/integration.d.ts.map +1 -0
  37. package/dist/integrations/github/integration.js +1077 -0
  38. package/dist/integrations/github/integration.js.map +1 -0
  39. package/dist/integrations/github/issue-triage.d.ts +27 -0
  40. package/dist/integrations/github/issue-triage.d.ts.map +1 -0
  41. package/dist/integrations/github/issue-triage.js +82 -0
  42. package/dist/integrations/github/issue-triage.js.map +1 -0
  43. package/dist/integrations/github/pat.d.ts +38 -0
  44. package/dist/integrations/github/pat.d.ts.map +1 -0
  45. package/dist/integrations/github/pat.js +59 -0
  46. package/dist/integrations/github/pat.js.map +1 -0
  47. package/dist/integrations/github/provenance.d.ts +27 -0
  48. package/dist/integrations/github/provenance.d.ts.map +1 -0
  49. package/dist/integrations/github/provenance.js +75 -0
  50. package/dist/integrations/github/provenance.js.map +1 -0
  51. package/dist/integrations/github/routes.d.ts +69 -0
  52. package/dist/integrations/github/routes.d.ts.map +1 -0
  53. package/dist/integrations/github/routes.js +1324 -0
  54. package/dist/integrations/github/routes.js.map +1 -0
  55. package/dist/integrations/github/rules.d.ts +78 -0
  56. package/dist/integrations/github/rules.d.ts.map +1 -0
  57. package/dist/integrations/github/rules.js +362 -0
  58. package/dist/integrations/github/rules.js.map +1 -0
  59. package/dist/integrations/github/sandbox-release.d.ts +38 -0
  60. package/dist/integrations/github/sandbox-release.d.ts.map +1 -0
  61. package/dist/integrations/github/sandbox-release.js +74 -0
  62. package/dist/integrations/github/sandbox-release.js.map +1 -0
  63. package/dist/integrations/github/sandbox.d.ts +281 -0
  64. package/dist/integrations/github/sandbox.d.ts.map +1 -0
  65. package/dist/integrations/github/sandbox.js +547 -0
  66. package/dist/integrations/github/sandbox.js.map +1 -0
  67. package/dist/integrations/github/session-subscriptions.d.ts +26 -0
  68. package/dist/integrations/github/session-subscriptions.d.ts.map +1 -0
  69. package/dist/integrations/github/session-subscriptions.js +192 -0
  70. package/dist/integrations/github/session-subscriptions.js.map +1 -0
  71. package/dist/integrations/github/subscriptions.d.ts +54 -0
  72. package/dist/integrations/github/subscriptions.d.ts.map +1 -0
  73. package/dist/integrations/github/subscriptions.js +62 -0
  74. package/dist/integrations/github/subscriptions.js.map +1 -0
  75. package/dist/integrations/github/token-refresh.d.ts +12 -0
  76. package/dist/integrations/github/token-refresh.d.ts.map +1 -0
  77. package/dist/integrations/github/token-refresh.js +24 -0
  78. package/dist/integrations/github/token-refresh.js.map +1 -0
  79. package/dist/integrations/github/webhook.d.ts +87 -0
  80. package/dist/integrations/github/webhook.d.ts.map +1 -0
  81. package/dist/integrations/github/webhook.js +397 -0
  82. package/dist/integrations/github/webhook.js.map +1 -0
  83. package/dist/integrations/linear/agent-tools.d.ts +34 -0
  84. package/dist/integrations/linear/agent-tools.d.ts.map +1 -0
  85. package/dist/integrations/linear/agent-tools.js +85 -0
  86. package/dist/integrations/linear/agent-tools.js.map +1 -0
  87. package/dist/integrations/linear/integration.d.ts +233 -0
  88. package/dist/integrations/linear/integration.d.ts.map +1 -0
  89. package/dist/integrations/linear/integration.js +672 -0
  90. package/dist/integrations/linear/integration.js.map +1 -0
  91. package/dist/integrations/linear/routes.d.ts +61 -0
  92. package/dist/integrations/linear/routes.d.ts.map +1 -0
  93. package/dist/integrations/linear/routes.js +239 -0
  94. package/dist/integrations/linear/routes.js.map +1 -0
  95. package/dist/integrations/linear/rules.d.ts +42 -0
  96. package/dist/integrations/linear/rules.d.ts.map +1 -0
  97. package/dist/integrations/linear/rules.js +133 -0
  98. package/dist/integrations/linear/rules.js.map +1 -0
  99. package/dist/integrations/linear/storage.d.ts +65 -0
  100. package/dist/integrations/linear/storage.d.ts.map +1 -0
  101. package/dist/integrations/linear/storage.js +1 -0
  102. package/dist/integrations/platform/api-client.d.ts +26 -0
  103. package/dist/integrations/platform/api-client.d.ts.map +1 -0
  104. package/dist/integrations/platform/api-client.js +156 -0
  105. package/dist/integrations/platform/api-client.js.map +1 -0
  106. package/dist/integrations/platform/github/event-worker.d.ts +49 -0
  107. package/dist/integrations/platform/github/event-worker.d.ts.map +1 -0
  108. package/dist/integrations/platform/github/event-worker.js +348 -0
  109. package/dist/integrations/platform/github/event-worker.js.map +1 -0
  110. package/dist/integrations/platform/github/integration.d.ts +50 -0
  111. package/dist/integrations/platform/github/integration.d.ts.map +1 -0
  112. package/dist/integrations/platform/github/integration.js +961 -0
  113. package/dist/integrations/platform/github/integration.js.map +1 -0
  114. package/dist/integrations/platform/linear/integration.d.ts +46 -0
  115. package/dist/integrations/platform/linear/integration.d.ts.map +1 -0
  116. package/dist/integrations/platform/linear/integration.js +483 -0
  117. package/dist/integrations/platform/linear/integration.js.map +1 -0
  118. package/dist/integrations/workos/integration.d.ts +39 -0
  119. package/dist/integrations/workos/integration.d.ts.map +1 -0
  120. package/dist/integrations/workos/integration.js +91 -0
  121. package/dist/integrations/workos/integration.js.map +1 -0
  122. package/dist/routes/config.d.ts +235 -0
  123. package/dist/routes/config.d.ts.map +1 -0
  124. package/dist/routes/config.js +972 -0
  125. package/dist/routes/config.js.map +1 -0
  126. package/dist/routes/custom-provider-source.d.ts +52 -0
  127. package/dist/routes/custom-provider-source.d.ts.map +1 -0
  128. package/dist/routes/custom-provider-source.js +124 -0
  129. package/dist/routes/custom-provider-source.js.map +1 -0
  130. package/dist/routes/fs.d.ts +151 -0
  131. package/dist/routes/fs.d.ts.map +1 -0
  132. package/dist/routes/fs.js +708 -0
  133. package/dist/routes/fs.js.map +1 -0
  134. package/dist/routes/intake.d.ts +23 -0
  135. package/dist/routes/intake.d.ts.map +1 -0
  136. package/dist/routes/intake.js +179 -0
  137. package/dist/routes/intake.js.map +1 -0
  138. package/dist/routes/oauth.d.ts +43 -0
  139. package/dist/routes/oauth.d.ts.map +1 -0
  140. package/dist/routes/oauth.js +463 -0
  141. package/dist/routes/oauth.js.map +1 -0
  142. package/dist/routes/projects.d.ts +19 -0
  143. package/dist/routes/projects.d.ts.map +1 -0
  144. package/dist/routes/projects.js +461 -0
  145. package/dist/routes/projects.js.map +1 -0
  146. package/dist/routes/provider-credentials.d.ts +81 -0
  147. package/dist/routes/provider-credentials.d.ts.map +1 -0
  148. package/dist/routes/provider-credentials.js +86 -0
  149. package/dist/routes/provider-credentials.js.map +1 -0
  150. package/dist/routes/route.d.ts +48 -0
  151. package/dist/routes/route.d.ts.map +1 -0
  152. package/dist/routes/route.js +15 -0
  153. package/dist/routes/route.js.map +1 -0
  154. package/dist/routes/skills.d.ts +30 -0
  155. package/dist/routes/skills.d.ts.map +1 -0
  156. package/dist/routes/skills.js +168 -0
  157. package/dist/routes/skills.js.map +1 -0
  158. package/dist/routes/surface.d.ts +91 -0
  159. package/dist/routes/surface.d.ts.map +1 -0
  160. package/dist/routes/surface.js +260 -0
  161. package/dist/routes/surface.js.map +1 -0
  162. package/dist/routes/tenant-credentials.d.ts +74 -0
  163. package/dist/routes/tenant-credentials.d.ts.map +1 -0
  164. package/dist/routes/tenant-credentials.js +156 -0
  165. package/dist/routes/tenant-credentials.js.map +1 -0
  166. package/dist/routes/work-items.d.ts +40 -0
  167. package/dist/routes/work-items.d.ts.map +1 -0
  168. package/dist/routes/work-items.js +695 -0
  169. package/dist/routes/work-items.js.map +1 -0
  170. package/dist/rules/binding-context.d.ts +5 -0
  171. package/dist/rules/binding-context.d.ts.map +1 -0
  172. package/dist/rules/binding-context.js +28 -0
  173. package/dist/rules/binding-context.js.map +1 -0
  174. package/dist/rules/defaults.d.ts +9 -0
  175. package/dist/rules/defaults.d.ts.map +1 -0
  176. package/dist/rules/defaults.js +260 -0
  177. package/dist/rules/defaults.js.map +1 -0
  178. package/dist/rules/dispatcher.d.ts +42 -0
  179. package/dist/rules/dispatcher.d.ts.map +1 -0
  180. package/dist/rules/dispatcher.js +518 -0
  181. package/dist/rules/dispatcher.js.map +1 -0
  182. package/dist/rules/index.d.ts +7 -0
  183. package/dist/rules/index.d.ts.map +1 -0
  184. package/dist/rules/index.js +5 -0
  185. package/dist/rules/processor.d.ts +54 -0
  186. package/dist/rules/processor.d.ts.map +1 -0
  187. package/dist/rules/processor.js +378 -0
  188. package/dist/rules/processor.js.map +1 -0
  189. package/dist/rules/resolve.d.ts +17 -0
  190. package/dist/rules/resolve.d.ts.map +1 -0
  191. package/dist/rules/resolve.js +30 -0
  192. package/dist/rules/resolve.js.map +1 -0
  193. package/dist/rules/start-coordinator.d.ts +60 -0
  194. package/dist/rules/start-coordinator.d.ts.map +1 -0
  195. package/dist/rules/start-coordinator.js +194 -0
  196. package/dist/rules/start-coordinator.js.map +1 -0
  197. package/dist/rules/tools.d.ts +10 -0
  198. package/dist/rules/tools.d.ts.map +1 -0
  199. package/dist/rules/tools.js +58 -0
  200. package/dist/rules/tools.js.map +1 -0
  201. package/dist/rules/transition-service.d.ts +49 -0
  202. package/dist/rules/transition-service.d.ts.map +1 -0
  203. package/dist/rules/transition-service.js +232 -0
  204. package/dist/rules/transition-service.js.map +1 -0
  205. package/dist/rules/types.d.ts +234 -0
  206. package/dist/rules/types.d.ts.map +1 -0
  207. package/dist/rules/types.js +38 -0
  208. package/dist/rules/types.js.map +1 -0
  209. package/dist/rules/validation.d.ts +11 -0
  210. package/dist/rules/validation.d.ts.map +1 -0
  211. package/dist/rules/validation.js +308 -0
  212. package/dist/rules/validation.js.map +1 -0
  213. package/dist/sandbox/fleet.d.ts +222 -0
  214. package/dist/sandbox/fleet.d.ts.map +1 -0
  215. package/dist/sandbox/fleet.js +322 -0
  216. package/dist/sandbox/fleet.js.map +1 -0
  217. package/dist/sandbox/reattach.d.ts +3 -0
  218. package/dist/sandbox/reattach.d.ts.map +1 -0
  219. package/dist/sandbox/reattach.js +16 -0
  220. package/dist/sandbox/reattach.js.map +1 -0
  221. package/dist/server-error.d.ts +12 -0
  222. package/dist/server-error.d.ts.map +1 -0
  223. package/dist/server-error.js +16 -0
  224. package/dist/server-error.js.map +1 -0
  225. package/dist/skills/service.d.ts +48 -0
  226. package/dist/skills/service.d.ts.map +1 -0
  227. package/dist/skills/service.js +40 -0
  228. package/dist/skills/service.js.map +1 -0
  229. package/dist/spa-static.d.ts +33 -0
  230. package/dist/spa-static.d.ts.map +1 -0
  231. package/dist/spa-static.js +104 -0
  232. package/dist/spa-static.js.map +1 -0
  233. package/dist/state-signing.d.ts +59 -0
  234. package/dist/state-signing.d.ts.map +1 -0
  235. package/dist/state-signing.js +83 -0
  236. package/dist/state-signing.js.map +1 -0
  237. package/dist/storage/domains/audit/agent-audit.d.ts +27 -0
  238. package/dist/storage/domains/audit/agent-audit.d.ts.map +1 -0
  239. package/dist/storage/domains/audit/agent-audit.js +66 -0
  240. package/dist/storage/domains/audit/agent-audit.js.map +1 -0
  241. package/dist/storage/domains/audit/base.d.ts +140 -0
  242. package/dist/storage/domains/audit/base.d.ts.map +1 -0
  243. package/dist/storage/domains/audit/base.js +184 -0
  244. package/dist/storage/domains/audit/base.js.map +1 -0
  245. package/dist/storage/domains/audit/domain.d.ts +69 -0
  246. package/dist/storage/domains/audit/domain.d.ts.map +1 -0
  247. package/dist/storage/domains/audit/domain.js +167 -0
  248. package/dist/storage/domains/audit/domain.js.map +1 -0
  249. package/dist/storage/domains/channel-identity/base.d.ts +96 -0
  250. package/dist/storage/domains/channel-identity/base.d.ts.map +1 -0
  251. package/dist/storage/domains/channel-identity/base.js +149 -0
  252. package/dist/storage/domains/channel-identity/base.js.map +1 -0
  253. package/dist/storage/domains/credentials/base.d.ts +134 -0
  254. package/dist/storage/domains/credentials/base.d.ts.map +1 -0
  255. package/dist/storage/domains/credentials/base.js +273 -0
  256. package/dist/storage/domains/credentials/base.js.map +1 -0
  257. package/dist/storage/domains/custom-providers/base.d.ts +57 -0
  258. package/dist/storage/domains/custom-providers/base.d.ts.map +1 -0
  259. package/dist/storage/domains/custom-providers/base.js +145 -0
  260. package/dist/storage/domains/custom-providers/base.js.map +1 -0
  261. package/dist/storage/domains/intake/base.d.ts +38 -0
  262. package/dist/storage/domains/intake/base.d.ts.map +1 -0
  263. package/dist/storage/domains/intake/base.js +80 -0
  264. package/dist/storage/domains/intake/base.js.map +1 -0
  265. package/dist/storage/domains/integrations/base.d.ts +126 -0
  266. package/dist/storage/domains/integrations/base.d.ts.map +1 -0
  267. package/dist/storage/domains/integrations/base.js +317 -0
  268. package/dist/storage/domains/integrations/base.js.map +1 -0
  269. package/dist/storage/domains/memory-settings/base.d.ts +62 -0
  270. package/dist/storage/domains/memory-settings/base.d.ts.map +1 -0
  271. package/dist/storage/domains/memory-settings/base.js +126 -0
  272. package/dist/storage/domains/memory-settings/base.js.map +1 -0
  273. package/dist/storage/domains/model-packs/base.d.ts +49 -0
  274. package/dist/storage/domains/model-packs/base.d.ts.map +1 -0
  275. package/dist/storage/domains/model-packs/base.js +96 -0
  276. package/dist/storage/domains/model-packs/base.js.map +1 -0
  277. package/dist/storage/domains/projects/base.d.ts +58 -0
  278. package/dist/storage/domains/projects/base.d.ts.map +1 -0
  279. package/dist/storage/domains/projects/base.js +111 -0
  280. package/dist/storage/domains/projects/base.js.map +1 -0
  281. package/dist/storage/domains/queue-health/base.d.ts +52 -0
  282. package/dist/storage/domains/queue-health/base.d.ts.map +1 -0
  283. package/dist/storage/domains/queue-health/base.js +122 -0
  284. package/dist/storage/domains/queue-health/base.js.map +1 -0
  285. package/dist/storage/domains/source-control/base.d.ts +358 -0
  286. package/dist/storage/domains/source-control/base.d.ts.map +1 -0
  287. package/dist/storage/domains/source-control/base.js +908 -0
  288. package/dist/storage/domains/source-control/base.js.map +1 -0
  289. package/dist/storage/domains/source-control/inmemory.d.ts +175 -0
  290. package/dist/storage/domains/source-control/inmemory.d.ts.map +1 -0
  291. package/dist/storage/domains/source-control/inmemory.js +377 -0
  292. package/dist/storage/domains/source-control/inmemory.js.map +1 -0
  293. package/dist/storage/domains/work-items/base.d.ts +412 -0
  294. package/dist/storage/domains/work-items/base.d.ts.map +1 -0
  295. package/dist/storage/domains/work-items/base.js +1309 -0
  296. package/dist/storage/domains/work-items/base.js.map +1 -0
  297. package/dist/storage/domains/work-items/metrics.d.ts +101 -0
  298. package/dist/storage/domains/work-items/metrics.d.ts.map +1 -0
  299. package/dist/storage/domains/work-items/metrics.js +221 -0
  300. package/dist/storage/domains/work-items/metrics.js.map +1 -0
  301. package/dist/timing.d.ts +15 -0
  302. package/dist/timing.d.ts.map +1 -0
  303. package/dist/timing.js +34 -0
  304. package/dist/timing.js.map +1 -0
  305. package/dist/workspace.d.ts +24 -0
  306. package/dist/workspace.d.ts.map +1 -0
  307. package/dist/workspace.js +286 -0
  308. package/dist/workspace.js.map +1 -0
  309. package/factory-skills/configure-factory-rules/SKILL.md +67 -0
  310. package/factory-skills/factory-plan/SKILL.md +61 -0
  311. package/factory-skills/factory-review/SKILL.md +155 -0
  312. package/factory-skills/factory-triage/SKILL.md +77 -0
  313. package/package.json +81 -0
@@ -0,0 +1,140 @@
1
+ import type { IntegrationConnection } from './connection.js';
2
+ export interface IntakeSource {
3
+ id: string;
4
+ name: string;
5
+ type: string;
6
+ metadata?: Record<string, unknown>;
7
+ }
8
+ export interface IntakeItem {
9
+ source: {
10
+ type: string;
11
+ externalId: string;
12
+ url?: string;
13
+ };
14
+ sourceId: string;
15
+ title: string;
16
+ status?: string;
17
+ labels?: string[];
18
+ assignee?: string | null;
19
+ createdAt?: string;
20
+ updatedAt?: string;
21
+ metadata?: Record<string, unknown>;
22
+ }
23
+ export interface IntakeItemPage {
24
+ items: IntakeItem[];
25
+ nextCursor: string | null;
26
+ }
27
+ export interface ListIntakeSourcesInput {
28
+ orgId: string;
29
+ userId: string;
30
+ }
31
+ export interface ListIntakeItemsInput extends ListIntakeSourcesInput {
32
+ sourceIds: string[];
33
+ cursor?: string;
34
+ }
35
+ /** Provider-neutral issue returned by every Intake integration. */
36
+ export interface IntakeIssue {
37
+ id: string;
38
+ identifier: string;
39
+ title: string;
40
+ url: string;
41
+ author: string | null;
42
+ state: string | null;
43
+ stateType: string | null;
44
+ priority: string | null;
45
+ assignee: string | null;
46
+ source: string | null;
47
+ labels: string[];
48
+ commentCount: number | null;
49
+ createdAt: string;
50
+ updatedAt: string;
51
+ }
52
+ export interface IntakeIssueComment {
53
+ author: string | null;
54
+ body: string;
55
+ createdAt: string;
56
+ }
57
+ export interface IntakeIssueDetail extends IntakeIssue {
58
+ description: string | null;
59
+ comments: IntakeIssueComment[];
60
+ }
61
+ export interface IntakeIssuePage {
62
+ issues: IntakeIssue[];
63
+ nextCursor: string | null;
64
+ }
65
+ export interface ListIntakeIssuesInput {
66
+ connection: IntegrationConnection;
67
+ /** Provider-defined source ids: repositories for GitHub, projects for Linear. */
68
+ sourceIds: string[];
69
+ /** Provider label names used to filter the issue listing. */
70
+ labels?: string[];
71
+ cursor?: string;
72
+ }
73
+ export interface GetIntakeIssueInput {
74
+ connection: IntegrationConnection;
75
+ sourceId?: string;
76
+ issueId: string;
77
+ }
78
+ export interface CreateIntakeCommentInput extends GetIntakeIssueInput {
79
+ body: string;
80
+ /** End user the comment should be attributed to, when the provider supports acting on a user's behalf. */
81
+ actingUserId?: string;
82
+ }
83
+ export interface CreatedIntakeComment {
84
+ id: string;
85
+ url: string;
86
+ }
87
+ /**
88
+ * Provider-neutral target state for `Intake.updateIssue`.
89
+ *
90
+ * `byType` uses the workflow-state family so callers don't have to know per-team
91
+ * state names; `byName` is escape hatch for teams that need a specific state.
92
+ * Adapters that don't support custom states (GitHub) ignore `byName` with a
93
+ * warn log.
94
+ */
95
+ export type IntakeIssueTargetState = {
96
+ kind: 'byType';
97
+ stateType: 'unstarted' | 'started' | 'completed' | 'canceled';
98
+ } | {
99
+ kind: 'byName';
100
+ name: string;
101
+ };
102
+ export interface UpdateIntakeIssueInput extends GetIntakeIssueInput {
103
+ state: IntakeIssueTargetState;
104
+ /** End user the state change should be attributed to, when the provider supports acting on a user's behalf. */
105
+ actingUserId?: string;
106
+ }
107
+ export interface ResolveIntakeDispatchInput {
108
+ orgId: string;
109
+ externalSource: {
110
+ type: string;
111
+ externalId: string;
112
+ };
113
+ }
114
+ export interface ResolvedIntakeDispatch {
115
+ connection: IntegrationConnection;
116
+ sourceId?: string;
117
+ issueId: string;
118
+ }
119
+ /** Fixed issue-oriented contract implemented by GitHub, Linear, and future sources. */
120
+ export interface Intake {
121
+ /**
122
+ * Resolve the connection and provider-specific identifiers needed to call
123
+ * this capability from a background dispatch context.
124
+ */
125
+ resolveIntakeDispatch?(input: ResolveIntakeDispatchInput): Promise<ResolvedIntakeDispatch | null>;
126
+ listSources(input: ListIntakeSourcesInput): Promise<IntakeSource[]>;
127
+ listItems(input: ListIntakeItemsInput): Promise<IntakeItemPage>;
128
+ listIssues(input: ListIntakeIssuesInput): Promise<IntakeIssuePage>;
129
+ getIssue(input: GetIntakeIssueInput): Promise<IntakeIssueDetail | null>;
130
+ createComment(input: CreateIntakeCommentInput): Promise<CreatedIntakeComment | null>;
131
+ /**
132
+ * Move an issue to a target state. Returns the refreshed `IntakeIssue` on
133
+ * success, or `null` when the target is not applicable (e.g., a GitHub PR,
134
+ * or no matching workflow state). Adapters MUST NOT throw for policy misses
135
+ * — only for infrastructure errors (network, auth). This distinction lets
136
+ * the executor idempotency guard treat `null` as "done, nothing to do".
137
+ */
138
+ updateIssue(input: UpdateIntakeIssueInput): Promise<IntakeIssue | null>;
139
+ }
140
+ //# sourceMappingURL=intake.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"intake.d.ts","sourceRoot":"","sources":["../../src/capabilities/intake.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,245 @@
1
+ import type { SourceControlInstallation, SourceControlRepository, SourceControlStorageHandle } from '../storage/domains/source-control/base.js';
2
+ import type { IntegrationConnection } from './connection.js';
3
+ export interface InstallationInput {
4
+ externalId: string;
5
+ accountName?: string | null;
6
+ accountType?: string | null;
7
+ metadata?: Record<string, unknown>;
8
+ }
9
+ export interface RepositoryInput {
10
+ externalId: string;
11
+ slug: string;
12
+ defaultBranch: string;
13
+ metadata?: Record<string, unknown>;
14
+ }
15
+ export interface RepositoryAccess {
16
+ cloneUrl: string;
17
+ authorization?: {
18
+ scheme: 'bearer';
19
+ token: string;
20
+ };
21
+ }
22
+ export type PullRequestState = 'open' | 'closed';
23
+ export interface PullRequest {
24
+ id: string;
25
+ title: string;
26
+ url: string;
27
+ author: string | null;
28
+ body: string | null;
29
+ state: PullRequestState;
30
+ draft: boolean;
31
+ merged: boolean;
32
+ mergeable: boolean | null;
33
+ baseBranch: string;
34
+ headBranch: string;
35
+ headSha: string;
36
+ createdAt: string;
37
+ updatedAt: string;
38
+ }
39
+ export interface PullRequestPage {
40
+ pullRequests: PullRequest[];
41
+ nextCursor: string | null;
42
+ }
43
+ export interface PullRequestRef {
44
+ connection: IntegrationConnection;
45
+ sourceId: string;
46
+ pullRequestId: string;
47
+ /** End user the write should be attributed to, when the provider supports acting on a user's behalf. */
48
+ actingUserId?: string;
49
+ }
50
+ export interface ListPullRequestsInput {
51
+ connection: IntegrationConnection;
52
+ sourceId: string;
53
+ state?: PullRequestState | 'all';
54
+ includeDrafts?: boolean;
55
+ cursor?: string;
56
+ }
57
+ export interface CreatePullRequestInput {
58
+ connection: IntegrationConnection;
59
+ sourceId: string;
60
+ title: string;
61
+ body?: string;
62
+ baseBranch: string;
63
+ headBranch: string;
64
+ draft?: boolean;
65
+ /** End user the write should be attributed to, when the provider supports acting on a user's behalf. */
66
+ actingUserId?: string;
67
+ }
68
+ export interface UpdatePullRequestInput extends PullRequestRef {
69
+ title?: string;
70
+ body?: string | null;
71
+ baseBranch?: string;
72
+ state?: PullRequestState;
73
+ }
74
+ export interface MergePullRequestInput extends PullRequestRef {
75
+ commitTitle?: string;
76
+ commitMessage?: string;
77
+ method?: 'merge' | 'squash' | 'rebase';
78
+ }
79
+ export interface MergePullRequestResult {
80
+ merged: boolean;
81
+ message: string;
82
+ sha: string | null;
83
+ }
84
+ export interface PullRequestComment {
85
+ id: string;
86
+ url: string;
87
+ author: string | null;
88
+ body: string;
89
+ createdAt: string;
90
+ updatedAt: string;
91
+ }
92
+ export interface PullRequestCommentPage {
93
+ comments: PullRequestComment[];
94
+ nextCursor: string | null;
95
+ }
96
+ export interface ListPullRequestCommentsInput extends PullRequestRef {
97
+ cursor?: string;
98
+ }
99
+ export interface CreatePullRequestCommentInput extends PullRequestRef {
100
+ body: string;
101
+ }
102
+ export interface UpdatePullRequestCommentInput {
103
+ connection: IntegrationConnection;
104
+ sourceId: string;
105
+ commentId: string;
106
+ body: string;
107
+ actingUserId?: string;
108
+ }
109
+ export interface DeletePullRequestCommentInput {
110
+ connection: IntegrationConnection;
111
+ sourceId: string;
112
+ commentId: string;
113
+ actingUserId?: string;
114
+ }
115
+ export type ReviewState = 'pending' | 'commented' | 'approved' | 'changes-requested' | 'dismissed';
116
+ export interface Review {
117
+ id: string;
118
+ url: string | null;
119
+ author: string | null;
120
+ body: string | null;
121
+ state: ReviewState;
122
+ commitId: string | null;
123
+ submittedAt: string | null;
124
+ }
125
+ export interface ReviewPage {
126
+ reviews: Review[];
127
+ nextCursor: string | null;
128
+ }
129
+ export interface ListReviewsInput extends PullRequestRef {
130
+ cursor?: string;
131
+ }
132
+ type CreateReviewBase = PullRequestRef & {
133
+ commitId?: string;
134
+ };
135
+ type ReviewSubmission = {
136
+ event: 'approve';
137
+ body?: string;
138
+ } | {
139
+ event: 'request-changes' | 'comment';
140
+ body: string;
141
+ };
142
+ export type CreateReviewInput = CreateReviewBase & (ReviewSubmission | {
143
+ event?: undefined;
144
+ body?: string;
145
+ });
146
+ export interface ReviewRef extends PullRequestRef {
147
+ reviewId: string;
148
+ }
149
+ export interface UpdateReviewInput extends ReviewRef {
150
+ body: string;
151
+ }
152
+ export type SubmitReviewInput = ReviewRef & ReviewSubmission;
153
+ export interface DismissReviewInput extends ReviewRef {
154
+ message: string;
155
+ }
156
+ export interface ReviewComment extends PullRequestComment {
157
+ path: string;
158
+ line: number | null;
159
+ side: 'left' | 'right' | null;
160
+ commitId: string;
161
+ replyToId: string | null;
162
+ }
163
+ export interface ReviewCommentPage {
164
+ comments: ReviewComment[];
165
+ nextCursor: string | null;
166
+ }
167
+ export interface ListReviewCommentsInput extends PullRequestRef {
168
+ cursor?: string;
169
+ }
170
+ interface CreateReviewCommentBase extends PullRequestRef {
171
+ body: string;
172
+ }
173
+ export type CreateReviewCommentInput = CreateReviewCommentBase & ({
174
+ replyToId: string;
175
+ commitId?: never;
176
+ path?: never;
177
+ line?: never;
178
+ side?: never;
179
+ startLine?: never;
180
+ startSide?: never;
181
+ } | {
182
+ replyToId?: never;
183
+ commitId: string;
184
+ path: string;
185
+ line: number;
186
+ side: 'left' | 'right';
187
+ startLine?: number;
188
+ startSide?: 'left' | 'right';
189
+ });
190
+ export type UpdateReviewCommentInput = UpdatePullRequestCommentInput;
191
+ export type DeleteReviewCommentInput = DeletePullRequestCommentInput;
192
+ export interface RequestedReviewers {
193
+ users: string[];
194
+ teams: string[];
195
+ }
196
+ export interface UpdateReviewersInput extends PullRequestRef {
197
+ users?: string[];
198
+ teams?: string[];
199
+ }
200
+ /** Fixed repository, pull-request lifecycle, review, comment, and reviewer contract. */
201
+ export interface VersionControl {
202
+ initialize(input: {
203
+ storage: SourceControlStorageHandle;
204
+ }): void;
205
+ registerInstallation(input: {
206
+ orgId: string;
207
+ userId: string;
208
+ installation: InstallationInput;
209
+ }): Promise<SourceControlInstallation>;
210
+ registerRepositories(input: {
211
+ orgId: string;
212
+ installationId: string;
213
+ repositories: RepositoryInput[];
214
+ }): Promise<SourceControlRepository[]>;
215
+ getRepositoryAccess(input: {
216
+ orgId: string;
217
+ repositoryId: string;
218
+ }): Promise<RepositoryAccess>;
219
+ listPullRequests(input: ListPullRequestsInput): Promise<PullRequestPage>;
220
+ getPullRequest(input: PullRequestRef): Promise<PullRequest | null>;
221
+ createPullRequest(input: CreatePullRequestInput): Promise<PullRequest>;
222
+ updatePullRequest(input: UpdatePullRequestInput): Promise<PullRequest>;
223
+ closePullRequest(input: PullRequestRef): Promise<PullRequest>;
224
+ mergePullRequest(input: MergePullRequestInput): Promise<MergePullRequestResult>;
225
+ listComments(input: ListPullRequestCommentsInput): Promise<PullRequestCommentPage>;
226
+ createComment(input: CreatePullRequestCommentInput): Promise<PullRequestComment>;
227
+ updateComment(input: UpdatePullRequestCommentInput): Promise<PullRequestComment>;
228
+ deleteComment(input: DeletePullRequestCommentInput): Promise<void>;
229
+ listReviews(input: ListReviewsInput): Promise<ReviewPage>;
230
+ getReview(input: ReviewRef): Promise<Review | null>;
231
+ createReview(input: CreateReviewInput): Promise<Review>;
232
+ updateReview(input: UpdateReviewInput): Promise<Review>;
233
+ submitReview(input: SubmitReviewInput): Promise<Review>;
234
+ dismissReview(input: DismissReviewInput): Promise<Review>;
235
+ deletePendingReview(input: ReviewRef): Promise<void>;
236
+ listReviewComments(input: ListReviewCommentsInput): Promise<ReviewCommentPage>;
237
+ createReviewComment(input: CreateReviewCommentInput): Promise<ReviewComment>;
238
+ updateReviewComment(input: UpdateReviewCommentInput): Promise<ReviewComment>;
239
+ deleteReviewComment(input: DeleteReviewCommentInput): Promise<void>;
240
+ listRequestedReviewers(input: PullRequestRef): Promise<RequestedReviewers>;
241
+ requestReviewers(input: UpdateReviewersInput): Promise<RequestedReviewers>;
242
+ removeRequestedReviewers(input: UpdateReviewersInput): Promise<RequestedReviewers>;
243
+ }
244
+ export {};
245
+ //# sourceMappingURL=version-control.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"version-control.d.ts","sourceRoot":"","sources":["../../src/capabilities/version-control.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,156 @@
1
+ /**
2
+ * `MastraFactory` — the single entry point to the whole Mastra Software Factory.
3
+ *
4
+ * The consumer's deploy entry constructs deployment-specific config instances
5
+ * (auth adapter, pubsub) and passes them here explicitly. The only provider
6
+ * defaults constructed here are Platform GitHub and Linear integrations when
7
+ * Platform credentials exist and the caller did not provide those integrations.
8
+ *
9
+ * `prepare()` resolves feature readiness, threads every dependency explicitly,
10
+ * assembles the web routes/middleware, and returns the constructor args for
11
+ * `new Mastra(...)`. The literal `export const mastra = new Mastra(...)` must
12
+ * stay in the entry file — the deployer's `checkConfigExport` Babel plugin
13
+ * only marks the config valid when it finds that literal in the entry AST —
14
+ * so the factory produces args instead of the instance. `finalize()` runs the
15
+ * post-construct boot (controller init + workers).
16
+ *
17
+ * Integration readiness is derived from each instance's declared capabilities
18
+ * and the storage domains those capabilities require.
19
+ */
20
+ import type { PubSub } from '@mastra/core/events';
21
+ import type { Mastra } from '@mastra/core/mastra';
22
+ import type { IMastraAuthProvider } from '@mastra/core/server';
23
+ import type { FactoryStorage } from '@mastra/core/storage';
24
+ import type { MastraVector } from '@mastra/core/vector';
25
+ import type { WorkspaceSandbox } from '@mastra/core/workspace';
26
+ import type { FactoryIntegration } from './integrations/base.js';
27
+ import type { GithubIssueTriageInput, GithubIssueTriageResult } from './integrations/github/issue-triage.js';
28
+ import type { FactoryRules } from './rules/types.js';
29
+ /** Constructor args for the `new Mastra(...)` literal in the deploy entry. */
30
+ export type MastraArgs = NonNullable<ConstructorParameters<typeof Mastra>[0]>;
31
+ export interface MastraFactoryConfig {
32
+ /**
33
+ * Auth provider instance — `MastraAuthStudio` (`@mastra/auth-studio`),
34
+ * `MastraAuthWorkos` (`@mastra/auth-workos`), `MastraAuthBetterAuth`
35
+ * (`@mastra/auth-better-auth`), or any custom `MastraAuthProvider`. Whatever
36
+ * instance is passed is the active provider; a passed instance is always
37
+ * honored as-is.
38
+ *
39
+ * Omitted → the factory defaults to `MastraAuthStudio`, proxying auth
40
+ * through the shared Mastra platform API. `MastraAuthStudio` resolves its
41
+ * own env (`MASTRA_SHARED_API_URL`, `MASTRA_ORGANIZATION_ID`,
42
+ * `MASTRA_COOKIE_DOMAIN`).
43
+ *
44
+ * Pass `null` to disable auth entirely (open server, local-dev behavior)
45
+ * without falling back to the default.
46
+ */
47
+ auth?: IMastraAuthProvider | null;
48
+ /**
49
+ * REQUIRED. Factory storage backend powering BOTH agent storage (threads,
50
+ * messages, memory, OM — via `getMastraStorage()`) and the app tables
51
+ * (projects/source-control/audit/intake — via the generic ops surface). Pass a
52
+ * `PgFactoryStorage` (`@mastra/pg`) for deployments or a
53
+ * `LibSQLFactoryStorage` (`@mastra/libsql`) for local dev — one backend,
54
+ * one connection, every feature on.
55
+ */
56
+ storage: FactoryStorage;
57
+ /**
58
+ * Vector store instance for recall search — `PgVector` (`@mastra/pg`) on
59
+ * the same database as `storage`. Omitted → the SDK mount's default vector
60
+ * store resolution applies.
61
+ */
62
+ vector?: MastraVector;
63
+ /**
64
+ * Distributed event bus instance (e.g. `new RedisStreamsPubSub({ url })`).
65
+ * When set, streams/workflows/signals ride it across processes and the
66
+ * controller drops file-based thread locks in favor of pubsub-coordinated
67
+ * leases. Omitted → in-process default.
68
+ */
69
+ pubsub?: PubSub;
70
+ /**
71
+ * Browser-facing origin used to build integration OAuth/install callback
72
+ * URLs and to derive the auth redirect URI. On the platform the SPA is
73
+ * hosted separately, so this MUST be the public API origin.
74
+ * Default: `http://localhost:4111` (the local Factory server, which also
75
+ * serves the UI).
76
+ */
77
+ publicUrl?: string;
78
+ /**
79
+ * Allowed cross-origin SPA origins. The SPA may be served from a separate
80
+ * static host, so credentialed requests must be explicitly allowed.
81
+ */
82
+ allowedOrigins?: string[];
83
+ /** Sandbox configuration. Omitted → repository sandboxes are disabled. */
84
+ sandbox?: MastraFactorySandboxConfig;
85
+ /**
86
+ * Deployment-stable secret for signing integration OAuth `state` values.
87
+ * Omitted → a per-process random secret, which is fine for single-process
88
+ * local development but rejected for integrations that declare
89
+ * `requiresStableStateSigner`.
90
+ */
91
+ stateSecret?: string;
92
+ /**
93
+ * Registered capability providers. The factory registers the pieces each
94
+ * `FactoryIntegration` instance provides — HTTP routes, storage domains,
95
+ * agent/session tools, intake, source control, and diagnostics — into the
96
+ * system. When Platform credentials are configured, missing `github` and
97
+ * `linear` integrations default to their Platform-backed implementations.
98
+ */
99
+ integrations?: FactoryIntegration[];
100
+ /**
101
+ * Authoritative Factory board, tool-result, and GitHub-event rules. Construct
102
+ * with `defaultFactoryRules({ version, overrides })` so deployment policy has
103
+ * an explicit version and exact handler leaves replace rather than compose.
104
+ * Omitted → conservative built-in rules for the current deployment.
105
+ */
106
+ rules?: FactoryRules;
107
+ /**
108
+ * Platform-specific overrides. When the Platform-backed GitHub integration
109
+ * is active, it derives a `runIssueTriage` runner from the mounted
110
+ * controller automatically. An explicit `runIssueTriage` here takes
111
+ * precedence over the controller-derived default.
112
+ */
113
+ platform?: {
114
+ runIssueTriage?: (input: GithubIssueTriageInput) => Promise<GithubIssueTriageResult>;
115
+ };
116
+ }
117
+ export interface MastraFactorySandboxConfig {
118
+ /**
119
+ * Template machine — `RailwaySandbox` (`@mastra/railway`), core
120
+ * `LocalSandbox` (`@mastra/core/workspace`), or any `WorkspaceSandbox` that
121
+ * implements `clone()`. Each project-repository execution environment gets
122
+ * its own sandbox cloned from this machine; the machine itself is never
123
+ * started. `prepare()` fails fast when the instance lacks `clone()`.
124
+ */
125
+ machine: WorkspaceSandbox;
126
+ /**
127
+ * In-sandbox base directory repos check out under (nested `owner/name` per
128
+ * repo). Default: the machine's own `workingDirectory` when it exposes one
129
+ * (core `LocalSandbox` does), else `/workspace`.
130
+ */
131
+ workdir?: string;
132
+ /**
133
+ * Per-replica cap on concurrently provisioned sandboxes. `0`/omitted means
134
+ * unlimited. A lightweight per-process budget, not a cross-replica scheduler.
135
+ */
136
+ maxSandboxes?: number;
137
+ }
138
+ export declare class MastraFactory {
139
+ #private;
140
+ constructor(config: MastraFactoryConfig);
141
+ /**
142
+ * Resolve feature readiness, wire every dependency explicitly, and assemble
143
+ * everything needed to construct the server-owned Mastra. Returns the args
144
+ * for the `new Mastra(...)` literal that must live in the entry file.
145
+ */
146
+ prepare(): Promise<MastraArgs>;
147
+ /**
148
+ * Post-construct boot: initialize the controller (which inherits the
149
+ * constructed Mastra's storage) and start its workers. Call AFTER the entry
150
+ * has run `new Mastra(prepare()'s args)`.
151
+ */
152
+ finalize(): Promise<void>;
153
+ /** Stop Factory-owned background dispatch before the host process shuts down. */
154
+ shutdown(): Promise<void>;
155
+ }
156
+ //# sourceMappingURL=factory.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAGlD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAS/D,OAAO,KAAK,EAAE,kBAAkB,EAAgD,MAAM,wBAAwB,CAAC;AAE/G,OAAO,KAAK,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAmB7G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA0BrD,8EAA8E;AAC9E,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,qBAAqB,CAAC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE9E,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;;;;;;;OAcG;IACH,IAAI,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAClC;;;;;;;OAOG;IACH,OAAO,EAAE,cAAc,CAAC;IACxB;;;;OAIG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,0EAA0E;IAC1E,OAAO,CAAC,EAAE,0BAA0B,CAAC;IACrC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACpC;;;;;OAKG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;IAErB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE;QACT,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAC;KACtF,CAAC;CACH;AAED,MAAM,WAAW,0BAA0B;IACzC;;;;;;OAMG;IACH,OAAO,EAAE,gBAAgB,CAAC;IAC1B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAwFD,qBAAa,aAAa;;gBAOZ,MAAM,EAAE,mBAAmB;IAWvC;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;IAyiBpC;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAY/B,iFAAiF;IAC3E,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAGhC"}