@mastra/factory 0.28.0 → 0.29.0-alpha.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +26 -8
- package/dist/board-changes.d.ts +16 -0
- package/dist/board-changes.d.ts.map +1 -0
- package/dist/board-changes.js +40 -0
- package/dist/board-changes.js.map +1 -0
- package/dist/boards/index.js +2 -1
- package/dist/boards/reroute.d.ts +31 -0
- package/dist/boards/reroute.d.ts.map +1 -0
- package/dist/boards/reroute.js +71 -0
- package/dist/boards/reroute.js.map +1 -0
- package/dist/boards/semantics.d.ts +1 -3
- package/dist/boards/semantics.d.ts.map +1 -1
- package/dist/boards/semantics.js +1 -5
- package/dist/boards/semantics.js.map +1 -1
- package/dist/environment/repository-access.d.ts +2 -0
- package/dist/environment/repository-access.d.ts.map +1 -1
- package/dist/environment/repository-access.js +9 -4
- package/dist/environment/repository-access.js.map +1 -1
- package/dist/factory.d.ts +4 -0
- package/dist/factory.d.ts.map +1 -1
- package/dist/factory.js +60 -9
- package/dist/factory.js.map +1 -1
- package/dist/integrations/base.d.ts +17 -0
- package/dist/integrations/base.d.ts.map +1 -1
- package/dist/integrations/dependabot/default-rules.d.ts +38 -0
- package/dist/integrations/dependabot/default-rules.d.ts.map +1 -0
- package/dist/integrations/dependabot/default-rules.js +63 -0
- package/dist/integrations/dependabot/default-rules.js.map +1 -0
- package/dist/integrations/dependabot/rules.d.ts +42 -0
- package/dist/integrations/dependabot/rules.d.ts.map +1 -0
- package/dist/integrations/dependabot/rules.js +187 -0
- package/dist/integrations/dependabot/rules.js.map +1 -0
- package/dist/integrations/dependabot/sync.d.ts +76 -0
- package/dist/integrations/dependabot/sync.d.ts.map +1 -0
- package/dist/integrations/dependabot/sync.js +111 -0
- package/dist/integrations/dependabot/sync.js.map +1 -0
- package/dist/integrations/github/pull-request-source.js +2 -1
- package/dist/integrations/github/pull-request-source.js.map +1 -1
- package/dist/integrations/github/reconcile-worker.js +1 -1
- package/dist/integrations/github/reconcile-worker.js.map +1 -1
- package/dist/integrations/github/routes.d.ts.map +1 -1
- package/dist/integrations/github/routes.js +7 -2
- package/dist/integrations/github/routes.js.map +1 -1
- package/dist/integrations/github/rules.d.ts +5 -2
- package/dist/integrations/github/rules.d.ts.map +1 -1
- package/dist/integrations/github/rules.js +16 -13
- package/dist/integrations/github/rules.js.map +1 -1
- package/dist/integrations/github/sandbox.d.ts +12 -0
- package/dist/integrations/github/sandbox.d.ts.map +1 -1
- package/dist/integrations/github/sandbox.js +24 -3
- package/dist/integrations/github/sandbox.js.map +1 -1
- package/dist/integrations/gitlab/default-rules.js +2 -1
- package/dist/integrations/gitlab/default-rules.js.map +1 -1
- package/dist/integrations/gitlab/discovery.d.ts +16 -0
- package/dist/integrations/gitlab/discovery.d.ts.map +1 -0
- package/dist/integrations/gitlab/discovery.js +107 -0
- package/dist/integrations/gitlab/discovery.js.map +1 -0
- package/dist/integrations/gitlab/integration.d.ts.map +1 -1
- package/dist/integrations/gitlab/integration.js +1 -2
- package/dist/integrations/gitlab/integration.js.map +1 -1
- package/dist/integrations/gitlab/issue-reconciler.d.ts.map +1 -1
- package/dist/integrations/gitlab/issue-reconciler.js +1 -0
- 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 +26 -10
- package/dist/integrations/gitlab/merge-request-reconciler.js.map +1 -1
- package/dist/integrations/gitlab/reconciler.d.ts.map +1 -1
- package/dist/integrations/gitlab/reconciler.js +4 -2
- package/dist/integrations/gitlab/reconciler.js.map +1 -1
- package/dist/integrations/gitlab/reconciliation-config.d.ts +0 -1
- package/dist/integrations/gitlab/reconciliation-config.d.ts.map +1 -1
- package/dist/integrations/gitlab/reconciliation-config.js +2 -8
- package/dist/integrations/gitlab/reconciliation-config.js.map +1 -1
- package/dist/integrations/gitlab/routes.d.ts +17 -0
- package/dist/integrations/gitlab/routes.d.ts.map +1 -1
- package/dist/integrations/gitlab/routes.js +28 -22
- package/dist/integrations/gitlab/routes.js.map +1 -1
- package/dist/integrations/gitlab/rules.d.ts +10 -4
- package/dist/integrations/gitlab/rules.d.ts.map +1 -1
- package/dist/integrations/gitlab/rules.js +32 -8
- package/dist/integrations/gitlab/rules.js.map +1 -1
- package/dist/integrations/incidentio/integration.d.ts +2 -1
- package/dist/integrations/incidentio/integration.d.ts.map +1 -1
- package/dist/integrations/incidentio/integration.js +7 -7
- package/dist/integrations/incidentio/integration.js.map +1 -1
- package/dist/integrations/incidentio/issue-reconciler.d.ts +7 -0
- package/dist/integrations/incidentio/issue-reconciler.d.ts.map +1 -1
- package/dist/integrations/incidentio/issue-reconciler.js +36 -1
- package/dist/integrations/incidentio/issue-reconciler.js.map +1 -1
- package/dist/integrations/incidentio/reconciliation-config.d.ts +0 -1
- package/dist/integrations/incidentio/reconciliation-config.d.ts.map +1 -1
- package/dist/integrations/incidentio/reconciliation-config.js +2 -5
- package/dist/integrations/incidentio/reconciliation-config.js.map +1 -1
- package/dist/integrations/incidentio/routes.d.ts +24 -8
- package/dist/integrations/incidentio/routes.d.ts.map +1 -1
- package/dist/integrations/incidentio/routes.js +33 -35
- package/dist/integrations/incidentio/routes.js.map +1 -1
- package/dist/integrations/incidentio/rules.d.ts +0 -4
- package/dist/integrations/incidentio/rules.d.ts.map +1 -1
- package/dist/integrations/incidentio/rules.js +17 -14
- package/dist/integrations/incidentio/rules.js.map +1 -1
- package/dist/integrations/intake-discovery.d.ts +44 -0
- package/dist/integrations/intake-discovery.d.ts.map +1 -0
- package/dist/integrations/intake-discovery.js +60 -0
- package/dist/integrations/intake-discovery.js.map +1 -0
- package/dist/integrations/issue-reconcile-worker.js +1 -1
- package/dist/integrations/issue-reconcile-worker.js.map +1 -1
- package/dist/integrations/issue-reconciler.d.ts +7 -0
- package/dist/integrations/issue-reconciler.d.ts.map +1 -1
- package/dist/integrations/issue-reconciler.js +47 -12
- package/dist/integrations/issue-reconciler.js.map +1 -1
- package/dist/integrations/jira/integration.d.ts +3 -2
- package/dist/integrations/jira/integration.d.ts.map +1 -1
- package/dist/integrations/jira/integration.js +5 -7
- package/dist/integrations/jira/integration.js.map +1 -1
- package/dist/integrations/jira/issue-reconciler.d.ts +17 -1
- package/dist/integrations/jira/issue-reconciler.d.ts.map +1 -1
- package/dist/integrations/jira/issue-reconciler.js +34 -1
- package/dist/integrations/jira/issue-reconciler.js.map +1 -1
- package/dist/integrations/jira/reconciliation-config.d.ts +0 -1
- package/dist/integrations/jira/reconciliation-config.d.ts.map +1 -1
- package/dist/integrations/jira/reconciliation-config.js +2 -5
- package/dist/integrations/jira/reconciliation-config.js.map +1 -1
- package/dist/integrations/jira/routes.d.ts +0 -7
- package/dist/integrations/jira/routes.d.ts.map +1 -1
- package/dist/integrations/jira/routes.js +2 -12
- package/dist/integrations/jira/routes.js.map +1 -1
- package/dist/integrations/jira/rules.d.ts +0 -4
- package/dist/integrations/jira/rules.d.ts.map +1 -1
- package/dist/integrations/jira/rules.js +3 -13
- package/dist/integrations/jira/rules.js.map +1 -1
- package/dist/integrations/kept-cards.d.ts +49 -0
- package/dist/integrations/kept-cards.d.ts.map +1 -0
- package/dist/integrations/kept-cards.js +97 -0
- package/dist/integrations/kept-cards.js.map +1 -0
- package/dist/integrations/linear/intake-discovery.d.ts +34 -0
- package/dist/integrations/linear/intake-discovery.d.ts.map +1 -0
- package/dist/integrations/linear/intake-discovery.js +112 -0
- package/dist/integrations/linear/intake-discovery.js.map +1 -0
- package/dist/integrations/linear/integration.d.ts.map +1 -1
- package/dist/integrations/linear/integration.js +1 -4
- package/dist/integrations/linear/integration.js.map +1 -1
- package/dist/integrations/linear/issue-reconciler.d.ts +13 -4
- package/dist/integrations/linear/issue-reconciler.d.ts.map +1 -1
- package/dist/integrations/linear/issue-reconciler.js +24 -20
- package/dist/integrations/linear/issue-reconciler.js.map +1 -1
- package/dist/integrations/linear/reconciliation-config.d.ts +0 -1
- package/dist/integrations/linear/reconciliation-config.d.ts.map +1 -1
- package/dist/integrations/linear/reconciliation-config.js +2 -8
- package/dist/integrations/linear/reconciliation-config.js.map +1 -1
- package/dist/integrations/linear/routes.d.ts +0 -2
- package/dist/integrations/linear/routes.d.ts.map +1 -1
- package/dist/integrations/linear/routes.js +3 -9
- package/dist/integrations/linear/routes.js.map +1 -1
- package/dist/integrations/platform/api-client.d.ts +2 -0
- package/dist/integrations/platform/api-client.d.ts.map +1 -1
- package/dist/integrations/platform/api-client.js +6 -1
- package/dist/integrations/platform/api-client.js.map +1 -1
- package/dist/integrations/platform/connect/routes.d.ts.map +1 -1
- package/dist/integrations/platform/connect/routes.js +8 -1
- package/dist/integrations/platform/connect/routes.js.map +1 -1
- package/dist/integrations/platform/github/event-worker.d.ts +17 -0
- package/dist/integrations/platform/github/event-worker.d.ts.map +1 -1
- package/dist/integrations/platform/github/event-worker.js +89 -7
- package/dist/integrations/platform/github/event-worker.js.map +1 -1
- package/dist/integrations/platform/github/integration.d.ts +20 -1
- package/dist/integrations/platform/github/integration.d.ts.map +1 -1
- package/dist/integrations/platform/github/integration.js +54 -3
- package/dist/integrations/platform/github/integration.js.map +1 -1
- package/dist/integrations/platform/gitlab/event-worker.js +1 -1
- package/dist/integrations/platform/gitlab/event-worker.js.map +1 -1
- package/dist/integrations/platform/incidentio/integration.d.ts +3 -2
- package/dist/integrations/platform/incidentio/integration.d.ts.map +1 -1
- package/dist/integrations/platform/incidentio/integration.js +7 -7
- package/dist/integrations/platform/incidentio/integration.js.map +1 -1
- package/dist/integrations/platform/jira/integration.d.ts.map +1 -1
- package/dist/integrations/platform/jira/integration.js +4 -7
- package/dist/integrations/platform/jira/integration.js.map +1 -1
- package/dist/integrations/platform/jira/routes.d.ts +0 -7
- package/dist/integrations/platform/jira/routes.d.ts.map +1 -1
- package/dist/integrations/platform/jira/routes.js +2 -12
- package/dist/integrations/platform/jira/routes.js.map +1 -1
- package/dist/integrations/platform/linear/event-worker.d.ts +2 -2
- package/dist/integrations/platform/linear/event-worker.d.ts.map +1 -1
- package/dist/integrations/platform/linear/event-worker.js +1 -1
- package/dist/integrations/platform/linear/event-worker.js.map +1 -1
- package/dist/integrations/platform/linear/integration.d.ts +1 -0
- package/dist/integrations/platform/linear/integration.d.ts.map +1 -1
- package/dist/integrations/platform/linear/integration.js +7 -7
- package/dist/integrations/platform/linear/integration.js.map +1 -1
- package/dist/integrations/platform/vanta/integration.d.ts +38 -0
- package/dist/integrations/platform/vanta/integration.d.ts.map +1 -0
- package/dist/integrations/platform/vanta/integration.js +149 -0
- package/dist/integrations/platform/vanta/integration.js.map +1 -0
- package/dist/integrations/reconciliation-config.d.ts +0 -1
- package/dist/integrations/reconciliation-config.d.ts.map +1 -1
- package/dist/integrations/reconciliation-config.js +1 -8
- package/dist/integrations/reconciliation-config.js.map +1 -1
- package/dist/integrations/slack/channel-reply-processor.js +1 -1
- package/dist/integrations/slack/channel-reply-processor.js.map +1 -1
- package/dist/integrations/startup-summary.d.ts +8 -0
- package/dist/integrations/startup-summary.d.ts.map +1 -0
- package/dist/integrations/startup-summary.js +36 -0
- package/dist/integrations/startup-summary.js.map +1 -0
- package/dist/integrations/vanta/default-rules.d.ts +34 -0
- package/dist/integrations/vanta/default-rules.d.ts.map +1 -0
- package/dist/integrations/vanta/default-rules.js +61 -0
- package/dist/integrations/vanta/default-rules.js.map +1 -0
- package/dist/integrations/vanta/rules.d.ts +40 -0
- package/dist/integrations/vanta/rules.d.ts.map +1 -0
- package/dist/integrations/vanta/rules.js +208 -0
- package/dist/integrations/vanta/rules.js.map +1 -0
- package/dist/integrations/vanta/sync.d.ts +40 -0
- package/dist/integrations/vanta/sync.d.ts.map +1 -0
- package/dist/integrations/vanta/sync.js +81 -0
- package/dist/integrations/vanta/sync.js.map +1 -0
- package/dist/linked-repositories-changed.d.ts +14 -0
- package/dist/linked-repositories-changed.d.ts.map +1 -0
- package/dist/linked-repositories-changed.js +48 -0
- package/dist/linked-repositories-changed.js.map +1 -0
- package/dist/mcp/routes.d.ts.map +1 -1
- package/dist/mcp/routes.js +1 -1
- package/dist/mcp/routes.js.map +1 -1
- package/dist/routes/board-snapshot.d.ts +8 -1
- package/dist/routes/board-snapshot.d.ts.map +1 -1
- package/dist/routes/board-snapshot.js +23 -2
- package/dist/routes/board-snapshot.js.map +1 -1
- package/dist/routes/contracts.d.ts +322 -0
- package/dist/routes/contracts.d.ts.map +1 -1
- package/dist/routes/contracts.js +202 -5
- package/dist/routes/contracts.js.map +1 -1
- package/dist/routes/intake-routes.d.ts +3 -0
- package/dist/routes/intake-routes.d.ts.map +1 -1
- package/dist/routes/intake-routes.js +44 -0
- package/dist/routes/intake-routes.js.map +1 -1
- package/dist/routes/knowledge.d.ts.map +1 -1
- package/dist/routes/knowledge.js +3 -2
- package/dist/routes/knowledge.js.map +1 -1
- package/dist/routes/run-queue.d.ts +17 -0
- package/dist/routes/run-queue.d.ts.map +1 -0
- package/dist/routes/run-queue.js +69 -0
- package/dist/routes/run-queue.js.map +1 -0
- package/dist/routes/source-control-sessions.d.ts +1 -1
- package/dist/routes/source-control-sessions.d.ts.map +1 -1
- package/dist/routes/source-control-sessions.js +109 -3
- package/dist/routes/source-control-sessions.js.map +1 -1
- package/dist/routes/surface.d.ts +14 -1
- package/dist/routes/surface.d.ts.map +1 -1
- package/dist/routes/surface.js +76 -11
- package/dist/routes/surface.js.map +1 -1
- package/dist/routes/work-item-selection.d.ts +4 -5
- package/dist/routes/work-item-selection.d.ts.map +1 -1
- package/dist/routes/work-item-selection.js +11 -23
- package/dist/routes/work-item-selection.js.map +1 -1
- package/dist/routes/work-item-starters.d.ts.map +1 -1
- package/dist/routes/work-item-starters.js +4 -21
- package/dist/routes/work-item-starters.js.map +1 -1
- package/dist/routes/work-items.d.ts +5 -0
- package/dist/routes/work-items.d.ts.map +1 -1
- package/dist/routes/work-items.js +129 -36
- package/dist/routes/work-items.js.map +1 -1
- package/dist/rules/dispatch-errors.d.ts +3 -0
- package/dist/rules/dispatch-errors.d.ts.map +1 -1
- package/dist/rules/dispatch-errors.js +5 -0
- package/dist/rules/dispatch-errors.js.map +1 -1
- package/dist/rules/dispatcher.d.ts +15 -1
- package/dist/rules/dispatcher.d.ts.map +1 -1
- package/dist/rules/dispatcher.js +48 -20
- package/dist/rules/dispatcher.js.map +1 -1
- package/dist/rules/index.d.ts +2 -2
- package/dist/rules/index.d.ts.map +1 -1
- package/dist/rules/index.js +2 -2
- package/dist/rules/review-source-tool.js +2 -1
- package/dist/rules/review-source-tool.js.map +1 -1
- package/dist/rules/start-coordinator.d.ts +6 -1
- package/dist/rules/start-coordinator.d.ts.map +1 -1
- package/dist/rules/start-coordinator.js +6 -2
- package/dist/rules/start-coordinator.js.map +1 -1
- package/dist/rules/transition-service.d.ts.map +1 -1
- package/dist/rules/transition-service.js +3 -2
- package/dist/rules/transition-service.js.map +1 -1
- package/dist/rules/types.d.ts +71 -3
- package/dist/rules/types.d.ts.map +1 -1
- package/dist/rules/types.js +10 -2
- package/dist/rules/types.js.map +1 -1
- package/dist/rules/validation.d.ts.map +1 -1
- package/dist/rules/validation.js +5 -0
- package/dist/rules/validation.js.map +1 -1
- package/dist/session/factory-session.d.ts +20 -5
- package/dist/session/factory-session.d.ts.map +1 -1
- package/dist/session/factory-session.js +20 -6
- package/dist/session/factory-session.js.map +1 -1
- package/dist/storage/domains/audit/actions.d.ts +1 -1
- package/dist/storage/domains/audit/actions.d.ts.map +1 -1
- package/dist/storage/domains/audit/actions.js +2 -1
- package/dist/storage/domains/audit/actions.js.map +1 -1
- package/dist/storage/domains/audit/actors.d.ts.map +1 -1
- package/dist/storage/domains/audit/actors.js +1 -1
- package/dist/storage/domains/audit/actors.js.map +1 -1
- package/dist/storage/domains/intake/base.d.ts +1 -1
- package/dist/storage/domains/intake/base.js +2 -2
- package/dist/storage/domains/intake/base.js.map +1 -1
- package/dist/storage/domains/projects/base.d.ts +10 -0
- package/dist/storage/domains/projects/base.d.ts.map +1 -1
- package/dist/storage/domains/projects/base.js +24 -2
- package/dist/storage/domains/projects/base.js.map +1 -1
- package/dist/storage/domains/source-control/base.d.ts +32 -0
- package/dist/storage/domains/source-control/base.d.ts.map +1 -1
- package/dist/storage/domains/source-control/base.js +54 -4
- package/dist/storage/domains/source-control/base.js.map +1 -1
- package/dist/storage/domains/source-control/inmemory.d.ts +3 -0
- package/dist/storage/domains/source-control/inmemory.d.ts.map +1 -1
- package/dist/storage/domains/source-control/inmemory.js +17 -0
- package/dist/storage/domains/source-control/inmemory.js.map +1 -1
- package/dist/storage/domains/work-items/base.d.ts +16 -4
- package/dist/storage/domains/work-items/base.d.ts.map +1 -1
- package/dist/storage/domains/work-items/base.js +28 -1
- package/dist/storage/domains/work-items/base.js.map +1 -1
- package/dist/timing.d.ts +8 -1
- package/dist/timing.d.ts.map +1 -1
- package/dist/timing.js +10 -2
- package/dist/timing.js.map +1 -1
- package/dist/tools/approval-tools.d.ts +20 -0
- package/dist/tools/approval-tools.d.ts.map +1 -1
- package/dist/tools/approval-tools.js +79 -30
- package/dist/tools/approval-tools.js.map +1 -1
- package/dist/tools/audit-events-tool.d.ts +1 -1
- package/dist/tools/messaging-tools.d.ts.map +1 -1
- package/dist/tools/messaging-tools.js +1 -1
- package/dist/tools/messaging-tools.js.map +1 -1
- package/dist/tools/read-tools.d.ts +0 -2
- package/dist/tools/read-tools.d.ts.map +1 -1
- package/dist/tools/read-tools.js +2 -7
- package/dist/tools/read-tools.js.map +1 -1
- package/dist/tools/reports.d.ts +3 -0
- package/dist/tools/reports.d.ts.map +1 -1
- package/dist/tools/reports.js +3 -3
- package/dist/tools/reports.js.map +1 -1
- package/dist/tools/run-watch.d.ts +14 -2
- package/dist/tools/run-watch.d.ts.map +1 -1
- package/dist/tools/run-watch.js +24 -4
- package/dist/tools/run-watch.js.map +1 -1
- package/dist/tools/session-tools.d.ts.map +1 -1
- package/dist/tools/session-tools.js +17 -6
- package/dist/tools/session-tools.js.map +1 -1
- package/dist/tools/side-sessions.d.ts.map +1 -1
- package/dist/tools/side-sessions.js +1 -1
- package/dist/tools/side-sessions.js.map +1 -1
- package/dist/tools/work-item-tools.d.ts.map +1 -1
- package/dist/tools/work-item-tools.js +12 -2
- package/dist/tools/work-item-tools.js.map +1 -1
- package/dist/work-item-branch.d.ts +1 -1
- package/dist/work-item-branch.d.ts.map +1 -1
- package/dist/work-item-branch.js +2 -0
- package/dist/work-item-branch.js.map +1 -1
- package/dist/work-items/board-filter-options.d.ts +5 -0
- package/dist/work-items/board-filter-options.d.ts.map +1 -0
- package/dist/work-items/board-filter-options.js +27 -0
- package/dist/work-items/board-filter-options.js.map +1 -0
- package/dist/work-items/board-phases.d.ts +28 -0
- package/dist/work-items/board-phases.d.ts.map +1 -0
- package/dist/work-items/board-phases.js +165 -0
- package/dist/work-items/board-phases.js.map +1 -0
- package/dist/work-items/card-facts.d.ts +24 -0
- package/dist/work-items/card-facts.d.ts.map +1 -0
- package/dist/work-items/card-facts.js +75 -0
- package/dist/work-items/card-facts.js.map +1 -0
- package/dist/work-items/card-labels.d.ts +5 -0
- package/dist/work-items/card-labels.d.ts.map +1 -0
- package/dist/work-items/card-labels.js +13 -0
- package/dist/work-items/card-labels.js.map +1 -0
- package/dist/work-items/card-number.d.ts +10 -0
- package/dist/work-items/card-number.d.ts.map +1 -0
- package/dist/work-items/card-number.js +15 -0
- package/dist/work-items/card-number.js.map +1 -0
- package/dist/work-items/card-people.d.ts +25 -0
- package/dist/work-items/card-people.d.ts.map +1 -0
- package/dist/work-items/card-people.js +100 -0
- package/dist/work-items/card-people.js.map +1 -0
- package/dist/work-items/card-search-text.d.ts +4 -0
- package/dist/work-items/card-search-text.d.ts.map +1 -0
- package/dist/work-items/card-search-text.js +15 -0
- package/dist/work-items/card-search-text.js.map +1 -0
- package/dist/work-items/card-source-filters.d.ts +23 -0
- package/dist/work-items/card-source-filters.d.ts.map +1 -0
- package/dist/work-items/card-source-filters.js +25 -0
- package/dist/work-items/card-source-filters.js.map +1 -0
- package/dist/work-items/create-work-item.d.ts +0 -6
- package/dist/work-items/create-work-item.d.ts.map +1 -1
- package/dist/work-items/create-work-item.js +2 -7
- package/dist/work-items/create-work-item.js.map +1 -1
- package/dist/work-items/list-related-cards.d.ts +4 -0
- package/dist/work-items/list-related-cards.d.ts.map +1 -0
- package/dist/work-items/list-related-cards.js +24 -0
- package/dist/work-items/list-related-cards.js.map +1 -0
- package/dist/work-items/search-words.d.ts +5 -0
- package/dist/work-items/search-words.d.ts.map +1 -0
- package/dist/work-items/search-words.js +12 -0
- package/dist/work-items/search-words.js.map +1 -0
- package/dist/work-items/source-external-id.d.ts +4 -0
- package/dist/work-items/source-external-id.d.ts.map +1 -0
- package/dist/work-items/source-external-id.js +9 -0
- package/dist/work-items/source-external-id.js.map +1 -0
- package/dist/workspace.d.ts.map +1 -1
- package/dist/workspace.js +92 -47
- package/dist/workspace.js.map +1 -1
- package/package.json +9 -8
package/dist/routes/knowledge.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { Route, loose } from "./route.js";
|
|
2
2
|
import { registerApiRoute } from "@mastra/core/server";
|
|
3
3
|
import { streamSSE } from "hono/streaming";
|
|
4
|
-
import { KnowledgeDeclarationError, listKnowledgeTreeChildren, readKnowledgePage, readKnowledgePageActivity, readKnowledgePageGraph, readKnowledgeScopeGrants, searchKnowledgeExplorerPages } from "@mastra/core/knowledge";
|
|
4
|
+
import { KnowledgeDeclarationError, encodeKnowledgeScopeId, listKnowledgeTreeChildren, readKnowledgePage, readKnowledgePageActivity, readKnowledgePageGraph, readKnowledgeScopeGrants, searchKnowledgeExplorerPages } from "@mastra/core/knowledge";
|
|
5
5
|
// src/routes/knowledge.ts
|
|
6
6
|
const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
|
|
7
7
|
/** Ids and cursors are opaque, but bounded so an unbounded query string never reaches storage. */
|
|
@@ -94,10 +94,11 @@ var KnowledgeRoutes = class extends Route {
|
|
|
94
94
|
message: "The configured Knowledge runtime is unavailable."
|
|
95
95
|
}, 503) };
|
|
96
96
|
try {
|
|
97
|
+
const principals = [`org:${encodeKnowledgeScopeId(tenant.orgId)}`, `project:${encodeKnowledgeScopeId(projectId)}`];
|
|
97
98
|
return {
|
|
98
99
|
knowledge,
|
|
99
100
|
store,
|
|
100
|
-
read: await knowledge.readScopeFor(
|
|
101
|
+
read: await knowledge.readScopeFor(principals)
|
|
101
102
|
};
|
|
102
103
|
} catch (error) {
|
|
103
104
|
if (error instanceof KnowledgeDeclarationError) return { response: c.json({
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"knowledge.js","names":[],"sources":["../../src/routes/knowledge.ts"],"sourcesContent":["/**\n * Read-only Mastra `apiRoutes` behind Factory's Knowledge page: the schema-4 page tree, a page with its\n * notes, the bounded page graph, search and activity, all through the same core page readers Studio uses,\n * plus a change stream (`/events`, SSE) naming the pages and scopes each committed write touched.\n * Every endpoint is a GET; this module never writes Knowledge.\n *\n * Scoping is fail-closed and server-side. The caller must be signed in to an org that owns the `:id`\n * project, and reads are limited to what the Knowledge's own declarations give the principals\n * `org:<orgId>` and `project:<projectId>`: the scopes a run in that project holds at org and project\n * level. Session (`resource:`/`thread:`) scopes are not principals here, so no member browses another\n * member's session pages. The host must declare `project:$projectId` (as its session runs need); without\n * it reads fail with 500 `knowledge_misconfigured`.\n */\n\nimport type { Knowledge, KnowledgeChangeEvent } from '@mastra/core/knowledge';\nimport {\n KnowledgeDeclarationError,\n listKnowledgeTreeChildren,\n readKnowledgePage,\n readKnowledgePageActivity,\n readKnowledgePageGraph,\n readKnowledgeScopeGrants,\n searchKnowledgeExplorerPages,\n} from '@mastra/core/knowledge';\nimport type { ApiRoute } from '@mastra/core/server';\nimport { registerApiRoute } from '@mastra/core/server';\nimport type { KnowledgeReadScope, KnowledgeStorage } from '@mastra/core/storage';\nimport type { Context } from 'hono';\nimport { streamSSE } from 'hono/streaming';\n\nimport type { FactoryProjectsStorage } from '../storage/domains/projects/base.js';\nimport type { RouteDependencies } from './route.js';\nimport { loose, Route } from './route.js';\n\nconst UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\n/** Ids and cursors are opaque, but bounded so an unbounded query string never reaches storage. */\nconst ID_LIMIT = 256;\nconst SEARCH_QUERY_LIMIT = 128;\nconst MAX_PAGE_LIMIT = 100;\nconst MAX_GRAPH_PAGES = 500;\n/** Comment frames only: proxies drop an idle stream. */\nconst EVENTS_KEEPALIVE_MS = 25_000;\n/**\n * The read scope is resolved when the stream opens. Closing it after this long makes the browser reconnect,\n * which re-checks membership and the read scope, so a revoked member stops hearing about changes.\n */\nconst EVENTS_MAX_AGE_MS = 5 * 60_000;\n\nexport interface KnowledgeRoutesDeps extends RouteDependencies {\n /** Factory projects domain: validates that the `:id` project belongs to the caller's org. */\n projects: FactoryProjectsStorage;\n /** Lazy handle to the host-registered Knowledge runtime; endpoints 503 when absent. */\n knowledge: (key: string) => Promise<Knowledge | undefined>;\n /** Host-selected Knowledge key. Requests cannot override it. */\n defaultKnowledgeKey?: string;\n}\n\ninterface ResolvedView {\n knowledge: Knowledge;\n store: KnowledgeStorage;\n read: KnowledgeReadScope;\n}\n\nfunction boundedId(value: string | undefined): string | undefined {\n if (value === undefined) return undefined;\n const trimmed = value.trim();\n return trimmed && trimmed.length <= ID_LIMIT ? trimmed : undefined;\n}\n\nfunction boundedLimit(value: string | undefined, max: number): number | undefined | null {\n if (value === undefined) return undefined;\n const parsed = Number(value);\n return Number.isInteger(parsed) && parsed >= 1 && parsed <= max ? parsed : null;\n}\n\n/**\n * The ids of a change this caller may see, or null when they may see none of it. Events carry ids only, so\n * readability is checked against the store now: a page moved out of reach is withheld, but the scope it\n * left still tells the caller to refresh.\n */\nasync function visibleChange(store: KnowledgeStorage, read: KnowledgeReadScope, event: KnowledgeChangeEvent) {\n const readable = async (id: string | undefined) =>\n id !== undefined && (read === 'all' || (await store.getPage({ id, read })) !== null);\n const scopeId = 'scopeId' in event ? event.scopeId : undefined;\n const fromScopeId = 'fromScopeId' in event ? event.fromScopeId : undefined;\n const [page, scope, fromScope] = await Promise.all([\n readable(event.pageId),\n readable(scopeId),\n readable(fromScopeId),\n ]);\n if (!page && !scope && !fromScope) return null;\n return {\n kind: event.kind,\n op: event.op,\n ...(page ? { pageId: event.pageId } : {}),\n ...(scope ? { scopeId } : {}),\n at: event.at.toISOString(),\n };\n}\n\ntype LabelablePage = { isScope: boolean; address?: string };\n\n/**\n * Adds a scope page's declared `displayLabel` with the address's `$params` filled in (`'$orgId policy'`\n * → `'acme policy'`); declarations live in config, not storage.\n */\nfunction withDisplayLabel<T extends LabelablePage>(knowledge: Knowledge, page: T): T & { displayLabel?: string } {\n if (!page.isScope || !page.address) return page;\n const displayLabel = knowledge.scopeLabel(page.address);\n return displayLabel ? { ...page, displayLabel } : page;\n}\n\nexport class KnowledgeRoutes extends Route<KnowledgeRoutesDeps> {\n /** Tenant, org-owned project, Knowledge runtime and the caller's read scope: the one seam every route shares. */\n async #resolveView(c: Context): Promise<ResolvedView | { response: Response }> {\n await this.deps.auth.ensureUser(c);\n const tenant = this.deps.auth.tenant(c);\n if (!tenant) return { response: c.json({ error: 'unauthorized' }, 401) };\n if (!tenant.orgId) {\n return {\n response: c.json({ error: 'organization_required', message: 'Knowledge requires an organization.' }, 403),\n };\n }\n\n const projectId = c.req.param('id');\n if (!projectId || !UUID_RE.test(projectId)) return { response: c.json({ error: 'Project not found' }, 404) };\n await this.deps.projects.ensureReady();\n const project = await this.deps.projects.get({ orgId: tenant.orgId, id: projectId });\n if (!project) return { response: c.json({ error: 'Project not found' }, 404) };\n\n let knowledge: Knowledge | undefined;\n let store: KnowledgeStorage | undefined;\n try {\n knowledge = await this.deps.knowledge(this.deps.defaultKnowledgeKey ?? 'default');\n store = knowledge ? await knowledge.getStorage() : undefined;\n } catch {\n store = undefined;\n }\n if (!knowledge || !store) {\n return {\n response: c.json(\n { error: 'knowledge_unavailable', message: 'The configured Knowledge runtime is unavailable.' },\n 503,\n ),\n };\n }\n try {\n return { knowledge, store, read: await knowledge.readScopeFor([`org:${tenant.orgId}`, `project:${projectId}`]) };\n } catch (error) {\n // The host's Knowledge does not declare the scopes a Factory run holds (`org:` and `project:`): a\n // deployment misconfiguration, which its session runs hit too. Never fall back to a guessed scope.\n if (error instanceof KnowledgeDeclarationError) {\n return { response: c.json({ error: 'knowledge_misconfigured', message: error.message }, 500) };\n }\n throw error;\n }\n }\n\n routes(): ApiRoute[] {\n const badRequest = (c: Context, message: string) => c.json({ error: 'bad_request', message }, 400);\n return [\n registerApiRoute('/web/factory/projects/:id/knowledge/tree', {\n method: 'GET',\n requiresAuth: false,\n handler: async raw => {\n const c = loose(raw);\n const view = await this.#resolveView(c);\n if ('response' in view) return view.response;\n const parentId = boundedId(c.req.query('parentId'));\n const cursor = boundedId(c.req.query('cursor'));\n const limit = boundedLimit(c.req.query('limit'), MAX_PAGE_LIMIT);\n if (limit === null) return badRequest(c, `limit must be an integer from 1 to ${MAX_PAGE_LIMIT}.`);\n const level = await listKnowledgeTreeChildren(view.store, {\n parentId: parentId ?? null,\n read: view.read,\n cursor,\n limit,\n });\n return c.json({ ...level, pages: level.pages.map(page => withDisplayLabel(view.knowledge, page)) });\n },\n }),\n registerApiRoute('/web/factory/projects/:id/knowledge/pages/:pageId', {\n method: 'GET',\n requiresAuth: false,\n handler: async raw => {\n const c = loose(raw);\n const view = await this.#resolveView(c);\n if ('response' in view) return view.response;\n const pageId = boundedId(c.req.param('pageId'));\n if (!pageId) return c.json({ error: 'page_not_found' }, 404);\n const noteLimit = boundedLimit(c.req.query('noteLimit'), MAX_PAGE_LIMIT);\n if (noteLimit === null) return badRequest(c, `noteLimit must be an integer from 1 to ${MAX_PAGE_LIMIT}.`);\n const page = await readKnowledgePage(view.store, {\n pageId,\n read: view.read,\n noteCursor: boundedId(c.req.query('noteCursor')),\n noteLimit,\n });\n if (!page) return c.json({ error: 'page_not_found' }, 404);\n const label = <T extends LabelablePage>(entry: T) => withDisplayLabel(view.knowledge, entry);\n return c.json({\n ...page,\n page: label(page.page),\n ancestors: page.ancestors.map(label),\n related: page.related.map(label),\n });\n },\n }),\n registerApiRoute('/web/factory/projects/:id/knowledge/graph', {\n method: 'GET',\n requiresAuth: false,\n handler: async raw => {\n const c = loose(raw);\n const view = await this.#resolveView(c);\n if ('response' in view) return view.response;\n const maxPages = boundedLimit(c.req.query('maxPages'), MAX_GRAPH_PAGES);\n if (maxPages === null) return badRequest(c, `maxPages must be an integer from 1 to ${MAX_GRAPH_PAGES}.`);\n const graph = await readKnowledgePageGraph(view.store, {\n read: view.read,\n rootId: boundedId(c.req.query('rootId')) ?? null,\n ...(maxPages ? { limits: { maxPages } } : {}),\n });\n if (!graph) return c.json({ error: 'page_not_found' }, 404);\n // Declared grants between the scopes shown, limited to principal scopes this caller can read.\n const grants = await readKnowledgeScopeGrants(view.store, {\n pages: graph.pages,\n read: view.read,\n grantsFor: scope => view.knowledge.scopeGrants(scope),\n });\n return c.json({\n ...graph,\n pages: graph.pages.map(page => withDisplayLabel(view.knowledge, page)),\n grants: grants.map(grant => {\n const principalLabel = view.knowledge.scopeLabel(grant.principal);\n return principalLabel ? { ...grant, principalLabel } : grant;\n }),\n });\n },\n }),\n registerApiRoute('/web/factory/projects/:id/knowledge/search', {\n method: 'GET',\n requiresAuth: false,\n handler: async raw => {\n const c = loose(raw);\n const view = await this.#resolveView(c);\n if ('response' in view) return view.response;\n const query = (c.req.query('q') ?? '').trim();\n if (!query) return c.json({ results: [] });\n if (query.length > SEARCH_QUERY_LIMIT) {\n return badRequest(c, `q must be at most ${SEARCH_QUERY_LIMIT} characters.`);\n }\n const limit = boundedLimit(c.req.query('limit'), MAX_PAGE_LIMIT);\n if (limit === null) return badRequest(c, `limit must be an integer from 1 to ${MAX_PAGE_LIMIT}.`);\n const scopeIds = c.req.queries('scopeId')?.flatMap(id => boundedId(id) ?? []);\n const results = await searchKnowledgeExplorerPages(view.store, {\n query,\n read: view.read,\n ...(scopeIds?.length ? { scopeIds } : {}),\n limit,\n });\n return c.json({\n results: results.map(hit => ({ ...hit, page: withDisplayLabel(view.knowledge, hit.page) })),\n });\n },\n }),\n registerApiRoute('/web/factory/projects/:id/knowledge/events', {\n method: 'GET',\n requiresAuth: false,\n handler: async raw => {\n const c = loose(raw);\n const view = await this.#resolveView(c);\n if ('response' in view) return view.response;\n const { knowledge, store, read } = view;\n return streamSSE(c, async stream => {\n const closed = new Promise<void>(resolve => stream.onAbort(resolve));\n // Filtering reads the store, so changes are queued to keep them in commit order.\n let queue = Promise.resolve();\n const unsubscribe = knowledge.onChange(event => {\n queue = queue.then(async () => {\n if (stream.aborted) return;\n const change = await visibleChange(store, read, event).catch(() => null);\n if (!change || stream.aborted) return;\n try {\n await stream.writeSSE({ event: 'change', data: JSON.stringify(change) });\n } catch {\n // The tab went away mid-write; abort cleans up.\n }\n });\n });\n const keepalive = setInterval(() => {\n if (!stream.aborted) void stream.write(': ping\\n\\n');\n }, EVENTS_KEEPALIVE_MS);\n let expire: ReturnType<typeof setTimeout> | undefined;\n try {\n await stream.write(': connected\\n\\n');\n // `streamSSE` closes the stream the moment this callback returns.\n await Promise.race([\n closed,\n new Promise<void>(resolve => (expire = setTimeout(resolve, EVENTS_MAX_AGE_MS))),\n ]);\n } finally {\n clearTimeout(expire);\n clearInterval(keepalive);\n unsubscribe();\n }\n });\n },\n }),\n registerApiRoute('/web/factory/projects/:id/knowledge/activity', {\n method: 'GET',\n requiresAuth: false,\n handler: async raw => {\n const c = loose(raw);\n const view = await this.#resolveView(c);\n if ('response' in view) return view.response;\n const limit = boundedLimit(c.req.query('limit'), MAX_PAGE_LIMIT);\n if (limit === null) return badRequest(c, `limit must be an integer from 1 to ${MAX_PAGE_LIMIT}.`);\n return c.json(\n await readKnowledgePageActivity(view.store, {\n read: view.read,\n scopeId: boundedId(c.req.query('scopeId')),\n pageId: boundedId(c.req.query('pageId')),\n cursor: boundedId(c.req.query('cursor')),\n limit,\n }),\n );\n },\n }),\n ];\n }\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"knowledge.js","names":[],"sources":["../../src/routes/knowledge.ts"],"sourcesContent":["/**\n * Read-only Mastra `apiRoutes` behind Factory's Knowledge page: the schema-4 page tree, a page with its\n * notes, the bounded page graph, search and activity, all through the same core page readers Studio uses,\n * plus a change stream (`/events`, SSE) naming the pages and scopes each committed write touched.\n * Every endpoint is a GET; this module never writes Knowledge.\n *\n * Scoping is fail-closed and server-side. The caller must be signed in to an org that owns the `:id`\n * project, and reads are limited to what the Knowledge's own declarations give the principals\n * `org:<orgId>` and `project:<projectId>`: the scopes a run in that project holds at org and project\n * level. Session (`resource:`/`thread:`) scopes are not principals here, so no member browses another\n * member's session pages. The host must declare `project:$projectId` (as its session runs need); without\n * it reads fail with 500 `knowledge_misconfigured`.\n */\n\nimport type { Knowledge, KnowledgeChangeEvent } from '@mastra/core/knowledge';\nimport {\n encodeKnowledgeScopeId,\n KnowledgeDeclarationError,\n listKnowledgeTreeChildren,\n readKnowledgePage,\n readKnowledgePageActivity,\n readKnowledgePageGraph,\n readKnowledgeScopeGrants,\n searchKnowledgeExplorerPages,\n} from '@mastra/core/knowledge';\nimport type { ApiRoute } from '@mastra/core/server';\nimport { registerApiRoute } from '@mastra/core/server';\nimport type { KnowledgeReadScope, KnowledgeStorage } from '@mastra/core/storage';\nimport type { Context } from 'hono';\nimport { streamSSE } from 'hono/streaming';\n\nimport type { FactoryProjectsStorage } from '../storage/domains/projects/base.js';\nimport type { RouteDependencies } from './route.js';\nimport { loose, Route } from './route.js';\n\nconst UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;\n/** Ids and cursors are opaque, but bounded so an unbounded query string never reaches storage. */\nconst ID_LIMIT = 256;\nconst SEARCH_QUERY_LIMIT = 128;\nconst MAX_PAGE_LIMIT = 100;\nconst MAX_GRAPH_PAGES = 500;\n/** Comment frames only: proxies drop an idle stream. */\nconst EVENTS_KEEPALIVE_MS = 25_000;\n/**\n * The read scope is resolved when the stream opens. Closing it after this long makes the browser reconnect,\n * which re-checks membership and the read scope, so a revoked member stops hearing about changes.\n */\nconst EVENTS_MAX_AGE_MS = 5 * 60_000;\n\nexport interface KnowledgeRoutesDeps extends RouteDependencies {\n /** Factory projects domain: validates that the `:id` project belongs to the caller's org. */\n projects: FactoryProjectsStorage;\n /** Lazy handle to the host-registered Knowledge runtime; endpoints 503 when absent. */\n knowledge: (key: string) => Promise<Knowledge | undefined>;\n /** Host-selected Knowledge key. Requests cannot override it. */\n defaultKnowledgeKey?: string;\n}\n\ninterface ResolvedView {\n knowledge: Knowledge;\n store: KnowledgeStorage;\n read: KnowledgeReadScope;\n}\n\nfunction boundedId(value: string | undefined): string | undefined {\n if (value === undefined) return undefined;\n const trimmed = value.trim();\n return trimmed && trimmed.length <= ID_LIMIT ? trimmed : undefined;\n}\n\nfunction boundedLimit(value: string | undefined, max: number): number | undefined | null {\n if (value === undefined) return undefined;\n const parsed = Number(value);\n return Number.isInteger(parsed) && parsed >= 1 && parsed <= max ? parsed : null;\n}\n\n/**\n * The ids of a change this caller may see, or null when they may see none of it. Events carry ids only, so\n * readability is checked against the store now: a page moved out of reach is withheld, but the scope it\n * left still tells the caller to refresh.\n */\nasync function visibleChange(store: KnowledgeStorage, read: KnowledgeReadScope, event: KnowledgeChangeEvent) {\n const readable = async (id: string | undefined) =>\n id !== undefined && (read === 'all' || (await store.getPage({ id, read })) !== null);\n const scopeId = 'scopeId' in event ? event.scopeId : undefined;\n const fromScopeId = 'fromScopeId' in event ? event.fromScopeId : undefined;\n const [page, scope, fromScope] = await Promise.all([\n readable(event.pageId),\n readable(scopeId),\n readable(fromScopeId),\n ]);\n if (!page && !scope && !fromScope) return null;\n return {\n kind: event.kind,\n op: event.op,\n ...(page ? { pageId: event.pageId } : {}),\n ...(scope ? { scopeId } : {}),\n at: event.at.toISOString(),\n };\n}\n\ntype LabelablePage = { isScope: boolean; address?: string };\n\n/**\n * Adds a scope page's declared `displayLabel` with the address's `$params` filled in (`'$orgId policy'`\n * → `'acme policy'`); declarations live in config, not storage.\n */\nfunction withDisplayLabel<T extends LabelablePage>(knowledge: Knowledge, page: T): T & { displayLabel?: string } {\n if (!page.isScope || !page.address) return page;\n const displayLabel = knowledge.scopeLabel(page.address);\n return displayLabel ? { ...page, displayLabel } : page;\n}\n\nexport class KnowledgeRoutes extends Route<KnowledgeRoutesDeps> {\n /** Tenant, org-owned project, Knowledge runtime and the caller's read scope: the one seam every route shares. */\n async #resolveView(c: Context): Promise<ResolvedView | { response: Response }> {\n await this.deps.auth.ensureUser(c);\n const tenant = this.deps.auth.tenant(c);\n if (!tenant) return { response: c.json({ error: 'unauthorized' }, 401) };\n if (!tenant.orgId) {\n return {\n response: c.json({ error: 'organization_required', message: 'Knowledge requires an organization.' }, 403),\n };\n }\n\n const projectId = c.req.param('id');\n if (!projectId || !UUID_RE.test(projectId)) return { response: c.json({ error: 'Project not found' }, 404) };\n await this.deps.projects.ensureReady();\n const project = await this.deps.projects.get({ orgId: tenant.orgId, id: projectId });\n if (!project) return { response: c.json({ error: 'Project not found' }, 404) };\n\n let knowledge: Knowledge | undefined;\n let store: KnowledgeStorage | undefined;\n try {\n knowledge = await this.deps.knowledge(this.deps.defaultKnowledgeKey ?? 'default');\n store = knowledge ? await knowledge.getStorage() : undefined;\n } catch {\n store = undefined;\n }\n if (!knowledge || !store) {\n return {\n response: c.json(\n { error: 'knowledge_unavailable', message: 'The configured Knowledge runtime is unavailable.' },\n 503,\n ),\n };\n }\n try {\n // The same canonical addresses a Factory session's runs hold (see the SDK's resolveKnowledgeSessionScopes).\n const principals = [\n `org:${encodeKnowledgeScopeId(tenant.orgId)}`,\n `project:${encodeKnowledgeScopeId(projectId)}`,\n ];\n return { knowledge, store, read: await knowledge.readScopeFor(principals) };\n } catch (error) {\n // The host's Knowledge does not declare the scopes a Factory run holds (`org:` and `project:`): a\n // deployment misconfiguration, which its session runs hit too. Never fall back to a guessed scope.\n if (error instanceof KnowledgeDeclarationError) {\n return { response: c.json({ error: 'knowledge_misconfigured', message: error.message }, 500) };\n }\n throw error;\n }\n }\n\n routes(): ApiRoute[] {\n const badRequest = (c: Context, message: string) => c.json({ error: 'bad_request', message }, 400);\n return [\n registerApiRoute('/web/factory/projects/:id/knowledge/tree', {\n method: 'GET',\n requiresAuth: false,\n handler: async raw => {\n const c = loose(raw);\n const view = await this.#resolveView(c);\n if ('response' in view) return view.response;\n const parentId = boundedId(c.req.query('parentId'));\n const cursor = boundedId(c.req.query('cursor'));\n const limit = boundedLimit(c.req.query('limit'), MAX_PAGE_LIMIT);\n if (limit === null) return badRequest(c, `limit must be an integer from 1 to ${MAX_PAGE_LIMIT}.`);\n const level = await listKnowledgeTreeChildren(view.store, {\n parentId: parentId ?? null,\n read: view.read,\n cursor,\n limit,\n });\n return c.json({ ...level, pages: level.pages.map(page => withDisplayLabel(view.knowledge, page)) });\n },\n }),\n registerApiRoute('/web/factory/projects/:id/knowledge/pages/:pageId', {\n method: 'GET',\n requiresAuth: false,\n handler: async raw => {\n const c = loose(raw);\n const view = await this.#resolveView(c);\n if ('response' in view) return view.response;\n const pageId = boundedId(c.req.param('pageId'));\n if (!pageId) return c.json({ error: 'page_not_found' }, 404);\n const noteLimit = boundedLimit(c.req.query('noteLimit'), MAX_PAGE_LIMIT);\n if (noteLimit === null) return badRequest(c, `noteLimit must be an integer from 1 to ${MAX_PAGE_LIMIT}.`);\n const page = await readKnowledgePage(view.store, {\n pageId,\n read: view.read,\n noteCursor: boundedId(c.req.query('noteCursor')),\n noteLimit,\n });\n if (!page) return c.json({ error: 'page_not_found' }, 404);\n const label = <T extends LabelablePage>(entry: T) => withDisplayLabel(view.knowledge, entry);\n return c.json({\n ...page,\n page: label(page.page),\n ancestors: page.ancestors.map(label),\n related: page.related.map(label),\n });\n },\n }),\n registerApiRoute('/web/factory/projects/:id/knowledge/graph', {\n method: 'GET',\n requiresAuth: false,\n handler: async raw => {\n const c = loose(raw);\n const view = await this.#resolveView(c);\n if ('response' in view) return view.response;\n const maxPages = boundedLimit(c.req.query('maxPages'), MAX_GRAPH_PAGES);\n if (maxPages === null) return badRequest(c, `maxPages must be an integer from 1 to ${MAX_GRAPH_PAGES}.`);\n const graph = await readKnowledgePageGraph(view.store, {\n read: view.read,\n rootId: boundedId(c.req.query('rootId')) ?? null,\n ...(maxPages ? { limits: { maxPages } } : {}),\n });\n if (!graph) return c.json({ error: 'page_not_found' }, 404);\n // Declared grants between the scopes shown, limited to principal scopes this caller can read.\n const grants = await readKnowledgeScopeGrants(view.store, {\n pages: graph.pages,\n read: view.read,\n grantsFor: scope => view.knowledge.scopeGrants(scope),\n });\n return c.json({\n ...graph,\n pages: graph.pages.map(page => withDisplayLabel(view.knowledge, page)),\n grants: grants.map(grant => {\n const principalLabel = view.knowledge.scopeLabel(grant.principal);\n return principalLabel ? { ...grant, principalLabel } : grant;\n }),\n });\n },\n }),\n registerApiRoute('/web/factory/projects/:id/knowledge/search', {\n method: 'GET',\n requiresAuth: false,\n handler: async raw => {\n const c = loose(raw);\n const view = await this.#resolveView(c);\n if ('response' in view) return view.response;\n const query = (c.req.query('q') ?? '').trim();\n if (!query) return c.json({ results: [] });\n if (query.length > SEARCH_QUERY_LIMIT) {\n return badRequest(c, `q must be at most ${SEARCH_QUERY_LIMIT} characters.`);\n }\n const limit = boundedLimit(c.req.query('limit'), MAX_PAGE_LIMIT);\n if (limit === null) return badRequest(c, `limit must be an integer from 1 to ${MAX_PAGE_LIMIT}.`);\n const scopeIds = c.req.queries('scopeId')?.flatMap(id => boundedId(id) ?? []);\n const results = await searchKnowledgeExplorerPages(view.store, {\n query,\n read: view.read,\n ...(scopeIds?.length ? { scopeIds } : {}),\n limit,\n });\n return c.json({\n results: results.map(hit => ({ ...hit, page: withDisplayLabel(view.knowledge, hit.page) })),\n });\n },\n }),\n registerApiRoute('/web/factory/projects/:id/knowledge/events', {\n method: 'GET',\n requiresAuth: false,\n handler: async raw => {\n const c = loose(raw);\n const view = await this.#resolveView(c);\n if ('response' in view) return view.response;\n const { knowledge, store, read } = view;\n return streamSSE(c, async stream => {\n const closed = new Promise<void>(resolve => stream.onAbort(resolve));\n // Filtering reads the store, so changes are queued to keep them in commit order.\n let queue = Promise.resolve();\n const unsubscribe = knowledge.onChange(event => {\n queue = queue.then(async () => {\n if (stream.aborted) return;\n const change = await visibleChange(store, read, event).catch(() => null);\n if (!change || stream.aborted) return;\n try {\n await stream.writeSSE({ event: 'change', data: JSON.stringify(change) });\n } catch {\n // The tab went away mid-write; abort cleans up.\n }\n });\n });\n const keepalive = setInterval(() => {\n if (!stream.aborted) void stream.write(': ping\\n\\n');\n }, EVENTS_KEEPALIVE_MS);\n let expire: ReturnType<typeof setTimeout> | undefined;\n try {\n await stream.write(': connected\\n\\n');\n // `streamSSE` closes the stream the moment this callback returns.\n await Promise.race([\n closed,\n new Promise<void>(resolve => (expire = setTimeout(resolve, EVENTS_MAX_AGE_MS))),\n ]);\n } finally {\n clearTimeout(expire);\n clearInterval(keepalive);\n unsubscribe();\n }\n });\n },\n }),\n registerApiRoute('/web/factory/projects/:id/knowledge/activity', {\n method: 'GET',\n requiresAuth: false,\n handler: async raw => {\n const c = loose(raw);\n const view = await this.#resolveView(c);\n if ('response' in view) return view.response;\n const limit = boundedLimit(c.req.query('limit'), MAX_PAGE_LIMIT);\n if (limit === null) return badRequest(c, `limit must be an integer from 1 to ${MAX_PAGE_LIMIT}.`);\n return c.json(\n await readKnowledgePageActivity(view.store, {\n read: view.read,\n scopeId: boundedId(c.req.query('scopeId')),\n pageId: boundedId(c.req.query('pageId')),\n cursor: boundedId(c.req.query('cursor')),\n limit,\n }),\n );\n },\n }),\n ];\n }\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import type { WorkItemsStorage } from '../storage/domains/work-items/base.js';
|
|
2
|
+
import type { RunQueueResponse } from './contracts.js';
|
|
3
|
+
/**
|
|
4
|
+
* The project's run-bearing decisions in the order the dispatcher claims them (oldest first),
|
|
5
|
+
* split into those waiting for a slot and those a server already holds one for.
|
|
6
|
+
*/
|
|
7
|
+
export declare function readRunQueue(input: {
|
|
8
|
+
workItems: WorkItemsStorage;
|
|
9
|
+
orgId: string;
|
|
10
|
+
factoryProjectId: string;
|
|
11
|
+
slots: {
|
|
12
|
+
inUse: number;
|
|
13
|
+
cap: number;
|
|
14
|
+
} | undefined;
|
|
15
|
+
now: Date;
|
|
16
|
+
}): Promise<RunQueueResponse>;
|
|
17
|
+
//# sourceMappingURL=run-queue.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"run-queue.d.ts","sourceRoot":"","sources":["../../src/routes/run-queue.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAuC,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AACnH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AA+CvD;;;GAGG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE;IACxC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAClD,GAAG,EAAE,IAAI,CAAC;CACX,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAiB5B"}
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
import { isRunBearingDecision } from "../rules/dispatcher.js";
|
|
2
|
+
import { currentStage } from "../rules/transition-service.js";
|
|
3
|
+
// src/routes/run-queue.ts
|
|
4
|
+
const LISTED_WAITING_RUNS = 50;
|
|
5
|
+
/** A lease past its expiry belongs to a server that stopped renewing it: the next claim takes it back. */
|
|
6
|
+
function holdsSlot(decision, now) {
|
|
7
|
+
return decision.status === "leased" && (decision.leaseExpiresAt?.getTime() ?? 0) > now.getTime();
|
|
8
|
+
}
|
|
9
|
+
function waitsForSlot(decision, now) {
|
|
10
|
+
if (decision.status === "leased") return !holdsSlot(decision, now);
|
|
11
|
+
return decision.availableAt.getTime() <= now.getTime();
|
|
12
|
+
}
|
|
13
|
+
function entry(decision, state, cards) {
|
|
14
|
+
const payload = decision.decision;
|
|
15
|
+
const card = decision.workItemId ? cards.get(decision.workItemId) : void 0;
|
|
16
|
+
const since = state === "claimed" ? decision.updatedAt : new Date(Math.max(decision.createdAt.getTime(), decision.availableAt.getTime()));
|
|
17
|
+
return {
|
|
18
|
+
decisionId: decision.id,
|
|
19
|
+
state,
|
|
20
|
+
type: payload.type,
|
|
21
|
+
role: typeof payload.role === "string" ? payload.role : null,
|
|
22
|
+
skillName: payload.type === "invokeSkill" && typeof payload.skillName === "string" ? payload.skillName : null,
|
|
23
|
+
queuedSince: since.toISOString(),
|
|
24
|
+
workItem: card ? {
|
|
25
|
+
id: card.id,
|
|
26
|
+
key: card.workItem.key,
|
|
27
|
+
title: card.title,
|
|
28
|
+
board: card.board,
|
|
29
|
+
phase: currentStage(card.stages) ?? null
|
|
30
|
+
} : null
|
|
31
|
+
};
|
|
32
|
+
}
|
|
33
|
+
/**
|
|
34
|
+
* The project's run-bearing decisions in the order the dispatcher claims them (oldest first),
|
|
35
|
+
* split into those waiting for a slot and those a server already holds one for.
|
|
36
|
+
*/
|
|
37
|
+
async function readRunQueue(input) {
|
|
38
|
+
const { workItems, orgId, factoryProjectId, now } = input;
|
|
39
|
+
const open = (await workItems.listDeferredDecisions(orgId, factoryProjectId, { statuses: [
|
|
40
|
+
"pending",
|
|
41
|
+
"retry",
|
|
42
|
+
"leased"
|
|
43
|
+
] })).filter((decision) => isRunBearingDecision(decision.decision));
|
|
44
|
+
const claimed = open.filter((decision) => holdsSlot(decision, now));
|
|
45
|
+
const waiting = open.filter((decision) => waitsForSlot(decision, now));
|
|
46
|
+
const listed = waiting.slice(0, LISTED_WAITING_RUNS);
|
|
47
|
+
const ids = [...claimed, ...listed].flatMap((decision) => decision.workItemId ? [decision.workItemId] : []);
|
|
48
|
+
const cards = new Map((await workItems.listByIds({
|
|
49
|
+
orgId,
|
|
50
|
+
factoryProjectId,
|
|
51
|
+
ids
|
|
52
|
+
})).map((card) => [card.id, card]));
|
|
53
|
+
return {
|
|
54
|
+
slots: input.slots ? {
|
|
55
|
+
scope: "server",
|
|
56
|
+
...input.slots
|
|
57
|
+
} : null,
|
|
58
|
+
running: claimed.length,
|
|
59
|
+
claimed: claimed.map((decision) => entry(decision, "claimed", cards)),
|
|
60
|
+
queuedCount: waiting.length,
|
|
61
|
+
queued: listed.map((decision, index) => ({
|
|
62
|
+
...entry(decision, "waiting", cards),
|
|
63
|
+
position: index + 1
|
|
64
|
+
}))
|
|
65
|
+
};
|
|
66
|
+
}
|
|
67
|
+
export { readRunQueue };
|
|
68
|
+
|
|
69
|
+
//# sourceMappingURL=run-queue.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"run-queue.js","names":[],"sources":["../../src/routes/run-queue.ts"],"sourcesContent":["import { isRunBearingDecision } from '../rules/dispatcher.js';\nimport { currentStage } from '../rules/transition-service.js';\nimport type { Card, FactoryDeferredDecisionRecord, WorkItemsStorage } from '../storage/domains/work-items/base.js';\nimport type { RunQueueResponse } from './contracts.js';\n\nconst LISTED_WAITING_RUNS = 50;\n\ntype RunQueueEntry = RunQueueResponse['claimed'][number];\n\n/** A lease past its expiry belongs to a server that stopped renewing it: the next claim takes it back. */\nfunction holdsSlot(decision: FactoryDeferredDecisionRecord, now: Date): boolean {\n return decision.status === 'leased' && (decision.leaseExpiresAt?.getTime() ?? 0) > now.getTime();\n}\n\nfunction waitsForSlot(decision: FactoryDeferredDecisionRecord, now: Date): boolean {\n if (decision.status === 'leased') return !holdsSlot(decision, now);\n // A postponed move or a retry backing off is not waiting on a slot yet.\n return decision.availableAt.getTime() <= now.getTime();\n}\n\nfunction entry(\n decision: FactoryDeferredDecisionRecord,\n state: RunQueueEntry['state'],\n cards: ReadonlyMap<string, Card>,\n): RunQueueEntry {\n const payload = decision.decision;\n const card = decision.workItemId ? cards.get(decision.workItemId) : undefined;\n const since =\n state === 'claimed'\n ? decision.updatedAt\n : new Date(Math.max(decision.createdAt.getTime(), decision.availableAt.getTime()));\n return {\n decisionId: decision.id,\n state,\n type: payload.type as RunQueueEntry['type'],\n role: typeof payload.role === 'string' ? payload.role : null,\n skillName: payload.type === 'invokeSkill' && typeof payload.skillName === 'string' ? payload.skillName : null,\n queuedSince: since.toISOString(),\n workItem: card\n ? {\n id: card.id,\n key: card.workItem.key,\n title: card.title,\n board: card.board,\n phase: currentStage(card.stages) ?? null,\n }\n : null,\n };\n}\n\n/**\n * The project's run-bearing decisions in the order the dispatcher claims them (oldest first),\n * split into those waiting for a slot and those a server already holds one for.\n */\nexport async function readRunQueue(input: {\n workItems: WorkItemsStorage;\n orgId: string;\n factoryProjectId: string;\n slots: { inUse: number; cap: number } | undefined;\n now: Date;\n}): Promise<RunQueueResponse> {\n const { workItems, orgId, factoryProjectId, now } = input;\n const open = (\n await workItems.listDeferredDecisions(orgId, factoryProjectId, { statuses: ['pending', 'retry', 'leased'] })\n ).filter(decision => isRunBearingDecision(decision.decision));\n const claimed = open.filter(decision => holdsSlot(decision, now));\n const waiting = open.filter(decision => waitsForSlot(decision, now));\n const listed = waiting.slice(0, LISTED_WAITING_RUNS);\n const ids = [...claimed, ...listed].flatMap(decision => (decision.workItemId ? [decision.workItemId] : []));\n const cards = new Map((await workItems.listByIds({ orgId, factoryProjectId, ids })).map(card => [card.id, card]));\n return {\n slots: input.slots ? { scope: 'server', ...input.slots } : null,\n running: claimed.length,\n claimed: claimed.map(decision => entry(decision, 'claimed', cards)),\n queuedCount: waiting.length,\n queued: listed.map((decision, index) => ({ ...entry(decision, 'waiting', cards), position: index + 1 })),\n };\n}\n"],"mappings":";;;AAKA,MAAM,sBAAsB;;AAK5B,SAAS,UAAU,UAAyC,KAAoB;CAC9E,OAAO,SAAS,WAAW,aAAa,SAAS,gBAAgB,QAAQ,KAAK,KAAK,IAAI,QAAQ;AACjG;AAEA,SAAS,aAAa,UAAyC,KAAoB;CACjF,IAAI,SAAS,WAAW,UAAU,OAAO,CAAC,UAAU,UAAU,GAAG;CAEjE,OAAO,SAAS,YAAY,QAAQ,KAAK,IAAI,QAAQ;AACvD;AAEA,SAAS,MACP,UACA,OACA,OACe;CACf,MAAM,UAAU,SAAS;CACzB,MAAM,OAAO,SAAS,aAAa,MAAM,IAAI,SAAS,UAAU,IAAI,KAAA;CACpE,MAAM,QACJ,UAAU,YACN,SAAS,YACT,IAAI,KAAK,KAAK,IAAI,SAAS,UAAU,QAAQ,GAAG,SAAS,YAAY,QAAQ,CAAC,CAAC;CACrF,OAAO;EACL,YAAY,SAAS;EACrB;EACA,MAAM,QAAQ;EACd,MAAM,OAAO,QAAQ,SAAS,WAAW,QAAQ,OAAO;EACxD,WAAW,QAAQ,SAAS,iBAAiB,OAAO,QAAQ,cAAc,WAAW,QAAQ,YAAY;EACzG,aAAa,MAAM,YAAY;EAC/B,UAAU,OACN;GACE,IAAI,KAAK;GACT,KAAK,KAAK,SAAS;GACnB,OAAO,KAAK;GACZ,OAAO,KAAK;GACZ,OAAO,aAAa,KAAK,MAAM,KAAK;EACtC,IACA;CACN;AACF;;;;;AAMA,eAAsB,aAAa,OAML;CAC5B,MAAM,EAAE,WAAW,OAAO,kBAAkB,QAAQ;CACpD,MAAM,QACJ,MAAM,UAAU,sBAAsB,OAAO,kBAAkB,EAAE,UAAU;EAAC;EAAW;EAAS;CAAQ,EAAE,CAAC,EAAA,CAC3G,QAAO,aAAY,qBAAqB,SAAS,QAAQ,CAAC;CAC5D,MAAM,UAAU,KAAK,QAAO,aAAY,UAAU,UAAU,GAAG,CAAC;CAChE,MAAM,UAAU,KAAK,QAAO,aAAY,aAAa,UAAU,GAAG,CAAC;CACnE,MAAM,SAAS,QAAQ,MAAM,GAAG,mBAAmB;CACnD,MAAM,MAAM,CAAC,GAAG,SAAS,GAAG,MAAM,CAAC,CAAC,SAAQ,aAAa,SAAS,aAAa,CAAC,SAAS,UAAU,IAAI,CAAC,CAAE;CAC1G,MAAM,QAAQ,IAAI,KAAK,MAAM,UAAU,UAAU;EAAE;EAAO;EAAkB;CAAI,CAAC,EAAA,CAAG,KAAI,SAAQ,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;CAChH,OAAO;EACL,OAAO,MAAM,QAAQ;GAAE,OAAO;GAAU,GAAG,MAAM;EAAM,IAAI;EAC3D,SAAS,QAAQ;EACjB,SAAS,QAAQ,KAAI,aAAY,MAAM,UAAU,WAAW,KAAK,CAAC;EAClE,aAAa,QAAQ;EACrB,QAAQ,OAAO,KAAK,UAAU,WAAW;GAAE,GAAG,MAAM,UAAU,WAAW,KAAK;GAAG,UAAU,QAAQ;EAAE,EAAE;CACzG;AACF"}
|
|
@@ -25,7 +25,7 @@ export interface SourceControlSessionRoutesOptions {
|
|
|
25
25
|
filesystem?: Pick<FilesystemStorage, 'deleteResourceFiles'>;
|
|
26
26
|
/** How long recreate waits for an aborted run to settle before destroying. */
|
|
27
27
|
abortSettleTimeoutMs?: number;
|
|
28
|
-
workItems?: Pick<WorkItemsStorage, 'clearSessionReferences' | 'hasRunBindingForSession'
|
|
28
|
+
workItems?: Pick<WorkItemsStorage, 'clearSessionReferences' | 'hasRunBindingForSession'> & Partial<Pick<WorkItemsStorage, 'listProjectSubscriptions' | 'listWorkItemSubscribers' | 'findActiveRunBindingForSession' | 'get'>>;
|
|
29
29
|
/** Moves a thread, with everything keyed by its resource, when a session's visibility changes. */
|
|
30
30
|
moveThread?: (input: {
|
|
31
31
|
threadId: string;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"source-control-sessions.d.ts","sourceRoot":"","sources":["../../src/routes/source-control-sessions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;
|
|
1
|
+
{"version":3,"file":"source-control-sessions.d.ts","sourceRoot":"","sources":["../../src/routes/source-control-sessions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG1D,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AASnE,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,kCAAkC,CAAC;AAarF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AAExF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,KAAK,EAGV,0BAA0B,EAC3B,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAG9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAK5C,eAAO,MAAM,0BAA0B,kBAAkB,CAAC;AAc1D,KAAK,wBAAwB,GAAG,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC,CAAC;AAE1G,MAAM,WAAW,iCAAiC;IAChD,IAAI,EAAE,SAAS,CAAC;IAChB,cAAc,EAAE,SAAS,0BAA0B,EAAE,CAAC;IACtD,QAAQ,EAAE,IAAI,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;IAC9C,KAAK,CAAC,EAAE,wBAAwB,CAAC;IACjC,UAAU,CAAC,EAAE,iBAAiB,CAAC,YAAY,CAAC,CAAC;IAC7C,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,cAAc,EAAE,IAAI,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;IACnD,iBAAiB,CAAC,EAAE,4BAA4B,CAAC;IACjD,mFAAmF;IACnF,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,sGAAsG;IACtG,UAAU,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,qBAAqB,CAAC,CAAC;IAC5D,8EAA8E;IAC9E,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAS,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,wBAAwB,GAAG,yBAAyB,CAAC,GACtF,OAAO,CACL,IAAI,CACF,gBAAgB,EAChB,0BAA0B,GAAG,yBAAyB,GAAG,gCAAgC,GAAG,KAAK,CAClG,CACF,CAAC;IACJ,kGAAkG;IAClG,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACpF;AA6eD,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,iCAAiC,GAAG,QAAQ,EAAE,CAgetG"}
|
|
@@ -5,10 +5,13 @@ import { seedSessionOrg } from "../session/org-seed.js";
|
|
|
5
5
|
import { isRunBound, isWorkerSession, listFactorySessionThreads, sessionMemoryResourceId, sessionThreadsToMove, userSessionResourceFor } from "../session/session-threads.js";
|
|
6
6
|
import { normalizeSessionTitle } from "../session/session-title.js";
|
|
7
7
|
import { SESSION_OWNER_SIGNAL_TAG } from "../session-owner-signal.js";
|
|
8
|
+
import { isFactoryPrincipalId } from "../storage/domains/projects/base.js";
|
|
9
|
+
import { answerParkedCall } from "../tools/approval-tools.js";
|
|
8
10
|
import { loose } from "./route.js";
|
|
9
11
|
import { canReadSessionResource, canSwitchSessionModel, canViewSourceControlSession } from "./session-access.js";
|
|
10
12
|
import { RequestContext } from "@mastra/core/request-context";
|
|
11
13
|
import { registerApiRoute } from "@mastra/core/server";
|
|
14
|
+
import { z } from "zod";
|
|
12
15
|
import { UniqueViolationError } from "@mastra/core/storage";
|
|
13
16
|
import { resolveModel } from "@mastra/code-sdk/agents/model";
|
|
14
17
|
import { createSignal } from "@mastra/core/signals";
|
|
@@ -33,6 +36,31 @@ async function sessionManagePermission(c, auth, tenant, session) {
|
|
|
33
36
|
if (isOwner) return "allowed";
|
|
34
37
|
return await auth.isOrganizationAdmin(c, session.orgId) ? "allowed" : "forbidden";
|
|
35
38
|
}
|
|
39
|
+
const parkedApprovalAnswerSchema = z.object({
|
|
40
|
+
decision: z.enum(["approve", "decline"]),
|
|
41
|
+
reason: z.string().trim().min(1).max(1e3).optional(),
|
|
42
|
+
toolCallId: z.string().trim().min(1).max(200).optional()
|
|
43
|
+
}).strict();
|
|
44
|
+
/** Whether the viewer asked for the card's work: they filed it, or a session of theirs follows it. */
|
|
45
|
+
async function followsCard(options, workItemId, tenant) {
|
|
46
|
+
const workItems = options.workItems;
|
|
47
|
+
if (!workItemId || !workItems?.get || !workItems.listWorkItemSubscribers) return false;
|
|
48
|
+
const item = await workItems.get({
|
|
49
|
+
orgId: tenant.orgId,
|
|
50
|
+
id: workItemId
|
|
51
|
+
});
|
|
52
|
+
if (!item) return false;
|
|
53
|
+
if (item.createdBy === tenant.userId) return true;
|
|
54
|
+
const followers = await workItems.listWorkItemSubscribers({
|
|
55
|
+
orgId: tenant.orgId,
|
|
56
|
+
workItemId
|
|
57
|
+
});
|
|
58
|
+
for (const sessionId of new Set(followers.map((follower) => follower.sessionId))) {
|
|
59
|
+
const following = (await resolveSession(options.sourceControls, sessionId))?.session;
|
|
60
|
+
if (following?.orgId === tenant.orgId && following.userId === tenant.userId) return true;
|
|
61
|
+
}
|
|
62
|
+
return false;
|
|
63
|
+
}
|
|
36
64
|
function canRecreateSandbox(options) {
|
|
37
65
|
return Boolean(options.sessionRetirement) && options.sandboxRecreateSupported === true;
|
|
38
66
|
}
|
|
@@ -220,9 +248,13 @@ function createSessionOwnerProfileResolver(users) {
|
|
|
220
248
|
}
|
|
221
249
|
};
|
|
222
250
|
return async (userIds) => {
|
|
223
|
-
if (!users) return /* @__PURE__ */ new Map();
|
|
224
|
-
const requestedUserIds = [...new Set(userIds)].slice(0, MAX_SESSION_OWNER_PROFILES);
|
|
225
251
|
const profiles = /* @__PURE__ */ new Map();
|
|
252
|
+
for (const userId of userIds) if (isFactoryPrincipalId(userId)) profiles.set(userId, {
|
|
253
|
+
id: userId,
|
|
254
|
+
name: "Factory"
|
|
255
|
+
});
|
|
256
|
+
if (!users) return profiles;
|
|
257
|
+
const requestedUserIds = [...new Set(userIds)].filter((userId) => !isFactoryPrincipalId(userId)).slice(0, MAX_SESSION_OWNER_PROFILES);
|
|
226
258
|
const unresolvedUserIds = [];
|
|
227
259
|
const now = Date.now();
|
|
228
260
|
for (const userId of requestedUserIds) {
|
|
@@ -373,7 +405,81 @@ function buildSourceControlSessionRoutes(options) {
|
|
|
373
405
|
viewerUserId: userId
|
|
374
406
|
})))).flat();
|
|
375
407
|
const owners = await resolveOwnerProfiles(sessions.map((session) => session.userId));
|
|
376
|
-
|
|
408
|
+
const followed = /* @__PURE__ */ new Map();
|
|
409
|
+
for (const link of await options.workItems?.listProjectSubscriptions?.({
|
|
410
|
+
orgId,
|
|
411
|
+
factoryProjectId: project.id
|
|
412
|
+
}) ?? []) {
|
|
413
|
+
const workItemIds = followed.get(link.sessionId);
|
|
414
|
+
if (workItemIds) workItemIds.push(link.workItemId);
|
|
415
|
+
else followed.set(link.sessionId, [link.workItemId]);
|
|
416
|
+
}
|
|
417
|
+
return c.json({ sessions: sessions.map((session) => ({
|
|
418
|
+
...withOwnerProfile(session, owners),
|
|
419
|
+
followedWorkItemIds: followed.get(session.sessionId) ?? []
|
|
420
|
+
})) });
|
|
421
|
+
}
|
|
422
|
+
}),
|
|
423
|
+
registerApiRoute("/web/user-sessions/:sessionId/parked-approval", {
|
|
424
|
+
method: "POST",
|
|
425
|
+
requiresAuth: false,
|
|
426
|
+
handler: async (c) => {
|
|
427
|
+
const resolved = await resolveOrgTenant(loose(c), options.auth);
|
|
428
|
+
if ("response" in resolved) return resolved.response;
|
|
429
|
+
const body = parkedApprovalAnswerSchema.safeParse(await c.req.json().catch(() => null));
|
|
430
|
+
if (!body.success) return c.json({ error: "Send a decision of \"approve\" or \"decline\", and optionally a reason and toolCallId." }, 400);
|
|
431
|
+
const session = (await resolveSession(options.sourceControls, c.req.param("sessionId")))?.session;
|
|
432
|
+
if (!session) return c.json({ error: "Session not found" }, 404);
|
|
433
|
+
const permission = await sessionManagePermission(loose(c), options.auth, resolved.tenant, session);
|
|
434
|
+
if (permission === "not-found") return c.json({ error: "Session not found" }, 404);
|
|
435
|
+
const binding = session.factoryProjectId && options.workItems?.findActiveRunBindingForSession ? await options.workItems.findActiveRunBindingForSession({
|
|
436
|
+
orgId: session.orgId,
|
|
437
|
+
factoryProjectId: session.factoryProjectId,
|
|
438
|
+
sessionId: session.sessionId
|
|
439
|
+
}) : null;
|
|
440
|
+
if (permission !== "allowed" && !await followsCard(options, binding?.workItemId, resolved.tenant)) return c.json({ error: "Only the session's owner, an organization admin, or someone following its card can answer." }, 403);
|
|
441
|
+
const controller = options.controller;
|
|
442
|
+
if (!controller) return c.json({ error: "Sessions are not available on this server." }, 503);
|
|
443
|
+
const { decision, reason } = body.data;
|
|
444
|
+
let answered;
|
|
445
|
+
try {
|
|
446
|
+
answered = await answerParkedCall({ messaging: async () => ({ controller }) }, {
|
|
447
|
+
session,
|
|
448
|
+
...body.data.toolCallId ? { toolCallId: body.data.toolCallId } : {},
|
|
449
|
+
decision,
|
|
450
|
+
declineReason: reason ?? "Declined from the card."
|
|
451
|
+
});
|
|
452
|
+
} catch (error) {
|
|
453
|
+
return c.json({ error: error instanceof Error ? error.message : String(error) }, 409);
|
|
454
|
+
}
|
|
455
|
+
const { toolCallId, toolName } = answered;
|
|
456
|
+
await options.audit?.record({
|
|
457
|
+
orgId: session.orgId,
|
|
458
|
+
actorId: resolved.tenant.userId,
|
|
459
|
+
actorType: "human",
|
|
460
|
+
action: decision === "approve" ? "factory.run.approved" : "factory.run.dismissed",
|
|
461
|
+
...session.factoryProjectId ? { factoryProjectId: session.factoryProjectId } : {},
|
|
462
|
+
targets: [{
|
|
463
|
+
type: "session",
|
|
464
|
+
id: session.sessionId
|
|
465
|
+
}, ...binding ? [{
|
|
466
|
+
type: "work_item",
|
|
467
|
+
id: binding.workItemId
|
|
468
|
+
}] : []],
|
|
469
|
+
metadata: {
|
|
470
|
+
toolCallId,
|
|
471
|
+
toolName,
|
|
472
|
+
sessionId: session.sessionId,
|
|
473
|
+
decision,
|
|
474
|
+
cause: "web"
|
|
475
|
+
}
|
|
476
|
+
});
|
|
477
|
+
return c.json({
|
|
478
|
+
answered: decision,
|
|
479
|
+
sessionId: session.sessionId,
|
|
480
|
+
toolCallId,
|
|
481
|
+
toolName
|
|
482
|
+
});
|
|
377
483
|
}
|
|
378
484
|
}),
|
|
379
485
|
...projectSessionRoutes("/web/source-control/projects/:id/sessions", options, resolveOwnerProfiles),
|