@mastra/factory 0.28.0-alpha.0 → 0.28.0-alpha.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +210 -42
- package/dist/boards/board-events.d.ts +34 -0
- package/dist/boards/board-events.d.ts.map +1 -0
- package/dist/boards/board-events.js +50 -0
- package/dist/boards/board-events.js.map +1 -0
- package/dist/boards/board-writes.d.ts +86 -0
- package/dist/boards/board-writes.d.ts.map +1 -0
- package/dist/boards/board-writes.js +252 -0
- package/dist/boards/board-writes.js.map +1 -0
- package/dist/boards/define-board.d.ts +16 -5
- package/dist/boards/define-board.d.ts.map +1 -1
- package/dist/boards/define-board.js +30 -8
- package/dist/boards/define-board.js.map +1 -1
- package/dist/boards/intake-routing.d.ts +30 -6
- package/dist/boards/intake-routing.d.ts.map +1 -1
- package/dist/boards/intake-routing.js +43 -5
- package/dist/boards/intake-routing.js.map +1 -1
- package/dist/boards/legacy-plan-role.d.ts.map +1 -1
- package/dist/boards/legacy-plan-role.js +8 -4
- package/dist/boards/legacy-plan-role.js.map +1 -1
- package/dist/boards/phase-automation.d.ts.map +1 -1
- package/dist/boards/phase-automation.js +7 -2
- package/dist/boards/phase-automation.js.map +1 -1
- package/dist/boards/project-boards.d.ts +18 -7
- package/dist/boards/project-boards.d.ts.map +1 -1
- package/dist/boards/project-boards.js +78 -14
- package/dist/boards/project-boards.js.map +1 -1
- package/dist/boards/stored-board.d.ts +59 -1
- package/dist/boards/stored-board.d.ts.map +1 -1
- package/dist/boards/stored-board.js +219 -7
- package/dist/boards/stored-board.js.map +1 -1
- package/dist/factory.d.ts +63 -9
- package/dist/factory.d.ts.map +1 -1
- package/dist/factory.js +187 -22
- package/dist/factory.js.map +1 -1
- package/dist/index.d.ts +3 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +4 -3
- package/dist/integrations/base.d.ts +6 -0
- package/dist/integrations/base.d.ts.map +1 -1
- package/dist/integrations/github/acceptance-labels.d.ts +4 -0
- package/dist/integrations/github/acceptance-labels.d.ts.map +1 -1
- package/dist/integrations/github/acceptance-labels.js +1 -1
- package/dist/integrations/github/acceptance-labels.js.map +1 -1
- package/dist/integrations/github/default-rules.d.ts +2 -9
- package/dist/integrations/github/default-rules.d.ts.map +1 -1
- package/dist/integrations/github/default-rules.js +7 -6
- package/dist/integrations/github/default-rules.js.map +1 -1
- package/dist/integrations/github/issue-reconciler.d.ts.map +1 -1
- package/dist/integrations/github/issue-reconciler.js +17 -1
- package/dist/integrations/github/issue-reconciler.js.map +1 -1
- package/dist/integrations/github/review-status-comment.d.ts +61 -0
- package/dist/integrations/github/review-status-comment.d.ts.map +1 -0
- package/dist/integrations/github/review-status-comment.js +217 -0
- package/dist/integrations/github/review-status-comment.js.map +1 -0
- package/dist/integrations/github/review-status-reporter.d.ts +42 -0
- package/dist/integrations/github/review-status-reporter.d.ts.map +1 -0
- package/dist/integrations/github/review-status-reporter.js +100 -0
- package/dist/integrations/github/review-status-reporter.js.map +1 -0
- package/dist/integrations/github/review-status.d.ts +28 -0
- package/dist/integrations/github/review-status.d.ts.map +1 -0
- package/dist/integrations/github/review-status.js +95 -0
- package/dist/integrations/github/review-status.js.map +1 -0
- package/dist/integrations/github/routes.d.ts.map +1 -1
- package/dist/integrations/github/routes.js +2 -5
- package/dist/integrations/github/routes.js.map +1 -1
- package/dist/integrations/github/rules.d.ts +13 -1
- package/dist/integrations/github/rules.d.ts.map +1 -1
- package/dist/integrations/github/rules.js +77 -6
- package/dist/integrations/github/rules.js.map +1 -1
- package/dist/integrations/gitlab/default-rules.d.ts +24 -9
- package/dist/integrations/gitlab/default-rules.d.ts.map +1 -1
- package/dist/integrations/gitlab/default-rules.js +4 -4
- package/dist/integrations/gitlab/default-rules.js.map +1 -1
- package/dist/integrations/gitlab/merge-request-reconciler.js +1 -1
- package/dist/integrations/gitlab/routes.d.ts.map +1 -1
- package/dist/integrations/gitlab/routes.js +1 -3
- package/dist/integrations/gitlab/routes.js.map +1 -1
- package/dist/integrations/gitlab/rules.d.ts +16 -0
- package/dist/integrations/gitlab/rules.d.ts.map +1 -1
- package/dist/integrations/gitlab/rules.js +69 -4
- package/dist/integrations/gitlab/rules.js.map +1 -1
- package/dist/integrations/incidentio/default-rules.d.ts +1 -9
- package/dist/integrations/incidentio/default-rules.d.ts.map +1 -1
- package/dist/integrations/incidentio/default-rules.js +3 -4
- package/dist/integrations/incidentio/default-rules.js.map +1 -1
- package/dist/integrations/incidentio/routes.d.ts.map +1 -1
- package/dist/integrations/incidentio/routes.js +1 -4
- package/dist/integrations/incidentio/routes.js.map +1 -1
- package/dist/integrations/incidentio/rules.d.ts +7 -0
- package/dist/integrations/incidentio/rules.d.ts.map +1 -1
- package/dist/integrations/incidentio/rules.js +35 -3
- package/dist/integrations/incidentio/rules.js.map +1 -1
- package/dist/integrations/jira/default-rules.d.ts +1 -9
- package/dist/integrations/jira/default-rules.d.ts.map +1 -1
- package/dist/integrations/jira/default-rules.js +3 -4
- package/dist/integrations/jira/default-rules.js.map +1 -1
- package/dist/integrations/jira/routes.d.ts.map +1 -1
- package/dist/integrations/jira/routes.js +1 -4
- package/dist/integrations/jira/routes.js.map +1 -1
- package/dist/integrations/jira/rules.d.ts +7 -0
- package/dist/integrations/jira/rules.d.ts.map +1 -1
- package/dist/integrations/jira/rules.js +35 -3
- package/dist/integrations/jira/rules.js.map +1 -1
- package/dist/integrations/linear/default-rules.d.ts +1 -9
- package/dist/integrations/linear/default-rules.d.ts.map +1 -1
- package/dist/integrations/linear/default-rules.js +3 -4
- package/dist/integrations/linear/default-rules.js.map +1 -1
- package/dist/integrations/linear/routes.d.ts.map +1 -1
- package/dist/integrations/linear/routes.js +1 -4
- package/dist/integrations/linear/routes.js.map +1 -1
- package/dist/integrations/linear/rules.d.ts +7 -0
- package/dist/integrations/linear/rules.d.ts.map +1 -1
- package/dist/integrations/linear/rules.js +35 -3
- package/dist/integrations/linear/rules.js.map +1 -1
- package/dist/integrations/platform/connect/routes.d.ts +7 -1
- package/dist/integrations/platform/connect/routes.d.ts.map +1 -1
- package/dist/integrations/platform/connect/routes.js +42 -5
- package/dist/integrations/platform/connect/routes.js.map +1 -1
- package/dist/integrations/platform/connect/session-tools.d.ts +7 -0
- package/dist/integrations/platform/connect/session-tools.d.ts.map +1 -0
- package/dist/integrations/platform/connect/session-tools.js +30 -0
- package/dist/integrations/platform/connect/session-tools.js.map +1 -0
- package/dist/integrations/platform/github/integration.d.ts.map +1 -1
- package/dist/integrations/platform/github/integration.js +1 -3
- package/dist/integrations/platform/github/integration.js.map +1 -1
- package/dist/integrations/platform/jira/routes.d.ts.map +1 -1
- package/dist/integrations/platform/jira/routes.js +1 -4
- package/dist/integrations/platform/jira/routes.js.map +1 -1
- package/dist/integrations/platform/linear/event-worker.d.ts +1 -1
- package/dist/integrations/platform/linear/event-worker.d.ts.map +1 -1
- package/dist/integrations/platform/linear/event-worker.js +9 -0
- package/dist/integrations/platform/linear/event-worker.js.map +1 -1
- package/dist/integrations/platform/linear/integration.d.ts.map +1 -1
- package/dist/integrations/platform/linear/integration.js +1 -3
- package/dist/integrations/platform/linear/integration.js.map +1 -1
- package/dist/integrations/slack/channel-reply-processor.d.ts +2 -0
- package/dist/integrations/slack/channel-reply-processor.d.ts.map +1 -1
- package/dist/integrations/slack/channel-reply-processor.js +6 -1
- package/dist/integrations/slack/channel-reply-processor.js.map +1 -1
- package/dist/integrations/slack/connect-route.d.ts.map +1 -1
- package/dist/integrations/slack/connect-route.js +1 -1
- package/dist/integrations/slack/connect-route.js.map +1 -1
- package/dist/integrations/slack/integration.d.ts.map +1 -1
- package/dist/integrations/slack/integration.js +2 -0
- package/dist/integrations/slack/integration.js.map +1 -1
- package/dist/integrations/slack/slack.d.ts +12 -10
- package/dist/integrations/slack/slack.d.ts.map +1 -1
- package/dist/integrations/slack/slack.js +110 -43
- package/dist/integrations/slack/slack.js.map +1 -1
- package/dist/integrations/slack/voice-clips.d.ts +32 -0
- package/dist/integrations/slack/voice-clips.d.ts.map +1 -0
- package/dist/integrations/slack/voice-clips.js +201 -0
- package/dist/integrations/slack/voice-clips.js.map +1 -0
- package/dist/integrations/workos/integration.d.ts.map +1 -1
- package/dist/integrations/workos/integration.js +1 -3
- package/dist/integrations/workos/integration.js.map +1 -1
- package/dist/mcp/routes.js +1 -1
- package/dist/packages/_internals/workspace/dist/index.js +1 -1
- package/dist/routes/attention-activity.js +1 -1
- package/dist/routes/attention-providers.js +1 -1
- package/dist/routes/automation-runs.d.ts.map +1 -1
- package/dist/routes/automation-runs.js +1 -4
- package/dist/routes/automation-runs.js.map +1 -1
- package/dist/routes/boards.d.ts +8 -6
- package/dist/routes/boards.d.ts.map +1 -1
- package/dist/routes/boards.js +73 -143
- package/dist/routes/boards.js.map +1 -1
- package/dist/routes/config.d.ts.map +1 -1
- package/dist/routes/config.js +3 -8
- package/dist/routes/config.js.map +1 -1
- package/dist/routes/contracts.d.ts +132 -0
- package/dist/routes/contracts.d.ts.map +1 -1
- package/dist/routes/contracts.js +77 -29
- package/dist/routes/contracts.js.map +1 -1
- package/dist/routes/fs.d.ts.map +1 -1
- package/dist/routes/fs.js +1 -4
- package/dist/routes/fs.js.map +1 -1
- package/dist/routes/intake-routes.d.ts.map +1 -1
- package/dist/routes/intake-routes.js +19 -12
- package/dist/routes/intake-routes.js.map +1 -1
- package/dist/routes/intake.d.ts.map +1 -1
- package/dist/routes/intake.js +3 -5
- package/dist/routes/intake.js.map +1 -1
- package/dist/routes/knowledge.d.ts.map +1 -1
- package/dist/routes/knowledge.js +1 -4
- package/dist/routes/knowledge.js.map +1 -1
- package/dist/routes/oauth.d.ts.map +1 -1
- package/dist/routes/oauth.js +1 -4
- package/dist/routes/oauth.js.map +1 -1
- package/dist/routes/projects.d.ts +3 -0
- package/dist/routes/projects.d.ts.map +1 -1
- package/dist/routes/projects.js +7 -4
- package/dist/routes/projects.js.map +1 -1
- package/dist/routes/provider-credentials.d.ts.map +1 -1
- package/dist/routes/provider-credentials.js +6 -0
- package/dist/routes/provider-credentials.js.map +1 -1
- package/dist/routes/route.d.ts +2 -0
- package/dist/routes/route.d.ts.map +1 -1
- package/dist/routes/route.js +5 -1
- package/dist/routes/route.js.map +1 -1
- package/dist/routes/skills.d.ts.map +1 -1
- package/dist/routes/skills.js +1 -4
- package/dist/routes/skills.js.map +1 -1
- package/dist/routes/source-control-sessions.d.ts.map +1 -1
- package/dist/routes/source-control-sessions.js +1 -3
- package/dist/routes/source-control-sessions.js.map +1 -1
- package/dist/routes/source-control-settings.d.ts.map +1 -1
- package/dist/routes/source-control-settings.js +3 -2
- package/dist/routes/source-control-settings.js.map +1 -1
- package/dist/routes/surface.d.ts +3 -1
- package/dist/routes/surface.d.ts.map +1 -1
- package/dist/routes/surface.js +11 -1
- package/dist/routes/surface.js.map +1 -1
- package/dist/routes/voice.d.ts +48 -0
- package/dist/routes/voice.d.ts.map +1 -0
- package/dist/routes/voice.js +248 -0
- package/dist/routes/voice.js.map +1 -0
- package/dist/routes/work-items.d.ts.map +1 -1
- package/dist/routes/work-items.js +1 -4
- package/dist/routes/work-items.js.map +1 -1
- package/dist/rules/decision-applicability.js +1 -1
- package/dist/rules/dispatcher.d.ts +28 -0
- package/dist/rules/dispatcher.d.ts.map +1 -1
- package/dist/rules/dispatcher.js +391 -93
- package/dist/rules/dispatcher.js.map +1 -1
- package/dist/rules/event-rules.d.ts +40 -1
- package/dist/rules/event-rules.d.ts.map +1 -1
- package/dist/rules/event-rules.js +59 -1
- package/dist/rules/event-rules.js.map +1 -1
- package/dist/rules/processor.js +1 -1
- package/dist/rules/processor.js.map +1 -1
- package/dist/rules/transition-service.d.ts +9 -0
- package/dist/rules/transition-service.d.ts.map +1 -1
- package/dist/rules/transition-service.js +4 -2
- package/dist/rules/transition-service.js.map +1 -1
- package/dist/rules/types.d.ts +54 -3
- package/dist/rules/types.d.ts.map +1 -1
- package/dist/rules/types.js +2 -0
- package/dist/rules/types.js.map +1 -1
- package/dist/rules/validation.d.ts.map +1 -1
- package/dist/rules/validation.js +57 -2
- package/dist/rules/validation.js.map +1 -1
- package/dist/session/credential-policy.d.ts +2 -2
- package/dist/session/credential-policy.d.ts.map +1 -1
- package/dist/session/credential-policy.js +3 -3
- package/dist/session/credential-policy.js.map +1 -1
- package/dist/session/default-model-hydration.d.ts +2 -2
- package/dist/session/default-model-hydration.d.ts.map +1 -1
- package/dist/session/default-model-hydration.js +4 -4
- package/dist/session/default-model-hydration.js.map +1 -1
- package/dist/session/session-threads.d.ts +8 -0
- package/dist/session/session-threads.d.ts.map +1 -1
- package/dist/session/session-threads.js +11 -1
- package/dist/session/session-threads.js.map +1 -1
- package/dist/skills/catalog.js +1 -1
- package/dist/storage/domains/audit/actions.d.ts +1 -1
- package/dist/storage/domains/audit/actions.d.ts.map +1 -1
- package/dist/storage/domains/audit/actions.js +2 -1
- package/dist/storage/domains/audit/actions.js.map +1 -1
- package/dist/storage/domains/audit/domain.d.ts.map +1 -1
- package/dist/storage/domains/audit/domain.js +1 -3
- package/dist/storage/domains/audit/domain.js.map +1 -1
- package/dist/storage/domains/boards/base.d.ts +32 -1
- package/dist/storage/domains/boards/base.d.ts.map +1 -1
- package/dist/storage/domains/boards/base.js +155 -8
- package/dist/storage/domains/boards/base.js.map +1 -1
- package/dist/storage/domains/boards/schemas.d.ts.map +1 -1
- package/dist/storage/domains/boards/schemas.js +13 -1
- package/dist/storage/domains/boards/schemas.js.map +1 -1
- package/dist/storage/domains/comments/routes.d.ts.map +1 -1
- package/dist/storage/domains/comments/routes.js +1 -3
- package/dist/storage/domains/comments/routes.js.map +1 -1
- package/dist/storage/domains/memory-settings/base.d.ts +0 -8
- package/dist/storage/domains/memory-settings/base.d.ts.map +1 -1
- package/dist/storage/domains/memory-settings/base.js +1 -11
- package/dist/storage/domains/memory-settings/base.js.map +1 -1
- package/dist/storage/domains/projects/base.d.ts +6 -0
- package/dist/storage/domains/projects/base.d.ts.map +1 -1
- package/dist/storage/domains/projects/base.js +9 -1
- package/dist/storage/domains/projects/base.js.map +1 -1
- package/dist/storage/domains/voice-settings/base.d.ts +31 -0
- package/dist/storage/domains/voice-settings/base.d.ts.map +1 -0
- package/dist/storage/domains/voice-settings/base.js +81 -0
- package/dist/storage/domains/voice-settings/base.js.map +1 -0
- package/dist/storage/domains/work-items/base.d.ts +31 -2
- package/dist/storage/domains/work-items/base.d.ts.map +1 -1
- package/dist/storage/domains/work-items/base.js +197 -44
- package/dist/storage/domains/work-items/base.js.map +1 -1
- package/dist/storage/domains/work-items/cards.d.ts +6 -1
- package/dist/storage/domains/work-items/cards.d.ts.map +1 -1
- package/dist/storage/domains/work-items/cards.js +54 -4
- package/dist/storage/domains/work-items/cards.js.map +1 -1
- package/dist/storage/domains/work-items/work-item-schema.d.ts +2 -0
- package/dist/storage/domains/work-items/work-item-schema.d.ts.map +1 -1
- package/dist/storage/domains/work-items/work-item-schema.js +24 -1
- package/dist/storage/domains/work-items/work-item-schema.js.map +1 -1
- package/dist/timing.d.ts +1 -0
- package/dist/timing.d.ts.map +1 -1
- package/dist/timing.js +1 -1
- package/dist/timing.js.map +1 -1
- package/dist/tools/read-tools.d.ts +2 -2
- package/dist/tools/read-tools.d.ts.map +1 -1
- package/dist/tools/read-tools.js +7 -6
- package/dist/tools/read-tools.js.map +1 -1
- package/dist/tools/session-tools.d.ts +1 -1
- package/dist/tools/session-tools.d.ts.map +1 -1
- package/dist/tools/session-tools.js.map +1 -1
- package/dist/tools/sessions-state-processor.d.ts +1 -1
- package/dist/tools/sessions-state-processor.d.ts.map +1 -1
- package/dist/tools/sessions-state-processor.js +9 -2
- package/dist/tools/sessions-state-processor.js.map +1 -1
- package/dist/tools/work-item-tools.js +2 -2
- package/dist/voice/rate-limit.d.ts +13 -0
- package/dist/voice/rate-limit.d.ts.map +1 -0
- package/dist/voice/rate-limit.js +36 -0
- package/dist/voice/rate-limit.js.map +1 -0
- package/dist/voice/realtime.d.ts +13 -0
- package/dist/voice/realtime.d.ts.map +1 -0
- package/dist/voice/realtime.js +56 -0
- package/dist/voice/realtime.js.map +1 -0
- package/dist/voice/transcription.d.ts +51 -0
- package/dist/voice/transcription.d.ts.map +1 -0
- package/dist/voice/transcription.js +112 -0
- package/dist/voice/transcription.js.map +1 -0
- package/dist/work-items/split-backfill.d.ts +13 -0
- package/dist/work-items/split-backfill.d.ts.map +1 -0
- package/dist/work-items/split-backfill.js +32 -0
- package/dist/work-items/split-backfill.js.map +1 -0
- package/dist/work-items/split-migration.d.ts +39 -2
- package/dist/work-items/split-migration.d.ts.map +1 -1
- package/dist/work-items/split-migration.js +170 -62
- package/dist/work-items/split-migration.js.map +1 -1
- package/dist/workspace.js +2 -2
- package/package.json +9 -8
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"stored-board.js","names":[],"sources":["../../src/boards/stored-board.ts"],"sourcesContent":["import { z } from 'zod';\n\nimport { cardRuleGroupSchema } from '../rules/rule-group.js';\nimport type { StoredBoardInput, StoredPhaseInput } from '../storage/domains/boards/base.js';\nimport { BoardDefinitionError, compileBoardDefinition } from './define-board.js';\nimport type { BoardPhase, BoardPhaseDefinition } from './define-board.js';\nimport type { InstalledBoard } from './registry.js';\n\nconst storedRunnerSchema = z\n .object({\n skill: z.string().optional(),\n context: z.string().optional(),\n instructions: z.string().optional(),\n })\n .strict();\n\nconst storedExitToolSchema = z\n .object({\n id: z.string(),\n autoApprove: z.boolean().optional(),\n autoApproveWhen: cardRuleGroupSchema.optional(),\n })\n .strict();\n\nexport const storedPhaseInputSchema = z\n .object({\n key: z.string(),\n name: z.string(),\n description: z.string().nullish(),\n kind: z.enum(['resting', 'working', 'terminal']),\n runner: storedRunnerSchema.nullish(),\n nextPhases: z.array(z.string()).nullish(),\n autoStart: z.boolean().optional(),\n autoStartWhen: cardRuleGroupSchema.nullish(),\n exitTool: storedExitToolSchema.nullish(),\n })\n .strict();\n\nfunction storedBoardFields() {\n return {\n name: z.string(),\n description: z.string().nullish(),\n phases: z.array(storedPhaseInputSchema).min(1, 'A board must define at least one phase.'),\n };\n}\n\n/**\n * A board's editable fields without its key, the shape of a replace. Only the shape: the board\n * rules run once the key is known, through {@link storedBoardInputSchema}.\n */\nexport const storedBoardDefinitionSchema = z.object(storedBoardFields()).strict();\n\n/**\n * A board as the API accepts it. Beyond the shape, it holds every rule `defineBoard()` enforces\n * (identifiers, lengths, phase kinds, runners, exit tools, conditions, targets), reported with\n * the same messages.\n */\nexport const storedBoardInputSchema = z\n .object({ key: z.string(), ...storedBoardFields() })\n .strict()\n .superRefine((input, context) => {\n try {\n compileStoredBoard(input);\n } catch (error) {\n if (!(error instanceof BoardDefinitionError)) throw error;\n context.addIssue({ code: 'custom', message: error.message });\n }\n });\n\n/** Phases a stored phase may move to: unset on a resting or working phase means every other phase. */\nfunction storedNextPhases(phase: StoredPhaseInput, phases: readonly StoredPhaseInput[]): string[] {\n if (phase.nextPhases != null) return phase.nextPhases;\n if (phase.kind === 'terminal') return [];\n return phases.filter(other => other.key !== phase.key).map(other => other.key);\n}\n\n/**\n * Compiles a stored board through the same validator as `defineBoard()`. Its first phase is where\n * cards start.\n */\nexport function compileStoredBoard(board: StoredBoardInput): InstalledBoard {\n const [initial] = board.phases;\n if (!initial) throw new BoardDefinitionError('A board must define at least one phase.');\n const phases: Record<string, BoardPhaseDefinition<string>> = {};\n for (const phase of board.phases) {\n if (Object.hasOwn(phases, phase.key)) {\n throw new BoardDefinitionError(`Board \"${board.key}\" declares phase \"${phase.key}\" more than once.`);\n }\n const runner = phase.runner ? withoutUndefined(phase.runner) : undefined;\n const exitTool = phase.exitTool ? withoutUndefined(phase.exitTool) : undefined;\n phases[phase.key] = withoutUndefined({\n name: phase.name,\n description: phase.description ?? undefined,\n kind: phase.kind,\n nextPhases: storedNextPhases(phase, board.phases),\n runner,\n autoStart: phase.autoStart ? true : undefined,\n autoStartWhen: phase.autoStartWhen ?? undefined,\n exitTool,\n }) as BoardPhaseDefinition<string>;\n }\n return compileBoardDefinition({\n id: board.key,\n name: board.name,\n ...(board.description != null ? { description: board.description } : {}),\n initialPhase: initial.key,\n phases,\n });\n}\n\n/**\n * A board's storable definition, in the shape the boards API reads and writes. The initial phase\n * comes first and every phase's resolved `nextPhases` is written out.\n */\nexport function boardDefinitionOf(board: InstalledBoard): StoredBoardInput {\n const order = [board.initialPhase, ...Object.keys(board.phases).filter(key => key !== board.initialPhase)];\n return {\n key: board.id,\n name: board.name,\n ...(board.description !== undefined ? { description: board.description } : {}),\n phases: order.map(key => storedPhase(key, board.phases[key]!)),\n };\n}\n\nfunction storedPhase(key: string, phase: BoardPhase<string>): StoredPhaseInput {\n return withoutUndefined({\n key,\n name: phase.name,\n description: phase.description,\n kind: phase.kind,\n nextPhases: [...phase.nextPhases],\n ...(phase.kind === 'working'\n ? {\n runner: withoutUndefined({\n skill: phase.runner.skill,\n context: phase.runner.context,\n instructions: phase.runner.instructions,\n }),\n autoStart: phase.autoStart ? true : undefined,\n autoStartWhen: phase.autoStartWhen,\n exitTool: phase.exitTool\n ? withoutUndefined({\n id: phase.exitTool.id,\n autoApprove: phase.exitTool.autoApprove,\n autoApproveWhen: phase.exitTool.autoApproveWhen,\n })\n : undefined,\n }\n : {}),\n });\n}\n\nfunction withoutUndefined<T extends object>(value: T): T {\n return Object.fromEntries(Object.entries(value).filter(([, entry]) => entry !== undefined)) as T;\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"stored-board.js","names":[],"sources":["../../src/boards/stored-board.ts"],"sourcesContent":["import { z } from 'zod';\n\nimport { cardRuleGroupSchema } from '../rules/rule-group.js';\nimport type { StoredBoardInput, StoredPhaseInput } from '../storage/domains/boards/base.js';\nimport { BoardDefinitionError, compileBoardDefinition, declarationOf, DEFAULT_PHASE_CONTEXT } from './define-board.js';\nimport type { AnyBoardConfig, BoardPhase, BoardPhaseDefinition } from './define-board.js';\nimport type { InstalledBoard } from './registry.js';\n\nconst storedRunnerSchema = z\n .object({\n skill: z.string().optional(),\n context: z.string().optional(),\n instructions: z.string().optional(),\n })\n .strict();\n\nconst storedExitToolSchema = z\n .object({\n id: z.string(),\n autoApprove: z.boolean().optional(),\n autoApproveWhen: cardRuleGroupSchema.optional(),\n })\n .strict();\n\nexport const storedPhaseInputSchema = z\n .object({\n key: z.string(),\n name: z.string(),\n description: z.string().nullish(),\n kind: z.enum(['resting', 'working', 'terminal']),\n runner: storedRunnerSchema.nullish(),\n nextPhases: z.array(z.string()).nullish(),\n autoStart: z.boolean().optional(),\n autoStartWhen: cardRuleGroupSchema.nullish(),\n exitTool: storedExitToolSchema.nullish(),\n })\n .strict();\n\nfunction storedBoardFields() {\n return {\n name: z.string(),\n description: z.string().nullish(),\n phases: z.array(storedPhaseInputSchema).min(1, 'A board must define at least one phase.'),\n };\n}\n\n/**\n * A board's editable fields without its key, the shape of a replace. Only the shape: the board\n * rules run once the key is known, through {@link storedBoardInputSchema}.\n */\nexport const storedBoardDefinitionSchema = z.object(storedBoardFields()).strict();\n\n/**\n * A board as the API accepts it. Beyond the shape, it holds every rule `defineBoard()` enforces\n * (identifiers, lengths, phase kinds, runners, exit tools, conditions, targets), reported with\n * the same messages.\n */\nexport const storedBoardInputSchema = z\n .object({ key: z.string(), ...storedBoardFields() })\n .strict()\n .superRefine((input, context) => {\n try {\n compileStoredBoard(input);\n } catch (error) {\n if (!(error instanceof BoardDefinitionError)) throw error;\n context.addIssue({ code: 'custom', message: error.message });\n }\n });\n\n/** Phases a stored phase may move to: unset on a resting or working phase means every other phase. */\nfunction storedNextPhases(phase: StoredPhaseInput, phases: readonly StoredPhaseInput[]): string[] {\n if (phase.nextPhases != null) return phase.nextPhases;\n if (phase.kind === 'terminal') return [];\n return phases.filter(other => other.key !== phase.key).map(other => other.key);\n}\n\n/**\n * Compiles a stored board through the same validator as `defineBoard()`. Its first phase is where\n * cards start.\n *\n * With `code`, the board is a project's edit of that code board: its fields come from the stored\n * definition and its behaviour from the code declaration, by phase key (`onEnter`, `onExit`,\n * `outcomes`) and for the board (`tools`, `events`, `sourceClosed`, `transitionPolicy`). The board\n * is rebuilt from the declaration, so the stored runner reaches the declared handlers. An edit code\n * behaviour can't honour ({@link codeBehaviourConflicts}) is refused.\n */\nexport function compileStoredBoard(board: StoredBoardInput, code?: InstalledBoard): InstalledBoard {\n if (!code) return compileBoardDefinition(storedBoardConfig(board));\n const conflicts = codeBehaviourConflicts(board, code);\n if (conflicts.length > 0) throw new BoardDefinitionError(conflicts.join(' '));\n const declaration = codeDeclaration(code);\n const phases: Record<string, PhaseBehaviour> = {};\n for (const key of Object.keys(declaration.phases)) {\n const { outcomes, onEnter, onExit } = declaration.phases[key]!;\n phases[key] = { outcomes, onEnter, onExit };\n }\n return compileBoardDefinition(\n storedBoardConfig(board, {\n phases,\n tools: declaration.tools,\n events: declaration.events,\n transitionPolicy: declaration.transitionPolicy,\n sourceClosed: declaration.sourceClosed,\n }),\n code,\n );\n}\n\n/** A board served from a stored row, and what of its code board's behaviour it runs without. */\ninterface MergedStoredBoard {\n board: InstalledBoard;\n /** One per piece of code behaviour the row can't run with; empty when it runs with all of it. */\n problems: string[];\n}\n\n/**\n * Serves a stored row of a code board's key with the code behaviour that still fits it. Unlike\n * {@link compileStoredBoard}, nothing is refused: a row that fell out of step with its code (an\n * edit from before a release added a phase or a code move, a row older than editable code boards)\n * still runs as stored.\n *\n * - A phase's `onEnter`, `onExit` and `outcomes` attach only when the row keeps the phase in the\n * shape they depend on: the same kind and, on phases with code handlers, the same runner context\n * and skill, the declared exit tool and no other. Outcomes whose target the row lacks or doesn't\n * allow are dropped.\n * - The board's `tools` always attach: they hold the exit-tool approval that keeps anyone but a\n * person from moving a card past an unapproved exit tool. If the row lacks a code phase, the\n * moves they make to it are refused, and that is reported.\n * - The board's `events` and `transitionPolicy` attach only when the row has every code phase,\n * since their handlers may move cards to any of them; `sourceClosed` when both of its phases are\n * stored and terminal.\n * - A move code makes that the row's `nextPhases` don't allow is reported; code making it is refused.\n * - If the board still fails to compile with that behaviour, it runs without any.\n *\n * The result links to `code` as its code board either way. Throws only when the row itself is\n * invalid.\n */\nexport function mergeCodeBehaviour(row: StoredBoardInput, code: InstalledBoard): MergedStoredBoard {\n const declaration = codeDeclaration(code);\n const stored = new Map(row.phases.map(phase => [phase.key, phase]));\n const problems: string[] = [];\n const phases: Record<string, PhaseBehaviour> = {};\n for (const [key, phase] of Object.entries(code.phases) as [string, BoardPhase<string>][]) {\n const declared = declaration.phases[key];\n const outcomes = Object.entries(declared?.outcomes ?? {});\n const edited = stored.get(key);\n const conflicts = edited ? phaseShapeConflicts(key, phase, declared, edited) : [];\n if (edited && edited.kind === phase.kind) {\n // A move code makes that the row doesn't allow is refused when code makes it.\n const allowed = storedNextPhases(edited, row.phases);\n const outcomeTargets = new Set(outcomes.map(([, target]) => target));\n for (const target of phase.nextPhases) {\n if (stored.has(target) && !allowed.includes(target) && !outcomeTargets.has(target)) {\n problems.push(\n `Board \"${row.key}\" doesn't let phase \"${key}\" move cards to \"${target}\", so Factory's code can't make that move.`,\n );\n }\n }\n }\n if (!hasHandlers(declared) && outcomes.length === 0) continue;\n if (!edited) {\n problems.push(`Phase \"${key}\" isn't on stored board \"${row.key}\", so its code behaviour doesn't run.`);\n continue;\n }\n if (conflicts.length > 0) {\n problems.push(...conflicts.map(conflict => `Phase \"${key}\" runs without its code behaviour: ${conflict}`));\n continue;\n }\n const allowed = storedNextPhases(edited, row.phases);\n const kept: Record<string, string> = {};\n for (const [outcome, target] of outcomes) {\n if (!stored.has(target)) {\n problems.push(`Phase \"${key}\" runs without its code outcome \"${outcome}\": phase \"${target}\" isn't stored.`);\n } else if (!allowed.includes(target)) {\n problems.push(\n `Phase \"${key}\" runs without its code outcome \"${outcome}\": the board doesn't let it move cards to \"${target}\".`,\n );\n } else kept[outcome] = target;\n }\n phases[key] = {\n onEnter: declared?.onEnter,\n onExit: declared?.onExit,\n outcomes: Object.keys(kept).length > 0 ? kept : undefined,\n };\n }\n\n const board: BoardBehaviour = { phases };\n const missing = Object.keys(code.phases).filter(key => !stored.has(key));\n const unfit = missing.length > 0 ? missingPhases(missing) : undefined;\n const tools = Object.keys(declaration.tools ?? {});\n if (tools.length > 0) {\n board.tools = declaration.tools;\n if (unfit) {\n problems.push(\n `Board \"${row.key}\" keeps its code tool rules (${tools.join(', ')}), but can't move cards where they lead: ${unfit}`,\n );\n }\n }\n const events = Object.keys(declaration.events ?? {});\n if (events.length > 0) {\n if (unfit) problems.push(`Board \"${row.key}\" runs without its code event rules (${events.join(', ')}): ${unfit}`);\n else board.events = declaration.events;\n }\n if (declaration.transitionPolicy) {\n if (unfit) problems.push(`Board \"${row.key}\" runs without its code transition policy: ${unfit}`);\n else board.transitionPolicy = declaration.transitionPolicy;\n }\n const sourceClosed = declaration.sourceClosed;\n if (sourceClosed) {\n const closed = [sourceClosed.completed, sourceClosed.canceled];\n const closedMissing = closed.filter(key => !stored.has(key));\n const closedOpen = closed.filter(key => stored.has(key) && stored.get(key)!.kind !== 'terminal');\n if (closedMissing.length > 0) {\n problems.push(`Board \"${row.key}\" doesn't move cards when their source closes: ${missingPhases(closedMissing)}`);\n } else if (closedOpen.length > 0) {\n problems.push(\n `Board \"${row.key}\" doesn't move cards when their source closes: ${\n closedOpen.length === 1\n ? `phase \"${closedOpen[0]}\" isn't terminal.`\n : `phases ${closedOpen.map(key => `\"${key}\"`).join(', ')} aren't terminal.`\n }`,\n );\n } else board.sourceClosed = sourceClosed;\n }\n\n try {\n return { board: compileBoardDefinition(storedBoardConfig(row, board), code), problems };\n } catch (error) {\n if (!(error instanceof BoardDefinitionError)) throw error;\n return {\n board: compileBoardDefinition(storedBoardConfig(row), code),\n problems: [...problems, `Board \"${row.key}\" runs without its code behaviour: ${error.message}`],\n };\n }\n}\n\nfunction missingPhases(keys: string[]): string {\n return keys.length === 1\n ? `phase \"${keys[0]}\" isn't stored.`\n : `phases ${keys.map(key => `\"${key}\"`).join(', ')} aren't stored.`;\n}\n\n/** The code behaviour one stored phase runs with. */\ninterface PhaseBehaviour {\n outcomes?: Readonly<Record<string, string>>;\n onEnter?: BoardPhaseDefinition<string>['onEnter'];\n onExit?: BoardPhaseDefinition<string>['onExit'];\n}\n\n/** The code behaviour a stored board runs with, by phase key and for the board. */\ninterface BoardBehaviour {\n phases: Record<string, PhaseBehaviour>;\n tools?: AnyBoardConfig['tools'];\n events?: AnyBoardConfig['events'];\n transitionPolicy?: AnyBoardConfig['transitionPolicy'];\n sourceClosed?: AnyBoardConfig['sourceClosed'];\n}\n\nfunction codeDeclaration(code: InstalledBoard): AnyBoardConfig {\n return declarationOf(code) ?? code;\n}\n\n/**\n * The board config a stored definition declares, with the given code behaviour. The board is\n * rebuilt from the declaration's handlers, so the stored runner reaches them.\n */\nfunction storedBoardConfig(board: StoredBoardInput, behaviour?: BoardBehaviour): AnyBoardConfig {\n const [initial] = board.phases;\n if (!initial) throw new BoardDefinitionError('A board must define at least one phase.');\n const phases: Record<string, BoardPhaseDefinition<string>> = {};\n for (const phase of board.phases) {\n if (Object.hasOwn(phases, phase.key)) {\n throw new BoardDefinitionError(`Board \"${board.key}\" declares phase \"${phase.key}\" more than once.`);\n }\n const runner = phase.runner ? withoutUndefined(phase.runner) : undefined;\n const exitTool = phase.exitTool ? withoutUndefined(phase.exitTool) : undefined;\n const declared = behaviour && Object.hasOwn(behaviour.phases, phase.key) ? behaviour.phases[phase.key] : undefined;\n phases[phase.key] = withoutUndefined({\n name: phase.name,\n description: phase.description ?? undefined,\n kind: phase.kind,\n nextPhases: storedNextPhases(phase, board.phases),\n runner,\n autoStart: phase.autoStart ? true : undefined,\n autoStartWhen: phase.autoStartWhen ?? undefined,\n exitTool,\n outcomes: declared?.outcomes,\n onEnter: declared?.onEnter,\n onExit: declared?.onExit,\n }) as BoardPhaseDefinition<string>;\n }\n return {\n id: board.key,\n name: board.name,\n ...(board.description != null ? { description: board.description } : {}),\n initialPhase: initial.key,\n phases,\n ...(behaviour?.tools ? { tools: behaviour.tools } : {}),\n ...(behaviour?.events ? { events: behaviour.events } : {}),\n ...(behaviour?.transitionPolicy ? { transitionPolicy: behaviour.transitionPolicy } : {}),\n ...(behaviour?.sourceClosed ? { sourceClosed: behaviour.sourceClosed } : {}),\n };\n}\n\n/** What a code board's behaviour holds fixed on each of its phases; the rest of the phase is editable. */\ninterface CodePhaseBehaviour {\n /** Code handlers run on entering or leaving it, so its runner context and skill are fixed. */\n handlers: boolean;\n /** The exit tool its code behaviour waits for, if any. */\n exitToolId: string | null;\n /** Phases code moves cards to from it; they stay in its nextPhases. */\n requiredNextPhases: string[];\n}\n\n/** The per-phase locks `codeBehaviourConflicts` enforces, for clients that show them. */\nexport function codeBehaviourOf(code: InstalledBoard): Record<string, CodePhaseBehaviour> {\n const declaration: AnyBoardConfig = declarationOf(code) ?? code;\n return Object.fromEntries(\n (Object.entries(code.phases) as [string, BoardPhase<string>][]).map(([key, phase]) => [\n key,\n {\n handlers: phase.kind === 'working' && hasHandlers(declaration.phases[key]),\n exitToolId: phase.kind === 'working' ? (phase.exitTool?.id ?? null) : null,\n requiredNextPhases: [...phase.nextPhases],\n },\n ]),\n );\n}\n\nfunction hasHandlers(phase: BoardPhaseDefinition<string> | undefined): boolean {\n return Object.keys(phase?.onEnter ?? {}).length > 0 || Object.keys(phase?.onExit ?? {}).length > 0;\n}\n\n/**\n * Why a stored definition of a code board's key can't run with that board's code behaviour, one\n * reason per locked change; empty when it can. Code handlers and checks name the board's phases,\n * its first phase, the context, skill and exit tool of phases with handlers, and the moves code\n * makes between phases (tool and event rules, `sourceClosed`, integrations, handler prompts), so\n * those stay as code declares them. Names, descriptions, added moves, start and approval\n * conditions, runner instructions and new phases are free.\n */\nexport function codeBehaviourConflicts(board: StoredBoardInput, code: InstalledBoard): string[] {\n const declaration: AnyBoardConfig = declarationOf(code) ?? code;\n const stored = new Map(board.phases.map(phase => [phase.key, phase]));\n const conflicts: string[] = [];\n if (board.phases[0]?.key !== code.initialPhase) {\n conflicts.push(`Cards on board \"${code.id}\" start in \"${code.initialPhase}\"; keep it the first phase.`);\n }\n for (const [key, phase] of Object.entries(code.phases) as [string, BoardPhase<string>][]) {\n const edited = stored.get(key);\n const label = `Phase \"${key}\"`;\n if (!edited) {\n conflicts.push(`${label} has code behaviour on board \"${code.id}\"; it can't be removed.`);\n continue;\n }\n conflicts.push(...phaseShapeConflicts(key, phase, declaration.phases[key], edited));\n if (edited.kind !== phase.kind) continue;\n const nextPhases = storedNextPhases(edited, board.phases);\n const outcomes = new Map(Object.entries(phase.outcomes ?? {}).map(([outcome, target]) => [target, outcome]));\n for (const target of phase.nextPhases) {\n if (nextPhases.includes(target)) continue;\n const outcome = outcomes.get(target);\n conflicts.push(\n outcome\n ? `${label} outcome \"${outcome}\" moves cards to \"${target}\"; keep it in nextPhases.`\n : `${label}: Factory's code moves cards from it to \"${target}\"; keep it in nextPhases.`,\n );\n }\n }\n return conflicts;\n}\n\n/**\n * Why a stored phase isn't in the shape its code behaviour depends on: its kind and, on a working\n * phase, the runner context and skill its code handlers run with and the exit tool they wait for.\n */\nfunction phaseShapeConflicts(\n key: string,\n phase: BoardPhase<string>,\n declared: BoardPhaseDefinition<string> | undefined,\n edited: StoredPhaseInput,\n): string[] {\n const label = `Phase \"${key}\"`;\n if (edited.kind !== phase.kind) return [`${label} must stay ${phase.kind}; its code behaviour depends on it.`];\n if (phase.kind !== 'working') return [];\n const conflicts: string[] = [];\n if (hasHandlers(declared)) {\n const context = edited.runner?.context ?? DEFAULT_PHASE_CONTEXT;\n if (context !== phase.runner.context) {\n conflicts.push(`${label} runs its code handlers in the \"${phase.runner.context}\" context; keep runner.context.`);\n }\n if (edited.runner?.skill !== phase.runner.skill) {\n conflicts.push(\n phase.runner.skill\n ? `${label} code handlers run with skill \"${phase.runner.skill}\"; keep runner.skill.`\n : `${label} code handlers choose the skill; leave runner.skill unset.`,\n );\n }\n }\n if (phase.exitTool && edited.exitTool?.id !== phase.exitTool.id) {\n conflicts.push(`${label} code behaviour waits for exit tool \"${phase.exitTool.id}\"; keep exitTool.id.`);\n } else if (!phase.exitTool && edited.exitTool && hasHandlers(declared)) {\n // An exit tool gates every move out of the phase, including the ones its code handlers make.\n conflicts.push(`${label} code handlers move cards on without an exit tool; leave exitTool unset.`);\n }\n return conflicts;\n}\n\n/** Whether two storable definitions describe the same board once unset fields and defaults are resolved. */\nexport function sameBoardDefinition(a: StoredBoardInput, b: StoredBoardInput): boolean {\n return (\n canonicalJson(boardDefinitionOf(compileStoredBoard(a))) === canonicalJson(boardDefinitionOf(compileStoredBoard(b)))\n );\n}\n\nfunction canonicalJson(value: unknown): string {\n if (Array.isArray(value)) return `[${value.map(canonicalJson).join(',')}]`;\n if (value !== null && typeof value === 'object') {\n const entries = Object.entries(value)\n .filter(([, entry]) => entry !== undefined)\n .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));\n return `{${entries.map(([key, entry]) => `${JSON.stringify(key)}:${canonicalJson(entry)}`).join(',')}}`;\n }\n return JSON.stringify(value);\n}\n\n/**\n * A board's storable definition, in the shape the boards API reads and writes. The initial phase\n * comes first and every phase's resolved `nextPhases` is written out.\n */\nexport function boardDefinitionOf(board: InstalledBoard): StoredBoardInput {\n const order = [board.initialPhase, ...Object.keys(board.phases).filter(key => key !== board.initialPhase)];\n return {\n key: board.id,\n name: board.name,\n ...(board.description !== undefined ? { description: board.description } : {}),\n phases: order.map(key => storedPhase(key, board.phases[key]!)),\n };\n}\n\nfunction storedPhase(key: string, phase: BoardPhase<string>): StoredPhaseInput {\n return withoutUndefined({\n key,\n name: phase.name,\n description: phase.description,\n kind: phase.kind,\n nextPhases: [...phase.nextPhases],\n ...(phase.kind === 'working'\n ? {\n runner: withoutUndefined({\n skill: phase.runner.skill,\n context: phase.runner.context,\n instructions: phase.runner.instructions,\n }),\n autoStart: phase.autoStart ? true : undefined,\n autoStartWhen: phase.autoStartWhen,\n exitTool: phase.exitTool\n ? withoutUndefined({\n id: phase.exitTool.id,\n autoApprove: phase.exitTool.autoApprove,\n autoApproveWhen: phase.exitTool.autoApproveWhen,\n })\n : undefined,\n }\n : {}),\n });\n}\n\nfunction withoutUndefined<T extends object>(value: T): T {\n return Object.fromEntries(Object.entries(value).filter(([, entry]) => entry !== undefined)) as T;\n}\n"],"mappings":"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"}
|
package/dist/factory.d.ts
CHANGED
|
@@ -23,20 +23,26 @@ import type { MastraBrowser } from '@mastra/core/browser';
|
|
|
23
23
|
import type { PubSub } from '@mastra/core/events';
|
|
24
24
|
import type { Knowledge } from '@mastra/core/knowledge';
|
|
25
25
|
import type { Mastra } from '@mastra/core/mastra';
|
|
26
|
+
import { RequestContext } from '@mastra/core/request-context';
|
|
26
27
|
import type { IMastraAuthProvider } from '@mastra/core/server';
|
|
27
28
|
import type { InlineSkill } from '@mastra/core/skills';
|
|
28
29
|
import type { FactoryStorage } from '@mastra/core/storage';
|
|
29
30
|
import type { MastraVector } from '@mastra/core/vector';
|
|
30
31
|
import type { FactorySandboxDescription } from '@mastra/core/workspace';
|
|
31
32
|
import type { InstalledBoard } from './boards/index.js';
|
|
32
|
-
import type { FactoryIntegration } from './integrations/base.js';
|
|
33
|
+
import type { FactoryIntegration, IntegrationTools } from './integrations/base.js';
|
|
33
34
|
import type { GithubRuleOverrides } from './integrations/github/default-rules.js';
|
|
34
35
|
import type { FactoryMcpConfig } from './mcp/routes.js';
|
|
35
36
|
import type { MastraFactorySandboxOption } from './sandbox/session-sandbox.js';
|
|
36
37
|
import type { FactorySecretEncryption } from './secret-encryption.js';
|
|
38
|
+
import type { StoredBoardInput, StoredBoardScope } from './storage/domains/boards/base.js';
|
|
37
39
|
import type { FactorySandboxStart } from './workspace.js';
|
|
38
40
|
/** Constructor args for the `new Mastra(...)` literal in the deploy entry. */
|
|
39
41
|
export type MastraArgs = NonNullable<ConstructorParameters<typeof Mastra>[0]>;
|
|
42
|
+
/** Tools for every Factory session, or a resolver called per run. */
|
|
43
|
+
export type FactoryTools = IntegrationTools | ((args: {
|
|
44
|
+
requestContext: RequestContext;
|
|
45
|
+
}) => IntegrationTools | Promise<IntegrationTools>);
|
|
40
46
|
export interface MastraFactoryConfig {
|
|
41
47
|
/**
|
|
42
48
|
* Auth provider instance — `MastraAuthStudio` (`@mastra/auth-studio`),
|
|
@@ -132,6 +138,20 @@ export interface MastraFactoryConfig {
|
|
|
132
138
|
* approval cannot bypass that gate.
|
|
133
139
|
*/
|
|
134
140
|
disableBuiltinTools?: BuiltinToolId[];
|
|
141
|
+
/**
|
|
142
|
+
* Tools offered to every Factory session, such as an MCP server's tools
|
|
143
|
+
* (`await mcpClient.listTools()`) or Mastra Connect's (`tools()` from
|
|
144
|
+
* `@mastra/connect`). Credentials built into these tools are shared by every
|
|
145
|
+
* user of the instance. Pass a function to resolve tools per run instead, for
|
|
146
|
+
* example to use the run's org credentials. A name Factory already gives the
|
|
147
|
+
* session keeps Factory's tool; the configured one is skipped with a warning.
|
|
148
|
+
*
|
|
149
|
+
* Defaults, with Platform credentials and `MASTRA_PROJECT_ID`, to the Mastra
|
|
150
|
+
* Connect tools of every connection attached to the Platform project, minus
|
|
151
|
+
* tools named for deleting or archiving and GitHub or GitLab tools. Pass `{}`
|
|
152
|
+
* to offer none.
|
|
153
|
+
*/
|
|
154
|
+
tools?: FactoryTools;
|
|
135
155
|
/** Background Factory dispatcher configuration. */
|
|
136
156
|
dispatcher?: MastraFactoryDispatcherConfig;
|
|
137
157
|
/**
|
|
@@ -179,11 +199,12 @@ export interface MastraFactoryConfig {
|
|
|
179
199
|
*/
|
|
180
200
|
configVersion?: string;
|
|
181
201
|
/**
|
|
182
|
-
* Boards
|
|
202
|
+
* Boards stored in every project once, next to the boards each project stored.
|
|
183
203
|
*
|
|
184
|
-
* @deprecated
|
|
185
|
-
*
|
|
186
|
-
*
|
|
204
|
+
* @deprecated Write board definitions into projects with `factory.upsertBoard()`, or manage them
|
|
205
|
+
* through the boards API (`/web/factory/projects/:id/boards`,
|
|
206
|
+
* README "Stored boards"); removal is tracked in mastra-ai/mastra#28920. Boards passed here still
|
|
207
|
+
* work: each project stores them once and is served from its rows, with the code behaviour they declare.
|
|
187
208
|
*/
|
|
188
209
|
boards?: readonly InstalledBoard[];
|
|
189
210
|
/**
|
|
@@ -194,10 +215,8 @@ export interface MastraFactoryConfig {
|
|
|
194
215
|
*/
|
|
195
216
|
skills?: readonly InlineSkill[];
|
|
196
217
|
/**
|
|
197
|
-
* Whether
|
|
198
|
-
*
|
|
199
|
-
* @deprecated Will be replaced by a one-time copy of the built-in boards into each project's
|
|
200
|
-
* database (mastra-ai/mastra#28920). It still decides whether projects get them until then.
|
|
218
|
+
* Whether projects get the built-in Work board, stored in each project once, and the legacy
|
|
219
|
+
* read-only Review board. Default: true.
|
|
201
220
|
*/
|
|
202
221
|
includeDefaultBoards?: boolean;
|
|
203
222
|
/**
|
|
@@ -243,6 +262,41 @@ export declare class MastraFactory {
|
|
|
243
262
|
* `prepare()` and when sandboxes are disabled.
|
|
244
263
|
*/
|
|
245
264
|
get sandboxDescription(): FactorySandboxDescription | undefined;
|
|
265
|
+
/**
|
|
266
|
+
* Writes a board definition into projects: each project that has no board under its key gets
|
|
267
|
+
* it, and each one that has it, edited or not, has it replaced at the next revision. Use it to
|
|
268
|
+
* push a board from code into projects; it isn't run for you, and projects created later don't
|
|
269
|
+
* get it until you run it again. A Work or app board's key keeps that board's code behaviour,
|
|
270
|
+
* so the definition is checked as an edit is; a new key gets none (no handlers, outcomes, tool or
|
|
271
|
+
* event rules). The board is validated once, as the boards API does, and each write is audited
|
|
272
|
+
* as `factory.board.created` or `factory.board.updated` by `system:factory`. Refusals throw a
|
|
273
|
+
* `BoardWriteError` (`invalid_board`, `unknown_skill`, `code_behaviour`, `code_board` for the
|
|
274
|
+
* legacy Review board, `phase_in_use` when cards sit in a phase it removes, `project_not_found`).
|
|
275
|
+
* Available after `prepare()`.
|
|
276
|
+
*
|
|
277
|
+
* @example
|
|
278
|
+
* ```ts
|
|
279
|
+
* const { inserted, updated, unchanged } = await factory.upsertBoard(
|
|
280
|
+
* {
|
|
281
|
+
* key: 'bugs',
|
|
282
|
+
* name: 'Bugs',
|
|
283
|
+
* phases: [
|
|
284
|
+
* { key: 'reported', name: 'Reported', kind: 'resting', nextPhases: ['fixing'] },
|
|
285
|
+
* { key: 'fixing', name: 'Fixing', kind: 'working', runner: { context: 'work' }, nextPhases: ['fixed'] },
|
|
286
|
+
* { key: 'fixed', name: 'Fixed', kind: 'terminal' },
|
|
287
|
+
* ],
|
|
288
|
+
* },
|
|
289
|
+
* { projects: 'all' },
|
|
290
|
+
* );
|
|
291
|
+
* ```
|
|
292
|
+
*/
|
|
293
|
+
upsertBoard(board: StoredBoardInput, options: {
|
|
294
|
+
projects: 'all' | readonly StoredBoardScope[];
|
|
295
|
+
}): Promise<{
|
|
296
|
+
inserted: StoredBoardScope[];
|
|
297
|
+
updated: StoredBoardScope[];
|
|
298
|
+
unchanged: StoredBoardScope[];
|
|
299
|
+
}>;
|
|
246
300
|
/**
|
|
247
301
|
* Resolve feature readiness, wire every dependency explicitly, and assemble
|
|
248
302
|
* everything needed to construct the server-owned Mastra. Returns the args
|
package/dist/factory.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;
|
|
1
|
+
{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AASH,OAAO,KAAK,EAAiC,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAClG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAG1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAkB,yBAAyB,EAAoB,MAAM,wBAAwB,CAAC;AAe1G,OAAO,KAAK,EAAiB,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAOvE,OAAO,KAAK,EAAE,kBAAkB,EAA8B,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/G,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAmBlF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAgCxD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAG/E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AA6BtE,OAAO,KAAK,EAAE,gBAAgB,EAAqB,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AA0C9G,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAI1D,8EAA8E;AAC9E,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,qBAAqB,CAAC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE9E,qEAAqE;AACrE,MAAM,MAAM,YAAY,GACpB,gBAAgB,GAChB,CAAC,CAAC,IAAI,EAAE;IAAE,cAAc,EAAE,cAAc,CAAA;CAAE,KAAK,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC;AAEjG,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;;;;;;;OAcG;IACH,IAAI,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAClC;;;;;;;OAOG;IACH,OAAO,EAAE,cAAc,CAAC;IACxB,iEAAiE;IACjE,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;OAIG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;;OAGG;IACH,SAAS,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,SAAS,CAAA;KAAE,CAAC;IACjD;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,GAAG,CAAC,EAAE,KAAK,GAAG,gBAAgB,CAAC;IAC/B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,0BAA0B,CAAC;IACrC,8DAA8D;IAC9D,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB;;;;OAIG;IACH,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,aAAa,EAAE,CAAC;IACtC;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,mDAAmD;IACnD,UAAU,CAAC,EAAE,6BAA6B,CAAC;IAC3C;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;IAC3C;;;;;;;;;;OAUG;IACH,wBAAwB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACpC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACnC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAChC;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,EAAE;QACT,sGAAsG;QACtG,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB;;;;;;WAMG;QACH,MAAM,CAAC,EAAE;YACP,uFAAuF;YACvF,KAAK,CAAC,EAAE,mBAAmB,CAAC;YAC5B;;;eAGG;YACH,IAAI,CAAC,EAAE,MAAM,CAAC;SACf,CAAC;KACH,CAAC;CACH;AAED,YAAY,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC3G,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D;;;;GAIG;AACH,MAAM,WAAW,6BAA6B;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAsID,qBAAa,aAAa;;IA8BxB,YAAY,MAAM,EAAE,mBAAmB,EAyBtC;IAED;;;;OAIG;IACH,IAAI,kBAAkB,IAAI,yBAAyB,GAAG,SAAS,CAI9D;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACG,WAAW,CACf,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE;QAAE,QAAQ,EAAE,KAAK,GAAG,SAAS,gBAAgB,EAAE,CAAA;KAAE,GACzD,OAAO,CAAC;QAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC;QAAC,OAAO,EAAE,gBAAgB,EAAE,CAAC;QAAC,SAAS,EAAE,gBAAgB,EAAE,CAAA;KAAE,CAAC,CA2CvG;IAED;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,CAqqDnC;IAED;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAuB9B;IAED,oGAAoG;IAC9F,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAmC9B;CACF"}
|
package/dist/factory.js
CHANGED
|
@@ -1,19 +1,22 @@
|
|
|
1
1
|
import { buildAuthDisabledRoutes, buildAuthRoutes, createFactoryAuthGate, createFactoryInteractiveMarker, createFactoryRouteAuth, getFactoryAuthOrgId, getFactoryAuthUserFromContext, getFactoryAuthUserId } from "./auth.js";
|
|
2
|
+
import { BoardWriteError, BoardWrites } from "./boards/board-writes.js";
|
|
2
3
|
import { isDefinedBoard } from "./boards/define-board.js";
|
|
3
4
|
import "./boards/index.js";
|
|
4
5
|
import { ProjectBoardCache } from "./boards/project-boards.js";
|
|
5
6
|
import { publishDispatchWake, subscribeDispatchWakes } from "./dispatch-wake.js";
|
|
6
7
|
import { EnvironmentBuildRunner } from "./environment/build-runner.js";
|
|
7
|
-
import { isTerminalWorkItem } from "./boards/semantics.js";
|
|
8
|
-
import { createBoardRegistry } from "./boards/registry.js";
|
|
9
8
|
import { ENVIRONMENT_BUILD_WORKFLOW_ID } from "./environment/build-workflow.js";
|
|
10
9
|
import { touchFeed } from "./feed-events.js";
|
|
11
10
|
import { reconcileGithubAcceptanceLabels } from "./integrations/github/acceptance-labels.js";
|
|
12
11
|
import { recordFactoryPullRequestProvenance, resolveFactoryPullRequestParentWorkItemId } from "./integrations/github/provenance.js";
|
|
12
|
+
import { createBoardRegistry } from "./boards/registry.js";
|
|
13
|
+
import { boardForWorkItem, isTerminalWorkItem } from "./boards/semantics.js";
|
|
14
|
+
import { createGithubReviewStatusReporter, reviewStatusAnimationFromEnv } from "./integrations/github/review-status-reporter.js";
|
|
13
15
|
import { isFactoryGithubLogin, trustedCollaborator } from "./integrations/github/rules.js";
|
|
14
16
|
import { dismissStaleFactoryReviews } from "./integrations/github/stale-reviews.js";
|
|
15
17
|
import { PlatformApiClient, platformApiClientConfigFromEnv } from "./integrations/platform/api-client.js";
|
|
16
|
-
import { buildPlatformConnectRoutes } from "./integrations/platform/connect/routes.js";
|
|
18
|
+
import { buildConnectToolsRoute, buildPlatformConnectRoutes } from "./integrations/platform/connect/routes.js";
|
|
19
|
+
import { platformConnectTools } from "./integrations/platform/connect/session-tools.js";
|
|
17
20
|
import { createSessionAsRowOwner, prepareSessionRunContext } from "./integrations/subscription-session.js";
|
|
18
21
|
import { buildFactoryMcpRoutes, resolveMcpAuthorizationServers } from "./mcp/routes.js";
|
|
19
22
|
import { resolveDeploymentModelProviders } from "./routes/config.js";
|
|
@@ -35,8 +38,8 @@ import { assertFactoryConfigVersion } from "./rules/validation.js";
|
|
|
35
38
|
import { CallbackFactorySandbox } from "./sandbox/callback-factory-sandbox.js";
|
|
36
39
|
import { isValidGitRef } from "./sandbox/git-ref.js";
|
|
37
40
|
import { LocalFactorySandbox } from "./sandbox/local-factory-sandbox.js";
|
|
38
|
-
import { resolveFactoryToolScope } from "./tools/scope.js";
|
|
39
41
|
import { SessionRetirementCoordinator } from "./sandbox/session-retirement.js";
|
|
42
|
+
import { resolveFactoryToolScope } from "./tools/scope.js";
|
|
40
43
|
import { peekSessionSandbox } from "./sandbox/session-sandbox.js";
|
|
41
44
|
import { createPlaintextFactorySecretEncryption } from "./secret-encryption.js";
|
|
42
45
|
import { handleServerError } from "./server-error.js";
|
|
@@ -47,8 +50,8 @@ import { FactoryEnvironmentStateProcessor } from "./session/environment-state-pr
|
|
|
47
50
|
import { createSourceControlSessionLookup } from "./session/factory-session.js";
|
|
48
51
|
import { observeSessionFilesystem } from "./session/filesystem-capture.js";
|
|
49
52
|
import { observeSessionFirstExec } from "./session/first-exec-capture.js";
|
|
50
|
-
import { observeSessionFirstMessage } from "./session/first-message-capture.js";
|
|
51
53
|
import { applyFactoryToolPermissions } from "./tools/permissions.js";
|
|
54
|
+
import { observeSessionFirstMessage } from "./session/first-message-capture.js";
|
|
52
55
|
import { LiveSessions } from "./session/live-sessions.js";
|
|
53
56
|
import { hydrateSessionMemorySettings } from "./session/memory-settings-hydration.js";
|
|
54
57
|
import { hasResolvedOrg } from "./session/org-seed.js";
|
|
@@ -77,27 +80,31 @@ import { CustomProvidersStorage } from "./storage/domains/custom-providers/base.
|
|
|
77
80
|
import { FilesystemStorage } from "./storage/domains/filesystem/base.js";
|
|
78
81
|
import { IntakeStorage } from "./storage/domains/intake/base.js";
|
|
79
82
|
import { IntegrationStorage } from "./storage/domains/integrations/base.js";
|
|
80
|
-
import { MemorySettingsStorage
|
|
83
|
+
import { MemorySettingsStorage } from "./storage/domains/memory-settings/base.js";
|
|
81
84
|
import { ModelDefaultsStorage } from "./storage/domains/model-defaults/base.js";
|
|
82
|
-
import { FactoryProjectsStorage } from "./storage/domains/projects/base.js";
|
|
85
|
+
import { FactoryProjectsStorage, factoryProjectSettingsUserId } from "./storage/domains/projects/base.js";
|
|
83
86
|
import { QueueHealthStorage } from "./storage/domains/queue-health/base.js";
|
|
84
87
|
import { SkillOverridesStorage } from "./storage/domains/skill-overrides/base.js";
|
|
85
88
|
import { SourceControlStorage } from "./storage/domains/source-control/base.js";
|
|
89
|
+
import { VoiceSettingsStorage } from "./storage/domains/voice-settings/base.js";
|
|
86
90
|
import { WorkItemSplitModeError, WorkItemsStorage } from "./storage/domains/work-items/base.js";
|
|
87
|
-
import { createRequestTimingMiddleware, factoryTimingEnabled, instrumentAsyncMethods, timedPhase } from "./timing.js";
|
|
91
|
+
import { createRequestTimingMiddleware, factoryTimingEnabled, instrumentAsyncMethods, logTiming, timedPhase } from "./timing.js";
|
|
88
92
|
import { deliverFactorySessionNotification } from "./tools/deliver.js";
|
|
89
93
|
import { createFactoryTools } from "./tools/index.js";
|
|
90
94
|
import { createSessionApprovalNotifier, createSessionRunEndReporter, createStageChangeNotifier, createWorkItemRunEndReporter } from "./tools/reports.js";
|
|
91
95
|
import { observeSessionRunReports } from "./tools/run-watch.js";
|
|
92
96
|
import { createFactorySandboxTools } from "./tools/sandbox-tools.js";
|
|
93
97
|
import { FactorySessionsStateProcessor } from "./tools/sessions-state-processor.js";
|
|
98
|
+
import { backfillUntilDone } from "./work-items/split-backfill.js";
|
|
94
99
|
import { FACTORY_PLANS_DIR, FactoryWorkspaceRegistry, createWorkspaceFactory } from "./workspace.js";
|
|
95
100
|
import { RequestContext } from "@mastra/core/request-context";
|
|
96
101
|
import { hasAuthInit, isUserProvider } from "@mastra/core/server";
|
|
97
102
|
import { EventEmitterPubSub } from "@mastra/core/events";
|
|
103
|
+
import { existsSync } from "fs";
|
|
98
104
|
import { MastraAuthStudio } from "@mastra/auth-studio";
|
|
99
105
|
import { prepareAgentControllerMount } from "@mastra/code-sdk";
|
|
100
106
|
import { getDynamicMemory } from "@mastra/code-sdk/agents/memory";
|
|
107
|
+
import { getGlobalMcpPath } from "@mastra/code-sdk/mcp/config";
|
|
101
108
|
import { AgentControllerChannels } from "@mastra/core/channels";
|
|
102
109
|
import { describeFactorySandbox, isFactorySandbox } from "@mastra/core/workspace";
|
|
103
110
|
// src/factory.ts
|
|
@@ -155,6 +162,20 @@ async function platformDefaultSandbox() {
|
|
|
155
162
|
const { PlatformFactorySandbox } = await import("@mastra/platform-workspace");
|
|
156
163
|
return new PlatformFactorySandbox();
|
|
157
164
|
}
|
|
165
|
+
function platformConnectProjectId() {
|
|
166
|
+
if (!hasPlatformCredentials()) return void 0;
|
|
167
|
+
const projectId = process.env.MASTRA_PROJECT_ID?.trim();
|
|
168
|
+
if (!projectId) {
|
|
169
|
+
console.warn("MastraFactory: Platform credentials are set but MASTRA_PROJECT_ID is missing, so sessions get no Mastra Connect tools.");
|
|
170
|
+
return;
|
|
171
|
+
}
|
|
172
|
+
return projectId;
|
|
173
|
+
}
|
|
174
|
+
function warnIgnoredMcpConfig() {
|
|
175
|
+
const mcpPath = getGlobalMcpPath();
|
|
176
|
+
if (!existsSync(mcpPath)) return;
|
|
177
|
+
console.warn(`MastraFactory: ${mcpPath} is ignored; Factory sessions don't load mcp.json. Pass MCP tools through the \`tools\` option or attach a Mastra Connect connection to the Platform project.`);
|
|
178
|
+
}
|
|
158
179
|
/**
|
|
159
180
|
* Default auth provider — `MastraAuthStudio`, which proxies identity to the
|
|
160
181
|
* shared Mastra platform API and resolves its own env (`MASTRA_SHARED_API_URL`,
|
|
@@ -187,7 +208,7 @@ let warnedDefinedBoards = false;
|
|
|
187
208
|
function warnDefinedBoards(boards) {
|
|
188
209
|
if (warnedDefinedBoards || ![...boards.values()].some(isDefinedBoard)) return;
|
|
189
210
|
warnedDefinedBoards = true;
|
|
190
|
-
console.warn("[Mastra Factory] MastraFactory({ boards }) and defineBoard() are deprecated: boards
|
|
211
|
+
console.warn("[Mastra Factory] MastraFactory({ boards }) and defineBoard() are deprecated: boards live in the database, and each project stores these definitions once. Write board definitions into projects with factory.upsertBoard(), or manage them through the boards API; see the README \"Stored boards\" section and mastra-ai/mastra#28920.");
|
|
191
212
|
}
|
|
192
213
|
/**
|
|
193
214
|
* The fleet-era `sandbox` options and what replaced each one. Only the keys
|
|
@@ -223,6 +244,8 @@ var MastraFactory = class {
|
|
|
223
244
|
#boards;
|
|
224
245
|
/** Each project's boards: the code boards plus the boards it stored. Undefined until `prepare()` or when the boards domain is down. */
|
|
225
246
|
#projectBoards;
|
|
247
|
+
/** Writes to stored boards for `upsertBoard()`; undefined until `prepare()` or when the boards domain is down. */
|
|
248
|
+
#boardStore;
|
|
226
249
|
#skills;
|
|
227
250
|
#configVersion;
|
|
228
251
|
#prepared;
|
|
@@ -238,6 +261,8 @@ var MastraFactory = class {
|
|
|
238
261
|
#environmentBuilds;
|
|
239
262
|
/** The background session resource migration; resolves `true` when it moved run bindings. */
|
|
240
263
|
#sessionResourceMigration;
|
|
264
|
+
#workItemSplitBackfill;
|
|
265
|
+
#prepareStartedAt;
|
|
241
266
|
#preparing = false;
|
|
242
267
|
constructor(config) {
|
|
243
268
|
if (!config?.storage) throw new Error("MastraFactory: 'storage' is required. Pass a FactoryStorage backend — e.g. new PgFactoryStorage({ connectionString }) from '@mastra/pg' for deployments, or new LibSQLFactoryStorage({ url }) from '@mastra/libsql' for local dev.");
|
|
@@ -263,6 +288,74 @@ var MastraFactory = class {
|
|
|
263
288
|
return this.#sandboxDescription;
|
|
264
289
|
}
|
|
265
290
|
/**
|
|
291
|
+
* Writes a board definition into projects: each project that has no board under its key gets
|
|
292
|
+
* it, and each one that has it, edited or not, has it replaced at the next revision. Use it to
|
|
293
|
+
* push a board from code into projects; it isn't run for you, and projects created later don't
|
|
294
|
+
* get it until you run it again. A Work or app board's key keeps that board's code behaviour,
|
|
295
|
+
* so the definition is checked as an edit is; a new key gets none (no handlers, outcomes, tool or
|
|
296
|
+
* event rules). The board is validated once, as the boards API does, and each write is audited
|
|
297
|
+
* as `factory.board.created` or `factory.board.updated` by `system:factory`. Refusals throw a
|
|
298
|
+
* `BoardWriteError` (`invalid_board`, `unknown_skill`, `code_behaviour`, `code_board` for the
|
|
299
|
+
* legacy Review board, `phase_in_use` when cards sit in a phase it removes, `project_not_found`).
|
|
300
|
+
* Available after `prepare()`.
|
|
301
|
+
*
|
|
302
|
+
* @example
|
|
303
|
+
* ```ts
|
|
304
|
+
* const { inserted, updated, unchanged } = await factory.upsertBoard(
|
|
305
|
+
* {
|
|
306
|
+
* key: 'bugs',
|
|
307
|
+
* name: 'Bugs',
|
|
308
|
+
* phases: [
|
|
309
|
+
* { key: 'reported', name: 'Reported', kind: 'resting', nextPhases: ['fixing'] },
|
|
310
|
+
* { key: 'fixing', name: 'Fixing', kind: 'working', runner: { context: 'work' }, nextPhases: ['fixed'] },
|
|
311
|
+
* { key: 'fixed', name: 'Fixed', kind: 'terminal' },
|
|
312
|
+
* ],
|
|
313
|
+
* },
|
|
314
|
+
* { projects: 'all' },
|
|
315
|
+
* );
|
|
316
|
+
* ```
|
|
317
|
+
*/
|
|
318
|
+
async upsertBoard(board, options) {
|
|
319
|
+
const store = this.#boardStore;
|
|
320
|
+
if (!store) throw new Error(this.#preparing ? "MastraFactory.upsertBoard(): the boards storage isn't available, so boards can't be stored." : "MastraFactory.upsertBoard() needs prepare() first.");
|
|
321
|
+
const { writes, projects, audit } = store;
|
|
322
|
+
const input = writes.validate(board);
|
|
323
|
+
writes.refuseCodeBoard(input.key, "edit");
|
|
324
|
+
await projects.ensureReady();
|
|
325
|
+
let scopes;
|
|
326
|
+
if (options.projects === "all") scopes = (await projects.listAll()).map((project) => ({
|
|
327
|
+
orgId: project.orgId,
|
|
328
|
+
factoryProjectId: project.id
|
|
329
|
+
}));
|
|
330
|
+
else {
|
|
331
|
+
scopes = [...options.projects];
|
|
332
|
+
for (const scope of scopes) if (!await projects.get({
|
|
333
|
+
orgId: scope.orgId,
|
|
334
|
+
id: scope.factoryProjectId
|
|
335
|
+
})) throw new BoardWriteError(404, {
|
|
336
|
+
error: "project_not_found",
|
|
337
|
+
message: `Project "${scope.factoryProjectId}" does not exist.`
|
|
338
|
+
});
|
|
339
|
+
}
|
|
340
|
+
const result = {
|
|
341
|
+
inserted: [],
|
|
342
|
+
updated: [],
|
|
343
|
+
unchanged: []
|
|
344
|
+
};
|
|
345
|
+
for (const scope of scopes) result[await writes.upsert(scope, input, {
|
|
346
|
+
id: "factory",
|
|
347
|
+
audit: async (entry) => {
|
|
348
|
+
await audit.record({
|
|
349
|
+
orgId: scope.orgId,
|
|
350
|
+
actorId: "factory",
|
|
351
|
+
actorType: "system",
|
|
352
|
+
...entry
|
|
353
|
+
});
|
|
354
|
+
}
|
|
355
|
+
})].push(scope);
|
|
356
|
+
return result;
|
|
357
|
+
}
|
|
358
|
+
/**
|
|
266
359
|
* Resolve feature readiness, wire every dependency explicitly, and assemble
|
|
267
360
|
* everything needed to construct the server-owned Mastra. Returns the args
|
|
268
361
|
* for the `new Mastra(...)` literal that must live in the entry file.
|
|
@@ -270,6 +363,8 @@ var MastraFactory = class {
|
|
|
270
363
|
async prepare() {
|
|
271
364
|
if (this.#preparing) throw new Error("MastraFactory.prepare() called twice");
|
|
272
365
|
this.#preparing = true;
|
|
366
|
+
this.#prepareStartedAt = performance.now();
|
|
367
|
+
warnIgnoredMcpConfig();
|
|
273
368
|
const publicOrigin = (this.#config.publicUrl ?? "http://localhost:4111").replace(/\/+$/, "");
|
|
274
369
|
const allowedOrigins = (this.#config.allowedOrigins ?? []).map((o) => o.replace(/\/+$/, "")).filter(Boolean);
|
|
275
370
|
const storage = instrumentAsyncMethods(this.#config.storage, "storage");
|
|
@@ -355,7 +450,8 @@ var MastraFactory = class {
|
|
|
355
450
|
workItems: workItemsStorage,
|
|
356
451
|
channelIdentity: channelIdentityStorage,
|
|
357
452
|
comments: workItemCommentsStorage,
|
|
358
|
-
skillOverrides: skillOverridesStorage
|
|
453
|
+
skillOverrides: skillOverridesStorage,
|
|
454
|
+
voiceSettings: storage.registerDomain(new VoiceSettingsStorage())
|
|
359
455
|
};
|
|
360
456
|
const auditDomain = new AuditDomain({
|
|
361
457
|
auth: routeAuth,
|
|
@@ -407,9 +503,35 @@ var MastraFactory = class {
|
|
|
407
503
|
codeSkills: this.#skills
|
|
408
504
|
});
|
|
409
505
|
this.#projectBoards = projectBoards;
|
|
506
|
+
this.#boardStore = {
|
|
507
|
+
writes: new BoardWrites({
|
|
508
|
+
storage: storedBoardsStorage,
|
|
509
|
+
boards: projectBoards,
|
|
510
|
+
workItems: workItemsStorage
|
|
511
|
+
}),
|
|
512
|
+
projects: factoryProjectsStorage,
|
|
513
|
+
audit: auditDomain
|
|
514
|
+
};
|
|
410
515
|
await timedPhase("prepare.boards.preload", () => projectBoards.preload().catch((error) => console.warn(`[factory] loading project boards at startup failed; each project loads on first use: ${error instanceof Error ? error.message : error}`)));
|
|
411
516
|
}
|
|
412
517
|
const boards = this.#projectBoards ?? this.#boards;
|
|
518
|
+
if (storage.isDomainReady("work-items") && !workItemsStorage.legacyMode) {
|
|
519
|
+
const projectBoards = this.#projectBoards;
|
|
520
|
+
const projects = projectBoards ? new Set((await factoryProjectsStorage.listAll()).map((project) => `${project.orgId}\u0000${project.id}`)) : void 0;
|
|
521
|
+
const isTerminal = async (card) => {
|
|
522
|
+
let registry = this.#boards;
|
|
523
|
+
if (projectBoards) {
|
|
524
|
+
if (!projects.has(`${card.orgId}\u0000${card.factoryProjectId}`)) return false;
|
|
525
|
+
try {
|
|
526
|
+
registry = await projectBoards.load(card);
|
|
527
|
+
} catch {
|
|
528
|
+
return false;
|
|
529
|
+
}
|
|
530
|
+
}
|
|
531
|
+
return registry.has(boardForWorkItem(card)) && isTerminalWorkItem(registry, card);
|
|
532
|
+
};
|
|
533
|
+
await timedPhase("prepare.migrate.workItemSplit", () => workItemsStorage.migrateOpenLegacyCards(isTerminal));
|
|
534
|
+
}
|
|
413
535
|
if (storage.isDomainReady("work-items")) await timedPhase("prepare.workItems.heldTriageCards", () => workItemsStorage.returnHeldTriageCards().then((moved) => {
|
|
414
536
|
if (moved.length > 0) console.info(`[factory] moved ${moved.length} card(s) held for triage acceptance back to Intake`);
|
|
415
537
|
}).catch((error) => console.warn(`[factory] moving cards held for triage acceptance back to Intake failed: ${error instanceof Error ? error.message : error}`)));
|
|
@@ -478,6 +600,13 @@ var MastraFactory = class {
|
|
|
478
600
|
return false;
|
|
479
601
|
}
|
|
480
602
|
});
|
|
603
|
+
if (workItemsStorage.legacyBackfillPending) {
|
|
604
|
+
const controller = new AbortController();
|
|
605
|
+
this.#workItemSplitBackfill = {
|
|
606
|
+
controller,
|
|
607
|
+
promise: timedPhase("background.migrate.workItemSplit", () => backfillUntilDone(() => workItemsStorage.backfillLegacyCards({ signal: controller.signal }), controller.signal))
|
|
608
|
+
};
|
|
609
|
+
}
|
|
481
610
|
const knowledgeEnabled = this.#config.knowledge !== void 0;
|
|
482
611
|
const githubIntegration = integrations.find((integration) => integration.id === "github");
|
|
483
612
|
const gitlabIntegration = integrations.find((integration) => integration.id === "gitlab" && integration.intake && integration.versionControl);
|
|
@@ -640,6 +769,7 @@ var MastraFactory = class {
|
|
|
640
769
|
const environmentBuilds = this.#environmentBuilds;
|
|
641
770
|
const projectRoutes = new ProjectRoutes({
|
|
642
771
|
auth: routeAuth,
|
|
772
|
+
...this.#projectBoards ? { boards: this.#projectBoards } : {},
|
|
643
773
|
sandbox: this.#sandbox,
|
|
644
774
|
...environmentBuilds ? { environmentBuilds } : {},
|
|
645
775
|
projects: factoryProjectsStorage,
|
|
@@ -726,7 +856,7 @@ var MastraFactory = class {
|
|
|
726
856
|
const orgId = tenantOrgId(policy.tenant);
|
|
727
857
|
return policy.tenant.credentialScope === "factory" && policy.factoryProjectId ? {
|
|
728
858
|
orgId,
|
|
729
|
-
userId:
|
|
859
|
+
userId: factoryProjectSettingsUserId(policy.factoryProjectId)
|
|
730
860
|
} : {
|
|
731
861
|
orgId,
|
|
732
862
|
userId: policy.tenant.userId
|
|
@@ -740,7 +870,7 @@ var MastraFactory = class {
|
|
|
740
870
|
};
|
|
741
871
|
return {
|
|
742
872
|
orgId: binding?.orgId ?? scope?.factoryOrgId ?? "local",
|
|
743
|
-
userId:
|
|
873
|
+
userId: factoryProjectSettingsUserId(factoryProjectId)
|
|
744
874
|
};
|
|
745
875
|
};
|
|
746
876
|
const loadMemorySettings = async ({ requestContext, binding }) => {
|
|
@@ -785,6 +915,9 @@ var MastraFactory = class {
|
|
|
785
915
|
versionControl: integration.versionControl,
|
|
786
916
|
storage: sourceControlStorage.forIntegration(integration.id)
|
|
787
917
|
}] : []);
|
|
918
|
+
const connectToolsProjectId = this.#config.tools === void 0 ? platformConnectProjectId() : void 0;
|
|
919
|
+
const sessionTools = this.#config.tools ?? (connectToolsProjectId ? platformConnectTools(connectToolsProjectId) : void 0);
|
|
920
|
+
const warnedConfiguredToolClashes = /* @__PURE__ */ new Set();
|
|
788
921
|
const prepared = await timedPhase("prepare.controllerMount", () => prepareAgentControllerMount({
|
|
789
922
|
controllerId: CONTROLLER_ID,
|
|
790
923
|
browser: this.#config.browser,
|
|
@@ -810,6 +943,7 @@ var MastraFactory = class {
|
|
|
810
943
|
workspaceRegistry
|
|
811
944
|
}),
|
|
812
945
|
disableGithubSignals: true,
|
|
946
|
+
disableMcp: true,
|
|
813
947
|
prepareWakeRequestContext: async ({ requestContext, resourceId, threadId }) => {
|
|
814
948
|
if (!storage.isDomainReady("source-control")) {
|
|
815
949
|
if (auth) await failWake({
|
|
@@ -1045,6 +1179,17 @@ var MastraFactory = class {
|
|
|
1045
1179
|
if (integration.agentTools) mergeTools(integration.id, await integration.agentTools({ requestContext }));
|
|
1046
1180
|
if (integration.sessionTools) mergeTools(integration.id, integration.sessionTools({ requestContext }));
|
|
1047
1181
|
}
|
|
1182
|
+
if (sessionTools) {
|
|
1183
|
+
const contributed = typeof sessionTools === "function" ? await sessionTools({ requestContext }) : sessionTools;
|
|
1184
|
+
for (const [name, tool] of Object.entries(contributed)) {
|
|
1185
|
+
const owner = toolOwners.get(name);
|
|
1186
|
+
if (!owner) tools[name] = tool;
|
|
1187
|
+
else if (!warnedConfiguredToolClashes.has(name)) {
|
|
1188
|
+
warnedConfiguredToolClashes.add(name);
|
|
1189
|
+
console.warn(`[factory] configured tool '${name}' is not offered to sessions: '${owner}' already provides a tool with that name.`);
|
|
1190
|
+
}
|
|
1191
|
+
}
|
|
1192
|
+
}
|
|
1048
1193
|
return tools;
|
|
1049
1194
|
},
|
|
1050
1195
|
postToolObserver: async (toolContext) => {
|
|
@@ -1167,13 +1312,22 @@ var MastraFactory = class {
|
|
|
1167
1312
|
reconcileToolResults: () => factoryProcessor?.reconcileAllBoundThreads() ?? Promise.resolve(),
|
|
1168
1313
|
prepareBinding,
|
|
1169
1314
|
feedReader: new FactoryFeedReader(workItemCommentsStorage),
|
|
1170
|
-
...githubIntegration ? {
|
|
1171
|
-
|
|
1172
|
-
|
|
1173
|
-
|
|
1174
|
-
|
|
1175
|
-
|
|
1176
|
-
|
|
1315
|
+
...githubIntegration ? {
|
|
1316
|
+
dismissStaleReviews: async (decision) => {
|
|
1317
|
+
await dismissStaleFactoryReviews(githubIntegration.versionControl, decision, (login) => isFactoryGithubLogin(githubIntegration, login), (login) => trustedCollaborator(githubIntegration, {
|
|
1318
|
+
installationId: decision.installationId,
|
|
1319
|
+
repository: decision.repository,
|
|
1320
|
+
login
|
|
1321
|
+
}));
|
|
1322
|
+
},
|
|
1323
|
+
reportReviewStatus: createGithubReviewStatusReporter({
|
|
1324
|
+
github: githubIntegration,
|
|
1325
|
+
sourceControl: sourceControlStorage.forIntegration(githubIntegration.id),
|
|
1326
|
+
workItems: workItemsStorage,
|
|
1327
|
+
reviewerName: process.env.FACTORY_REVIEW_STATUS_NAME?.trim() || "Factory",
|
|
1328
|
+
...reviewStatusAnimationFromEnv(process.env)
|
|
1329
|
+
})
|
|
1330
|
+
} : {},
|
|
1177
1331
|
primeCredentials: (tenant) => primeTenantCredentials({
|
|
1178
1332
|
tenant,
|
|
1179
1333
|
credentials: modelCredentialsStorage
|
|
@@ -1203,7 +1357,11 @@ var MastraFactory = class {
|
|
|
1203
1357
|
...hasPlatformCredentials() ? buildPlatformConnectRoutes({
|
|
1204
1358
|
auth: routeAuth,
|
|
1205
1359
|
client: new PlatformApiClient(platformApiClientConfigFromEnv())
|
|
1206
|
-
}) : []
|
|
1360
|
+
}) : [],
|
|
1361
|
+
buildConnectToolsRoute(routeAuth, connectToolsProjectId ? {
|
|
1362
|
+
client: new PlatformApiClient(platformApiClientConfigFromEnv()),
|
|
1363
|
+
projectId: connectToolsProjectId
|
|
1364
|
+
} : void 0)
|
|
1207
1365
|
],
|
|
1208
1366
|
buildServerConfig: () => {
|
|
1209
1367
|
const mcpCors = {
|
|
@@ -1385,6 +1543,7 @@ var MastraFactory = class {
|
|
|
1385
1543
|
await timedPhase("finalize.reconcileBoundThreads", () => this.#factoryProcessor?.reconcileAllBoundThreads() ?? Promise.resolve());
|
|
1386
1544
|
this.#sessionResourceMigration?.then((movedRunBindings) => movedRunBindings ? this.#factoryProcessor?.reconcileAllBoundThreads() : void 0).catch((error) => console.warn(`[factory] reconciling bound threads after the session resource migration failed: ${error instanceof Error ? error.message : error}`));
|
|
1387
1545
|
this.#dispatcher?.start();
|
|
1546
|
+
if (this.#prepareStartedAt !== void 0) logTiming(`boot ${Math.round(performance.now() - this.#prepareStartedAt)}ms`);
|
|
1388
1547
|
}
|
|
1389
1548
|
/** Stop Factory-owned background work and channel transports before the host process shuts down. */
|
|
1390
1549
|
async shutdown() {
|
|
@@ -1395,8 +1554,14 @@ var MastraFactory = class {
|
|
|
1395
1554
|
const unsubscribeDispatchWakes = this.#unsubscribeDispatchWakes;
|
|
1396
1555
|
this.#unsubscribeDispatchWakes = void 0;
|
|
1397
1556
|
await unsubscribeDispatchWakes?.then((unsubscribe) => unsubscribe?.()).catch((error) => console.warn(`[factory] unsubscribing from dispatcher wakes failed: ${error instanceof Error ? error.message : error}`));
|
|
1398
|
-
const
|
|
1399
|
-
|
|
1557
|
+
const backfill = this.#workItemSplitBackfill;
|
|
1558
|
+
backfill?.controller.abort();
|
|
1559
|
+
const results = await Promise.allSettled([
|
|
1560
|
+
this.#dispatcher?.stop() ?? Promise.resolve(),
|
|
1561
|
+
backfill?.promise ?? Promise.resolve(),
|
|
1562
|
+
...channelShutdowns.map(async (shutdown) => shutdown())
|
|
1563
|
+
]);
|
|
1564
|
+
results.slice(2).forEach((result, index) => {
|
|
1400
1565
|
if (result.status === "rejected") this.#channelShutdowns.push(channelShutdowns[index]);
|
|
1401
1566
|
});
|
|
1402
1567
|
const failure = results.find((result) => result.status === "rejected");
|