@mastra/factory 0.28.0-alpha.0 → 0.28.0-alpha.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +210 -42
- package/dist/boards/board-events.d.ts +34 -0
- package/dist/boards/board-events.d.ts.map +1 -0
- package/dist/boards/board-events.js +50 -0
- package/dist/boards/board-events.js.map +1 -0
- package/dist/boards/board-writes.d.ts +86 -0
- package/dist/boards/board-writes.d.ts.map +1 -0
- package/dist/boards/board-writes.js +252 -0
- package/dist/boards/board-writes.js.map +1 -0
- package/dist/boards/define-board.d.ts +16 -5
- package/dist/boards/define-board.d.ts.map +1 -1
- package/dist/boards/define-board.js +30 -8
- package/dist/boards/define-board.js.map +1 -1
- package/dist/boards/intake-routing.d.ts +30 -6
- package/dist/boards/intake-routing.d.ts.map +1 -1
- package/dist/boards/intake-routing.js +43 -5
- package/dist/boards/intake-routing.js.map +1 -1
- package/dist/boards/legacy-plan-role.d.ts.map +1 -1
- package/dist/boards/legacy-plan-role.js +8 -4
- package/dist/boards/legacy-plan-role.js.map +1 -1
- package/dist/boards/phase-automation.d.ts.map +1 -1
- package/dist/boards/phase-automation.js +7 -2
- package/dist/boards/phase-automation.js.map +1 -1
- package/dist/boards/project-boards.d.ts +18 -7
- package/dist/boards/project-boards.d.ts.map +1 -1
- package/dist/boards/project-boards.js +78 -14
- package/dist/boards/project-boards.js.map +1 -1
- package/dist/boards/stored-board.d.ts +59 -1
- package/dist/boards/stored-board.d.ts.map +1 -1
- package/dist/boards/stored-board.js +219 -7
- package/dist/boards/stored-board.js.map +1 -1
- package/dist/factory.d.ts +63 -9
- package/dist/factory.d.ts.map +1 -1
- package/dist/factory.js +187 -22
- package/dist/factory.js.map +1 -1
- package/dist/index.d.ts +3 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +4 -3
- package/dist/integrations/base.d.ts +6 -0
- package/dist/integrations/base.d.ts.map +1 -1
- package/dist/integrations/github/acceptance-labels.d.ts +4 -0
- package/dist/integrations/github/acceptance-labels.d.ts.map +1 -1
- package/dist/integrations/github/acceptance-labels.js +1 -1
- package/dist/integrations/github/acceptance-labels.js.map +1 -1
- package/dist/integrations/github/default-rules.d.ts +2 -9
- package/dist/integrations/github/default-rules.d.ts.map +1 -1
- package/dist/integrations/github/default-rules.js +7 -6
- package/dist/integrations/github/default-rules.js.map +1 -1
- package/dist/integrations/github/issue-reconciler.d.ts.map +1 -1
- package/dist/integrations/github/issue-reconciler.js +17 -1
- package/dist/integrations/github/issue-reconciler.js.map +1 -1
- package/dist/integrations/github/review-status-comment.d.ts +61 -0
- package/dist/integrations/github/review-status-comment.d.ts.map +1 -0
- package/dist/integrations/github/review-status-comment.js +217 -0
- package/dist/integrations/github/review-status-comment.js.map +1 -0
- package/dist/integrations/github/review-status-reporter.d.ts +42 -0
- package/dist/integrations/github/review-status-reporter.d.ts.map +1 -0
- package/dist/integrations/github/review-status-reporter.js +100 -0
- package/dist/integrations/github/review-status-reporter.js.map +1 -0
- package/dist/integrations/github/review-status.d.ts +28 -0
- package/dist/integrations/github/review-status.d.ts.map +1 -0
- package/dist/integrations/github/review-status.js +95 -0
- package/dist/integrations/github/review-status.js.map +1 -0
- package/dist/integrations/github/routes.d.ts.map +1 -1
- package/dist/integrations/github/routes.js +2 -5
- package/dist/integrations/github/routes.js.map +1 -1
- package/dist/integrations/github/rules.d.ts +13 -1
- package/dist/integrations/github/rules.d.ts.map +1 -1
- package/dist/integrations/github/rules.js +77 -6
- package/dist/integrations/github/rules.js.map +1 -1
- package/dist/integrations/gitlab/default-rules.d.ts +24 -9
- package/dist/integrations/gitlab/default-rules.d.ts.map +1 -1
- package/dist/integrations/gitlab/default-rules.js +4 -4
- package/dist/integrations/gitlab/default-rules.js.map +1 -1
- package/dist/integrations/gitlab/merge-request-reconciler.js +1 -1
- package/dist/integrations/gitlab/routes.d.ts.map +1 -1
- package/dist/integrations/gitlab/routes.js +1 -3
- package/dist/integrations/gitlab/routes.js.map +1 -1
- package/dist/integrations/gitlab/rules.d.ts +16 -0
- package/dist/integrations/gitlab/rules.d.ts.map +1 -1
- package/dist/integrations/gitlab/rules.js +69 -4
- package/dist/integrations/gitlab/rules.js.map +1 -1
- package/dist/integrations/incidentio/default-rules.d.ts +1 -9
- package/dist/integrations/incidentio/default-rules.d.ts.map +1 -1
- package/dist/integrations/incidentio/default-rules.js +3 -4
- package/dist/integrations/incidentio/default-rules.js.map +1 -1
- package/dist/integrations/incidentio/routes.d.ts.map +1 -1
- package/dist/integrations/incidentio/routes.js +1 -4
- package/dist/integrations/incidentio/routes.js.map +1 -1
- package/dist/integrations/incidentio/rules.d.ts +7 -0
- package/dist/integrations/incidentio/rules.d.ts.map +1 -1
- package/dist/integrations/incidentio/rules.js +35 -3
- package/dist/integrations/incidentio/rules.js.map +1 -1
- package/dist/integrations/jira/default-rules.d.ts +1 -9
- package/dist/integrations/jira/default-rules.d.ts.map +1 -1
- package/dist/integrations/jira/default-rules.js +3 -4
- package/dist/integrations/jira/default-rules.js.map +1 -1
- package/dist/integrations/jira/routes.d.ts.map +1 -1
- package/dist/integrations/jira/routes.js +1 -4
- package/dist/integrations/jira/routes.js.map +1 -1
- package/dist/integrations/jira/rules.d.ts +7 -0
- package/dist/integrations/jira/rules.d.ts.map +1 -1
- package/dist/integrations/jira/rules.js +35 -3
- package/dist/integrations/jira/rules.js.map +1 -1
- package/dist/integrations/linear/default-rules.d.ts +1 -9
- package/dist/integrations/linear/default-rules.d.ts.map +1 -1
- package/dist/integrations/linear/default-rules.js +3 -4
- package/dist/integrations/linear/default-rules.js.map +1 -1
- package/dist/integrations/linear/routes.d.ts.map +1 -1
- package/dist/integrations/linear/routes.js +1 -4
- package/dist/integrations/linear/routes.js.map +1 -1
- package/dist/integrations/linear/rules.d.ts +7 -0
- package/dist/integrations/linear/rules.d.ts.map +1 -1
- package/dist/integrations/linear/rules.js +35 -3
- package/dist/integrations/linear/rules.js.map +1 -1
- package/dist/integrations/platform/connect/routes.d.ts +7 -1
- package/dist/integrations/platform/connect/routes.d.ts.map +1 -1
- package/dist/integrations/platform/connect/routes.js +42 -5
- package/dist/integrations/platform/connect/routes.js.map +1 -1
- package/dist/integrations/platform/connect/session-tools.d.ts +7 -0
- package/dist/integrations/platform/connect/session-tools.d.ts.map +1 -0
- package/dist/integrations/platform/connect/session-tools.js +30 -0
- package/dist/integrations/platform/connect/session-tools.js.map +1 -0
- package/dist/integrations/platform/github/integration.d.ts.map +1 -1
- package/dist/integrations/platform/github/integration.js +1 -3
- package/dist/integrations/platform/github/integration.js.map +1 -1
- package/dist/integrations/platform/jira/routes.d.ts.map +1 -1
- package/dist/integrations/platform/jira/routes.js +1 -4
- package/dist/integrations/platform/jira/routes.js.map +1 -1
- package/dist/integrations/platform/linear/event-worker.d.ts +1 -1
- package/dist/integrations/platform/linear/event-worker.d.ts.map +1 -1
- package/dist/integrations/platform/linear/event-worker.js +9 -0
- package/dist/integrations/platform/linear/event-worker.js.map +1 -1
- package/dist/integrations/platform/linear/integration.d.ts.map +1 -1
- package/dist/integrations/platform/linear/integration.js +1 -3
- package/dist/integrations/platform/linear/integration.js.map +1 -1
- package/dist/integrations/slack/channel-reply-processor.d.ts +2 -0
- package/dist/integrations/slack/channel-reply-processor.d.ts.map +1 -1
- package/dist/integrations/slack/channel-reply-processor.js +6 -1
- package/dist/integrations/slack/channel-reply-processor.js.map +1 -1
- package/dist/integrations/slack/connect-route.d.ts.map +1 -1
- package/dist/integrations/slack/connect-route.js +1 -1
- package/dist/integrations/slack/connect-route.js.map +1 -1
- package/dist/integrations/slack/integration.d.ts.map +1 -1
- package/dist/integrations/slack/integration.js +2 -0
- package/dist/integrations/slack/integration.js.map +1 -1
- package/dist/integrations/slack/slack.d.ts +12 -10
- package/dist/integrations/slack/slack.d.ts.map +1 -1
- package/dist/integrations/slack/slack.js +110 -43
- package/dist/integrations/slack/slack.js.map +1 -1
- package/dist/integrations/slack/voice-clips.d.ts +32 -0
- package/dist/integrations/slack/voice-clips.d.ts.map +1 -0
- package/dist/integrations/slack/voice-clips.js +201 -0
- package/dist/integrations/slack/voice-clips.js.map +1 -0
- package/dist/integrations/workos/integration.d.ts.map +1 -1
- package/dist/integrations/workos/integration.js +1 -3
- package/dist/integrations/workos/integration.js.map +1 -1
- package/dist/mcp/routes.js +1 -1
- package/dist/packages/_internals/workspace/dist/index.js +1 -1
- package/dist/routes/attention-activity.js +1 -1
- package/dist/routes/attention-providers.js +1 -1
- package/dist/routes/automation-runs.d.ts.map +1 -1
- package/dist/routes/automation-runs.js +1 -4
- package/dist/routes/automation-runs.js.map +1 -1
- package/dist/routes/boards.d.ts +8 -6
- package/dist/routes/boards.d.ts.map +1 -1
- package/dist/routes/boards.js +73 -143
- package/dist/routes/boards.js.map +1 -1
- package/dist/routes/config.d.ts.map +1 -1
- package/dist/routes/config.js +3 -8
- package/dist/routes/config.js.map +1 -1
- package/dist/routes/contracts.d.ts +132 -0
- package/dist/routes/contracts.d.ts.map +1 -1
- package/dist/routes/contracts.js +77 -29
- package/dist/routes/contracts.js.map +1 -1
- package/dist/routes/fs.d.ts.map +1 -1
- package/dist/routes/fs.js +1 -4
- package/dist/routes/fs.js.map +1 -1
- package/dist/routes/intake-routes.d.ts.map +1 -1
- package/dist/routes/intake-routes.js +19 -12
- package/dist/routes/intake-routes.js.map +1 -1
- package/dist/routes/intake.d.ts.map +1 -1
- package/dist/routes/intake.js +3 -5
- package/dist/routes/intake.js.map +1 -1
- package/dist/routes/knowledge.d.ts.map +1 -1
- package/dist/routes/knowledge.js +1 -4
- package/dist/routes/knowledge.js.map +1 -1
- package/dist/routes/oauth.d.ts.map +1 -1
- package/dist/routes/oauth.js +1 -4
- package/dist/routes/oauth.js.map +1 -1
- package/dist/routes/projects.d.ts +3 -0
- package/dist/routes/projects.d.ts.map +1 -1
- package/dist/routes/projects.js +7 -4
- package/dist/routes/projects.js.map +1 -1
- package/dist/routes/provider-credentials.d.ts.map +1 -1
- package/dist/routes/provider-credentials.js +6 -0
- package/dist/routes/provider-credentials.js.map +1 -1
- package/dist/routes/route.d.ts +2 -0
- package/dist/routes/route.d.ts.map +1 -1
- package/dist/routes/route.js +5 -1
- package/dist/routes/route.js.map +1 -1
- package/dist/routes/skills.d.ts.map +1 -1
- package/dist/routes/skills.js +1 -4
- package/dist/routes/skills.js.map +1 -1
- package/dist/routes/source-control-sessions.d.ts.map +1 -1
- package/dist/routes/source-control-sessions.js +1 -3
- package/dist/routes/source-control-sessions.js.map +1 -1
- package/dist/routes/source-control-settings.d.ts.map +1 -1
- package/dist/routes/source-control-settings.js +3 -2
- package/dist/routes/source-control-settings.js.map +1 -1
- package/dist/routes/surface.d.ts +3 -1
- package/dist/routes/surface.d.ts.map +1 -1
- package/dist/routes/surface.js +11 -1
- package/dist/routes/surface.js.map +1 -1
- package/dist/routes/voice.d.ts +48 -0
- package/dist/routes/voice.d.ts.map +1 -0
- package/dist/routes/voice.js +248 -0
- package/dist/routes/voice.js.map +1 -0
- package/dist/routes/work-items.d.ts.map +1 -1
- package/dist/routes/work-items.js +1 -4
- package/dist/routes/work-items.js.map +1 -1
- package/dist/rules/decision-applicability.js +1 -1
- package/dist/rules/dispatcher.d.ts +28 -0
- package/dist/rules/dispatcher.d.ts.map +1 -1
- package/dist/rules/dispatcher.js +391 -93
- package/dist/rules/dispatcher.js.map +1 -1
- package/dist/rules/event-rules.d.ts +40 -1
- package/dist/rules/event-rules.d.ts.map +1 -1
- package/dist/rules/event-rules.js +59 -1
- package/dist/rules/event-rules.js.map +1 -1
- package/dist/rules/processor.js +1 -1
- package/dist/rules/processor.js.map +1 -1
- package/dist/rules/transition-service.d.ts +9 -0
- package/dist/rules/transition-service.d.ts.map +1 -1
- package/dist/rules/transition-service.js +4 -2
- package/dist/rules/transition-service.js.map +1 -1
- package/dist/rules/types.d.ts +54 -3
- package/dist/rules/types.d.ts.map +1 -1
- package/dist/rules/types.js +2 -0
- package/dist/rules/types.js.map +1 -1
- package/dist/rules/validation.d.ts.map +1 -1
- package/dist/rules/validation.js +57 -2
- package/dist/rules/validation.js.map +1 -1
- package/dist/session/credential-policy.d.ts +2 -2
- package/dist/session/credential-policy.d.ts.map +1 -1
- package/dist/session/credential-policy.js +3 -3
- package/dist/session/credential-policy.js.map +1 -1
- package/dist/session/default-model-hydration.d.ts +2 -2
- package/dist/session/default-model-hydration.d.ts.map +1 -1
- package/dist/session/default-model-hydration.js +4 -4
- package/dist/session/default-model-hydration.js.map +1 -1
- package/dist/session/session-threads.d.ts +8 -0
- package/dist/session/session-threads.d.ts.map +1 -1
- package/dist/session/session-threads.js +11 -1
- package/dist/session/session-threads.js.map +1 -1
- package/dist/skills/catalog.js +1 -1
- package/dist/storage/domains/audit/actions.d.ts +1 -1
- package/dist/storage/domains/audit/actions.d.ts.map +1 -1
- package/dist/storage/domains/audit/actions.js +2 -1
- package/dist/storage/domains/audit/actions.js.map +1 -1
- package/dist/storage/domains/audit/domain.d.ts.map +1 -1
- package/dist/storage/domains/audit/domain.js +1 -3
- package/dist/storage/domains/audit/domain.js.map +1 -1
- package/dist/storage/domains/boards/base.d.ts +32 -1
- package/dist/storage/domains/boards/base.d.ts.map +1 -1
- package/dist/storage/domains/boards/base.js +155 -8
- package/dist/storage/domains/boards/base.js.map +1 -1
- package/dist/storage/domains/boards/schemas.d.ts.map +1 -1
- package/dist/storage/domains/boards/schemas.js +13 -1
- package/dist/storage/domains/boards/schemas.js.map +1 -1
- package/dist/storage/domains/comments/routes.d.ts.map +1 -1
- package/dist/storage/domains/comments/routes.js +1 -3
- package/dist/storage/domains/comments/routes.js.map +1 -1
- package/dist/storage/domains/memory-settings/base.d.ts +0 -8
- package/dist/storage/domains/memory-settings/base.d.ts.map +1 -1
- package/dist/storage/domains/memory-settings/base.js +1 -11
- package/dist/storage/domains/memory-settings/base.js.map +1 -1
- package/dist/storage/domains/projects/base.d.ts +6 -0
- package/dist/storage/domains/projects/base.d.ts.map +1 -1
- package/dist/storage/domains/projects/base.js +9 -1
- package/dist/storage/domains/projects/base.js.map +1 -1
- package/dist/storage/domains/voice-settings/base.d.ts +31 -0
- package/dist/storage/domains/voice-settings/base.d.ts.map +1 -0
- package/dist/storage/domains/voice-settings/base.js +81 -0
- package/dist/storage/domains/voice-settings/base.js.map +1 -0
- package/dist/storage/domains/work-items/base.d.ts +31 -2
- package/dist/storage/domains/work-items/base.d.ts.map +1 -1
- package/dist/storage/domains/work-items/base.js +197 -44
- package/dist/storage/domains/work-items/base.js.map +1 -1
- package/dist/storage/domains/work-items/cards.d.ts +6 -1
- package/dist/storage/domains/work-items/cards.d.ts.map +1 -1
- package/dist/storage/domains/work-items/cards.js +54 -4
- package/dist/storage/domains/work-items/cards.js.map +1 -1
- package/dist/storage/domains/work-items/work-item-schema.d.ts +2 -0
- package/dist/storage/domains/work-items/work-item-schema.d.ts.map +1 -1
- package/dist/storage/domains/work-items/work-item-schema.js +24 -1
- package/dist/storage/domains/work-items/work-item-schema.js.map +1 -1
- package/dist/timing.d.ts +1 -0
- package/dist/timing.d.ts.map +1 -1
- package/dist/timing.js +1 -1
- package/dist/timing.js.map +1 -1
- package/dist/tools/read-tools.d.ts +2 -2
- package/dist/tools/read-tools.d.ts.map +1 -1
- package/dist/tools/read-tools.js +7 -6
- package/dist/tools/read-tools.js.map +1 -1
- package/dist/tools/session-tools.d.ts +1 -1
- package/dist/tools/session-tools.d.ts.map +1 -1
- package/dist/tools/session-tools.js.map +1 -1
- package/dist/tools/sessions-state-processor.d.ts +1 -1
- package/dist/tools/sessions-state-processor.d.ts.map +1 -1
- package/dist/tools/sessions-state-processor.js +9 -2
- package/dist/tools/sessions-state-processor.js.map +1 -1
- package/dist/tools/work-item-tools.js +2 -2
- package/dist/voice/rate-limit.d.ts +13 -0
- package/dist/voice/rate-limit.d.ts.map +1 -0
- package/dist/voice/rate-limit.js +36 -0
- package/dist/voice/rate-limit.js.map +1 -0
- package/dist/voice/realtime.d.ts +13 -0
- package/dist/voice/realtime.d.ts.map +1 -0
- package/dist/voice/realtime.js +56 -0
- package/dist/voice/realtime.js.map +1 -0
- package/dist/voice/transcription.d.ts +51 -0
- package/dist/voice/transcription.d.ts.map +1 -0
- package/dist/voice/transcription.js +112 -0
- package/dist/voice/transcription.js.map +1 -0
- package/dist/work-items/split-backfill.d.ts +13 -0
- package/dist/work-items/split-backfill.d.ts.map +1 -0
- package/dist/work-items/split-backfill.js +32 -0
- package/dist/work-items/split-backfill.js.map +1 -0
- package/dist/work-items/split-migration.d.ts +39 -2
- package/dist/work-items/split-migration.d.ts.map +1 -1
- package/dist/work-items/split-migration.js +170 -62
- package/dist/work-items/split-migration.js.map +1 -1
- package/dist/workspace.js +2 -2
- package/package.json +12 -11
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Writes to a project's stored boards, shared by the boards API and `MastraFactory#upsertBoard()`.
|
|
3
|
+
*
|
|
4
|
+
* Every write is checked against the rules `defineBoard()` enforces, the skills its runners name,
|
|
5
|
+
* the code behaviour of a code board's copy, and the cards sitting on the board. It then
|
|
6
|
+
* invalidates the project's board cache and records an audit event.
|
|
7
|
+
*/
|
|
8
|
+
import type { z } from 'zod';
|
|
9
|
+
import type { EmitAuditInput } from '../storage/domains/audit/domain.js';
|
|
10
|
+
import type { StoredBoardInput, StoredBoardRecord, StoredBoardScope, StoredBoardsStorage } from '../storage/domains/boards/base.js';
|
|
11
|
+
import type { WorkItemsStorage } from '../storage/domains/work-items/base.js';
|
|
12
|
+
import type { ProjectBoardCache } from './project-boards.js';
|
|
13
|
+
export interface BoardWritesDeps {
|
|
14
|
+
storage: StoredBoardsStorage;
|
|
15
|
+
/** The per-project boards: the code boards and their seeds, skills, and the cache to invalidate. */
|
|
16
|
+
boards: Pick<ProjectBoardCache, 'describe' | 'invalidate' | 'codeRegistry' | 'codeSkills' | 'seedFor'>;
|
|
17
|
+
/** Read to refuse edits that would strand cards. */
|
|
18
|
+
workItems: Pick<WorkItemsStorage, 'list'>;
|
|
19
|
+
}
|
|
20
|
+
/** Who writes: stored as the board's author, and the audit event's actor. */
|
|
21
|
+
export interface BoardWriter {
|
|
22
|
+
id: string;
|
|
23
|
+
audit(input: EmitAuditInput): Promise<void>;
|
|
24
|
+
}
|
|
25
|
+
/** A refused board write. `status` and `body` are what the boards API answers with. */
|
|
26
|
+
export declare class BoardWriteError extends Error {
|
|
27
|
+
readonly status: 404 | 409 | 422;
|
|
28
|
+
readonly body: {
|
|
29
|
+
error: string;
|
|
30
|
+
message?: string;
|
|
31
|
+
} & Record<string, unknown>;
|
|
32
|
+
name: string;
|
|
33
|
+
constructor(status: 404 | 409 | 422, body: {
|
|
34
|
+
error: string;
|
|
35
|
+
message?: string;
|
|
36
|
+
} & Record<string, unknown>);
|
|
37
|
+
get code(): string;
|
|
38
|
+
}
|
|
39
|
+
export declare function issueMessage(issues: readonly z.core.$ZodIssue[]): string;
|
|
40
|
+
export declare class BoardWrites {
|
|
41
|
+
#private;
|
|
42
|
+
private readonly deps;
|
|
43
|
+
constructor(deps: BoardWritesDeps);
|
|
44
|
+
/**
|
|
45
|
+
* Code boards can't be created over, and Work can't be deleted while its code handlers run by its
|
|
46
|
+
* key; the legacy Review board can't be changed at all.
|
|
47
|
+
*/
|
|
48
|
+
refuseCodeBoard(key: string, action: 'create' | 'edit' | 'delete'): void;
|
|
49
|
+
existing(scope: StoredBoardScope, key: string): Promise<StoredBoardRecord>;
|
|
50
|
+
/**
|
|
51
|
+
* Validates a definition the way `defineBoard()` does, plus the skills its runners name. A code
|
|
52
|
+
* board's copy is also checked against the code behaviour of its board and phase keys.
|
|
53
|
+
*/
|
|
54
|
+
validate(input: unknown): StoredBoardInput;
|
|
55
|
+
/** Creates a board under a key no code board uses. */
|
|
56
|
+
create(scope: StoredBoardScope, input: unknown, writer: BoardWriter): Promise<StoredBoardRecord>;
|
|
57
|
+
/**
|
|
58
|
+
* Stores a validated board in a project, after its first load stored Factory's boards: creates
|
|
59
|
+
* it when the project has none under its key, and otherwise replaces the project's board, edited
|
|
60
|
+
* or not, at its current revision, with the same checks as an edit. A write that loses a race
|
|
61
|
+
* with another one rereads and tries again.
|
|
62
|
+
*/
|
|
63
|
+
upsert(scope: StoredBoardScope, board: StoredBoardInput, writer: BoardWriter): Promise<'inserted' | 'updated' | 'unchanged'>;
|
|
64
|
+
/**
|
|
65
|
+
* Replaces a board's definition at `expectedRevision`. Saving it unchanged writes nothing;
|
|
66
|
+
* `written` says whether anything was stored.
|
|
67
|
+
*/
|
|
68
|
+
replace(scope: StoredBoardScope, key: string, definition: Omit<StoredBoardInput, 'key'>, { expectedRevision, writer }: {
|
|
69
|
+
expectedRevision: number;
|
|
70
|
+
writer: BoardWriter;
|
|
71
|
+
}): Promise<{
|
|
72
|
+
row: StoredBoardRecord;
|
|
73
|
+
written: boolean;
|
|
74
|
+
}>;
|
|
75
|
+
/** Deletes a stored board that no card sits on. */
|
|
76
|
+
remove(scope: StoredBoardScope, key: string, { expectedRevision, writer }: {
|
|
77
|
+
expectedRevision: number;
|
|
78
|
+
writer: BoardWriter;
|
|
79
|
+
}): Promise<void>;
|
|
80
|
+
/** Rewrites a board Factory stores to Factory's current definition of it, at the next revision. */
|
|
81
|
+
reset(scope: StoredBoardScope, key: string, { expectedRevision, writer }: {
|
|
82
|
+
expectedRevision: number;
|
|
83
|
+
writer: BoardWriter;
|
|
84
|
+
}): Promise<StoredBoardRecord>;
|
|
85
|
+
}
|
|
86
|
+
//# sourceMappingURL=board-writes.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"board-writes.d.ts","sourceRoot":"","sources":["../../src/boards/board-writes.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,252 @@
|
|
|
1
|
+
import { findBoardSkillProblems } from "../skills/app-skills.js";
|
|
2
|
+
import { StoredBoardError } from "../storage/domains/boards/base.js";
|
|
3
|
+
import { codeBoardOf } from "./define-board.js";
|
|
4
|
+
import { createBoardRegistry } from "./registry.js";
|
|
5
|
+
import { boardForWorkItem } from "./semantics.js";
|
|
6
|
+
import { codeBehaviourConflicts, compileStoredBoard, sameBoardDefinition, storedBoardInputSchema } from "./stored-board.js";
|
|
7
|
+
import { workBoard } from "./work.js";
|
|
8
|
+
// src/boards/board-writes.ts
|
|
9
|
+
/** A refused board write. `status` and `body` are what the boards API answers with. */
|
|
10
|
+
var BoardWriteError = class extends Error {
|
|
11
|
+
status;
|
|
12
|
+
body;
|
|
13
|
+
name = "BoardWriteError";
|
|
14
|
+
constructor(status, body) {
|
|
15
|
+
super(body.message ?? body.error);
|
|
16
|
+
this.status = status;
|
|
17
|
+
this.body = body;
|
|
18
|
+
}
|
|
19
|
+
get code() {
|
|
20
|
+
return this.body.error;
|
|
21
|
+
}
|
|
22
|
+
};
|
|
23
|
+
function issueMessage(issues) {
|
|
24
|
+
return issues.map((issue) => issue.path.length > 0 ? `${issue.path.join(".")}: ${issue.message}` : issue.message).join("; ");
|
|
25
|
+
}
|
|
26
|
+
const UNKNOWN_SKILL = "but no such skill exists";
|
|
27
|
+
const UPSERT_ATTEMPTS = 3;
|
|
28
|
+
/** Storage refusals (a stale revision, a missing or existing board) as board write errors. */
|
|
29
|
+
async function stored(write) {
|
|
30
|
+
try {
|
|
31
|
+
return await write();
|
|
32
|
+
} catch (error) {
|
|
33
|
+
if (error instanceof StoredBoardError) throw new BoardWriteError(error.code === "board_not_found" ? 404 : 409, {
|
|
34
|
+
error: error.code,
|
|
35
|
+
message: error.message
|
|
36
|
+
});
|
|
37
|
+
throw error;
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
var BoardWrites = class {
|
|
41
|
+
deps;
|
|
42
|
+
constructor(deps) {
|
|
43
|
+
this.deps = deps;
|
|
44
|
+
}
|
|
45
|
+
/**
|
|
46
|
+
* Code boards can't be created over, and Work can't be deleted while its code handlers run by its
|
|
47
|
+
* key; the legacy Review board can't be changed at all.
|
|
48
|
+
*/
|
|
49
|
+
refuseCodeBoard(key, action) {
|
|
50
|
+
const { boards } = this.deps;
|
|
51
|
+
const code = boards.codeRegistry.get(key);
|
|
52
|
+
if (!code) return;
|
|
53
|
+
const stored = boards.seedFor(key) !== void 0;
|
|
54
|
+
if (action === "edit" && stored) return;
|
|
55
|
+
if (action === "delete" && stored && codeBoardOf(code) !== workBoard) return;
|
|
56
|
+
throw new BoardWriteError(409, {
|
|
57
|
+
error: "code_board",
|
|
58
|
+
message: action === "delete" && stored ? `Board "${key}" is defined in code and can't be deleted; reset it to its default instead.` : `Board "${key}" is defined in code and can't be ${action === "create" ? "created over" : "changed"} here.`
|
|
59
|
+
});
|
|
60
|
+
}
|
|
61
|
+
async existing(scope, key) {
|
|
62
|
+
const row = await this.deps.storage.get(scope, key);
|
|
63
|
+
if (!row) throw new BoardWriteError(404, {
|
|
64
|
+
error: "board_not_found",
|
|
65
|
+
message: `Board "${key}" does not exist.`
|
|
66
|
+
});
|
|
67
|
+
return row;
|
|
68
|
+
}
|
|
69
|
+
/**
|
|
70
|
+
* Validates a definition the way `defineBoard()` does, plus the skills its runners name. A code
|
|
71
|
+
* board's copy is also checked against the code behaviour of its board and phase keys.
|
|
72
|
+
*/
|
|
73
|
+
validate(input) {
|
|
74
|
+
const { boards } = this.deps;
|
|
75
|
+
const parsed = storedBoardInputSchema.safeParse(input);
|
|
76
|
+
if (!parsed.success) throw new BoardWriteError(422, {
|
|
77
|
+
error: "invalid_board",
|
|
78
|
+
message: issueMessage(parsed.error.issues)
|
|
79
|
+
});
|
|
80
|
+
const code = boards.seedFor(parsed.data.key) && boards.codeRegistry.get(parsed.data.key);
|
|
81
|
+
if (code) {
|
|
82
|
+
const conflicts = codeBehaviourConflicts(parsed.data, code);
|
|
83
|
+
if (conflicts.length > 0) throw new BoardWriteError(422, {
|
|
84
|
+
error: "code_behaviour",
|
|
85
|
+
message: conflicts.join(" "),
|
|
86
|
+
conflicts
|
|
87
|
+
});
|
|
88
|
+
}
|
|
89
|
+
const board = code ? compileStoredBoard(parsed.data, code) : compileStoredBoard(parsed.data);
|
|
90
|
+
const unknown = findBoardSkillProblems(createBoardRegistry({
|
|
91
|
+
boards: [board],
|
|
92
|
+
includeDefaultBoards: false
|
|
93
|
+
}), boards.codeSkills).filter((problem) => problem.includes(UNKNOWN_SKILL));
|
|
94
|
+
if (unknown.length > 0) throw new BoardWriteError(422, {
|
|
95
|
+
error: "unknown_skill",
|
|
96
|
+
message: unknown.join(" ")
|
|
97
|
+
});
|
|
98
|
+
return parsed.data;
|
|
99
|
+
}
|
|
100
|
+
/** Creates a board under a key no code board uses. */
|
|
101
|
+
async create(scope, input, writer) {
|
|
102
|
+
const key = input?.key;
|
|
103
|
+
if (typeof key === "string") this.refuseCodeBoard(key, "create");
|
|
104
|
+
const board = this.validate(input);
|
|
105
|
+
const row = await stored(() => this.deps.storage.create(scope, board, writer.id));
|
|
106
|
+
this.deps.boards.invalidate(scope);
|
|
107
|
+
await this.#audit(scope, writer, "created", board);
|
|
108
|
+
return row;
|
|
109
|
+
}
|
|
110
|
+
/**
|
|
111
|
+
* Stores a validated board in a project, after its first load stored Factory's boards: creates
|
|
112
|
+
* it when the project has none under its key, and otherwise replaces the project's board, edited
|
|
113
|
+
* or not, at its current revision, with the same checks as an edit. A write that loses a race
|
|
114
|
+
* with another one rereads and tries again.
|
|
115
|
+
*/
|
|
116
|
+
async upsert(scope, board, writer) {
|
|
117
|
+
const { storage, boards } = this.deps;
|
|
118
|
+
await boards.describe(scope);
|
|
119
|
+
for (let attempt = 1;; attempt++) {
|
|
120
|
+
const row = await storage.get(scope, board.key);
|
|
121
|
+
try {
|
|
122
|
+
if (!row) {
|
|
123
|
+
if (!await storage.insertIfMissing(scope, board, writer.id)) throw new BoardWriteError(409, {
|
|
124
|
+
error: "revision_mismatch",
|
|
125
|
+
message: `Board "${board.key}" was stored by another write; try again.`
|
|
126
|
+
});
|
|
127
|
+
boards.invalidate(scope);
|
|
128
|
+
await this.#audit(scope, writer, "created", board);
|
|
129
|
+
return "inserted";
|
|
130
|
+
}
|
|
131
|
+
const { key, ...definition } = board;
|
|
132
|
+
const { written } = await this.replace(scope, key, definition, {
|
|
133
|
+
expectedRevision: row.revision,
|
|
134
|
+
writer
|
|
135
|
+
});
|
|
136
|
+
return written ? "updated" : "unchanged";
|
|
137
|
+
} catch (error) {
|
|
138
|
+
if (!(error instanceof BoardWriteError && (error.code === "revision_mismatch" || error.code === "board_not_found")) || attempt >= UPSERT_ATTEMPTS) throw error;
|
|
139
|
+
}
|
|
140
|
+
}
|
|
141
|
+
}
|
|
142
|
+
/**
|
|
143
|
+
* Replaces a board's definition at `expectedRevision`. Saving it unchanged writes nothing;
|
|
144
|
+
* `written` says whether anything was stored.
|
|
145
|
+
*/
|
|
146
|
+
async replace(scope, key, definition, { expectedRevision, writer }) {
|
|
147
|
+
const { storage, boards } = this.deps;
|
|
148
|
+
this.refuseCodeBoard(key, "edit");
|
|
149
|
+
if (boards.seedFor(key)) await boards.describe(scope);
|
|
150
|
+
const row = await this.existing(scope, key);
|
|
151
|
+
const input = this.validate({
|
|
152
|
+
key,
|
|
153
|
+
...definition
|
|
154
|
+
});
|
|
155
|
+
if (row.revision === expectedRevision && sameBoardDefinition(row, input)) return {
|
|
156
|
+
row,
|
|
157
|
+
written: false
|
|
158
|
+
};
|
|
159
|
+
await this.#checkPhasesFree(scope, row, input.phases);
|
|
160
|
+
const { key: _key, ...replacement } = input;
|
|
161
|
+
const replaced = await stored(() => storage.replace(scope, key, replacement, {
|
|
162
|
+
expectedRevision,
|
|
163
|
+
actor: writer.id
|
|
164
|
+
}));
|
|
165
|
+
boards.invalidate(scope);
|
|
166
|
+
await this.#audit(scope, writer, "updated", input);
|
|
167
|
+
return {
|
|
168
|
+
row: replaced,
|
|
169
|
+
written: true
|
|
170
|
+
};
|
|
171
|
+
}
|
|
172
|
+
/** Deletes a stored board that no card sits on. */
|
|
173
|
+
async remove(scope, key, { expectedRevision, writer }) {
|
|
174
|
+
this.refuseCodeBoard(key, "delete");
|
|
175
|
+
if (this.deps.boards.seedFor(key)) await this.deps.boards.describe(scope);
|
|
176
|
+
const row = await this.existing(scope, key);
|
|
177
|
+
const { cards } = await this.#occupancy(scope, key);
|
|
178
|
+
if (cards > 0) throw new BoardWriteError(409, {
|
|
179
|
+
error: "board_in_use",
|
|
180
|
+
message: `Board "${key}" still has cards; move or delete them first.`,
|
|
181
|
+
cards
|
|
182
|
+
});
|
|
183
|
+
await stored(() => this.deps.storage.delete(scope, key, { expectedRevision }));
|
|
184
|
+
this.deps.boards.invalidate(scope);
|
|
185
|
+
await this.#audit(scope, writer, "deleted", row);
|
|
186
|
+
}
|
|
187
|
+
/** Rewrites a board Factory stores to Factory's current definition of it, at the next revision. */
|
|
188
|
+
async reset(scope, key, { expectedRevision, writer }) {
|
|
189
|
+
const { storage, boards } = this.deps;
|
|
190
|
+
const seed = boards.seedFor(key);
|
|
191
|
+
if (!seed) {
|
|
192
|
+
this.refuseCodeBoard(key, "edit");
|
|
193
|
+
await this.existing(scope, key);
|
|
194
|
+
throw new BoardWriteError(409, {
|
|
195
|
+
error: "not_code_board",
|
|
196
|
+
message: `Board "${key}" was created in this project and has no default to reset to.`
|
|
197
|
+
});
|
|
198
|
+
}
|
|
199
|
+
await boards.describe(scope);
|
|
200
|
+
const row = await this.existing(scope, key);
|
|
201
|
+
await this.#checkPhasesFree(scope, row, seed.phases);
|
|
202
|
+
const reset = await stored(() => storage.resetTo(scope, key, seed, {
|
|
203
|
+
expectedRevision,
|
|
204
|
+
actor: writer.id
|
|
205
|
+
}));
|
|
206
|
+
boards.invalidate(scope);
|
|
207
|
+
await this.#audit(scope, writer, "reset", row);
|
|
208
|
+
return reset;
|
|
209
|
+
}
|
|
210
|
+
/** The cards on a board, and how many sit in each phase. */
|
|
211
|
+
async #occupancy(scope, key) {
|
|
212
|
+
const phases = /* @__PURE__ */ new Map();
|
|
213
|
+
let cards = 0;
|
|
214
|
+
for (const item of await this.deps.workItems.list(scope)) {
|
|
215
|
+
if (boardForWorkItem(item) !== key) continue;
|
|
216
|
+
cards++;
|
|
217
|
+
for (const stage of new Set(item.stages)) phases.set(stage, (phases.get(stage) ?? 0) + 1);
|
|
218
|
+
}
|
|
219
|
+
return {
|
|
220
|
+
cards,
|
|
221
|
+
phases
|
|
222
|
+
};
|
|
223
|
+
}
|
|
224
|
+
/** Refuses a change that removes, or changes the kind of, a phase cards sit in. */
|
|
225
|
+
async #checkPhasesFree(scope, row, next) {
|
|
226
|
+
const kinds = new Map(next.map((phase) => [phase.key, phase.kind]));
|
|
227
|
+
const changed = row.phases.filter((phase) => kinds.get(phase.key) !== phase.kind).map((phase) => phase.key);
|
|
228
|
+
if (changed.length === 0) return;
|
|
229
|
+
const occupancy = (await this.#occupancy(scope, row.key)).phases;
|
|
230
|
+
const inUse = Object.fromEntries(changed.flatMap((key) => occupancy.get(key) ? [[key, occupancy.get(key)]] : []));
|
|
231
|
+
if (Object.keys(inUse).length === 0) return;
|
|
232
|
+
throw new BoardWriteError(409, {
|
|
233
|
+
error: "phase_in_use",
|
|
234
|
+
message: `Cards sit in ${Object.entries(inUse).map(([key, count]) => `"${key}" (${count})`).join(", ")}; move them before removing those phases or changing their kind.`,
|
|
235
|
+
phases: inUse
|
|
236
|
+
});
|
|
237
|
+
}
|
|
238
|
+
async #audit(scope, writer, action, board) {
|
|
239
|
+
await writer.audit({
|
|
240
|
+
action: `factory.board.${action}`,
|
|
241
|
+
factoryProjectId: scope.factoryProjectId,
|
|
242
|
+
targets: [{
|
|
243
|
+
type: "board",
|
|
244
|
+
id: board.key,
|
|
245
|
+
name: board.name
|
|
246
|
+
}]
|
|
247
|
+
});
|
|
248
|
+
}
|
|
249
|
+
};
|
|
250
|
+
export { BoardWriteError, BoardWrites, issueMessage };
|
|
251
|
+
|
|
252
|
+
//# sourceMappingURL=board-writes.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"board-writes.js","names":[],"sources":["../../src/boards/board-writes.ts"],"sourcesContent":["/**\n * Writes to a project's stored boards, shared by the boards API and `MastraFactory#upsertBoard()`.\n *\n * Every write is checked against the rules `defineBoard()` enforces, the skills its runners name,\n * the code behaviour of a code board's copy, and the cards sitting on the board. It then\n * invalidates the project's board cache and records an audit event.\n */\n\nimport type { z } from 'zod';\n\nimport { findBoardSkillProblems } from '../skills/app-skills.js';\nimport type { EmitAuditInput } from '../storage/domains/audit/domain.js';\nimport { StoredBoardError } from '../storage/domains/boards/base.js';\nimport type {\n StoredBoardInput,\n StoredBoardRecord,\n StoredBoardScope,\n StoredBoardsStorage,\n StoredPhaseInput,\n} from '../storage/domains/boards/base.js';\nimport type { WorkItemsStorage } from '../storage/domains/work-items/base.js';\nimport { codeBoardOf } from './define-board.js';\nimport type { ProjectBoardCache } from './project-boards.js';\nimport { createBoardRegistry } from './registry.js';\nimport { boardForWorkItem } from './semantics.js';\nimport {\n codeBehaviourConflicts,\n compileStoredBoard,\n sameBoardDefinition,\n storedBoardInputSchema,\n} from './stored-board.js';\nimport { workBoard } from './work.js';\n\nexport interface BoardWritesDeps {\n storage: StoredBoardsStorage;\n /** The per-project boards: the code boards and their seeds, skills, and the cache to invalidate. */\n boards: Pick<ProjectBoardCache, 'describe' | 'invalidate' | 'codeRegistry' | 'codeSkills' | 'seedFor'>;\n /** Read to refuse edits that would strand cards. */\n workItems: Pick<WorkItemsStorage, 'list'>;\n}\n\n/** Who writes: stored as the board's author, and the audit event's actor. */\nexport interface BoardWriter {\n id: string;\n audit(input: EmitAuditInput): Promise<void>;\n}\n\n/** A refused board write. `status` and `body` are what the boards API answers with. */\nexport class BoardWriteError extends Error {\n override name = 'BoardWriteError';\n constructor(\n readonly status: 404 | 409 | 422,\n readonly body: { error: string; message?: string } & Record<string, unknown>,\n ) {\n super(body.message ?? body.error);\n }\n\n get code(): string {\n return this.body.error;\n }\n}\n\nexport function issueMessage(issues: readonly z.core.$ZodIssue[]): string {\n return issues\n .map(issue => (issue.path.length > 0 ? `${issue.path.join('.')}: ${issue.message}` : issue.message))\n .join('; ');\n}\n\nconst UNKNOWN_SKILL = 'but no such skill exists';\nconst UPSERT_ATTEMPTS = 3;\n\n/** Storage refusals (a stale revision, a missing or existing board) as board write errors. */\nasync function stored<T>(write: () => Promise<T>): Promise<T> {\n try {\n return await write();\n } catch (error) {\n if (error instanceof StoredBoardError) {\n throw new BoardWriteError(error.code === 'board_not_found' ? 404 : 409, {\n error: error.code,\n message: error.message,\n });\n }\n throw error;\n }\n}\n\nexport class BoardWrites {\n constructor(private readonly deps: BoardWritesDeps) {}\n\n /**\n * Code boards can't be created over, and Work can't be deleted while its code handlers run by its\n * key; the legacy Review board can't be changed at all.\n */\n refuseCodeBoard(key: string, action: 'create' | 'edit' | 'delete'): void {\n const { boards } = this.deps;\n const code = boards.codeRegistry.get(key);\n if (!code) return;\n const stored = boards.seedFor(key) !== undefined;\n if (action === 'edit' && stored) return;\n if (action === 'delete' && stored && codeBoardOf(code) !== workBoard) return;\n throw new BoardWriteError(409, {\n error: 'code_board',\n message:\n action === 'delete' && stored\n ? `Board \"${key}\" is defined in code and can't be deleted; reset it to its default instead.`\n : `Board \"${key}\" is defined in code and can't be ${action === 'create' ? 'created over' : 'changed'} here.`,\n });\n }\n\n async existing(scope: StoredBoardScope, key: string): Promise<StoredBoardRecord> {\n const row = await this.deps.storage.get(scope, key);\n if (!row) throw new BoardWriteError(404, { error: 'board_not_found', message: `Board \"${key}\" does not exist.` });\n return row;\n }\n\n /**\n * Validates a definition the way `defineBoard()` does, plus the skills its runners name. A code\n * board's copy is also checked against the code behaviour of its board and phase keys.\n */\n validate(input: unknown): StoredBoardInput {\n const { boards } = this.deps;\n const parsed = storedBoardInputSchema.safeParse(input);\n if (!parsed.success) {\n throw new BoardWriteError(422, { error: 'invalid_board', message: issueMessage(parsed.error.issues) });\n }\n const code = boards.seedFor(parsed.data.key) && boards.codeRegistry.get(parsed.data.key);\n if (code) {\n const conflicts = codeBehaviourConflicts(parsed.data, code);\n if (conflicts.length > 0) {\n throw new BoardWriteError(422, { error: 'code_behaviour', message: conflicts.join(' '), conflicts });\n }\n }\n const board = code ? compileStoredBoard(parsed.data, code) : compileStoredBoard(parsed.data);\n const problems = findBoardSkillProblems(\n createBoardRegistry({ boards: [board], includeDefaultBoards: false }),\n boards.codeSkills,\n );\n const unknown = problems.filter(problem => problem.includes(UNKNOWN_SKILL));\n if (unknown.length > 0) throw new BoardWriteError(422, { error: 'unknown_skill', message: unknown.join(' ') });\n return parsed.data;\n }\n\n /** Creates a board under a key no code board uses. */\n async create(scope: StoredBoardScope, input: unknown, writer: BoardWriter): Promise<StoredBoardRecord> {\n const key = (input as { key?: unknown } | null)?.key;\n if (typeof key === 'string') this.refuseCodeBoard(key, 'create');\n const board = this.validate(input);\n const row = await stored(() => this.deps.storage.create(scope, board, writer.id));\n this.deps.boards.invalidate(scope);\n await this.#audit(scope, writer, 'created', board);\n return row;\n }\n\n /**\n * Stores a validated board in a project, after its first load stored Factory's boards: creates\n * it when the project has none under its key, and otherwise replaces the project's board, edited\n * or not, at its current revision, with the same checks as an edit. A write that loses a race\n * with another one rereads and tries again.\n */\n async upsert(\n scope: StoredBoardScope,\n board: StoredBoardInput,\n writer: BoardWriter,\n ): Promise<'inserted' | 'updated' | 'unchanged'> {\n const { storage, boards } = this.deps;\n await boards.describe(scope);\n for (let attempt = 1; ; attempt++) {\n const row = await storage.get(scope, board.key);\n try {\n if (!row) {\n if (!(await storage.insertIfMissing(scope, board, writer.id))) {\n throw new BoardWriteError(409, {\n error: 'revision_mismatch',\n message: `Board \"${board.key}\" was stored by another write; try again.`,\n });\n }\n boards.invalidate(scope);\n await this.#audit(scope, writer, 'created', board);\n return 'inserted';\n }\n const { key, ...definition } = board;\n const { written } = await this.replace(scope, key, definition, { expectedRevision: row.revision, writer });\n return written ? 'updated' : 'unchanged';\n } catch (error) {\n const lost =\n error instanceof BoardWriteError && (error.code === 'revision_mismatch' || error.code === 'board_not_found');\n if (!lost || attempt >= UPSERT_ATTEMPTS) throw error;\n }\n }\n }\n\n /**\n * Replaces a board's definition at `expectedRevision`. Saving it unchanged writes nothing;\n * `written` says whether anything was stored.\n */\n async replace(\n scope: StoredBoardScope,\n key: string,\n definition: Omit<StoredBoardInput, 'key'>,\n { expectedRevision, writer }: { expectedRevision: number; writer: BoardWriter },\n ): Promise<{ row: StoredBoardRecord; written: boolean }> {\n const { storage, boards } = this.deps;\n this.refuseCodeBoard(key, 'edit');\n const seed = boards.seedFor(key);\n // The project's first load stores Factory's boards.\n if (seed) await boards.describe(scope);\n const row = await this.existing(scope, key);\n const input = this.validate({ key, ...definition });\n if (row.revision === expectedRevision && sameBoardDefinition(row, input)) {\n return { row, written: false };\n }\n await this.#checkPhasesFree(scope, row, input.phases);\n const { key: _key, ...replacement } = input;\n const replaced = await stored(() =>\n storage.replace(scope, key, replacement, { expectedRevision, actor: writer.id }),\n );\n boards.invalidate(scope);\n await this.#audit(scope, writer, 'updated', input);\n return { row: replaced, written: true };\n }\n\n /** Deletes a stored board that no card sits on. */\n async remove(\n scope: StoredBoardScope,\n key: string,\n { expectedRevision, writer }: { expectedRevision: number; writer: BoardWriter },\n ): Promise<void> {\n this.refuseCodeBoard(key, 'delete');\n // The project's first load stores Factory's boards.\n if (this.deps.boards.seedFor(key)) await this.deps.boards.describe(scope);\n const row = await this.existing(scope, key);\n const { cards } = await this.#occupancy(scope, key);\n if (cards > 0) {\n throw new BoardWriteError(409, {\n error: 'board_in_use',\n message: `Board \"${key}\" still has cards; move or delete them first.`,\n cards,\n });\n }\n await stored(() => this.deps.storage.delete(scope, key, { expectedRevision }));\n this.deps.boards.invalidate(scope);\n await this.#audit(scope, writer, 'deleted', row);\n }\n\n /** Rewrites a board Factory stores to Factory's current definition of it, at the next revision. */\n async reset(\n scope: StoredBoardScope,\n key: string,\n { expectedRevision, writer }: { expectedRevision: number; writer: BoardWriter },\n ): Promise<StoredBoardRecord> {\n const { storage, boards } = this.deps;\n const seed = boards.seedFor(key);\n if (!seed) {\n this.refuseCodeBoard(key, 'edit');\n await this.existing(scope, key);\n throw new BoardWriteError(409, {\n error: 'not_code_board',\n message: `Board \"${key}\" was created in this project and has no default to reset to.`,\n });\n }\n await boards.describe(scope);\n const row = await this.existing(scope, key);\n await this.#checkPhasesFree(scope, row, seed.phases);\n const reset = await stored(() => storage.resetTo(scope, key, seed, { expectedRevision, actor: writer.id }));\n boards.invalidate(scope);\n await this.#audit(scope, writer, 'reset', row);\n return reset;\n }\n\n /** The cards on a board, and how many sit in each phase. */\n async #occupancy(scope: StoredBoardScope, key: string): Promise<{ cards: number; phases: Map<string, number> }> {\n const phases = new Map<string, number>();\n let cards = 0;\n for (const item of await this.deps.workItems.list(scope)) {\n if (boardForWorkItem(item) !== key) continue;\n cards++;\n for (const stage of new Set(item.stages)) phases.set(stage, (phases.get(stage) ?? 0) + 1);\n }\n return { cards, phases };\n }\n\n /** Refuses a change that removes, or changes the kind of, a phase cards sit in. */\n async #checkPhasesFree(\n scope: StoredBoardScope,\n row: StoredBoardRecord,\n next: readonly StoredPhaseInput[],\n ): Promise<void> {\n const kinds = new Map(next.map(phase => [phase.key, phase.kind]));\n const changed = row.phases.filter(phase => kinds.get(phase.key) !== phase.kind).map(phase => phase.key);\n if (changed.length === 0) return;\n const occupancy = (await this.#occupancy(scope, row.key)).phases;\n const inUse = Object.fromEntries(changed.flatMap(key => (occupancy.get(key) ? [[key, occupancy.get(key)!]] : [])));\n if (Object.keys(inUse).length === 0) return;\n throw new BoardWriteError(409, {\n error: 'phase_in_use',\n message: `Cards sit in ${Object.entries(inUse)\n .map(([key, count]) => `\"${key}\" (${count})`)\n .join(', ')}; move them before removing those phases or changing their kind.`,\n phases: inUse,\n });\n }\n\n async #audit(\n scope: StoredBoardScope,\n writer: BoardWriter,\n action: 'created' | 'updated' | 'deleted' | 'reset',\n board: { key: string; name: string },\n ): Promise<void> {\n await writer.audit({\n action: `factory.board.${action}`,\n factoryProjectId: scope.factoryProjectId,\n targets: [{ type: 'board', id: board.key, name: board.name }],\n });\n }\n}\n"],"mappings":"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"}
|
|
@@ -215,14 +215,25 @@ export declare class BoardDefinitionError extends Error {
|
|
|
215
215
|
/**
|
|
216
216
|
* Declares a board in code.
|
|
217
217
|
*
|
|
218
|
-
* @deprecated
|
|
219
|
-
*
|
|
220
|
-
* boards
|
|
218
|
+
* @deprecated Write the board's definition into projects with `factory.upsertBoard()`, or manage
|
|
219
|
+
* it through the boards API
|
|
220
|
+
* (`/web/factory/projects/:id/boards`, README "Stored boards"); removal is tracked in
|
|
221
|
+
* mastra-ai/mastra#28920. A board defined here still works: each project stores it once and is
|
|
222
|
+
* served from its row, with the code behaviour it declares.
|
|
221
223
|
*/
|
|
222
224
|
export declare function defineBoard<const BoardId extends string, const Phases extends Record<string, BoardPhaseDefinition<keyof Phases & string>>>(config: BoardConfig<BoardId, Phases>): BoardDefinition<BoardId, keyof Phases & string>;
|
|
223
225
|
/** Whether an app declared the board with the deprecated `defineBoard()`. */
|
|
224
226
|
export declare function isDefinedBoard(board: object): boolean;
|
|
225
|
-
/**
|
|
226
|
-
export
|
|
227
|
+
/** A board declaration as `defineBoard()` takes it, with any phase keys. */
|
|
228
|
+
export type AnyBoardConfig = BoardConfig<string, Record<string, BoardPhaseDefinition<string>>>;
|
|
229
|
+
/** The declaration a board was built from; undefined for an object that was not built as a board. */
|
|
230
|
+
export declare function declarationOf(board: object): AnyBoardConfig | undefined;
|
|
231
|
+
/** The code board a board takes its behaviour from: itself unless it was built from a stored definition. */
|
|
232
|
+
export declare function codeBoardOf<Board extends object>(board: Board): Board;
|
|
233
|
+
/**
|
|
234
|
+
* Validates and resolves a board declaration. Factory's own boards use this directly. A board
|
|
235
|
+
* built from a stored definition names the code board whose behaviour it carries.
|
|
236
|
+
*/
|
|
237
|
+
export declare function compileBoardDefinition<const BoardId extends string, const Phases extends Record<string, BoardPhaseDefinition<keyof Phases & string>>>(config: BoardConfig<BoardId, Phases>, codeBoard?: object): BoardDefinition<BoardId, keyof Phases & string>;
|
|
227
238
|
export {};
|
|
228
239
|
//# sourceMappingURL=define-board.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"define-board.d.ts","sourceRoot":"","sources":["../../src/boards/define-board.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"define-board.d.ts","sourceRoot":"","sources":["../../src/boards/define-board.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AASnE,OAAO,KAAK,EACV,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,wBAAwB,EACxB,0BAA0B,EAC1B,4BAA4B,EAC5B,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,4BAA4B,EAC7B,MAAM,mBAAmB,CAAC;AAU3B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAEpE,KAAK,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,kBAAkB,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC;AAC1G,KAAK,0BAA0B,GAAG,QAAQ,CAAC,kBAAkB,CAAC,CAAC;AAE/D,wEAAwE;AACxE,MAAM,MAAM,0BAA0B,GAAG,kBAAkB,CAAC,4BAA4B,CAAC,CAAC;AAC1F,MAAM,MAAM,aAAa,GAAG;IAAE,QAAQ,CAAC,QAAQ,EAAE,0BAA0B,CAAA;CAAE,CAAC;AAC9E,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;AAErE;;;GAGG;AACH,KAAK,oBAAoB,CAAC,SAAS,SAAS,MAAM,EAAE,OAAO,IAAI,QAAQ,CACrE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,kBAAkB,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,CAC/D,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,oBAAoB,CAAC,sBAAsB,EAAE,wBAAwB,CAAC,CAAC;IACzF,QAAQ,CAAC,MAAM,CAAC,EAAE,oBAAoB,CAAC,sBAAsB,EAAE,wBAAwB,CAAC,CAAC;IACzF,QAAQ,CAAC,MAAM,CAAC,EAAE,oBAAoB,CAAC,sBAAsB,EAAE,wBAAwB,CAAC,CAAC;IACzF,QAAQ,CAAC,IAAI,CAAC,EAAE,oBAAoB,CAAC,oBAAoB,EAAE,sBAAsB,CAAC,CAAC;IACnF,QAAQ,CAAC,UAAU,CAAC,EAAE,oBAAoB,CAAC,0BAA0B,EAAE,4BAA4B,CAAC,CAAC;CACtG;AACD,MAAM,MAAM,qBAAqB,GAAG,MAAM,eAAe,CAAC;AAU1D,KAAK,yBAAyB,GAAG,QAAQ,CACvC,MAAM,CACJ,MAAM,EACN,QAAQ,CACN,OAAO,CACL,MAAM,CACJ,iBAAiB,EACjB,QAAQ,CAAC;IACP,OAAO,CAAC,EAAE,kBAAkB,CAAC,uBAAuB,CAAC,CAAC;IACtD,MAAM,CAAC,EAAE,kBAAkB,CAAC,uBAAuB,CAAC,CAAC;CACtD,CAAC,CACH,CACF,CACF,CACF,CACF,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AAEhE,+CAA+C;AAC/C,eAAO,MAAM,gBAAgB,eAAgB,CAAC;AAE9C,sEAAsE;AACtE,eAAO,MAAM,qBAAqB,SAAS,CAAC;AAE5C,+CAA+C;AAC/C,MAAM,WAAW,gBAAgB;IAC/B,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,0FAA0F;IAC1F,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,8CAA8C;IAC9C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,iFAAiF;IACjF,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,CAAC;CACtC;AAED,KAAK,cAAc,CAAC,OAAO,SAAS,MAAM,IAAI;IAC5C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,8BAA8B;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,2CAA2C;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IACzC,kDAAkD;IAClD,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,0FAA0F;IAC1F,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD,QAAQ,CAAC,OAAO,CAAC,EAAE,0BAA0B,CAAC;IAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,0BAA0B,CAAC;CAC9C,CAAC;AAEF,KAAK,kBAAkB,GAAG;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IACnC,wCAAwC;IACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,sFAAsF;IACtF,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,CAAC;IACnC,8FAA8F;IAC9F,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAAC;CACjD,CAAC;AAEF,KAAK,qBAAqB,GAAG;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,KAAK,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC;CAC3B,CAAC;AAEF,sCAAsC;AACtC,MAAM,MAAM,oBAAoB,CAAC,OAAO,SAAS,MAAM,IACnD,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,qBAAqB,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,GAChF,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,kBAAkB,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,GAC7E,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,qBAAqB,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC,CAAC;AAEtF,KAAK,iBAAiB,CAAC,OAAO,SAAS,MAAM,IAAI;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gGAAgG;IAChG,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,EAAE,SAAS,OAAO,EAAE,CAAC;IACxC,wEAAwE;IACxE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD,QAAQ,CAAC,OAAO,CAAC,EAAE,0BAA0B,CAAC;IAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,0BAA0B,CAAC;CAC9C,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,UAAU,CAAC,OAAO,SAAS,MAAM,IACzC,CAAC,iBAAiB,CAAC,OAAO,CAAC,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,GAC3D,CAAC,iBAAiB,CAAC,OAAO,CAAC,GAAG;IAC5B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,gBAAgB,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnF,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,OAAO,CAAC;QAAC,eAAe,CAAC,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;CACjG,CAAC,GACF,CAAC,iBAAiB,CAAC,OAAO,CAAC,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC,CAAC;AAKjE,MAAM,WAAW,eAAe,CAAC,OAAO,SAAS,MAAM;IACrD,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,MAAM,iBAAiB,CAAC,OAAO,SAAS,MAAM,IAAI,QAAQ,CAAC;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAE5G,MAAM,WAAW,eAAe,CAAC,OAAO,SAAS,MAAM,EAAE,OAAO,SAAS,MAAM;IAC7E,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gGAAgG;IAChG,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAChE,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;IACrF,QAAQ,CAAC,KAAK,EAAE,yBAAyB,CAAC;IAC1C,gFAAgF;IAChF,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,8FAA8F;IAC9F,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,2GAA2G;IAC3G,QAAQ,CAAC,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;IAClD,6FAA6F;IAC7F,QAAQ,CAAC,YAAY,CAAC,EAAE,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACnD,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC;IACtD,+EAA+E;IAC/E,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAC;IACrD,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IACnC,yFAAyF;IACzF,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAChD,8EAA8E;IAC9E,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IAChD;;;OAGG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;CAChE;AAED,KAAK,WAAW,CAAC,OAAO,SAAS,MAAM,EAAE,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,IAAI;IACrH,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,MAAM,GAAG,MAAM,CAAC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,2GAA2G;IAC3G,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;IACzC,YAAY,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,MAAM,GAAG,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CACtF,CAAC;AAEF,qBAAa,oBAAqB,SAAQ,KAAK;IACpC,IAAI,SAA0B;CACxC;AAyQD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,KAAK,CAAC,OAAO,SAAS,MAAM,EAC5B,KAAK,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,EAChF,MAAM,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,eAAe,CAAC,OAAO,EAAE,MAAM,MAAM,GAAG,MAAM,CAAC,CAEvF;AAED,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAErD;AAED,4EAA4E;AAC5E,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAW/F,qGAAqG;AACrG,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEvE;AAED,4GAA4G;AAC5G,wBAAgB,WAAW,CAAC,KAAK,SAAS,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,CAErE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,CAAC,OAAO,SAAS,MAAM,EAC5B,KAAK,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,EAChF,MAAM,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,MAAM,MAAM,GAAG,MAAM,CAAC,CAE3G"}
|
|
@@ -196,9 +196,11 @@ const DEFINED_BOARD = Symbol("DefinedBoard");
|
|
|
196
196
|
/**
|
|
197
197
|
* Declares a board in code.
|
|
198
198
|
*
|
|
199
|
-
* @deprecated
|
|
200
|
-
*
|
|
201
|
-
* boards
|
|
199
|
+
* @deprecated Write the board's definition into projects with `factory.upsertBoard()`, or manage
|
|
200
|
+
* it through the boards API
|
|
201
|
+
* (`/web/factory/projects/:id/boards`, README "Stored boards"); removal is tracked in
|
|
202
|
+
* mastra-ai/mastra#28920. A board defined here still works: each project stores it once and is
|
|
203
|
+
* served from its row, with the code behaviour it declares.
|
|
202
204
|
*/
|
|
203
205
|
function defineBoard(config) {
|
|
204
206
|
return buildBoard(config, true);
|
|
@@ -207,11 +209,29 @@ function defineBoard(config) {
|
|
|
207
209
|
function isDefinedBoard(board) {
|
|
208
210
|
return DEFINED_BOARD in board;
|
|
209
211
|
}
|
|
210
|
-
/**
|
|
211
|
-
|
|
212
|
-
|
|
212
|
+
/**
|
|
213
|
+
* The declaration a board was built from. A resolved board's `onEnter` handlers already carry its
|
|
214
|
+
* runner's skill and instructions, so a board with other runner fields is rebuilt from this.
|
|
215
|
+
*/
|
|
216
|
+
const BOARD_DECLARATION = Symbol("BoardDeclaration");
|
|
217
|
+
/** On a board built from a stored definition, the code board that gave it its behaviour. */
|
|
218
|
+
const CODE_BOARD = Symbol("CodeBoard");
|
|
219
|
+
/** The declaration a board was built from; undefined for an object that was not built as a board. */
|
|
220
|
+
function declarationOf(board) {
|
|
221
|
+
return board[BOARD_DECLARATION];
|
|
222
|
+
}
|
|
223
|
+
/** The code board a board takes its behaviour from: itself unless it was built from a stored definition. */
|
|
224
|
+
function codeBoardOf(board) {
|
|
225
|
+
return board[CODE_BOARD] ?? board;
|
|
226
|
+
}
|
|
227
|
+
/**
|
|
228
|
+
* Validates and resolves a board declaration. Factory's own boards use this directly. A board
|
|
229
|
+
* built from a stored definition names the code board whose behaviour it carries.
|
|
230
|
+
*/
|
|
231
|
+
function compileBoardDefinition(config, codeBoard) {
|
|
232
|
+
return buildBoard(config, false, codeBoard);
|
|
213
233
|
}
|
|
214
|
-
function buildBoard(config, defined) {
|
|
234
|
+
function buildBoard(config, defined, codeBoard) {
|
|
215
235
|
validateBoardIdentifier(config.id, "Board id");
|
|
216
236
|
const boardName = resolveName(config.name, config.title, `Board "${config.id}"`);
|
|
217
237
|
const boardDescription = optionalText(config.description, `Board "${config.id}" description`, MAX_DESCRIPTION_LENGTH);
|
|
@@ -323,8 +343,10 @@ function buildBoard(config, defined) {
|
|
|
323
343
|
}
|
|
324
344
|
};
|
|
325
345
|
if (defined) Object.defineProperty(board, DEFINED_BOARD, { value: true });
|
|
346
|
+
Object.defineProperty(board, BOARD_DECLARATION, { value: config });
|
|
347
|
+
if (codeBoard) Object.defineProperty(board, CODE_BOARD, { value: codeBoardOf(codeBoard) });
|
|
326
348
|
return Object.freeze(board);
|
|
327
349
|
}
|
|
328
|
-
export { BoardDefinitionError, DEFAULT_PHASE_CONTEXT, FACTORY_AGENT_ID, compileBoardDefinition, defineBoard, isDefinedBoard };
|
|
350
|
+
export { BoardDefinitionError, DEFAULT_PHASE_CONTEXT, FACTORY_AGENT_ID, codeBoardOf, compileBoardDefinition, declarationOf, defineBoard, isDefinedBoard };
|
|
329
351
|
|
|
330
352
|
//# sourceMappingURL=define-board.js.map
|