@mastra/factory 0.28.0-alpha.5 → 0.28.0-alpha.6
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 +52 -28
- package/dist/auth.d.ts.map +1 -1
- package/dist/auth.js +5 -5
- package/dist/auth.js.map +1 -1
- package/dist/boards/board-writes.d.ts.map +1 -1
- package/dist/boards/board-writes.js +6 -7
- package/dist/boards/board-writes.js.map +1 -1
- package/dist/boards/index.d.ts +1 -1
- package/dist/boards/index.d.ts.map +1 -1
- package/dist/boards/index.js +2 -2
- package/dist/boards/project-boards.d.ts +30 -4
- package/dist/boards/project-boards.d.ts.map +1 -1
- package/dist/boards/project-boards.js +71 -19
- package/dist/boards/project-boards.js.map +1 -1
- package/dist/boards/registry.d.ts +7 -1
- package/dist/boards/registry.d.ts.map +1 -1
- package/dist/boards/registry.js +16 -3
- package/dist/boards/registry.js.map +1 -1
- package/dist/boards/semantics.d.ts +5 -4
- package/dist/boards/semantics.d.ts.map +1 -1
- package/dist/boards/semantics.js +5 -4
- package/dist/boards/semantics.js.map +1 -1
- package/dist/boards/work-migrations.d.ts +4 -3
- package/dist/boards/work-migrations.d.ts.map +1 -1
- package/dist/boards/work-migrations.js +6 -5
- package/dist/boards/work-migrations.js.map +1 -1
- package/dist/boards/work-seeds.d.ts +9 -0
- package/dist/boards/work-seeds.d.ts.map +1 -0
- package/dist/boards/work-seeds.js +56 -0
- package/dist/boards/work-seeds.js.map +1 -0
- package/dist/boards/work.d.ts +2 -2
- package/dist/boards/work.d.ts.map +1 -1
- package/dist/boards/work.js +0 -16
- package/dist/boards/work.js.map +1 -1
- package/dist/factory.d.ts +8 -4
- package/dist/factory.d.ts.map +1 -1
- package/dist/factory.js +30 -58
- package/dist/factory.js.map +1 -1
- package/dist/feed-events.d.ts +2 -3
- package/dist/feed-events.d.ts.map +1 -1
- package/dist/feed-events.js +4 -5
- package/dist/feed-events.js.map +1 -1
- package/dist/index.d.ts +2 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +3 -1
- package/dist/integrations/base.d.ts +0 -11
- package/dist/integrations/base.d.ts.map +1 -1
- package/dist/integrations/linear/agent-tools.d.ts.map +1 -1
- package/dist/integrations/linear/agent-tools.js +1 -1
- package/dist/integrations/linear/agent-tools.js.map +1 -1
- package/dist/integrations/slack/integration.d.ts +0 -2
- package/dist/integrations/slack/integration.d.ts.map +1 -1
- package/dist/integrations/slack/integration.js +0 -5
- package/dist/integrations/slack/integration.js.map +1 -1
- package/dist/integrations/slack/slack.d.ts +3 -18
- package/dist/integrations/slack/slack.d.ts.map +1 -1
- package/dist/integrations/slack/slack.js +3 -74
- package/dist/integrations/slack/slack.js.map +1 -1
- package/dist/links.d.ts +1 -2
- package/dist/links.d.ts.map +1 -1
- package/dist/links.js +1 -2
- package/dist/links.js.map +1 -1
- package/dist/routes/attention-providers.d.ts +0 -25
- package/dist/routes/attention-providers.d.ts.map +1 -1
- package/dist/routes/attention-providers.js +2 -150
- package/dist/routes/attention-providers.js.map +1 -1
- package/dist/routes/attention.d.ts +0 -2
- package/dist/routes/attention.d.ts.map +1 -1
- package/dist/routes/attention.js +2 -13
- package/dist/routes/attention.js.map +1 -1
- package/dist/routes/contracts.d.ts +6 -14
- package/dist/routes/contracts.d.ts.map +1 -1
- package/dist/routes/contracts.js +4 -2
- package/dist/routes/contracts.js.map +1 -1
- package/dist/routes/feed-events.d.ts +15 -0
- package/dist/routes/feed-events.d.ts.map +1 -0
- package/dist/routes/feed-events.js +68 -0
- package/dist/routes/feed-events.js.map +1 -0
- package/dist/routes/knowledge.js +1 -1
- package/dist/routes/projects.d.ts +1 -1
- package/dist/routes/projects.d.ts.map +1 -1
- package/dist/routes/projects.js +1 -1
- package/dist/routes/projects.js.map +1 -1
- package/dist/routes/surface.d.ts +0 -7
- package/dist/routes/surface.d.ts.map +1 -1
- package/dist/routes/surface.js +1 -5
- package/dist/routes/surface.js.map +1 -1
- package/dist/routes/work-items.d.ts +0 -3
- package/dist/routes/work-items.d.ts.map +1 -1
- package/dist/routes/work-items.js +0 -1
- package/dist/routes/work-items.js.map +1 -1
- package/dist/rules/dispatcher.d.ts +0 -3
- package/dist/rules/dispatcher.d.ts.map +1 -1
- package/dist/rules/dispatcher.js +5 -7
- package/dist/rules/dispatcher.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 +0 -4
- package/dist/storage/domains/audit/actions.js.map +1 -1
- package/dist/storage/domains/boards/base.d.ts +15 -1
- package/dist/storage/domains/boards/base.d.ts.map +1 -1
- package/dist/storage/domains/boards/base.js +21 -5
- package/dist/storage/domains/boards/base.js.map +1 -1
- package/dist/storage/domains/channel-identity/base.d.ts +0 -4
- package/dist/storage/domains/channel-identity/base.d.ts.map +1 -1
- package/dist/storage/domains/channel-identity/base.js +0 -7
- package/dist/storage/domains/channel-identity/base.js.map +1 -1
- package/dist/storage/domains/work-items/base.d.ts +6 -8
- package/dist/storage/domains/work-items/base.d.ts.map +1 -1
- package/dist/storage/domains/work-items/base.js +9 -84
- package/dist/storage/domains/work-items/base.js.map +1 -1
- package/dist/storage/domains/work-items/cards.d.ts +3 -3
- package/dist/storage/domains/work-items/cards.d.ts.map +1 -1
- package/dist/storage/domains/work-items/cards.js +10 -10
- package/dist/storage/domains/work-items/cards.js.map +1 -1
- package/dist/storage/domains/work-items/work-item-schema.d.ts +1 -2
- package/dist/storage/domains/work-items/work-item-schema.d.ts.map +1 -1
- package/dist/storage/domains/work-items/work-item-schema.js +8 -8
- package/dist/storage/domains/work-items/work-item-schema.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 +3 -14
- package/dist/tools/read-tools.js.map +1 -1
- package/dist/tools/work-item-tools.d.ts +0 -3
- package/dist/tools/work-item-tools.d.ts.map +1 -1
- package/dist/tools/work-item-tools.js +8 -18
- package/dist/tools/work-item-tools.js.map +1 -1
- package/dist/work-items/create-work-item.d.ts.map +1 -1
- package/dist/work-items/create-work-item.js +3 -2
- package/dist/work-items/create-work-item.js.map +1 -1
- package/dist/work-items/description-context.d.ts +5 -0
- package/dist/work-items/description-context.d.ts.map +1 -0
- package/dist/work-items/description-context.js +17 -0
- package/dist/work-items/description-context.js.map +1 -0
- package/dist/work-items/split-migration.d.ts.map +1 -1
- package/dist/work-items/split-migration.js +1 -6
- package/dist/work-items/split-migration.js.map +1 -1
- package/factory-skills/configure-factory-rules/SKILL.md +3 -3
- package/factory-skills/factory-rereview/SKILL.md +2 -2
- package/factory-skills/factory-review/SKILL.md +2 -2
- package/factory-skills/factory-triage/SKILL.md +3 -2
- package/package.json +6 -6
- package/dist/integrations/slack/emoji-shortcodes.generated.d.ts +0 -8
- package/dist/integrations/slack/emoji-shortcodes.generated.d.ts.map +0 -1
- package/dist/integrations/slack/emoji-shortcodes.generated.js +0 -1984
- package/dist/integrations/slack/emoji-shortcodes.generated.js.map +0 -1
- package/dist/integrations/slack/emoji.d.ts +0 -3
- package/dist/integrations/slack/emoji.d.ts.map +0 -1
- package/dist/integrations/slack/emoji.js +0 -11
- package/dist/integrations/slack/emoji.js.map +0 -1
- package/dist/integrations/slack/feed-publisher.d.ts +0 -26
- package/dist/integrations/slack/feed-publisher.d.ts.map +0 -1
- package/dist/integrations/slack/feed-publisher.js +0 -43
- package/dist/integrations/slack/feed-publisher.js.map +0 -1
- package/dist/routes/attention-activity.d.ts +0 -23
- package/dist/routes/attention-activity.d.ts.map +0 -1
- package/dist/routes/attention-activity.js +0 -154
- package/dist/routes/attention-activity.js.map +0 -1
- package/dist/storage/domains/comments/activity.d.ts +0 -40
- package/dist/storage/domains/comments/activity.d.ts.map +0 -1
- package/dist/storage/domains/comments/activity.js +0 -93
- package/dist/storage/domains/comments/activity.js.map +0 -1
- package/dist/storage/domains/comments/actor.d.ts +0 -51
- package/dist/storage/domains/comments/actor.d.ts.map +0 -1
- package/dist/storage/domains/comments/actor.js +0 -37
- package/dist/storage/domains/comments/actor.js.map +0 -1
- package/dist/storage/domains/comments/base.d.ts +0 -245
- package/dist/storage/domains/comments/base.d.ts.map +0 -1
- package/dist/storage/domains/comments/base.js +0 -539
- package/dist/storage/domains/comments/base.js.map +0 -1
- package/dist/storage/domains/comments/domain.d.ts +0 -135
- package/dist/storage/domains/comments/domain.d.ts.map +0 -1
- package/dist/storage/domains/comments/domain.js +0 -284
- package/dist/storage/domains/comments/domain.js.map +0 -1
- package/dist/storage/domains/comments/feed-context.d.ts +0 -22
- package/dist/storage/domains/comments/feed-context.d.ts.map +0 -1
- package/dist/storage/domains/comments/feed-context.js +0 -88
- package/dist/storage/domains/comments/feed-context.js.map +0 -1
- package/dist/storage/domains/comments/feed-sync.d.ts +0 -21
- package/dist/storage/domains/comments/feed-sync.d.ts.map +0 -1
- package/dist/storage/domains/comments/feed-sync.js +0 -1
- package/dist/storage/domains/comments/parse.d.ts +0 -23
- package/dist/storage/domains/comments/parse.d.ts.map +0 -1
- package/dist/storage/domains/comments/parse.js +0 -89
- package/dist/storage/domains/comments/parse.js.map +0 -1
- package/dist/storage/domains/comments/routes.d.ts +0 -24
- package/dist/storage/domains/comments/routes.d.ts.map +0 -1
- package/dist/storage/domains/comments/routes.js +0 -301
- package/dist/storage/domains/comments/routes.js.map +0 -1
- package/dist/storage/domains/comments/schema.d.ts +0 -5
- package/dist/storage/domains/comments/schema.d.ts.map +0 -1
- package/dist/storage/domains/comments/schema.js +0 -178
- package/dist/storage/domains/comments/schema.js.map +0 -1
- package/dist/storage/domains/comments/wire.d.ts +0 -40
- package/dist/storage/domains/comments/wire.d.ts.map +0 -1
- package/dist/storage/domains/comments/wire.js +0 -36
- package/dist/storage/domains/comments/wire.js.map +0 -1
package/README.md
CHANGED
|
@@ -116,7 +116,7 @@ There is no dual-write rollback: an older Factory version sees the legacy snapsh
|
|
|
116
116
|
|
|
117
117
|
Each project's boards live in its database, and the stored row is the board.
|
|
118
118
|
|
|
119
|
-
- **Factory's boards**: the built-in Work board and the boards you pass to `new MastraFactory({ boards })` (app boards). Factory stores each in a project once: when the project is created, and in existing projects the first time a process loads them, which includes the preload at startup. The project keeps a key's board from then on. A Factory release or an app change never rewrites it (except through a [board migration](#board-migrations)), and a board the project deleted is not stored again. A key you add later is stored once in every project that hasn't had it. The retired Review board is never stored, and its `review` key is reserved: no board can be created or written under it. A project that still has open cards on it is served the code Review board, read-only (see [The retired Review board](#the-retired-review-board)).
|
|
119
|
+
- **Factory's boards**: the built-in Work board and the boards you pass to `new MastraFactory({ boards })` (app boards). Factory stores each in a project once: when the project is created, and in existing projects the first time a process loads them, which includes the preload at startup. Work goes only into a project that has no boards yet: a project that already holds a board, such as one your app wrote with `factory.upsertBoard()`, gets no Work from Factory. A project created now (the create call onboarding makes) gets Work without a Triage phase: Intake, Planning, Building, Review, Done and Canceled. Every other project, including one created on an older release that stores its boards only now, gets Work with Triage, as Factory always stored it, and resetting Factory's Work restores Factory's built-in Work, with Triage if Factory first stored the project's Work with it (an app's `work` board upserted with `projects: 'all'` resets to the app's; one upserted only to named projects resets to Factory's). Add Triage back in Settings › Work board if you want it. The project keeps a key's board from then on. A Factory release or an app change never rewrites it (except through a [board migration](#board-migrations)), and a board the project deleted is not stored again. A key you add later is stored once in every project that hasn't had it. The retired Review board is never stored, and its `review` key is reserved: no board can be created or written under it. A project that still has open cards on it is served the code Review board, read-only (see [The retired Review board](#the-retired-review-board)).
|
|
120
120
|
- **The project's own boards**: boards an admin created through the boards API, or that an app wrote with [`factory.upsertBoard()`](#writing-a-board-into-projects).
|
|
121
121
|
|
|
122
122
|
A project's boards are the Work and app boards in code order, followed by the others. The catalog, card creation through the API and Factory tools, transitions, the dispatcher, phase runs and the attention views all read that list. Existing apps need no change.
|
|
@@ -150,7 +150,7 @@ A release that changes what Factory's own boards need can carry a board migratio
|
|
|
150
150
|
|
|
151
151
|
#### Writing a board into projects
|
|
152
152
|
|
|
153
|
-
`factory.upsertBoard()` writes a board definition into projects after `prepare()`: each named project (or all of them) that has no board under its key gets it, and each one that has it, edited or not, has it replaced at the next revision.
|
|
153
|
+
`factory.upsertBoard()` writes a board definition into projects after `prepare()`: each named project (or all of them) that has no board under its key gets it, and each one that has it, edited or not, has it replaced at the next revision. Run it after `prepare()` at every startup to ship your boards: with `projects: 'all'`, a project that has no boards yet when it first loads (one created later, during onboarding, or one that never loaded) gets the board too, before Factory's own, so a project that gets your `work` board never gets Factory's Work beside it. Factory only adds Work to a project with no boards. That lasts for the process, which is why it runs at every startup; a project that already has boards is changed only by the call itself. The board is checked once, as the boards API checks it, each replacement passes the checks an edit does (cards in a removed phase refuse it with `phase_in_use` there), and each write is audited as `factory.board.created` or `factory.board.updated` by `system:factory`. It returns the projects it stored the board in, the ones it replaced it in, and the ones that already had it unchanged. A refused board throws `BoardWriteError`, whose `code` is the boards API's error code (`invalid_board`, `unknown_skill`, `code_behaviour`, `phase_in_use`, `project_not_found`, or `reserved_board` for the retired Review board's `review` key). A board under a new key has no code behaviour; an app board's key keeps the app board's, so it also brings back an app board a project deleted.
|
|
154
154
|
|
|
155
155
|
```ts
|
|
156
156
|
const bugs = {
|
|
@@ -232,7 +232,7 @@ Admins can make the same edits in the Factory UI under **Settings → Boards**,
|
|
|
232
232
|
[Mastra Factory] MastraFactory({ boards }) and defineBoard() are deprecated: boards live in the database, and each project stores these definitions once. Write board definitions into projects with factory.upsertBoard(), or manage them through the boards API; see the README "Stored boards" section and mastra-ai/mastra#28920.
|
|
233
233
|
```
|
|
234
234
|
|
|
235
|
-
`includeDefaultBoards`
|
|
235
|
+
`includeDefaultBoards` is deprecated and ignored, with a warning logged once: Factory adds its Work to a project only on the first load that finds it with no boards, and a project that has any keeps what it has. Two cases get no Work from Factory: a project an app's `upsertBoard(board, { projects: 'all' })` reached first (it gets the app's boards instead), and a project Factory already stored Work in once: Factory never adds it a second time (Work itself can't be deleted, only reset). To run your own Work board, write it under the `work` key with `factory.upsertBoard(board, { projects: 'all' })` at startup (see below).
|
|
236
236
|
|
|
237
237
|
Using only the built-in boards logs nothing. A board that cards reach only through the API, the Factory UI or Factory tools, and that needs no policies or rules, can move off code: write its definition under a new key into projects with `factory.upsertBoard()`, move its cards, then stop passing the code board. Keep passing a board while it needs code behaviors.
|
|
238
238
|
|
|
@@ -276,19 +276,45 @@ export function createFactory(storage: MastraFactoryConfig['storage']) {
|
|
|
276
276
|
|
|
277
277
|
To migrate, move each handler's skill into the phase's `runner.skill` (its prompt into `runner.instructions` or the skill), put card context the handler read into the skill (agents get it from the [`factory-work-item` signal](#the-factory-work-item-signal)), and list outcome targets in `nextPhases`. A handler that refused a move becomes a `transitionPolicy` rejection (`nextPhases` is the only limit on where a card may go).
|
|
278
278
|
|
|
279
|
-
To replace Work,
|
|
279
|
+
To replace Work, write your board under the `work` key with `factory.upsertBoard()` at every startup, after `prepare()`. It replaces the Work board every existing project stored, at that row's current revision, so edits people made to Work in Settings are discarded each time it runs; a project created later gets yours instead of Factory's. Work's code rules still attach by the key, so for now a board stored under `work` must keep Work's code phases and moves: Intake stays first, and Intake, Planning (`planning`), Building (`execute`), Review (`pr-review`), Done and Canceled keep their kind and every move Work makes between them, or `upsertBoard` refuses it with `code_behaviour`. Names, runners, exit tools, start conditions, added phases and added moves are free; boards under any other key have no such limit. Upserted with `projects: 'all'`, resetting it restores your board as this process last upserted it, not Factory's Work, and Factory's one-time Work migrations don't run on it once registered (registration happens in `upsertBoard`, after `prepare()` loaded existing projects, so a migration a new release adds can run once on the stored `work` row during `prepare()`; your `upsertBoard` call right after writes your board back over it); an upsert to named projects registers nothing, so those projects reset to Factory's Work and get its migrations. Start from `workSeedWithTriage()`, Work as existing projects store it, and edit it. Keep Triage while any project may have cards in it: `upsertBoard` refuses (`409 phase_in_use`) to drop a phase that holds cards, and with `projects: 'all'` that stops the call partway, after earlier projects were already replaced. To drop Triage, move its cards out first. A project created now has no Triage and gains it from this board. For example, renaming Planning, auto-starting it and adding a Blocked phase:
|
|
280
280
|
|
|
281
281
|
```typescript
|
|
282
|
-
import {
|
|
282
|
+
import { Mastra } from '@mastra/core/mastra';
|
|
283
|
+
import { MastraFactory, workSeedWithTriage } from '@mastra/factory';
|
|
284
|
+
import type { StoredBoardInput } from '@mastra/factory';
|
|
285
|
+
|
|
286
|
+
// Work with Triage, as existing projects store it. Dropping Triage fails while cards sit in it.
|
|
287
|
+
const work = workSeedWithTriage();
|
|
288
|
+
const ourWorkBoard: StoredBoardInput = {
|
|
289
|
+
...work,
|
|
290
|
+
phases: [
|
|
291
|
+
...work.phases.map(phase => {
|
|
292
|
+
// Free: names, runners and start conditions.
|
|
293
|
+
if (phase.key === 'planning') {
|
|
294
|
+
return {
|
|
295
|
+
...phase,
|
|
296
|
+
name: 'Plan',
|
|
297
|
+
autoStart: true,
|
|
298
|
+
runner: { ...phase.runner, instructions: 'Follow docs/planning.md.' },
|
|
299
|
+
};
|
|
300
|
+
}
|
|
301
|
+
// Free: added moves.
|
|
302
|
+
if (phase.key === 'execute') return { ...phase, nextPhases: [...(phase.nextPhases ?? []), 'blocked'] };
|
|
303
|
+
return phase;
|
|
304
|
+
}),
|
|
305
|
+
// Free: added phases.
|
|
306
|
+
{ key: 'blocked', name: 'Blocked', kind: 'resting', nextPhases: ['planning', 'execute', 'canceled'] },
|
|
307
|
+
],
|
|
308
|
+
};
|
|
283
309
|
|
|
284
|
-
const factory = new MastraFactory({
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
310
|
+
const factory = new MastraFactory({ storage });
|
|
311
|
+
const mastraArgs = await factory.prepare(); // prepare() runs once: keep its result
|
|
312
|
+
await factory.upsertBoard(ourWorkBoard, { projects: 'all' });
|
|
313
|
+
export const mastra = new Mastra(mastraArgs);
|
|
314
|
+
await factory.finalize();
|
|
289
315
|
```
|
|
290
316
|
|
|
291
|
-
|
|
317
|
+
Passing a board with the `work` ID in `boards` throws: Work is always installed, so store yours under its key instead. Cards stored before board tracking resolve to `work`, and some runtime and UI behavior is keyed to those IDs, including Work issue intake and triage, the review-requested filter, and funnel metrics. Keep the built-in phase names and contexts in a replacement unless you intend to change that behavior.
|
|
292
318
|
|
|
293
319
|
**Preferred intake behavior:** By default, every integration arrival lands in its routed board's initial phase—Intake for Work—and does not start or suggest a run. This includes GitHub, GitLab, Linear, Jira, and incident.io. An [intake route](#intake-routes) can file new cards straight into another phase, such as Triage, whose runner then starts (on its own when the phase's `autoStart` or `autoStartWhen` allows it). Trusted maintainer requests to review a GitHub pull request with no existing card file it directly in Work's Review.
|
|
294
320
|
|
|
@@ -417,12 +443,11 @@ Contexts that carried `ruleSetVersion` now carry `configVersion`. To add a tool-
|
|
|
417
443
|
|
|
418
444
|
Boards own two separate concerns: topology (`nextPhases`) declares which moves exist, and each working phase's runner starts the work on entry. `nextPhases` binds everyone: people dragging cards on the Factory board, agents calling `factory_transition_work_item`, and board rules. A move it does not list is rejected with `invalid_transition`. Staying in the same phase is always allowed.
|
|
419
445
|
|
|
420
|
-
The built-in Work board lists these moves:
|
|
446
|
+
The built-in Work board lists these moves (projects stored before new projects' Work dropped Triage also have Triage, entered from Intake and Planning, and leaving to Intake, Planning, Done or Canceled: a confirmed bug goes to Planning, any other open issue waits in Intake for a person):
|
|
421
447
|
|
|
422
448
|
| From | To | Why |
|
|
423
449
|
| -------- | ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
424
|
-
| Intake |
|
|
425
|
-
| Triage | Intake, Planning, Done, Canceled | A confirmed bug goes to Planning; any other open issue waits in Intake for a person. |
|
|
450
|
+
| Intake | Planning, Review, Done, Canceled | Never straight to Building: a plan comes first. Review takes a card that carries a pull request; Done is where a completed source closes it. |
|
|
426
451
|
| Planning | Building, Intake, Done, Canceled | Into Building only through the approved plan (see `exitTool` below). |
|
|
427
452
|
| Building | Review, Planning, Done, Canceled | Review once the builder opened the change request; Planning again when the build shows the plan was wrong. |
|
|
428
453
|
| Review | Intake, Planning, Building, Done, Canceled | A card with a pull request: merged, closed, or set aside in Intake. A pull request's own card never reaches the builder's lanes. |
|
|
@@ -433,7 +458,7 @@ Work's Review phase is keyed `pr-review`: it reviews a card's pull request.
|
|
|
433
458
|
|
|
434
459
|
A pull request's own card only enters Intake, Review, Done and Canceled, and only a card that carries a pull request (its own, or one attached to an issue card) enters Review, for people too. An issue card with an attached pull request can still go back to Planning or Building for a fix; Intake leads to both Triage and Review and which one fits depends on the card, so this one rule stays in code (`workPullRequestCardRejection`). Planning ends with `submit_plan`, its exit tool: a plan waits for a person to approve it, and the approved plan moves the card to Building. Whether work is finished (no open pull request, no review asking for changes) is not checked by the board: the build instructions tell the agent when to move a card to Done. Intake is resting, so nothing runs on a card parked there; an agent in another session could still move it.
|
|
435
460
|
|
|
436
|
-
**Triage
|
|
461
|
+
**Triage** (projects that have it). The triage agent sends a confirmed bug to Planning, an open non-bug back to Intake, and closures to Done or Canceled. A person moving the card on from Intake is the approval; Factory records no classification or acceptance, and that move removes the `status: needs approval` label from the GitHub issue. On boot, Factory moves any card left in Triage by the old classify-and-accept rule back to Intake, once.
|
|
437
462
|
|
|
438
463
|
**A board without an approval wait.** A board that should start work on its own says so in its triage phase's `runner.instructions` (for example `This board needs no approval before work starts.`). factory-triage then sends an open feature request, docs or maintenance item from a trusted author, that the repository would take on, to the phase a confirmed bug goes to (Planning on Work) instead of back to rest, and adds no `status: needs approval` label. Untrusted authors, questions and anything to close still rest or close as before. The agent's move starts the planning run without a person, whether or not that phase has `autoStart`: an agent's move consents to the runs it queues. Work's triage phase has no instructions, so Work keeps its approval wait.
|
|
439
464
|
|
|
@@ -479,12 +504,12 @@ const releaseBoard = defineBoard({
|
|
|
479
504
|
|
|
480
505
|
Work declares `intake` resting; `triage`, `planning`, `execute` and `pr-review` (named Review, the independent review of a card's pull request) working; `done` and `canceled` terminal. Its working phases run on stored runners, which an admin can edit:
|
|
481
506
|
|
|
482
|
-
| Phase | Runner | Also
|
|
483
|
-
| -------- | ---------------------------------------------------- |
|
|
484
|
-
| Triage | `factory-triage` in `triage` | Investigates the issue; a card labelled `status: needs approval` gets a summary of the decision needed instead.
|
|
485
|
-
| Planning | `factory-plan` in `work` | Exit tool `submit_plan`, never auto-approved; once the plan is approved the planner moves the card to Building.
|
|
486
|
-
| Building | `factory-build` in `work`, as a goal (up to 20 runs) | Builds the approved plan, runs its gates and pushes, then opens the change request and moves the card to Review.
|
|
487
|
-
| Review | `factory-review` in `review` | Grants `factory_record_review_verdict` and `factory_review_source`.
|
|
507
|
+
| Phase | Runner | Also |
|
|
508
|
+
| -------- | ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
509
|
+
| Triage | `factory-triage` in `triage` | Projects stored before new projects' Work dropped Triage. Investigates the issue; a card labelled `status: needs approval` gets a summary of the decision needed instead. |
|
|
510
|
+
| Planning | `factory-plan` in `work` | Exit tool `submit_plan`, never auto-approved; once the plan is approved the planner moves the card to Building. |
|
|
511
|
+
| Building | `factory-build` in `work`, as a goal (up to 20 runs) | Builds the approved plan, runs its gates and pushes, then opens the change request and moves the card to Review. |
|
|
512
|
+
| Review | `factory-review` in `review` | Grants `factory_record_review_verdict` and `factory_review_source`. |
|
|
488
513
|
|
|
489
514
|
The review skills post their test results in a `## Factory test report` comment on the change request. Factory gives sessions no tool to publish a commit check; an app that wants one passes its own tool and builds it on `factory.reviewedChangeRequest()` (see [Mastra Connect and your own tools in sessions](#mastra-connect-and-your-own-tools-in-sessions)). Earlier releases had a per-project `reviewTestChecksEnabled` setting; `PATCH /web/factory/projects/:id` still accepts it for one release and ignores it.
|
|
490
515
|
|
|
@@ -775,17 +800,16 @@ const releaseBoard = defineBoard<'release', Record<ReleasePhase, BoardPhaseDefin
|
|
|
775
800
|
},
|
|
776
801
|
});
|
|
777
802
|
|
|
778
|
-
export function createFactory(config: Omit<MastraFactoryConfig, 'boards'
|
|
803
|
+
export function createFactory(config: Omit<MastraFactoryConfig, 'boards'>) {
|
|
779
804
|
return new MastraFactory({
|
|
780
805
|
...config,
|
|
781
806
|
boards: [releaseBoard],
|
|
782
807
|
skills: [prepareRelease, checkRelease],
|
|
783
|
-
includeDefaultBoards: true,
|
|
784
808
|
});
|
|
785
809
|
}
|
|
786
810
|
```
|
|
787
811
|
|
|
788
|
-
Use the host's normal `prepare()`, `new Mastra(...)`, and `finalize()` sequence.
|
|
812
|
+
Use the host's normal `prepare()`, `new Mastra(...)`, and `finalize()` sequence. Working roles name bindings on the shared Code Agent; they do not register separate agents. Factory has no per-role agent configuration option. Each phase's skill supplies the role-specific instructions.
|
|
789
813
|
|
|
790
814
|
Create a card with `POST /web/factory/projects/:id/work-items`, passing `board: 'release'`, a title, and the GitHub issue's `externalSource`. The card starts in `backlog`. Then use `POST /web/factory/projects/:id/work-items/:workItemId/transition` with `board: 'release'`, `stage: 'preparing'`, the returned `expectedRevision`, a unique `requestId`, and a `cause`. Send these requests as an authorized user using the host's authentication. The move starts the preparer. Its bound tool advances to `build`; the publisher's completed check produces a deferred transition to `done`. Terminal entry revokes the binding and releases the sandbox. The Factory UI performs the same operations against installed boards (see below); verify the persisted card's board, phase, and deferred decision status either way.
|
|
791
815
|
|
|
@@ -890,7 +914,7 @@ The default routes are stored routes like any other: list them, edit them, disab
|
|
|
890
914
|
|
|
891
915
|
Routes are evaluated in `position` order (0 first). Rules can test the [card facts](#phase-runners-automatic-starts-and-exit-tools) phase rules test, `source.repository` and `item.labels` among them. For pull requests, routes can also test `pullRequest.closesIssue` (`true` when the body closes an issue that has a usable card), `closedIssue.phase` and `closedIssue.hasPullRequest` (that card's phase and whether it already carries a pull request). These three are route-only: phase rules can't use them. A route that lets a pull request join a card already in its review phase doesn't start a second review: the review in progress keeps its pull request, and the new one is reviewed on its next push by a trusted author, or on a review request once the current pass has a verdict. That's why the default route requires `closedIssue.hasPullRequest` to be `false`. `author.trusted` is `true` when the card carries an `authorTrusted: true` or `factoryAuthored: true` stamp. GitHub and GitLab stamp `authorTrusted` from the author's repository permission, and a stamp that is missing counts as untrusted.
|
|
892
916
|
|
|
893
|
-
**Placement.** When an integration files a new card, or a card is created without naming a board (the `factory_create_work_item` tool, or `POST /web/factory/projects/:id/work-items` without `board`), the first enabled route that matches the card and whose board can take it decides where the card lands. On the built-in boards, a pull request lands on Work only in Intake or Review and Review takes only cards with a pull request; a route a card can't take is skipped and the next one is tried. If the route's phase no longer exists, or can no longer be reached from the first phase, the card lands in the first phase. A card routed to a later phase enters the first phase and then moves on through the transition service as a system move, recorded in the card's history. The route makes this move, not a person, so it gives no consent to start work; a run the phase asks for still needs a person unless the phase starts on its own (`autoStart`). A board whose transition policy refuses system moves refuses the route, and the card is not filed. The board and phase an integration's rule names don't count: every integration files a new card in the default board's first phase, and the routes take it from there. If no route places it, it stays there.
|
|
917
|
+
**Placement.** When an integration files a new card, or a card is created without naming a board (the `factory_create_work_item` tool, or `POST /web/factory/projects/:id/work-items` without `board`), the first enabled route that matches the card and whose board can take it decides where the card lands. On the built-in boards, a pull request lands on Work only in Intake or Review and Review takes only cards with a pull request; a route a card can't take is skipped and the next one is tried. If the route's phase no longer exists, or can no longer be reached from the first phase, the card lands in the first phase. A card routed to a later phase enters the first phase and then moves on through the transition service as a system move, recorded in the card's history. The route makes this move, not a person, so it gives no consent to start work; a run the phase asks for still needs a person unless the phase starts on its own (`autoStart`). A board whose transition policy refuses system moves refuses the route, and the card is not filed. The board and phase an integration's rule names don't count: every integration files a new card in the default board's first phase, and the routes take it from there. If no route places it, it stays there. The default board is Work; a project without a Work board (one an app gave only its own boards with `upsertBoard`) uses its first board in catalog order instead, so its arrivals are still filed and placed by its routes. A project with no boards at all files nothing, and refuses cards created without a board, until a board is installed.
|
|
894
918
|
|
|
895
919
|
A card a route placed records the route's id in its `intakeRouteId` metadata and stays on that board afterwards: a GitHub label change, a reconcile that replays a known issue, and rebinding the card's source all leave it there (its labels still update). An edited route moves no existing card. If filing a card stopped partway (it entered the board's first phase but the move to the route's phase failed), the retry keeps the card on that board: it moves to the phase the route names now, or stays in the first phase when the route was deleted, disabled or pointed at another board. An explicit placement wins over routes, for example:
|
|
896
920
|
|
|
@@ -1221,8 +1245,8 @@ A person's own Factory session (a user session) gets tools to find, file and man
|
|
|
1221
1245
|
| `factory_list_work_items` | Optional `query` (title text or `#number`), `stage`, `board`, `role`, `active`, `requestedBy: 'me'`, `subscribed`, `limit` (default 25, max 50) |
|
|
1222
1246
|
| `factory_inspect_work_item` | `workItem` (id or `#number`) |
|
|
1223
1247
|
| `factory_list_attention` | Optional `limit` (max 50) |
|
|
1224
|
-
| `factory_create_work_item` | `title`, `
|
|
1225
|
-
| `factory_update_work_item` | `workItem` plus any of `title`, `repository`, `parentWorkItem` (or `null` to detach)
|
|
1248
|
+
| `factory_create_work_item` | `title`, `description`, optional `repository` (`owner/name`, one this Factory links) |
|
|
1249
|
+
| `factory_update_work_item` | `workItem` plus any of `title`, `description`, `repository`, `parentWorkItem` (or `null` to detach) |
|
|
1226
1250
|
| `factory_subscribe_work_item` | `workItem` |
|
|
1227
1251
|
| `factory_unsubscribe_work_item` | `workItem` |
|
|
1228
1252
|
| `factory_transition_work_item` | `workItem`, `stage` |
|
|
@@ -1239,7 +1263,7 @@ Read tools and `factory_message_origin` are available on every turn. The other t
|
|
|
1239
1263
|
|
|
1240
1264
|
`factory_switch_session_model` changes the model of a side, work item or review session you own in the same Factory, without recreating it. It refuses a model this server can't run. A running session switches right away; a stopped one uses the model on its next run.
|
|
1241
1265
|
|
|
1242
|
-
`factory_create_work_item` files the card as the caller where the project's [intake routes](#intake-routes) send it, or in the Work board's first phase when no route matches,
|
|
1266
|
+
`factory_create_work_item` files the card as the caller where the project's [intake routes](#intake-routes) send it, or in the Work board's first phase when no route matches (a project without Work: its first board's), stores the description that its runs start from, and subscribes the session. Name the `repository` when the Factory links more than one: a run can't start on a card that doesn't say which. `factory_update_work_item` sets it afterwards, like choosing a repository on the card, and also edits the title, the description and the parent item. It can't pre-approve plans: a plan waits for a person unless the board's phase auto-approves it. Both refuse a repository the Factory doesn't link, and a card synced from an issue keeps the issue's repository. Stages, the board and role sessions aren't fields it edits; stages move with `factory_transition_work_item`. Subscriptions are stored per work item and session in the `factory_work_item_subscriptions` collection and are removed with the item, so any number of sessions can follow one item.
|
|
1243
1267
|
|
|
1244
1268
|
#### Messaging between sessions
|
|
1245
1269
|
|
package/dist/auth.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAWvD,OAAO,KAAK,EAAE,QAAQ,EAAE,mBAAmB,EAAoB,MAAM,qBAAqB,CAAC;AAC3F,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAQ1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;
|
|
1
|
+
{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"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"}
|
package/dist/auth.js
CHANGED
|
@@ -1,5 +1,4 @@
|
|
|
1
1
|
import { CUSTOM_DOMAIN_UNSUPPORTED_ERROR, isPlatformAuthSupportedHost } from "./platform-auth-host.js";
|
|
2
|
-
import { actorFromAuthUser } from "./storage/domains/comments/actor.js";
|
|
3
2
|
import { isFactoryTelemetryEnabled } from "./telemetry.js";
|
|
4
3
|
import { timedAboveThreshold } from "./timing.js";
|
|
5
4
|
import { MastraAuthStudio } from "@mastra/auth-studio";
|
|
@@ -98,11 +97,12 @@ function factoryAuthTenant(c) {
|
|
|
98
97
|
function messageAuthor(user) {
|
|
99
98
|
const userId = getFactoryAuthUserId(user);
|
|
100
99
|
if (!userId) return void 0;
|
|
101
|
-
const
|
|
100
|
+
const name = user.name?.trim() || user.email?.trim();
|
|
101
|
+
const avatarUrl = user.avatarUrl?.trim();
|
|
102
102
|
return {
|
|
103
|
-
id:
|
|
104
|
-
...
|
|
105
|
-
...
|
|
103
|
+
id: userId,
|
|
104
|
+
...name ? { name } : {},
|
|
105
|
+
...avatarUrl ? { avatarUrl } : {}
|
|
106
106
|
};
|
|
107
107
|
}
|
|
108
108
|
/** True when both WorkOS credential env vars are present (legacy env gate). */
|
package/dist/auth.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"auth.js","names":[],"sources":["../src/auth.ts"],"sourcesContent":["import { MastraAuthStudio } from '@mastra/auth-studio';\nimport { MastraAuthWorkos } from '@mastra/auth-workos';\nimport type { MessageAuthor } from '@mastra/core/agent-controller';\nimport { MASTRA_MESSAGE_AUTHOR_KEY } from '@mastra/core/request-context';\nimport {\n registerApiRoute,\n isAuthHttpHandler,\n isCredentialsProvider,\n isOrganizationsProvider,\n isSessionProvider,\n isSSOProvider,\n} from '@mastra/core/server';\nimport type { ApiRoute, IMastraAuthProvider, ISessionProvider } from '@mastra/core/server';\nimport type { Context, Hono } from 'hono';\nimport { HTTPException } from 'hono/http-exception';\n\nimport {\n CUSTOM_DOMAIN_UNSUPPORTED_ERROR,\n PLATFORM_AUTH_PROVIDER,\n isPlatformAuthSupportedHost,\n} from './platform-auth-host.js';\nimport type { RouteAuth } from './routes/route.js';\nimport { actorFromAuthUser } from './storage/domains/comments/actor.js';\nimport { isFactoryTelemetryEnabled } from './telemetry.js';\nimport { timedAboveThreshold } from './timing.js';\n\nconst ORGANIZATION_ID_HEADER = 'X-Mastra-Organization-Id';\n\n/**\n * Provider-neutral factory auth gating for the MastraCode web server.\n *\n * When an auth provider is active (a `MastraAuthProvider` instance passed to\n * `MastraFactory`'s `auth` slot, or — back-compat for suites/paths that never\n * boot the factory — implied by the WorkOS env vars), every route on the web\n * server is placed behind it: unauthenticated browser navigations are\n * redirected to the SPA's `/signin` page, API/XHR calls receive a 401, and a\n * small set of public routes stay reachable while signed out — the provider's\n * `/auth/*` routes plus `/auth/me`, the `/signin` page, its `/assets/*` bundle,\n * and the SPA manifest metadata. When no provider is active, `mountFactoryAuth` is a no-op and the server\n * behaves exactly as it does without auth.\n *\n * Provider specifics stay in the providers (`@mastra/auth-workos`,\n * `@mastra/auth-better-auth`, or any custom `IMastraAuthProvider`); this\n * module composes them capability-first via the core type guards:\n * - `authenticateToken` — session/bearer validation (all providers)\n * - `ISSOProvider` — hosted-login `/auth/login`, `/auth/callback`, `/auth/logout`\n * - `IAuthHttpHandler` — provider-owned `/auth/api/*` endpoints (better-auth)\n * - `IOrganizationsProvider` — personal-org bootstrap + admin checks\n * - `ICredentialsProvider.isSignUpEnabled` — SPA sign-up affordance\n * - `getClearSessionHeaders` — session cookie clearing on logout\n */\n\n/** Minimal shape of the signed-in user surfaced to the SPA (no tokens). */\nexport interface FactoryAuthUser {\n /** Stable WorkOS user id used to scope per-user data (GitHub installs etc.). */\n workosId?: string;\n /** Provider user id; WorkOS shapes may use `workosId` instead (see {@link workosId}). */\n id?: string;\n email?: string;\n name?: string;\n /** Provider-supplied profile picture URL, when the auth provider exposes one. */\n avatarUrl?: string;\n /**\n * Organization id. The org is the top-level tenant: it owns the GitHub\n * App installation and connected projects, while each user inside the org gets\n * isolated building instances. Absent for personal (no-org) accounts.\n */\n organizationId?: string;\n /** Organization ids proven by the provider's authenticated membership response. */\n organizationMembershipIds?: string[];\n}\n\n/**\n * Tenant identity: the org is the top-level tenant, and each user inside it is\n * an isolated builder. Agent state, worktrees and sandboxes are scoped per\n * `(orgId, userId)`. Personal (no-org) users have `orgId === undefined`.\n */\nexport interface FactoryAuthTenant {\n /** Organization id, or `undefined` for personal (no-org) accounts. */\n orgId?: string;\n /** Stable provider user id. */\n userId: string;\n}\n\n/**\n * Validate that a `returnTo` value is a safe same-site path, to prevent\n * open-redirect attacks. Only absolute local paths (`/foo`) are allowed;\n * protocol-relative (`//evil.com`) and absolute URLs are rejected.\n */\nexport function sanitizeReturnTo(raw: string | undefined): string {\n if (!raw) return '/';\n if (!raw.startsWith('/')) return '/';\n // Reject protocol-relative URLs like \"//evil.com\" and \"/\\evil.com\".\n if (raw.startsWith('//') || raw.startsWith('/\\\\')) return '/';\n return raw;\n}\n\n/** Extract a bearer token from the Authorization header, if present. */\nexport function getBearerToken(authorization: string | undefined): string {\n if (!authorization) return '';\n const match = /^Bearer\\s+(.+)$/i.exec(authorization);\n return match?.[1] ?? '';\n}\n\n/**\n * Whether the SPA is served cross-origin from this API (platform deploy). When\n * `MASTRACODE_ALLOWED_ORIGINS` is set the browser talks to us cross-site, so\n * session cookies must be `SameSite=None; Secure` for the browser to send them.\n * Same-origin local dev leaves this unset and keeps the stricter `SameSite=Lax`.\n */\nexport function isCrossSiteAuth(): boolean {\n return Boolean(process.env.MASTRACODE_ALLOWED_ORIGINS?.trim());\n}\n\n/** Hono context variables set by the auth gate. */\nexport interface FactoryAuthVariables {\n factoryAuthUser: FactoryAuthUser;\n}\n\n/** Context key under which the gate stashes the authenticated user. */\nconst FACTORY_AUTH_USER_KEY = 'factoryAuthUser';\n\n/**\n * Read the authenticated user the gate stashed on the context, or\n * `undefined` when unauthenticated / auth disabled. Used by downstream routes\n * (e.g. GitHub) to scope rows per user.\n */\nexport function getFactoryAuthUser(c: Context): FactoryAuthUser | undefined {\n return c.get(FACTORY_AUTH_USER_KEY) as FactoryAuthUser | undefined;\n}\n\n/**\n * Read the authenticated user off a request context, normalizing whatever the\n * active auth provider put there.\n *\n * The server's auth layer writes the provider's `authenticateToken` result into\n * the request context's `user` slot verbatim, so the value's shape follows the\n * provider: WorkOS writes a flat user, better-auth writes a `{ session, user }`\n * wrapper whose org lives on the session. Reading that slot as a\n * {@link FactoryAuthUser} therefore yields `undefined` for both the id and the\n * org under better-auth, which reads as \"this session belongs to somebody else\"\n * at every ownership check. Normalize on the way in instead.\n */\nexport function getFactoryAuthUserFromContext(\n requestContext: { get: (key: string) => unknown } | undefined,\n): FactoryAuthUser | undefined {\n if (!requestContext || typeof requestContext.get !== 'function') return undefined;\n return toFactoryAuthUser(requestContext.get('user')) ?? undefined;\n}\n\n/** Resolve the stable user id from an authenticated user shape. */\nexport function getFactoryAuthUserId(user: FactoryAuthUser | undefined): string | undefined {\n return user?.workosId ?? user?.id;\n}\n\n/** Resolve the organization id from a user shape, if present. */\nexport function getFactoryAuthOrgId(user: FactoryAuthUser | undefined): string | undefined {\n return user?.organizationId;\n}\n\n/**\n * The org rung a user's rows are keyed by: the organization they belong to, or a\n * per-user rung for personal (no-org) accounts so their rows never land in the\n * shared `local` scope. Every writer and reader of a `(org, user)` row must\n * agree on this, so it lives here rather than being re-derived per call site.\n */\nexport function factoryUserOrgId(user: FactoryAuthUser | undefined): string | undefined {\n const userId = getFactoryAuthUserId(user);\n if (!userId) return undefined;\n return getFactoryAuthOrgId(user) ?? `user:${userId}`;\n}\n\n/**\n * Resolve the tenant identity `(orgId, userId)` from the authenticated user on\n * the context. Returns `undefined` when there is no signed-in user (auth\n * disabled or unauthenticated). `orgId` is `undefined` for personal accounts;\n * callers gate org-scoped GitHub features on its presence while agent state\n * falls back to a user-only tenant.\n */\nexport function factoryAuthTenant(c: Context): FactoryAuthTenant | undefined {\n const user = getFactoryAuthUser(c);\n const userId = getFactoryAuthUserId(user);\n if (!userId) return undefined;\n return { orgId: getFactoryAuthOrgId(user), userId };\n}\n\nfunction messageAuthor(user: FactoryAuthUser): MessageAuthor | undefined {\n const userId = getFactoryAuthUserId(user);\n if (!userId) return undefined;\n const actor = actorFromAuthUser(userId, user);\n return {\n id: actor.id,\n ...(actor.displayName ? { name: actor.displayName } : {}),\n ...(actor.avatarUrl ? { avatarUrl: actor.avatarUrl } : {}),\n };\n}\n\n/** True when both WorkOS credential env vars are present (legacy env gate). */\nfunction envWorkosConfigured(): boolean {\n return Boolean(process.env.WORKOS_API_KEY && process.env.WORKOS_CLIENT_ID);\n}\n\n/**\n * WorkOS provider implied by the `WORKOS_*` env vars — back-compat for test\n * suites exercised without booting the factory (route suites set `WORKOS_*`\n * directly and call {@link mountFactoryAuth} without an explicit provider).\n * `fetchMemberships: true` lets `authenticateToken` resolve `organizationId`\n * from a single membership when the JWT has no org claim — required so a\n * bootstrapped personal org resolves without re-auth.\n */\nfunction envFallbackAuthProvider(redirectUri: string | undefined): MastraAuthWorkos | undefined {\n if (!envWorkosConfigured()) return undefined;\n return new MastraAuthWorkos({\n redirectUri: redirectUri ?? process.env.WORKOS_REDIRECT_URI,\n fetchMemberships: true,\n });\n}\n\n/**\n * Map a provider `authenticateToken` result onto the neutral SPA user shape.\n *\n * Two result families exist today:\n * - flat provider users (WorkOS `WorkOSUser` et al.): `id`/`workosId`/`email`/\n * `name`/`organizationId` directly on the object;\n * - session-shaped results (better-auth `BetterAuthUser`): `{ session, user }`\n * with the active org on the session.\n */\nfunction toFactoryAuthUser(result: unknown): FactoryAuthUser | null {\n if (!result || typeof result !== 'object') return null;\n const record = result as Record<string, unknown>;\n\n // Session-shaped results: { session, user }. A result carrying both halves and\n // top-level identity fields is read as session-shaped: the session half is the\n // authenticated one, and preferring it keeps the org and the id from coming\n // from two different places.\n if (record.user && typeof record.user === 'object' && record.session && typeof record.session === 'object') {\n const user = record.user as { id?: unknown; email?: unknown; name?: unknown; avatarUrl?: unknown };\n const session = record.session as { activeOrganizationId?: unknown };\n if (typeof user.id !== 'string') return null;\n return {\n id: user.id,\n email: typeof user.email === 'string' ? user.email : undefined,\n name: typeof user.name === 'string' ? user.name : undefined,\n avatarUrl: typeof user.avatarUrl === 'string' ? user.avatarUrl : undefined,\n organizationId: typeof session.activeOrganizationId === 'string' ? session.activeOrganizationId : undefined,\n };\n }\n\n // Flat provider users.\n const flat = record as {\n id?: unknown;\n workosId?: unknown;\n email?: unknown;\n name?: unknown;\n avatarUrl?: unknown;\n organizationId?: unknown;\n memberships?: unknown;\n memberOrgIds?: unknown;\n };\n const id = typeof flat.id === 'string' ? flat.id : undefined;\n const workosId = typeof flat.workosId === 'string' ? flat.workosId : undefined;\n if (!id && !workosId) return null;\n const membershipOrganizationIds = Array.isArray(flat.memberships)\n ? flat.memberships.flatMap(membership => {\n if (!membership || typeof membership !== 'object') return [];\n const organizationId = (membership as { organizationId?: unknown }).organizationId;\n return typeof organizationId === 'string' ? [organizationId] : [];\n })\n : [];\n const memberOrgIds = Array.isArray(flat.memberOrgIds)\n ? flat.memberOrgIds.filter((organizationId): organizationId is string => typeof organizationId === 'string')\n : [];\n const organizationMembershipIds = [...new Set([...membershipOrganizationIds, ...memberOrgIds])];\n return {\n id,\n workosId,\n email: typeof flat.email === 'string' ? flat.email : undefined,\n name: typeof flat.name === 'string' ? flat.name : undefined,\n avatarUrl: typeof flat.avatarUrl === 'string' ? flat.avatarUrl : undefined,\n organizationId: typeof flat.organizationId === 'string' ? flat.organizationId : undefined,\n organizationMembershipIds,\n };\n}\n\n/**\n * Resolve the authenticated user for a request via the provider. Never throws:\n * ordinary invalid/expired sessions resolve to `null`.\n */\nasync function authenticateRequest(\n provider: IMastraAuthProvider,\n token: string,\n raw: Request,\n): Promise<FactoryAuthUser | null> {\n try {\n const result = await provider.authenticateToken(token, raw);\n return toFactoryAuthUser(result);\n } catch {\n return null;\n }\n}\n\n/**\n * Bootstrap a personal org for no-org accounts so org-scoped features (GitHub\n * connect) work without leaving the app. Mutates the resolved user so the\n * current request sees the org immediately; subsequent requests resolve it via\n * the provider's own session/membership lookup (providers cache internally).\n * Best-effort: providers swallow their own bootstrap failures, and any\n * unexpected throw leaves the user no-org.\n */\nasync function ensureUserOrg(provider: IMastraAuthProvider, user: FactoryAuthUser): Promise<void> {\n if (getFactoryAuthOrgId(user)) return;\n if (!isOrganizationsProvider(provider)) return;\n const userId = getFactoryAuthUserId(user);\n if (!userId) return;\n try {\n const orgId = await provider.ensureOrganization(userId);\n if (orgId) user.organizationId = orgId;\n } catch {\n // Best-effort: the user stays no-org until a later request succeeds.\n }\n}\n\n/**\n * The `org_id` claim of a JWT bearer token. Read only after the provider has\n * verified the token, and only adopted when the user is a verified member of\n * that org — so it picks among orgs the user already has, never grants one.\n */\nexport function bearerTokenOrgClaim(token: string | undefined): string | undefined {\n const payload = token?.split('.')[1];\n if (!payload) return undefined;\n try {\n const claims = JSON.parse(Buffer.from(payload, 'base64url').toString('utf8')) as { org_id?: unknown };\n return typeof claims.org_id === 'string' && claims.org_id ? claims.org_id : undefined;\n } catch {\n return undefined;\n }\n}\n\n/**\n * Picks the request's org: an explicit `X-Mastra-Organization-Id` header, else\n * a bearer token's `org_id` claim (MCP clients such as ChatGPT can't send the\n * header, and the verify endpoint otherwise reports the user's default org).\n * Either must name an org the user belongs to, else `false` — never fall back\n * to another org than the one asked for. With neither, bootstraps the user's org.\n */\nasync function applyRequestedOrganization(\n provider: IMastraAuthProvider,\n c: Context,\n token: string | undefined,\n user: FactoryAuthUser,\n): Promise<boolean> {\n const requested = (token ? c.req.header(ORGANIZATION_ID_HEADER)?.trim() : undefined) || bearerTokenOrgClaim(token);\n if (requested) return selectRequestedOrganization(user, requested);\n await ensureUserOrg(provider, user);\n return true;\n}\n\nfunction selectRequestedOrganization(user: FactoryAuthUser, requestedOrganizationId: string): boolean {\n if (user.organizationId === requestedOrganizationId) return true;\n if (!user.organizationMembershipIds?.includes(requestedOrganizationId)) return false;\n user.organizationId = requestedOrganizationId;\n return true;\n}\n\n/**\n * `Set-Cookie` values that clear the provider's session cookie(s), from the\n * provider's (possibly partial) `ISessionProvider.getClearSessionHeaders`.\n */\nfunction providerClearCookies(provider: IMastraAuthProvider): string[] {\n const cookies: string[] = [];\n const getClearSessionHeaders = (provider as Partial<ISessionProvider>).getClearSessionHeaders;\n if (typeof getClearSessionHeaders === 'function') {\n const headers = getClearSessionHeaders.call(provider) ?? {};\n const setCookie = headers['Set-Cookie'];\n // A provider may join several clearing cookies into one header value.\n if (setCookie) cookies.push(...setCookie.split(/,(?=\\s*[^;=,\\s]+=)/).map(cookie => cookie.trim()));\n }\n cookies.push(...providerLegacySessionClearCookies(provider));\n return cookies;\n}\n\n/**\n * Expiring `Set-Cookie` values for legacy copies of the provider's session\n * cookie (e.g. one an earlier release scoped to a shared parent domain), from\n * the optional `ISessionProvider.getLegacySessionClearCookies`.\n */\nfunction providerLegacySessionClearCookies(provider: IMastraAuthProvider): string[] {\n const getLegacy = (provider as Partial<ISessionProvider>).getLegacySessionClearCookies;\n if (typeof getLegacy !== 'function') return [];\n return getLegacy.call(provider) ?? [];\n}\n\n/**\n * Fail-closed authorization for organization-level administrative mutations.\n * The caller must belong to the same active organization and the provider must\n * explicitly confirm an admin/owner role.\n */\nexport async function isOrganizationAdmin(\n provider: IMastraAuthProvider | undefined,\n c: Context,\n organizationId: string,\n): Promise<boolean> {\n const user = await ensureFactoryAuthUser(provider, c);\n if (!user || user.organizationId !== organizationId || !provider || !isOrganizationsProvider(provider)) {\n return false;\n }\n const userId = getFactoryAuthUserId(user);\n if (!userId) return false;\n try {\n return await provider.isOrganizationAdmin(organizationId, userId);\n } catch {\n return false;\n }\n}\n\n/**\n * Build the factory's implementation of the `RouteAuth` seam over the\n * resolved provider (`undefined` = auth disabled). Constructed once per boot\n * by `MastraFactory.prepare()` and handed to factory route modules at\n * construction — they never import the factory auth module directly.\n */\nexport function createFactoryRouteAuth(provider: IMastraAuthProvider | undefined): RouteAuth {\n return {\n enabled: () => provider !== undefined,\n ensureUser: (c: Context) => ensureFactoryAuthUser(provider, c),\n tenant: (c: Context) => factoryAuthTenant(c),\n isOrganizationAdmin: (c: Context, organizationId: string) => isOrganizationAdmin(provider, c, organizationId),\n ...(provider instanceof MastraAuthStudio\n ? {\n fetchPlatformAsUser: async (c: Context, path: string, init?: RequestInit) => {\n const res = await provider.fetchAsRequestUser(c.req.raw, path, init);\n forwardPendingResponseHeaders(provider, c);\n return res;\n },\n }\n : {}),\n };\n}\n\n/** True when the given provider is WorkOS. Gates WorkOS-only capabilities. */\nexport function isWorkOSAuth(provider: IMastraAuthProvider | undefined): boolean {\n return provider instanceof MastraAuthWorkos;\n}\n\n/**\n * The raw WorkOS provider, for features that need the WorkOS client directly\n * (audit-log export, Admin Portal links). Callers must gate on\n * {@link isWorkOSAuth} first — throws when the provider is not WorkOS.\n */\nexport function getWorkOSProvider(provider: IMastraAuthProvider | undefined): MastraAuthWorkos {\n if (provider instanceof MastraAuthWorkos) return provider;\n throw new Error('WorkOS provider requested but the active factory auth provider is not WorkOS');\n}\n\n/**\n * Resolve the authenticated user for a request, stashing it on the context.\n *\n * The gate only authenticates non-`/auth/*` requests via the `Authorization`\n * header, so cookie-based browser navigations to public `/auth/*` routes (the\n * GitHub connect/callback flow) arrive without a gate-stashed user. This reads\n * the session cookie from the raw request the same way `/auth/me` does,\n * caches the result on the context, and returns it so downstream helpers like\n * {@link factoryAuthTenant} work uniformly on both gated and public routes.\n *\n * Returns `undefined` when there is no valid session (or auth is disabled).\n */\nfunction forwardPendingResponseHeaders(provider: IMastraAuthProvider, c: Context): void {\n // Forward a renewed session cookie (e.g. rotated by the shared API during\n // verification) so the browser's cookie stays current. Best-effort.\n try {\n const pending = provider.consumePendingResponseHeaders?.(c.req.raw);\n for (const [name, value] of Object.entries(pending ?? {})) {\n c.header(name, value, { append: true });\n }\n } catch {\n // never fail a request over header forwarding\n }\n}\n\nexport async function ensureFactoryAuthUser(\n provider: IMastraAuthProvider | undefined,\n c: Context,\n): Promise<FactoryAuthUser | undefined> {\n const existing = getFactoryAuthUser(c);\n if (existing) return existing;\n if (!provider) return undefined;\n\n const token = getBearerToken(c.req.header('Authorization'));\n const user = await authenticateRequest(provider, token, c.req.raw);\n // Routes declared `requiresAuth: false` skip the gate, so this is their only\n // authentication — forward a renewed session cookie from here too.\n forwardPendingResponseHeaders(provider, c);\n if (!user) return undefined;\n\n if (!(await applyRequestedOrganization(provider, c, token, user))) {\n throw new HTTPException(403, { message: 'organization_forbidden' });\n }\n\n c.set(FACTORY_AUTH_USER_KEY, user);\n return user;\n}\n\nexport interface MountFactoryAuthOptions {\n /**\n * Explicit auth provider to mount. When omitted, falls back to a WorkOS\n * provider implied by the `WORKOS_*` env vars (back-compat for suites that\n * never boot the factory).\n */\n provider?: IMastraAuthProvider;\n /**\n * Absolute URL the identity provider redirects back to after login (WorkOS\n * env-fallback path only). Defaults to the `WORKOS_REDIRECT_URI` env var.\n */\n redirectUri?: string;\n /** Browser-facing origin used to derive the SSO callback URL. */\n publicUrl?: string;\n}\n\n/**\n * Decide whether a request is a top-level browser navigation (which should be\n * redirected to `/signin`) versus an API/XHR call (which should get a 401 JSON\n * response the SPA can react to).\n */\nfunction isNavigationRequest(path: string, accept: string | undefined): boolean {\n if (path.startsWith('/api/')) return false;\n return (accept ?? '').includes('text/html');\n}\n\nfunction isPlatformAuthCustomDomain(provider: IMastraAuthProvider, publicUrl?: string): boolean {\n return (\n provider.name === PLATFORM_AUTH_PROVIDER &&\n Boolean(publicUrl && !isPlatformAuthSupportedHost(new URL(publicUrl).hostname))\n );\n}\n\n/**\n * Handle the provider-neutral `/auth/me` route: validate the session with the\n * active provider and report the signed-in user (no tokens) to the SPA.\n * `/auth/me` is public (the gate skips `/auth/*`), so it validates the session\n * itself rather than reading a value the gate would have stashed.\n */\nasync function handleAuthMe(provider: IMastraAuthProvider, c: Context, publicUrl?: string): Promise<Response> {\n const token = getBearerToken(c.req.header('Authorization'));\n const user = await authenticateRequest(provider, token, c.req.raw);\n // Provider identity for the SPA: `/signin` renders the hosted-login button\n // for WorkOS and an email/password form for better-auth (with sign-up hidden\n // when the provider disables it).\n const signUpDisabled = isCredentialsProvider(provider) && provider.isSignUpEnabled?.() === false;\n const customDomainUnsupported = isPlatformAuthCustomDomain(provider, publicUrl);\n const meta = {\n provider: provider.name,\n ...(signUpDisabled ? { signUpDisabled: true } : {}),\n ...(customDomainUnsupported ? { customDomainUnsupported: true } : {}),\n };\n if (!user) {\n return c.json({ authenticated: false, user: null, ...meta });\n }\n // Resolve the org the same way gated requests do (providers cache, so this\n // is a lookup — not a create — after first bootstrap).\n await ensureUserOrg(provider, user);\n return c.json({\n authenticated: true,\n telemetryEnabled: isFactoryTelemetryEnabled(provider.name),\n user: {\n userId: getFactoryAuthUserId(user),\n email: user.email,\n name: user.name,\n avatarUrl: user.avatarUrl,\n organizationId: user.organizationId,\n },\n ...meta,\n });\n}\n\n/**\n * Encode a validated returnTo path into the OAuth `state` parameter.\n *\n * Pipe format (`uuid|encodedPath`) is the contract `MastraAuthStudio` parses\n * to forward the path as the platform's `post_login_redirect`; a JSON blob\n * here silently degrades every post-login redirect to `/`.\n */\nfunction encodeState(returnTo: string): string {\n return `${crypto.randomUUID()}|${encodeURIComponent(returnTo)}`;\n}\n\n/** Decode the OAuth `state` parameter back into a sanitized returnTo path. */\nfunction decodeState(state: string | undefined): string {\n if (!state) return '/';\n const pipeIndex = state.indexOf('|');\n if (pipeIndex !== -1) {\n try {\n return sanitizeReturnTo(decodeURIComponent(state.slice(pipeIndex + 1)));\n } catch {\n return '/';\n }\n }\n return '/';\n}\n\n/**\n * Short-lived cookie stashing the post-login destination across the hosted\n * OAuth round-trip. Providers/platforms differ in whether they echo `state`\n * back to the callback, so the cookie is the reliable channel; `state` (when\n * echoed) takes precedence only if the cookie is missing.\n */\nconst RETURN_TO_COOKIE = 'mastra_factory_return_to';\n\nfunction returnToCookieHeader(returnTo: string): string {\n const crossSite = isCrossSiteAuth() ? '; SameSite=None; Secure' : '; SameSite=Lax';\n return `${RETURN_TO_COOKIE}=${encodeURIComponent(returnTo)}; Path=/; Max-Age=600; HttpOnly${crossSite}`;\n}\n\nfunction clearReturnToCookieHeader(): string {\n const crossSite = isCrossSiteAuth() ? '; SameSite=None; Secure' : '; SameSite=Lax';\n return `${RETURN_TO_COOKIE}=; Path=/; Max-Age=0; HttpOnly${crossSite}`;\n}\n\nfunction readReturnToCookie(c: Context): string | undefined {\n const header = c.req.header('Cookie');\n if (!header) return undefined;\n for (const part of header.split(';')) {\n const [name, ...rest] = part.trim().split('=');\n if (name === RETURN_TO_COOKIE) {\n try {\n return decodeURIComponent(rest.join('='));\n } catch {\n return undefined;\n }\n }\n }\n return undefined;\n}\n\n/** HTTP methods supported for public auth routes. */\ntype AuthRouteMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'ALL';\n\n/** A public `/auth/*` route derived from the provider's capabilities. */\ninterface AuthRouteSpec {\n path: string;\n method: AuthRouteMethod;\n handler: (c: Context) => Response | Promise<Response>;\n}\n\n/**\n * Derive the public `/auth/*` routes from the provider's capabilities:\n *\n * - `IAuthHttpHandler` → `ALL /auth/api/*` proxy to the provider's own HTTP\n * surface (better-auth sign-in/up/out/session — what the SPA's\n * email/password form posts to).\n * - `ISSOProvider` → hosted-login `GET /auth/login` / `GET /auth/callback` /\n * `GET /auth/logout` (returnTo preserved through the OAuth `state` param).\n * - handler-shaped, non-SSO providers → `GET /auth/login` redirects to the\n * SPA's `/signin` form, `GET /auth/logout` revokes via the provider's\n * sign-out endpoint and clears the session cookie.\n */\nfunction providerAuthRoutes(provider: IMastraAuthProvider, publicUrl?: string): AuthRouteSpec[] {\n const routes: AuthRouteSpec[] = [];\n\n if (isAuthHttpHandler(provider)) {\n routes.push({\n path: '/auth/api/*',\n method: 'ALL',\n handler: c => provider.handleAuthRequest(c.req.raw),\n });\n }\n\n if (isSSOProvider(provider)) {\n routes.push(\n {\n path: '/auth/login',\n method: 'GET',\n handler: async c => {\n const returnTo = sanitizeReturnTo(c.req.query('returnTo'));\n if (isPlatformAuthCustomDomain(provider, publicUrl)) {\n const query = new URLSearchParams({ error: CUSTOM_DOMAIN_UNSUPPORTED_ERROR });\n if (returnTo !== '/') query.set('returnTo', returnTo);\n return c.redirect(`/signin?${query.toString()}`);\n }\n const state = encodeState(returnTo);\n // Build the callback URL from the browser-facing public origin so\n // the OAuth round-trip lands back on the SPA's origin (in dev the\n // SPA is on :5173 and Vite proxies /auth/* to the API on :4111 —\n // deriving from c.req.url would use :4111 and the post-callback\n // redirect to `/` would miss the SPA). Providers that ignore the\n // caller's URI in favor of their own config (e.g. MastraAuthWorkos\n // with an explicit `redirectUri` option) still take precedence.\n const redirectUri = publicUrl ? new URL('/auth/callback', publicUrl).toString() : '';\n const loginUrl = await provider.getLoginUrl(redirectUri, state);\n for (const cookie of (await provider.getLoginCookies?.(redirectUri, state)) ?? []) {\n c.header('Set-Cookie', cookie, { append: true });\n }\n // Stash the destination in a cookie too: not every provider/platform\n // echoes `state` back to the callback.\n if (returnTo !== '/') {\n c.header('Set-Cookie', returnToCookieHeader(returnTo), { append: true });\n }\n return c.redirect(loginUrl);\n },\n },\n {\n path: '/auth/callback',\n method: 'GET',\n handler: async c => {\n const code = c.req.query('code');\n const stateReturnTo = decodeState(c.req.query('state'));\n const cookieReturnTo = sanitizeReturnTo(readReturnToCookie(c));\n const returnTo = cookieReturnTo !== '/' ? cookieReturnTo : stateReturnTo;\n c.header('Set-Cookie', clearReturnToCookieHeader(), { append: true });\n const idpError = c.req.query('error');\n if (idpError) {\n // IdP denial (e.g. access_denied for a non-org-member): bouncing to\n // /auth/login would re-enter the IdP in a redirect loop.\n const query = new URLSearchParams({ error: idpError.slice(0, 64) });\n const description = c.req.query('error_description');\n if (description) query.set('error_description', description.slice(0, 256));\n if (returnTo !== '/') query.set('returnTo', returnTo);\n return c.redirect(`/signin?${query.toString()}`);\n }\n if (!code) {\n return c.redirect('/auth/login');\n }\n try {\n const result = await provider.handleCallback(code, c.req.query('state') ?? '');\n if (result.cookies?.length) {\n // Provider populated cookies directly (e.g. WorkOS AuthKit builds\n // its own sealed session cookie inside handleCallback).\n for (const cookie of result.cookies) {\n c.header('Set-Cookie', cookie, { append: true });\n }\n } else if (isSessionProvider(provider) && result.tokens) {\n // Fallback for providers that expose ISessionProvider but leave\n // cookie construction to the server (e.g. MastraAuthStudio, which\n // returns just the sealed session as accessToken so\n // getSessionHeaders can issue this deployment's host-only cookie).\n // Mirrors packages/server/src/server/handlers/auth.ts:492-503.\n const resultUser = result.user as { id: string; organizationId?: string };\n const session = await provider.createSession(resultUser.id, {\n accessToken: result.tokens.accessToken,\n refreshToken: result.tokens.refreshToken,\n expiresAt: result.tokens.expiresAt,\n organizationId: resultUser.organizationId,\n });\n for (const [key, value] of Object.entries(provider.getSessionHeaders(session))) {\n c.header(key, value, { append: true });\n }\n }\n // Signing in also expires legacy (e.g. shared parent-domain) session cookies.\n for (const cookie of providerLegacySessionClearCookies(provider)) {\n c.header('Set-Cookie', cookie, { append: true });\n }\n return c.redirect(returnTo);\n } catch {\n // Code exchange failed (expired/replayed code, misconfig). Send the\n // user back to login rather than surfacing a raw error.\n return c.redirect('/auth/login');\n }\n },\n },\n {\n path: '/auth/logout',\n method: 'GET',\n handler: async c => {\n let logoutUrl: string | null = null;\n try {\n logoutUrl = (await provider.getLogoutUrl?.('/', c.req.raw)) ?? null;\n } catch {\n logoutUrl = null;\n }\n // Clear the session cookie regardless of whether the provider\n // returned a logout URL.\n for (const cookie of providerClearCookies(provider)) {\n c.header('Set-Cookie', cookie, { append: true });\n }\n return c.redirect(logoutUrl ?? '/');\n },\n },\n );\n } else if (isAuthHttpHandler(provider)) {\n routes.push(\n {\n // Hosted-login equivalent: no hosted page, so send the browser to the\n // SPA's /signin form, preserving returnTo.\n path: '/auth/login',\n method: 'GET',\n handler: c => {\n const returnTo = sanitizeReturnTo(c.req.query('returnTo'));\n return c.redirect(`/signin?returnTo=${encodeURIComponent(returnTo)}`);\n },\n },\n {\n path: '/auth/logout',\n method: 'GET',\n handler: async c => {\n // Revoke the session server-side through the provider's own sign-out\n // endpoint and forward its clearing cookies; fall back to our clear\n // cookies regardless.\n try {\n const origin = new URL(c.req.url).origin;\n const response = await provider.handleAuthRequest(\n new Request(`${origin}/auth/api/sign-out`, { method: 'POST', headers: c.req.raw.headers }),\n );\n for (const cookie of response.headers.getSetCookie()) {\n c.header('Set-Cookie', cookie, { append: true });\n }\n } catch {\n // No/invalid session: nothing to revoke.\n }\n for (const cookie of providerClearCookies(provider)) {\n c.header('Set-Cookie', cookie, { append: true });\n }\n return c.redirect('/');\n },\n },\n );\n }\n\n return routes;\n}\n\n/**\n * Register the public `/auth/*` routes on a Hono app: the capability-derived\n * provider routes (login/callback/logout/provider APIs) plus the\n * provider-neutral `/auth/me`. Split out from `mountFactoryAuth` so both the local\n * Hono server and the platform Mastra entry can reuse the exact same handlers.\n */\nexport function registerAuthRoutes(\n app: Hono<any>,\n provider: IMastraAuthProvider,\n options: { publicUrl?: string } = {},\n): void {\n for (const route of providerAuthRoutes(provider, options.publicUrl)) {\n const methods = route.method === 'ALL' ? ['GET', 'POST', 'PUT', 'DELETE', 'PATCH'] : [route.method];\n app.on(methods, route.path, c => route.handler(c));\n }\n app.get('/auth/me', c => handleAuthMe(provider, c, options.publicUrl));\n}\n\n/**\n * Build the public `/auth/*` routes (provider routes + `/auth/me`) as Mastra\n * `server.apiRoutes`. Used by the platform Mastra entry (`src/mastra/index.ts`),\n * which can't register plain Hono routes on the deployer-generated app the way\n * the local server does via {@link registerAuthRoutes}.\n *\n * Handlers are identical to {@link registerAuthRoutes}. All are `requiresAuth: false`\n * (they must be reachable while unauthenticated), and the gate middleware skips\n * `/auth/*` so it never blocks them. `/auth/*` is not under `/api`, so it is a\n * valid custom-route path.\n */\nexport function buildAuthRoutes(provider: IMastraAuthProvider, options: { publicUrl?: string } = {}): ApiRoute[] {\n return [\n // `registerApiRoute` handlers see @mastra/core's bundled hono Context type,\n // which is structurally identical to (but nominally distinct from) the\n // local hono version the route handlers are typed against — cast across\n // the seam.\n ...providerAuthRoutes(provider, options.publicUrl).map(route =>\n registerApiRoute(route.path, {\n method: route.method,\n requiresAuth: false,\n handler: c => route.handler(c as unknown as Context),\n }),\n ),\n registerApiRoute('/auth/me', {\n method: 'GET',\n requiresAuth: false,\n handler: c => handleAuthMe(provider, c as unknown as Context, options.publicUrl),\n }),\n ];\n}\n\n/**\n * `/auth/*` routes for auth-disabled mode (`auth: null`). Only `/auth/me`, answering\n * 404 — the UI's \"auth disabled\" signal. Without it the deployer's HTML catch-all\n * answers `/auth/me` with 200 text/html and the UI retries forever.\n */\nexport function buildAuthDisabledRoutes(): ApiRoute[] {\n return [\n registerApiRoute('/auth/me', {\n method: 'GET',\n requiresAuth: false,\n handler: c => c.json({ authEnabled: false, authenticated: false }, 404),\n }),\n ];\n}\n\n/**\n * Channel webhook paths whose adapter verifies the platform's request signature,\n * making the delivery self-authenticating. Add a platform here only once its\n * adapter rejects unsigned or mis-signed requests.\n */\nconst SIGNATURE_VERIFYING_CHANNEL_WEBHOOK = /^\\/api\\/agent-controllers\\/[^/]+\\/channels\\/slack\\/webhook$/;\n\n// Fetched by tabs that may already be signed out. Enumerated, not prefix-matched,\n// so a future route under the same prefix does not inherit the pass.\nconst SESSION_FAVICON_PATHS = new Set([\n '/favicon-session-initializing.svg',\n '/favicon-session-working.svg',\n '/favicon-session-awaiting.svg',\n '/favicon-session-error.svg',\n]);\n\n/**\n * Request-context key marking an authenticated interactive turn. HTTP requests\n * and linked Slack senders verified against their session owner can carry it;\n * wakes, webhooks, and dispatcher turns cannot.\n */\nexport const FACTORY_INTERACTIVE_KEY = 'factoryInteractive';\n\n/** With auth disabled there is no gate; this marks every HTTP request as interactive instead. */\nexport function createFactoryInteractiveMarker() {\n return async (c: Context, next: () => Promise<void>): Promise<void> => {\n c.get('requestContext')?.set(FACTORY_INTERACTIVE_KEY, true);\n await next();\n };\n}\n\n/**\n * Build the auth gate as a plain Hono middleware handler `(c, next)`. Protects\n * everything that is not a public `/auth/*` route: authenticated requests stash\n * the user on the context and continue; unauthenticated navigations redirect to\n * login and XHR/API calls get a 401 JSON. Shared by the local Hono server\n * (`mountFactoryAuth`) and the platform Mastra entry (`server.middleware`).\n */\nexport function createFactoryAuthGate(provider: IMastraAuthProvider) {\n return async (c: Context, next: () => Promise<void>): Promise<Response | void> => {\n const path = c.req.path;\n if (path.startsWith('/auth/')) {\n return next();\n }\n if (c.req.method === 'POST' && (path === '/web/github/webhook' || path === '/web/gitlab/webhook')) {\n return next();\n }\n // Inbound chat-channel webhooks (Slack events) carry no user session: they\n // authenticate by platform signature, the adapter verifying the request\n // against its signing secret. The routes declare `requiresAuth: false`, but\n // this gate is `use()` middleware — it runs before route matching, so that\n // metadata is not readable here and the path needs an explicit pass.\n //\n // The platform is allowlisted rather than matched as a wildcard: a pass\n // keyed on path shape alone would silently extend to any future adapter,\n // including one that does not verify signatures. Controller id stays a\n // wildcard because it is whatever the host registered.\n if (c.req.method === 'POST' && SIGNATURE_VERIFYING_CHANNEL_WEBHOOK.test(path)) {\n return next();\n }\n // The Slack account-linking deep link and the Sign-in-with-Slack OIDC\n // start/callback do their own auth (friendly login-redirect for signed-out\n // visitors; the OIDC callback authenticates via its signed `state`) — see\n // connect-route.ts.\n if (c.req.method === 'GET' && (path === '/connect/slack' || path.startsWith('/connect/slack/'))) {\n return next();\n }\n // The platform's deploy-auth flow lands IdP denials on `/login`\n // (`error=access_denied&error_description=...`); the SPA serves sign-in at\n // `/signin`, so forward the query there instead of burying it in returnTo.\n if (c.req.method === 'GET' && path === '/login') {\n return c.redirect(`/signin${new URL(c.req.url).search}`);\n }\n // The SPA sign-in page, its static bundle, and browser-fetched metadata\n // must be reachable while signed out; no user is stashed, so `/api/*`\n // stays protected.\n if (\n path === '/signin' ||\n path.startsWith('/assets/') ||\n path === '/manifest.webmanifest' ||\n path === '/mastra.svg' ||\n path === '/pwa-192.png' ||\n path === '/pwa-512.png' ||\n path === '/apple-touch-icon.png' ||\n (c.req.method === 'GET' && SESSION_FAVICON_PATHS.has(path))\n ) {\n return next();\n }\n\n const token = getBearerToken(c.req.header('Authorization'));\n // A slow verification here delays EVERY protected request — surface\n // outliers so auth-backend latency is attributable from server logs.\n const user = await timedAboveThreshold('auth.gate.authenticate', 1_000, () =>\n authenticateRequest(provider, token, c.req.raw),\n );\n forwardPendingResponseHeaders(provider, c);\n\n if (user) {\n // Without a requested org, no-org accounts get a bootstrapped personal org\n // so the org id resolves on this request (see ensureFactoryAuthUser).\n if (!(await applyRequestedOrganization(provider, c, token, user))) {\n return c.json({ error: 'organization_forbidden' }, 403);\n }\n c.set(FACTORY_AUTH_USER_KEY, user);\n const requestContext = c.get('requestContext');\n requestContext?.set('user', user);\n requestContext?.set(MASTRA_MESSAGE_AUTHOR_KEY, messageAuthor(user));\n requestContext?.set(FACTORY_INTERACTIVE_KEY, true);\n return next();\n }\n\n if (isNavigationRequest(path, c.req.header('Accept'))) {\n const url = new URL(c.req.url);\n const returnTo = sanitizeReturnTo(url.pathname + url.search);\n return c.redirect(`/signin?returnTo=${encodeURIComponent(returnTo)}`);\n }\n\n return c.json({ error: 'unauthorized' }, 401);\n };\n}\n\n/**\n * Mount factory auth gating onto the host app. No-op when auth is disabled\n * (no provider active).\n *\n * Must be called before the Mastra adapter routes, the `/web/*` routes, and\n * the static UI handlers so the gate covers every request. Composes the shared\n * `registerAuthRoutes` + `createFactoryAuthGate` factories so the local Hono server\n * and the platform Mastra entry stay behavior-identical.\n */\nexport function mountFactoryAuth(app: Hono<any>, options: MountFactoryAuthOptions = {}): boolean {\n const provider = options.provider ?? envFallbackAuthProvider(options.redirectUri);\n if (!provider) return false;\n\n registerAuthRoutes(app, provider, { publicUrl: options.publicUrl });\n app.use('*', createFactoryAuthGate(provider));\n return true;\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"auth.js","names":[],"sources":["../src/auth.ts"],"sourcesContent":["import { MastraAuthStudio } from '@mastra/auth-studio';\nimport { MastraAuthWorkos } from '@mastra/auth-workos';\nimport type { MessageAuthor } from '@mastra/core/agent-controller';\nimport { MASTRA_MESSAGE_AUTHOR_KEY } from '@mastra/core/request-context';\nimport {\n registerApiRoute,\n isAuthHttpHandler,\n isCredentialsProvider,\n isOrganizationsProvider,\n isSessionProvider,\n isSSOProvider,\n} from '@mastra/core/server';\nimport type { ApiRoute, IMastraAuthProvider, ISessionProvider } from '@mastra/core/server';\nimport type { Context, Hono } from 'hono';\nimport { HTTPException } from 'hono/http-exception';\n\nimport {\n CUSTOM_DOMAIN_UNSUPPORTED_ERROR,\n PLATFORM_AUTH_PROVIDER,\n isPlatformAuthSupportedHost,\n} from './platform-auth-host.js';\nimport type { RouteAuth } from './routes/route.js';\nimport { isFactoryTelemetryEnabled } from './telemetry.js';\nimport { timedAboveThreshold } from './timing.js';\n\nconst ORGANIZATION_ID_HEADER = 'X-Mastra-Organization-Id';\n\n/**\n * Provider-neutral factory auth gating for the MastraCode web server.\n *\n * When an auth provider is active (a `MastraAuthProvider` instance passed to\n * `MastraFactory`'s `auth` slot, or — back-compat for suites/paths that never\n * boot the factory — implied by the WorkOS env vars), every route on the web\n * server is placed behind it: unauthenticated browser navigations are\n * redirected to the SPA's `/signin` page, API/XHR calls receive a 401, and a\n * small set of public routes stay reachable while signed out — the provider's\n * `/auth/*` routes plus `/auth/me`, the `/signin` page, its `/assets/*` bundle,\n * and the SPA manifest metadata. When no provider is active, `mountFactoryAuth` is a no-op and the server\n * behaves exactly as it does without auth.\n *\n * Provider specifics stay in the providers (`@mastra/auth-workos`,\n * `@mastra/auth-better-auth`, or any custom `IMastraAuthProvider`); this\n * module composes them capability-first via the core type guards:\n * - `authenticateToken` — session/bearer validation (all providers)\n * - `ISSOProvider` — hosted-login `/auth/login`, `/auth/callback`, `/auth/logout`\n * - `IAuthHttpHandler` — provider-owned `/auth/api/*` endpoints (better-auth)\n * - `IOrganizationsProvider` — personal-org bootstrap + admin checks\n * - `ICredentialsProvider.isSignUpEnabled` — SPA sign-up affordance\n * - `getClearSessionHeaders` — session cookie clearing on logout\n */\n\n/** Minimal shape of the signed-in user surfaced to the SPA (no tokens). */\nexport interface FactoryAuthUser {\n /** Stable WorkOS user id used to scope per-user data (GitHub installs etc.). */\n workosId?: string;\n /** Provider user id; WorkOS shapes may use `workosId` instead (see {@link workosId}). */\n id?: string;\n email?: string;\n name?: string;\n /** Provider-supplied profile picture URL, when the auth provider exposes one. */\n avatarUrl?: string;\n /**\n * Organization id. The org is the top-level tenant: it owns the GitHub\n * App installation and connected projects, while each user inside the org gets\n * isolated building instances. Absent for personal (no-org) accounts.\n */\n organizationId?: string;\n /** Organization ids proven by the provider's authenticated membership response. */\n organizationMembershipIds?: string[];\n}\n\n/**\n * Tenant identity: the org is the top-level tenant, and each user inside it is\n * an isolated builder. Agent state, worktrees and sandboxes are scoped per\n * `(orgId, userId)`. Personal (no-org) users have `orgId === undefined`.\n */\nexport interface FactoryAuthTenant {\n /** Organization id, or `undefined` for personal (no-org) accounts. */\n orgId?: string;\n /** Stable provider user id. */\n userId: string;\n}\n\n/**\n * Validate that a `returnTo` value is a safe same-site path, to prevent\n * open-redirect attacks. Only absolute local paths (`/foo`) are allowed;\n * protocol-relative (`//evil.com`) and absolute URLs are rejected.\n */\nexport function sanitizeReturnTo(raw: string | undefined): string {\n if (!raw) return '/';\n if (!raw.startsWith('/')) return '/';\n // Reject protocol-relative URLs like \"//evil.com\" and \"/\\evil.com\".\n if (raw.startsWith('//') || raw.startsWith('/\\\\')) return '/';\n return raw;\n}\n\n/** Extract a bearer token from the Authorization header, if present. */\nexport function getBearerToken(authorization: string | undefined): string {\n if (!authorization) return '';\n const match = /^Bearer\\s+(.+)$/i.exec(authorization);\n return match?.[1] ?? '';\n}\n\n/**\n * Whether the SPA is served cross-origin from this API (platform deploy). When\n * `MASTRACODE_ALLOWED_ORIGINS` is set the browser talks to us cross-site, so\n * session cookies must be `SameSite=None; Secure` for the browser to send them.\n * Same-origin local dev leaves this unset and keeps the stricter `SameSite=Lax`.\n */\nexport function isCrossSiteAuth(): boolean {\n return Boolean(process.env.MASTRACODE_ALLOWED_ORIGINS?.trim());\n}\n\n/** Hono context variables set by the auth gate. */\nexport interface FactoryAuthVariables {\n factoryAuthUser: FactoryAuthUser;\n}\n\n/** Context key under which the gate stashes the authenticated user. */\nconst FACTORY_AUTH_USER_KEY = 'factoryAuthUser';\n\n/**\n * Read the authenticated user the gate stashed on the context, or\n * `undefined` when unauthenticated / auth disabled. Used by downstream routes\n * (e.g. GitHub) to scope rows per user.\n */\nexport function getFactoryAuthUser(c: Context): FactoryAuthUser | undefined {\n return c.get(FACTORY_AUTH_USER_KEY) as FactoryAuthUser | undefined;\n}\n\n/**\n * Read the authenticated user off a request context, normalizing whatever the\n * active auth provider put there.\n *\n * The server's auth layer writes the provider's `authenticateToken` result into\n * the request context's `user` slot verbatim, so the value's shape follows the\n * provider: WorkOS writes a flat user, better-auth writes a `{ session, user }`\n * wrapper whose org lives on the session. Reading that slot as a\n * {@link FactoryAuthUser} therefore yields `undefined` for both the id and the\n * org under better-auth, which reads as \"this session belongs to somebody else\"\n * at every ownership check. Normalize on the way in instead.\n */\nexport function getFactoryAuthUserFromContext(\n requestContext: { get: (key: string) => unknown } | undefined,\n): FactoryAuthUser | undefined {\n if (!requestContext || typeof requestContext.get !== 'function') return undefined;\n return toFactoryAuthUser(requestContext.get('user')) ?? undefined;\n}\n\n/** Resolve the stable user id from an authenticated user shape. */\nexport function getFactoryAuthUserId(user: FactoryAuthUser | undefined): string | undefined {\n return user?.workosId ?? user?.id;\n}\n\n/** Resolve the organization id from a user shape, if present. */\nexport function getFactoryAuthOrgId(user: FactoryAuthUser | undefined): string | undefined {\n return user?.organizationId;\n}\n\n/**\n * The org rung a user's rows are keyed by: the organization they belong to, or a\n * per-user rung for personal (no-org) accounts so their rows never land in the\n * shared `local` scope. Every writer and reader of a `(org, user)` row must\n * agree on this, so it lives here rather than being re-derived per call site.\n */\nexport function factoryUserOrgId(user: FactoryAuthUser | undefined): string | undefined {\n const userId = getFactoryAuthUserId(user);\n if (!userId) return undefined;\n return getFactoryAuthOrgId(user) ?? `user:${userId}`;\n}\n\n/**\n * Resolve the tenant identity `(orgId, userId)` from the authenticated user on\n * the context. Returns `undefined` when there is no signed-in user (auth\n * disabled or unauthenticated). `orgId` is `undefined` for personal accounts;\n * callers gate org-scoped GitHub features on its presence while agent state\n * falls back to a user-only tenant.\n */\nexport function factoryAuthTenant(c: Context): FactoryAuthTenant | undefined {\n const user = getFactoryAuthUser(c);\n const userId = getFactoryAuthUserId(user);\n if (!userId) return undefined;\n return { orgId: getFactoryAuthOrgId(user), userId };\n}\n\nfunction messageAuthor(user: FactoryAuthUser): MessageAuthor | undefined {\n const userId = getFactoryAuthUserId(user);\n if (!userId) return undefined;\n const name = user.name?.trim() || user.email?.trim();\n const avatarUrl = user.avatarUrl?.trim();\n return {\n id: userId,\n ...(name ? { name } : {}),\n ...(avatarUrl ? { avatarUrl } : {}),\n };\n}\n\n/** True when both WorkOS credential env vars are present (legacy env gate). */\nfunction envWorkosConfigured(): boolean {\n return Boolean(process.env.WORKOS_API_KEY && process.env.WORKOS_CLIENT_ID);\n}\n\n/**\n * WorkOS provider implied by the `WORKOS_*` env vars — back-compat for test\n * suites exercised without booting the factory (route suites set `WORKOS_*`\n * directly and call {@link mountFactoryAuth} without an explicit provider).\n * `fetchMemberships: true` lets `authenticateToken` resolve `organizationId`\n * from a single membership when the JWT has no org claim — required so a\n * bootstrapped personal org resolves without re-auth.\n */\nfunction envFallbackAuthProvider(redirectUri: string | undefined): MastraAuthWorkos | undefined {\n if (!envWorkosConfigured()) return undefined;\n return new MastraAuthWorkos({\n redirectUri: redirectUri ?? process.env.WORKOS_REDIRECT_URI,\n fetchMemberships: true,\n });\n}\n\n/**\n * Map a provider `authenticateToken` result onto the neutral SPA user shape.\n *\n * Two result families exist today:\n * - flat provider users (WorkOS `WorkOSUser` et al.): `id`/`workosId`/`email`/\n * `name`/`organizationId` directly on the object;\n * - session-shaped results (better-auth `BetterAuthUser`): `{ session, user }`\n * with the active org on the session.\n */\nfunction toFactoryAuthUser(result: unknown): FactoryAuthUser | null {\n if (!result || typeof result !== 'object') return null;\n const record = result as Record<string, unknown>;\n\n // Session-shaped results: { session, user }. A result carrying both halves and\n // top-level identity fields is read as session-shaped: the session half is the\n // authenticated one, and preferring it keeps the org and the id from coming\n // from two different places.\n if (record.user && typeof record.user === 'object' && record.session && typeof record.session === 'object') {\n const user = record.user as { id?: unknown; email?: unknown; name?: unknown; avatarUrl?: unknown };\n const session = record.session as { activeOrganizationId?: unknown };\n if (typeof user.id !== 'string') return null;\n return {\n id: user.id,\n email: typeof user.email === 'string' ? user.email : undefined,\n name: typeof user.name === 'string' ? user.name : undefined,\n avatarUrl: typeof user.avatarUrl === 'string' ? user.avatarUrl : undefined,\n organizationId: typeof session.activeOrganizationId === 'string' ? session.activeOrganizationId : undefined,\n };\n }\n\n // Flat provider users.\n const flat = record as {\n id?: unknown;\n workosId?: unknown;\n email?: unknown;\n name?: unknown;\n avatarUrl?: unknown;\n organizationId?: unknown;\n memberships?: unknown;\n memberOrgIds?: unknown;\n };\n const id = typeof flat.id === 'string' ? flat.id : undefined;\n const workosId = typeof flat.workosId === 'string' ? flat.workosId : undefined;\n if (!id && !workosId) return null;\n const membershipOrganizationIds = Array.isArray(flat.memberships)\n ? flat.memberships.flatMap(membership => {\n if (!membership || typeof membership !== 'object') return [];\n const organizationId = (membership as { organizationId?: unknown }).organizationId;\n return typeof organizationId === 'string' ? [organizationId] : [];\n })\n : [];\n const memberOrgIds = Array.isArray(flat.memberOrgIds)\n ? flat.memberOrgIds.filter((organizationId): organizationId is string => typeof organizationId === 'string')\n : [];\n const organizationMembershipIds = [...new Set([...membershipOrganizationIds, ...memberOrgIds])];\n return {\n id,\n workosId,\n email: typeof flat.email === 'string' ? flat.email : undefined,\n name: typeof flat.name === 'string' ? flat.name : undefined,\n avatarUrl: typeof flat.avatarUrl === 'string' ? flat.avatarUrl : undefined,\n organizationId: typeof flat.organizationId === 'string' ? flat.organizationId : undefined,\n organizationMembershipIds,\n };\n}\n\n/**\n * Resolve the authenticated user for a request via the provider. Never throws:\n * ordinary invalid/expired sessions resolve to `null`.\n */\nasync function authenticateRequest(\n provider: IMastraAuthProvider,\n token: string,\n raw: Request,\n): Promise<FactoryAuthUser | null> {\n try {\n const result = await provider.authenticateToken(token, raw);\n return toFactoryAuthUser(result);\n } catch {\n return null;\n }\n}\n\n/**\n * Bootstrap a personal org for no-org accounts so org-scoped features (GitHub\n * connect) work without leaving the app. Mutates the resolved user so the\n * current request sees the org immediately; subsequent requests resolve it via\n * the provider's own session/membership lookup (providers cache internally).\n * Best-effort: providers swallow their own bootstrap failures, and any\n * unexpected throw leaves the user no-org.\n */\nasync function ensureUserOrg(provider: IMastraAuthProvider, user: FactoryAuthUser): Promise<void> {\n if (getFactoryAuthOrgId(user)) return;\n if (!isOrganizationsProvider(provider)) return;\n const userId = getFactoryAuthUserId(user);\n if (!userId) return;\n try {\n const orgId = await provider.ensureOrganization(userId);\n if (orgId) user.organizationId = orgId;\n } catch {\n // Best-effort: the user stays no-org until a later request succeeds.\n }\n}\n\n/**\n * The `org_id` claim of a JWT bearer token. Read only after the provider has\n * verified the token, and only adopted when the user is a verified member of\n * that org — so it picks among orgs the user already has, never grants one.\n */\nexport function bearerTokenOrgClaim(token: string | undefined): string | undefined {\n const payload = token?.split('.')[1];\n if (!payload) return undefined;\n try {\n const claims = JSON.parse(Buffer.from(payload, 'base64url').toString('utf8')) as { org_id?: unknown };\n return typeof claims.org_id === 'string' && claims.org_id ? claims.org_id : undefined;\n } catch {\n return undefined;\n }\n}\n\n/**\n * Picks the request's org: an explicit `X-Mastra-Organization-Id` header, else\n * a bearer token's `org_id` claim (MCP clients such as ChatGPT can't send the\n * header, and the verify endpoint otherwise reports the user's default org).\n * Either must name an org the user belongs to, else `false` — never fall back\n * to another org than the one asked for. With neither, bootstraps the user's org.\n */\nasync function applyRequestedOrganization(\n provider: IMastraAuthProvider,\n c: Context,\n token: string | undefined,\n user: FactoryAuthUser,\n): Promise<boolean> {\n const requested = (token ? c.req.header(ORGANIZATION_ID_HEADER)?.trim() : undefined) || bearerTokenOrgClaim(token);\n if (requested) return selectRequestedOrganization(user, requested);\n await ensureUserOrg(provider, user);\n return true;\n}\n\nfunction selectRequestedOrganization(user: FactoryAuthUser, requestedOrganizationId: string): boolean {\n if (user.organizationId === requestedOrganizationId) return true;\n if (!user.organizationMembershipIds?.includes(requestedOrganizationId)) return false;\n user.organizationId = requestedOrganizationId;\n return true;\n}\n\n/**\n * `Set-Cookie` values that clear the provider's session cookie(s), from the\n * provider's (possibly partial) `ISessionProvider.getClearSessionHeaders`.\n */\nfunction providerClearCookies(provider: IMastraAuthProvider): string[] {\n const cookies: string[] = [];\n const getClearSessionHeaders = (provider as Partial<ISessionProvider>).getClearSessionHeaders;\n if (typeof getClearSessionHeaders === 'function') {\n const headers = getClearSessionHeaders.call(provider) ?? {};\n const setCookie = headers['Set-Cookie'];\n // A provider may join several clearing cookies into one header value.\n if (setCookie) cookies.push(...setCookie.split(/,(?=\\s*[^;=,\\s]+=)/).map(cookie => cookie.trim()));\n }\n cookies.push(...providerLegacySessionClearCookies(provider));\n return cookies;\n}\n\n/**\n * Expiring `Set-Cookie` values for legacy copies of the provider's session\n * cookie (e.g. one an earlier release scoped to a shared parent domain), from\n * the optional `ISessionProvider.getLegacySessionClearCookies`.\n */\nfunction providerLegacySessionClearCookies(provider: IMastraAuthProvider): string[] {\n const getLegacy = (provider as Partial<ISessionProvider>).getLegacySessionClearCookies;\n if (typeof getLegacy !== 'function') return [];\n return getLegacy.call(provider) ?? [];\n}\n\n/**\n * Fail-closed authorization for organization-level administrative mutations.\n * The caller must belong to the same active organization and the provider must\n * explicitly confirm an admin/owner role.\n */\nexport async function isOrganizationAdmin(\n provider: IMastraAuthProvider | undefined,\n c: Context,\n organizationId: string,\n): Promise<boolean> {\n const user = await ensureFactoryAuthUser(provider, c);\n if (!user || user.organizationId !== organizationId || !provider || !isOrganizationsProvider(provider)) {\n return false;\n }\n const userId = getFactoryAuthUserId(user);\n if (!userId) return false;\n try {\n return await provider.isOrganizationAdmin(organizationId, userId);\n } catch {\n return false;\n }\n}\n\n/**\n * Build the factory's implementation of the `RouteAuth` seam over the\n * resolved provider (`undefined` = auth disabled). Constructed once per boot\n * by `MastraFactory.prepare()` and handed to factory route modules at\n * construction — they never import the factory auth module directly.\n */\nexport function createFactoryRouteAuth(provider: IMastraAuthProvider | undefined): RouteAuth {\n return {\n enabled: () => provider !== undefined,\n ensureUser: (c: Context) => ensureFactoryAuthUser(provider, c),\n tenant: (c: Context) => factoryAuthTenant(c),\n isOrganizationAdmin: (c: Context, organizationId: string) => isOrganizationAdmin(provider, c, organizationId),\n ...(provider instanceof MastraAuthStudio\n ? {\n fetchPlatformAsUser: async (c: Context, path: string, init?: RequestInit) => {\n const res = await provider.fetchAsRequestUser(c.req.raw, path, init);\n forwardPendingResponseHeaders(provider, c);\n return res;\n },\n }\n : {}),\n };\n}\n\n/** True when the given provider is WorkOS. Gates WorkOS-only capabilities. */\nexport function isWorkOSAuth(provider: IMastraAuthProvider | undefined): boolean {\n return provider instanceof MastraAuthWorkos;\n}\n\n/**\n * The raw WorkOS provider, for features that need the WorkOS client directly\n * (audit-log export, Admin Portal links). Callers must gate on\n * {@link isWorkOSAuth} first — throws when the provider is not WorkOS.\n */\nexport function getWorkOSProvider(provider: IMastraAuthProvider | undefined): MastraAuthWorkos {\n if (provider instanceof MastraAuthWorkos) return provider;\n throw new Error('WorkOS provider requested but the active factory auth provider is not WorkOS');\n}\n\n/**\n * Resolve the authenticated user for a request, stashing it on the context.\n *\n * The gate only authenticates non-`/auth/*` requests via the `Authorization`\n * header, so cookie-based browser navigations to public `/auth/*` routes (the\n * GitHub connect/callback flow) arrive without a gate-stashed user. This reads\n * the session cookie from the raw request the same way `/auth/me` does,\n * caches the result on the context, and returns it so downstream helpers like\n * {@link factoryAuthTenant} work uniformly on both gated and public routes.\n *\n * Returns `undefined` when there is no valid session (or auth is disabled).\n */\nfunction forwardPendingResponseHeaders(provider: IMastraAuthProvider, c: Context): void {\n // Forward a renewed session cookie (e.g. rotated by the shared API during\n // verification) so the browser's cookie stays current. Best-effort.\n try {\n const pending = provider.consumePendingResponseHeaders?.(c.req.raw);\n for (const [name, value] of Object.entries(pending ?? {})) {\n c.header(name, value, { append: true });\n }\n } catch {\n // never fail a request over header forwarding\n }\n}\n\nexport async function ensureFactoryAuthUser(\n provider: IMastraAuthProvider | undefined,\n c: Context,\n): Promise<FactoryAuthUser | undefined> {\n const existing = getFactoryAuthUser(c);\n if (existing) return existing;\n if (!provider) return undefined;\n\n const token = getBearerToken(c.req.header('Authorization'));\n const user = await authenticateRequest(provider, token, c.req.raw);\n // Routes declared `requiresAuth: false` skip the gate, so this is their only\n // authentication — forward a renewed session cookie from here too.\n forwardPendingResponseHeaders(provider, c);\n if (!user) return undefined;\n\n if (!(await applyRequestedOrganization(provider, c, token, user))) {\n throw new HTTPException(403, { message: 'organization_forbidden' });\n }\n\n c.set(FACTORY_AUTH_USER_KEY, user);\n return user;\n}\n\nexport interface MountFactoryAuthOptions {\n /**\n * Explicit auth provider to mount. When omitted, falls back to a WorkOS\n * provider implied by the `WORKOS_*` env vars (back-compat for suites that\n * never boot the factory).\n */\n provider?: IMastraAuthProvider;\n /**\n * Absolute URL the identity provider redirects back to after login (WorkOS\n * env-fallback path only). Defaults to the `WORKOS_REDIRECT_URI` env var.\n */\n redirectUri?: string;\n /** Browser-facing origin used to derive the SSO callback URL. */\n publicUrl?: string;\n}\n\n/**\n * Decide whether a request is a top-level browser navigation (which should be\n * redirected to `/signin`) versus an API/XHR call (which should get a 401 JSON\n * response the SPA can react to).\n */\nfunction isNavigationRequest(path: string, accept: string | undefined): boolean {\n if (path.startsWith('/api/')) return false;\n return (accept ?? '').includes('text/html');\n}\n\nfunction isPlatformAuthCustomDomain(provider: IMastraAuthProvider, publicUrl?: string): boolean {\n return (\n provider.name === PLATFORM_AUTH_PROVIDER &&\n Boolean(publicUrl && !isPlatformAuthSupportedHost(new URL(publicUrl).hostname))\n );\n}\n\n/**\n * Handle the provider-neutral `/auth/me` route: validate the session with the\n * active provider and report the signed-in user (no tokens) to the SPA.\n * `/auth/me` is public (the gate skips `/auth/*`), so it validates the session\n * itself rather than reading a value the gate would have stashed.\n */\nasync function handleAuthMe(provider: IMastraAuthProvider, c: Context, publicUrl?: string): Promise<Response> {\n const token = getBearerToken(c.req.header('Authorization'));\n const user = await authenticateRequest(provider, token, c.req.raw);\n // Provider identity for the SPA: `/signin` renders the hosted-login button\n // for WorkOS and an email/password form for better-auth (with sign-up hidden\n // when the provider disables it).\n const signUpDisabled = isCredentialsProvider(provider) && provider.isSignUpEnabled?.() === false;\n const customDomainUnsupported = isPlatformAuthCustomDomain(provider, publicUrl);\n const meta = {\n provider: provider.name,\n ...(signUpDisabled ? { signUpDisabled: true } : {}),\n ...(customDomainUnsupported ? { customDomainUnsupported: true } : {}),\n };\n if (!user) {\n return c.json({ authenticated: false, user: null, ...meta });\n }\n // Resolve the org the same way gated requests do (providers cache, so this\n // is a lookup — not a create — after first bootstrap).\n await ensureUserOrg(provider, user);\n return c.json({\n authenticated: true,\n telemetryEnabled: isFactoryTelemetryEnabled(provider.name),\n user: {\n userId: getFactoryAuthUserId(user),\n email: user.email,\n name: user.name,\n avatarUrl: user.avatarUrl,\n organizationId: user.organizationId,\n },\n ...meta,\n });\n}\n\n/**\n * Encode a validated returnTo path into the OAuth `state` parameter.\n *\n * Pipe format (`uuid|encodedPath`) is the contract `MastraAuthStudio` parses\n * to forward the path as the platform's `post_login_redirect`; a JSON blob\n * here silently degrades every post-login redirect to `/`.\n */\nfunction encodeState(returnTo: string): string {\n return `${crypto.randomUUID()}|${encodeURIComponent(returnTo)}`;\n}\n\n/** Decode the OAuth `state` parameter back into a sanitized returnTo path. */\nfunction decodeState(state: string | undefined): string {\n if (!state) return '/';\n const pipeIndex = state.indexOf('|');\n if (pipeIndex !== -1) {\n try {\n return sanitizeReturnTo(decodeURIComponent(state.slice(pipeIndex + 1)));\n } catch {\n return '/';\n }\n }\n return '/';\n}\n\n/**\n * Short-lived cookie stashing the post-login destination across the hosted\n * OAuth round-trip. Providers/platforms differ in whether they echo `state`\n * back to the callback, so the cookie is the reliable channel; `state` (when\n * echoed) takes precedence only if the cookie is missing.\n */\nconst RETURN_TO_COOKIE = 'mastra_factory_return_to';\n\nfunction returnToCookieHeader(returnTo: string): string {\n const crossSite = isCrossSiteAuth() ? '; SameSite=None; Secure' : '; SameSite=Lax';\n return `${RETURN_TO_COOKIE}=${encodeURIComponent(returnTo)}; Path=/; Max-Age=600; HttpOnly${crossSite}`;\n}\n\nfunction clearReturnToCookieHeader(): string {\n const crossSite = isCrossSiteAuth() ? '; SameSite=None; Secure' : '; SameSite=Lax';\n return `${RETURN_TO_COOKIE}=; Path=/; Max-Age=0; HttpOnly${crossSite}`;\n}\n\nfunction readReturnToCookie(c: Context): string | undefined {\n const header = c.req.header('Cookie');\n if (!header) return undefined;\n for (const part of header.split(';')) {\n const [name, ...rest] = part.trim().split('=');\n if (name === RETURN_TO_COOKIE) {\n try {\n return decodeURIComponent(rest.join('='));\n } catch {\n return undefined;\n }\n }\n }\n return undefined;\n}\n\n/** HTTP methods supported for public auth routes. */\ntype AuthRouteMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'ALL';\n\n/** A public `/auth/*` route derived from the provider's capabilities. */\ninterface AuthRouteSpec {\n path: string;\n method: AuthRouteMethod;\n handler: (c: Context) => Response | Promise<Response>;\n}\n\n/**\n * Derive the public `/auth/*` routes from the provider's capabilities:\n *\n * - `IAuthHttpHandler` → `ALL /auth/api/*` proxy to the provider's own HTTP\n * surface (better-auth sign-in/up/out/session — what the SPA's\n * email/password form posts to).\n * - `ISSOProvider` → hosted-login `GET /auth/login` / `GET /auth/callback` /\n * `GET /auth/logout` (returnTo preserved through the OAuth `state` param).\n * - handler-shaped, non-SSO providers → `GET /auth/login` redirects to the\n * SPA's `/signin` form, `GET /auth/logout` revokes via the provider's\n * sign-out endpoint and clears the session cookie.\n */\nfunction providerAuthRoutes(provider: IMastraAuthProvider, publicUrl?: string): AuthRouteSpec[] {\n const routes: AuthRouteSpec[] = [];\n\n if (isAuthHttpHandler(provider)) {\n routes.push({\n path: '/auth/api/*',\n method: 'ALL',\n handler: c => provider.handleAuthRequest(c.req.raw),\n });\n }\n\n if (isSSOProvider(provider)) {\n routes.push(\n {\n path: '/auth/login',\n method: 'GET',\n handler: async c => {\n const returnTo = sanitizeReturnTo(c.req.query('returnTo'));\n if (isPlatformAuthCustomDomain(provider, publicUrl)) {\n const query = new URLSearchParams({ error: CUSTOM_DOMAIN_UNSUPPORTED_ERROR });\n if (returnTo !== '/') query.set('returnTo', returnTo);\n return c.redirect(`/signin?${query.toString()}`);\n }\n const state = encodeState(returnTo);\n // Build the callback URL from the browser-facing public origin so\n // the OAuth round-trip lands back on the SPA's origin (in dev the\n // SPA is on :5173 and Vite proxies /auth/* to the API on :4111 —\n // deriving from c.req.url would use :4111 and the post-callback\n // redirect to `/` would miss the SPA). Providers that ignore the\n // caller's URI in favor of their own config (e.g. MastraAuthWorkos\n // with an explicit `redirectUri` option) still take precedence.\n const redirectUri = publicUrl ? new URL('/auth/callback', publicUrl).toString() : '';\n const loginUrl = await provider.getLoginUrl(redirectUri, state);\n for (const cookie of (await provider.getLoginCookies?.(redirectUri, state)) ?? []) {\n c.header('Set-Cookie', cookie, { append: true });\n }\n // Stash the destination in a cookie too: not every provider/platform\n // echoes `state` back to the callback.\n if (returnTo !== '/') {\n c.header('Set-Cookie', returnToCookieHeader(returnTo), { append: true });\n }\n return c.redirect(loginUrl);\n },\n },\n {\n path: '/auth/callback',\n method: 'GET',\n handler: async c => {\n const code = c.req.query('code');\n const stateReturnTo = decodeState(c.req.query('state'));\n const cookieReturnTo = sanitizeReturnTo(readReturnToCookie(c));\n const returnTo = cookieReturnTo !== '/' ? cookieReturnTo : stateReturnTo;\n c.header('Set-Cookie', clearReturnToCookieHeader(), { append: true });\n const idpError = c.req.query('error');\n if (idpError) {\n // IdP denial (e.g. access_denied for a non-org-member): bouncing to\n // /auth/login would re-enter the IdP in a redirect loop.\n const query = new URLSearchParams({ error: idpError.slice(0, 64) });\n const description = c.req.query('error_description');\n if (description) query.set('error_description', description.slice(0, 256));\n if (returnTo !== '/') query.set('returnTo', returnTo);\n return c.redirect(`/signin?${query.toString()}`);\n }\n if (!code) {\n return c.redirect('/auth/login');\n }\n try {\n const result = await provider.handleCallback(code, c.req.query('state') ?? '');\n if (result.cookies?.length) {\n // Provider populated cookies directly (e.g. WorkOS AuthKit builds\n // its own sealed session cookie inside handleCallback).\n for (const cookie of result.cookies) {\n c.header('Set-Cookie', cookie, { append: true });\n }\n } else if (isSessionProvider(provider) && result.tokens) {\n // Fallback for providers that expose ISessionProvider but leave\n // cookie construction to the server (e.g. MastraAuthStudio, which\n // returns just the sealed session as accessToken so\n // getSessionHeaders can issue this deployment's host-only cookie).\n // Mirrors packages/server/src/server/handlers/auth.ts:492-503.\n const resultUser = result.user as { id: string; organizationId?: string };\n const session = await provider.createSession(resultUser.id, {\n accessToken: result.tokens.accessToken,\n refreshToken: result.tokens.refreshToken,\n expiresAt: result.tokens.expiresAt,\n organizationId: resultUser.organizationId,\n });\n for (const [key, value] of Object.entries(provider.getSessionHeaders(session))) {\n c.header(key, value, { append: true });\n }\n }\n // Signing in also expires legacy (e.g. shared parent-domain) session cookies.\n for (const cookie of providerLegacySessionClearCookies(provider)) {\n c.header('Set-Cookie', cookie, { append: true });\n }\n return c.redirect(returnTo);\n } catch {\n // Code exchange failed (expired/replayed code, misconfig). Send the\n // user back to login rather than surfacing a raw error.\n return c.redirect('/auth/login');\n }\n },\n },\n {\n path: '/auth/logout',\n method: 'GET',\n handler: async c => {\n let logoutUrl: string | null = null;\n try {\n logoutUrl = (await provider.getLogoutUrl?.('/', c.req.raw)) ?? null;\n } catch {\n logoutUrl = null;\n }\n // Clear the session cookie regardless of whether the provider\n // returned a logout URL.\n for (const cookie of providerClearCookies(provider)) {\n c.header('Set-Cookie', cookie, { append: true });\n }\n return c.redirect(logoutUrl ?? '/');\n },\n },\n );\n } else if (isAuthHttpHandler(provider)) {\n routes.push(\n {\n // Hosted-login equivalent: no hosted page, so send the browser to the\n // SPA's /signin form, preserving returnTo.\n path: '/auth/login',\n method: 'GET',\n handler: c => {\n const returnTo = sanitizeReturnTo(c.req.query('returnTo'));\n return c.redirect(`/signin?returnTo=${encodeURIComponent(returnTo)}`);\n },\n },\n {\n path: '/auth/logout',\n method: 'GET',\n handler: async c => {\n // Revoke the session server-side through the provider's own sign-out\n // endpoint and forward its clearing cookies; fall back to our clear\n // cookies regardless.\n try {\n const origin = new URL(c.req.url).origin;\n const response = await provider.handleAuthRequest(\n new Request(`${origin}/auth/api/sign-out`, { method: 'POST', headers: c.req.raw.headers }),\n );\n for (const cookie of response.headers.getSetCookie()) {\n c.header('Set-Cookie', cookie, { append: true });\n }\n } catch {\n // No/invalid session: nothing to revoke.\n }\n for (const cookie of providerClearCookies(provider)) {\n c.header('Set-Cookie', cookie, { append: true });\n }\n return c.redirect('/');\n },\n },\n );\n }\n\n return routes;\n}\n\n/**\n * Register the public `/auth/*` routes on a Hono app: the capability-derived\n * provider routes (login/callback/logout/provider APIs) plus the\n * provider-neutral `/auth/me`. Split out from `mountFactoryAuth` so both the local\n * Hono server and the platform Mastra entry can reuse the exact same handlers.\n */\nexport function registerAuthRoutes(\n app: Hono<any>,\n provider: IMastraAuthProvider,\n options: { publicUrl?: string } = {},\n): void {\n for (const route of providerAuthRoutes(provider, options.publicUrl)) {\n const methods = route.method === 'ALL' ? ['GET', 'POST', 'PUT', 'DELETE', 'PATCH'] : [route.method];\n app.on(methods, route.path, c => route.handler(c));\n }\n app.get('/auth/me', c => handleAuthMe(provider, c, options.publicUrl));\n}\n\n/**\n * Build the public `/auth/*` routes (provider routes + `/auth/me`) as Mastra\n * `server.apiRoutes`. Used by the platform Mastra entry (`src/mastra/index.ts`),\n * which can't register plain Hono routes on the deployer-generated app the way\n * the local server does via {@link registerAuthRoutes}.\n *\n * Handlers are identical to {@link registerAuthRoutes}. All are `requiresAuth: false`\n * (they must be reachable while unauthenticated), and the gate middleware skips\n * `/auth/*` so it never blocks them. `/auth/*` is not under `/api`, so it is a\n * valid custom-route path.\n */\nexport function buildAuthRoutes(provider: IMastraAuthProvider, options: { publicUrl?: string } = {}): ApiRoute[] {\n return [\n // `registerApiRoute` handlers see @mastra/core's bundled hono Context type,\n // which is structurally identical to (but nominally distinct from) the\n // local hono version the route handlers are typed against — cast across\n // the seam.\n ...providerAuthRoutes(provider, options.publicUrl).map(route =>\n registerApiRoute(route.path, {\n method: route.method,\n requiresAuth: false,\n handler: c => route.handler(c as unknown as Context),\n }),\n ),\n registerApiRoute('/auth/me', {\n method: 'GET',\n requiresAuth: false,\n handler: c => handleAuthMe(provider, c as unknown as Context, options.publicUrl),\n }),\n ];\n}\n\n/**\n * `/auth/*` routes for auth-disabled mode (`auth: null`). Only `/auth/me`, answering\n * 404 — the UI's \"auth disabled\" signal. Without it the deployer's HTML catch-all\n * answers `/auth/me` with 200 text/html and the UI retries forever.\n */\nexport function buildAuthDisabledRoutes(): ApiRoute[] {\n return [\n registerApiRoute('/auth/me', {\n method: 'GET',\n requiresAuth: false,\n handler: c => c.json({ authEnabled: false, authenticated: false }, 404),\n }),\n ];\n}\n\n/**\n * Channel webhook paths whose adapter verifies the platform's request signature,\n * making the delivery self-authenticating. Add a platform here only once its\n * adapter rejects unsigned or mis-signed requests.\n */\nconst SIGNATURE_VERIFYING_CHANNEL_WEBHOOK = /^\\/api\\/agent-controllers\\/[^/]+\\/channels\\/slack\\/webhook$/;\n\n// Fetched by tabs that may already be signed out. Enumerated, not prefix-matched,\n// so a future route under the same prefix does not inherit the pass.\nconst SESSION_FAVICON_PATHS = new Set([\n '/favicon-session-initializing.svg',\n '/favicon-session-working.svg',\n '/favicon-session-awaiting.svg',\n '/favicon-session-error.svg',\n]);\n\n/**\n * Request-context key marking an authenticated interactive turn. HTTP requests\n * and linked Slack senders verified against their session owner can carry it;\n * wakes, webhooks, and dispatcher turns cannot.\n */\nexport const FACTORY_INTERACTIVE_KEY = 'factoryInteractive';\n\n/** With auth disabled there is no gate; this marks every HTTP request as interactive instead. */\nexport function createFactoryInteractiveMarker() {\n return async (c: Context, next: () => Promise<void>): Promise<void> => {\n c.get('requestContext')?.set(FACTORY_INTERACTIVE_KEY, true);\n await next();\n };\n}\n\n/**\n * Build the auth gate as a plain Hono middleware handler `(c, next)`. Protects\n * everything that is not a public `/auth/*` route: authenticated requests stash\n * the user on the context and continue; unauthenticated navigations redirect to\n * login and XHR/API calls get a 401 JSON. Shared by the local Hono server\n * (`mountFactoryAuth`) and the platform Mastra entry (`server.middleware`).\n */\nexport function createFactoryAuthGate(provider: IMastraAuthProvider) {\n return async (c: Context, next: () => Promise<void>): Promise<Response | void> => {\n const path = c.req.path;\n if (path.startsWith('/auth/')) {\n return next();\n }\n if (c.req.method === 'POST' && (path === '/web/github/webhook' || path === '/web/gitlab/webhook')) {\n return next();\n }\n // Inbound chat-channel webhooks (Slack events) carry no user session: they\n // authenticate by platform signature, the adapter verifying the request\n // against its signing secret. The routes declare `requiresAuth: false`, but\n // this gate is `use()` middleware — it runs before route matching, so that\n // metadata is not readable here and the path needs an explicit pass.\n //\n // The platform is allowlisted rather than matched as a wildcard: a pass\n // keyed on path shape alone would silently extend to any future adapter,\n // including one that does not verify signatures. Controller id stays a\n // wildcard because it is whatever the host registered.\n if (c.req.method === 'POST' && SIGNATURE_VERIFYING_CHANNEL_WEBHOOK.test(path)) {\n return next();\n }\n // The Slack account-linking deep link and the Sign-in-with-Slack OIDC\n // start/callback do their own auth (friendly login-redirect for signed-out\n // visitors; the OIDC callback authenticates via its signed `state`) — see\n // connect-route.ts.\n if (c.req.method === 'GET' && (path === '/connect/slack' || path.startsWith('/connect/slack/'))) {\n return next();\n }\n // The platform's deploy-auth flow lands IdP denials on `/login`\n // (`error=access_denied&error_description=...`); the SPA serves sign-in at\n // `/signin`, so forward the query there instead of burying it in returnTo.\n if (c.req.method === 'GET' && path === '/login') {\n return c.redirect(`/signin${new URL(c.req.url).search}`);\n }\n // The SPA sign-in page, its static bundle, and browser-fetched metadata\n // must be reachable while signed out; no user is stashed, so `/api/*`\n // stays protected.\n if (\n path === '/signin' ||\n path.startsWith('/assets/') ||\n path === '/manifest.webmanifest' ||\n path === '/mastra.svg' ||\n path === '/pwa-192.png' ||\n path === '/pwa-512.png' ||\n path === '/apple-touch-icon.png' ||\n (c.req.method === 'GET' && SESSION_FAVICON_PATHS.has(path))\n ) {\n return next();\n }\n\n const token = getBearerToken(c.req.header('Authorization'));\n // A slow verification here delays EVERY protected request — surface\n // outliers so auth-backend latency is attributable from server logs.\n const user = await timedAboveThreshold('auth.gate.authenticate', 1_000, () =>\n authenticateRequest(provider, token, c.req.raw),\n );\n forwardPendingResponseHeaders(provider, c);\n\n if (user) {\n // Without a requested org, no-org accounts get a bootstrapped personal org\n // so the org id resolves on this request (see ensureFactoryAuthUser).\n if (!(await applyRequestedOrganization(provider, c, token, user))) {\n return c.json({ error: 'organization_forbidden' }, 403);\n }\n c.set(FACTORY_AUTH_USER_KEY, user);\n const requestContext = c.get('requestContext');\n requestContext?.set('user', user);\n requestContext?.set(MASTRA_MESSAGE_AUTHOR_KEY, messageAuthor(user));\n requestContext?.set(FACTORY_INTERACTIVE_KEY, true);\n return next();\n }\n\n if (isNavigationRequest(path, c.req.header('Accept'))) {\n const url = new URL(c.req.url);\n const returnTo = sanitizeReturnTo(url.pathname + url.search);\n return c.redirect(`/signin?returnTo=${encodeURIComponent(returnTo)}`);\n }\n\n return c.json({ error: 'unauthorized' }, 401);\n };\n}\n\n/**\n * Mount factory auth gating onto the host app. No-op when auth is disabled\n * (no provider active).\n *\n * Must be called before the Mastra adapter routes, the `/web/*` routes, and\n * the static UI handlers so the gate covers every request. Composes the shared\n * `registerAuthRoutes` + `createFactoryAuthGate` factories so the local Hono server\n * and the platform Mastra entry stay behavior-identical.\n */\nexport function mountFactoryAuth(app: Hono<any>, options: MountFactoryAuthOptions = {}): boolean {\n const provider = options.provider ?? envFallbackAuthProvider(options.redirectUri);\n if (!provider) return false;\n\n registerAuthRoutes(app, provider, { publicUrl: options.publicUrl });\n app.use('*', createFactoryAuthGate(provider));\n return true;\n}\n"],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"board-writes.d.ts","sourceRoot":"","sources":["../../src/boards/board-writes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAG7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EAEpB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAG9E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAW7D,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,mBAAmB,CAAC;IAC7B,oGAAoG;IACpG,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,UAAU,GAAG,YAAY,GAAG,cAAc,GAAG,YAAY,GAAG,SAAS,CAAC,CAAC;IACvG,oDAAoD;IACpD,SAAS,EAAE,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED,6EAA6E;AAC7E,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C;AAED,uFAAuF;AACvF,qBAAa,eAAgB,SAAQ,KAAK;IAGtC,QAAQ,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG;IAChC,QAAQ,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAHrE,IAAI,SAAqB;IAClC,YACW,MAAM,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,EACvB,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAG7E;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,MAAM,CAIxE;AAgCD,qBAAa,WAAW;;IACV,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAjC,YAA6B,IAAI,EAAE,eAAe,EAAI;IAEtD;;;OAGG;IACH,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,IAAI,CAevE;IAEK,QAAQ,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAI/E;IAED;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,
|
|
1
|
+
{"version":3,"file":"board-writes.d.ts","sourceRoot":"","sources":["../../src/boards/board-writes.ts"],"names":[],"mappings":"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"}
|
|
@@ -2,7 +2,7 @@ import { findBoardSkillProblems } from "../skills/app-skills.js";
|
|
|
2
2
|
import { StoredBoardError } from "../storage/domains/boards/base.js";
|
|
3
3
|
import "../storage/domains/work-items/legacy-review.js";
|
|
4
4
|
import { codeBoardOf } from "./define-board.js";
|
|
5
|
-
import {
|
|
5
|
+
import { boardRegistryOf } from "./registry.js";
|
|
6
6
|
import { boardForWorkItem } from "./semantics.js";
|
|
7
7
|
import { codeBehaviourConflicts, compileStoredBoard, sameBoardDefinition, storedBoardInputSchema } from "./stored-board.js";
|
|
8
8
|
import { workBoard } from "./work.js";
|
|
@@ -101,10 +101,7 @@ var BoardWrites = class {
|
|
|
101
101
|
});
|
|
102
102
|
}
|
|
103
103
|
const board = code ? compileStoredBoard(parsed.data, code) : compileStoredBoard(parsed.data);
|
|
104
|
-
const unknown = findBoardSkillProblems(
|
|
105
|
-
boards: [board],
|
|
106
|
-
includeDefaultBoards: false
|
|
107
|
-
}), boards.codeSkills).filter((problem) => problem.includes(UNKNOWN_SKILL));
|
|
104
|
+
const unknown = findBoardSkillProblems(boardRegistryOf([board]), boards.codeSkills).filter((problem) => problem.includes(UNKNOWN_SKILL));
|
|
108
105
|
if (unknown.length > 0) throw new BoardWriteError(422, {
|
|
109
106
|
error: "unknown_skill",
|
|
110
107
|
message: unknown.join(" ")
|
|
@@ -116,6 +113,7 @@ var BoardWrites = class {
|
|
|
116
113
|
const key = input?.key;
|
|
117
114
|
if (typeof key === "string") this.refuseCodeBoard(key, "create");
|
|
118
115
|
const board = this.validate(input);
|
|
116
|
+
await this.deps.boards.describe(scope);
|
|
119
117
|
const row = await stored(() => this.deps.storage.create(scope, board, writer.id));
|
|
120
118
|
this.deps.boards.invalidate(scope);
|
|
121
119
|
await this.#audit(scope, writer, "created", board);
|
|
@@ -213,8 +211,9 @@ var BoardWrites = class {
|
|
|
213
211
|
}
|
|
214
212
|
await boards.describe(scope);
|
|
215
213
|
const row = await this.existing(scope, key);
|
|
216
|
-
|
|
217
|
-
|
|
214
|
+
const definition = boards.seedFor(key, row) ?? seed;
|
|
215
|
+
await this.#checkPhasesFree(scope, row, definition.phases);
|
|
216
|
+
const reset = await stored(() => storage.resetTo(scope, key, definition, {
|
|
218
217
|
expectedRevision,
|
|
219
218
|
actor: writer.id
|
|
220
219
|
}));
|