@mastra/factory 0.28.0-alpha.0 → 0.28.0-alpha.10
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 +528 -161
- package/dist/auth.d.ts.map +1 -1
- package/dist/auth.js +12 -6
- package/dist/auth.js.map +1 -1
- package/dist/boards/board-events.d.ts +54 -0
- package/dist/boards/board-events.d.ts.map +1 -0
- package/dist/boards/board-events.js +87 -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 +266 -0
- package/dist/boards/board-writes.js.map +1 -0
- package/dist/boards/card-facts.d.ts +3 -1
- package/dist/boards/card-facts.d.ts.map +1 -1
- package/dist/boards/card-facts.js +30 -4
- package/dist/boards/card-facts.js.map +1 -1
- package/dist/boards/default-board.d.ts +7 -0
- package/dist/boards/default-board.d.ts.map +1 -0
- package/dist/boards/default-board.js +10 -0
- package/dist/boards/default-board.js.map +1 -0
- package/dist/boards/define-board.d.ts +56 -23
- package/dist/boards/define-board.d.ts.map +1 -1
- package/dist/boards/define-board.js +89 -45
- package/dist/boards/define-board.js.map +1 -1
- package/dist/boards/index.d.ts +6 -9
- package/dist/boards/index.d.ts.map +1 -1
- package/dist/boards/index.js +6 -20
- package/dist/boards/intake-routing.d.ts +55 -11
- package/dist/boards/intake-routing.d.ts.map +1 -1
- package/dist/boards/intake-routing.js +109 -19
- 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 +14 -5
- package/dist/boards/legacy-plan-role.js.map +1 -1
- package/dist/boards/phase-automation.d.ts +7 -0
- package/dist/boards/phase-automation.d.ts.map +1 -1
- package/dist/boards/phase-automation.js +19 -3
- package/dist/boards/phase-automation.js.map +1 -1
- package/dist/boards/phase-runner.d.ts +18 -10
- package/dist/boards/phase-runner.d.ts.map +1 -1
- package/dist/boards/phase-runner.js +39 -34
- package/dist/boards/phase-runner.js.map +1 -1
- package/dist/boards/project-boards.d.ts +65 -8
- package/dist/boards/project-boards.d.ts.map +1 -1
- package/dist/boards/project-boards.js +217 -26
- package/dist/boards/project-boards.js.map +1 -1
- package/dist/boards/registry.d.ts +7 -1
- package/dist/boards/registry.d.ts.map +1 -1
- package/dist/boards/registry.js +19 -4
- package/dist/boards/registry.js.map +1 -1
- package/dist/boards/relocate.d.ts +1 -1
- package/dist/boards/relocate.d.ts.map +1 -1
- package/dist/boards/relocate.js +3 -2
- package/dist/boards/relocate.js.map +1 -1
- package/dist/boards/review.d.ts +5 -2
- package/dist/boards/review.d.ts.map +1 -1
- package/dist/boards/review.js +12 -11
- package/dist/boards/review.js.map +1 -1
- package/dist/boards/semantics.d.ts +160 -20
- package/dist/boards/semantics.d.ts.map +1 -1
- package/dist/boards/semantics.js +255 -23
- package/dist/boards/semantics.js.map +1 -1
- package/dist/boards/stored-board.d.ts +73 -1
- package/dist/boards/stored-board.d.ts.map +1 -1
- package/dist/boards/stored-board.js +157 -11
- package/dist/boards/stored-board.js.map +1 -1
- package/dist/boards/work-migrations.d.ts +43 -0
- package/dist/boards/work-migrations.d.ts.map +1 -0
- package/dist/boards/work-migrations.js +353 -0
- package/dist/boards/work-migrations.js.map +1 -0
- package/dist/boards/work-routes.d.ts +58 -0
- package/dist/boards/work-routes.d.ts.map +1 -0
- package/dist/boards/work-routes.js +270 -0
- package/dist/boards/work-routes.js.map +1 -0
- package/dist/boards/work-seeds.d.ts +9 -0
- package/dist/boards/work-seeds.d.ts.map +1 -0
- package/dist/boards/work-seeds.js +56 -0
- package/dist/boards/work-seeds.js.map +1 -0
- package/dist/boards/work.d.ts +8 -19
- package/dist/boards/work.d.ts.map +1 -1
- package/dist/boards/work.js +33 -281
- package/dist/boards/work.js.map +1 -1
- package/dist/environment/build-runner.d.ts.map +1 -1
- package/dist/environment/build-runner.js +2 -2
- package/dist/environment/build-runner.js.map +1 -1
- package/dist/environment/build-workflow.d.ts.map +1 -1
- package/dist/environment/build-workflow.js +6 -5
- package/dist/environment/build-workflow.js.map +1 -1
- package/dist/environment/build.d.ts +15 -2
- package/dist/environment/build.d.ts.map +1 -1
- package/dist/environment/build.js +32 -9
- package/dist/environment/build.js.map +1 -1
- package/dist/factory.d.ts +90 -9
- package/dist/factory.d.ts.map +1 -1
- package/dist/factory.js +334 -141
- package/dist/factory.js.map +1 -1
- package/dist/feed-events.d.ts +4 -4
- package/dist/feed-events.d.ts.map +1 -1
- package/dist/feed-events.js +6 -6
- package/dist/feed-events.js.map +1 -1
- package/dist/index.d.ts +10 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +7 -4
- package/dist/integrations/base.d.ts +12 -13
- package/dist/integrations/base.d.ts.map +1 -1
- package/dist/integrations/closing-references.d.ts +15 -0
- package/dist/integrations/closing-references.d.ts.map +1 -0
- package/dist/integrations/closing-references.js +69 -0
- package/dist/integrations/closing-references.js.map +1 -0
- 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 +17 -75
- package/dist/integrations/github/default-rules.d.ts.map +1 -1
- package/dist/integrations/github/default-rules.js +134 -77
- package/dist/integrations/github/default-rules.js.map +1 -1
- package/dist/integrations/github/integration.d.ts.map +1 -1
- package/dist/integrations/github/integration.js +7 -3
- package/dist/integrations/github/integration.js.map +1 -1
- package/dist/integrations/github/issue-reconciler.d.ts.map +1 -1
- package/dist/integrations/github/issue-reconciler.js +21 -3
- package/dist/integrations/github/issue-reconciler.js.map +1 -1
- package/dist/integrations/github/provenance.js +1 -1
- package/dist/integrations/github/provenance.js.map +1 -1
- package/dist/integrations/github/pull-request-source.d.ts +8 -0
- package/dist/integrations/github/pull-request-source.d.ts.map +1 -0
- package/dist/integrations/github/pull-request-source.js +17 -0
- package/dist/integrations/github/pull-request-source.js.map +1 -0
- package/dist/integrations/github/reconcile-worker.d.ts +5 -1
- package/dist/integrations/github/reconcile-worker.d.ts.map +1 -1
- package/dist/integrations/github/reconcile-worker.js +39 -6
- package/dist/integrations/github/reconcile-worker.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 +104 -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 +4 -3
- package/dist/integrations/github/routes.d.ts.map +1 -1
- package/dist/integrations/github/routes.js +11 -91
- package/dist/integrations/github/routes.js.map +1 -1
- package/dist/integrations/github/rules.d.ts +92 -8
- package/dist/integrations/github/rules.d.ts.map +1 -1
- package/dist/integrations/github/rules.js +498 -103
- package/dist/integrations/github/rules.js.map +1 -1
- package/dist/integrations/github/sandbox.d.ts +10 -2
- package/dist/integrations/github/sandbox.d.ts.map +1 -1
- package/dist/integrations/github/sandbox.js +20 -4
- package/dist/integrations/github/sandbox.js.map +1 -1
- package/dist/integrations/github/session-subscriptions.js +2 -2
- package/dist/integrations/github/session-subscriptions.js.map +1 -1
- package/dist/integrations/github/token-refresh.d.ts +2 -1
- package/dist/integrations/github/token-refresh.d.ts.map +1 -1
- package/dist/integrations/github/token-refresh.js.map +1 -1
- package/dist/integrations/gitlab/agent-tools.js +1 -1
- package/dist/integrations/gitlab/default-rules.d.ts +96 -39
- package/dist/integrations/gitlab/default-rules.d.ts.map +1 -1
- package/dist/integrations/gitlab/default-rules.js +109 -46
- package/dist/integrations/gitlab/default-rules.js.map +1 -1
- package/dist/integrations/gitlab/issue-reconciler.d.ts.map +1 -1
- package/dist/integrations/gitlab/issue-reconciler.js +2 -1
- package/dist/integrations/gitlab/issue-reconciler.js.map +1 -1
- package/dist/integrations/gitlab/merge-request-reconciler.d.ts.map +1 -1
- package/dist/integrations/gitlab/merge-request-reconciler.js +12 -5
- package/dist/integrations/gitlab/merge-request-reconciler.js.map +1 -1
- package/dist/integrations/gitlab/routes.d.ts.map +1 -1
- package/dist/integrations/gitlab/routes.js +2 -6
- package/dist/integrations/gitlab/routes.js.map +1 -1
- package/dist/integrations/gitlab/rules.d.ts +22 -1
- package/dist/integrations/gitlab/rules.d.ts.map +1 -1
- package/dist/integrations/gitlab/rules.js +188 -34
- package/dist/integrations/gitlab/rules.js.map +1 -1
- package/dist/integrations/gitlab/session-subscriptions.js +1 -1
- package/dist/integrations/incidentio/agent-tools.js +6 -6
- package/dist/integrations/incidentio/agent-tools.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 +6 -7
- package/dist/integrations/incidentio/default-rules.js.map +1 -1
- package/dist/integrations/incidentio/issue-reconciler.d.ts.map +1 -1
- package/dist/integrations/incidentio/issue-reconciler.js +2 -1
- package/dist/integrations/incidentio/issue-reconciler.js.map +1 -1
- package/dist/integrations/incidentio/routes.d.ts +2 -2
- package/dist/integrations/incidentio/routes.d.ts.map +1 -1
- package/dist/integrations/incidentio/routes.js +11 -17
- package/dist/integrations/incidentio/routes.js.map +1 -1
- package/dist/integrations/incidentio/rules.d.ts +11 -4
- package/dist/integrations/incidentio/rules.d.ts.map +1 -1
- package/dist/integrations/incidentio/rules.js +52 -16
- package/dist/integrations/incidentio/rules.js.map +1 -1
- package/dist/integrations/issue-reconciler.js +1 -1
- package/dist/integrations/issue-reconciler.js.map +1 -1
- package/dist/integrations/jira/agent-tools.js +1 -1
- package/dist/integrations/jira/binding-scope.d.ts +5 -6
- package/dist/integrations/jira/binding-scope.d.ts.map +1 -1
- package/dist/integrations/jira/binding-scope.js +9 -11
- package/dist/integrations/jira/binding-scope.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 +6 -7
- package/dist/integrations/jira/default-rules.js.map +1 -1
- package/dist/integrations/jira/issue-reconciler.d.ts.map +1 -1
- package/dist/integrations/jira/issue-reconciler.js +2 -1
- package/dist/integrations/jira/issue-reconciler.js.map +1 -1
- package/dist/integrations/jira/routes.d.ts.map +1 -1
- package/dist/integrations/jira/routes.js +4 -9
- package/dist/integrations/jira/routes.js.map +1 -1
- package/dist/integrations/jira/rules.d.ts +11 -4
- package/dist/integrations/jira/rules.d.ts.map +1 -1
- package/dist/integrations/jira/rules.js +52 -16
- package/dist/integrations/jira/rules.js.map +1 -1
- package/dist/integrations/linear/agent-tools.d.ts +9 -1
- package/dist/integrations/linear/agent-tools.d.ts.map +1 -1
- package/dist/integrations/linear/agent-tools.js +81 -3
- package/dist/integrations/linear/agent-tools.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 +6 -7
- package/dist/integrations/linear/default-rules.js.map +1 -1
- package/dist/integrations/linear/integration.d.ts +4 -1
- package/dist/integrations/linear/integration.d.ts.map +1 -1
- package/dist/integrations/linear/integration.js +21 -1
- package/dist/integrations/linear/integration.js.map +1 -1
- package/dist/integrations/linear/issue-reconciler.d.ts.map +1 -1
- package/dist/integrations/linear/issue-reconciler.js +2 -1
- package/dist/integrations/linear/issue-reconciler.js.map +1 -1
- package/dist/integrations/linear/routes.d.ts +2 -1
- package/dist/integrations/linear/routes.d.ts.map +1 -1
- package/dist/integrations/linear/routes.js +16 -21
- package/dist/integrations/linear/routes.js.map +1 -1
- package/dist/integrations/linear/rules.d.ts +11 -4
- package/dist/integrations/linear/rules.d.ts.map +1 -1
- package/dist/integrations/linear/rules.js +50 -17
- 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 +12 -0
- package/dist/integrations/platform/connect/session-tools.d.ts.map +1 -0
- package/dist/integrations/platform/connect/session-tools.js +35 -0
- package/dist/integrations/platform/connect/session-tools.js.map +1 -0
- package/dist/integrations/platform/github/event-worker.d.ts +4 -1
- package/dist/integrations/platform/github/event-worker.d.ts.map +1 -1
- package/dist/integrations/platform/github/event-worker.js +39 -3
- package/dist/integrations/platform/github/event-worker.js.map +1 -1
- package/dist/integrations/platform/github/integration.d.ts +8 -0
- package/dist/integrations/platform/github/integration.d.ts.map +1 -1
- package/dist/integrations/platform/github/integration.js +132 -90
- package/dist/integrations/platform/github/integration.js.map +1 -1
- package/dist/integrations/platform/jira/agent-tools.js +1 -1
- package/dist/integrations/platform/jira/routes.d.ts.map +1 -1
- package/dist/integrations/platform/jira/routes.js +4 -9
- 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 +10 -1
- package/dist/integrations/platform/linear/event-worker.js.map +1 -1
- package/dist/integrations/platform/linear/integration.d.ts +1 -1
- package/dist/integrations/platform/linear/integration.d.ts.map +1 -1
- package/dist/integrations/platform/linear/integration.js +7 -8
- 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/chat-tools.js +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 +0 -2
- package/dist/integrations/slack/integration.d.ts.map +1 -1
- package/dist/integrations/slack/integration.js +2 -5
- package/dist/integrations/slack/integration.js.map +1 -1
- package/dist/integrations/slack/reply-tool.js +1 -1
- package/dist/integrations/slack/run-error-card.js +1 -0
- package/dist/integrations/slack/run-error-card.js.map +1 -1
- package/dist/integrations/slack/share-file-tool.js +1 -1
- package/dist/integrations/slack/slack.d.ts +23 -30
- package/dist/integrations/slack/slack.d.ts.map +1 -1
- package/dist/integrations/slack/slack.js +131 -125
- 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/links.d.ts +1 -2
- package/dist/links.d.ts.map +1 -1
- package/dist/links.js +4 -4
- package/dist/links.js.map +1 -1
- package/dist/mcp/routes.js +2 -2
- package/dist/mcp/routes.js.map +1 -1
- package/dist/packages/_internals/workspace/dist/index.js +1 -1
- package/dist/provider-display-name.d.ts.map +1 -1
- package/dist/provider-display-name.js +1 -0
- package/dist/provider-display-name.js.map +1 -1
- package/dist/routes/attention-parked.d.ts +1 -0
- package/dist/routes/attention-parked.d.ts.map +1 -1
- package/dist/routes/attention-parked.js +2 -2
- package/dist/routes/attention-parked.js.map +1 -1
- package/dist/routes/attention-providers.d.ts +0 -25
- package/dist/routes/attention-providers.d.ts.map +1 -1
- package/dist/routes/attention-providers.js +3 -151
- package/dist/routes/attention-providers.js.map +1 -1
- package/dist/routes/attention.d.ts +0 -2
- package/dist/routes/attention.d.ts.map +1 -1
- package/dist/routes/attention.js +2 -13
- package/dist/routes/attention.js.map +1 -1
- package/dist/routes/automation-runs.d.ts +5 -1
- package/dist/routes/automation-runs.d.ts.map +1 -1
- package/dist/routes/automation-runs.js +16 -4
- package/dist/routes/automation-runs.js.map +1 -1
- package/dist/routes/board-snapshot.d.ts +15 -0
- package/dist/routes/board-snapshot.d.ts.map +1 -0
- package/dist/routes/board-snapshot.js +41 -0
- package/dist/routes/board-snapshot.js.map +1 -0
- package/dist/routes/boards.d.ts +9 -7
- package/dist/routes/boards.d.ts.map +1 -1
- package/dist/routes/boards.js +59 -145
- package/dist/routes/boards.js.map +1 -1
- package/dist/routes/config.d.ts +11 -1
- package/dist/routes/config.d.ts.map +1 -1
- package/dist/routes/config.js +122 -29
- package/dist/routes/config.js.map +1 -1
- package/dist/routes/contracts.d.ts +366 -34
- package/dist/routes/contracts.d.ts.map +1 -1
- package/dist/routes/contracts.js +179 -51
- package/dist/routes/contracts.js.map +1 -1
- package/dist/routes/feed-events.d.ts +15 -0
- package/dist/routes/feed-events.d.ts.map +1 -0
- package/dist/routes/feed-events.js +68 -0
- package/dist/routes/feed-events.js.map +1 -0
- package/dist/routes/fs.d.ts +4 -0
- package/dist/routes/fs.d.ts.map +1 -1
- package/dist/routes/fs.js +9 -8
- package/dist/routes/fs.js.map +1 -1
- package/dist/routes/intake-routes.d.ts.map +1 -1
- package/dist/routes/intake-routes.js +25 -13
- package/dist/routes/intake-routes.js.map +1 -1
- package/dist/routes/intake.d.ts +0 -23
- package/dist/routes/intake.d.ts.map +1 -1
- package/dist/routes/intake.js +16 -314
- package/dist/routes/intake.js.map +1 -1
- package/dist/routes/knowledge.d.ts.map +1 -1
- package/dist/routes/knowledge.js +2 -5
- package/dist/routes/knowledge.js.map +1 -1
- package/dist/routes/mastra-gateway.d.ts +19 -0
- package/dist/routes/mastra-gateway.d.ts.map +1 -0
- package/dist/routes/mastra-gateway.js +120 -0
- package/dist/routes/mastra-gateway.js.map +1 -0
- 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 +80 -61
- package/dist/routes/projects.js.map +1 -1
- package/dist/routes/provider-credentials.d.ts +6 -1
- package/dist/routes/provider-credentials.d.ts.map +1 -1
- package/dist/routes/provider-credentials.js +44 -3
- package/dist/routes/provider-credentials.js.map +1 -1
- package/dist/routes/route.d.ts +8 -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/running-packages.d.ts +13 -0
- package/dist/routes/running-packages.d.ts.map +1 -0
- package/dist/routes/running-packages.js +45 -0
- package/dist/routes/running-packages.js.map +1 -0
- package/dist/routes/sandbox-envs.d.ts +26 -0
- package/dist/routes/sandbox-envs.d.ts.map +1 -0
- package/dist/routes/sandbox-envs.js +180 -0
- package/dist/routes/sandbox-envs.js.map +1 -0
- package/dist/routes/session-access.d.ts.map +1 -1
- package/dist/routes/session-access.js +12 -3
- package/dist/routes/session-access.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 +13 -9
- package/dist/routes/surface.d.ts.map +1 -1
- package/dist/routes/surface.js +116 -43
- package/dist/routes/surface.js.map +1 -1
- package/dist/routes/tenant-credentials.d.ts.map +1 -1
- package/dist/routes/tenant-credentials.js +5 -1
- package/dist/routes/tenant-credentials.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 +0 -3
- package/dist/routes/work-items.d.ts.map +1 -1
- package/dist/routes/work-items.js +39 -14
- package/dist/routes/work-items.js.map +1 -1
- package/dist/rules/binding-context.d.ts.map +1 -1
- package/dist/rules/binding-context.js +1 -0
- package/dist/rules/binding-context.js.map +1 -1
- package/dist/rules/decision-applicability.js +1 -1
- package/dist/rules/dispatcher.d.ts +28 -9
- package/dist/rules/dispatcher.d.ts.map +1 -1
- package/dist/rules/dispatcher.js +734 -143
- package/dist/rules/dispatcher.js.map +1 -1
- package/dist/rules/event-rules.d.ts +71 -1
- package/dist/rules/event-rules.d.ts.map +1 -1
- package/dist/rules/event-rules.js +94 -1
- package/dist/rules/event-rules.js.map +1 -1
- package/dist/rules/index.d.ts +2 -4
- package/dist/rules/index.d.ts.map +1 -1
- package/dist/rules/index.js +2 -3
- package/dist/rules/phase-goal.d.ts +54 -0
- package/dist/rules/phase-goal.d.ts.map +1 -0
- package/dist/rules/phase-goal.js +70 -0
- package/dist/rules/phase-goal.js.map +1 -0
- package/dist/rules/phase-tools.d.ts +11 -0
- package/dist/rules/phase-tools.d.ts.map +1 -0
- package/dist/rules/phase-tools.js +19 -0
- package/dist/rules/phase-tools.js.map +1 -0
- package/dist/rules/processor.d.ts.map +1 -1
- package/dist/rules/processor.js +116 -15
- package/dist/rules/processor.js.map +1 -1
- package/dist/rules/review-source-tool.d.ts +4 -1
- package/dist/rules/review-source-tool.d.ts.map +1 -1
- package/dist/rules/review-source-tool.js +24 -4
- package/dist/rules/review-source-tool.js.map +1 -1
- package/dist/rules/rule-group.d.ts +1 -1
- package/dist/rules/rule-group.d.ts.map +1 -1
- package/dist/rules/rule-group.js +15 -6
- package/dist/rules/rule-group.js.map +1 -1
- package/dist/rules/start-coordinator.d.ts +5 -1
- package/dist/rules/start-coordinator.d.ts.map +1 -1
- package/dist/rules/start-coordinator.js +9 -3
- package/dist/rules/start-coordinator.js.map +1 -1
- package/dist/rules/tools.d.ts.map +1 -1
- package/dist/rules/tools.js +39 -28
- package/dist/rules/tools.js.map +1 -1
- package/dist/rules/transition-service.d.ts +10 -7
- package/dist/rules/transition-service.d.ts.map +1 -1
- package/dist/rules/transition-service.js +63 -55
- package/dist/rules/transition-service.js.map +1 -1
- package/dist/rules/types.d.ts +140 -39
- package/dist/rules/types.d.ts.map +1 -1
- package/dist/rules/types.js +7 -41
- package/dist/rules/types.js.map +1 -1
- package/dist/rules/validation.d.ts.map +1 -1
- package/dist/rules/validation.js +89 -4
- package/dist/rules/validation.js.map +1 -1
- package/dist/run-error.d.ts +1 -1
- package/dist/run-error.d.ts.map +1 -1
- package/dist/run-error.js +38 -5
- package/dist/run-error.js.map +1 -1
- package/dist/sandbox/sandbox-env-cache.d.ts +33 -0
- package/dist/sandbox/sandbox-env-cache.d.ts.map +1 -0
- package/dist/sandbox/sandbox-env-cache.js +140 -0
- package/dist/sandbox/sandbox-env-cache.js.map +1 -0
- package/dist/sandbox/sandbox-env.d.ts +77 -0
- package/dist/sandbox/sandbox-env.d.ts.map +1 -0
- package/dist/sandbox/sandbox-env.js +130 -0
- package/dist/sandbox/sandbox-env.js.map +1 -0
- package/dist/secret-encryption.d.ts +21 -0
- package/dist/secret-encryption.d.ts.map +1 -1
- package/dist/secret-encryption.js +31 -4
- package/dist/secret-encryption.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/live-sessions.d.ts +11 -4
- package/dist/session/live-sessions.d.ts.map +1 -1
- package/dist/session/live-sessions.js +31 -10
- package/dist/session/live-sessions.js.map +1 -1
- package/dist/session/self-review-gate.d.ts +6 -4
- package/dist/session/self-review-gate.d.ts.map +1 -1
- package/dist/session/self-review-gate.js +9 -12
- package/dist/session/self-review-gate.js.map +1 -1
- package/dist/session/session-threads.d.ts +10 -3
- 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/session/source-control-tools.d.ts +39 -13
- package/dist/session/source-control-tools.d.ts.map +1 -1
- package/dist/session/source-control-tools.js +55 -61
- package/dist/session/source-control-tools.js.map +1 -1
- package/dist/session/work-item-state-processor.d.ts +24 -0
- package/dist/session/work-item-state-processor.d.ts.map +1 -0
- package/dist/session/work-item-state-processor.js +275 -0
- package/dist/session/work-item-state-processor.js.map +1 -0
- package/dist/skills/catalog.js +1 -1
- package/dist/storage/domains/audit/actions.d.ts +3 -2
- package/dist/storage/domains/audit/actions.d.ts.map +1 -1
- package/dist/storage/domains/audit/actions.js +7 -5
- 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 +107 -23
- package/dist/storage/domains/boards/base.d.ts.map +1 -1
- package/dist/storage/domains/boards/base.js +201 -65
- 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 +25 -1
- package/dist/storage/domains/boards/schemas.js.map +1 -1
- package/dist/storage/domains/channel-identity/base.d.ts +0 -4
- package/dist/storage/domains/channel-identity/base.d.ts.map +1 -1
- package/dist/storage/domains/channel-identity/base.js +0 -7
- package/dist/storage/domains/channel-identity/base.js.map +1 -1
- package/dist/storage/domains/intake/base.d.ts +5 -45
- package/dist/storage/domains/intake/base.d.ts.map +1 -1
- package/dist/storage/domains/intake/base.js +11 -89
- package/dist/storage/domains/intake/base.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 +23 -9
- package/dist/storage/domains/projects/base.d.ts.map +1 -1
- package/dist/storage/domains/projects/base.js +24 -8
- package/dist/storage/domains/projects/base.js.map +1 -1
- package/dist/storage/domains/sandbox-envs/base.d.ts +70 -0
- package/dist/storage/domains/sandbox-envs/base.d.ts.map +1 -0
- package/dist/storage/domains/sandbox-envs/base.js +227 -0
- package/dist/storage/domains/sandbox-envs/base.js.map +1 -0
- 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 +93 -24
- package/dist/storage/domains/work-items/base.d.ts.map +1 -1
- package/dist/storage/domains/work-items/base.js +413 -188
- package/dist/storage/domains/work-items/base.js.map +1 -1
- package/dist/storage/domains/work-items/board-version.d.ts +6 -2
- package/dist/storage/domains/work-items/board-version.d.ts.map +1 -1
- package/dist/storage/domains/work-items/board-version.js +20 -9
- package/dist/storage/domains/work-items/board-version.js.map +1 -1
- package/dist/storage/domains/work-items/cards.d.ts +33 -5
- package/dist/storage/domains/work-items/cards.d.ts.map +1 -1
- package/dist/storage/domains/work-items/cards.js +208 -25
- package/dist/storage/domains/work-items/cards.js.map +1 -1
- package/dist/storage/domains/work-items/legacy-review.d.ts +63 -0
- package/dist/storage/domains/work-items/legacy-review.d.ts.map +1 -0
- package/dist/storage/domains/work-items/legacy-review.js +109 -0
- package/dist/storage/domains/work-items/legacy-review.js.map +1 -0
- package/dist/storage/domains/work-items/metrics.d.ts +12 -4
- package/dist/storage/domains/work-items/metrics.d.ts.map +1 -1
- package/dist/storage/domains/work-items/metrics.js +14 -32
- package/dist/storage/domains/work-items/metrics.js.map +1 -1
- package/dist/storage/domains/work-items/work-item-schema.d.ts +6 -2
- package/dist/storage/domains/work-items/work-item-schema.d.ts.map +1 -1
- package/dist/storage/domains/work-items/work-item-schema.js +83 -27
- 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/approval-tools.d.ts.map +1 -1
- package/dist/tools/approval-tools.js +28 -9
- package/dist/tools/approval-tools.js.map +1 -1
- package/dist/tools/index.d.ts +1 -1
- package/dist/tools/index.js +1 -1
- package/dist/tools/index.js.map +1 -1
- package/dist/tools/messaging-tools.d.ts +3 -0
- package/dist/tools/messaging-tools.d.ts.map +1 -1
- package/dist/tools/messaging-tools.js +2 -1
- package/dist/tools/messaging-tools.js.map +1 -1
- package/dist/tools/read-tools.d.ts +10 -6
- package/dist/tools/read-tools.d.ts.map +1 -1
- package/dist/tools/read-tools.js +89 -39
- package/dist/tools/read-tools.js.map +1 -1
- package/dist/tools/reports.d.ts +1 -0
- package/dist/tools/reports.d.ts.map +1 -1
- package/dist/tools/reports.js +2 -1
- package/dist/tools/reports.js.map +1 -1
- package/dist/tools/run-watch.d.ts +1 -1
- package/dist/tools/run-watch.d.ts.map +1 -1
- package/dist/tools/run-watch.js +1 -0
- package/dist/tools/run-watch.js.map +1 -1
- package/dist/tools/sandbox-tools.js +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 +1 -1
- package/dist/tools/session-tools.js.map +1 -1
- package/dist/tools/sessions-state-processor.d.ts +3 -1
- package/dist/tools/sessions-state-processor.d.ts.map +1 -1
- package/dist/tools/sessions-state-processor.js +13 -4
- package/dist/tools/sessions-state-processor.js.map +1 -1
- package/dist/tools/side-sessions.d.ts +2 -0
- package/dist/tools/side-sessions.d.ts.map +1 -1
- package/dist/tools/side-sessions.js +2 -1
- package/dist/tools/side-sessions.js.map +1 -1
- package/dist/tools/work-item-tools.d.ts +0 -3
- package/dist/tools/work-item-tools.d.ts.map +1 -1
- package/dist/tools/work-item-tools.js +10 -20
- package/dist/tools/work-item-tools.js.map +1 -1
- 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-item-branch.d.ts +13 -0
- package/dist/work-item-branch.d.ts.map +1 -1
- package/dist/work-item-branch.js +16 -1
- package/dist/work-item-branch.js.map +1 -1
- package/dist/work-items/create-work-item.d.ts +6 -0
- package/dist/work-items/create-work-item.d.ts.map +1 -1
- package/dist/work-items/create-work-item.js +28 -3
- package/dist/work-items/create-work-item.js.map +1 -1
- package/dist/work-items/description-context.d.ts +5 -0
- package/dist/work-items/description-context.d.ts.map +1 -0
- package/dist/work-items/description-context.js +17 -0
- package/dist/work-items/description-context.js.map +1 -0
- package/dist/work-items/providers/base.d.ts +4 -1
- package/dist/work-items/providers/base.d.ts.map +1 -1
- package/dist/work-items/providers/base.js +6 -1
- package/dist/work-items/providers/base.js.map +1 -1
- package/dist/work-items/providers/github.d.ts.map +1 -1
- package/dist/work-items/providers/github.js +2 -1
- package/dist/work-items/providers/github.js.map +1 -1
- package/dist/work-items/providers/gitlab.d.ts.map +1 -1
- package/dist/work-items/providers/gitlab.js +2 -1
- package/dist/work-items/providers/gitlab.js.map +1 -1
- package/dist/work-items/providers/jira.d.ts.map +1 -1
- package/dist/work-items/providers/jira.js +3 -2
- package/dist/work-items/providers/jira.js.map +1 -1
- package/dist/work-items/providers/linear.d.ts.map +1 -1
- package/dist/work-items/providers/linear.js +3 -2
- package/dist/work-items/providers/linear.js.map +1 -1
- package/dist/work-items/providers/types.d.ts +6 -0
- package/dist/work-items/providers/types.d.ts.map +1 -1
- 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 +178 -70
- package/dist/work-items/split-migration.js.map +1 -1
- package/dist/workspace.d.ts +3 -1
- package/dist/workspace.d.ts.map +1 -1
- package/dist/workspace.js +118 -34
- package/dist/workspace.js.map +1 -1
- package/factory-skills/configure-factory-rules/SKILL.md +13 -11
- package/factory-skills/factory-build/SKILL.md +64 -0
- package/factory-skills/factory-gitlab-rereview/SKILL.md +4 -4
- package/factory-skills/factory-gitlab-review/SKILL.md +6 -6
- package/factory-skills/factory-plan/SKILL.md +8 -10
- package/factory-skills/factory-rereview/SKILL.md +74 -28
- package/factory-skills/factory-review/SKILL.md +85 -29
- package/factory-skills/factory-self-review/SKILL.md +32 -13
- package/factory-skills/factory-triage/SKILL.md +36 -32
- package/package.json +12 -11
- package/dist/boards/index.js.map +0 -1
- package/dist/boards/pull-request-review.d.ts +0 -14
- package/dist/boards/pull-request-review.d.ts.map +0 -1
- package/dist/boards/pull-request-review.js +0 -81
- package/dist/boards/pull-request-review.js.map +0 -1
- package/dist/boards/work-tool-rules.d.ts +0 -8
- package/dist/boards/work-tool-rules.d.ts.map +0 -1
- package/dist/boards/work-tool-rules.js +0 -19
- package/dist/boards/work-tool-rules.js.map +0 -1
- package/dist/integrations/slack/emoji-shortcodes.generated.d.ts +0 -8
- package/dist/integrations/slack/emoji-shortcodes.generated.d.ts.map +0 -1
- package/dist/integrations/slack/emoji-shortcodes.generated.js +0 -1984
- package/dist/integrations/slack/emoji-shortcodes.generated.js.map +0 -1
- package/dist/integrations/slack/emoji.d.ts +0 -3
- package/dist/integrations/slack/emoji.d.ts.map +0 -1
- package/dist/integrations/slack/emoji.js +0 -11
- package/dist/integrations/slack/emoji.js.map +0 -1
- package/dist/integrations/slack/feed-publisher.d.ts +0 -26
- package/dist/integrations/slack/feed-publisher.d.ts.map +0 -1
- package/dist/integrations/slack/feed-publisher.js +0 -43
- package/dist/integrations/slack/feed-publisher.js.map +0 -1
- package/dist/routes/attention-activity.d.ts +0 -23
- package/dist/routes/attention-activity.d.ts.map +0 -1
- package/dist/routes/attention-activity.js +0 -154
- package/dist/routes/attention-activity.js.map +0 -1
- package/dist/rules/resolve.d.ts +0 -15
- package/dist/rules/resolve.d.ts.map +0 -1
- package/dist/rules/resolve.js +0 -22
- package/dist/rules/resolve.js.map +0 -1
- package/dist/storage/domains/comments/activity.d.ts +0 -40
- package/dist/storage/domains/comments/activity.d.ts.map +0 -1
- package/dist/storage/domains/comments/activity.js +0 -93
- package/dist/storage/domains/comments/activity.js.map +0 -1
- package/dist/storage/domains/comments/actor.d.ts +0 -51
- package/dist/storage/domains/comments/actor.d.ts.map +0 -1
- package/dist/storage/domains/comments/actor.js +0 -37
- package/dist/storage/domains/comments/actor.js.map +0 -1
- package/dist/storage/domains/comments/base.d.ts +0 -245
- package/dist/storage/domains/comments/base.d.ts.map +0 -1
- package/dist/storage/domains/comments/base.js +0 -539
- package/dist/storage/domains/comments/base.js.map +0 -1
- package/dist/storage/domains/comments/domain.d.ts +0 -135
- package/dist/storage/domains/comments/domain.d.ts.map +0 -1
- package/dist/storage/domains/comments/domain.js +0 -284
- package/dist/storage/domains/comments/domain.js.map +0 -1
- package/dist/storage/domains/comments/feed-context.d.ts +0 -22
- package/dist/storage/domains/comments/feed-context.d.ts.map +0 -1
- package/dist/storage/domains/comments/feed-context.js +0 -88
- package/dist/storage/domains/comments/feed-context.js.map +0 -1
- package/dist/storage/domains/comments/feed-sync.d.ts +0 -21
- package/dist/storage/domains/comments/feed-sync.d.ts.map +0 -1
- package/dist/storage/domains/comments/feed-sync.js +0 -1
- package/dist/storage/domains/comments/parse.d.ts +0 -23
- package/dist/storage/domains/comments/parse.d.ts.map +0 -1
- package/dist/storage/domains/comments/parse.js +0 -89
- package/dist/storage/domains/comments/parse.js.map +0 -1
- package/dist/storage/domains/comments/routes.d.ts +0 -24
- package/dist/storage/domains/comments/routes.d.ts.map +0 -1
- package/dist/storage/domains/comments/routes.js +0 -301
- package/dist/storage/domains/comments/routes.js.map +0 -1
- package/dist/storage/domains/comments/schema.d.ts +0 -5
- package/dist/storage/domains/comments/schema.d.ts.map +0 -1
- package/dist/storage/domains/comments/schema.js +0 -178
- package/dist/storage/domains/comments/schema.js.map +0 -1
- package/dist/storage/domains/comments/wire.d.ts +0 -40
- package/dist/storage/domains/comments/wire.d.ts.map +0 -1
- package/dist/storage/domains/comments/wire.js +0 -36
- package/dist/storage/domains/comments/wire.js.map +0 -1
- package/factory-skills/factory-complete-issue/SKILL.md +0 -24
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import type { PubSub } from '@mastra/core/events';
|
|
2
|
+
import type { ResolvedSandboxEnvs, SandboxEnvAppliesTo, SandboxEnvMetadata, SandboxEnvRevisions, SandboxEnvStore, SetSandboxEnvInput } from '../storage/domains/sandbox-envs/base.js';
|
|
3
|
+
/** One topic for every Factory: a replica drops its cached entry for the Factory named in the event. */
|
|
4
|
+
export declare const SANDBOX_ENV_CHANGED_TOPIC = "factory.sandbox-env";
|
|
5
|
+
/**
|
|
6
|
+
* The sandbox-envs store with reads served from memory. The revision is
|
|
7
|
+
* re-read only when a write is announced (by this replica or another one
|
|
8
|
+
* through the event bus) or the read gets old, and values are decrypted again
|
|
9
|
+
* only when the revision changed. Commands and workspace resolves then cost
|
|
10
|
+
* no storage reads while nobody edits a variable.
|
|
11
|
+
*
|
|
12
|
+
* Writes go through to the store, drop this replica's entry and announce the
|
|
13
|
+
* change, so the next command anywhere sees it.
|
|
14
|
+
*/
|
|
15
|
+
export declare class CachedSandboxEnvs implements SandboxEnvStore {
|
|
16
|
+
#private;
|
|
17
|
+
private readonly store;
|
|
18
|
+
private readonly options;
|
|
19
|
+
constructor(store: SandboxEnvStore, options?: {
|
|
20
|
+
pubsub?: PubSub;
|
|
21
|
+
crossProcess?: boolean;
|
|
22
|
+
now?: () => number;
|
|
23
|
+
});
|
|
24
|
+
/** Listen for other replicas' writes; resolves to the unsubscribe. */
|
|
25
|
+
subscribe(): Promise<() => Promise<void>>;
|
|
26
|
+
list(orgId: string, projectId: string): Promise<SandboxEnvMetadata[]>;
|
|
27
|
+
set(orgId: string, projectId: string, input: SetSandboxEnvInput, actorId: string): Promise<SandboxEnvMetadata>;
|
|
28
|
+
updateAppliesTo(orgId: string, projectId: string, name: string, appliesTo: SandboxEnvAppliesTo, actorId: string): Promise<SandboxEnvMetadata | null>;
|
|
29
|
+
delete(orgId: string, projectId: string, name: string): Promise<boolean>;
|
|
30
|
+
revisions(orgId: string, projectId: string): Promise<SandboxEnvRevisions | null>;
|
|
31
|
+
resolve(orgId: string, projectId: string): Promise<ResolvedSandboxEnvs>;
|
|
32
|
+
}
|
|
33
|
+
//# sourceMappingURL=sandbox-env-cache.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"sandbox-env-cache.d.ts","sourceRoot":"","sources":["../../src/sandbox/sandbox-env-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAGjE,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EACnB,MAAM,yCAAyC,CAAC;AAEjD,wGAAwG;AACxG,eAAO,MAAM,yBAAyB,wBAAwB,CAAC;AAoB/D;;;;;;;;;GASG;AACH,qBAAa,iBAAkB,YAAW,eAAe;;IAWrD,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAF1B,YACmB,KAAK,EAAE,eAAe,EACtB,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,OAAO,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;KAAO,EAG/F;IAED,sEAAsE;IAChE,SAAS,IAAI,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAM9C;IAED,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAEpE;IAEK,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,+BAIrF;IAEK,eAAe,CACnB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,mBAAmB,EAC9B,OAAO,EAAE,MAAM,sCAKhB;IAEK,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,oBAI1D;IAED,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAE/E;IAEK,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAoB5E;CAgCF"}
|
|
@@ -0,0 +1,140 @@
|
|
|
1
|
+
import { withAck } from "@mastra/core/events";
|
|
2
|
+
// src/sandbox/sandbox-env-cache.ts
|
|
3
|
+
/** One topic for every Factory: a replica drops its cached entry for the Factory named in the event. */
|
|
4
|
+
const SANDBOX_ENV_CHANGED_TOPIC = "factory.sandbox-env";
|
|
5
|
+
/**
|
|
6
|
+
* How long a revision read is trusted without hearing of a change. With a
|
|
7
|
+
* cross-process event bus, other replicas announce their writes, so this is
|
|
8
|
+
* only a safety net for a missed event. Without one, a write on another
|
|
9
|
+
* replica is only seen when the read expires.
|
|
10
|
+
*/
|
|
11
|
+
const TRUST_WITH_EVENTS_MS = 6e4;
|
|
12
|
+
const TRUST_WITHOUT_EVENTS_MS = 1e3;
|
|
13
|
+
/**
|
|
14
|
+
* The sandbox-envs store with reads served from memory. The revision is
|
|
15
|
+
* re-read only when a write is announced (by this replica or another one
|
|
16
|
+
* through the event bus) or the read gets old, and values are decrypted again
|
|
17
|
+
* only when the revision changed. Commands and workspace resolves then cost
|
|
18
|
+
* no storage reads while nobody edits a variable.
|
|
19
|
+
*
|
|
20
|
+
* Writes go through to the store, drop this replica's entry and announce the
|
|
21
|
+
* change, so the next command anywhere sees it.
|
|
22
|
+
*/
|
|
23
|
+
var CachedSandboxEnvs = class {
|
|
24
|
+
store;
|
|
25
|
+
options;
|
|
26
|
+
#entries = /* @__PURE__ */ new Map();
|
|
27
|
+
#origin = globalThis.crypto.randomUUID();
|
|
28
|
+
#trustMs;
|
|
29
|
+
#onEvent = withAck(async (event) => {
|
|
30
|
+
if (event.runId === this.#origin) return;
|
|
31
|
+
const { orgId, projectId } = event.data ?? {};
|
|
32
|
+
if (typeof orgId === "string" && typeof projectId === "string") this.#forget({
|
|
33
|
+
orgId,
|
|
34
|
+
projectId
|
|
35
|
+
});
|
|
36
|
+
});
|
|
37
|
+
constructor(store, options = {}) {
|
|
38
|
+
this.store = store;
|
|
39
|
+
this.options = options;
|
|
40
|
+
this.#trustMs = options.crossProcess ? TRUST_WITH_EVENTS_MS : TRUST_WITHOUT_EVENTS_MS;
|
|
41
|
+
}
|
|
42
|
+
/** Listen for other replicas' writes; resolves to the unsubscribe. */
|
|
43
|
+
async subscribe() {
|
|
44
|
+
const pubsub = this.options.pubsub;
|
|
45
|
+
if (!pubsub) return async () => {};
|
|
46
|
+
await pubsub.subscribe(SANDBOX_ENV_CHANGED_TOPIC, this.#onEvent, { startFrom: "latest" });
|
|
47
|
+
return () => pubsub.unsubscribe(SANDBOX_ENV_CHANGED_TOPIC, this.#onEvent);
|
|
48
|
+
}
|
|
49
|
+
list(orgId, projectId) {
|
|
50
|
+
return this.store.list(orgId, projectId);
|
|
51
|
+
}
|
|
52
|
+
async set(orgId, projectId, input, actorId) {
|
|
53
|
+
const env = await this.store.set(orgId, projectId, input, actorId);
|
|
54
|
+
this.#changed({
|
|
55
|
+
orgId,
|
|
56
|
+
projectId
|
|
57
|
+
});
|
|
58
|
+
return env;
|
|
59
|
+
}
|
|
60
|
+
async updateAppliesTo(orgId, projectId, name, appliesTo, actorId) {
|
|
61
|
+
const env = await this.store.updateAppliesTo(orgId, projectId, name, appliesTo, actorId);
|
|
62
|
+
if (env) this.#changed({
|
|
63
|
+
orgId,
|
|
64
|
+
projectId
|
|
65
|
+
});
|
|
66
|
+
return env;
|
|
67
|
+
}
|
|
68
|
+
async delete(orgId, projectId, name) {
|
|
69
|
+
const deleted = await this.store.delete(orgId, projectId, name);
|
|
70
|
+
if (deleted) this.#changed({
|
|
71
|
+
orgId,
|
|
72
|
+
projectId
|
|
73
|
+
});
|
|
74
|
+
return deleted;
|
|
75
|
+
}
|
|
76
|
+
revisions(orgId, projectId) {
|
|
77
|
+
return this.#entry({
|
|
78
|
+
orgId,
|
|
79
|
+
projectId
|
|
80
|
+
}).revisions;
|
|
81
|
+
}
|
|
82
|
+
async resolve(orgId, projectId) {
|
|
83
|
+
const entry = this.#entry({
|
|
84
|
+
orgId,
|
|
85
|
+
projectId
|
|
86
|
+
});
|
|
87
|
+
const current = (await entry.revisions)?.revision ?? "";
|
|
88
|
+
if (entry.resolved) {
|
|
89
|
+
const cached = await entry.resolved.catch(() => void 0);
|
|
90
|
+
if (cached?.revision === current) return cached;
|
|
91
|
+
}
|
|
92
|
+
const resolved = this.store.resolve(orgId, projectId);
|
|
93
|
+
entry.resolved = resolved;
|
|
94
|
+
resolved.then(({ revision, buildRevision }) => {
|
|
95
|
+
if (revision !== current) entry.revisions = Promise.resolve({
|
|
96
|
+
revision,
|
|
97
|
+
buildRevision
|
|
98
|
+
});
|
|
99
|
+
}, () => {
|
|
100
|
+
if (entry.resolved === resolved) entry.resolved = void 0;
|
|
101
|
+
});
|
|
102
|
+
return resolved;
|
|
103
|
+
}
|
|
104
|
+
#entry(scope) {
|
|
105
|
+
const key = keyOf(scope);
|
|
106
|
+
const now = (this.options.now ?? Date.now)();
|
|
107
|
+
const existing = this.#entries.get(key);
|
|
108
|
+
if (existing && now - existing.at < this.#trustMs) return existing;
|
|
109
|
+
const revisions = this.store.revisions(scope.orgId, scope.projectId);
|
|
110
|
+
const entry = {
|
|
111
|
+
at: now,
|
|
112
|
+
revisions,
|
|
113
|
+
...existing?.resolved ? { resolved: existing.resolved } : {}
|
|
114
|
+
};
|
|
115
|
+
this.#entries.set(key, entry);
|
|
116
|
+
revisions.catch(() => {
|
|
117
|
+
if (this.#entries.get(key) === entry) this.#entries.delete(key);
|
|
118
|
+
});
|
|
119
|
+
return entry;
|
|
120
|
+
}
|
|
121
|
+
#forget(scope) {
|
|
122
|
+
this.#entries.delete(keyOf(scope));
|
|
123
|
+
}
|
|
124
|
+
#changed(scope) {
|
|
125
|
+
this.#forget(scope);
|
|
126
|
+
this.options.pubsub?.publish(SANDBOX_ENV_CHANGED_TOPIC, {
|
|
127
|
+
type: "factory.sandbox-env.changed",
|
|
128
|
+
runId: this.#origin,
|
|
129
|
+
data: scope
|
|
130
|
+
}).catch((error) => {
|
|
131
|
+
console.warn("[Factory] Failed to announce a sandbox environment variable change", { error: error instanceof Error ? error.message : String(error) });
|
|
132
|
+
});
|
|
133
|
+
}
|
|
134
|
+
};
|
|
135
|
+
function keyOf(scope) {
|
|
136
|
+
return `${scope.orgId}\u0000${scope.projectId}`;
|
|
137
|
+
}
|
|
138
|
+
export { CachedSandboxEnvs, SANDBOX_ENV_CHANGED_TOPIC };
|
|
139
|
+
|
|
140
|
+
//# sourceMappingURL=sandbox-env-cache.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"sandbox-env-cache.js","names":[],"sources":["../../src/sandbox/sandbox-env-cache.ts"],"sourcesContent":["import type { EventCallback, PubSub } from '@mastra/core/events';\nimport { withAck } from '@mastra/core/events';\n\nimport type {\n ResolvedSandboxEnvs,\n SandboxEnvAppliesTo,\n SandboxEnvMetadata,\n SandboxEnvRevisions,\n SandboxEnvStore,\n SetSandboxEnvInput,\n} from '../storage/domains/sandbox-envs/base.js';\n\n/** One topic for every Factory: a replica drops its cached entry for the Factory named in the event. */\nexport const SANDBOX_ENV_CHANGED_TOPIC = 'factory.sandbox-env';\n\n/**\n * How long a revision read is trusted without hearing of a change. With a\n * cross-process event bus, other replicas announce their writes, so this is\n * only a safety net for a missed event. Without one, a write on another\n * replica is only seen when the read expires.\n */\nconst TRUST_WITH_EVENTS_MS = 60_000;\nconst TRUST_WITHOUT_EVENTS_MS = 1_000;\n\ntype Scope = { orgId: string; projectId: string };\n\ninterface Entry {\n at: number;\n revisions: Promise<SandboxEnvRevisions | null>;\n /** Decrypted values, reused while the revision they were read at is current. */\n resolved?: Promise<ResolvedSandboxEnvs>;\n}\n\n/**\n * The sandbox-envs store with reads served from memory. The revision is\n * re-read only when a write is announced (by this replica or another one\n * through the event bus) or the read gets old, and values are decrypted again\n * only when the revision changed. Commands and workspace resolves then cost\n * no storage reads while nobody edits a variable.\n *\n * Writes go through to the store, drop this replica's entry and announce the\n * change, so the next command anywhere sees it.\n */\nexport class CachedSandboxEnvs implements SandboxEnvStore {\n readonly #entries = new Map<string, Entry>();\n readonly #origin = globalThis.crypto.randomUUID();\n readonly #trustMs: number;\n readonly #onEvent: EventCallback = withAck(async event => {\n if (event.runId === this.#origin) return;\n const { orgId, projectId } = (event.data ?? {}) as Partial<Scope>;\n if (typeof orgId === 'string' && typeof projectId === 'string') this.#forget({ orgId, projectId });\n });\n\n constructor(\n private readonly store: SandboxEnvStore,\n private readonly options: { pubsub?: PubSub; crossProcess?: boolean; now?: () => number } = {},\n ) {\n this.#trustMs = options.crossProcess ? TRUST_WITH_EVENTS_MS : TRUST_WITHOUT_EVENTS_MS;\n }\n\n /** Listen for other replicas' writes; resolves to the unsubscribe. */\n async subscribe(): Promise<() => Promise<void>> {\n const pubsub = this.options.pubsub;\n if (!pubsub) return async () => {};\n // Without `latest`, a retaining broker replays old changes on boot.\n await pubsub.subscribe(SANDBOX_ENV_CHANGED_TOPIC, this.#onEvent, { startFrom: 'latest' });\n return () => pubsub.unsubscribe(SANDBOX_ENV_CHANGED_TOPIC, this.#onEvent);\n }\n\n list(orgId: string, projectId: string): Promise<SandboxEnvMetadata[]> {\n return this.store.list(orgId, projectId);\n }\n\n async set(orgId: string, projectId: string, input: SetSandboxEnvInput, actorId: string) {\n const env = await this.store.set(orgId, projectId, input, actorId);\n this.#changed({ orgId, projectId });\n return env;\n }\n\n async updateAppliesTo(\n orgId: string,\n projectId: string,\n name: string,\n appliesTo: SandboxEnvAppliesTo,\n actorId: string,\n ) {\n const env = await this.store.updateAppliesTo(orgId, projectId, name, appliesTo, actorId);\n if (env) this.#changed({ orgId, projectId });\n return env;\n }\n\n async delete(orgId: string, projectId: string, name: string) {\n const deleted = await this.store.delete(orgId, projectId, name);\n if (deleted) this.#changed({ orgId, projectId });\n return deleted;\n }\n\n revisions(orgId: string, projectId: string): Promise<SandboxEnvRevisions | null> {\n return this.#entry({ orgId, projectId }).revisions;\n }\n\n async resolve(orgId: string, projectId: string): Promise<ResolvedSandboxEnvs> {\n const entry = this.#entry({ orgId, projectId });\n const current = (await entry.revisions)?.revision ?? '';\n if (entry.resolved) {\n const cached = await entry.resolved.catch(() => undefined);\n if (cached?.revision === current) return cached;\n }\n const resolved = this.store.resolve(orgId, projectId);\n entry.resolved = resolved;\n resolved.then(\n // The values carry their own revision; adopt it so the next call matches instead of decrypting again.\n ({ revision, buildRevision }) => {\n if (revision !== current) entry.revisions = Promise.resolve({ revision, buildRevision });\n },\n // Keep only a read that succeeded.\n () => {\n if (entry.resolved === resolved) entry.resolved = undefined;\n },\n );\n return resolved;\n }\n\n #entry(scope: Scope): Entry {\n const key = keyOf(scope);\n const now = (this.options.now ?? Date.now)();\n const existing = this.#entries.get(key);\n if (existing && now - existing.at < this.#trustMs) return existing;\n const revisions = this.store.revisions(scope.orgId, scope.projectId);\n // The decrypted values survive a re-read: `resolve` reuses them if the revision didn't move.\n const entry: Entry = { at: now, revisions, ...(existing?.resolved ? { resolved: existing.resolved } : {}) };\n this.#entries.set(key, entry);\n // A failed read is never served from memory.\n revisions.catch(() => {\n if (this.#entries.get(key) === entry) this.#entries.delete(key);\n });\n return entry;\n }\n\n #forget(scope: Scope): void {\n this.#entries.delete(keyOf(scope));\n }\n\n #changed(scope: Scope): void {\n this.#forget(scope);\n this.options.pubsub\n ?.publish(SANDBOX_ENV_CHANGED_TOPIC, { type: 'factory.sandbox-env.changed', runId: this.#origin, data: scope })\n .catch((error: unknown) => {\n console.warn('[Factory] Failed to announce a sandbox environment variable change', {\n error: error instanceof Error ? error.message : String(error),\n });\n });\n }\n}\n\nfunction keyOf(scope: Scope): string {\n return `${scope.orgId}\\u0000${scope.projectId}`;\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Sandbox environment variables: what a session sandbox's commands and builds
|
|
3
|
+
* get from the Factory's stored variables, and how a running sandbox picks up
|
|
4
|
+
* edits on its next command.
|
|
5
|
+
*/
|
|
6
|
+
import type { FactorySandboxContext } from '@mastra/core/workspace';
|
|
7
|
+
import type { SandboxEnvStore } from '../storage/domains/sandbox-envs/base.js';
|
|
8
|
+
export interface SandboxEnv {
|
|
9
|
+
/** Variables every command in the sandbox gets. */
|
|
10
|
+
runtime: Record<string, string>;
|
|
11
|
+
/** Variables template builds and Factory-run setup commands get; never runtime commands. */
|
|
12
|
+
build: Record<string, string>;
|
|
13
|
+
/** Read before the values: an edit landing in between makes the next check reload. */
|
|
14
|
+
revision: string;
|
|
15
|
+
buildRevision: string;
|
|
16
|
+
}
|
|
17
|
+
/**
|
|
18
|
+
* The single place a sandbox's environment is resolved. v1 reads only the
|
|
19
|
+
* Factory-wide variables; personal and session layers merge in here later,
|
|
20
|
+
* with session over personal over Factory, so callers never change.
|
|
21
|
+
*/
|
|
22
|
+
export declare function resolveSandboxEnv(store: Pick<SandboxEnvStore, 'resolve'>, scope: {
|
|
23
|
+
orgId: string;
|
|
24
|
+
projectId: string;
|
|
25
|
+
}): Promise<SandboxEnv>;
|
|
26
|
+
/**
|
|
27
|
+
* `resolveSandboxEnv` for session boot and setup: a failed read (a storage
|
|
28
|
+
* blip, a value encrypted with a removed key) is logged and yields no Factory
|
|
29
|
+
* variables, so it can't stop a session from starting. Its empty revision
|
|
30
|
+
* makes the first command's refresh try again.
|
|
31
|
+
*/
|
|
32
|
+
export declare function resolveSandboxEnvOrEmpty(store: Pick<SandboxEnvStore, 'resolve'>, scope: {
|
|
33
|
+
orgId: string;
|
|
34
|
+
projectId: string;
|
|
35
|
+
}): Promise<SandboxEnv>;
|
|
36
|
+
/**
|
|
37
|
+
* The template-build fields of a sandbox context. Omitted when the Factory has
|
|
38
|
+
* no Build variables, so the template identity matches one built without them.
|
|
39
|
+
* Session boot and environment builds share this, so both name the same template.
|
|
40
|
+
*/
|
|
41
|
+
export declare function sandboxBuildContext(env: SandboxEnv | undefined): Pick<FactorySandboxContext, 'buildEnv' | 'buildEnvRevision'>;
|
|
42
|
+
/**
|
|
43
|
+
* Replace every Build value that appears in provider or command output with
|
|
44
|
+
* `***`. Each value is also matched without its edge whitespace, since output
|
|
45
|
+
* often drops a pasted trailing space or newline. Longest first, so a value
|
|
46
|
+
* that contains another is masked whole.
|
|
47
|
+
*/
|
|
48
|
+
export declare function maskSandboxEnvValues(text: string, env: Record<string, string> | undefined): string;
|
|
49
|
+
type EnvOverlay = Record<string, string | undefined>;
|
|
50
|
+
/**
|
|
51
|
+
* The Factory runtime values currently applied to a sandbox, so output from a
|
|
52
|
+
* command that ran in it (a failed teardown) can be masked without a storage read.
|
|
53
|
+
*/
|
|
54
|
+
export declare function appliedSandboxEnv(sandbox: object): Record<string, string>;
|
|
55
|
+
export interface RefreshableSandbox {
|
|
56
|
+
ensureRunning?: () => Promise<void>;
|
|
57
|
+
setEnv?: (update: (env: EnvOverlay) => EnvOverlay) => void;
|
|
58
|
+
}
|
|
59
|
+
/**
|
|
60
|
+
* Apply the Factory's runtime variables to a sandbox's env overlay and keep
|
|
61
|
+
* them current: after every `ensureRunning()` (which every command path awaits
|
|
62
|
+
* before reading the overlay) the Factory revision is checked, and on a change
|
|
63
|
+
* the variables are reloaded and re-applied, so an add, edit or delete reaches
|
|
64
|
+
* the next command. Processes already running keep the env they started with.
|
|
65
|
+
*
|
|
66
|
+
* A key the sandbox already had (its host `env`) is remembered before Factory
|
|
67
|
+
* first writes it and restored when the Factory variable goes away. A refresh
|
|
68
|
+
* that fails is logged and the command runs with the env last applied.
|
|
69
|
+
*/
|
|
70
|
+
export declare function attachSandboxEnvRefresh(sandbox: RefreshableSandbox, options: {
|
|
71
|
+
initial: Pick<SandboxEnv, 'runtime' | 'revision'>;
|
|
72
|
+
revision: () => Promise<string>;
|
|
73
|
+
load: () => Promise<Pick<SandboxEnv, 'runtime' | 'revision'>>;
|
|
74
|
+
onError?: (error: unknown) => void;
|
|
75
|
+
}): void;
|
|
76
|
+
export {};
|
|
77
|
+
//# sourceMappingURL=sandbox-env.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"sandbox-env.d.ts","sourceRoot":"","sources":["../../src/sandbox/sandbox-env.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAE/E,MAAM,WAAW,UAAU;IACzB,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,4FAA4F;IAC5F,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,sFAAsF;IACtF,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,SAAS,CAAC,EACvC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC1C,OAAO,CAAC,UAAU,CAAC,CAGrB;AASD;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,SAAS,CAAC,EACvC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC1C,OAAO,CAAC,UAAU,CAAC,CAOrB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,UAAU,GAAG,SAAS,GAC1B,IAAI,CAAC,qBAAqB,EAAE,UAAU,GAAG,kBAAkB,CAAC,CAG9D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GAAG,MAAM,CAQlG;AAED,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAIrD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEzE;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,UAAU,KAAK,IAAI,CAAC;CAC5D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE;IACP,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,UAAU,CAAC,CAAC;IAClD,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC;IAC9D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC,GACA,IAAI,CAmDN"}
|
|
@@ -0,0 +1,130 @@
|
|
|
1
|
+
// src/sandbox/sandbox-env.ts
|
|
2
|
+
/**
|
|
3
|
+
* The single place a sandbox's environment is resolved. v1 reads only the
|
|
4
|
+
* Factory-wide variables; personal and session layers merge in here later,
|
|
5
|
+
* with session over personal over Factory, so callers never change.
|
|
6
|
+
*/
|
|
7
|
+
async function resolveSandboxEnv(store, scope) {
|
|
8
|
+
const { runtime, build, revision, buildRevision } = await store.resolve(scope.orgId, scope.projectId);
|
|
9
|
+
return {
|
|
10
|
+
runtime,
|
|
11
|
+
build,
|
|
12
|
+
revision,
|
|
13
|
+
buildRevision
|
|
14
|
+
};
|
|
15
|
+
}
|
|
16
|
+
function warnReadFailed(message, error) {
|
|
17
|
+
console.warn(`[Mastra Factory] ${message}`, { error: error instanceof Error ? error.message : String(error) });
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* `resolveSandboxEnv` for session boot and setup: a failed read (a storage
|
|
21
|
+
* blip, a value encrypted with a removed key) is logged and yields no Factory
|
|
22
|
+
* variables, so it can't stop a session from starting. Its empty revision
|
|
23
|
+
* makes the first command's refresh try again.
|
|
24
|
+
*/
|
|
25
|
+
async function resolveSandboxEnvOrEmpty(store, scope) {
|
|
26
|
+
try {
|
|
27
|
+
return await resolveSandboxEnv(store, scope);
|
|
28
|
+
} catch (error) {
|
|
29
|
+
warnReadFailed("Could not read sandbox environment variables; starting without them", error);
|
|
30
|
+
return {
|
|
31
|
+
runtime: {},
|
|
32
|
+
build: {},
|
|
33
|
+
revision: "",
|
|
34
|
+
buildRevision: ""
|
|
35
|
+
};
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
* The template-build fields of a sandbox context. Omitted when the Factory has
|
|
40
|
+
* no Build variables, so the template identity matches one built without them.
|
|
41
|
+
* Session boot and environment builds share this, so both name the same template.
|
|
42
|
+
*/
|
|
43
|
+
function sandboxBuildContext(env) {
|
|
44
|
+
if (!env || Object.keys(env.build).length === 0) return {};
|
|
45
|
+
return {
|
|
46
|
+
buildEnv: env.build,
|
|
47
|
+
buildEnvRevision: env.buildRevision
|
|
48
|
+
};
|
|
49
|
+
}
|
|
50
|
+
/**
|
|
51
|
+
* Replace every Build value that appears in provider or command output with
|
|
52
|
+
* `***`. Each value is also matched without its edge whitespace, since output
|
|
53
|
+
* often drops a pasted trailing space or newline. Longest first, so a value
|
|
54
|
+
* that contains another is masked whole.
|
|
55
|
+
*/
|
|
56
|
+
function maskSandboxEnvValues(text, env) {
|
|
57
|
+
if (!env) return text;
|
|
58
|
+
const values = new Set(Object.values(env).flatMap((value) => [value, value.trim()]));
|
|
59
|
+
let masked = text;
|
|
60
|
+
for (const value of [...values].sort((a, b) => b.length - a.length)) if (value) masked = masked.replaceAll(value, "***");
|
|
61
|
+
return masked;
|
|
62
|
+
}
|
|
63
|
+
const appliedBySandbox = /* @__PURE__ */ new WeakMap();
|
|
64
|
+
/**
|
|
65
|
+
* The Factory runtime values currently applied to a sandbox, so output from a
|
|
66
|
+
* command that ran in it (a failed teardown) can be masked without a storage read.
|
|
67
|
+
*/
|
|
68
|
+
function appliedSandboxEnv(sandbox) {
|
|
69
|
+
return appliedBySandbox.get(sandbox)?.() ?? {};
|
|
70
|
+
}
|
|
71
|
+
/**
|
|
72
|
+
* Apply the Factory's runtime variables to a sandbox's env overlay and keep
|
|
73
|
+
* them current: after every `ensureRunning()` (which every command path awaits
|
|
74
|
+
* before reading the overlay) the Factory revision is checked, and on a change
|
|
75
|
+
* the variables are reloaded and re-applied, so an add, edit or delete reaches
|
|
76
|
+
* the next command. Processes already running keep the env they started with.
|
|
77
|
+
*
|
|
78
|
+
* A key the sandbox already had (its host `env`) is remembered before Factory
|
|
79
|
+
* first writes it and restored when the Factory variable goes away. A refresh
|
|
80
|
+
* that fails is logged and the command runs with the env last applied.
|
|
81
|
+
*/
|
|
82
|
+
function attachSandboxEnvRefresh(sandbox, options) {
|
|
83
|
+
const setEnv = sandbox.setEnv?.bind(sandbox);
|
|
84
|
+
if (!setEnv) return;
|
|
85
|
+
const shadowed = /* @__PURE__ */ new Map();
|
|
86
|
+
let applied = {};
|
|
87
|
+
let appliedRevision = options.initial.revision;
|
|
88
|
+
const apply = (next) => {
|
|
89
|
+
setEnv((env) => {
|
|
90
|
+
const out = { ...env };
|
|
91
|
+
for (const key of Object.keys(applied)) {
|
|
92
|
+
if (Object.hasOwn(next, key)) continue;
|
|
93
|
+
const previous = shadowed.get(key);
|
|
94
|
+
shadowed.delete(key);
|
|
95
|
+
if (previous === void 0) delete out[key];
|
|
96
|
+
else out[key] = previous;
|
|
97
|
+
}
|
|
98
|
+
for (const [key, value] of Object.entries(next)) {
|
|
99
|
+
if (!Object.hasOwn(applied, key)) shadowed.set(key, env[key]);
|
|
100
|
+
out[key] = value;
|
|
101
|
+
}
|
|
102
|
+
return out;
|
|
103
|
+
});
|
|
104
|
+
applied = { ...next };
|
|
105
|
+
};
|
|
106
|
+
apply(options.initial.runtime);
|
|
107
|
+
appliedBySandbox.set(sandbox, () => applied);
|
|
108
|
+
const original = sandbox.ensureRunning?.bind(sandbox);
|
|
109
|
+
if (!original) return;
|
|
110
|
+
let inFlight;
|
|
111
|
+
const refresh = async () => {
|
|
112
|
+
if (await options.revision() === appliedRevision) return;
|
|
113
|
+
const next = await options.load();
|
|
114
|
+
apply(next.runtime);
|
|
115
|
+
appliedRevision = next.revision;
|
|
116
|
+
};
|
|
117
|
+
sandbox.ensureRunning = async () => {
|
|
118
|
+
await original();
|
|
119
|
+
inFlight ??= refresh().catch((error) => {
|
|
120
|
+
if (options.onError) options.onError(error);
|
|
121
|
+
else warnReadFailed("Could not refresh sandbox environment variables; using the last applied", error);
|
|
122
|
+
}).finally(() => {
|
|
123
|
+
inFlight = void 0;
|
|
124
|
+
});
|
|
125
|
+
await inFlight;
|
|
126
|
+
};
|
|
127
|
+
}
|
|
128
|
+
export { appliedSandboxEnv, attachSandboxEnvRefresh, maskSandboxEnvValues, resolveSandboxEnv, resolveSandboxEnvOrEmpty, sandboxBuildContext };
|
|
129
|
+
|
|
130
|
+
//# sourceMappingURL=sandbox-env.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"sandbox-env.js","names":[],"sources":["../../src/sandbox/sandbox-env.ts"],"sourcesContent":["/**\n * Sandbox environment variables: what a session sandbox's commands and builds\n * get from the Factory's stored variables, and how a running sandbox picks up\n * edits on its next command.\n */\n\nimport type { FactorySandboxContext } from '@mastra/core/workspace';\nimport type { SandboxEnvStore } from '../storage/domains/sandbox-envs/base.js';\n\nexport interface SandboxEnv {\n /** Variables every command in the sandbox gets. */\n runtime: Record<string, string>;\n /** Variables template builds and Factory-run setup commands get; never runtime commands. */\n build: Record<string, string>;\n /** Read before the values: an edit landing in between makes the next check reload. */\n revision: string;\n buildRevision: string;\n}\n\n/**\n * The single place a sandbox's environment is resolved. v1 reads only the\n * Factory-wide variables; personal and session layers merge in here later,\n * with session over personal over Factory, so callers never change.\n */\nexport async function resolveSandboxEnv(\n store: Pick<SandboxEnvStore, 'resolve'>,\n scope: { orgId: string; projectId: string },\n): Promise<SandboxEnv> {\n const { runtime, build, revision, buildRevision } = await store.resolve(scope.orgId, scope.projectId);\n return { runtime, build, revision, buildRevision };\n}\n\nfunction warnReadFailed(message: string, error: unknown) {\n console.warn(`[Mastra Factory] ${message}`, {\n // Storage and decryption errors name no values.\n error: error instanceof Error ? error.message : String(error),\n });\n}\n\n/**\n * `resolveSandboxEnv` for session boot and setup: a failed read (a storage\n * blip, a value encrypted with a removed key) is logged and yields no Factory\n * variables, so it can't stop a session from starting. Its empty revision\n * makes the first command's refresh try again.\n */\nexport async function resolveSandboxEnvOrEmpty(\n store: Pick<SandboxEnvStore, 'resolve'>,\n scope: { orgId: string; projectId: string },\n): Promise<SandboxEnv> {\n try {\n return await resolveSandboxEnv(store, scope);\n } catch (error) {\n warnReadFailed('Could not read sandbox environment variables; starting without them', error);\n return { runtime: {}, build: {}, revision: '', buildRevision: '' };\n }\n}\n\n/**\n * The template-build fields of a sandbox context. Omitted when the Factory has\n * no Build variables, so the template identity matches one built without them.\n * Session boot and environment builds share this, so both name the same template.\n */\nexport function sandboxBuildContext(\n env: SandboxEnv | undefined,\n): Pick<FactorySandboxContext, 'buildEnv' | 'buildEnvRevision'> {\n if (!env || Object.keys(env.build).length === 0) return {};\n return { buildEnv: env.build, buildEnvRevision: env.buildRevision };\n}\n\n/**\n * Replace every Build value that appears in provider or command output with\n * `***`. Each value is also matched without its edge whitespace, since output\n * often drops a pasted trailing space or newline. Longest first, so a value\n * that contains another is masked whole.\n */\nexport function maskSandboxEnvValues(text: string, env: Record<string, string> | undefined): string {\n if (!env) return text;\n const values = new Set(Object.values(env).flatMap(value => [value, value.trim()]));\n let masked = text;\n for (const value of [...values].sort((a, b) => b.length - a.length)) {\n if (value) masked = masked.replaceAll(value, '***');\n }\n return masked;\n}\n\ntype EnvOverlay = Record<string, string | undefined>;\n\nconst appliedBySandbox = new WeakMap<object, () => Record<string, string>>();\n\n/**\n * The Factory runtime values currently applied to a sandbox, so output from a\n * command that ran in it (a failed teardown) can be masked without a storage read.\n */\nexport function appliedSandboxEnv(sandbox: object): Record<string, string> {\n return appliedBySandbox.get(sandbox)?.() ?? {};\n}\n\nexport interface RefreshableSandbox {\n ensureRunning?: () => Promise<void>;\n setEnv?: (update: (env: EnvOverlay) => EnvOverlay) => void;\n}\n\n/**\n * Apply the Factory's runtime variables to a sandbox's env overlay and keep\n * them current: after every `ensureRunning()` (which every command path awaits\n * before reading the overlay) the Factory revision is checked, and on a change\n * the variables are reloaded and re-applied, so an add, edit or delete reaches\n * the next command. Processes already running keep the env they started with.\n *\n * A key the sandbox already had (its host `env`) is remembered before Factory\n * first writes it and restored when the Factory variable goes away. A refresh\n * that fails is logged and the command runs with the env last applied.\n */\nexport function attachSandboxEnvRefresh(\n sandbox: RefreshableSandbox,\n options: {\n initial: Pick<SandboxEnv, 'runtime' | 'revision'>;\n revision: () => Promise<string>;\n load: () => Promise<Pick<SandboxEnv, 'runtime' | 'revision'>>;\n onError?: (error: unknown) => void;\n },\n): void {\n const setEnv = sandbox.setEnv?.bind(sandbox);\n if (!setEnv) return;\n // Values the overlay held under a key before Factory first wrote it.\n const shadowed = new Map<string, string | undefined>();\n let applied: Record<string, string> = {};\n let appliedRevision = options.initial.revision;\n\n const apply = (next: Record<string, string>) => {\n setEnv(env => {\n const out = { ...env };\n for (const key of Object.keys(applied)) {\n if (Object.hasOwn(next, key)) continue;\n const previous = shadowed.get(key);\n shadowed.delete(key);\n if (previous === undefined) delete out[key];\n else out[key] = previous;\n }\n for (const [key, value] of Object.entries(next)) {\n if (!Object.hasOwn(applied, key)) shadowed.set(key, env[key]);\n out[key] = value;\n }\n return out;\n });\n applied = { ...next };\n };\n apply(options.initial.runtime);\n appliedBySandbox.set(sandbox, () => applied);\n\n const original = sandbox.ensureRunning?.bind(sandbox);\n if (!original) return;\n let inFlight: Promise<void> | undefined;\n // Never calls ensureRunning itself, so a command inside `onStart` can't wait on its own start.\n const refresh = async () => {\n if ((await options.revision()) === appliedRevision) return;\n const next = await options.load();\n apply(next.runtime);\n appliedRevision = next.revision;\n };\n sandbox.ensureRunning = async () => {\n await original();\n inFlight ??= refresh()\n .catch(error => {\n if (options.onError) options.onError(error);\n else warnReadFailed('Could not refresh sandbox environment variables; using the last applied', error);\n })\n .finally(() => {\n inFlight = undefined;\n });\n await inFlight;\n };\n}\n"],"mappings":"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"}
|
|
@@ -15,6 +15,27 @@ export interface FactorySecretEncryptionConfig {
|
|
|
15
15
|
primary: FactorySecretEncryptionKey;
|
|
16
16
|
previous?: FactorySecretEncryptionKey[];
|
|
17
17
|
}
|
|
18
|
+
/** A stored secret can't be read with the keys this instance was configured with. */
|
|
19
|
+
export declare class FactorySecretDecryptionError extends Error {
|
|
20
|
+
/** True when this instance has no key at all, rather than the wrong one. */
|
|
21
|
+
readonly missingKey: boolean;
|
|
22
|
+
name: string;
|
|
23
|
+
constructor(message: string,
|
|
24
|
+
/** True when this instance has no key at all, rather than the wrong one. */
|
|
25
|
+
missingKey?: boolean);
|
|
26
|
+
}
|
|
27
|
+
/**
|
|
28
|
+
* Client-safe copy for a storage failure caused by an encryption key problem,
|
|
29
|
+
* or `undefined` for any other failure (whose message may expose database
|
|
30
|
+
* internals and stays in the server log). `fix` marks env var names with backticks.
|
|
31
|
+
*/
|
|
32
|
+
export declare function secretKeyProblem(error: unknown): {
|
|
33
|
+
title: string;
|
|
34
|
+
message: string;
|
|
35
|
+
fix: string;
|
|
36
|
+
} | undefined;
|
|
37
|
+
/** {@link secretKeyProblem} as one plain sentence, for API error messages. */
|
|
38
|
+
export declare function secretKeyMismatchHint(error: unknown): string | undefined;
|
|
18
39
|
/**
|
|
19
40
|
* Creates a versioned AES-256-GCM encryptor. The primary key is used for new
|
|
20
41
|
* writes; previous keys remain decrypt-only until stored values are rotated.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"secret-encryption.d.ts","sourceRoot":"","sources":["../src/secret-encryption.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC,KAAK,EAAE,CAAC,CAAC;IACT,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,kFAAkF;AAClF,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,UAAU,CAAC;CACjB;AAED,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,0BAA0B,CAAC;IACpC,QAAQ,CAAC,EAAE,0BAA0B,EAAE,CAAC;CACzC;
|
|
1
|
+
{"version":3,"file":"secret-encryption.d.ts","sourceRoot":"","sources":["../src/secret-encryption.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC,KAAK,EAAE,CAAC,CAAC;IACT,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,kFAAkF;AAClF,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,UAAU,CAAC;CACjB;AAED,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,0BAA0B,CAAC;IACpC,QAAQ,CAAC,EAAE,0BAA0B,EAAE,CAAC;CACzC;AAWD,qFAAqF;AACrF,qBAAa,4BAA6B,SAAQ,KAAK;IAKnD,4EAA4E;IAC5E,QAAQ,CAAC,UAAU;IALZ,IAAI,SAAkC;IAE/C,YACE,OAAO,EAAE,MAAM;IACf,4EAA4E;IACnE,UAAU,UAAQ,EAG5B;CACF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAS5G;AAED,8EAA8E;AAC9E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAGxE;AAuBD;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,6BAA6B,GAAG,uBAAuB,CA+E5G;AAED,+EAA+E;AAC/E,wBAAgB,sCAAsC,IAAI,uBAAuB,CAgChF"}
|
|
@@ -10,6 +10,33 @@ function validateKey({ id, key }) {
|
|
|
10
10
|
if (buffer.byteLength !== 32) throw new Error(`[FactorySecretEncryption] Key "${id}" must be exactly 32 bytes.`);
|
|
11
11
|
return buffer;
|
|
12
12
|
}
|
|
13
|
+
/** A stored secret can't be read with the keys this instance was configured with. */
|
|
14
|
+
var FactorySecretDecryptionError = class extends Error {
|
|
15
|
+
missingKey;
|
|
16
|
+
name = "FactorySecretDecryptionError";
|
|
17
|
+
constructor(message, missingKey = false) {
|
|
18
|
+
super(message);
|
|
19
|
+
this.missingKey = missingKey;
|
|
20
|
+
}
|
|
21
|
+
};
|
|
22
|
+
/**
|
|
23
|
+
* Client-safe copy for a storage failure caused by an encryption key problem,
|
|
24
|
+
* or `undefined` for any other failure (whose message may expose database
|
|
25
|
+
* internals and stays in the server log). `fix` marks env var names with backticks.
|
|
26
|
+
*/
|
|
27
|
+
function secretKeyProblem(error) {
|
|
28
|
+
if (!(error instanceof FactorySecretDecryptionError)) return void 0;
|
|
29
|
+
return {
|
|
30
|
+
title: "Factory needs its encryption key",
|
|
31
|
+
message: error.missingKey ? "This deployment doesn't have one set." : "This deployment is using a different one than before.",
|
|
32
|
+
fix: "Set `FACTORY_CREDENTIAL_ENCRYPTION_KEY` and redeploy."
|
|
33
|
+
};
|
|
34
|
+
}
|
|
35
|
+
/** {@link secretKeyProblem} as one plain sentence, for API error messages. */
|
|
36
|
+
function secretKeyMismatchHint(error) {
|
|
37
|
+
const problem = secretKeyProblem(error);
|
|
38
|
+
return problem && `${problem.title}. ${problem.message} ${problem.fix.replaceAll("`", "")}`;
|
|
39
|
+
}
|
|
13
40
|
function parseEnvelope(value) {
|
|
14
41
|
let parsed;
|
|
15
42
|
try {
|
|
@@ -68,7 +95,7 @@ function createFactorySecretEncryption(config) {
|
|
|
68
95
|
}
|
|
69
96
|
const envelope = parseEnvelope(value);
|
|
70
97
|
const key = keys.get(envelope.keyId);
|
|
71
|
-
if (!key) throw new
|
|
98
|
+
if (!key) throw new FactorySecretDecryptionError(`[FactorySecretEncryption] Unknown key id "${envelope.keyId}".`);
|
|
72
99
|
let decoded;
|
|
73
100
|
try {
|
|
74
101
|
const decipher = createDecipheriv(ALGORITHM, key, Buffer.from(envelope.iv, "base64url"));
|
|
@@ -76,7 +103,7 @@ function createFactorySecretEncryption(config) {
|
|
|
76
103
|
const plaintext = Buffer.concat([decipher.update(Buffer.from(envelope.ciphertext, "base64url")), decipher.final()]).toString("utf8");
|
|
77
104
|
decoded = JSON.parse(plaintext);
|
|
78
105
|
} catch {
|
|
79
|
-
throw new
|
|
106
|
+
throw new FactorySecretDecryptionError("[FactorySecretEncryption] Unable to decrypt encrypted value.");
|
|
80
107
|
}
|
|
81
108
|
const nested = await unwrapNestedEnvelope(decoded, depth);
|
|
82
109
|
if (nested !== void 0) return {
|
|
@@ -125,7 +152,7 @@ function createPlaintextFactorySecretEncryption() {
|
|
|
125
152
|
needsReencryption: true
|
|
126
153
|
};
|
|
127
154
|
}
|
|
128
|
-
throw new
|
|
155
|
+
throw new FactorySecretDecryptionError("[FactorySecretEncryption] Value is encrypted, but this instance has no secret encryption key configured. Configure 'secretEncryption' with the same key on every Factory instance.", true);
|
|
129
156
|
}
|
|
130
157
|
try {
|
|
131
158
|
return {
|
|
@@ -141,6 +168,6 @@ function createPlaintextFactorySecretEncryption() {
|
|
|
141
168
|
}
|
|
142
169
|
};
|
|
143
170
|
}
|
|
144
|
-
export { createFactorySecretEncryption, createPlaintextFactorySecretEncryption };
|
|
171
|
+
export { FactorySecretDecryptionError, createFactorySecretEncryption, createPlaintextFactorySecretEncryption, secretKeyMismatchHint, secretKeyProblem };
|
|
145
172
|
|
|
146
173
|
//# sourceMappingURL=secret-encryption.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"secret-encryption.js","names":[],"sources":["../src/secret-encryption.ts"],"sourcesContent":["import { createCipheriv, createDecipheriv } from 'node:crypto';\n\nconst ENVELOPE_PREFIX = 'mastra:factory-secret:v1:';\nconst ALGORITHM = 'aes-256-gcm';\nconst IV_BYTES = 12;\nconst MAX_NESTED_ENVELOPES = 4;\n\ninterface SecretEnvelopeV1 {\n keyId: string;\n iv: string;\n ciphertext: string;\n tag: string;\n}\n\nexport interface DecryptedFactorySecret<T> {\n value: T;\n needsReencryption: boolean;\n}\n\n/** Encrypts opaque JSON values before they cross the Factory storage boundary. */\nexport interface FactorySecretEncryption {\n encrypt<T>(value: T): Promise<string>;\n decrypt<T>(value: unknown): Promise<DecryptedFactorySecret<T>>;\n}\n\nexport interface FactorySecretEncryptionKey {\n id: string;\n key: Uint8Array;\n}\n\nexport interface FactorySecretEncryptionConfig {\n primary: FactorySecretEncryptionKey;\n previous?: FactorySecretEncryptionKey[];\n}\n\nfunction validateKey({ id, key }: FactorySecretEncryptionKey): Buffer {\n if (!id) throw new Error('[FactorySecretEncryption] Key id is required.');\n const buffer = Buffer.from(key);\n if (buffer.byteLength !== 32) {\n throw new Error(`[FactorySecretEncryption] Key \"${id}\" must be exactly 32 bytes.`);\n }\n return buffer;\n}\n\nfunction parseEnvelope(value: string): SecretEnvelopeV1 {\n let parsed: unknown;\n try {\n parsed = JSON.parse(Buffer.from(value.slice(ENVELOPE_PREFIX.length), 'base64url').toString('utf8'));\n } catch {\n throw new Error('[FactorySecretEncryption] Invalid encrypted value.');\n }\n\n if (\n !parsed ||\n typeof parsed !== 'object' ||\n typeof (parsed as SecretEnvelopeV1).keyId !== 'string' ||\n typeof (parsed as SecretEnvelopeV1).iv !== 'string' ||\n typeof (parsed as SecretEnvelopeV1).ciphertext !== 'string' ||\n typeof (parsed as SecretEnvelopeV1).tag !== 'string'\n ) {\n throw new Error('[FactorySecretEncryption] Invalid encrypted value.');\n }\n return parsed as SecretEnvelopeV1;\n}\n\n/**\n * Creates a versioned AES-256-GCM encryptor. The primary key is used for new\n * writes; previous keys remain decrypt-only until stored values are rotated.\n */\nexport function createFactorySecretEncryption(config: FactorySecretEncryptionConfig): FactorySecretEncryption {\n const primaryKey = validateKey(config.primary);\n const keys = new Map<string, Buffer>([[config.primary.id, primaryKey]]);\n for (const previous of config.previous ?? []) {\n if (keys.has(previous.id)) throw new Error(`[FactorySecretEncryption] Duplicate key id \"${previous.id}\".`);\n keys.set(previous.id, validateKey(previous));\n }\n\n return {\n async encrypt<T>(value: T): Promise<string> {\n const iv = Buffer.from(globalThis.crypto.getRandomValues(new Uint8Array(IV_BYTES)));\n const cipher = createCipheriv(ALGORITHM, primaryKey, iv);\n const ciphertext = Buffer.concat([cipher.update(JSON.stringify(value), 'utf8'), cipher.final()]);\n const envelope: SecretEnvelopeV1 = {\n keyId: config.primary.id,\n iv: iv.toString('base64url'),\n ciphertext: ciphertext.toString('base64url'),\n tag: cipher.getAuthTag().toString('base64url'),\n };\n return `${ENVELOPE_PREFIX}${Buffer.from(JSON.stringify(envelope), 'utf8').toString('base64url')}`;\n },\n\n decrypt,\n };\n\n async function decrypt<T>(value: unknown, depth = 0): Promise<DecryptedFactorySecret<T>> {\n if (typeof value !== 'string') {\n return { value: structuredClone(value) as T, needsReencryption: true };\n }\n if (!value.startsWith(ENVELOPE_PREFIX)) {\n // JSON text written by the plaintext encryptor, or a raw pre-encryption\n // secret string. Decode it the same way the plaintext encryptor does so\n // migration encrypts the original value, not its JSON text.\n let parsed: unknown;\n try {\n parsed = JSON.parse(value);\n } catch {\n return { value: value as T, needsReencryption: true };\n }\n return { value: (await unwrapNestedEnvelope<T>(parsed, depth)) ?? (parsed as T), needsReencryption: true };\n }\n\n const envelope = parseEnvelope(value);\n const key = keys.get(envelope.keyId);\n if (!key) throw new Error(`[FactorySecretEncryption] Unknown key id \"${envelope.keyId}\".`);\n\n let decoded: unknown;\n try {\n const decipher = createDecipheriv(ALGORITHM, key, Buffer.from(envelope.iv, 'base64url'));\n decipher.setAuthTag(Buffer.from(envelope.tag, 'base64url'));\n const plaintext = Buffer.concat([\n decipher.update(Buffer.from(envelope.ciphertext, 'base64url')),\n decipher.final(),\n ]).toString('utf8');\n decoded = JSON.parse(plaintext);\n } catch {\n throw new Error('[FactorySecretEncryption] Unable to decrypt encrypted value.');\n }\n const nested = await unwrapNestedEnvelope<T>(decoded, depth);\n if (nested !== undefined) return { value: nested, needsReencryption: true };\n return { value: decoded as T, needsReencryption: envelope.keyId !== config.primary.id };\n }\n\n /**\n * Older plaintext encryptors treated an envelope as a raw legacy secret and\n * rewrote it as JSON text, which a keyed boot then re-encrypted. Peel those\n * layers back to the real value so the row is repaired on the next write.\n * A user-supplied secret can also look like an envelope, so anything that\n * does not decrypt with our keys is kept as the literal value.\n */\n async function unwrapNestedEnvelope<T>(value: unknown, depth: number): Promise<T | undefined> {\n if (typeof value !== 'string' || !value.startsWith(ENVELOPE_PREFIX)) return undefined;\n if (depth >= MAX_NESTED_ENVELOPES) return undefined;\n try {\n return (await decrypt<T>(value, depth + 1)).value;\n } catch {\n return undefined;\n }\n }\n}\n\n/** Explicit plaintext compatibility for local, no-auth Factory development. */\nexport function createPlaintextFactorySecretEncryption(): FactorySecretEncryption {\n return {\n async encrypt<T>(value: T): Promise<string> {\n return JSON.stringify(value);\n },\n async decrypt<T>(value: unknown): Promise<DecryptedFactorySecret<T>> {\n if (typeof value !== 'string') return { value: structuredClone(value) as T, needsReencryption: false };\n if (value.startsWith(ENVELOPE_PREFIX)) {\n // Never hand an envelope back as the secret, and never let migration\n // rewrite it as plaintext JSON: that corrupts the row for keyed instances.\n // A raw legacy secret can merely start with the prefix; keep those as-is.\n try {\n parseEnvelope(value);\n } catch {\n return { value: value as T, needsReencryption: true };\n }\n throw new Error(\n '[FactorySecretEncryption] Value is encrypted, but this instance has no secret encryption key configured. ' +\n \"Configure 'secretEncryption' with the same key on every Factory instance.\",\n );\n }\n try {\n return { value: JSON.parse(value) as T, needsReencryption: false };\n } catch {\n // Pre-encryption rows stored raw secret strings (e.g. a bare\n // `custom_providers.api_key`), not JSON. Treat the raw string as the\n // value and flag it so migration rewrites it in the current format.\n return { value: value as T, needsReencryption: true };\n }\n },\n };\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"secret-encryption.js","names":[],"sources":["../src/secret-encryption.ts"],"sourcesContent":["import { createCipheriv, createDecipheriv } from 'node:crypto';\n\nconst ENVELOPE_PREFIX = 'mastra:factory-secret:v1:';\nconst ALGORITHM = 'aes-256-gcm';\nconst IV_BYTES = 12;\nconst MAX_NESTED_ENVELOPES = 4;\n\ninterface SecretEnvelopeV1 {\n keyId: string;\n iv: string;\n ciphertext: string;\n tag: string;\n}\n\nexport interface DecryptedFactorySecret<T> {\n value: T;\n needsReencryption: boolean;\n}\n\n/** Encrypts opaque JSON values before they cross the Factory storage boundary. */\nexport interface FactorySecretEncryption {\n encrypt<T>(value: T): Promise<string>;\n decrypt<T>(value: unknown): Promise<DecryptedFactorySecret<T>>;\n}\n\nexport interface FactorySecretEncryptionKey {\n id: string;\n key: Uint8Array;\n}\n\nexport interface FactorySecretEncryptionConfig {\n primary: FactorySecretEncryptionKey;\n previous?: FactorySecretEncryptionKey[];\n}\n\nfunction validateKey({ id, key }: FactorySecretEncryptionKey): Buffer {\n if (!id) throw new Error('[FactorySecretEncryption] Key id is required.');\n const buffer = Buffer.from(key);\n if (buffer.byteLength !== 32) {\n throw new Error(`[FactorySecretEncryption] Key \"${id}\" must be exactly 32 bytes.`);\n }\n return buffer;\n}\n\n/** A stored secret can't be read with the keys this instance was configured with. */\nexport class FactorySecretDecryptionError extends Error {\n override name = 'FactorySecretDecryptionError';\n\n constructor(\n message: string,\n /** True when this instance has no key at all, rather than the wrong one. */\n readonly missingKey = false,\n ) {\n super(message);\n }\n}\n\n/**\n * Client-safe copy for a storage failure caused by an encryption key problem,\n * or `undefined` for any other failure (whose message may expose database\n * internals and stays in the server log). `fix` marks env var names with backticks.\n */\nexport function secretKeyProblem(error: unknown): { title: string; message: string; fix: string } | undefined {\n if (!(error instanceof FactorySecretDecryptionError)) return undefined;\n return {\n title: 'Factory needs its encryption key',\n message: error.missingKey\n ? \"This deployment doesn't have one set.\"\n : 'This deployment is using a different one than before.',\n fix: 'Set `FACTORY_CREDENTIAL_ENCRYPTION_KEY` and redeploy.',\n };\n}\n\n/** {@link secretKeyProblem} as one plain sentence, for API error messages. */\nexport function secretKeyMismatchHint(error: unknown): string | undefined {\n const problem = secretKeyProblem(error);\n return problem && `${problem.title}. ${problem.message} ${problem.fix.replaceAll('`', '')}`;\n}\n\nfunction parseEnvelope(value: string): SecretEnvelopeV1 {\n let parsed: unknown;\n try {\n parsed = JSON.parse(Buffer.from(value.slice(ENVELOPE_PREFIX.length), 'base64url').toString('utf8'));\n } catch {\n throw new Error('[FactorySecretEncryption] Invalid encrypted value.');\n }\n\n if (\n !parsed ||\n typeof parsed !== 'object' ||\n typeof (parsed as SecretEnvelopeV1).keyId !== 'string' ||\n typeof (parsed as SecretEnvelopeV1).iv !== 'string' ||\n typeof (parsed as SecretEnvelopeV1).ciphertext !== 'string' ||\n typeof (parsed as SecretEnvelopeV1).tag !== 'string'\n ) {\n throw new Error('[FactorySecretEncryption] Invalid encrypted value.');\n }\n return parsed as SecretEnvelopeV1;\n}\n\n/**\n * Creates a versioned AES-256-GCM encryptor. The primary key is used for new\n * writes; previous keys remain decrypt-only until stored values are rotated.\n */\nexport function createFactorySecretEncryption(config: FactorySecretEncryptionConfig): FactorySecretEncryption {\n const primaryKey = validateKey(config.primary);\n const keys = new Map<string, Buffer>([[config.primary.id, primaryKey]]);\n for (const previous of config.previous ?? []) {\n if (keys.has(previous.id)) throw new Error(`[FactorySecretEncryption] Duplicate key id \"${previous.id}\".`);\n keys.set(previous.id, validateKey(previous));\n }\n\n return {\n async encrypt<T>(value: T): Promise<string> {\n const iv = Buffer.from(globalThis.crypto.getRandomValues(new Uint8Array(IV_BYTES)));\n const cipher = createCipheriv(ALGORITHM, primaryKey, iv);\n const ciphertext = Buffer.concat([cipher.update(JSON.stringify(value), 'utf8'), cipher.final()]);\n const envelope: SecretEnvelopeV1 = {\n keyId: config.primary.id,\n iv: iv.toString('base64url'),\n ciphertext: ciphertext.toString('base64url'),\n tag: cipher.getAuthTag().toString('base64url'),\n };\n return `${ENVELOPE_PREFIX}${Buffer.from(JSON.stringify(envelope), 'utf8').toString('base64url')}`;\n },\n\n decrypt,\n };\n\n async function decrypt<T>(value: unknown, depth = 0): Promise<DecryptedFactorySecret<T>> {\n if (typeof value !== 'string') {\n return { value: structuredClone(value) as T, needsReencryption: true };\n }\n if (!value.startsWith(ENVELOPE_PREFIX)) {\n // JSON text written by the plaintext encryptor, or a raw pre-encryption\n // secret string. Decode it the same way the plaintext encryptor does so\n // migration encrypts the original value, not its JSON text.\n let parsed: unknown;\n try {\n parsed = JSON.parse(value);\n } catch {\n return { value: value as T, needsReencryption: true };\n }\n return { value: (await unwrapNestedEnvelope<T>(parsed, depth)) ?? (parsed as T), needsReencryption: true };\n }\n\n const envelope = parseEnvelope(value);\n const key = keys.get(envelope.keyId);\n if (!key) throw new FactorySecretDecryptionError(`[FactorySecretEncryption] Unknown key id \"${envelope.keyId}\".`);\n\n let decoded: unknown;\n try {\n const decipher = createDecipheriv(ALGORITHM, key, Buffer.from(envelope.iv, 'base64url'));\n decipher.setAuthTag(Buffer.from(envelope.tag, 'base64url'));\n const plaintext = Buffer.concat([\n decipher.update(Buffer.from(envelope.ciphertext, 'base64url')),\n decipher.final(),\n ]).toString('utf8');\n decoded = JSON.parse(plaintext);\n } catch {\n throw new FactorySecretDecryptionError('[FactorySecretEncryption] Unable to decrypt encrypted value.');\n }\n const nested = await unwrapNestedEnvelope<T>(decoded, depth);\n if (nested !== undefined) return { value: nested, needsReencryption: true };\n return { value: decoded as T, needsReencryption: envelope.keyId !== config.primary.id };\n }\n\n /**\n * Older plaintext encryptors treated an envelope as a raw legacy secret and\n * rewrote it as JSON text, which a keyed boot then re-encrypted. Peel those\n * layers back to the real value so the row is repaired on the next write.\n * A user-supplied secret can also look like an envelope, so anything that\n * does not decrypt with our keys is kept as the literal value.\n */\n async function unwrapNestedEnvelope<T>(value: unknown, depth: number): Promise<T | undefined> {\n if (typeof value !== 'string' || !value.startsWith(ENVELOPE_PREFIX)) return undefined;\n if (depth >= MAX_NESTED_ENVELOPES) return undefined;\n try {\n return (await decrypt<T>(value, depth + 1)).value;\n } catch {\n return undefined;\n }\n }\n}\n\n/** Explicit plaintext compatibility for local, no-auth Factory development. */\nexport function createPlaintextFactorySecretEncryption(): FactorySecretEncryption {\n return {\n async encrypt<T>(value: T): Promise<string> {\n return JSON.stringify(value);\n },\n async decrypt<T>(value: unknown): Promise<DecryptedFactorySecret<T>> {\n if (typeof value !== 'string') return { value: structuredClone(value) as T, needsReencryption: false };\n if (value.startsWith(ENVELOPE_PREFIX)) {\n // Never hand an envelope back as the secret, and never let migration\n // rewrite it as plaintext JSON: that corrupts the row for keyed instances.\n // A raw legacy secret can merely start with the prefix; keep those as-is.\n try {\n parseEnvelope(value);\n } catch {\n return { value: value as T, needsReencryption: true };\n }\n throw new FactorySecretDecryptionError(\n '[FactorySecretEncryption] Value is encrypted, but this instance has no secret encryption key configured. ' +\n \"Configure 'secretEncryption' with the same key on every Factory instance.\",\n true,\n );\n }\n try {\n return { value: JSON.parse(value) as T, needsReencryption: false };\n } catch {\n // Pre-encryption rows stored raw secret strings (e.g. a bare\n // `custom_providers.api_key`), not JSON. Treat the raw string as the\n // value and flag it so migration rewrites it in the current format.\n return { value: value as T, needsReencryption: true };\n }\n },\n };\n}\n"],"mappings":"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"}
|
|
@@ -2,12 +2,12 @@ import type { CredentialTenant } from '@mastra/code-sdk/agents/credential-resolv
|
|
|
2
2
|
import type { RequestContext } from '@mastra/core/request-context';
|
|
3
3
|
import type { ModelDefaultRecord, ModelDefaultsStorage } from '../storage/domains/model-defaults/base.js';
|
|
4
4
|
import type { FactoryProjectsStorage } from '../storage/domains/projects/base.js';
|
|
5
|
-
import type { WorkItemsStorage } from '../storage/domains/work-items/base.js';
|
|
6
5
|
import type { SourceControlSessionLookup } from './factory-session.js';
|
|
6
|
+
import type { ThreadRunBindings } from './session-threads.js';
|
|
7
7
|
export interface FactoryModelPolicyDependencies {
|
|
8
8
|
projects: Pick<FactoryProjectsStorage, 'getById'>;
|
|
9
9
|
sourceControl: Pick<SourceControlSessionLookup, 'getBySessionId'>;
|
|
10
|
-
workItems:
|
|
10
|
+
workItems: ThreadRunBindings;
|
|
11
11
|
}
|
|
12
12
|
/** Resolve billing authority from authenticated identity and durable bindings, never session state. */
|
|
13
13
|
export declare function resolveFactoryCredentialTenant(requestContext: RequestContext, deps: FactoryModelPolicyDependencies): Promise<CredentialTenant | undefined>;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"credential-policy.d.ts","sourceRoot":"","sources":["../../src/session/credential-policy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AAEpF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAInE,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAE1G,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,EAAE,
|
|
1
|
+
{"version":3,"file":"credential-policy.d.ts","sourceRoot":"","sources":["../../src/session/credential-policy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AAEpF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAInE,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAE1G,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAEvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAI9D,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,EAAE,IAAI,CAAC,sBAAsB,EAAE,SAAS,CAAC,CAAC;IAClD,aAAa,EAAE,IAAI,CAAC,0BAA0B,EAAE,gBAAgB,CAAC,CAAC;IAClE,SAAS,EAAE,iBAAiB,CAAC;CAC9B;AAED,uGAAuG;AACvG,wBAAsB,8BAA8B,CAClD,cAAc,EAAE,cAAc,EAC9B,IAAI,EAAE,8BAA8B,GACnC,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAEvC;AAED,+FAA+F;AAC/F,wBAAsB,yBAAyB,CAC7C,cAAc,EAAE,cAAc,EAC9B,IAAI,EAAE,8BAA8B,GACnC,OAAO,CAAC;IAAE,MAAM,EAAE,gBAAgB,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,SAAS,CAAC,CAsDrH;AAED,gFAAgF;AAChF,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,gBAAgB,EACxB,aAAa,EAAE,IAAI,CAAC,oBAAoB,EAAE,aAAa,GAAG,KAAK,CAAC,GAC/D,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAIpC"}
|