@mastra/factory 0.24.0-alpha.1 → 0.24.0-alpha.11

package/README.md

@@ -575,10 +575,10 @@ const gitlab = new PlatformGitLabIntegration(); // Optionally { connectionId: 'c
 
 In Platform mode, issue, note, merge request and push events reach Factory by polling the Platform's event log for each connection, the same way Platform GitHub deployments do. Point the GitLab project webhook at the Platform's Nango forwarding URL, not at Factory; Platform mode needs neither `MASTRA_GITLAB_CONNECTION_ID` nor `MASTRA_GITLAB_WEBHOOK_SECRET`. The direct `/web/gitlab/webhook` route stays available when `MASTRA_GITLAB_WEBHOOK_SECRET` is set; do not point a project webhook at both Factory and the Platform, or each event is processed twice.
 
-| Variable                                     | Default | Purpose                                                               |
-| -------------------------------------------- | ------- | --------------------------------------------------------------------- |
-| `MASTRA_PLATFORM_GITLAB_POLLING_ENABLED`     | `true`  | Set `false` to stop polling the Platform event log for GitLab events. |
-| `MASTRA_PLATFORM_GITLAB_POLLING_INTERVAL_MS` | `20000` | Positive polling interval in milliseconds.                            |
+| Variable | Default | Purpose |
+| -------------------------------------------- | ------- |
+| `MASTRA_PLATFORM_GITLAB_POLLING_ENABLED` | `true` | Set `false` to stop polling the Platform event log for GitLab events. |
+| `MASTRA_PLATFORM_GITLAB_POLLING_INTERVAL_MS` | `20000` | Positive polling interval in milliseconds. |
 
 These sit next to `MASTRA_PLATFORM_GITHUB_POLLING_ENABLED` and `MASTRA_PLATFORM_GITHUB_POLLING_INTERVAL_MS` and follow the same rules. One replica polls at a time; the cursor for each connection is stored in the integration settings table and only advances once a page of events has been processed. `diagnostics()` reports `pollingEnabled` and `pollingIntervalMs`.
 
@@ -648,6 +648,108 @@ A repository maintainer with write or admin access can start a Factory review fr
 
 `@<factory-app> re-review` is also accepted. Factory resolves `<factory-app>` from its observed or configured GitHub App login (without the `[bot]` suffix), so commands are ignored until that identity is known. The command creates and starts a first Review pass for a missing or Intake card, restarts a completed card with `factory-rereview`, and is a no-op while the card is already Reviewing. Other prose, quoted mentions, edited comments, and comments from untrusted users do not trigger a run.
 
