@mastra/factory 0.28.0-alpha.0 → 0.28.0-alpha.2
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 +12 -11
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"voice-clips.js","names":[],"sources":["../../../src/integrations/slack/voice-clips.ts"],"sourcesContent":["import type { ChannelHandler } from '@mastra/core/channels';\nimport { classifyProviderError } from '@mastra/core/error';\nimport type { ProviderFailureKind } from '@mastra/core/error';\nimport { Actions, Card, CardText, LinkButton } from 'chat';\nimport { z } from 'zod';\n\nimport { tenantOrgId } from '../../routes/provider-credentials.js';\nimport type { ModelCredentialsStorage } from '../../storage/domains/credentials/base.js';\nimport { effectiveModelScope } from '../../storage/domains/projects/base.js';\nimport type { VoiceSettingsStorage } from '../../storage/domains/voice-settings/base.js';\nimport type { STTChoice, STTSelection, VoiceFactory } from '../../voice/transcription.js';\nimport {\n chooseSTTModel,\n MAX_TRANSCRIBE_AUDIO_BYTES,\n savedSTTModel,\n tenantVoiceCaller,\n transcribeAudio,\n transcriptionFailureReason,\n voicePolicy,\n} from '../../voice/transcription.js';\nimport { voiceSettingsLink } from './channel-reply-processor.js';\n\ntype HandlerMessage = Parameters<ChannelHandler>[1];\ntype HandlerAttachment = HandlerMessage['attachments'][number];\n\n/** Download plus provider call, per clip. The provider call isn't cancelled; a late result is dropped. */\nexport const VOICE_CLIP_TIMEOUT_MS = 60_000;\n\ntype VoiceClipFix = 'settings' | 'retry' | 'shorter' | 'rerecord' | 'none';\n\nexport interface VoiceClipFailure {\n reason: string;\n fix: VoiceClipFix;\n}\n\nexport interface VoiceClipReport {\n transcribed: number;\n failures: VoiceClipFailure[];\n settingsFactoryId?: string;\n}\n\nexport interface VoiceClipFactories {\n run?: () => Promise<VoiceFactory | undefined>;\n home?: () => Promise<VoiceFactory | undefined>;\n}\n\ntype ClipOutcome = { transcript: string } | VoiceClipFailure;\n\nconst DOWNLOAD_FAILED: VoiceClipFailure = { reason: 'The clip could not be downloaded.', fix: 'retry' };\nconst TOO_LONG: VoiceClipFailure = { reason: 'The clip is too long.', fix: 'shorter' };\n\nexport interface VoiceClipDeps {\n modelCredentials?: ModelCredentialsStorage;\n voiceSettings?: VoiceSettingsStorage;\n}\n\nconst slackEventFiles = z.object({\n files: z.array(z.object({ subtype: z.string().optional(), url_private: z.string().optional() })),\n});\n\n/** Slack marks composer recordings with `subtype: 'slack_audio'` and names them `audio_message.*`; other audio is an upload. */\nfunction recordedClipUrls(message: HandlerMessage): Set<string> {\n const event = slackEventFiles.safeParse(message.raw);\n if (!event.success) return new Set();\n return new Set(\n event.data.files.flatMap(file => (file.subtype === 'slack_audio' && file.url_private ? [file.url_private] : [])),\n );\n}\n\nfunction voiceClips(message: HandlerMessage): HandlerAttachment[] {\n const recorded = recordedClipUrls(message);\n return message.attachments.filter(\n attachment =>\n (attachment.url !== undefined && recorded.has(attachment.url)) ||\n ((attachment.type === 'audio' || attachment.type === 'video') &&\n (attachment.name?.startsWith('audio_message') ?? false)),\n );\n}\n\nfunction say(message: HandlerMessage, text: string): void {\n message.text = message.text ? `${message.text}\\n\\n${text}` : text;\n message.formatted.children.push({ type: 'paragraph', children: [{ type: 'text', value: text }] });\n}\n\nfunction detach(message: HandlerMessage, clip: HandlerAttachment): void {\n message.attachments = message.attachments.filter(attachment => attachment !== clip);\n}\n\nfunction sentence(fragment: string): string {\n return `${fragment.charAt(0).toUpperCase()}${fragment.slice(1)}.`;\n}\n\nconst SETUP_FAILURES = new Set<ProviderFailureKind>(['auth', 'quota', 'model_rejected']);\n\nfunction providerFailure(error: unknown): VoiceClipFailure {\n return {\n reason: sentence(transcriptionFailureReason(error)),\n fix: SETUP_FAILURES.has(classifyProviderError(error)) ? 'settings' : 'retry',\n };\n}\n\nasync function transcribeClip(\n selection: STTSelection,\n fetchData: () => Promise<Buffer | ArrayBuffer>,\n mimeType: string,\n): Promise<ClipOutcome> {\n const data = await fetchData().catch((error: unknown) => {\n console.warn('[slack] voice clip download failed', { error });\n return undefined;\n });\n if (data === undefined) return DOWNLOAD_FAILED;\n const audio = data instanceof ArrayBuffer ? Buffer.from(data) : data;\n if (audio.byteLength > MAX_TRANSCRIBE_AUDIO_BYTES) return TOO_LONG;\n const transcript = await transcribeAudio(selection, audio, mimeType);\n return transcript ? { transcript } : { reason: 'No speech was detected in the clip.', fix: 'rerecord' };\n}\n\nasync function withinTimeout(work: Promise<ClipOutcome>): Promise<ClipOutcome> {\n let timer: NodeJS.Timeout | undefined;\n const timedOut = new Promise<ClipOutcome>(resolve => {\n timer = setTimeout(\n () => resolve({ reason: `Transcription timed out after ${VOICE_CLIP_TIMEOUT_MS / 1000} seconds.`, fix: 'retry' }),\n VOICE_CLIP_TIMEOUT_MS,\n );\n });\n try {\n return await Promise.race([work, timedOut]);\n } finally {\n clearTimeout(timer);\n }\n}\n\nasync function resolveSettingsFactory(\n run: VoiceFactory | undefined,\n home: VoiceClipFactories['home'],\n): Promise<string | undefined> {\n if (run) return run.id;\n const factory = await home?.().catch((error: unknown) => {\n console.warn('[slack] voice clip settings Factory lookup failed', { error });\n return undefined;\n });\n return factory && effectiveModelScope(factory.modelScope, 'session') !== 'factory' ? factory.id : undefined;\n}\n\nasync function transcribeAll(\n clips: { message: HandlerMessage; clip: HandlerAttachment }[],\n sender: { orgId?: string; userId: string },\n modelCredentials: ModelCredentialsStorage,\n voiceSettings: VoiceSettingsStorage | undefined,\n factory: VoiceFactory | undefined,\n): Promise<VoiceClipFailure[]> {\n const failEvery = (failure: VoiceClipFailure) => clips.map(() => failure);\n const orgId = tenantOrgId(sender);\n let choice: STTChoice;\n try {\n const records = await modelCredentials.listCredentials(orgId, sender.userId);\n const policy = voicePolicy(tenantVoiceCaller(records, orgId, sender.userId), factory);\n const saved = voiceSettings ? await savedSTTModel(voiceSettings, policy.settingsKey) : undefined;\n choice = chooseSTTModel(policy, saved);\n } catch (error) {\n console.warn('[slack] voice clip settings lookup failed', { error });\n return failEvery({ reason: 'Speech-to-text settings could not be loaded.', fix: 'retry' });\n }\n if ('error' in choice) return failEvery({ reason: choice.error, fix: 'settings' });\n\n const failures: VoiceClipFailure[] = [];\n for (const { message, clip } of clips) {\n const outcome = await transcribeAttachment(choice, message, clip);\n if ('transcript' in outcome) say(message, outcome.transcript);\n else failures.push(outcome);\n }\n return failures;\n}\n\nexport async function transcribeVoiceClips(\n messages: readonly HandlerMessage[],\n sender: { orgId?: string; userId: string } | undefined,\n deps: VoiceClipDeps,\n factories: VoiceClipFactories = {},\n): Promise<VoiceClipReport> {\n const clips = messages.flatMap(message => voiceClips(message).map(clip => ({ message, clip })));\n if (clips.length === 0) return { transcribed: 0, failures: [] };\n\n if (!sender || !deps.modelCredentials) {\n for (const { message, clip } of clips) detach(message, clip);\n const failure: VoiceClipFailure = {\n reason: 'Voice clips need a linked Mastra account with a speech-to-text API key.',\n fix: 'none',\n };\n return { transcribed: 0, failures: clips.map(() => failure) };\n }\n\n // Routing failures stay fatal: the message must not run under the wrong Factory.\n const factory = await factories.run?.();\n const failures = await transcribeAll(clips, sender, deps.modelCredentials, deps.voiceSettings, factory);\n for (const { message, clip } of clips) detach(message, clip);\n const transcribed = clips.length - failures.length;\n if (!failures.some(failure => failure.fix === 'settings')) return { transcribed, failures };\n const settingsFactoryId = await resolveSettingsFactory(factory, factories.home);\n return settingsFactoryId ? { transcribed, failures, settingsFactoryId } : { transcribed, failures };\n}\n\nasync function transcribeAttachment(\n selection: STTSelection,\n message: HandlerMessage,\n clip: HandlerAttachment,\n): Promise<ClipOutcome> {\n if (!clip.fetchData) return DOWNLOAD_FAILED;\n if (clip.size !== undefined && clip.size > MAX_TRANSCRIBE_AUDIO_BYTES) return TOO_LONG;\n try {\n return await withinTimeout(transcribeClip(selection, clip.fetchData, clip.mimeType ?? 'audio/mp4'));\n } catch (error) {\n console.warn('[slack] voice clip transcription failed', { messageId: message.id, error });\n return providerFailure(error);\n }\n}\n\nfunction nextStep(fix: VoiceClipFix, retryHint: string): string | undefined {\n switch (fix) {\n case 'settings':\n return `Once that's fixed, ${retryHint} with the clip.`;\n case 'retry':\n return `Wait a moment, then ${retryHint} with the clip.`;\n case 'shorter':\n return 'Record a shorter clip, or type your message instead.';\n case 'rerecord':\n return 'Record the clip again.';\n case 'none':\n return undefined;\n }\n}\n\nexport function voiceClipFailureCard({ failures, settingsFactoryId }: VoiceClipReport, retryHint: string) {\n const reasons = [...new Set(failures.map(failure => failure.reason))];\n const fixes = [...new Set(failures.map(failure => failure.fix))];\n const steps = fixes.flatMap(fix => nextStep(fix, retryHint) ?? []);\n const settingsUrl = fixes.includes('settings') && settingsFactoryId ? voiceSettingsLink(settingsFactoryId) : undefined;\n return Card({\n title: failures.length === 1 ? 'Voice clip not transcribed' : `${failures.length} voice clips not transcribed`,\n children: [\n CardText(reasons.join('\\n')),\n ...(steps.length > 0 ? [CardText(steps.join(' '))] : []),\n ...(settingsUrl ? [Actions([LinkButton({ url: settingsUrl, label: 'Open voice settings' })])] : []),\n ],\n });\n}\n"],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"integration.d.ts","sourceRoot":"","sources":["../../../src/integrations/workos/integration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAIpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEzE,KAAK,YAAY,GAAG,qBAAqB,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;
|
|
1
|
+
{"version":3,"file":"integration.d.ts","sourceRoot":"","sources":["../../../src/integrations/workos/integration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAIpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEzE,KAAK,YAAY,GAAG,qBAAqB,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;AAqBvE,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,IAAI,CAAC;IACjB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACpC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5D,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CACrD,CAgBA;AAED,sFAAsF;AACtF,qBAAa,sBAAuB,YAAW,kBAAkB;;IAC/D,QAAQ,CAAC,EAAE,YAAY;IAIvB,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE;QAAE,MAAM,EAAE,YAAY,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAG7E;IAEK,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE;QAAE,KAAK,EAAE,aAAa,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAS9D;IAED,MAAM,CAAC,GAAG,EAAE,kBAAkB,GAAG,QAAQ,EAAE,CA8B1C;IAED,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAErC;CACF"}
|
|
@@ -1,10 +1,8 @@
|
|
|
1
|
+
import { loose } from "../../routes/route.js";
|
|
1
2
|
import { WorkOSAdminPortal } from "@mastra/auth-workos";
|
|
2
3
|
import { registerApiRoute } from "@mastra/core/server";
|
|
3
4
|
// src/integrations/workos/integration.ts
|
|
4
5
|
const UNKNOWN_LOCATION = "unknown";
|
|
5
|
-
function loose(c) {
|
|
6
|
-
return c;
|
|
7
|
-
}
|
|
8
6
|
function flattenMetadata(metadata) {
|
|
9
7
|
const flat = {};
|
|
10
8
|
for (const [key, value] of Object.entries(metadata)) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"integration.js","names":[],"sources":["../../../src/integrations/workos/integration.ts"],"sourcesContent":["import { WorkOSAdminPortal } from '@mastra/auth-workos';\nimport type { ApiRoute } from '@mastra/core/server';\nimport { registerApiRoute } from '@mastra/core/server';\nimport
|
|
1
|
+
{"version":3,"file":"integration.js","names":[],"sources":["../../../src/integrations/workos/integration.ts"],"sourcesContent":["import { WorkOSAdminPortal } from '@mastra/auth-workos';\nimport type { ApiRoute } from '@mastra/core/server';\nimport { registerApiRoute } from '@mastra/core/server';\n\nimport { loose } from '../../routes/route.js';\nimport type { AuditEventRow } from '../../storage/domains/audit/base.js';\nimport type { FactoryIntegration, IntegrationContext } from '../base.js';\n\ntype WorkOSClient = ConstructorParameters<typeof WorkOSAdminPortal>[0];\n\nconst UNKNOWN_LOCATION = 'unknown';\n\nfunction flattenMetadata(metadata: Record<string, unknown>): Record<string, string | number | boolean> {\n const flat: Record<string, string | number | boolean> = {};\n for (const [key, value] of Object.entries(metadata)) {\n if (value === undefined || value === null) continue;\n if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {\n flat[key] = value;\n continue;\n }\n try {\n flat[key] = JSON.stringify(value);\n } catch {\n // Drop unserializable metadata rather than the event.\n }\n }\n return flat;\n}\n\nexport function toWorkOSEvent(event: AuditEventRow): {\n action: string;\n occurredAt: Date;\n actor: { type: string; id: string };\n targets: Array<{ type: string; id: string; name?: string }>;\n context: { location: string; userAgent?: string };\n metadata: Record<string, string | number | boolean>;\n} {\n return {\n action: event.action,\n occurredAt: event.occurredAt,\n actor: { type: event.actorType === 'human' ? 'user' : event.actorType, id: event.actorId },\n targets: event.targets.map(target => ({\n type: target.type,\n id: target.id,\n ...(target.name !== undefined ? { name: target.name } : {}),\n })),\n context: {\n location: event.context.location ?? UNKNOWN_LOCATION,\n ...(event.context.userAgent !== undefined ? { userAgent: event.context.userAgent } : {}),\n },\n metadata: flattenMetadata(event.metadata),\n };\n}\n\n/** Optional WorkOS mirror and Admin Portal route, independent of the auth adapter. */\nexport class WorkOSAuditIntegration implements FactoryIntegration {\n readonly id = 'workos';\n readonly #client: WorkOSClient;\n readonly #returnUrl: string;\n\n constructor({ client, returnUrl }: { client: WorkOSClient; returnUrl: string }) {\n this.#client = client;\n this.#returnUrl = returnUrl;\n }\n\n async audit({ event }: { event: AuditEventRow }): Promise<void> {\n try {\n await this.#client.auditLogs.createEvent(event.orgId, toWorkOSEvent(event));\n } catch (err) {\n console.warn('[Audit] Failed to forward audit event to WorkOS', {\n action: event.action,\n error: err instanceof Error ? err.message : String(err),\n });\n }\n }\n\n routes(ctx: IntegrationContext): ApiRoute[] {\n const { auth } = ctx;\n return [\n registerApiRoute('/web/audit/portal-link', {\n method: 'GET',\n handler: async cc => {\n const c = loose(cc);\n await auth.ensureUser(c);\n const tenant = auth.tenant(c);\n if (!tenant) return c.json({ error: 'unauthorized' }, 401);\n if (!tenant.orgId) {\n return c.json(\n { error: 'organization_required', message: 'The audit trail requires a WorkOS organization.' },\n 403,\n );\n }\n\n try {\n const portal = new WorkOSAdminPortal(this.#client, { returnUrl: this.#returnUrl });\n const url = await portal.getPortalLink(tenant.orgId, 'audit_logs');\n return c.json({ url });\n } catch (err) {\n console.warn('[Audit] Failed to generate WorkOS Admin Portal link', {\n error: err instanceof Error ? err.message : String(err),\n });\n return c.json({ error: 'portal_link_failed' }, 502);\n }\n },\n }),\n ];\n }\n\n diagnostics(): Record<string, unknown> {\n return { configured: true };\n }\n}\n"],"mappings":";;;;AAUA,MAAM,mBAAmB;AAEzB,SAAS,gBAAgB,UAA8E;CACrG,MAAM,OAAkD,CAAC;CACzD,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,GAAG;EACnD,IAAI,UAAU,KAAA,KAAa,UAAU,MAAM;EAC3C,IAAI,OAAO,UAAU,YAAY,OAAO,UAAU,YAAY,OAAO,UAAU,WAAW;GACxF,KAAK,OAAO;GACZ;EACF;EACA,IAAI;GACF,KAAK,OAAO,KAAK,UAAU,KAAK;EAClC,QAAQ,CAER;CACF;CACA,OAAO;AACT;AAEA,SAAgB,cAAc,OAO5B;CACA,OAAO;EACL,QAAQ,MAAM;EACd,YAAY,MAAM;EAClB,OAAO;GAAE,MAAM,MAAM,cAAc,UAAU,SAAS,MAAM;GAAW,IAAI,MAAM;EAAQ;EACzF,SAAS,MAAM,QAAQ,KAAI,YAAW;GACpC,MAAM,OAAO;GACb,IAAI,OAAO;GACX,GAAI,OAAO,SAAS,KAAA,IAAY,EAAE,MAAM,OAAO,KAAK,IAAI,CAAC;EAC3D,EAAE;EACF,SAAS;GACP,UAAU,MAAM,QAAQ,YAAY;GACpC,GAAI,MAAM,QAAQ,cAAc,KAAA,IAAY,EAAE,WAAW,MAAM,QAAQ,UAAU,IAAI,CAAC;EACxF;EACA,UAAU,gBAAgB,MAAM,QAAQ;CAC1C;AACF;;AAGA,IAAa,yBAAb,MAAkE;CAChE,KAAc;CACd;CACA;CAEA,YAAY,EAAE,QAAQ,aAA0D;EAC9E,KAAK,UAAU;EACf,KAAK,aAAa;CACpB;CAEA,MAAM,MAAM,EAAE,SAAkD;EAC9D,IAAI;GACF,MAAM,KAAK,QAAQ,UAAU,YAAY,MAAM,OAAO,cAAc,KAAK,CAAC;EAC5E,SAAS,KAAK;GACZ,QAAQ,KAAK,mDAAmD;IAC9D,QAAQ,MAAM;IACd,OAAO,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;GACxD,CAAC;EACH;CACF;CAEA,OAAO,KAAqC;EAC1C,MAAM,EAAE,SAAS;EACjB,OAAO,CACL,iBAAiB,0BAA0B;GACzC,QAAQ;GACR,SAAS,OAAM,OAAM;IACnB,MAAM,IAAI,MAAM,EAAE;IAClB,MAAM,KAAK,WAAW,CAAC;IACvB,MAAM,SAAS,KAAK,OAAO,CAAC;IAC5B,IAAI,CAAC,QAAQ,OAAO,EAAE,KAAK,EAAE,OAAO,eAAe,GAAG,GAAG;IACzD,IAAI,CAAC,OAAO,OACV,OAAO,EAAE,KACP;KAAE,OAAO;KAAyB,SAAS;IAAkD,GAC7F,GACF;IAGF,IAAI;KAEF,MAAM,MAAM,MAAM,IADC,kBAAkB,KAAK,SAAS,EAAE,WAAW,KAAK,WAAW,CACzD,CAAC,CAAC,cAAc,OAAO,OAAO,YAAY;KACjE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC;IACvB,SAAS,KAAK;KACZ,QAAQ,KAAK,uDAAuD,EAClE,OAAO,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,EACxD,CAAC;KACD,OAAO,EAAE,KAAK,EAAE,OAAO,qBAAqB,GAAG,GAAG;IACpD;GACF;EACF,CAAC,CACH;CACF;CAEA,cAAuC;EACrC,OAAO,EAAE,YAAY,KAAK;CAC5B;AACF"}
|
package/dist/mcp/routes.js
CHANGED
|
@@ -7,8 +7,8 @@ import { createFactoryTools } from "../tools/index.js";
|
|
|
7
7
|
import { propagateClientDisconnect } from "./disconnect.js";
|
|
8
8
|
import { factoryActivityEvent } from "./events.js";
|
|
9
9
|
import { registerApiRoute } from "@mastra/core/server";
|
|
10
|
-
import { z } from "zod";
|
|
11
10
|
import { createHash } from "crypto";
|
|
11
|
+
import { z } from "zod";
|
|
12
12
|
import { createTool } from "@mastra/core/tools";
|
|
13
13
|
import { MCPServer } from "@mastra/mcp";
|
|
14
14
|
import { toFetchResponse, toReqRes } from "fetch-to-node";
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import "@mastra/core/workspace";
|
|
2
|
-
import { createHash } from "crypto";
|
|
3
2
|
import "path";
|
|
3
|
+
import { createHash } from "crypto";
|
|
4
4
|
// ../../packages/_internals/workspace/dist/index.js
|
|
5
5
|
/** Directory, relative to the template's build cwd, that holds every marker below. */
|
|
6
6
|
const SETUP_MARKER_DIR = ".mastra-sandbox";
|
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import "../boards/index.js";
|
|
2
1
|
import { boardForWorkItem } from "../boards/semantics.js";
|
|
2
|
+
import "../boards/index.js";
|
|
3
3
|
import { factoryActivityAttentionIdentity, factoryAttentionKey } from "../storage/domains/work-items/base.js";
|
|
4
4
|
import { collectPage, markScanRead, matchesView, receiptScope, scanBatches } from "./attention-providers.js";
|
|
5
5
|
// src/routes/attention-activity.ts
|
|
@@ -1,6 +1,6 @@
|
|
|
1
|
+
import { boardForWorkItem } from "../boards/semantics.js";
|
|
1
2
|
import "../boards/index.js";
|
|
2
3
|
import { toBoardSource } from "../boards/project-boards.js";
|
|
3
|
-
import { boardForWorkItem } from "../boards/semantics.js";
|
|
4
4
|
import { decisionRetryable, overtakenDecisionIds } from "../rules/decision-applicability.js";
|
|
5
5
|
import { factoryDispatchFailureMetadata } from "../rules/dispatch-errors.js";
|
|
6
6
|
import { factoryAttentionKey, factoryDecisionAttentionIdentity, factoryMentionAttentionIdentity } from "../storage/domains/work-items/base.js";
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"automation-runs.d.ts","sourceRoot":"","sources":["../../src/routes/automation-runs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAMpD,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAEtF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAE9E,OAAO,
|
|
1
|
+
{"version":3,"file":"automation-runs.d.ts","sourceRoot":"","sources":["../../src/routes/automation-runs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAMpD,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAEtF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAE9E,OAAO,EAAS,KAAK,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAyCpD,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,KAAK,EAAE,YAAY,GAAG,aAAa,CAAC;IACpC,yFAAyF;IACzF,QAAQ,EAAE,sBAAsB,CAAC;IACjC,wDAAwD;IACxD,SAAS,EAAE,gBAAgB,CAAC;IAC5B,+DAA+D;IAC/D,aAAa,EAAE,MAAM,CAAC;CACvB;AASD,qBAAa,mBAAoB,SAAQ,KAAK,CAAC,uBAAuB,CAAC;;IAmFrE,MAAM,IAAI,QAAQ,EAAE,CAyHnB;CACF;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,uBAAuB,GAAG,QAAQ,EAAE,CAElF"}
|
|
@@ -1,11 +1,8 @@
|
|
|
1
1
|
import { auditRequestContext } from "../storage/domains/audit/domain.js";
|
|
2
2
|
import { FACTORY_ROUTE_CONTRACTS } from "./contracts.js";
|
|
3
|
-
import { Route } from "./route.js";
|
|
3
|
+
import { Route, loose } from "./route.js";
|
|
4
4
|
import { registerApiRoute } from "@mastra/core/server";
|
|
5
5
|
// src/routes/automation-runs.ts
|
|
6
|
-
function loose(c) {
|
|
7
|
-
return c;
|
|
8
|
-
}
|
|
9
6
|
/**
|
|
10
7
|
* Whether a replayed rule-evaluation record describes the SAME operation as the
|
|
11
8
|
* current request. `commitRuleEvaluation` keys idempotency on `(org, project,
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"automation-runs.js","names":[],"sources":["../../src/routes/automation-runs.ts"],"sourcesContent":["/**\n * Mastra `apiRoutes` for trusted external orchestrators to enqueue an\n * idempotent, deferred skill dispatch against a Factory work item.\n *\n * The endpoint is a constrained ingress in front of\n * `WorkItemsStorage.commitRuleEvaluation()`: it commits exactly one\n * `invokeSkill` decision, stamps a non-human system actor, and leaves\n * execution (session creation, auto-run/approval policy, retry, restart\n * recovery) to the `FactoryDecisionDispatcher`.\n *\n * Idempotency: the `requestId` becomes the ingress identity, so replaying the\n * same request returns the prior result without inserting a second decision.\n * Tenant-mode callers must administer the organization; local (no-auth)\n * deployments run under the shared `local` storage scope without inventing a\n * tenant user.\n */\n\nimport type { ApiRoute } from '@mastra/core/server';\nimport { registerApiRoute } from '@mastra/core/server';\nimport type { Context } from 'hono';\n\nimport type { AuditAction } from '../storage/domains/audit/actions.js';\nimport type { AuditTarget } from '../storage/domains/audit/base.js';\nimport type { AuditEmitter, AuditRecorder } from '../storage/domains/audit/domain.js';\nimport { auditRequestContext } from '../storage/domains/audit/domain.js';\nimport type { FactoryProjectsStorage } from '../storage/domains/projects/base.js';\nimport type { WorkItemsStorage } from '../storage/domains/work-items/base.js';\nimport { FACTORY_ROUTE_CONTRACTS } from './contracts.js';\nimport { Route } from './route.js';\nimport type { RouteDependencies } from './route.js';\n\nfunction loose(c: unknown): Context {\n return c as Context;\n}\n\n/** The invokeSkill payload this route commits, matched against a prior replay. */\ninterface AutomationInvokeSkillDecision {\n type: 'invokeSkill';\n idempotencyKey: string;\n role: string;\n skillName: string;\n arguments?: string;\n}\n\n/**\n * Whether a replayed rule-evaluation record describes the SAME operation as the\n * current request. `commitRuleEvaluation` keys idempotency on `(org, project,\n * ingress identity)` alone, so a reused `requestId` replays regardless of the\n * work item or decision payload. We reconstruct the prior `invokeSkill`\n * decision from the stored result and compare the item id, role, skill, and\n * arguments; any divergence is a collision, not a legitimate retry.\n */\nfunction replayMatchesRequest(\n result: { itemId?: string | null; decisions?: unknown[] },\n itemId: string,\n request: AutomationInvokeSkillDecision,\n): boolean {\n if (result.itemId != null && result.itemId !== itemId) return false;\n const decisions = Array.isArray(result.decisions) ? result.decisions : [];\n const prior = decisions.find(\n (candidate): candidate is Record<string, unknown> =>\n typeof candidate === 'object' &&\n candidate !== null &&\n (candidate as Record<string, unknown>).type === 'invokeSkill' &&\n (candidate as Record<string, unknown>).idempotencyKey === request.idempotencyKey,\n );\n if (!prior) return false;\n return (\n prior.role === request.role &&\n prior.skillName === request.skillName &&\n (prior.arguments ?? undefined) === (request.arguments ?? undefined)\n );\n}\n\nexport interface AutomationRunRoutesDeps extends RouteDependencies {\n audit: AuditEmitter & AuditRecorder;\n /** Factory projects domain — validates the `:id` project belongs to the caller's org. */\n projects: FactoryProjectsStorage;\n /** Work-items domain backing `commitRuleEvaluation`. */\n workItems: WorkItemsStorage;\n /** Config version stamped on the committed rule evaluation. */\n configVersion: string;\n}\n\n/** Resolved ingress scope for an automation-run request. */\ninterface AutomationRunScope {\n orgId: string;\n userId: string;\n factoryProjectId: string;\n}\n\nexport class AutomationRunRoutes extends Route<AutomationRunRoutesDeps> {\n /**\n * Resolve the `(orgId, userId)` ingress scope. Tenant mode requires a\n * signed-in organization administrator; local (no-auth) mode runs under the\n * shared `local` scope without inventing a user.\n */\n async #resolveScope(c: Context): Promise<{ orgId: string; userId: string } | { response: Response }> {\n const { auth } = this.deps;\n if (!auth.enabled()) {\n return { orgId: 'local', userId: 'local' };\n }\n await auth.ensureUser(c);\n const tenant = auth.tenant(c);\n if (!tenant) return { response: c.json({ error: 'unauthorized' }, 401) };\n if (!tenant.orgId) {\n return {\n response: c.json(\n { error: 'organization_required', message: 'The Factory board requires an organization.' },\n 403,\n ),\n };\n }\n if (!(await auth.isOrganizationAdmin(c, tenant.orgId))) {\n return {\n response: c.json(\n { error: 'forbidden', message: 'Organization administrator access is required for automation ingress.' },\n 403,\n ),\n };\n }\n return { orgId: tenant.orgId, userId: tenant.userId };\n }\n\n /** Resolve the ingress scope AND the org-owned project from the `:id` param. */\n async #resolveProject(c: Context): Promise<AutomationRunScope | { response: Response }> {\n const scope = await this.#resolveScope(c);\n if ('response' in scope) return scope;\n\n const parsedPath = FACTORY_ROUTE_CONTRACTS.projectGet.pathSchema.safeParse({ id: c.req.param('id') });\n if (!parsedPath.success) {\n return { response: c.json({ error: 'Project not found' }, 404) };\n }\n const { projects } = this.deps;\n await projects.ensureReady();\n const project = await projects.get({ orgId: scope.orgId, id: parsedPath.data.id });\n if (!project) {\n return { response: c.json({ error: 'Project not found' }, 404) };\n }\n return { ...scope, factoryProjectId: parsedPath.data.id };\n }\n\n /**\n * Persist an audit event under the ingress-resolved scope. This route can run\n * under the synthetic `local` no-auth scope, where the tenant-gated\n * `audit.emit()` derives no org from the request and drops the event; writing\n * through `record()` with the explicit org + system actor keeps traceability\n * in every deployment mode.\n *\n * The `idempotencyKey` (`<action>:<requestId>`) makes the audit write itself\n * idempotent: replaying the same request re-enters this path, but the trail\n * keeps a single event per requestId instead of one duplicate per retry.\n */\n async #writeAudit(\n c: Context,\n scope: AutomationRunScope,\n action: AuditAction,\n requestId: string,\n targets: AuditTarget[],\n metadata: Record<string, unknown>,\n ): Promise<void> {\n await this.deps.audit.record({\n idempotencyKey: `${action}:${requestId}`,\n orgId: scope.orgId,\n actorId: 'factory-external-orchestrator',\n actorType: 'system',\n action,\n targets,\n metadata,\n factoryProjectId: scope.factoryProjectId,\n context: auditRequestContext(c),\n });\n }\n\n routes(): ApiRoute[] {\n const { workItems, configVersion } = this.deps;\n const contract = FACTORY_ROUTE_CONTRACTS.workItemAutomationRun;\n\n return [\n registerApiRoute(contract.path, {\n method: contract.method,\n handler: async c => {\n const context = loose(c);\n const resolved = await this.#resolveProject(context);\n if ('response' in resolved) return resolved.response;\n\n const parsedPath = contract.pathSchema.safeParse({\n id: c.req.param('id'),\n workItemId: c.req.param('workItemId'),\n });\n if (!parsedPath.success) return c.json({ error: 'Work item not found' }, 404);\n\n const body = await c.req.json().catch(() => undefined);\n if (body === undefined) return c.json({ error: 'Invalid JSON body' }, 400);\n const parsed = contract.bodySchema.safeParse(body);\n if (!parsed.success) return c.json({ error: 'invalid_automation_run_request' }, 400);\n const request = parsed.data as {\n requestId: string;\n expectedRevision: number;\n role: string;\n skillName: string;\n arguments?: string;\n };\n\n const item = await workItems.getForProject(\n resolved.orgId,\n resolved.factoryProjectId,\n (parsedPath.data as { workItemId: string }).workItemId,\n );\n if (!item) return c.json({ error: 'Work item not found' }, 404);\n\n const idempotencyKey = `external-orchestrator:${request.requestId}`;\n const decision = {\n type: 'invokeSkill' as const,\n idempotencyKey,\n role: request.role,\n skillName: request.skillName,\n ...(request.arguments !== undefined ? { arguments: request.arguments } : {}),\n };\n\n const now = new Date();\n const commit = await workItems.commitRuleEvaluation({\n orgId: resolved.orgId,\n factoryProjectId: resolved.factoryProjectId,\n workItemId: item.id,\n ingress: { identity: idempotencyKey, triggerType: 'external-orchestrator.invoke-skill' },\n configVersion,\n expectedRevision: request.expectedRevision,\n actor: { type: 'system', id: 'factory-external-orchestrator' },\n outcome: { status: 'accepted' },\n decisions: [decision],\n causalChain: [],\n now,\n });\n\n if (commit.status === 'missing') return c.json({ error: 'Work item not found' }, 404);\n\n // A stale commit persists nothing, so the caller can retry the same\n // requestId once it has re-read the work item's revision.\n const result = (commit.status === 'stale' ? { status: 'rejected', code: 'stale' } : commit.result) as {\n status?: string;\n code?: string;\n itemId?: string | null;\n decisions?: unknown[];\n };\n const resultStatus = result.status ?? 'accepted';\n const code = typeof result.code === 'string' ? result.code : undefined;\n const targets = [{ type: 'work_item' as const, id: item.id, name: item.title }];\n\n const auditMetadata = {\n requestId: request.requestId,\n role: request.role,\n skillName: request.skillName,\n commitStatus: commit.status,\n resultStatus,\n ...(code ? { code } : {}),\n };\n\n // A replay only means \"this request was already committed\" — it must\n // be the SAME operation. If the caller reused a requestId against a\n // different work item, role, skill, or arguments, returning\n // `replayed` would report durable success for work that was never\n // enqueued. Reject the collision instead of silently swallowing it.\n if (commit.status === 'replayed' && !replayMatchesRequest(result, item.id, decision)) {\n await this.#writeAudit(context, resolved, 'factory.run.rejected', request.requestId, targets, {\n ...auditMetadata,\n resultStatus: 'rejected',\n code: 'request_id_conflict',\n });\n return c.json(\n {\n status: 'rejected',\n code: 'request_id_conflict',\n requestId: request.requestId,\n },\n 409,\n );\n }\n\n if (resultStatus === 'accepted') {\n await this.#writeAudit(context, resolved, 'factory.run.queued', request.requestId, targets, auditMetadata);\n return c.json(\n { status: commit.status === 'replayed' ? 'replayed' : 'committed', requestId: request.requestId },\n commit.status === 'replayed' ? 200 : 202,\n );\n }\n\n await this.#writeAudit(context, resolved, 'factory.run.rejected', request.requestId, targets, auditMetadata);\n return c.json(\n { status: 'rejected', ...(code ? { code } : {}), requestId: request.requestId },\n code === 'stale' ? 409 : 422,\n );\n },\n }),\n ];\n }\n}\n\nexport function buildAutomationRunRoutes(deps: AutomationRunRoutesDeps): ApiRoute[] {\n return new AutomationRunRoutes(deps).routes();\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"automation-runs.js","names":[],"sources":["../../src/routes/automation-runs.ts"],"sourcesContent":["/**\n * Mastra `apiRoutes` for trusted external orchestrators to enqueue an\n * idempotent, deferred skill dispatch against a Factory work item.\n *\n * The endpoint is a constrained ingress in front of\n * `WorkItemsStorage.commitRuleEvaluation()`: it commits exactly one\n * `invokeSkill` decision, stamps a non-human system actor, and leaves\n * execution (session creation, auto-run/approval policy, retry, restart\n * recovery) to the `FactoryDecisionDispatcher`.\n *\n * Idempotency: the `requestId` becomes the ingress identity, so replaying the\n * same request returns the prior result without inserting a second decision.\n * Tenant-mode callers must administer the organization; local (no-auth)\n * deployments run under the shared `local` storage scope without inventing a\n * tenant user.\n */\n\nimport type { ApiRoute } from '@mastra/core/server';\nimport { registerApiRoute } from '@mastra/core/server';\nimport type { Context } from 'hono';\n\nimport type { AuditAction } from '../storage/domains/audit/actions.js';\nimport type { AuditTarget } from '../storage/domains/audit/base.js';\nimport type { AuditEmitter, AuditRecorder } from '../storage/domains/audit/domain.js';\nimport { auditRequestContext } from '../storage/domains/audit/domain.js';\nimport type { FactoryProjectsStorage } from '../storage/domains/projects/base.js';\nimport type { WorkItemsStorage } from '../storage/domains/work-items/base.js';\nimport { FACTORY_ROUTE_CONTRACTS } from './contracts.js';\nimport { loose, Route } from './route.js';\nimport type { RouteDependencies } from './route.js';\n\n/** The invokeSkill payload this route commits, matched against a prior replay. */\ninterface AutomationInvokeSkillDecision {\n type: 'invokeSkill';\n idempotencyKey: string;\n role: string;\n skillName: string;\n arguments?: string;\n}\n\n/**\n * Whether a replayed rule-evaluation record describes the SAME operation as the\n * current request. `commitRuleEvaluation` keys idempotency on `(org, project,\n * ingress identity)` alone, so a reused `requestId` replays regardless of the\n * work item or decision payload. We reconstruct the prior `invokeSkill`\n * decision from the stored result and compare the item id, role, skill, and\n * arguments; any divergence is a collision, not a legitimate retry.\n */\nfunction replayMatchesRequest(\n result: { itemId?: string | null; decisions?: unknown[] },\n itemId: string,\n request: AutomationInvokeSkillDecision,\n): boolean {\n if (result.itemId != null && result.itemId !== itemId) return false;\n const decisions = Array.isArray(result.decisions) ? result.decisions : [];\n const prior = decisions.find(\n (candidate): candidate is Record<string, unknown> =>\n typeof candidate === 'object' &&\n candidate !== null &&\n (candidate as Record<string, unknown>).type === 'invokeSkill' &&\n (candidate as Record<string, unknown>).idempotencyKey === request.idempotencyKey,\n );\n if (!prior) return false;\n return (\n prior.role === request.role &&\n prior.skillName === request.skillName &&\n (prior.arguments ?? undefined) === (request.arguments ?? undefined)\n );\n}\n\nexport interface AutomationRunRoutesDeps extends RouteDependencies {\n audit: AuditEmitter & AuditRecorder;\n /** Factory projects domain — validates the `:id` project belongs to the caller's org. */\n projects: FactoryProjectsStorage;\n /** Work-items domain backing `commitRuleEvaluation`. */\n workItems: WorkItemsStorage;\n /** Config version stamped on the committed rule evaluation. */\n configVersion: string;\n}\n\n/** Resolved ingress scope for an automation-run request. */\ninterface AutomationRunScope {\n orgId: string;\n userId: string;\n factoryProjectId: string;\n}\n\nexport class AutomationRunRoutes extends Route<AutomationRunRoutesDeps> {\n /**\n * Resolve the `(orgId, userId)` ingress scope. Tenant mode requires a\n * signed-in organization administrator; local (no-auth) mode runs under the\n * shared `local` scope without inventing a user.\n */\n async #resolveScope(c: Context): Promise<{ orgId: string; userId: string } | { response: Response }> {\n const { auth } = this.deps;\n if (!auth.enabled()) {\n return { orgId: 'local', userId: 'local' };\n }\n await auth.ensureUser(c);\n const tenant = auth.tenant(c);\n if (!tenant) return { response: c.json({ error: 'unauthorized' }, 401) };\n if (!tenant.orgId) {\n return {\n response: c.json(\n { error: 'organization_required', message: 'The Factory board requires an organization.' },\n 403,\n ),\n };\n }\n if (!(await auth.isOrganizationAdmin(c, tenant.orgId))) {\n return {\n response: c.json(\n { error: 'forbidden', message: 'Organization administrator access is required for automation ingress.' },\n 403,\n ),\n };\n }\n return { orgId: tenant.orgId, userId: tenant.userId };\n }\n\n /** Resolve the ingress scope AND the org-owned project from the `:id` param. */\n async #resolveProject(c: Context): Promise<AutomationRunScope | { response: Response }> {\n const scope = await this.#resolveScope(c);\n if ('response' in scope) return scope;\n\n const parsedPath = FACTORY_ROUTE_CONTRACTS.projectGet.pathSchema.safeParse({ id: c.req.param('id') });\n if (!parsedPath.success) {\n return { response: c.json({ error: 'Project not found' }, 404) };\n }\n const { projects } = this.deps;\n await projects.ensureReady();\n const project = await projects.get({ orgId: scope.orgId, id: parsedPath.data.id });\n if (!project) {\n return { response: c.json({ error: 'Project not found' }, 404) };\n }\n return { ...scope, factoryProjectId: parsedPath.data.id };\n }\n\n /**\n * Persist an audit event under the ingress-resolved scope. This route can run\n * under the synthetic `local` no-auth scope, where the tenant-gated\n * `audit.emit()` derives no org from the request and drops the event; writing\n * through `record()` with the explicit org + system actor keeps traceability\n * in every deployment mode.\n *\n * The `idempotencyKey` (`<action>:<requestId>`) makes the audit write itself\n * idempotent: replaying the same request re-enters this path, but the trail\n * keeps a single event per requestId instead of one duplicate per retry.\n */\n async #writeAudit(\n c: Context,\n scope: AutomationRunScope,\n action: AuditAction,\n requestId: string,\n targets: AuditTarget[],\n metadata: Record<string, unknown>,\n ): Promise<void> {\n await this.deps.audit.record({\n idempotencyKey: `${action}:${requestId}`,\n orgId: scope.orgId,\n actorId: 'factory-external-orchestrator',\n actorType: 'system',\n action,\n targets,\n metadata,\n factoryProjectId: scope.factoryProjectId,\n context: auditRequestContext(c),\n });\n }\n\n routes(): ApiRoute[] {\n const { workItems, configVersion } = this.deps;\n const contract = FACTORY_ROUTE_CONTRACTS.workItemAutomationRun;\n\n return [\n registerApiRoute(contract.path, {\n method: contract.method,\n handler: async c => {\n const context = loose(c);\n const resolved = await this.#resolveProject(context);\n if ('response' in resolved) return resolved.response;\n\n const parsedPath = contract.pathSchema.safeParse({\n id: c.req.param('id'),\n workItemId: c.req.param('workItemId'),\n });\n if (!parsedPath.success) return c.json({ error: 'Work item not found' }, 404);\n\n const body = await c.req.json().catch(() => undefined);\n if (body === undefined) return c.json({ error: 'Invalid JSON body' }, 400);\n const parsed = contract.bodySchema.safeParse(body);\n if (!parsed.success) return c.json({ error: 'invalid_automation_run_request' }, 400);\n const request = parsed.data as {\n requestId: string;\n expectedRevision: number;\n role: string;\n skillName: string;\n arguments?: string;\n };\n\n const item = await workItems.getForProject(\n resolved.orgId,\n resolved.factoryProjectId,\n (parsedPath.data as { workItemId: string }).workItemId,\n );\n if (!item) return c.json({ error: 'Work item not found' }, 404);\n\n const idempotencyKey = `external-orchestrator:${request.requestId}`;\n const decision = {\n type: 'invokeSkill' as const,\n idempotencyKey,\n role: request.role,\n skillName: request.skillName,\n ...(request.arguments !== undefined ? { arguments: request.arguments } : {}),\n };\n\n const now = new Date();\n const commit = await workItems.commitRuleEvaluation({\n orgId: resolved.orgId,\n factoryProjectId: resolved.factoryProjectId,\n workItemId: item.id,\n ingress: { identity: idempotencyKey, triggerType: 'external-orchestrator.invoke-skill' },\n configVersion,\n expectedRevision: request.expectedRevision,\n actor: { type: 'system', id: 'factory-external-orchestrator' },\n outcome: { status: 'accepted' },\n decisions: [decision],\n causalChain: [],\n now,\n });\n\n if (commit.status === 'missing') return c.json({ error: 'Work item not found' }, 404);\n\n // A stale commit persists nothing, so the caller can retry the same\n // requestId once it has re-read the work item's revision.\n const result = (commit.status === 'stale' ? { status: 'rejected', code: 'stale' } : commit.result) as {\n status?: string;\n code?: string;\n itemId?: string | null;\n decisions?: unknown[];\n };\n const resultStatus = result.status ?? 'accepted';\n const code = typeof result.code === 'string' ? result.code : undefined;\n const targets = [{ type: 'work_item' as const, id: item.id, name: item.title }];\n\n const auditMetadata = {\n requestId: request.requestId,\n role: request.role,\n skillName: request.skillName,\n commitStatus: commit.status,\n resultStatus,\n ...(code ? { code } : {}),\n };\n\n // A replay only means \"this request was already committed\" — it must\n // be the SAME operation. If the caller reused a requestId against a\n // different work item, role, skill, or arguments, returning\n // `replayed` would report durable success for work that was never\n // enqueued. Reject the collision instead of silently swallowing it.\n if (commit.status === 'replayed' && !replayMatchesRequest(result, item.id, decision)) {\n await this.#writeAudit(context, resolved, 'factory.run.rejected', request.requestId, targets, {\n ...auditMetadata,\n resultStatus: 'rejected',\n code: 'request_id_conflict',\n });\n return c.json(\n {\n status: 'rejected',\n code: 'request_id_conflict',\n requestId: request.requestId,\n },\n 409,\n );\n }\n\n if (resultStatus === 'accepted') {\n await this.#writeAudit(context, resolved, 'factory.run.queued', request.requestId, targets, auditMetadata);\n return c.json(\n { status: commit.status === 'replayed' ? 'replayed' : 'committed', requestId: request.requestId },\n commit.status === 'replayed' ? 200 : 202,\n );\n }\n\n await this.#writeAudit(context, resolved, 'factory.run.rejected', request.requestId, targets, auditMetadata);\n return c.json(\n { status: 'rejected', ...(code ? { code } : {}), requestId: request.requestId },\n code === 'stale' ? 409 : 422,\n );\n },\n }),\n ];\n }\n}\n\nexport function buildAutomationRunRoutes(deps: AutomationRunRoutesDeps): ApiRoute[] {\n return new AutomationRunRoutes(deps).routes();\n}\n"],"mappings":"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"}
|
package/dist/routes/boards.d.ts
CHANGED
|
@@ -1,10 +1,12 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Mastra `apiRoutes` for managing a project's stored boards.
|
|
3
3
|
*
|
|
4
|
-
* Reads need project membership; writes need an organization admin in tenant mode.
|
|
5
|
-
*
|
|
6
|
-
*
|
|
7
|
-
*
|
|
4
|
+
* Reads need project membership; writes need an organization admin in tenant mode. Factory stores
|
|
5
|
+
* the built-in Work board and app boards in each project once, and they are edited under their own
|
|
6
|
+
* key; their code behaviour stays attached, so an edit it can't honour is refused
|
|
7
|
+
* (`code_behaviour`), and reset rewrites Factory's current definition at the next revision. They
|
|
8
|
+
* can't be created over, and Work can't be deleted. The legacy Review board stays read-only. The
|
|
9
|
+
* writes themselves are `BoardWrites`.
|
|
8
10
|
*/
|
|
9
11
|
import type { ApiRoute } from '@mastra/core/server';
|
|
10
12
|
import type { ProjectBoardCache } from '../boards/project-boards.js';
|
|
@@ -20,8 +22,8 @@ export interface BoardRoutesDeps extends RouteDependencies {
|
|
|
20
22
|
/** Read to refuse edits that would strand cards. */
|
|
21
23
|
workItems: Pick<WorkItemsStorage, 'list'>;
|
|
22
24
|
storage: StoredBoardsStorage;
|
|
23
|
-
/** The per-project boards: the
|
|
24
|
-
boards: Pick<ProjectBoardCache, 'describe' | 'invalidate' | 'codeRegistry' | 'codeSkills'>;
|
|
25
|
+
/** The per-project boards: the code boards and their seeds, skills, and the cache to invalidate. */
|
|
26
|
+
boards: Pick<ProjectBoardCache, 'describe' | 'invalidate' | 'codeRegistry' | 'codeSkills' | 'seedFor'>;
|
|
25
27
|
}
|
|
26
28
|
export declare class BoardRoutes extends Route<BoardRoutesDeps> {
|
|
27
29
|
#private;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"boards.d.ts","sourceRoot":"","sources":["../../src/routes/boards.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"boards.d.ts","sourceRoot":"","sources":["../../src/routes/boards.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAMpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,KAAK,EAAoB,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAC/F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAE9E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAS,KAAK,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,WAAW,eAAgB,SAAQ,iBAAiB;IACxD,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,sBAAsB,CAAC;IACjC,oDAAoD;IACpD,SAAS,EAAE,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;IAC1C,OAAO,EAAE,mBAAmB,CAAC;IAC7B,oGAAoG;IACpG,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,UAAU,GAAG,YAAY,GAAG,cAAc,GAAG,YAAY,GAAG,SAAS,CAAC,CAAC;CACxG;AAYD,qBAAa,WAAY,SAAQ,KAAK,CAAC,eAAe,CAAC;;IA2HrD,MAAM,IAAI,QAAQ,EAAE,CAgEnB;CACF"}
|
package/dist/routes/boards.js
CHANGED
|
@@ -1,10 +1,7 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import {
|
|
3
|
-
import { boardDefinitionOf, compileStoredBoard, storedBoardInputSchema } from "../boards/stored-board.js";
|
|
4
|
-
import { findBoardSkillProblems } from "../skills/app-skills.js";
|
|
5
|
-
import { StoredBoardError } from "../storage/domains/boards/base.js";
|
|
1
|
+
import { BoardWriteError, BoardWrites, issueMessage } from "../boards/board-writes.js";
|
|
2
|
+
import { boardDefinitionOf, codeBehaviourOf } from "../boards/stored-board.js";
|
|
6
3
|
import { FACTORY_ROUTE_CONTRACTS } from "./contracts.js";
|
|
7
|
-
import { Route } from "./route.js";
|
|
4
|
+
import { Route, loose } from "./route.js";
|
|
8
5
|
import { registerApiRoute } from "@mastra/core/server";
|
|
9
6
|
// src/routes/boards.ts
|
|
10
7
|
/** A response the handler returns as is: a refusal or an error. */
|
|
@@ -16,14 +13,8 @@ var Refusal = class {
|
|
|
16
13
|
this.body = body;
|
|
17
14
|
}
|
|
18
15
|
};
|
|
19
|
-
function loose(context) {
|
|
20
|
-
return context;
|
|
21
|
-
}
|
|
22
|
-
function issueMessage(issues) {
|
|
23
|
-
return issues.map((issue) => issue.path.length > 0 ? `${issue.path.join(".")}: ${issue.message}` : issue.message).join("; ");
|
|
24
|
-
}
|
|
25
|
-
const UNKNOWN_SKILL = "but no such skill exists";
|
|
26
16
|
var BoardRoutes = class extends Route {
|
|
17
|
+
#writes = new BoardWrites(this.deps);
|
|
27
18
|
async #resolve(c) {
|
|
28
19
|
const { auth, projects } = this.deps;
|
|
29
20
|
await auth.ensureUser(c);
|
|
@@ -71,113 +62,48 @@ var BoardRoutes = class extends Route {
|
|
|
71
62
|
if (!parsed.success) throw new Refusal(404, { error: "board_not_found" });
|
|
72
63
|
return parsed.data.boardKey;
|
|
73
64
|
}
|
|
74
|
-
/** Built-in and app boards come from code; they can't be created over, edited or deleted here. */
|
|
75
|
-
#refuseCodeBoard(key) {
|
|
76
|
-
if (!this.deps.boards.codeRegistry.has(key)) return;
|
|
77
|
-
throw new Refusal(409, {
|
|
78
|
-
error: "code_board",
|
|
79
|
-
message: `Board "${key}" is defined in code and can't be edited here.`
|
|
80
|
-
});
|
|
81
|
-
}
|
|
82
|
-
async #existing(scope, key) {
|
|
83
|
-
const row = await this.deps.storage.get(scope, key);
|
|
84
|
-
if (!row) throw new Refusal(404, {
|
|
85
|
-
error: "board_not_found",
|
|
86
|
-
message: `Board "${key}" does not exist.`
|
|
87
|
-
});
|
|
88
|
-
return row;
|
|
89
|
-
}
|
|
90
|
-
/** Validates a definition the way `defineBoard()` does, plus the skills its runners name. */
|
|
91
|
-
#validate(input) {
|
|
92
|
-
const parsed = storedBoardInputSchema.safeParse(input);
|
|
93
|
-
if (!parsed.success) throw new Refusal(422, {
|
|
94
|
-
error: "invalid_board",
|
|
95
|
-
message: issueMessage(parsed.error.issues)
|
|
96
|
-
});
|
|
97
|
-
const board = compileStoredBoard(parsed.data);
|
|
98
|
-
const unknown = findBoardSkillProblems(createBoardRegistry({
|
|
99
|
-
boards: [board],
|
|
100
|
-
includeDefaultBoards: false
|
|
101
|
-
}), this.deps.boards.codeSkills).filter((problem) => problem.includes(UNKNOWN_SKILL));
|
|
102
|
-
if (unknown.length > 0) throw new Refusal(422, {
|
|
103
|
-
error: "unknown_skill",
|
|
104
|
-
message: unknown.join(" ")
|
|
105
|
-
});
|
|
106
|
-
return parsed.data;
|
|
107
|
-
}
|
|
108
|
-
/** The cards on a board, and how many sit in each phase. */
|
|
109
|
-
async #occupancy(scope, key) {
|
|
110
|
-
const phases = /* @__PURE__ */ new Map();
|
|
111
|
-
let cards = 0;
|
|
112
|
-
for (const item of await this.deps.workItems.list(scope)) {
|
|
113
|
-
if (boardForWorkItem(item) !== key) continue;
|
|
114
|
-
cards++;
|
|
115
|
-
for (const stage of new Set(item.stages)) phases.set(stage, (phases.get(stage) ?? 0) + 1);
|
|
116
|
-
}
|
|
117
|
-
return {
|
|
118
|
-
cards,
|
|
119
|
-
phases
|
|
120
|
-
};
|
|
121
|
-
}
|
|
122
|
-
/** Refuses a change that removes, or changes the kind of, a phase cards sit in. */
|
|
123
|
-
async #checkPhasesFree(scope, row, next) {
|
|
124
|
-
const kinds = new Map(next.map((phase) => [phase.key, phase.kind]));
|
|
125
|
-
const changed = row.phases.filter((phase) => kinds.get(phase.key) !== phase.kind).map((phase) => phase.key);
|
|
126
|
-
if (changed.length === 0) return;
|
|
127
|
-
const occupancy = (await this.#occupancy(scope, row.key)).phases;
|
|
128
|
-
const inUse = Object.fromEntries(changed.flatMap((key) => occupancy.get(key) ? [[key, occupancy.get(key)]] : []));
|
|
129
|
-
if (Object.keys(inUse).length === 0) return;
|
|
130
|
-
throw new Refusal(409, {
|
|
131
|
-
error: "phase_in_use",
|
|
132
|
-
message: `Cards sit in ${Object.entries(inUse).map(([key, count]) => `"${key}" (${count})`).join(", ")}; move them before removing those phases or changing their kind.`,
|
|
133
|
-
phases: inUse
|
|
134
|
-
});
|
|
135
|
-
}
|
|
136
65
|
async #respond(c, scope, key, status = 200) {
|
|
66
|
+
const { auth } = this.deps;
|
|
67
|
+
const canEdit = !auth.enabled() || await auth.isOrganizationAdmin(c, scope.orgId);
|
|
137
68
|
const project = await this.deps.boards.describe(scope);
|
|
138
69
|
const details = project.details.get(key);
|
|
139
70
|
const code = this.deps.boards.codeRegistry.get(key);
|
|
140
|
-
|
|
71
|
+
const seed = this.deps.boards.seedFor(key);
|
|
72
|
+
if (code && !seed) {
|
|
141
73
|
const { description, ...definition } = boardDefinitionOf(code);
|
|
142
|
-
return c.json({
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
74
|
+
return c.json({
|
|
75
|
+
board: {
|
|
76
|
+
...definition,
|
|
77
|
+
description: description ?? null,
|
|
78
|
+
revision: null,
|
|
79
|
+
source: details?.source ?? "app",
|
|
80
|
+
editable: false,
|
|
81
|
+
codeBehaviour: codeBehaviourOf(code),
|
|
82
|
+
problems: details?.problems ?? []
|
|
83
|
+
},
|
|
84
|
+
canEdit: false
|
|
85
|
+
}, status);
|
|
150
86
|
}
|
|
151
87
|
const row = await this.deps.storage.get(scope, key);
|
|
152
88
|
if (!row) return c.json({
|
|
153
89
|
error: "board_not_found",
|
|
154
90
|
message: `Board "${key}" does not exist.`
|
|
155
91
|
}, 404);
|
|
156
|
-
const
|
|
157
|
-
return c.json({
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
input: {
|
|
172
|
-
action: `factory.board.${action}`,
|
|
173
|
-
factoryProjectId: scope.factoryProjectId,
|
|
174
|
-
targets: [{
|
|
175
|
-
type: "board",
|
|
176
|
-
id: board.key,
|
|
177
|
-
name: board.name
|
|
178
|
-
}]
|
|
179
|
-
}
|
|
180
|
-
});
|
|
92
|
+
const rowProblems = project.problems.filter((problem) => problem.startsWith(`Board '${key}' could not be loaded:`) || problem.startsWith(`Stored board "${key}" `));
|
|
93
|
+
return c.json({
|
|
94
|
+
board: {
|
|
95
|
+
key: row.key,
|
|
96
|
+
name: row.name,
|
|
97
|
+
description: row.description,
|
|
98
|
+
phases: row.phases.map(({ position: _position, ...phase }) => phase),
|
|
99
|
+
revision: row.revision,
|
|
100
|
+
source: details?.source ?? "stored",
|
|
101
|
+
editable: true,
|
|
102
|
+
codeBehaviour: code ? codeBehaviourOf(code) : null,
|
|
103
|
+
problems: [...details?.problems ?? [], ...rowProblems.filter((p) => !details?.problems.includes(p))]
|
|
104
|
+
},
|
|
105
|
+
canEdit
|
|
106
|
+
}, status);
|
|
181
107
|
}
|
|
182
108
|
#route(contract, handle) {
|
|
183
109
|
return registerApiRoute(contract.path, {
|
|
@@ -189,80 +115,84 @@ var BoardRoutes = class extends Route {
|
|
|
189
115
|
return await handle(context);
|
|
190
116
|
} catch (error) {
|
|
191
117
|
if (error instanceof Refusal) return context.json(error.body, error.status);
|
|
192
|
-
if (error instanceof
|
|
193
|
-
error: error.code,
|
|
194
|
-
message: error.message
|
|
195
|
-
}, error.code === "board_not_found" ? 404 : 409);
|
|
118
|
+
if (error instanceof BoardWriteError) return context.json(error.body, error.status);
|
|
196
119
|
throw error;
|
|
197
120
|
}
|
|
198
121
|
}
|
|
199
122
|
});
|
|
200
123
|
}
|
|
124
|
+
/** The request's user, as the board's author and the audit event's actor. */
|
|
125
|
+
#writer(c, scope) {
|
|
126
|
+
return {
|
|
127
|
+
id: scope.userId,
|
|
128
|
+
audit: (input) => this.deps.audit.emit({
|
|
129
|
+
context: c,
|
|
130
|
+
input
|
|
131
|
+
})
|
|
132
|
+
};
|
|
133
|
+
}
|
|
201
134
|
routes() {
|
|
202
|
-
const { storage, boards } = this.deps;
|
|
203
135
|
const contracts = FACTORY_ROUTE_CONTRACTS;
|
|
136
|
+
const writes = this.#writes;
|
|
204
137
|
return [
|
|
205
138
|
this.#route(contracts.boardGet, async (c) => {
|
|
206
139
|
const scope = await this.#resolve(c);
|
|
207
|
-
|
|
140
|
+
const key = this.#boardKey(c);
|
|
141
|
+
return this.#respond(c, scope, key);
|
|
208
142
|
}),
|
|
209
143
|
this.#route(contracts.boardCreate, async (c) => {
|
|
210
144
|
const scope = await this.#resolve(c);
|
|
211
145
|
await this.#requireAdmin(c, scope);
|
|
212
|
-
const
|
|
213
|
-
this.#
|
|
214
|
-
await storage.create(scope, input, scope.userId);
|
|
215
|
-
boards.invalidate(scope);
|
|
216
|
-
await this.#audit(c, scope, "created", input);
|
|
217
|
-
return this.#respond(c, scope, input.key, 201);
|
|
146
|
+
const row = await writes.create(scope, await this.#body(c), this.#writer(c, scope));
|
|
147
|
+
return this.#respond(c, scope, row.key, 201);
|
|
218
148
|
}),
|
|
219
149
|
this.#route(contracts.boardReplace, async (c) => {
|
|
220
150
|
const scope = await this.#resolve(c);
|
|
221
151
|
const key = this.#boardKey(c);
|
|
222
152
|
await this.#requireAdmin(c, scope);
|
|
223
|
-
|
|
153
|
+
writes.refuseCodeBoard(key, "edit");
|
|
224
154
|
const parsed = contracts.boardReplace.bodySchema.safeParse(await this.#body(c));
|
|
225
155
|
if (!parsed.success) throw new Refusal(422, {
|
|
226
156
|
error: "invalid_board",
|
|
227
157
|
message: issueMessage(parsed.error.issues)
|
|
228
158
|
});
|
|
229
159
|
const { expectedRevision, ...definition } = parsed.data;
|
|
230
|
-
|
|
231
|
-
const input = this.#validate({
|
|
232
|
-
key,
|
|
233
|
-
...definition
|
|
234
|
-
});
|
|
235
|
-
await this.#checkPhasesFree(scope, row, input.phases);
|
|
236
|
-
const { key: _key, ...replacement } = input;
|
|
237
|
-
await storage.replace(scope, key, replacement, {
|
|
160
|
+
await writes.replace(scope, key, definition, {
|
|
238
161
|
expectedRevision,
|
|
239
|
-
|
|
162
|
+
writer: this.#writer(c, scope)
|
|
240
163
|
});
|
|
241
|
-
boards.invalidate(scope);
|
|
242
|
-
await this.#audit(c, scope, "updated", input);
|
|
243
164
|
return this.#respond(c, scope, key);
|
|
244
165
|
}),
|
|
245
166
|
this.#route(contracts.boardDelete, async (c) => {
|
|
246
167
|
const scope = await this.#resolve(c);
|
|
247
168
|
const key = this.#boardKey(c);
|
|
248
169
|
await this.#requireAdmin(c, scope);
|
|
249
|
-
|
|
170
|
+
writes.refuseCodeBoard(key, "delete");
|
|
250
171
|
const parsed = contracts.boardDelete.querySchema.safeParse({ expectedRevision: c.req.query("expectedRevision") });
|
|
251
172
|
if (!parsed.success) throw new Refusal(422, {
|
|
252
173
|
error: "invalid_request",
|
|
253
174
|
message: issueMessage(parsed.error.issues)
|
|
254
175
|
});
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
error: "board_in_use",
|
|
259
|
-
message: `Board "${key}" still has cards; move or delete them first.`,
|
|
260
|
-
cards
|
|
176
|
+
await writes.remove(scope, key, {
|
|
177
|
+
expectedRevision: parsed.data.expectedRevision,
|
|
178
|
+
writer: this.#writer(c, scope)
|
|
261
179
|
});
|
|
262
|
-
await storage.delete(scope, key, { expectedRevision: parsed.data.expectedRevision });
|
|
263
|
-
boards.invalidate(scope);
|
|
264
|
-
await this.#audit(c, scope, "deleted", row);
|
|
265
180
|
return c.body(null, 204);
|
|
181
|
+
}),
|
|
182
|
+
this.#route(contracts.boardReset, async (c) => {
|
|
183
|
+
const scope = await this.#resolve(c);
|
|
184
|
+
const key = this.#boardKey(c);
|
|
185
|
+
await this.#requireAdmin(c, scope);
|
|
186
|
+
const parsed = contracts.boardReset.bodySchema.safeParse(await this.#body(c));
|
|
187
|
+
if (!parsed.success) throw new Refusal(422, {
|
|
188
|
+
error: "invalid_request",
|
|
189
|
+
message: issueMessage(parsed.error.issues)
|
|
190
|
+
});
|
|
191
|
+
await writes.reset(scope, key, {
|
|
192
|
+
expectedRevision: parsed.data.expectedRevision,
|
|
193
|
+
writer: this.#writer(c, scope)
|
|
194
|
+
});
|
|
195
|
+
return this.#respond(c, scope, key);
|
|
266
196
|
})
|
|
267
197
|
];
|
|
268
198
|
}
|