+### Factory tools in user sessions
+
+A person's own Factory session (a user session) gets tools to find, file and manage the Factory's work items through its agent. Factory scopes the tools from the stored session row, never from the thread's `factoryProjectId` tag: the session must belong to a Factory in the caller's organization, and a private session only works for its owner. With authentication disabled, the shared `local` tenant applies. Sessions doing work for someone else, either bound to a work item's run or started as a side session, only get `factory_message_origin`, so they can report back and answer messages.
+
+| Tool                            | Input                                                                                                                                           |
+| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
+| `factory_list_work_items`       | Optional `query` (title text or `#number`), `stage`, `board`, `role`, `active`, `requestedBy: 'me'`, `subscribed`, `limit` (default 25, max 50) |
+| `factory_inspect_work_item`     | `workItem` (id or `#number`)                                                                                                                    |
+| `factory_list_attention`        | Optional `limit` (max 50)                                                                                                                       |
+| `factory_create_work_item`      | `title`, `brief`, optional `repository` (`owner/name`, one this Factory links)                                                                  |
+| `factory_update_work_item`      | `workItem` plus any of `title`, `repository`, `parentWorkItem` (or `null` to detach), `plansPreapproved: true`                                  |
+| `factory_subscribe_work_item`   | `workItem`                                                                                                                                      |
+| `factory_unsubscribe_work_item` | `workItem`                                                                                                                                      |
+| `factory_transition_work_item`  | `workItem`, `stage`                                                                                                                             |
+| `factory_retry_decision`        | `decisionId`                                                                                                                                    |
+| `factory_dismiss_decision`      | `decisionId`                                                                                                                                    |
+| `factory_resolve_proposal`      | `decisionId`, `action` (`approve` or `dismiss`)                                                                                                 |
+| `factory_start_session`         | `prompt` (up to 8000 characters), optional `title`; for a work-item role, `workItem` and `role`                                                 |
+| `factory_answer_approval`       | `sessionId`, `toolCallId`, `decision` (approve or decline), optional `reason`                                                                   |
+| `factory_switch_session_model`  | `sessionId`, `modelId`                                                                                                                          |
+| `factory_signal_session`        | `sessionId`, `message` (up to 4000 characters), optional `priority` (`low`, `medium`, `high`, `urgent`; default `medium`)                       |
+| `factory_message_origin`        | `message`, optional `inReplyTo` (the message's notification id), optional `status` (`progress`, `blocked`, `done`, `failed`)                    |
+
+Read tools and `factory_message_origin` are available on every turn. The other tools only appear on turns a signed-in person started, so text arriving from a notification, webhook or channel can't drive them. The one exception is `factory_signal_session`: on those turns it can still message the side sessions this session started and the active sessions of work items it follows, so the session can answer the sessions it is waiting on. None of them asks for approval: they are allowed on the session when it's created, unless the person has set their own policy for the tool or for the `mcp` category.
+
+`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.
+
+`factory_create_work_item` files the card as the caller in its board's first phase, exactly like **New card**, posts the brief as its first comment, 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 parent item and plan pre-approval. 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.
+
+#### Messaging between sessions
+
+`factory_signal_session` messages any other session in the same Factory that the caller can see: a work item's role session, or a teammate's session that isn't private. The message arrives as a `factory-session` notification on that session's own thread. Factory brings an offline session back online first, and the turn it wakes runs as that session's owner, with the owner's credentials, never as the sender.
+
+How a message is delivered depends on its priority. `urgent` always delivers, even into a running turn. `high` and `medium` wake an idle session; while it is busy, `high` arrives as a summary and then in full, and `medium` waits for the current step. `low` arrives as a summary. Agents can read the full text of any notification with `notification_inbox`. A session can send at most 10 messages, replies and reports, together, to the same session thread in 10 minutes; past that, the tools refuse until the window moves on. `progress` reports don't count, since they replace each other.
+
+`factory_message_origin` with `inReplyTo` answers a message. `inReplyTo` must name a `factory-session` message that reached the answering session's own thread, and the reply goes to the session and thread that sent it, never to an address the agent supplies. Each message can be answered once, and replies, reports and other notifications can't be answered, so two agents can't ping-pong. Replies arrive at `high` priority and carry an `in-reply-to` attribute. Messages and replies are recorded in the audit trail as `factory.agent.signaled`.
+
+#### Sub-sessions
+
+`factory_start_session` starts another session for the caller and sends `prompt` as its first message. It has two modes:
+
+- **Side session** (no `workItem`): a standalone session with no work item, for a one-off job. It uses the same repository as the session that started it. Factory stores that session on the new session's row (`origin_session_id`, `origin_thread_id`) and copies the parent's visibility.
+- **Work-item role** (`workItem` and `role`): starts a role the item's board seats, the same way **Start** does in the Factory UI. The card does not move and no autonomy is armed. The tool refuses when the role already has a session, naming it so the agent can message it instead, and refuses an item linked to several repositories. The caller is subscribed to the item, and the run is recorded as `factory.run.started` with the caller as the person who started it.
+
+Both modes attribute the new session to the caller, so it runs with the caller's credentials (the caller's own keys under the `user` model scope, the organization's under `factory`) and keeps the Factory's default worker model. The first message runs with only the caller as its user, never the rest of the parent turn's context. The tool needs no approval but, like the other management tools, only appears on turns a signed-in person started.
+
+#### Reports
+
+A spawned session reports back with `factory_message_origin` without `inReplyTo`. A side session's report goes to the session that started it; a work-item session's report goes to every session subscribed to the item except itself. The `status` sets how the report is delivered:
+
+| `status`   | Notification kind | Priority |
+| ---------- | ----------------- | -------- |
+| `failed`   | `failed`          | `urgent` |
+| `blocked`  | `blocked`         | `urgent` |
+| `done`     | `done`            | `high`   |
+| `progress` | `progress`        | `low`    |
+| none       | `report`          | `high`   |
+
+Progress reports from one session replace each other while unread. `done`, `failed` and `blocked` reports are never replaced, so a final report can't be overwritten by a later progress update.
+
+Every run of a work session or side session ends with exactly one final report, however the run started: the board, a person typing into the session, a wake from another session's message, or a run after a server restart. Each Factory session gets a listener when it is created. A session with an active run binding reports to everyone following its work item, including for the run that moved the item to a finished stage and so ended its own binding; a side session reports to the session that started it; a person's own session reports to nobody. When a run ends, Factory checks each recipient's thread for a final report the agent sent since the run started, and sends one itself to the recipients that lack it: `done` when the run completed, `failed` when it ended in error (quoting the error), and `blocked`, naming the tool, when the run stopped waiting for an answer or for someone to approve a tool call. A reply with a final `status` counts as the final report, and any reply counts for a completed run. A run that completes after the agent reported `blocked` is waiting for an answer, so it gets no `done`; a run someone stopped gets no report. A board run that fails before it ever runs (no session, a configuration the run can't succeed with) reports `failed` once no retry remains. These backstop reports carry a `backstop` attribute.
+
+A run that holds a tool call for approval stays open, so the same listener tells those sessions right away: an urgent `approval` notification names the session, the tool, its arguments and the `toolCallId`, once per call. A session that follows the work item, or started the side session, can answer it with `factory_answer_approval`, as the person signed in to it; the answer is audited as `factory.run.approved` or `factory.run.dismissed`. Other people's private sessions can't be answered, and an approval whose run already ended can't be either: the tool says so, and the session can be messaged to try again.
+
+When a followed work item changes stage, subscribers whose session is running get a `low` priority `stage` notice. A stage change never wakes an offline session; it sees the current stage in its state signal instead.
+
+#### The `<factory-sessions>` state signal
+
+A user session sees what it is waiting on without calling a tool. Once it has started a side session or follows a work item, each step carries a `<factory-sessions>` state signal listing:
+
+- side sessions it started: title, session id, whether it is running, parked or idle, and the last report with its time;
+- work items it follows: number, title, stage, the session working on it and whether that session is `running`, `idle` or `parked`, and the last report with its time. Following doesn't end when an item finishes; a session can unsubscribe when it's done with an item.
+
+Running entries come first, and the list shows at most 20 rows with a "+N more" line. Side sessions idle for more than 24 hours, and items in a finished stage for more than 24 hours, drop out. Sessions the caller only messaged never appear. When the last entry goes, the signal sends "No sub-sessions or followed work items." once and then stays silent. The signal is only resent when its content changes.
+
+Spawned sessions get a one-line signal instead: a side session sees which session started it, and a work-item session sees the item, its role, and how many sessions follow it (nothing when nobody does).
+
+The tools take their scope as an argument rather than reading the request, so the same tool set can later be mounted elsewhere, such as an MCP server.
+
+### MCP server (ChatGPT and other MCP clients)
+
+A Factory with an auth provider and an OAuth authorization server serves an MCP endpoint over Streamable HTTP:
+
+```
+https://<your-factory>/web/factory/projects/<projectId>/mcp
+```
+
+It exposes the Factory tools a signed-in web session has (list, inspect, create, update and transition work items, start and signal sessions, decisions, approvals), plus `search` and `fetch` over work items for ChatGPT. Each tool carries MCP annotations (read-only, destructive, idempotent) so clients can ask before changes.
+
+Callers must sign in. Requests without a valid bearer token get `401` with a `WWW-Authenticate` header pointing to the RFC 9728 metadata at `/.well-known/oauth-protected-resource/web/factory/projects/<projectId>/mcp`. Tokens go through the same auth provider and org checks as the web UI. Each user gets one private connector session per Factory that the session tools act from.
+
+To connect ChatGPT, open **Settings → Connectors → Create**, paste the endpoint URL, and choose OAuth. Factories on Mastra Platform auth advertise Platform's AuthKit (`https://auth-kit.mastra.ai`) automatically. With other auth providers, set the authorization server the metadata advertises, or the endpoint isn't served:
+
+```ts
+new MastraFactory({
+  // ...
+  mcp: { authorizationServers: ['https://your-tenant.authkit.app'] },
+});
+```
+
+or set `MASTRA_FACTORY_MCP_AUTHORIZATION_SERVER`. Pass `mcp: false` to turn the endpoint off.
+
 ### Development
 
 Run focused package checks from the repository root:

package/dist/auth.d.ts

@@ -114,6 +114,12 @@ export declare function factoryUserOrgId(user: FactoryAuthUser | undefined): str
  * falls back to a user-only tenant.
  */
 export declare function factoryAuthTenant(c: Context): FactoryAuthTenant | undefined;
+/**
+ * The `org_id` claim of a JWT bearer token. Read only after the provider has
+ * verified the token, and only adopted when the user is a verified member of
+ * that org — so it picks among orgs the user already has, never grants one.
+ */
+export declare function bearerTokenOrgClaim(token: string | undefined): string | undefined;
 /**
  * Fail-closed authorization for organization-level administrative mutations.
  * The caller must belong to the same active organization and the provider must
@@ -180,6 +186,14 @@ export declare function buildAuthRoutes(provider: IMastraAuthProvider, options?:
  * answers `/auth/me` with 200 text/html and the UI retries forever.
  */
 export declare function buildAuthDisabledRoutes(): ApiRoute[];
+/**
+ * Request-context key marking an authenticated interactive turn. HTTP requests
+ * and linked Slack senders verified against their session owner can carry it;
+ * wakes, webhooks, and dispatcher turns cannot.
+ */
+export declare const FACTORY_INTERACTIVE_KEY = "factoryInteractive";
+/** With auth disabled there is no gate; this marks every HTTP request as interactive instead. */
+export declare function createFactoryInteractiveMarker(): (c: Context, next: () => Promise<void>) => Promise<void>;
 /**
  * Build the auth gate as a plain Hono middleware handler `(c, next)`. Protects
  * everything that is not a public `/auth/*` route: authenticated requests stash

package/dist/auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"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"}

package/dist/auth.js

@@ -197,6 +197,34 @@ async function ensureUserOrg(provider, user) {
 		if (orgId) user.organizationId = orgId;
 	} catch {}
 }
+/**
+* The `org_id` claim of a JWT bearer token. Read only after the provider has
+* verified the token, and only adopted when the user is a verified member of
+* that org — so it picks among orgs the user already has, never grants one.
+*/
+function bearerTokenOrgClaim(token) {
+	const payload = token?.split(".")[1];
+	if (!payload) return void 0;
+	try {
+		const claims = JSON.parse(Buffer.from(payload, "base64url").toString("utf8"));
+		return typeof claims.org_id === "string" && claims.org_id ? claims.org_id : void 0;
+	} catch {
+		return;
+	}
+}
+/**
+* Picks the request's org: an explicit `X-Mastra-Organization-Id` header, else
+* a bearer token's `org_id` claim (MCP clients such as ChatGPT can't send the
+* header, and the verify endpoint otherwise reports the user's default org).
+* Either must name an org the user belongs to, else `false` — never fall back
+* to another org than the one asked for. With neither, bootstraps the user's org.
+*/
+async function applyRequestedOrganization(provider, c, token, user) {
+	const requested = (token ? c.req.header(ORGANIZATION_ID_HEADER)?.trim() : void 0) || bearerTokenOrgClaim(token);
+	if (requested) return selectRequestedOrganization(user, requested);
+	await ensureUserOrg(provider, user);
+	return true;
+}
 function selectRequestedOrganization(user, requestedOrganizationId) {
 	if (user.organizationId === requestedOrganizationId) return true;
 	if (!user.organizationMembershipIds?.includes(requestedOrganizationId)) return false;
@@ -283,10 +311,7 @@ async function ensureFactoryAuthUser(provider, c) {
 	const user = await authenticateRequest(provider, token, c.req.raw);
 	forwardPendingResponseHeaders(provider, c);
 	if (!user) return void 0;
-	const requestedOrganizationId = token ? c.req.header(ORGANIZATION_ID_HEADER)?.trim() : void 0;
-	if (requestedOrganizationId) {
-		if (!selectRequestedOrganization(user, requestedOrganizationId)) throw new HTTPException(403, { message: "organization_forbidden" });
-	} else await ensureUserOrg(provider, user);
+	if (!await applyRequestedOrganization(provider, c, token, user)) throw new HTTPException(403, { message: "organization_forbidden" });
 	c.set(FACTORY_AUTH_USER_KEY, user);
 	return user;
 }
@@ -564,6 +589,19 @@ const SESSION_FAVICON_PATHS = /* @__PURE__ */ new Set([
 	"/favicon-session-error.svg"
 ]);
 /**
+* Request-context key marking an authenticated interactive turn. HTTP requests
+* and linked Slack senders verified against their session owner can carry it;
+* wakes, webhooks, and dispatcher turns cannot.
+*/
+const FACTORY_INTERACTIVE_KEY = "factoryInteractive";
+/** With auth disabled there is no gate; this marks every HTTP request as interactive instead. */
+function createFactoryInteractiveMarker() {
+	return async (c, next) => {
+		c.get("requestContext")?.set(FACTORY_INTERACTIVE_KEY, true);
+		await next();
+	};
+}
+/**
 * Build the auth gate as a plain Hono middleware handler `(c, next)`. Protects
 * everything that is not a public `/auth/*` route: authenticated requests stash
 * the user on the context and continue; unauthenticated navigations redirect to
@@ -583,14 +621,12 @@ function createFactoryAuthGate(provider) {
 		const user = await timedAboveThreshold("auth.gate.authenticate", 1e3, () => authenticateRequest(provider, token, c.req.raw));
 		forwardPendingResponseHeaders(provider, c);
 		if (user) {
-			const requestedOrganizationId = token ? c.req.header(ORGANIZATION_ID_HEADER)?.trim() : void 0;
-			if (requestedOrganizationId) {
-				if (!selectRequestedOrganization(user, requestedOrganizationId)) return c.json({ error: "organization_forbidden" }, 403);
-			} else await ensureUserOrg(provider, user);
+			if (!await applyRequestedOrganization(provider, c, token, user)) return c.json({ error: "organization_forbidden" }, 403);
 			c.set(FACTORY_AUTH_USER_KEY, user);
 			const requestContext = c.get("requestContext");
 			requestContext?.set("user", user);
 			requestContext?.set(MASTRA_MESSAGE_AUTHOR_KEY, messageAuthor(user));
+			requestContext?.set(FACTORY_INTERACTIVE_KEY, true);
 			return next();
 		}
 		if (isNavigationRequest(path, c.req.header("Accept"))) {
@@ -618,6 +654,6 @@ function mountFactoryAuth(app, options = {}) {
 	return true;
 }
 //#endregion
-export { buildAuthDisabledRoutes, buildAuthRoutes, createFactoryAuthGate, createFactoryRouteAuth, ensureFactoryAuthUser, factoryAuthTenant, factoryUserOrgId, getBearerToken, getFactoryAuthOrgId, getFactoryAuthUser, getFactoryAuthUserFromContext, getFactoryAuthUserId, getWorkOSProvider, isCrossSiteAuth, isOrganizationAdmin, isWorkOSAuth, mountFactoryAuth, registerAuthRoutes, sanitizeReturnTo };
+export { FACTORY_INTERACTIVE_KEY, bearerTokenOrgClaim, buildAuthDisabledRoutes, buildAuthRoutes, createFactoryAuthGate, createFactoryInteractiveMarker, createFactoryRouteAuth, ensureFactoryAuthUser, factoryAuthTenant, factoryUserOrgId, getBearerToken, getFactoryAuthOrgId, getFactoryAuthUser, getFactoryAuthUserFromContext, getFactoryAuthUserId, getWorkOSProvider, isCrossSiteAuth, isOrganizationAdmin, isWorkOSAuth, mountFactoryAuth, registerAuthRoutes, sanitizeReturnTo };
 
 //# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -1 +1 @@
-{"version":3,"file":"auth.js","names":[],"sources":["../src/auth.ts"],"sourcesContent":["import { 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\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 getClearSessionHeaders = (provider as Partial<ISessionProvider>).getClearSessionHeaders;\n  if (typeof getClearSessionHeaders !== 'function') return [];\n  const headers = getClearSessionHeaders.call(provider) ?? {};\n  const setCookie = headers['Set-Cookie'];\n  if (!setCookie) return [];\n  // A provider may join several clearing cookies into one header value.\n  return setCookie.split(/,(?=\\s*[^;=,\\s]+=)/).map(cookie => cookie.trim());\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  };\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  const requestedOrganizationId = token ? c.req.header(ORGANIZATION_ID_HEADER)?.trim() : undefined;\n  if (requestedOrganizationId) {\n    if (!selectRequestedOrganization(user, requestedOrganizationId)) {\n      throw new HTTPException(403, { message: 'organization_forbidden' });\n    }\n  } else {\n    await ensureUserOrg(provider, user);\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 scope the cookie to this deployment's\n              // domain via MASTRA_COOKIE_DOMAIN / sharedApiUrl auto-detection).\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            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 * 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      const requestedOrganizationId = token ? c.req.header(ORGANIZATION_ID_HEADER)?.trim() : undefined;\n      if (requestedOrganizationId) {\n        if (!selectRequestedOrganization(user, requestedOrganizationId)) {\n          return c.json({ error: 'organization_forbidden' }, 403);\n        }\n      } else {\n        // Bootstrap a personal org for no-org accounts so the org id resolves on\n        // this request (see ensureFactoryAuthUser for the rationale).\n        await ensureUserOrg(provider, user);\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      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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"}
+{"version":3,"file":"auth.js","names":[],"sources":["../src/auth.ts"],"sourcesContent":["import { 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 getClearSessionHeaders = (provider as Partial<ISessionProvider>).getClearSessionHeaders;\n  if (typeof getClearSessionHeaders !== 'function') return [];\n  const headers = getClearSessionHeaders.call(provider) ?? {};\n  const setCookie = headers['Set-Cookie'];\n  if (!setCookie) return [];\n  // A provider may join several clearing cookies into one header value.\n  return setCookie.split(/,(?=\\s*[^;=,\\s]+=)/).map(cookie => cookie.trim());\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  };\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 scope the cookie to this deployment's\n              // domain via MASTRA_COOKIE_DOMAIN / sharedApiUrl auto-detection).\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            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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"}

package/dist/boards/review.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/boards/review.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAA2B,MAAM,mBAAmB,CAAC;AA4DzF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAExE;AA4CD,eAAO,MAAM,WAAW,kGAqCtB,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,WAAW,CAAC,MAAM,CAAC;AAE/D,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,gBAAgB,CAE3E"}
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/boards/review.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAA2B,MAAM,mBAAmB,CAAC;AAoGzF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAExE;AA4CD,eAAO,MAAM,WAAW,kGAqCtB,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,WAAW,CAAC,MAAM,CAAC;AAE/D,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,gBAAgB,CAE3E"}

package/dist/boards/review.js

@@ -29,6 +29,26 @@ function checkoutHint(item) {
 function isSafeBranchName(value) {
 	return /^[A-Za-z0-9][A-Za-z0-9._/@+-]*$/.test(value) && !value.includes("..") && !value.includes("//") && !value.includes("@{") && !value.endsWith(".") && !value.endsWith("/") && !value.endsWith(".lock");
 }
+function commitSha(value) {
+	return typeof value === "string" && /^(?:[0-9a-f]{40}|[0-9a-f]{64})$/i.test(value) ? value.toLowerCase() : void 0;
+}
+/**
+* Names the head this pass covers. Without it every pass on a pull request
+* opens with the same text, so a reviewer reading a re-review kickoff in the
+* session that recorded the last verdict can take it for a repeat and restate
+* that verdict instead of reviewing what was pushed since.
+*/
+function headLine(item, priorReviewCompleted) {
+	const head = commitSha(item.metadata?.pullRequestHeadSha);
+	const reviewed = priorReviewCompleted ? commitSha(item.metadata?.reviewedHeadSha) : void 0;
+	const recorded = item.metadata?.reviewVerdict;
+	const priorPass = recorded === "approve" || recorded === "request changes" ? `recorded "${recorded}"` : "reviewed";
+	if (head && reviewed && head !== reviewed) return `\n\nThis is a new review pass for head \`${head}\`. The previous pass ${priorPass} on \`${reviewed}\`; that pass does not cover this head. Review the changes since \`${reviewed}\` and record a verdict for \`${head}\`.`;
+	if (head && reviewed) return `\n\nThis is a new review pass. The previous pass ${priorPass} on \`${reviewed}\`, which is also the last recorded head. Read the current head first: if it moved, review the changes since \`${reviewed}\` and record a verdict for the new head; otherwise check the change request for anything new and record a verdict for \`${head}\`.`;
+	if (head) return `\n\nThis review pass covers head \`${head}\`. Record your verdict for that head.`;
+	if (reviewed) return `\n\nThis is a new review pass. The previous pass ${priorPass} on \`${reviewed}\`. Read the current head first; if it moved, review the changes since \`${reviewed}\` and record a verdict for the new head.`;
+	return "";
+}
 function hasRecordedVerdict(item) {
 	return typeof item.metadata?.reviewVerdict === "string";
 }
@@ -49,7 +69,7 @@ function reviewPullRequest(context) {
 		idempotencyKey: `${context.ingress.id}:${skillName}`,
 		role: "review",
 		skillName,
-		arguments: `${sourceRef(context.item)}\n\n${checkoutHint(context.item)}`,
+		arguments: `${sourceRef(context.item)}\n\n${checkoutHint(context.item)}${headLine(context.item, priorReviewCompleted)}`,
 		...supersedes ? { cancelInFlight: true } : {},
 		...supersedes && !priorReviewCompleted ? { resume: true } : {}
 	};