@mastra/factory 0.2.1 → 0.2.2-alpha.1

package/dist/workspace.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/workspace.ts","../src/auth.ts","../src/integrations/github/pat.ts","../src/integrations/github/sandbox.ts","../src/sandbox/fleet.ts","../src/integrations/github/token-refresh.ts","../src/rules/binding-context.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport path, { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { SandboxFilesystem } from '@mastra/code-sdk/agents/sandbox-filesystem';\nimport { MASTRACODE_WORKSPACE_TOOLS } from '@mastra/code-sdk/agents/tool-availability';\nimport { getDynamicWorkspace } from '@mastra/code-sdk/agents/workspace';\nimport type { WorkspaceSkillExtension } from '@mastra/code-sdk/agents/workspace';\nimport { DEFAULT_CONFIG_DIR } from '@mastra/code-sdk/constants';\nimport type { MastraCodeState } from '@mastra/code-sdk/schema';\nimport type { AgentControllerRequestContext } from '@mastra/core/agent-controller';\nimport { LocalSandbox, LocalSkillSource, Workspace } from '@mastra/core/workspace';\nimport type { SkillSource, SkillSourceEntry, SkillSourceStat } from '@mastra/core/workspace';\nimport { getFactoryAuthUserId } from './auth.js';\nimport type { FactoryAuthUser } from './auth.js';\nimport type { MastraFactorySandboxConfig } from './factory.js';\nimport type { GithubIntegration } from './integrations/github/integration.js';\nimport { getGithubPat } from './integrations/github/pat.js';\nimport type { GithubPatKind } from './integrations/github/pat.js';\nimport { checkoutSessionBranch, materializeRepo, runWorktreeSetup } from './integrations/github/sandbox.js';\nimport { registerGithubPatKind, registerGithubTokenInjector } from './integrations/github/token-refresh.js';\nimport { getFactorySessionAddress } from './rules/binding-context.js';\nimport type { SandboxBindingStore, SandboxFleet } from './sandbox/fleet.js';\nimport type { WorkItemsStorage } from './storage/domains/work-items/base.js';\n\nconst WORKSPACE_ID_PREFIX = 'mfw';\nconst SESSION_CHECKPOINT_PREFIX = 'mastracode-session';\n\nexport function checkpointNameForSession(sessionId: string): string {\n  return `${SESSION_CHECKPOINT_PREFIX}-${sessionId}`;\n}\n\nconst bundleDirectory = dirname(fileURLToPath(import.meta.url));\nconst bundledFactorySkillsPath = join(bundleDirectory, 'factory-skills');\nconst FACTORY_SKILLS_SOURCE_PATH =\n  [\n    // Deploy bundle: the consumer copies `factory-skills/` next to the built\n    // server module (e.g. via its public/ dir).\n    bundledFactorySkillsPath,\n    // Package layout: `dist/../factory-skills` (also `src/../factory-skills`\n    // when running tests against sources).\n    join(bundleDirectory, '..', 'factory-skills'),\n    // Consumer repo running from its package root before a build.\n    join(process.cwd(), 'src', 'mastra', 'public', 'factory-skills'),\n  ].find(existsSync) ?? bundledFactorySkillsPath;\nconst FACTORY_SKILLS_MOUNT = path.resolve(path.parse(process.cwd()).root, '__mastracode_factory_skills__');\nconst FACTORY_SKILL_NAMES = new Set(['configure-factory-rules', 'factory-plan', 'factory-review', 'factory-triage']);\n\nclass FactorySkillSource implements SkillSource {\n  readonly #factorySource = new LocalSkillSource({ basePath: FACTORY_SKILLS_SOURCE_PATH });\n  readonly #fallbackSkillRoots: Set<string>;\n\n  constructor(\n    readonly fallback: SkillSource,\n    fallbackSkillRoots: string[],\n  ) {\n    this.#fallbackSkillRoots = new Set(fallbackSkillRoots.map(skillPath => path.normalize(skillPath)));\n  }\n\n  #isFactoryPath(skillPath: string): boolean {\n    const normalized = path.normalize(skillPath);\n    return normalized === FACTORY_SKILLS_MOUNT || normalized.startsWith(`${FACTORY_SKILLS_MOUNT}${path.sep}`);\n  }\n\n  #factoryPath(skillPath: string): string {\n    return path.relative(FACTORY_SKILLS_MOUNT, path.normalize(skillPath));\n  }\n\n  exists(skillPath: string): Promise<boolean> {\n    return this.#isFactoryPath(skillPath)\n      ? this.#factorySource.exists(this.#factoryPath(skillPath))\n      : this.fallback.exists(skillPath);\n  }\n\n  stat(skillPath: string): Promise<SkillSourceStat> {\n    return this.#isFactoryPath(skillPath)\n      ? this.#factorySource.stat(this.#factoryPath(skillPath))\n      : this.fallback.stat(skillPath);\n  }\n\n  readFile(skillPath: string): Promise<string | Buffer> {\n    return this.#isFactoryPath(skillPath)\n      ? this.#factorySource.readFile(this.#factoryPath(skillPath))\n      : this.fallback.readFile(skillPath);\n  }\n\n  async readdir(skillPath: string): Promise<SkillSourceEntry[]> {\n    if (this.#isFactoryPath(skillPath)) {\n      return this.#factorySource.readdir(this.#factoryPath(skillPath));\n    }\n    const entries = await this.fallback.readdir(skillPath);\n    if (this.#fallbackSkillRoots.has(path.normalize(skillPath))) {\n      return entries.filter(entry => !FACTORY_SKILL_NAMES.has(entry.name));\n    }\n    return entries;\n  }\n\n  realpath(skillPath: string): Promise<string> {\n    if (this.#isFactoryPath(skillPath)) return Promise.resolve(path.normalize(skillPath));\n    return this.fallback.realpath ? this.fallback.realpath(skillPath) : Promise.resolve(skillPath);\n  }\n}\n\nconst factorySkillExtension: WorkspaceSkillExtension = {\n  id: 'web-factory',\n  paths: [FACTORY_SKILLS_MOUNT],\n  createSource: (fallback, fallbackSkillRoots) => new FactorySkillSource(fallback, fallbackSkillRoots),\n};\n\ntype DynamicWorkspaceContext = Parameters<typeof getDynamicWorkspace>[0];\n\nexport interface CreateWorkspaceFactoryOptions {\n  /** Factory sandbox runtime config (template machine + workdir base). */\n  sandbox?: MastraFactorySandboxConfig;\n  /** GitHub integration used to resolve Factory sessions and mint repo tokens. */\n  github?: GithubIntegration;\n  /** Fleet the per-session sandboxes are provisioned/reattached through. */\n  fleet?: SandboxFleet;\n  /** Work-items storage used to resolve the session's run-binding role, so\n   * review-board sessions get the reviewer PAT as `GH_TOKEN`. Optional —\n   * without it every session uses the default (worker) PAT. */\n  workItems?: Pick<WorkItemsStorage, 'findRunBindingBySession'>;\n}\n\nexport function createWorkspaceFactory(options: CreateWorkspaceFactoryOptions = {}) {\n  const { sandbox: sandboxConfig, github, fleet, workItems } = options;\n  const isLocalSandbox = sandboxConfig?.machine instanceof LocalSandbox;\n  const githubTokenInjectors = new Map<\n    string,\n    { inject: (token: string) => void; patKind: GithubPatKind; ghToken: string }\n  >();\n\n  return async ({ requestContext, mastra, skillExtension }: DynamicWorkspaceContext) => {\n    const effectiveSkillExtension = skillExtension ?? factorySkillExtension;\n    const ctx = requestContext.get('controller') as AgentControllerRequestContext<MastraCodeState> | undefined;\n    const session =\n      ctx?.resourceId && github ? await github.sourceControlStorage.sessions.getBySessionId(ctx.resourceId) : null;\n\n    if (!session) {\n      if (sandboxConfig && !isLocalSandbox) {\n        throw new Error('A Factory session ID is required to create a remote sandbox workspace');\n      }\n      return getDynamicWorkspace({ requestContext, mastra, skillExtension: effectiveSkillExtension });\n    }\n\n    const user = requestContext.get('user') as FactoryAuthUser | undefined;\n    const userId = getFactoryAuthUserId(user);\n    if (!user?.organizationId || !userId || user.organizationId !== session.orgId || userId !== session.userId) {\n      throw new Error(`Factory session ${session.sessionId} is not available to the current user`);\n    }\n    if (!sandboxConfig || !github || !fleet) {\n      throw new Error('GitHub and sandbox providers are required to create a Factory session workspace');\n    }\n\n    const storage = github.sourceControlStorage;\n    const projectRepository = await storage.projectRepositories.get({\n      orgId: session.orgId,\n      id: session.projectRepositoryId,\n    });\n    if (!projectRepository) throw new Error(`Repository link ${session.projectRepositoryId} was not found`);\n    const connection = await storage.connections.get({ orgId: session.orgId, id: projectRepository.connectionId });\n    const repository = await storage.repositories.get({ orgId: session.orgId, id: projectRepository.repositoryId });\n    if (!connection || !repository) throw new Error(`Repository link ${session.projectRepositoryId} is incomplete`);\n    const installation = await storage.installations.get({ orgId: session.orgId, id: connection.installationId });\n    if (!installation) throw new Error(`GitHub installation ${connection.installationId} was not found`);\n    const repoFullName = repository.slug;\n\n    const workdir = isLocalSandbox\n      ? fleet.computeLocalSessionWorkdir(repoFullName, session.id)\n      : (session.sandboxWorkdir ?? projectRepository.sandboxWorkdir);\n    const binding: SandboxBindingStore = {\n      sandboxId: session.sandboxId,\n      checkpointName: checkpointNameForSession(session.id),\n      setSandboxId: async id => {\n        await storage.sessions.setSandbox({ id: session.id, sandboxId: id, sandboxWorkdir: workdir });\n        session.sandboxId = id;\n        session.sandboxWorkdir = workdir;\n      },\n      clear: async () => {\n        await storage.sessions.setSandbox({ id: session.id, sandboxId: null, sandboxWorkdir: workdir });\n        session.sandboxId = null;\n      },\n    };\n\n    const extensionId = effectiveSkillExtension ? `-${effectiveSkillExtension.id}` : '';\n    const workspaceId = `${WORKSPACE_ID_PREFIX}-${projectRepository.id}-${session.id}${extensionId}`;\n    const configDir = sandboxConfig.workdir ?? DEFAULT_CONFIG_DIR;\n    try {\n      const existing = mastra?.getWorkspaceById(workspaceId) as Workspace | undefined;\n      if (existing) {\n        existing.setToolsConfig(MASTRACODE_WORKSPACE_TOOLS);\n        const registered = githubTokenInjectors.get(workspaceId);\n        if (registered) {\n          registerGithubTokenInjector(requestContext, registered.inject);\n          registerGithubPatKind(requestContext, registered.patKind);\n          // A PAT saved in Settings after this sandbox was provisioned must\n          // reach the running sandbox without a server restart — re-read it\n          // on every reuse and push it into the live sandbox when it changed.\n          // Best-effort: a failed read or inject keeps the installed token.\n          try {\n            const pat = await getGithubPat(() => github.integrationStorage, session.orgId, registered.patKind);\n            if (pat && pat !== registered.ghToken) {\n              registered.inject(pat);\n            }\n          } catch {\n            // Keep the token already installed in the sandbox.\n          }\n        }\n        return existing;\n      }\n    } catch {\n      // Not registered yet.\n    }\n\n    const access = await github.versionControl.getRepositoryAccess({\n      orgId: session.orgId,\n      repositoryId: repository.id,\n    });\n    const token = access.authorization?.token;\n    if (!token) throw new Error('Repository access did not include a bearer token for the Factory session');\n\n    // The `gh` CLI needs a PAT when the org configured one (installation\n    // tokens 403 on integration-restricted endpoints); git clone/checkout\n    // below keep using the minted installation token. Review-board sessions\n    // (run-binding role `review`) authenticate `gh` as the reviewer account\n    // when a reviewer token is configured; everything else — including\n    // sessions with no resolvable run binding — uses the worker token.\n    let patKind: GithubPatKind = 'default';\n    if (workItems) {\n      try {\n        const address = getFactorySessionAddress(requestContext);\n        const runBinding = address ? await workItems.findRunBindingBySession(address) : null;\n        if (runBinding?.role === 'review' && runBinding.orgId === session.orgId) patKind = 'reviewer';\n      } catch {\n        // No resolvable binding — worker token.\n      }\n    }\n    const ghCliToken = (await getGithubPat(() => github.integrationStorage, session.orgId, patKind)) ?? token;\n\n    const sandbox = await fleet.ensureSandbox(\n      binding,\n      { GH_TOKEN: ghCliToken },\n      undefined,\n      isLocalSandbox ? { workingDirectory: workdir } : {},\n    );\n    await materializeRepo({\n      row: { id: session.id, sandboxWorkdir: workdir, materializedAt: session.materializedAt },\n      repoInfo: { repoFullName: repoFullName, defaultBranch: repository.defaultBranch },\n      sandbox,\n      token,\n      storage: storage.sessions,\n    });\n    await checkoutSessionBranch(sandbox, workdir, {\n      branch: session.branch,\n      baseBranch: session.baseBranch || projectRepository.branch || repository.defaultBranch,\n      token,\n      repoFullName: repoFullName,\n    });\n    if (projectRepository.setupCommand) await runWorktreeSetup(sandbox, workdir, projectRepository.setupCommand);\n\n    const injectGithubToken = (freshToken: string) => {\n      if (!sandbox.setEnvironmentVariable) {\n        throw new Error('The active sandbox provider does not support runtime GitHub token refresh.');\n      }\n      sandbox.setEnvironmentVariable('GH_TOKEN', freshToken);\n      const registered = githubTokenInjectors.get(workspaceId);\n      if (registered) registered.ghToken = freshToken;\n    };\n    githubTokenInjectors.set(workspaceId, { inject: injectGithubToken, patKind, ghToken: ghCliToken });\n    registerGithubTokenInjector(requestContext, injectGithubToken);\n    registerGithubPatKind(requestContext, patKind);\n\n    const filesystem = new SandboxFilesystem({ sandbox, workdir });\n    const projectSkillPaths = [path.join(configDir, 'skills'), '.claude/skills', '.agents/skills'];\n    const skillPaths = [...(effectiveSkillExtension?.paths ?? []), ...projectSkillPaths];\n    return new Workspace({\n      id: workspaceId,\n      name: 'Mastra Code Factory Session Workspace',\n      filesystem,\n      sandbox: sandbox as unknown as ConstructorParameters<typeof Workspace>[0]['sandbox'],\n      tools: MASTRACODE_WORKSPACE_TOOLS,\n      skills: skillPaths,\n      skillSource: effectiveSkillExtension?.createSource(filesystem, projectSkillPaths) ?? filesystem,\n    });\n  };\n}\n\nexport const getFactoryWorkspace = createWorkspaceFactory();\n","import { MastraAuthWorkos } from '@mastra/auth-workos';\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';\n\nimport type { RouteAuth } from './routes/route.js';\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 and its `/assets/*`\n * bundle. 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  /**\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}\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/** 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 * 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\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 }.\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 };\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      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    organizationId?: 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  return {\n    id,\n    workosId,\n    email: typeof flat.email === 'string' ? flat.email : undefined,\n    name: typeof flat.name === 'string' ? flat.name : undefined,\n    organizationId: typeof flat.organizationId === 'string' ? flat.organizationId : undefined,\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 * `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 */\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  if (!user) return undefined;\n\n  await ensureUserOrg(provider, user);\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\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): 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 meta = { provider: provider.name, ...(signUpDisabled ? { signUpDisabled: true } : {}) };\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    user: {\n      userId: getFactoryAuthUserId(user),\n      email: user.email,\n      name: user.name,\n      organizationId: user.organizationId,\n    },\n    ...meta,\n  });\n}\n\n/** Encode a validated returnTo path into the OAuth `state` parameter. */\nfunction encodeState(returnTo: string): string {\n  return Buffer.from(JSON.stringify({ returnTo }), 'utf8').toString('base64url');\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  try {\n    const parsed = JSON.parse(Buffer.from(state, 'base64url').toString('utf8')) as { returnTo?: string };\n    return sanitizeReturnTo(parsed.returnTo);\n  } catch {\n    return '/';\n  }\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          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          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 returnTo = decodeState(c.req.query('state'));\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));\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),\n    }),\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') {\n      return next();\n    }\n    // The SPA sign-in page and the static bundle it needs must be reachable\n    // while signed out; no user is stashed, so `/api/*` stays protected.\n    if (path === '/signin' || path.startsWith('/assets/')) {\n      return next();\n    }\n\n    const token = getBearerToken(c.req.header('Authorization'));\n    const user = await authenticateRequest(provider, token, c.req.raw);\n\n    if (user) {\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      c.set(FACTORY_AUTH_USER_KEY, user);\n      c.get('requestContext')?.set('user', 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","/**\n * Org-scoped GitHub Personal Access Token settings.\n *\n * GitHub App installation tokens are the wrong credential for the `gh` CLI —\n * they hit \"Resource not accessible by integration\" on endpoints the CLI\n * needs regardless of the minted permission set. When an org pastes a PAT in\n * Settings, the sandbox `GH_TOKEN` injection sites and the\n * `github_refresh_token` tool use it instead of a minted installation token.\n * Tokens must be classic PATs whose account has access to the linked repos.\n *\n * Two kinds:\n * - `default` — the worker token every sandbox gets.\n * - `reviewer` — optional second token for review-board sessions, so PR\n *   reviews come from a different account than the author. When it isn't\n *   configured, review sessions fall back to the worker token.\n *\n * Both live in the generic `integration_settings` collection for the\n * `github` integration under a sentinel user id (the settings are org-wide,\n * but the schema keys settings per `(org, user)`). Tokens are never returned\n * to the browser — the routes only report whether each is configured.\n */\n\nimport type { GithubSubscriptionStorage } from './subscriptions.js';\n\n/** Sentinel `user_id` for the org-wide settings row. */\nconst PAT_SETTINGS_USER_ID = '__github_org_settings__';\n\nexport type GithubPatKind = 'default' | 'reviewer';\n\ntype GithubOrgSettings = { pat?: string; reviewerPat?: string };\n\nconst FIELD_FOR_KIND: Record<GithubPatKind, keyof GithubOrgSettings> = {\n  default: 'pat',\n  reviewer: 'reviewerPat',\n};\n\nfunction asToken(value: unknown): string | null {\n  return typeof value === 'string' && value.length > 0 ? value : null;\n}\n\n/** The PAT to install for `kind`, or null. `reviewer` falls back to the\n * worker token so review sessions still authenticate when no dedicated\n * reviewer token is configured. Fail-soft: storage errors (e.g. integration\n * storage not initialized in a partial test harness) read as \"no PAT\n * configured\" so token minting still works. */\nexport async function getGithubPat(\n  getStorage: () => GithubSubscriptionStorage,\n  orgId: string,\n  kind: GithubPatKind = 'default',\n): Promise<string | null> {\n  try {\n    const settings = (await getStorage().settings.get(orgId, PAT_SETTINGS_USER_ID)) as GithubOrgSettings | null;\n    if (!settings) return null;\n    if (kind === 'reviewer') return asToken(settings.reviewerPat) ?? asToken(settings.pat);\n    return asToken(settings.pat);\n  } catch {\n    return null;\n  }\n}\n\n/** Which tokens are configured, without fallback semantics — feeds the\n * settings UI status badges. */\nexport async function getGithubPatStatus(\n  getStorage: () => GithubSubscriptionStorage,\n  orgId: string,\n): Promise<{ configured: boolean; reviewerConfigured: boolean }> {\n  try {\n    const settings = (await getStorage().settings.get(orgId, PAT_SETTINGS_USER_ID)) as GithubOrgSettings | null;\n    return {\n      configured: asToken(settings?.pat) !== null,\n      reviewerConfigured: asToken(settings?.reviewerPat) !== null,\n    };\n  } catch {\n    return { configured: false, reviewerConfigured: false };\n  }\n}\n\nexport async function setGithubPat(\n  storage: GithubSubscriptionStorage,\n  orgId: string,\n  pat: string,\n  kind: GithubPatKind = 'default',\n): Promise<void> {\n  const existing = ((await storage.settings.get(orgId, PAT_SETTINGS_USER_ID)) ?? {}) as GithubOrgSettings;\n  await storage.settings.save(orgId, PAT_SETTINGS_USER_ID, { ...existing, [FIELD_FOR_KIND[kind]]: pat });\n}\n\nexport async function clearGithubPat(\n  storage: GithubSubscriptionStorage,\n  orgId: string,\n  kind: GithubPatKind = 'default',\n): Promise<void> {\n  const existing = (await storage.settings.get(orgId, PAT_SETTINGS_USER_ID)) as GithubOrgSettings | null;\n  const field = FIELD_FOR_KIND[kind];\n  if (!existing?.[field]) return;\n  const { [field]: _removed, ...rest } = existing;\n  await storage.settings.save(orgId, PAT_SETTINGS_USER_ID, rest);\n}\n","/**\n * Repo materialization for GitHub-backed repositories.\n *\n * A GitHub repo is never cloned onto the server host. Instead each project gets\n * its own isolated sandbox (provisioned by the fleet in `../sandbox/fleet`) and\n * the repo is cloned *inside* that sandbox. The agent's file tools and command\n * tools then operate entirely against the remote checkout.\n *\n * - `ensureProjectSandbox(row)` / `teardownProjectSandbox(row)` bind the fleet's\n *   provision/reattach/teardown lifecycle to the per-(project,user) sandbox row.\n * - `materializeRepo(row, token)` runs `git clone` (first open) or `git pull`\n *   (re-open) inside the sandbox, using a short-lived installation token that is\n *   scrubbed from the git remote afterwards so it never persists in the VM.\n *\n * This module owns everything git/GitHub: clone/pull, commit/push, worktrees,\n * and `gh pr create`. Sandbox provisioning, budgets, and workdir layout live in\n * the fleet module.\n */\n\nimport { createHash } from 'node:crypto';\nimport { reportProgress } from '../../sandbox/fleet.js';\nimport type {\n  MaterializationSandbox,\n  ProgressFn,\n  SandboxBindingStore,\n  SandboxCommandResult,\n  SandboxFleet,\n} from '../../sandbox/fleet.js';\nimport type {\n  ProjectRepositorySandbox,\n  SourceControlStorageHandle,\n} from '../../storage/domains/source-control/base.js';\n\ntype SourceControlSandboxStorage = SourceControlStorageHandle['sandboxes'];\ntype MaterializationStore = Pick<SourceControlSandboxStorage, 'markMaterialized'>;\n\ninterface RepoMaterializationBinding {\n  id: string;\n  sandboxWorkdir: string;\n  materializedAt: Date | null;\n}\n\n/** Adapt a per-(project,user) sandbox binding row to the fleet's persistence seam. */\nfunction bindingStore(row: ProjectRepositorySandbox, storage: SourceControlSandboxStorage): SandboxBindingStore {\n  return {\n    sandboxId: row.sandboxId,\n    setSandboxId: id =>\n      id === null ? storage.clearBinding({ id: row.id }) : storage.setSandboxId({ id: row.id, sandboxId: id }),\n    clear: () => storage.clearBinding({ id: row.id }),\n  };\n}\n\n/**\n * Provision a new sandbox (persisting its provider id on first open) or\n * reattach to the stored one. Returns a started, live sandbox.\n */\nexport async function ensureProjectSandbox(options: {\n  fleet: SandboxFleet;\n  row: ProjectRepositorySandbox;\n  storage: SourceControlSandboxStorage;\n  token: string;\n  onProgress?: ProgressFn;\n}): Promise<MaterializationSandbox> {\n  const { fleet, row, storage, token, onProgress } = options;\n  return fleet.ensureSandbox(bindingStore(row, storage), { GH_TOKEN: token }, onProgress);\n}\n\n/**\n * Tear down a user's sandbox for a project: stop the live VM (best-effort) and\n * clear the persisted `sandboxId`/`materializedAt` on the per-(project,user)\n * binding row so the next open re-provisions cleanly.\n *\n * @param row     the per-(project,user) sandbox binding to tear down\n * @param sandbox an already-reattached live sandbox to stop, when available\n */\nexport async function teardownProjectSandbox(options: {\n  fleet: SandboxFleet;\n  row: ProjectRepositorySandbox;\n  storage: SourceControlSandboxStorage;\n  sandbox?: MaterializationSandbox;\n}): Promise<void> {\n  const { fleet, row, storage, sandbox } = options;\n  return fleet.teardownSandbox(bindingStore(row, storage), sandbox);\n}\n\n/**\n * Single-quote a string for safe POSIX shell interpolation. Wraps the value in\n * single quotes and escapes any embedded single quote using the canonical\n * close-quote / escaped-quote / reopen-quote sequence (`'\\''`). This is the\n * standard POSIX-safe construction and prevents the quoted string from being\n * terminated early.\n */\nexport function shellQuote(value: string): string {\n  // Replace each ' with the four-character sequence: ' \\ ' '\n  return `'` + value.split(`'`).join(`'\\\\''`) + `'`;\n}\n\n/** Run a shell script in the sandbox via `sh -c`. */\nasync function sh(sandbox: MaterializationSandbox, script: string): Promise<SandboxCommandResult> {\n  return sandbox.executeCommand('sh', ['-c', script]);\n}\n\n/** Error raised when the sandbox cannot materialize the repo (actionable). */\nexport class MaterializeError extends Error {\n  constructor(\n    message: string,\n    readonly code:\n      | 'git-missing'\n      | 'egress-blocked'\n      | 'clone-failed'\n      | 'pull-failed'\n      | 'push-failed'\n      | 'commit-failed'\n      | 'gh-missing'\n      | 'pr-failed',\n  ) {\n    super(message);\n    this.name = 'MaterializeError';\n  }\n}\n\n/**\n * Build the token-auth clone/pull URL for a repo. The token lives only inside\n * this URL and is scrubbed from the remote after the operation.\n */\nfunction tokenUrl(repoFullName: string, token: string): string {\n  return `https://x-access-token:${token}@github.com/${repoFullName}.git`;\n}\n\nfunction cleanUrl(repoFullName: string): string {\n  return `https://github.com/${repoFullName}.git`;\n}\n\n/** Repo metadata needed to materialize, read from the org-owned project row. */\nexport interface RepoMaterializeInfo {\n  repoFullName: string;\n  defaultBranch: string;\n}\n\n/**\n * Materialize the repo inside the user's sandbox. Clones on first open, pulls on\n * re-open. Always scrubs the install token from the remote afterwards and sets\n * `materialized_at` on the per-user sandbox binding row.\n *\n */\nexport async function materializeRepo(options: {\n  /** The per-(project,user) sandbox binding (provisioned via `ensureProjectSandbox`). */\n  row: RepoMaterializationBinding;\n  /** Repo metadata from the org-owned project row. */\n  repoInfo: RepoMaterializeInfo;\n  /** The live sandbox to run git inside. */\n  sandbox: MaterializationSandbox;\n  /** A freshly minted, short-lived installation access token. */\n  token: string;\n  storage: MaterializationStore;\n  onProgress?: ProgressFn;\n}): Promise<void> {\n  const { row: sandboxRow, repoInfo, sandbox, token, storage, onProgress } = options;\n  const workdir = sandboxRow.sandboxWorkdir;\n  const repo = repoInfo.repoFullName;\n\n  // 0. Defense in depth: never build a git command from values that aren't\n  // strictly shaped, even if a malformed row reached the DB. Inputs are also\n  // validated at the route boundary before storage.\n  if (!/^[\\w.-]+\\/[\\w.-]+$/.test(repo)) {\n    throw new MaterializeError(`Refusing to materialize: invalid repo full name '${repo}'.`, 'clone-failed');\n  }\n  if (!/^[A-Za-z0-9_./-]+$/.test(repoInfo.defaultBranch)) {\n    throw new MaterializeError(\n      `Refusing to materialize: invalid default branch '${repoInfo.defaultBranch}'.`,\n      'clone-failed',\n    );\n  }\n\n  // 1. Preflight: git must be installed in the sandbox template.\n  const gitVersion = await sh(sandbox, 'git --version');\n  if (gitVersion.exitCode !== 0) {\n    throw new MaterializeError(\n      'git is not installed in the sandbox. The sandbox template must include git.',\n      'git-missing',\n    );\n  }\n\n  const authUrl = tokenUrl(repo, token);\n\n  // The DB's `materializedAt` can drift from disk — a fresh per-user binding\n  // row over an already-populated workdir (local dev DB resets, repaired\n  // rows, earlier flows) would make `git clone` fail on the non-empty\n  // directory. Re-detect an existing checkout of this repo and pull instead.\n  const alreadyMaterialized = Boolean(sandboxRow.materializedAt) || (await hasExistingCheckout(sandbox, workdir, repo));\n\n  try {\n    if (!alreadyMaterialized) {\n      // 2a. First open: shallow-clone the default branch into the workdir. A\n      // shallow single-branch clone is dramatically faster for large repos; the\n      // later re-open uses `git pull --ff-only`, which works on shallow clones.\n      reportProgress(onProgress, {\n        phase: 'cloning',\n        message: `Cloning ${repo} (first open can take a minute)…`,\n      });\n      const clone = await sh(\n        sandbox,\n        `git clone --depth=1 --single-branch --branch ${shellQuote(repoInfo.defaultBranch)} ${shellQuote(authUrl)} ${shellQuote(workdir)}`,\n      );\n      if (clone.exitCode !== 0) {\n        throw classifyGitFailure(clone, 'clone-failed');\n      }\n    } else {\n      // 2b. Re-open: refresh remote to the token URL and fast-forward pull.\n      reportProgress(onProgress, { phase: 'pulling', message: `Updating ${repo} to the latest changes…` });\n      const setUrl = await sh(sandbox, `git -C ${shellQuote(workdir)} remote set-url origin ${shellQuote(authUrl)}`);\n      if (setUrl.exitCode !== 0) {\n        throw new MaterializeError(`Failed to set git remote: ${setUrl.stderr}`, 'pull-failed');\n      }\n      const pull = await sh(sandbox, `git -C ${shellQuote(workdir)} pull --ff-only`);\n      if (pull.exitCode !== 0) {\n        throw classifyGitFailure(pull, 'pull-failed');\n      }\n    }\n  } finally {\n    // 3. Always scrub the token from the remote so it isn't left in the VM's\n    // git config, even when the clone/pull above failed partway through. This\n    // is best-effort on the failure path (the workdir may not exist yet after a\n    // failed clone); on the success path the scrub must succeed or we surface it.\n    await scrubRemote(sandbox, workdir, repo, alreadyMaterialized);\n  }\n\n  // 4. Mark materialized.\n  reportProgress(onProgress, { phase: 'finalizing', message: 'Finalizing workspace…' });\n  await storage.markMaterialized({ id: sandboxRow.id });\n}\n\n/** Check out a session's branch inside its isolated repository clone. */\nexport async function checkoutSessionBranch(\n  sandbox: MaterializationSandbox,\n  workdir: string,\n  {\n    branch,\n    baseBranch,\n    token,\n    repoFullName,\n  }: { branch: string; baseBranch: string; token: string; repoFullName: string },\n): Promise<void> {\n  if (!isValidGitRef(branch) || !isValidGitRef(baseBranch)) {\n    throw new MaterializeError('Refusing to create a session from an invalid branch name.', 'clone-failed');\n  }\n\n  const current = await sh(sandbox, `git -C ${shellQuote(workdir)} branch --show-current`);\n  if (current.exitCode === 0 && current.stdout.trim() === branch) return;\n\n  const local = await sh(\n    sandbox,\n    `git -C ${shellQuote(workdir)} show-ref --verify --quiet refs/heads/${shellQuote(branch)}`,\n  );\n  if (local.exitCode === 0) {\n    const checkout = await sh(sandbox, `git -C ${shellQuote(workdir)} checkout ${shellQuote(branch)}`);\n    if (checkout.exitCode !== 0) throw classifyGitFailure(checkout, 'clone-failed');\n    return;\n  }\n\n  const authUrl = tokenUrl(repoFullName, token);\n  try {\n    const setUrl = await sh(sandbox, `git -C ${shellQuote(workdir)} remote set-url origin ${shellQuote(authUrl)}`);\n    if (setUrl.exitCode !== 0) throw classifyGitFailure(setUrl, 'pull-failed');\n    const fetch = await sh(\n      sandbox,\n      `git -C ${shellQuote(workdir)} fetch origin ${shellQuote(baseBranch)} && git -C ${shellQuote(workdir)} checkout -b ${shellQuote(branch)} FETCH_HEAD`,\n    );\n    if (fetch.exitCode !== 0) throw classifyGitFailure(fetch, 'clone-failed');\n  } finally {\n    await sh(sandbox, `git -C ${shellQuote(workdir)} remote set-url origin ${shellQuote(cleanUrl(repoFullName))}`);\n  }\n}\n\n/**\n * True when the workdir already holds a git checkout whose `origin` points at\n * this exact repo. Matches both the clean and token-auth URL forms; any other\n * remote (or no git dir at all) falls back to the clone path.\n */\nasync function hasExistingCheckout(\n  sandbox: MaterializationSandbox,\n  workdir: string,\n  repoFullName: string,\n): Promise<boolean> {\n  const result = await sh(sandbox, `git -C ${shellQuote(workdir)} remote get-url origin`);\n  if (result.exitCode !== 0) return false;\n  const url = result.stdout.trim().toLowerCase();\n  const suffix = `github.com/${repoFullName.toLowerCase()}`;\n  return url.endsWith(`${suffix}.git`) || url.endsWith(suffix);\n}\n\n/**\n * Reset the git remote back to the tokenless URL. On a successful clone/pull the\n * workdir always has a `.git`, so a non-zero exit code here means the token may\n * still be persisted — surface it. On the failure path the workdir may not exist\n * (e.g. a failed clone), so a non-zero exit is tolerated.\n */\nasync function scrubRemote(\n  sandbox: MaterializationSandbox,\n  workdir: string,\n  repoFullName: string,\n  expectGitDir: boolean,\n): Promise<void> {\n  const result = await sh(\n    sandbox,\n    `git -C ${shellQuote(workdir)} remote set-url origin ${shellQuote(cleanUrl(repoFullName))}`,\n  );\n  if (result.exitCode !== 0 && expectGitDir) {\n    throw new MaterializeError(\n      `Failed to scrub installation token from git remote: ${result.stderr.trim() || result.stdout.trim()}`,\n      'pull-failed',\n    );\n  }\n}\n\n/**\n * Turn a failed git command into an actionable error, detecting the common\n * \"cannot reach github.com\" egress failure.\n */\nfunction classifyGitFailure(\n  result: SandboxCommandResult,\n  fallback: 'clone-failed' | 'pull-failed' | 'push-failed',\n): MaterializeError {\n  const stderr = result.stderr || '';\n  if (/could not resolve host|failed to connect|network is unreachable|Connection timed out/i.test(stderr)) {\n    return new MaterializeError(\n      'The sandbox could not reach github.com. The sandbox network must allow outbound egress to github.com.',\n      'egress-blocked',\n    );\n  }\n  const verb = fallback === 'clone-failed' ? 'clone' : fallback === 'pull-failed' ? 'pull' : 'push';\n  return new MaterializeError(`git ${verb} failed: ${stderr}`, fallback);\n}\n\n// ---------------------------------------------------------------------------\n// Phase 1 — git identity + token-scoped push primitive\n//\n// These helpers let the sandbox author and push commits safely. The install\n// token is short-lived, minted per-operation server-side, injected only into\n// the temporary remote URL inside the sandbox, and always scrubbed in a\n// `finally` so it never persists in `.git/config`.\n// ---------------------------------------------------------------------------\n\n/**\n * Validate a git ref (branch) name. Server-side defense-in-depth: only allow a\n * conservative character set so a branch can never be built into a shell\n * command in a way that escapes quoting. Mirrors the route-layer check.\n */\nexport function isValidGitRef(value: unknown): value is string {\n  return (\n    typeof value === 'string' &&\n    value.length > 0 &&\n    value.length <= 255 &&\n    // Reject leading-dash refs (e.g. `--mirror`) so the value can never be\n    // parsed as a git option when interpolated into a command.\n    !value.startsWith('-') &&\n    /^[A-Za-z0-9_./-]+$/.test(value)\n  );\n}\n\n/** Identity used to author commits inside the sandbox. */\nexport interface GitIdentity {\n  name?: string | null;\n  email?: string | null;\n  /** GitHub login, used to derive a stable noreply identity when name/email are absent. */\n  login?: string | null;\n}\n\n/**\n * Resolve a concrete `{ name, email }` for git authorship from a possibly-sparse\n * identity. Falls back to a GitHub-style noreply identity so commits are never\n * authored with an empty or host-derived identity.\n */\nexport function resolveGitIdentity(identity: GitIdentity): { name: string; email: string } {\n  const login = (identity.login || '').trim();\n  const name = (identity.name || '').trim() || login || 'Mastra Code';\n  const email =\n    (identity.email || '').trim() ||\n    (login ? `${login}@users.noreply.github.com` : 'mastra-code@users.noreply.github.com');\n  return { name, email };\n}\n\n/**\n * Configure `user.name` / `user.email` for the given repo working tree inside\n * the sandbox so commits are authored correctly. Values are shell-quoted.\n */\nexport async function configureGitIdentity(\n  sandbox: MaterializationSandbox,\n  workdir: string,\n  identity: GitIdentity,\n): Promise<void> {\n  const { name, email } = resolveGitIdentity(identity);\n  const setName = await sh(sandbox, `git -C ${shellQuote(workdir)} config user.name ${shellQuote(name)}`);\n  if (setName.exitCode !== 0) {\n    throw new MaterializeError(`Failed to set git user.name: ${setName.stderr.trim()}`, 'commit-failed');\n  }\n  const setEmail = await sh(sandbox, `git -C ${shellQuote(workdir)} config user.email ${shellQuote(email)}`);\n  if (setEmail.exitCode !== 0) {\n    throw new MaterializeError(`Failed to set git user.email: ${setEmail.stderr.trim()}`, 'commit-failed');\n  }\n}\n\n/**\n * Temporarily rewrite `origin` to a tokenized URL, run `fn` (e.g. a push), and\n * **always** scrub the remote back to the tokenless URL in a `finally`. The\n * token therefore only ever lives in the remote URL for the duration of the\n * operation and is never left in the VM's git config.\n *\n * On the success path the scrub must succeed (a leaked token is a hard error);\n * if it fails we surface it. On the failure path the scrub is best-effort but\n * still attempted, and the original operation error is rethrown.\n */\nexport async function withInstallToken<T>(\n  sandbox: MaterializationSandbox,\n  workdir: string,\n  repoFullName: string,\n  token: string,\n  fn: () => Promise<T>,\n): Promise<T> {\n  if (!/^[\\w.-]+\\/[\\w.-]+$/.test(repoFullName)) {\n    throw new MaterializeError(`Refusing to push: invalid repo full name '${repoFullName}'.`, 'push-failed');\n  }\n\n  const setUrl = await sh(\n    sandbox,\n    `git -C ${shellQuote(workdir)} remote set-url origin ${shellQuote(tokenUrl(repoFullName, token))}`,\n  );\n  if (setUrl.exitCode !== 0) {\n    // Best-effort scrub even though set-url failed, then surface the failure.\n    await scrubRemote(sandbox, workdir, repoFullName, false);\n    throw new MaterializeError(`Failed to set git remote: ${setUrl.stderr.trim()}`, 'push-failed');\n  }\n\n  try {\n    return await fn();\n  } finally {\n    // Always restore the tokenless remote. The workdir has a `.git` (we just\n    // rewrote its remote) so a scrub failure means the token may still persist\n    // — surface it.\n    await scrubRemote(sandbox, workdir, repoFullName, true);\n  }\n}\n\n/**\n * Push a branch back to GitHub from inside the sandbox using a short-lived\n * installation token. The branch is ref-validated, the token is injected only\n * into the remote URL via `withInstallToken`, and egress failures are\n * classified into actionable errors.\n */\nexport async function pushBranch(\n  sandbox: MaterializationSandbox,\n  workdir: string,\n  branch: string,\n  token: string,\n  repoFullName: string,\n): Promise<void> {\n  if (!isValidGitRef(branch)) {\n    throw new MaterializeError(`Refusing to push: invalid branch name '${branch}'.`, 'push-failed');\n  }\n\n  await withInstallToken(sandbox, workdir, repoFullName, token, async () => {\n    const push = await sh(sandbox, `git -C ${shellQuote(workdir)} push -u origin ${shellQuote(branch)}`);\n    if (push.exitCode !== 0) {\n      throw classifyGitFailure(push, 'push-failed');\n    }\n  });\n}\n\nexport interface CommitResult {\n  /** True when a commit was created; false when there was nothing to commit. */\n  committed: boolean;\n}\n\n/**\n * Stage every change in the working tree and create a commit inside the\n * sandbox. The git identity is configured first so authorship is correct. When\n * there is nothing to commit this is a no-op (`committed: false`) rather than an\n * error, so callers can safely commit-then-push without first diffing.\n *\n * @param sandbox  the live sandbox containing the checkout\n * @param workdir  the worktree (or repo) path to commit in\n * @param message  the commit message (quoted; arbitrary text is safe)\n * @param identity authorship identity for the commit\n */\nexport async function commitAll(\n  sandbox: MaterializationSandbox,\n  workdir: string,\n  message: string,\n  identity: GitIdentity,\n): Promise<CommitResult> {\n  await configureGitIdentity(sandbox, workdir, identity);\n\n  const add = await sh(sandbox, `git -C ${shellQuote(workdir)} add -A`);\n  if (add.exitCode !== 0) {\n    throw new MaterializeError(`git add failed: ${add.stderr.trim() || add.stdout.trim()}`, 'commit-failed');\n  }\n\n  // Nothing staged → nothing to commit. `git diff --cached --quiet` exits 1 when\n  // there are staged changes, 0 when the index is clean.\n  const staged = await sh(sandbox, `git -C ${shellQuote(workdir)} diff --cached --quiet`);\n  if (staged.exitCode === 0) {\n    return { committed: false };\n  }\n\n  const commit = await sh(sandbox, `git -C ${shellQuote(workdir)} commit -m ${shellQuote(message)}`);\n  if (commit.exitCode !== 0) {\n    throw new MaterializeError(`git commit failed: ${commit.stderr.trim() || commit.stdout.trim()}`, 'commit-failed');\n  }\n\n  return { committed: true };\n}\n\n// ---------------------------------------------------------------------------\n// Phase 2 — worktree / branch lifecycle\n//\n// Each unit of work gets its own branch + working tree inside the same sandbox\n// as the base checkout. The worktree path is always computed server-side from a\n// sanitized branch name; client input never reaches a filesystem path.\n// ---------------------------------------------------------------------------\n\n/** Error raised when a worktree cannot be created/reused inside the sandbox. */\nexport class WorktreeError extends Error {\n  constructor(\n    message: string,\n    readonly code: 'invalid-branch' | 'worktree-failed' | 'setup-failed',\n  ) {\n    super(message);\n    this.name = 'WorktreeError';\n  }\n}\n\n/**\n * Reduce a (already ref-validated) branch name to a filesystem-safe directory\n * segment for the worktree path: slashes/dots/unsafe chars collapsed to `-`.\n * This only affects the *directory name*, never the git branch itself.\n *\n * Sanitization is lossy (e.g. `feat/a` and `feat-a` both reduce to `feat-a`),\n * so an 8-char hash of the original branch is appended whenever the sanitized\n * form differs from the input. That keeps clean names (`main`) readable while\n * guaranteeing distinct branches never share a worktree directory.\n */\nexport function safeBranchDir(branch: string): string {\n  const sanitized =\n    branch\n      .replace(/[^A-Za-z0-9._-]+/g, '-')\n      .replace(/\\/+/g, '-')\n      .replace(/^[-.]+|[-.]+$/g, '')\n      .slice(0, 100) || 'work';\n  if (sanitized === branch) return sanitized;\n  const hash = createHash('sha256').update(branch).digest('hex').slice(0, 8);\n  return `${sanitized}-${hash}`;\n}\n\n/**\n * Compute the absolute worktree path for a branch, server-side only. Worktrees\n * live alongside the repo checkout under a sibling `worktrees/` directory so the\n * repo's `.git` is shared. Never derived from client-supplied paths.\n */\nexport function computeWorktreePath(repoWorkdir: string, branch: string): string {\n  const parent = repoWorkdir.replace(/\\/+$/, '').split('/').slice(0, -1).join('/') || '';\n  return `${parent}/worktrees/${safeBranchDir(branch)}`;\n}\n\nexport interface EnsureWorktreeResult {\n  worktreePath: string;\n  branch: string;\n  baseBranch: string;\n  /** True when an existing worktree was reused rather than freshly created. */\n  reused: boolean;\n}\n\n/**\n * Create (or reuse) a git worktree + branch inside the sandbox for a unit of\n * work. Idempotent: if a worktree already exists at the computed path it is\n * reused. The branch is created from the freshly fetched `origin/<baseBranch>`\n * — never the sandbox's possibly stale local ref — so new worktrees always\n * start from the latest remote state.\n *\n * @param sandbox       live sandbox containing the base checkout\n * @param repoWorkdir   the base repo checkout path inside the sandbox\n * @param branch        the feature branch (ref-validated server-side)\n * @param baseBranch    the branch to fork from (ref-validated; defaults to the repo's default branch)\n * @param token         short-lived installation token used only for the base-branch fetch\n * @param repoFullName  `owner/repo` used to build the tokenized remote URL\n */\nexport async function ensureWorktree(\n  sandbox: MaterializationSandbox,\n  repoWorkdir: string,\n  {\n    branch,\n    baseBranch,\n    token,\n    repoFullName,\n  }: { branch: string; baseBranch: string; token: string; repoFullName: string },\n): Promise<EnsureWorktreeResult> {\n  if (!isValidGitRef(branch)) {\n    throw new WorktreeError(`Invalid branch name '${branch}'.`, 'invalid-branch');\n  }\n  if (!isValidGitRef(baseBranch)) {\n    throw new WorktreeError(`Invalid base branch name '${baseBranch}'.`, 'invalid-branch');\n  }\n\n  const worktreePath = computeWorktreePath(repoWorkdir, branch);\n\n  // Idempotent reuse: a worktree already checked out at this path has a `.git`\n  // file (worktrees use a gitfile, not a directory). Reuse it as-is.\n  const exists = await sh(sandbox, `test -e ${shellQuote(`${worktreePath}/.git`)}`);\n  if (exists.exitCode === 0) {\n    return { worktreePath, branch, baseBranch, reused: true };\n  }\n\n  // Fetch the latest base ref from origin before forking. The explicit refspec\n  // updates `refs/remotes/origin/<base>` even when the checkout was created as\n  // a single-branch clone. The fetch needs the install token (the resting\n  // remote is tokenless), and a failure is a hard error — silently forking a\n  // stale local ref is worse than failing the request.\n  const baseRef = `origin/${baseBranch}`;\n  await withInstallToken(sandbox, repoWorkdir, repoFullName, token, async () => {\n    const fetch = await sh(\n      sandbox,\n      `git -C ${shellQuote(repoWorkdir)} fetch origin ${shellQuote(`+refs/heads/${baseBranch}:refs/remotes/${baseRef}`)}`,\n    );\n    if (fetch.exitCode !== 0) {\n      throw classifyGitFailure(fetch, 'pull-failed');\n    }\n  });\n\n  // Create the worktree. If the branch already exists, check it out into the\n  // worktree; otherwise create it from the fetched base. `git worktree add -B`\n  // creates-or-resets the branch to the base, which keeps this idempotent for a\n  // fresh worktree while still working when the branch already exists remotely.\n  // `--no-track` keeps the feature branch from tracking origin/<base>; pushes\n  // set their own upstream via `push -u`.\n  const add = await sh(\n    sandbox,\n    `git -C ${shellQuote(repoWorkdir)} worktree add --no-track -B ${shellQuote(branch)} ${shellQuote(worktreePath)} ${shellQuote(baseRef)}`,\n  );\n  if (add.exitCode !== 0) {\n    throw new WorktreeError(`git worktree add failed: ${add.stderr.trim() || add.stdout.trim()}`, 'worktree-failed');\n  }\n\n  return { worktreePath, branch, baseBranch, reused: false };\n}\n\n/**\n * Run the project's setup command (e.g. `pnpm i && pnpm build`) inside a\n * freshly created worktree. Called before the worktree is handed to any agent\n * run so the checkout is ready to build/test. A non-zero exit is a hard error —\n * starting agent work in a half-set-up tree is worse than failing the request.\n *\n * Security model: the command is intentionally arbitrary shell — that is the\n * feature (install deps, build, seed fixtures). It is only configurable by\n * authenticated org members (the settings route is gated by\n * `resolveOrgTenant` + org-scoped project lookup, with length and\n * control-character validation), and it executes exclusively inside the\n * project's isolated sandbox — the same environment where org members already\n * run arbitrary shell via the agent's command tool. It never runs on the web\n * server host, so it grants no privilege beyond what sandbox access already\n * provides.\n *\n * @param sandbox       live sandbox containing the worktree\n * @param worktreePath  the server-computed worktree path the command runs in\n * @param command       the org-configured setup shell command\n */\nexport async function runWorktreeSetup(\n  sandbox: MaterializationSandbox,\n  worktreePath: string,\n  command: string,\n): Promise<void> {\n  const result = await sh(sandbox, `cd ${shellQuote(worktreePath)} && { ${command}\\n}`);\n  if (result.exitCode !== 0) {\n    const detail = (result.stderr.trim() || result.stdout.trim()).slice(-2000);\n    throw new WorktreeError(`Setup command failed (exit ${result.exitCode}): ${detail}`, 'setup-failed');\n  }\n}\n\n/**\n * Remove a worktree (and its local feature branch) from the sandbox. The\n * checkout is removed with `--force` — the caller owns confirming that any\n * uncommitted work in it can be discarded. Idempotent: a worktree whose\n * directory is already gone only has its metadata pruned.\n *\n * @param sandbox       live sandbox containing the base checkout\n * @param repoWorkdir   the base repo checkout path inside the sandbox\n * @param branch        the worktree's feature branch (ref-validated)\n * @param worktreePath  the persisted, server-computed worktree path\n */\nexport async function removeWorktree(\n  sandbox: MaterializationSandbox,\n  repoWorkdir: string,\n  { branch, worktreePath }: { branch: string; worktreePath: string },\n): Promise<void> {\n  if (!isValidGitRef(branch)) {\n    throw new WorktreeError(`Invalid branch name '${branch}'.`, 'invalid-branch');\n  }\n\n  const remove = await sh(\n    sandbox,\n    `git -C ${shellQuote(repoWorkdir)} worktree remove --force ${shellQuote(worktreePath)}`,\n  );\n  if (remove.exitCode !== 0) {\n    // Tolerate a checkout that's already gone (e.g. a fresh sandbox after\n    // re-provisioning): prune stale metadata and only fail when the directory\n    // still exists, meaning git genuinely refused to remove it.\n    await sh(sandbox, `git -C ${shellQuote(repoWorkdir)} worktree prune`);\n    const exists = await sh(sandbox, `test -e ${shellQuote(worktreePath)}`);\n    if (exists.exitCode === 0) {\n      throw new WorktreeError(\n        `git worktree remove failed: ${remove.stderr.trim() || remove.stdout.trim()}`,\n        'worktree-failed',\n      );\n    }\n  }\n\n  // Best-effort local branch cleanup; the branch may not exist locally anymore\n  // or may still be pushed remotely — neither should fail the removal.\n  await sh(sandbox, `git -C ${shellQuote(repoWorkdir)} branch -D ${shellQuote(branch)}`);\n}\n\n// ---------------------------------------------------------------------------\n// Phase 3 — `gh` CLI pull-request creation primitive\n//\n// PRs are opened from inside the sandbox with the GitHub CLI. `gh` must be\n// present in the sandbox template (preflighted only on the PR path so clone /\n// open still work when it is absent). The token is passed to `gh` via a\n// per-invocation `GH_TOKEN` env that is scoped to the single `gh` process and\n// never written to git config, a shell rc, or the VM's environment.\n// ---------------------------------------------------------------------------\n\nexport interface CreatePullRequestArgs {\n  /** Short-lived installation token, injected only into the `gh` process env. */\n  token: string;\n  /** Base branch the PR merges into. Ref-validated. */\n  base: string;\n  /** Head branch the PR is opened from. Ref-validated. */\n  head: string;\n  /** PR title. */\n  title: string;\n  /** PR body (optional). */\n  body?: string;\n}\n\nexport interface CreatePullRequestResult {\n  /** The PR URL parsed from `gh pr create` stdout. */\n  url: string;\n}\n\n/**\n * Preflight that `gh` is installed in the sandbox. Only called on the PR path so\n * a missing `gh` never blocks clone/open. Surfaces an actionable error naming\n * the sandbox template requirement.\n */\nasync function assertGhAvailable(sandbox: MaterializationSandbox): Promise<void> {\n  const version = await sh(sandbox, 'gh --version');\n  if (version.exitCode !== 0) {\n    throw new MaterializeError(\n      'The GitHub CLI (gh) is not installed in the sandbox. The sandbox template must include gh to open pull requests.',\n      'gh-missing',\n    );\n  }\n}\n\n/** Match the first GitHub PR URL in `gh pr create` output. */\nfunction parsePullRequestUrl(stdout: string): string | undefined {\n  const match = stdout.match(/https:\\/\\/github\\.com\\/[^\\s]+\\/pull\\/\\d+/);\n  return match?.[0];\n}\n\n/**\n * Open a pull request from inside the sandbox via `gh pr create`. The token is\n * passed only through a per-invocation `GH_TOKEN` env scoped to the single `gh`\n * process (never persisted), all arguments are shell-quoted, and the resulting\n * PR URL is parsed from stdout.\n *\n * @param sandbox live sandbox containing the checkout\n * @param workdir the worktree (or repo) path the PR head branch is checked out in\n */\nexport async function createPullRequest(\n  sandbox: MaterializationSandbox,\n  workdir: string,\n  { token, base, head, title, body }: CreatePullRequestArgs,\n): Promise<CreatePullRequestResult> {\n  if (!isValidGitRef(base)) {\n    throw new MaterializeError(`Refusing to open PR: invalid base branch '${base}'.`, 'pr-failed');\n  }\n  if (!isValidGitRef(head)) {\n    throw new MaterializeError(`Refusing to open PR: invalid head branch '${head}'.`, 'pr-failed');\n  }\n\n  await assertGhAvailable(sandbox);\n\n  // GH_TOKEN is prefixed inline so it is exported only to the single `gh`\n  // process and never to the wider shell session, git config, or VM env. `gh`\n  // is run from inside the checkout so it targets the correct repo/head branch.\n  const ghCommand = [\n    `GH_TOKEN=${shellQuote(token)} gh pr create`,\n    `--base ${shellQuote(base)}`,\n    `--head ${shellQuote(head)}`,\n    `--title ${shellQuote(title)}`,\n    `--body ${shellQuote(body ?? '')}`,\n  ].join(' ');\n  const script = `cd ${shellQuote(workdir)} && ${ghCommand}`;\n\n  const result = await sh(sandbox, script);\n  if (result.exitCode !== 0) {\n    const classified = classifyGitFailure(result, 'push-failed');\n    if (classified.code === 'egress-blocked') {\n      throw classified;\n    }\n    throw new MaterializeError(`gh pr create failed: ${result.stderr.trim() || result.stdout.trim()}`, 'pr-failed');\n  }\n\n  const url = parsePullRequestUrl(result.stdout);\n  if (!url) {\n    throw new MaterializeError(\n      `gh pr create succeeded but no PR URL was found in its output: ${result.stdout.trim()}`,\n      'pr-failed',\n    );\n  }\n\n  return { url };\n}\n","/**\n * Project sandbox fleet: provisioning, reattach, teardown, and budgeting.\n *\n * Server-hosted projects never run on the web host itself. Each project gets\n * its own isolated sandbox (a `WorkspaceSandbox`, e.g. a Railway VM) `clone()`d\n * from the machine the factory was configured with. This module owns everything\n * about that fleet — which provider is active, where checkouts live inside a\n * sandbox, the idle window, the per-replica budget, and the\n * provision/reattach/teardown lifecycle — but knows nothing about what runs\n * inside a sandbox (git materialization lives with its feature, e.g. the\n * GitHub integration's `sandbox.ts`).\n *\n * The fleet is constructed once at boot with the machine config (or none, when\n * sandboxes are disabled) and handed to consumers — no global registry.\n * Persistence of the provider's reattach id is delegated to the caller via\n * {@link SandboxBindingStore}, so the fleet stays storage-agnostic. Tests can\n * swap the low-level construction via {@link SandboxFleet.setFactory}.\n */\n\nimport path from 'node:path';\n\nimport type { WorkspaceSandbox } from '@mastra/core/workspace';\n\n/** Minimal command result shape sandbox consumers depend on. */\nexport interface SandboxCommandResult {\n  exitCode: number;\n  stdout: string;\n  stderr: string;\n}\n\n/**\n * Minimal live-sandbox surface fleet consumers need: an id, a way to start it,\n * a way to learn the provider's reattach id, and command execution.\n */\nexport interface MaterializationSandbox {\n  readonly id: string;\n  start(): Promise<void>;\n  getInfo(): Promise<{ metadata?: Record<string, unknown> }>;\n  executeCommand(\n    command: string,\n    args?: string[],\n    options?: { timeout?: number; env?: Record<string, string | undefined> },\n  ): Promise<SandboxCommandResult>;\n  /** Update an environment variable for future commands in this sandbox. */\n  setEnvironmentVariable?(name: string, value: string): void;\n  /** Tear down the underlying VM. Optional: providers without it are no-ops. */\n  stop?(): Promise<void>;\n}\n\n/** Options for building (or reattaching) one sandbox. */\nexport interface SandboxCreateOptions {\n  /** Reattach to this existing provider VM instead of provisioning a new one. */\n  providerSandboxId?: string;\n  /** Environment variables baked into the sandbox. */\n  env?: Record<string, string>;\n  /** Provider working directory for this sandbox. */\n  workingDirectory?: string;\n  /** Idle teardown window (minutes). The provider stops the VM after this idle period. */\n  idleTimeoutMinutes?: number;\n  /** Provider checkpoint used to seed and preserve this sandbox's filesystem. */\n  checkpointName?: string;\n}\n\n/**\n * A coarse-grained step of the sandbox-preparation flow, reported as it happens\n * so the UI can show the user what the server is doing instead of a static\n * \"Preparing…\" toast. `phase` is a stable machine token; `message` is\n * user-facing copy.\n */\nexport interface PrepareProgress {\n  phase: 'reattaching' | 'provisioning' | 'preparing-workspace' | 'cloning' | 'pulling' | 'finalizing' | 'done';\n  message: string;\n}\n\n/** Callback invoked with each preparation step. Best-effort; never throws. */\nexport type ProgressFn = (event: PrepareProgress) => void;\n\n/** Invoke a progress callback without letting it break the actual work. */\nexport function reportProgress(onProgress: ProgressFn | undefined, event: PrepareProgress): void {\n  if (!onProgress) return;\n  try {\n    onProgress(event);\n  } catch {\n    // Progress reporting must never break the actual work.\n  }\n}\n\n/**\n * Factory that builds a (not-yet-started) sandbox. When `providerSandboxId` is\n * provided the sandbox should reattach to that existing VM instead of\n * provisioning a new one.\n */\nexport type SandboxFactory = (opts: SandboxCreateOptions) => MaterializationSandbox;\n\n/** Raised when provisioning would exceed the per-replica sandbox budget. */\nexport class SandboxBudgetError extends Error {\n  readonly code = 'sandbox-budget-exceeded' as const;\n  constructor(readonly max: number) {\n    super(\n      `Sandbox budget exceeded: this server already has ${max} active sandbox(es), ` +\n        `the configured per-replica maximum. Close an existing repository's sandbox and try again.`,\n    );\n    this.name = 'SandboxBudgetError';\n  }\n}\n\n/** Optional knobs for provisioning/reattaching one sandbox. */\nexport interface EnsureSandboxOptions {\n  /** Provider working directory for this sandbox. */\n  workingDirectory?: string;\n}\n\n/**\n * Where a feature persists its sandbox binding. The fleet reads the stored\n * reattach id and writes updates through this seam so it stays agnostic of\n * the owning table (GitHub projects today, anything else tomorrow).\n */\nexport interface SandboxBindingStore {\n  /** Stored provider reattach id from a previous provisioning, if any. */\n  readonly sandboxId: string | null;\n  /** Provider checkpoint used to seed and preserve this sandbox's filesystem. */\n  readonly checkpointName?: string;\n  /** Persist a freshly provisioned provider id, or clear a stale one with `null`. */\n  setSandboxId(id: string | null): Promise<void>;\n  /** Clear all stored sandbox state (reattach id + materialization mark) on teardown. */\n  clear(): Promise<void>;\n}\n\n/**\n * Adapt a cloned `WorkspaceSandbox` to the minimal surface this module needs.\n * Lifecycle goes through the `_`-prefixed wrappers when present (they add\n * status tracking and concurrency safety on `MastraSandbox` subclasses),\n * falling back to the plain methods for interface-only implementations.\n */\nfunction toMaterializationSandbox(\n  sandbox: WorkspaceSandbox,\n  initialEnvironment: Record<string, string> = {},\n): MaterializationSandbox {\n  if (typeof sandbox.executeCommand !== 'function') {\n    throw new Error(\n      `Sandbox provider '${sandbox.provider}' does not implement executeCommand() — cannot materialize repos.`,\n    );\n  }\n  const lifecycle = sandbox as { _start?(): Promise<void>; _stop?(): Promise<void> };\n  const environment = { ...initialEnvironment };\n  return {\n    id: sandbox.id,\n    start: async () => {\n      await (lifecycle._start ?? sandbox.start)?.call(sandbox);\n    },\n    getInfo: async () => (await sandbox.getInfo?.()) ?? {},\n    executeCommand: (command, args, options) =>\n      sandbox.executeCommand!(command, args, {\n        ...options,\n        env: { ...environment, ...options?.env },\n      }),\n    setEnvironmentVariable: (name, value) => {\n      environment[name] = value;\n    },\n    stop: async () => {\n      await (lifecycle._stop ?? sandbox.stop)?.call(sandbox);\n    },\n  };\n}\n\n/**\n * The provider's reattach id for a started sandbox. For Railway this is the\n * underlying `railwaySandboxId` in `getInfo().metadata`. Providers without a\n * provider-native id (e.g. local) reattach by construction id, so fall back\n * to the sandbox's own logical id.\n */\nasync function readProviderSandboxId(sandbox: MaterializationSandbox): Promise<string | undefined> {\n  const info = await sandbox.getInfo();\n  const id = info.metadata?.railwaySandboxId ?? info.metadata?.sandboxId;\n  return typeof id === 'string' ? id : sandbox.id;\n}\n\n/** Keep each path piece a single safe segment (no separators or traversal). */\nfunction sanitizeSegment(segment: string): string {\n  const cleaned = segment.replace(/[^A-Za-z0-9._-]/g, '-').replace(/^\\.+/, '');\n  return cleaned || 'repo';\n}\n\n/** Resolve a workdir under `root`, refusing any path that escapes the configured root. */\nexport function resolveContainedLocalWorkdir(root: string, ...segments: string[]): string {\n  const resolvedRoot = path.resolve(root);\n  const resolved = path.resolve(resolvedRoot, ...segments);\n  if (resolved !== resolvedRoot && resolved.startsWith(`${resolvedRoot}${path.sep}`)) return resolved;\n  throw new Error(`Refusing to use local sandbox path outside configured root: ${resolved}`);\n}\n\n/**\n * Factory-resolved sandbox runtime the fleet is constructed with: the machine\n * projects clone their per-project sandboxes from, plus the knobs the factory\n * resolved around it.\n */\nexport interface SandboxFleetConfig {\n  /**\n   * Template machine (validated by the factory to implement `clone()`).\n   * Never started — acts purely as the credential/default holder that\n   * per-project sandboxes are cloned from.\n   */\n  machine: WorkspaceSandbox;\n  /** In-sandbox base directory repos check out under (no trailing slash). */\n  workdirBase: string;\n  /** Per-replica cap on concurrently provisioned sandboxes. 0 = unlimited. */\n  maxSandboxes?: number;\n}\n\n/**\n * The sandbox fleet for one deployment. Constructed once at boot — with a\n * config when a sandbox machine was configured, or without one when sandboxes\n * are disabled (every provisioning entry point then throws and\n * {@link enabled} reports `false` so features stay off).\n */\nexport class SandboxFleet {\n  readonly #config: SandboxFleetConfig | undefined;\n  #factory: SandboxFactory | undefined;\n  #liveCount = 0;\n\n  constructor(config?: SandboxFleetConfig) {\n    this.#config = config;\n  }\n\n  /**\n   * True when a sandbox machine was configured. The factory validates the\n   * machine implements `clone()` at boot, so a configured fleet is usable —\n   * sandbox-backed projects stay off only when the slot was omitted.\n   */\n  get enabled(): boolean {\n    return this.#config !== undefined;\n  }\n\n  /**\n   * Name of the active sandbox provider — the configured machine's `provider`\n   * discriminator (`'railway'`, `'local'`, …), or `'none'` when the fleet was\n   * constructed without a config. Diagnostic only; feature gating goes\n   * through {@link enabled}.\n   */\n  get provider(): string {\n    return this.#config?.machine.provider ?? 'none';\n  }\n\n  /**\n   * Idle teardown window for provisioned sandboxes, in minutes; defaults to 30.\n   * Read back from the machine's own config when it exposes one\n   * (Railway's `idleTimeoutMinutes`) — the knob lives on the sandbox, the\n   * fleet only needs it to schedule GC and stamp sandbox clones. Advisory:\n   * providers without idle GC ignore it, and a re-open detects a torn-down VM\n   * and re-provisions cleanly.\n   */\n  get idleMinutes(): number {\n    const machine = this.#config?.machine as { idleTimeoutMinutes?: unknown } | undefined;\n    const minutes = machine?.idleTimeoutMinutes;\n    return typeof minutes === 'number' && Number.isFinite(minutes) && minutes > 0 ? minutes : 30;\n  }\n\n  /**\n   * Per-replica cap on concurrently *provisioned* sandboxes. 0 means unlimited.\n   * This is a lightweight per-process budget to keep a single replica from\n   * exhausting provider quota — it is not a global, cross-replica scheduler\n   * (that is a deferred follow-up).\n   */\n  get maxSandboxes(): number {\n    return this.#config?.maxSandboxes ?? 0;\n  }\n\n  /**\n   * Count of sandboxes this fleet has freshly provisioned and not yet torn\n   * down. Reattaches to existing VMs do not count (they reuse an already-billed\n   * sandbox). Used to enforce {@link maxSandboxes}.\n   */\n  get liveCount(): number {\n    return this.#liveCount;\n  }\n\n  /** For tests: reset the live-sandbox counter to a known state. */\n  __resetLiveCount(value = 0): void {\n    this.#liveCount = value;\n  }\n\n  /** Override the sandbox factory (tests). */\n  setFactory(factory: SandboxFactory): void {\n    this.#factory = factory;\n  }\n\n  /** Reset to the default machine-cloning factory. */\n  resetFactory(): void {\n    this.#factory = undefined;\n  }\n\n  /**\n   * Compute the in-sandbox working directory for a repo: a nested\n   * `<base>/<owner>/<name>` layout under the factory-resolved checkout base.\n   * Nesting keeps same-name repos apart (`acme/api` vs `other/api`) — cloud\n   * sandboxes are one-per-project so it's merely tidy there, but local\n   * checkouts share one host root where it prevents collisions. Server-side\n   * only; never derived from client input.\n   */\n  computeWorkdir(repoFullName: string): string {\n    if (!this.#config) throw new Error('No sandbox configured');\n    const [owner, name] = repoFullName.split('/', 2);\n    return `${this.#config.workdirBase}/${sanitizeSegment(owner || 'unknown')}/${sanitizeSegment(name || 'repo')}`;\n  }\n\n  /**\n   * Compute the host working directory for a local GitHub session checkout.\n   * This is server-derived only: repo pieces are sanitized and the trusted\n   * session id is kept as a single path segment under the configured local root.\n   */\n  computeLocalSessionWorkdir(repoFullName: string, sessionId: string): string {\n    if (!this.#config) throw new Error('No sandbox configured');\n    if (this.#config.machine.provider !== 'local') {\n      throw new Error('Local session workdirs require the local sandbox provider');\n    }\n\n    const localRoot = (this.#config.machine as { workingDirectory?: unknown }).workingDirectory;\n    if (typeof localRoot !== 'string' || localRoot.length === 0) {\n      throw new Error('Local sandbox working directory is not configured');\n    }\n\n    const [owner, name] = repoFullName.split('/', 2);\n    return resolveContainedLocalWorkdir(\n      localRoot,\n      'github-sessions',\n      sanitizeSegment(owner || 'unknown'),\n      sanitizeSegment(name || 'repo'),\n      sanitizeSegment(sessionId),\n    );\n  }\n\n  /**\n   * Build a (not-yet-started) sandbox: the test-provided factory when set,\n   * otherwise a per-project clone of the configured machine. The stored id is\n   * passed both as the logical `id` (providers that reattach by construction\n   * id, e.g. local) and as the provider-native `sandboxId` hint (Railway) so\n   * reattach works across the provider matrix.\n   */\n  #build(opts: SandboxCreateOptions): MaterializationSandbox {\n    if (this.#factory) return this.#factory(opts);\n    if (!this.#config) throw new Error('No sandbox configured');\n    const clone = this.#config.machine.clone!({\n      ...(opts.providerSandboxId ? { id: opts.providerSandboxId, sandboxId: opts.providerSandboxId } : {}),\n      ...(opts.env ? { env: opts.env } : {}),\n      ...(opts.workingDirectory ? { workingDirectory: opts.workingDirectory } : {}),\n      ...(opts.idleTimeoutMinutes !== undefined ? { idleTimeoutMinutes: opts.idleTimeoutMinutes } : {}),\n      ...(opts.checkpointName ? { checkpointName: opts.checkpointName } : {}),\n    });\n    return toMaterializationSandbox(clone, opts.env);\n  }\n\n  /**\n   * Provision a new sandbox (persisting its provider id on first open) or\n   * reattach to the stored one. Returns a started, live sandbox.\n   */\n  async ensureSandbox(store: SandboxBindingStore, onProgress?: ProgressFn): Promise<MaterializationSandbox>;\n  async ensureSandbox(\n    store: SandboxBindingStore,\n    env?: Record<string, string>,\n    onProgress?: ProgressFn,\n    options?: EnsureSandboxOptions,\n  ): Promise<MaterializationSandbox>;\n  async ensureSandbox(\n    store: SandboxBindingStore,\n    envOrProgress?: Record<string, string> | ProgressFn,\n    progressOrOptions?: ProgressFn | EnsureSandboxOptions,\n    maybeOptions: EnsureSandboxOptions = {},\n  ): Promise<MaterializationSandbox> {\n    const env = typeof envOrProgress === 'function' ? undefined : envOrProgress;\n    const onProgress =\n      typeof envOrProgress === 'function' ? envOrProgress : (progressOrOptions as ProgressFn | undefined);\n    const options =\n      typeof envOrProgress === 'function'\n        ? ((progressOrOptions as EnsureSandboxOptions | undefined) ?? {})\n        : maybeOptions;\n    const idleTimeoutMinutes = this.idleMinutes;\n    const checkpointName = store.checkpointName;\n\n    // Reattach path: if we have a stored sandbox id, try to reattach. The VM may\n    // have been torn down by the provider's idle GC (or otherwise died), in which\n    // case `start()` fails. Recover by clearing the stale id and provisioning a\n    // fresh sandbox so the next open succeeds instead of being permanently wedged.\n    if (store.sandboxId) {\n      reportProgress(onProgress, { phase: 'reattaching', message: 'Reconnecting to your sandbox…' });\n      const reattached = this.#build({\n        providerSandboxId: store.sandboxId,\n        idleTimeoutMinutes,\n        ...(checkpointName ? { checkpointName } : {}),\n        ...(env ? { env } : {}),\n        ...(options.workingDirectory ? { workingDirectory: options.workingDirectory } : {}),\n      });\n      try {\n        await reattached.start();\n        return reattached;\n      } catch {\n        await store.setSandboxId(null);\n        // fall through to fresh provision below\n      }\n    }\n\n    // Fresh provision: enforce the per-replica budget before spending quota.\n    const max = this.maxSandboxes;\n    if (max > 0 && this.#liveCount >= max) {\n      throw new SandboxBudgetError(max);\n    }\n\n    reportProgress(onProgress, { phase: 'provisioning', message: 'Provisioning a new sandbox…' });\n    const sandbox = this.#build({\n      idleTimeoutMinutes,\n      ...(checkpointName ? { checkpointName } : {}),\n      ...(env ? { env } : {}),\n      ...(options.workingDirectory ? { workingDirectory: options.workingDirectory } : {}),\n    });\n    await sandbox.start();\n    this.#liveCount += 1;\n\n    const providerSandboxId = await readProviderSandboxId(sandbox);\n    if (providerSandboxId) {\n      await store.setSandboxId(providerSandboxId);\n    }\n\n    return sandbox;\n  }\n\n  /**\n   * Tear down a sandbox binding: stop the live VM (best-effort) and clear the\n   * persisted state through the binding store so the next open re-provisions\n   * cleanly. Decrements the per-replica live-sandbox counter.\n   *\n   * @param store   the binding to tear down\n   * @param sandbox an already-reattached live sandbox to stop, when available\n   */\n  async teardownSandbox(store: SandboxBindingStore, sandbox?: MaterializationSandbox): Promise<void> {\n    if (sandbox?.stop) {\n      try {\n        await sandbox.stop();\n      } catch {\n        // Best-effort: the VM may already be gone (idle GC). Still clear the binding.\n      }\n    }\n    if (store.sandboxId) {\n      if (this.#liveCount > 0) this.#liveCount -= 1;\n      await store.clear();\n    }\n  }\n\n  /**\n   * Reattach to an already-provisioned sandbox by its provider id and start it.\n   * Used by the workspace seam when opening a project that was already\n   * materialized (sandbox id + workdir carried on controller state), so no DB\n   * round-trip is needed.\n   */\n  async reattachSandbox(\n    providerSandboxId: string,\n    options: EnsureSandboxOptions = {},\n  ): Promise<MaterializationSandbox> {\n    const sandbox = this.#build({\n      providerSandboxId,\n      idleTimeoutMinutes: this.idleMinutes,\n      ...(options.workingDirectory ? { workingDirectory: options.workingDirectory } : {}),\n    });\n    await sandbox.start();\n    return sandbox;\n  }\n}\n","import type { RequestContext } from '@mastra/core/request-context';\n\nimport type { GithubPatKind } from './pat.js';\n\nconst GITHUB_TOKEN_INJECTOR_CONTEXT_KEY = 'factoryGithubTokenInjector';\nconst GITHUB_PAT_KIND_CONTEXT_KEY = 'factoryGithubPatKind';\n\ntype GithubTokenInjector = (token: string) => void;\n\nexport function registerGithubTokenInjector(requestContext: RequestContext, injector: GithubTokenInjector): void {\n  requestContext.set(GITHUB_TOKEN_INJECTOR_CONTEXT_KEY, injector);\n}\n\n/** Record which PAT kind the active sandbox was provisioned with, so token\n * refresh re-injects the same credential (review-board sandboxes keep the\n * reviewer token instead of being clobbered with the worker token). */\nexport function registerGithubPatKind(requestContext: RequestContext, kind: GithubPatKind): void {\n  requestContext.set(GITHUB_PAT_KIND_CONTEXT_KEY, kind);\n}\n\nexport function getRegisteredGithubPatKind(requestContext: RequestContext): GithubPatKind {\n  const kind = requestContext.get(GITHUB_PAT_KIND_CONTEXT_KEY);\n  return kind === 'reviewer' ? 'reviewer' : 'default';\n}\n\nexport function injectGithubToken(requestContext: RequestContext, token: string): void {\n  const injector = requestContext.get(GITHUB_TOKEN_INJECTOR_CONTEXT_KEY) as GithubTokenInjector | undefined;\n  if (!injector) {\n    throw new Error('GitHub token refresh requires an active Factory sandbox workspace.');\n  }\n  injector(token);\n}\n","import type { AgentControllerRequestContext } from '@mastra/core/agent-controller';\nimport type { RequestContext } from '@mastra/core/request-context';\n\nimport type { FactoryAuthUser } from '../auth.js';\nimport { getFactoryAuthOrgId } from '../auth.js';\nimport type { FactoryRunBindingAddress, FactoryRunBindingSessionAddress } from '../storage/domains/work-items/base.js';\n\ninterface FactorySessionState {\n  factoryProjectId?: string;\n}\n\nexport function getFactorySessionCoordinates(\n  requestContext: RequestContext | undefined,\n): FactoryRunBindingSessionAddress | null {\n  if (!requestContext || typeof requestContext.get !== 'function') return null;\n  const context = requestContext.get('controller') as AgentControllerRequestContext<FactorySessionState> | undefined;\n  const factoryProjectId = context?.getState().factoryProjectId;\n  if (!context?.threadId || !context.resourceId || !factoryProjectId) return null;\n  return {\n    factoryProjectId,\n    threadId: context.threadId,\n    resourceId: context.resourceId,\n    sessionId: context.resourceId,\n  };\n}\n\nexport function getFactorySessionAddress(requestContext: RequestContext | undefined): FactoryRunBindingAddress | null {\n  const coordinates = getFactorySessionCoordinates(requestContext);\n  if (!coordinates || !requestContext || typeof requestContext.get !== 'function') return null;\n  const user = requestContext.get('user') as FactoryAuthUser | undefined;\n  const orgId = getFactoryAuthOrgId(user);\n  if (!orgId) return null;\n  return { orgId, ...coordinates };\n}\n"],"mappings":"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","names":["path","path"]}
+{"version":3,"sources":["../src/workspace.ts","../src/auth.ts","../src/integrations/github/pat.ts","../src/integrations/github/sandbox.ts","../src/sandbox/fleet.ts","../src/integrations/github/token-refresh.ts","../src/rules/binding-context.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport path, { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { SandboxFilesystem } from '@mastra/code-sdk/agents/sandbox-filesystem';\nimport { MASTRACODE_WORKSPACE_TOOLS } from '@mastra/code-sdk/agents/tool-availability';\nimport { getDynamicWorkspace } from '@mastra/code-sdk/agents/workspace';\nimport type { WorkspaceSkillExtension } from '@mastra/code-sdk/agents/workspace';\nimport { DEFAULT_CONFIG_DIR } from '@mastra/code-sdk/constants';\nimport type { MastraCodeState } from '@mastra/code-sdk/schema';\nimport type { AgentControllerRequestContext } from '@mastra/core/agent-controller';\nimport { LocalSandbox, LocalSkillSource, Workspace } from '@mastra/core/workspace';\nimport type { SkillSource, SkillSourceEntry, SkillSourceStat } from '@mastra/core/workspace';\nimport { getFactoryAuthUserId } from './auth.js';\nimport type { FactoryAuthUser } from './auth.js';\nimport type { MastraFactorySandboxConfig } from './factory.js';\nimport type { GithubIntegration } from './integrations/github/integration.js';\nimport { getGithubPat } from './integrations/github/pat.js';\nimport type { GithubPatKind } from './integrations/github/pat.js';\nimport { checkoutSessionBranch, materializeRepo, runWorktreeSetup } from './integrations/github/sandbox.js';\nimport { registerGithubPatKind, registerGithubTokenInjector } from './integrations/github/token-refresh.js';\nimport { getFactorySessionAddress } from './rules/binding-context.js';\nimport type { SandboxBindingStore, SandboxFleet } from './sandbox/fleet.js';\nimport type { WorkItemsStorage } from './storage/domains/work-items/base.js';\n\nconst WORKSPACE_ID_PREFIX = 'mfw';\nconst SESSION_CHECKPOINT_PREFIX = 'mastracode-session';\n\nexport function checkpointNameForSession(sessionId: string): string {\n  return `${SESSION_CHECKPOINT_PREFIX}-${sessionId}`;\n}\n\nconst bundleDirectory = dirname(fileURLToPath(import.meta.url));\nconst bundledFactorySkillsPath = join(bundleDirectory, 'factory-skills');\nconst FACTORY_SKILLS_SOURCE_PATH =\n  [\n    // Deploy bundle: the consumer copies `factory-skills/` next to the built\n    // server module (e.g. via its public/ dir).\n    bundledFactorySkillsPath,\n    // Package layout: `dist/../factory-skills` (also `src/../factory-skills`\n    // when running tests against sources).\n    join(bundleDirectory, '..', 'factory-skills'),\n    // Consumer repo running from its package root before a build.\n    join(process.cwd(), 'src', 'mastra', 'public', 'factory-skills'),\n  ].find(existsSync) ?? bundledFactorySkillsPath;\nconst FACTORY_SKILLS_MOUNT = path.resolve(path.parse(process.cwd()).root, '__mastracode_factory_skills__');\nconst FACTORY_SKILL_NAMES = new Set(['configure-factory-rules', 'factory-plan', 'factory-review', 'factory-triage']);\n\nclass FactorySkillSource implements SkillSource {\n  readonly #factorySource = new LocalSkillSource({ basePath: FACTORY_SKILLS_SOURCE_PATH });\n  readonly #fallbackSkillRoots: Set<string>;\n\n  constructor(\n    readonly fallback: SkillSource,\n    fallbackSkillRoots: string[],\n  ) {\n    this.#fallbackSkillRoots = new Set(fallbackSkillRoots.map(skillPath => path.normalize(skillPath)));\n  }\n\n  #isFactoryPath(skillPath: string): boolean {\n    const normalized = path.normalize(skillPath);\n    return normalized === FACTORY_SKILLS_MOUNT || normalized.startsWith(`${FACTORY_SKILLS_MOUNT}${path.sep}`);\n  }\n\n  #factoryPath(skillPath: string): string {\n    return path.relative(FACTORY_SKILLS_MOUNT, path.normalize(skillPath));\n  }\n\n  exists(skillPath: string): Promise<boolean> {\n    return this.#isFactoryPath(skillPath)\n      ? this.#factorySource.exists(this.#factoryPath(skillPath))\n      : this.fallback.exists(skillPath);\n  }\n\n  stat(skillPath: string): Promise<SkillSourceStat> {\n    return this.#isFactoryPath(skillPath)\n      ? this.#factorySource.stat(this.#factoryPath(skillPath))\n      : this.fallback.stat(skillPath);\n  }\n\n  readFile(skillPath: string): Promise<string | Buffer> {\n    return this.#isFactoryPath(skillPath)\n      ? this.#factorySource.readFile(this.#factoryPath(skillPath))\n      : this.fallback.readFile(skillPath);\n  }\n\n  async readdir(skillPath: string): Promise<SkillSourceEntry[]> {\n    if (this.#isFactoryPath(skillPath)) {\n      return this.#factorySource.readdir(this.#factoryPath(skillPath));\n    }\n    const entries = await this.fallback.readdir(skillPath);\n    if (this.#fallbackSkillRoots.has(path.normalize(skillPath))) {\n      return entries.filter(entry => !FACTORY_SKILL_NAMES.has(entry.name));\n    }\n    return entries;\n  }\n\n  realpath(skillPath: string): Promise<string> {\n    if (this.#isFactoryPath(skillPath)) return Promise.resolve(path.normalize(skillPath));\n    return this.fallback.realpath ? this.fallback.realpath(skillPath) : Promise.resolve(skillPath);\n  }\n}\n\nconst factorySkillExtension: WorkspaceSkillExtension = {\n  id: 'web-factory',\n  paths: [FACTORY_SKILLS_MOUNT],\n  createSource: (fallback, fallbackSkillRoots) => new FactorySkillSource(fallback, fallbackSkillRoots),\n};\n\ntype DynamicWorkspaceContext = Parameters<typeof getDynamicWorkspace>[0];\n\nexport interface CreateWorkspaceFactoryOptions {\n  /** Factory sandbox runtime config (template machine + workdir base). */\n  sandbox?: MastraFactorySandboxConfig;\n  /** GitHub integration used to resolve Factory sessions and mint repo tokens. */\n  github?: GithubIntegration;\n  /** Fleet the per-session sandboxes are provisioned/reattached through. */\n  fleet?: SandboxFleet;\n  /** Work-items storage used to resolve the session's run-binding role, so\n   * review-board sessions get the reviewer PAT as `GH_TOKEN`. Optional —\n   * without it every session uses the default (worker) PAT. */\n  workItems?: Pick<WorkItemsStorage, 'findRunBindingBySession'>;\n}\n\nexport function createWorkspaceFactory(options: CreateWorkspaceFactoryOptions = {}) {\n  const { sandbox: sandboxConfig, github, fleet, workItems } = options;\n  const isLocalSandbox = sandboxConfig?.machine instanceof LocalSandbox;\n  const githubTokenInjectors = new Map<\n    string,\n    { inject: (token: string) => void; patKind: GithubPatKind; ghToken: string }\n  >();\n  // Concurrent requests for the same session (thread list + activity polling +\n  // chat) must not each provision a sandbox and clone the repository. The\n  // first caller materializes; followers await the same promise.\n  const inflightMaterializations = new Map<string, Promise<Workspace>>();\n\n  return async ({ requestContext, mastra, skillExtension }: DynamicWorkspaceContext) => {\n    const effectiveSkillExtension = skillExtension ?? factorySkillExtension;\n    const ctx = requestContext.get('controller') as AgentControllerRequestContext<MastraCodeState> | undefined;\n    const session =\n      ctx?.resourceId && github ? await github.sourceControlStorage.sessions.getBySessionId(ctx.resourceId) : null;\n\n    if (!session) {\n      if (sandboxConfig && !isLocalSandbox) {\n        throw new Error('A Factory session ID is required to create a remote sandbox workspace');\n      }\n      return getDynamicWorkspace({ requestContext, mastra, skillExtension: effectiveSkillExtension });\n    }\n\n    const user = requestContext.get('user') as FactoryAuthUser | undefined;\n    const userId = getFactoryAuthUserId(user);\n    if (!user?.organizationId || !userId || user.organizationId !== session.orgId || userId !== session.userId) {\n      throw new Error(`Factory session ${session.sessionId} is not available to the current user`);\n    }\n    if (!sandboxConfig || !github || !fleet) {\n      throw new Error('GitHub and sandbox providers are required to create a Factory session workspace');\n    }\n\n    const storage = github.sourceControlStorage;\n    const projectRepository = await storage.projectRepositories.get({\n      orgId: session.orgId,\n      id: session.projectRepositoryId,\n    });\n    if (!projectRepository) throw new Error(`Repository link ${session.projectRepositoryId} was not found`);\n    const connection = await storage.connections.get({ orgId: session.orgId, id: projectRepository.connectionId });\n    const repository = await storage.repositories.get({ orgId: session.orgId, id: projectRepository.repositoryId });\n    if (!connection || !repository) throw new Error(`Repository link ${session.projectRepositoryId} is incomplete`);\n    const installation = await storage.installations.get({ orgId: session.orgId, id: connection.installationId });\n    if (!installation) throw new Error(`GitHub installation ${connection.installationId} was not found`);\n    const repoFullName = repository.slug;\n\n    const workdir = isLocalSandbox\n      ? fleet.computeLocalSessionWorkdir(repoFullName, session.id)\n      : (session.sandboxWorkdir ?? projectRepository.sandboxWorkdir);\n    const binding: SandboxBindingStore = {\n      sandboxId: session.sandboxId,\n      checkpointName: checkpointNameForSession(session.id),\n      setSandboxId: async id => {\n        await storage.sessions.setSandbox({ id: session.id, sandboxId: id, sandboxWorkdir: workdir });\n        session.sandboxId = id;\n        session.sandboxWorkdir = workdir;\n      },\n      clear: async () => {\n        await storage.sessions.setSandbox({ id: session.id, sandboxId: null, sandboxWorkdir: workdir });\n        session.sandboxId = null;\n      },\n    };\n\n    const extensionId = effectiveSkillExtension ? `-${effectiveSkillExtension.id}` : '';\n    const workspaceId = `${WORKSPACE_ID_PREFIX}-${projectRepository.id}-${session.id}${extensionId}`;\n    const configDir = sandboxConfig.workdir ?? DEFAULT_CONFIG_DIR;\n    try {\n      const existing = mastra?.getWorkspaceById(workspaceId) as Workspace | undefined;\n      if (existing) {\n        existing.setToolsConfig(MASTRACODE_WORKSPACE_TOOLS);\n        const registered = githubTokenInjectors.get(workspaceId);\n        if (registered) {\n          registerGithubTokenInjector(requestContext, registered.inject);\n          registerGithubPatKind(requestContext, registered.patKind);\n          // A PAT saved in Settings after this sandbox was provisioned must\n          // reach the running sandbox without a server restart — re-read it\n          // on every reuse and push it into the live sandbox when it changed.\n          // Best-effort: a failed read or inject keeps the installed token.\n          try {\n            const pat = await getGithubPat(() => github.integrationStorage, session.orgId, registered.patKind);\n            if (pat && pat !== registered.ghToken) {\n              registered.inject(pat);\n            }\n          } catch {\n            // Keep the token already installed in the sandbox.\n          }\n        }\n        return existing;\n      }\n    } catch {\n      // Not registered yet.\n    }\n\n    const materialize = async (): Promise<Workspace> => {\n      const access = await github.versionControl.getRepositoryAccess({\n        orgId: session.orgId,\n        repositoryId: repository.id,\n      });\n      const token = access.authorization?.token;\n      if (!token) throw new Error('Repository access did not include a bearer token for the Factory session');\n\n      // The `gh` CLI needs a PAT when the org configured one (installation\n      // tokens 403 on integration-restricted endpoints); git clone/checkout\n      // below keep using the minted installation token. Review-board sessions\n      // (run-binding role `review`) authenticate `gh` as the reviewer account\n      // when a reviewer token is configured; everything else — including\n      // sessions with no resolvable run binding — uses the worker token.\n      let patKind: GithubPatKind = 'default';\n      if (workItems) {\n        try {\n          const address = getFactorySessionAddress(requestContext);\n          const runBinding = address ? await workItems.findRunBindingBySession(address) : null;\n          if (runBinding?.role === 'review' && runBinding.orgId === session.orgId) patKind = 'reviewer';\n        } catch {\n          // No resolvable binding — worker token.\n        }\n      }\n      const ghCliToken = (await getGithubPat(() => github.integrationStorage, session.orgId, patKind)) ?? token;\n\n      const sandbox = await fleet.ensureSandbox(\n        binding,\n        { GH_TOKEN: ghCliToken },\n        undefined,\n        isLocalSandbox ? { workingDirectory: workdir } : {},\n      );\n      await materializeRepo({\n        row: { id: session.id, sandboxWorkdir: workdir, materializedAt: session.materializedAt },\n        repoInfo: { repoFullName: repoFullName, defaultBranch: repository.defaultBranch },\n        sandbox,\n        token,\n        storage: storage.sessions,\n      });\n      await checkoutSessionBranch(sandbox, workdir, {\n        branch: session.branch,\n        baseBranch: session.baseBranch || projectRepository.branch || repository.defaultBranch,\n        token,\n        repoFullName: repoFullName,\n      });\n      if (projectRepository.setupCommand) await runWorktreeSetup(sandbox, workdir, projectRepository.setupCommand);\n\n      const injectGithubToken = (freshToken: string) => {\n        if (!sandbox.setEnvironmentVariable) {\n          throw new Error('The active sandbox provider does not support runtime GitHub token refresh.');\n        }\n        sandbox.setEnvironmentVariable('GH_TOKEN', freshToken);\n        const registered = githubTokenInjectors.get(workspaceId);\n        if (registered) registered.ghToken = freshToken;\n      };\n      githubTokenInjectors.set(workspaceId, { inject: injectGithubToken, patKind, ghToken: ghCliToken });\n      registerGithubTokenInjector(requestContext, injectGithubToken);\n      registerGithubPatKind(requestContext, patKind);\n\n      const filesystem = new SandboxFilesystem({ sandbox, workdir });\n      const projectSkillPaths = [path.join(configDir, 'skills'), '.claude/skills', '.agents/skills'];\n      const skillPaths = [...(effectiveSkillExtension?.paths ?? []), ...projectSkillPaths];\n      return new Workspace({\n        id: workspaceId,\n        name: 'Mastra Code Factory Session Workspace',\n        filesystem,\n        sandbox: sandbox as unknown as ConstructorParameters<typeof Workspace>[0]['sandbox'],\n        tools: MASTRACODE_WORKSPACE_TOOLS,\n        skills: skillPaths,\n        skillSource: effectiveSkillExtension?.createSource(filesystem, projectSkillPaths) ?? filesystem,\n      });\n    };\n\n    // Dedupe concurrent materializations of the same workspace: followers\n    // await the leader's promise instead of provisioning a second sandbox,\n    // then bind the shared token injector into their own request context.\n    const inflight = inflightMaterializations.get(workspaceId);\n    if (inflight) {\n      const workspace = await inflight;\n      const registered = githubTokenInjectors.get(workspaceId);\n      if (registered) {\n        registerGithubTokenInjector(requestContext, registered.inject);\n        registerGithubPatKind(requestContext, registered.patKind);\n      }\n      return workspace;\n    }\n    const materialization = materialize();\n    inflightMaterializations.set(workspaceId, materialization);\n    try {\n      return await materialization;\n    } finally {\n      inflightMaterializations.delete(workspaceId);\n    }\n  };\n}\n\nexport const getFactoryWorkspace = createWorkspaceFactory();\n","import { MastraAuthWorkos } from '@mastra/auth-workos';\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';\n\nimport type { RouteAuth } from './routes/route.js';\nimport { timedAboveThreshold } from './timing.js';\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  /**\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}\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/** 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 * 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\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 }.\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 };\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      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    organizationId?: 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  return {\n    id,\n    workosId,\n    email: typeof flat.email === 'string' ? flat.email : undefined,\n    name: typeof flat.name === 'string' ? flat.name : undefined,\n    organizationId: typeof flat.organizationId === 'string' ? flat.organizationId : undefined,\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 * `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 */\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  if (!user) return undefined;\n\n  await ensureUserOrg(provider, user);\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\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): 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 meta = { provider: provider.name, ...(signUpDisabled ? { signUpDisabled: true } : {}) };\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    user: {\n      userId: getFactoryAuthUserId(user),\n      email: user.email,\n      name: user.name,\n      organizationId: user.organizationId,\n    },\n    ...meta,\n  });\n}\n\n/** Encode a validated returnTo path into the OAuth `state` parameter. */\nfunction encodeState(returnTo: string): string {\n  return Buffer.from(JSON.stringify({ returnTo }), 'utf8').toString('base64url');\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  try {\n    const parsed = JSON.parse(Buffer.from(state, 'base64url').toString('utf8')) as { returnTo?: string };\n    return sanitizeReturnTo(parsed.returnTo);\n  } catch {\n    return '/';\n  }\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          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          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 returnTo = decodeState(c.req.query('state'));\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));\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),\n    }),\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') {\n      return next();\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    ) {\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\n    if (user) {\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      c.set(FACTORY_AUTH_USER_KEY, user);\n      c.get('requestContext')?.set('user', 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","/**\n * Org-scoped GitHub Personal Access Token settings.\n *\n * GitHub App installation tokens are the wrong credential for the `gh` CLI —\n * they hit \"Resource not accessible by integration\" on endpoints the CLI\n * needs regardless of the minted permission set. When an org pastes a PAT in\n * Settings, the sandbox `GH_TOKEN` injection sites and the\n * `github_refresh_token` tool use it instead of a minted installation token.\n * Tokens must be classic PATs whose account has access to the linked repos.\n *\n * Two kinds:\n * - `default` — the worker token every sandbox gets.\n * - `reviewer` — optional second token for review-board sessions, so PR\n *   reviews come from a different account than the author. When it isn't\n *   configured, review sessions fall back to the worker token.\n *\n * Both live in the generic `integration_settings` collection for the\n * `github` integration under a sentinel user id (the settings are org-wide,\n * but the schema keys settings per `(org, user)`). Tokens are never returned\n * to the browser — the routes only report whether each is configured.\n */\n\nimport type { GithubSubscriptionStorage } from './subscriptions.js';\n\n/** Sentinel `user_id` for the org-wide settings row. */\nconst PAT_SETTINGS_USER_ID = '__github_org_settings__';\n\nexport type GithubPatKind = 'default' | 'reviewer';\n\ntype GithubOrgSettings = { pat?: string; reviewerPat?: string };\n\nconst FIELD_FOR_KIND: Record<GithubPatKind, keyof GithubOrgSettings> = {\n  default: 'pat',\n  reviewer: 'reviewerPat',\n};\n\nfunction asToken(value: unknown): string | null {\n  return typeof value === 'string' && value.length > 0 ? value : null;\n}\n\n/** The PAT to install for `kind`, or null. `reviewer` falls back to the\n * worker token so review sessions still authenticate when no dedicated\n * reviewer token is configured. Fail-soft: storage errors (e.g. integration\n * storage not initialized in a partial test harness) read as \"no PAT\n * configured\" so token minting still works. */\nexport async function getGithubPat(\n  getStorage: () => GithubSubscriptionStorage,\n  orgId: string,\n  kind: GithubPatKind = 'default',\n): Promise<string | null> {\n  try {\n    const settings = (await getStorage().settings.get(orgId, PAT_SETTINGS_USER_ID)) as GithubOrgSettings | null;\n    if (!settings) return null;\n    if (kind === 'reviewer') return asToken(settings.reviewerPat) ?? asToken(settings.pat);\n    return asToken(settings.pat);\n  } catch {\n    return null;\n  }\n}\n\n/** Which tokens are configured, without fallback semantics — feeds the\n * settings UI status badges. */\nexport async function getGithubPatStatus(\n  getStorage: () => GithubSubscriptionStorage,\n  orgId: string,\n): Promise<{ configured: boolean; reviewerConfigured: boolean }> {\n  try {\n    const settings = (await getStorage().settings.get(orgId, PAT_SETTINGS_USER_ID)) as GithubOrgSettings | null;\n    return {\n      configured: asToken(settings?.pat) !== null,\n      reviewerConfigured: asToken(settings?.reviewerPat) !== null,\n    };\n  } catch {\n    return { configured: false, reviewerConfigured: false };\n  }\n}\n\nexport async function setGithubPat(\n  storage: GithubSubscriptionStorage,\n  orgId: string,\n  pat: string,\n  kind: GithubPatKind = 'default',\n): Promise<void> {\n  const existing = ((await storage.settings.get(orgId, PAT_SETTINGS_USER_ID)) ?? {}) as GithubOrgSettings;\n  await storage.settings.save(orgId, PAT_SETTINGS_USER_ID, { ...existing, [FIELD_FOR_KIND[kind]]: pat });\n}\n\nexport async function clearGithubPat(\n  storage: GithubSubscriptionStorage,\n  orgId: string,\n  kind: GithubPatKind = 'default',\n): Promise<void> {\n  const existing = (await storage.settings.get(orgId, PAT_SETTINGS_USER_ID)) as GithubOrgSettings | null;\n  const field = FIELD_FOR_KIND[kind];\n  if (!existing?.[field]) return;\n  const { [field]: _removed, ...rest } = existing;\n  await storage.settings.save(orgId, PAT_SETTINGS_USER_ID, rest);\n}\n","/**\n * Repo materialization for GitHub-backed repositories.\n *\n * A GitHub repo is never cloned onto the server host. Instead each project gets\n * its own isolated sandbox (provisioned by the fleet in `../sandbox/fleet`) and\n * the repo is cloned *inside* that sandbox. The agent's file tools and command\n * tools then operate entirely against the remote checkout.\n *\n * - `ensureProjectSandbox(row)` / `teardownProjectSandbox(row)` bind the fleet's\n *   provision/reattach/teardown lifecycle to the per-(project,user) sandbox row.\n * - `materializeRepo(row, token)` runs `git clone` (first open) or `git pull`\n *   (re-open) inside the sandbox, using a short-lived installation token that is\n *   scrubbed from the git remote afterwards so it never persists in the VM.\n *\n * This module owns everything git/GitHub: clone/pull, commit/push, worktrees,\n * and `gh pr create`. Sandbox provisioning, budgets, and workdir layout live in\n * the fleet module.\n */\n\nimport { createHash } from 'node:crypto';\nimport { reportProgress } from '../../sandbox/fleet.js';\nimport type {\n  MaterializationSandbox,\n  ProgressFn,\n  SandboxBindingStore,\n  SandboxCommandResult,\n  SandboxFleet,\n} from '../../sandbox/fleet.js';\nimport type {\n  ProjectRepositorySandbox,\n  SourceControlStorageHandle,\n} from '../../storage/domains/source-control/base.js';\n\ntype SourceControlSandboxStorage = SourceControlStorageHandle['sandboxes'];\ntype MaterializationStore = Pick<SourceControlSandboxStorage, 'markMaterialized'>;\n\ninterface RepoMaterializationBinding {\n  id: string;\n  sandboxWorkdir: string;\n  materializedAt: Date | null;\n}\n\n/** Adapt a per-(project,user) sandbox binding row to the fleet's persistence seam. */\nfunction bindingStore(row: ProjectRepositorySandbox, storage: SourceControlSandboxStorage): SandboxBindingStore {\n  return {\n    sandboxId: row.sandboxId,\n    setSandboxId: id =>\n      id === null ? storage.clearBinding({ id: row.id }) : storage.setSandboxId({ id: row.id, sandboxId: id }),\n    clear: () => storage.clearBinding({ id: row.id }),\n  };\n}\n\n/**\n * Provision a new sandbox (persisting its provider id on first open) or\n * reattach to the stored one. Returns a started, live sandbox.\n */\nexport async function ensureProjectSandbox(options: {\n  fleet: SandboxFleet;\n  row: ProjectRepositorySandbox;\n  storage: SourceControlSandboxStorage;\n  token: string;\n  onProgress?: ProgressFn;\n}): Promise<MaterializationSandbox> {\n  const { fleet, row, storage, token, onProgress } = options;\n  return fleet.ensureSandbox(bindingStore(row, storage), { GH_TOKEN: token }, onProgress);\n}\n\n/**\n * Tear down a user's sandbox for a project: stop the live VM (best-effort) and\n * clear the persisted `sandboxId`/`materializedAt` on the per-(project,user)\n * binding row so the next open re-provisions cleanly.\n *\n * @param row     the per-(project,user) sandbox binding to tear down\n * @param sandbox an already-reattached live sandbox to stop, when available\n */\nexport async function teardownProjectSandbox(options: {\n  fleet: SandboxFleet;\n  row: ProjectRepositorySandbox;\n  storage: SourceControlSandboxStorage;\n  sandbox?: MaterializationSandbox;\n}): Promise<void> {\n  const { fleet, row, storage, sandbox } = options;\n  return fleet.teardownSandbox(bindingStore(row, storage), sandbox);\n}\n\n/**\n * Single-quote a string for safe POSIX shell interpolation. Wraps the value in\n * single quotes and escapes any embedded single quote using the canonical\n * close-quote / escaped-quote / reopen-quote sequence (`'\\''`). This is the\n * standard POSIX-safe construction and prevents the quoted string from being\n * terminated early.\n */\nexport function shellQuote(value: string): string {\n  // Replace each ' with the four-character sequence: ' \\ ' '\n  return `'` + value.split(`'`).join(`'\\\\''`) + `'`;\n}\n\n/**\n * Default hang guard for sandbox shell commands. Generous by design — large\n * clones and dependency installs legitimately take minutes; the guard exists\n * so a wedged sandbox surfaces a failure instead of hanging the request that\n * triggered materialization forever.\n */\nconst DEFAULT_COMMAND_TIMEOUT_MS = 15 * 60_000;\n/** Branch checkout only fetches one ref — a much tighter budget applies. */\nexport const CHECKOUT_COMMAND_TIMEOUT_MS = 5 * 60_000;\n\ninterface ShOptions {\n  /** Override the hang-guard budget for this command. */\n  timeoutMs?: number;\n  /** Human-readable phase name included in the timeout error. */\n  phase?: string;\n}\n\n/** Run a shell script in the sandbox via `sh -c`, bounded by a hang guard. */\nasync function sh(\n  sandbox: MaterializationSandbox,\n  script: string,\n  options: ShOptions = {},\n): Promise<SandboxCommandResult> {\n  const timeoutMs = options.timeoutMs ?? DEFAULT_COMMAND_TIMEOUT_MS;\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  const hangGuard = new Promise<never>((_, reject) => {\n    timer = setTimeout(() => {\n      const phase = options.phase ? ` during ${options.phase}` : '';\n      reject(new Error(`Sandbox command timed out after ${Math.round(timeoutMs / 1000)}s${phase}.`));\n    }, timeoutMs);\n    timer.unref?.();\n  });\n  try {\n    // Forward the budget to the provider too so it can terminate the wedged\n    // process; the race stays as the outer guard for providers that ignore it.\n    return await Promise.race([sandbox.executeCommand('sh', ['-c', script], { timeout: timeoutMs }), hangGuard]);\n  } finally {\n    clearTimeout(timer);\n  }\n}\n\n/** Error raised when the sandbox cannot materialize the repo (actionable). */\nexport class MaterializeError extends Error {\n  constructor(\n    message: string,\n    readonly code:\n      | 'git-missing'\n      | 'egress-blocked'\n      | 'clone-failed'\n      | 'pull-failed'\n      | 'push-failed'\n      | 'commit-failed'\n      | 'gh-missing'\n      | 'pr-failed',\n  ) {\n    super(message);\n    this.name = 'MaterializeError';\n  }\n}\n\n/**\n * Build the token-auth clone/pull URL for a repo. The token lives only inside\n * this URL and is scrubbed from the remote after the operation.\n */\nfunction tokenUrl(repoFullName: string, token: string): string {\n  return `https://x-access-token:${token}@github.com/${repoFullName}.git`;\n}\n\nfunction cleanUrl(repoFullName: string): string {\n  return `https://github.com/${repoFullName}.git`;\n}\n\n/** Repo metadata needed to materialize, read from the org-owned project row. */\nexport interface RepoMaterializeInfo {\n  repoFullName: string;\n  defaultBranch: string;\n}\n\n/**\n * Materialize the repo inside the user's sandbox. Clones on first open, pulls on\n * re-open. Always scrubs the install token from the remote afterwards and sets\n * `materialized_at` on the per-user sandbox binding row.\n *\n */\nexport async function materializeRepo(options: {\n  /** The per-(project,user) sandbox binding (provisioned via `ensureProjectSandbox`). */\n  row: RepoMaterializationBinding;\n  /** Repo metadata from the org-owned project row. */\n  repoInfo: RepoMaterializeInfo;\n  /** The live sandbox to run git inside. */\n  sandbox: MaterializationSandbox;\n  /** A freshly minted, short-lived installation access token. */\n  token: string;\n  storage: MaterializationStore;\n  onProgress?: ProgressFn;\n}): Promise<void> {\n  const { row: sandboxRow, repoInfo, sandbox, token, storage, onProgress } = options;\n  const workdir = sandboxRow.sandboxWorkdir;\n  const repo = repoInfo.repoFullName;\n\n  // 0. Defense in depth: never build a git command from values that aren't\n  // strictly shaped, even if a malformed row reached the DB. Inputs are also\n  // validated at the route boundary before storage.\n  if (!/^[\\w.-]+\\/[\\w.-]+$/.test(repo)) {\n    throw new MaterializeError(`Refusing to materialize: invalid repo full name '${repo}'.`, 'clone-failed');\n  }\n  if (!/^[A-Za-z0-9_./-]+$/.test(repoInfo.defaultBranch)) {\n    throw new MaterializeError(\n      `Refusing to materialize: invalid default branch '${repoInfo.defaultBranch}'.`,\n      'clone-failed',\n    );\n  }\n\n  // 1. Preflight: git must be installed in the sandbox template.\n  const gitVersion = await sh(sandbox, 'git --version');\n  if (gitVersion.exitCode !== 0) {\n    throw new MaterializeError(\n      'git is not installed in the sandbox. The sandbox template must include git.',\n      'git-missing',\n    );\n  }\n\n  const authUrl = tokenUrl(repo, token);\n\n  // The DB's `materializedAt` can drift from disk in both directions: a fresh\n  // binding row over an already-populated workdir (local dev DB resets,\n  // repaired rows, earlier flows) must pull instead of failing `git clone` on\n  // the non-empty directory, and a stale `materializedAt` over an empty\n  // sandbox (an expired/recreated VM whose disk was wiped) must re-clone\n  // instead of running `git -C <workdir>` against a directory that no longer\n  // exists. Disk is the source of truth: detect the checkout instead of\n  // trusting the row.\n  const alreadyMaterialized = await hasExistingCheckout(sandbox, workdir, repo);\n\n  let succeeded = false;\n  try {\n    if (!alreadyMaterialized) {\n      // 2a. First open: shallow-clone the default branch into the workdir. A\n      // shallow single-branch clone is dramatically faster for large repos; the\n      // later re-open uses `git pull --ff-only`, which works on shallow clones.\n      reportProgress(onProgress, {\n        phase: 'cloning',\n        message: `Cloning ${repo} (first open can take a minute)…`,\n      });\n      const clone = await sh(\n        sandbox,\n        `git clone --depth=1 --single-branch --branch ${shellQuote(repoInfo.defaultBranch)} ${shellQuote(authUrl)} ${shellQuote(workdir)}`,\n        { phase: 'repository clone' },\n      );\n      if (clone.exitCode !== 0) {\n        throw classifyGitFailure(clone, 'clone-failed');\n      }\n    } else {\n      // 2b. Re-open: refresh remote to the token URL and fast-forward pull.\n      reportProgress(onProgress, { phase: 'pulling', message: `Updating ${repo} to the latest changes…` });\n      const setUrl = await sh(sandbox, `git -C ${shellQuote(workdir)} remote set-url origin ${shellQuote(authUrl)}`);\n      if (setUrl.exitCode !== 0) {\n        throw new MaterializeError(`Failed to set git remote: ${setUrl.stderr}`, 'pull-failed');\n      }\n      const pull = await sh(sandbox, `git -C ${shellQuote(workdir)} pull --ff-only`, { phase: 'repository pull' });\n      if (pull.exitCode !== 0) {\n        throw classifyGitFailure(pull, 'pull-failed');\n      }\n    }\n    succeeded = true;\n  } finally {\n    // 3. Always scrub the token from the remote so it isn't left in the VM's\n    // git config, even when the clone/pull above failed partway through. This\n    // is best-effort on the failure path (the workdir may not even exist, and\n    // a scrub error must never mask the primary failure); on the success path\n    // the scrub must succeed or we surface it.\n    await scrubRemote(sandbox, workdir, repo, succeeded);\n  }\n\n  // 4. Mark materialized.\n  reportProgress(onProgress, { phase: 'finalizing', message: 'Finalizing workspace…' });\n  await storage.markMaterialized({ id: sandboxRow.id });\n}\n\n/** Check out a session's branch inside its isolated repository clone. */\nexport async function checkoutSessionBranch(\n  sandbox: MaterializationSandbox,\n  workdir: string,\n  {\n    branch,\n    baseBranch,\n    token,\n    repoFullName,\n  }: { branch: string; baseBranch: string; token: string; repoFullName: string },\n): Promise<void> {\n  if (!isValidGitRef(branch) || !isValidGitRef(baseBranch)) {\n    throw new MaterializeError('Refusing to create a session from an invalid branch name.', 'clone-failed');\n  }\n\n  const current = await sh(sandbox, `git -C ${shellQuote(workdir)} branch --show-current`);\n  if (current.exitCode === 0 && current.stdout.trim() === branch) return;\n\n  const local = await sh(\n    sandbox,\n    `git -C ${shellQuote(workdir)} show-ref --verify --quiet refs/heads/${shellQuote(branch)}`,\n  );\n  if (local.exitCode === 0) {\n    const checkout = await sh(sandbox, `git -C ${shellQuote(workdir)} checkout ${shellQuote(branch)}`);\n    if (checkout.exitCode !== 0) throw classifyGitFailure(checkout, 'clone-failed');\n    return;\n  }\n\n  const authUrl = tokenUrl(repoFullName, token);\n  try {\n    const setUrl = await sh(sandbox, `git -C ${shellQuote(workdir)} remote set-url origin ${shellQuote(authUrl)}`);\n    if (setUrl.exitCode !== 0) throw classifyGitFailure(setUrl, 'pull-failed');\n    const fetch = await sh(\n      sandbox,\n      `git -C ${shellQuote(workdir)} fetch origin ${shellQuote(baseBranch)} && git -C ${shellQuote(workdir)} checkout -b ${shellQuote(branch)} FETCH_HEAD`,\n      { timeoutMs: CHECKOUT_COMMAND_TIMEOUT_MS, phase: 'branch checkout' },\n    );\n    if (fetch.exitCode !== 0) throw classifyGitFailure(fetch, 'clone-failed');\n  } finally {\n    await sh(sandbox, `git -C ${shellQuote(workdir)} remote set-url origin ${shellQuote(cleanUrl(repoFullName))}`);\n  }\n}\n\n/**\n * True when the workdir already holds a git checkout whose `origin` points at\n * this exact repo. Matches both the clean and token-auth URL forms; any other\n * remote (or no git dir at all) falls back to the clone path.\n */\nasync function hasExistingCheckout(\n  sandbox: MaterializationSandbox,\n  workdir: string,\n  repoFullName: string,\n): Promise<boolean> {\n  const result = await sh(sandbox, `git -C ${shellQuote(workdir)} remote get-url origin`);\n  if (result.exitCode !== 0) return false;\n  const url = result.stdout.trim().toLowerCase();\n  const suffix = `github.com/${repoFullName.toLowerCase()}`;\n  return url.endsWith(`${suffix}.git`) || url.endsWith(suffix);\n}\n\n/**\n * Reset the git remote back to the tokenless URL. On a successful clone/pull the\n * workdir always has a `.git`, so a non-zero exit code here means the token may\n * still be persisted — surface it. On the failure path the workdir may not exist\n * (e.g. a failed clone), so a non-zero exit is tolerated — and never masks the\n * primary failure being thrown through the `finally`.\n */\nasync function scrubRemote(\n  sandbox: MaterializationSandbox,\n  workdir: string,\n  repoFullName: string,\n  expectGitDir: boolean,\n): Promise<void> {\n  const result = await sh(\n    sandbox,\n    `git -C ${shellQuote(workdir)} remote set-url origin ${shellQuote(cleanUrl(repoFullName))}`,\n  );\n  if (result.exitCode !== 0 && expectGitDir) {\n    throw new MaterializeError(\n      `Failed to scrub installation token from git remote: ${result.stderr.trim() || result.stdout.trim()}`,\n      'pull-failed',\n    );\n  }\n}\n\n/**\n * Turn a failed git command into an actionable error, detecting the common\n * \"cannot reach github.com\" egress failure.\n */\nfunction classifyGitFailure(\n  result: SandboxCommandResult,\n  fallback: 'clone-failed' | 'pull-failed' | 'push-failed',\n): MaterializeError {\n  const stderr = result.stderr || '';\n  if (/could not resolve host|failed to connect|network is unreachable|Connection timed out/i.test(stderr)) {\n    return new MaterializeError(\n      'The sandbox could not reach github.com. The sandbox network must allow outbound egress to github.com.',\n      'egress-blocked',\n    );\n  }\n  const verb = fallback === 'clone-failed' ? 'clone' : fallback === 'pull-failed' ? 'pull' : 'push';\n  return new MaterializeError(`git ${verb} failed: ${stderr}`, fallback);\n}\n\n// ---------------------------------------------------------------------------\n// Phase 1 — git identity + token-scoped push primitive\n//\n// These helpers let the sandbox author and push commits safely. The install\n// token is short-lived, minted per-operation server-side, injected only into\n// the temporary remote URL inside the sandbox, and always scrubbed in a\n// `finally` so it never persists in `.git/config`.\n// ---------------------------------------------------------------------------\n\n/**\n * Validate a git ref (branch) name. Server-side defense-in-depth: only allow a\n * conservative character set so a branch can never be built into a shell\n * command in a way that escapes quoting. Mirrors the route-layer check.\n */\nexport function isValidGitRef(value: unknown): value is string {\n  return (\n    typeof value === 'string' &&\n    value.length > 0 &&\n    value.length <= 255 &&\n    // Reject leading-dash refs (e.g. `--mirror`) so the value can never be\n    // parsed as a git option when interpolated into a command.\n    !value.startsWith('-') &&\n    /^[A-Za-z0-9_./-]+$/.test(value)\n  );\n}\n\n/** Identity used to author commits inside the sandbox. */\nexport interface GitIdentity {\n  name?: string | null;\n  email?: string | null;\n  /** GitHub login, used to derive a stable noreply identity when name/email are absent. */\n  login?: string | null;\n}\n\n/**\n * Resolve a concrete `{ name, email }` for git authorship from a possibly-sparse\n * identity. Falls back to a GitHub-style noreply identity so commits are never\n * authored with an empty or host-derived identity.\n */\nexport function resolveGitIdentity(identity: GitIdentity): { name: string; email: string } {\n  const login = (identity.login || '').trim();\n  const name = (identity.name || '').trim() || login || 'Mastra Code';\n  const email =\n    (identity.email || '').trim() ||\n    (login ? `${login}@users.noreply.github.com` : 'mastra-code@users.noreply.github.com');\n  return { name, email };\n}\n\n/**\n * Configure `user.name` / `user.email` for the given repo working tree inside\n * the sandbox so commits are authored correctly. Values are shell-quoted.\n */\nexport async function configureGitIdentity(\n  sandbox: MaterializationSandbox,\n  workdir: string,\n  identity: GitIdentity,\n): Promise<void> {\n  const { name, email } = resolveGitIdentity(identity);\n  const setName = await sh(sandbox, `git -C ${shellQuote(workdir)} config user.name ${shellQuote(name)}`);\n  if (setName.exitCode !== 0) {\n    throw new MaterializeError(`Failed to set git user.name: ${setName.stderr.trim()}`, 'commit-failed');\n  }\n  const setEmail = await sh(sandbox, `git -C ${shellQuote(workdir)} config user.email ${shellQuote(email)}`);\n  if (setEmail.exitCode !== 0) {\n    throw new MaterializeError(`Failed to set git user.email: ${setEmail.stderr.trim()}`, 'commit-failed');\n  }\n}\n\n/**\n * Temporarily rewrite `origin` to a tokenized URL, run `fn` (e.g. a push), and\n * **always** scrub the remote back to the tokenless URL in a `finally`. The\n * token therefore only ever lives in the remote URL for the duration of the\n * operation and is never left in the VM's git config.\n *\n * On the success path the scrub must succeed (a leaked token is a hard error);\n * if it fails we surface it. On the failure path the scrub is best-effort but\n * still attempted, and the original operation error is rethrown.\n */\nexport async function withInstallToken<T>(\n  sandbox: MaterializationSandbox,\n  workdir: string,\n  repoFullName: string,\n  token: string,\n  fn: () => Promise<T>,\n): Promise<T> {\n  if (!/^[\\w.-]+\\/[\\w.-]+$/.test(repoFullName)) {\n    throw new MaterializeError(`Refusing to push: invalid repo full name '${repoFullName}'.`, 'push-failed');\n  }\n\n  const setUrl = await sh(\n    sandbox,\n    `git -C ${shellQuote(workdir)} remote set-url origin ${shellQuote(tokenUrl(repoFullName, token))}`,\n  );\n  if (setUrl.exitCode !== 0) {\n    // Best-effort scrub even though set-url failed, then surface the failure.\n    await scrubRemote(sandbox, workdir, repoFullName, false);\n    throw new MaterializeError(`Failed to set git remote: ${setUrl.stderr.trim()}`, 'push-failed');\n  }\n\n  try {\n    return await fn();\n  } finally {\n    // Always restore the tokenless remote. The workdir has a `.git` (we just\n    // rewrote its remote) so a scrub failure means the token may still persist\n    // — surface it.\n    await scrubRemote(sandbox, workdir, repoFullName, true);\n  }\n}\n\n/**\n * Push a branch back to GitHub from inside the sandbox using a short-lived\n * installation token. The branch is ref-validated, the token is injected only\n * into the remote URL via `withInstallToken`, and egress failures are\n * classified into actionable errors.\n */\nexport async function pushBranch(\n  sandbox: MaterializationSandbox,\n  workdir: string,\n  branch: string,\n  token: string,\n  repoFullName: string,\n): Promise<void> {\n  if (!isValidGitRef(branch)) {\n    throw new MaterializeError(`Refusing to push: invalid branch name '${branch}'.`, 'push-failed');\n  }\n\n  await withInstallToken(sandbox, workdir, repoFullName, token, async () => {\n    const push = await sh(sandbox, `git -C ${shellQuote(workdir)} push -u origin ${shellQuote(branch)}`);\n    if (push.exitCode !== 0) {\n      throw classifyGitFailure(push, 'push-failed');\n    }\n  });\n}\n\nexport interface CommitResult {\n  /** True when a commit was created; false when there was nothing to commit. */\n  committed: boolean;\n}\n\n/**\n * Stage every change in the working tree and create a commit inside the\n * sandbox. The git identity is configured first so authorship is correct. When\n * there is nothing to commit this is a no-op (`committed: false`) rather than an\n * error, so callers can safely commit-then-push without first diffing.\n *\n * @param sandbox  the live sandbox containing the checkout\n * @param workdir  the worktree (or repo) path to commit in\n * @param message  the commit message (quoted; arbitrary text is safe)\n * @param identity authorship identity for the commit\n */\nexport async function commitAll(\n  sandbox: MaterializationSandbox,\n  workdir: string,\n  message: string,\n  identity: GitIdentity,\n): Promise<CommitResult> {\n  await configureGitIdentity(sandbox, workdir, identity);\n\n  const add = await sh(sandbox, `git -C ${shellQuote(workdir)} add -A`);\n  if (add.exitCode !== 0) {\n    throw new MaterializeError(`git add failed: ${add.stderr.trim() || add.stdout.trim()}`, 'commit-failed');\n  }\n\n  // Nothing staged → nothing to commit. `git diff --cached --quiet` exits 1 when\n  // there are staged changes, 0 when the index is clean.\n  const staged = await sh(sandbox, `git -C ${shellQuote(workdir)} diff --cached --quiet`);\n  if (staged.exitCode === 0) {\n    return { committed: false };\n  }\n\n  const commit = await sh(sandbox, `git -C ${shellQuote(workdir)} commit -m ${shellQuote(message)}`);\n  if (commit.exitCode !== 0) {\n    throw new MaterializeError(`git commit failed: ${commit.stderr.trim() || commit.stdout.trim()}`, 'commit-failed');\n  }\n\n  return { committed: true };\n}\n\n// ---------------------------------------------------------------------------\n// Phase 2 — worktree / branch lifecycle\n//\n// Each unit of work gets its own branch + working tree inside the same sandbox\n// as the base checkout. The worktree path is always computed server-side from a\n// sanitized branch name; client input never reaches a filesystem path.\n// ---------------------------------------------------------------------------\n\n/** Error raised when a worktree cannot be created/reused inside the sandbox. */\nexport class WorktreeError extends Error {\n  constructor(\n    message: string,\n    readonly code: 'invalid-branch' | 'worktree-failed' | 'setup-failed',\n  ) {\n    super(message);\n    this.name = 'WorktreeError';\n  }\n}\n\n/**\n * Reduce a (already ref-validated) branch name to a filesystem-safe directory\n * segment for the worktree path: slashes/dots/unsafe chars collapsed to `-`.\n * This only affects the *directory name*, never the git branch itself.\n *\n * Sanitization is lossy (e.g. `feat/a` and `feat-a` both reduce to `feat-a`),\n * so an 8-char hash of the original branch is appended whenever the sanitized\n * form differs from the input. That keeps clean names (`main`) readable while\n * guaranteeing distinct branches never share a worktree directory.\n */\nexport function safeBranchDir(branch: string): string {\n  const sanitized =\n    branch\n      .replace(/[^A-Za-z0-9._-]+/g, '-')\n      .replace(/\\/+/g, '-')\n      .replace(/^[-.]+|[-.]+$/g, '')\n      .slice(0, 100) || 'work';\n  if (sanitized === branch) return sanitized;\n  const hash = createHash('sha256').update(branch).digest('hex').slice(0, 8);\n  return `${sanitized}-${hash}`;\n}\n\n/**\n * Compute the absolute worktree path for a branch, server-side only. Worktrees\n * live alongside the repo checkout under a sibling `worktrees/` directory so the\n * repo's `.git` is shared. Never derived from client-supplied paths.\n */\nexport function computeWorktreePath(repoWorkdir: string, branch: string): string {\n  const parent = repoWorkdir.replace(/\\/+$/, '').split('/').slice(0, -1).join('/') || '';\n  return `${parent}/worktrees/${safeBranchDir(branch)}`;\n}\n\nexport interface EnsureWorktreeResult {\n  worktreePath: string;\n  branch: string;\n  baseBranch: string;\n  /** True when an existing worktree was reused rather than freshly created. */\n  reused: boolean;\n}\n\n/**\n * Create (or reuse) a git worktree + branch inside the sandbox for a unit of\n * work. Idempotent: if a worktree already exists at the computed path it is\n * reused. The branch is created from the freshly fetched `origin/<baseBranch>`\n * — never the sandbox's possibly stale local ref — so new worktrees always\n * start from the latest remote state.\n *\n * @param sandbox       live sandbox containing the base checkout\n * @param repoWorkdir   the base repo checkout path inside the sandbox\n * @param branch        the feature branch (ref-validated server-side)\n * @param baseBranch    the branch to fork from (ref-validated; defaults to the repo's default branch)\n * @param token         short-lived installation token used only for the base-branch fetch\n * @param repoFullName  `owner/repo` used to build the tokenized remote URL\n */\nexport async function ensureWorktree(\n  sandbox: MaterializationSandbox,\n  repoWorkdir: string,\n  {\n    branch,\n    baseBranch,\n    token,\n    repoFullName,\n  }: { branch: string; baseBranch: string; token: string; repoFullName: string },\n): Promise<EnsureWorktreeResult> {\n  if (!isValidGitRef(branch)) {\n    throw new WorktreeError(`Invalid branch name '${branch}'.`, 'invalid-branch');\n  }\n  if (!isValidGitRef(baseBranch)) {\n    throw new WorktreeError(`Invalid base branch name '${baseBranch}'.`, 'invalid-branch');\n  }\n\n  const worktreePath = computeWorktreePath(repoWorkdir, branch);\n\n  // Idempotent reuse: a worktree already checked out at this path has a `.git`\n  // file (worktrees use a gitfile, not a directory). Reuse it as-is.\n  const exists = await sh(sandbox, `test -e ${shellQuote(`${worktreePath}/.git`)}`);\n  if (exists.exitCode === 0) {\n    return { worktreePath, branch, baseBranch, reused: true };\n  }\n\n  // Fetch the latest base ref from origin before forking. The explicit refspec\n  // updates `refs/remotes/origin/<base>` even when the checkout was created as\n  // a single-branch clone. The fetch needs the install token (the resting\n  // remote is tokenless), and a failure is a hard error — silently forking a\n  // stale local ref is worse than failing the request.\n  const baseRef = `origin/${baseBranch}`;\n  await withInstallToken(sandbox, repoWorkdir, repoFullName, token, async () => {\n    const fetch = await sh(\n      sandbox,\n      `git -C ${shellQuote(repoWorkdir)} fetch origin ${shellQuote(`+refs/heads/${baseBranch}:refs/remotes/${baseRef}`)}`,\n    );\n    if (fetch.exitCode !== 0) {\n      throw classifyGitFailure(fetch, 'pull-failed');\n    }\n  });\n\n  // Create the worktree. If the branch already exists, check it out into the\n  // worktree; otherwise create it from the fetched base. `git worktree add -B`\n  // creates-or-resets the branch to the base, which keeps this idempotent for a\n  // fresh worktree while still working when the branch already exists remotely.\n  // `--no-track` keeps the feature branch from tracking origin/<base>; pushes\n  // set their own upstream via `push -u`.\n  const add = await sh(\n    sandbox,\n    `git -C ${shellQuote(repoWorkdir)} worktree add --no-track -B ${shellQuote(branch)} ${shellQuote(worktreePath)} ${shellQuote(baseRef)}`,\n  );\n  if (add.exitCode !== 0) {\n    throw new WorktreeError(`git worktree add failed: ${add.stderr.trim() || add.stdout.trim()}`, 'worktree-failed');\n  }\n\n  return { worktreePath, branch, baseBranch, reused: false };\n}\n\n/**\n * Run the project's setup command (e.g. `pnpm i && pnpm build`) inside a\n * freshly created worktree. Called before the worktree is handed to any agent\n * run so the checkout is ready to build/test. A non-zero exit is a hard error —\n * starting agent work in a half-set-up tree is worse than failing the request.\n *\n * Security model: the command is intentionally arbitrary shell — that is the\n * feature (install deps, build, seed fixtures). It is only configurable by\n * authenticated org members (the settings route is gated by\n * `resolveOrgTenant` + org-scoped project lookup, with length and\n * control-character validation), and it executes exclusively inside the\n * project's isolated sandbox — the same environment where org members already\n * run arbitrary shell via the agent's command tool. It never runs on the web\n * server host, so it grants no privilege beyond what sandbox access already\n * provides.\n *\n * @param sandbox       live sandbox containing the worktree\n * @param worktreePath  the server-computed worktree path the command runs in\n * @param command       the org-configured setup shell command\n */\nexport async function runWorktreeSetup(\n  sandbox: MaterializationSandbox,\n  worktreePath: string,\n  command: string,\n): Promise<void> {\n  const result = await sh(sandbox, `cd ${shellQuote(worktreePath)} && { ${command}\\n}`, { phase: 'worktree setup' });\n  if (result.exitCode !== 0) {\n    const detail = (result.stderr.trim() || result.stdout.trim()).slice(-2000);\n    throw new WorktreeError(`Setup command failed (exit ${result.exitCode}): ${detail}`, 'setup-failed');\n  }\n}\n\n/**\n * Remove a worktree (and its local feature branch) from the sandbox. The\n * checkout is removed with `--force` — the caller owns confirming that any\n * uncommitted work in it can be discarded. Idempotent: a worktree whose\n * directory is already gone only has its metadata pruned.\n *\n * @param sandbox       live sandbox containing the base checkout\n * @param repoWorkdir   the base repo checkout path inside the sandbox\n * @param branch        the worktree's feature branch (ref-validated)\n * @param worktreePath  the persisted, server-computed worktree path\n */\nexport async function removeWorktree(\n  sandbox: MaterializationSandbox,\n  repoWorkdir: string,\n  { branch, worktreePath }: { branch: string; worktreePath: string },\n): Promise<void> {\n  if (!isValidGitRef(branch)) {\n    throw new WorktreeError(`Invalid branch name '${branch}'.`, 'invalid-branch');\n  }\n\n  const remove = await sh(\n    sandbox,\n    `git -C ${shellQuote(repoWorkdir)} worktree remove --force ${shellQuote(worktreePath)}`,\n  );\n  if (remove.exitCode !== 0) {\n    // Tolerate a checkout that's already gone (e.g. a fresh sandbox after\n    // re-provisioning): prune stale metadata and only fail when the directory\n    // still exists, meaning git genuinely refused to remove it.\n    await sh(sandbox, `git -C ${shellQuote(repoWorkdir)} worktree prune`);\n    const exists = await sh(sandbox, `test -e ${shellQuote(worktreePath)}`);\n    if (exists.exitCode === 0) {\n      throw new WorktreeError(\n        `git worktree remove failed: ${remove.stderr.trim() || remove.stdout.trim()}`,\n        'worktree-failed',\n      );\n    }\n  }\n\n  // Best-effort local branch cleanup; the branch may not exist locally anymore\n  // or may still be pushed remotely — neither should fail the removal.\n  await sh(sandbox, `git -C ${shellQuote(repoWorkdir)} branch -D ${shellQuote(branch)}`);\n}\n\n// ---------------------------------------------------------------------------\n// Phase 3 — `gh` CLI pull-request creation primitive\n//\n// PRs are opened from inside the sandbox with the GitHub CLI. `gh` must be\n// present in the sandbox template (preflighted only on the PR path so clone /\n// open still work when it is absent). The token is passed to `gh` via a\n// per-invocation `GH_TOKEN` env that is scoped to the single `gh` process and\n// never written to git config, a shell rc, or the VM's environment.\n// ---------------------------------------------------------------------------\n\nexport interface CreatePullRequestArgs {\n  /** Short-lived installation token, injected only into the `gh` process env. */\n  token: string;\n  /** Base branch the PR merges into. Ref-validated. */\n  base: string;\n  /** Head branch the PR is opened from. Ref-validated. */\n  head: string;\n  /** PR title. */\n  title: string;\n  /** PR body (optional). */\n  body?: string;\n}\n\nexport interface CreatePullRequestResult {\n  /** The PR URL parsed from `gh pr create` stdout. */\n  url: string;\n}\n\n/**\n * Preflight that `gh` is installed in the sandbox. Only called on the PR path so\n * a missing `gh` never blocks clone/open. Surfaces an actionable error naming\n * the sandbox template requirement.\n */\nasync function assertGhAvailable(sandbox: MaterializationSandbox): Promise<void> {\n  const version = await sh(sandbox, 'gh --version');\n  if (version.exitCode !== 0) {\n    throw new MaterializeError(\n      'The GitHub CLI (gh) is not installed in the sandbox. The sandbox template must include gh to open pull requests.',\n      'gh-missing',\n    );\n  }\n}\n\n/** Match the first GitHub PR URL in `gh pr create` output. */\nfunction parsePullRequestUrl(stdout: string): string | undefined {\n  const match = stdout.match(/https:\\/\\/github\\.com\\/[^\\s]+\\/pull\\/\\d+/);\n  return match?.[0];\n}\n\n/**\n * Open a pull request from inside the sandbox via `gh pr create`. The token is\n * passed only through a per-invocation `GH_TOKEN` env scoped to the single `gh`\n * process (never persisted), all arguments are shell-quoted, and the resulting\n * PR URL is parsed from stdout.\n *\n * @param sandbox live sandbox containing the checkout\n * @param workdir the worktree (or repo) path the PR head branch is checked out in\n */\nexport async function createPullRequest(\n  sandbox: MaterializationSandbox,\n  workdir: string,\n  { token, base, head, title, body }: CreatePullRequestArgs,\n): Promise<CreatePullRequestResult> {\n  if (!isValidGitRef(base)) {\n    throw new MaterializeError(`Refusing to open PR: invalid base branch '${base}'.`, 'pr-failed');\n  }\n  if (!isValidGitRef(head)) {\n    throw new MaterializeError(`Refusing to open PR: invalid head branch '${head}'.`, 'pr-failed');\n  }\n\n  await assertGhAvailable(sandbox);\n\n  // GH_TOKEN is prefixed inline so it is exported only to the single `gh`\n  // process and never to the wider shell session, git config, or VM env. `gh`\n  // is run from inside the checkout so it targets the correct repo/head branch.\n  const ghCommand = [\n    `GH_TOKEN=${shellQuote(token)} gh pr create`,\n    `--base ${shellQuote(base)}`,\n    `--head ${shellQuote(head)}`,\n    `--title ${shellQuote(title)}`,\n    `--body ${shellQuote(body ?? '')}`,\n  ].join(' ');\n  const script = `cd ${shellQuote(workdir)} && ${ghCommand}`;\n\n  const result = await sh(sandbox, script);\n  if (result.exitCode !== 0) {\n    const classified = classifyGitFailure(result, 'push-failed');\n    if (classified.code === 'egress-blocked') {\n      throw classified;\n    }\n    throw new MaterializeError(`gh pr create failed: ${result.stderr.trim() || result.stdout.trim()}`, 'pr-failed');\n  }\n\n  const url = parsePullRequestUrl(result.stdout);\n  if (!url) {\n    throw new MaterializeError(\n      `gh pr create succeeded but no PR URL was found in its output: ${result.stdout.trim()}`,\n      'pr-failed',\n    );\n  }\n\n  return { url };\n}\n","/**\n * Project sandbox fleet: provisioning, reattach, teardown, and budgeting.\n *\n * Server-hosted projects never run on the web host itself. Each project gets\n * its own isolated sandbox (a `WorkspaceSandbox`, e.g. a Railway VM) `clone()`d\n * from the machine the factory was configured with. This module owns everything\n * about that fleet — which provider is active, where checkouts live inside a\n * sandbox, the idle window, the per-replica budget, and the\n * provision/reattach/teardown lifecycle — but knows nothing about what runs\n * inside a sandbox (git materialization lives with its feature, e.g. the\n * GitHub integration's `sandbox.ts`).\n *\n * The fleet is constructed once at boot with the machine config (or none, when\n * sandboxes are disabled) and handed to consumers — no global registry.\n * Persistence of the provider's reattach id is delegated to the caller via\n * {@link SandboxBindingStore}, so the fleet stays storage-agnostic. Tests can\n * swap the low-level construction via {@link SandboxFleet.setFactory}.\n */\n\nimport path from 'node:path';\n\nimport type { WorkspaceSandbox } from '@mastra/core/workspace';\n\n/** Minimal command result shape sandbox consumers depend on. */\nexport interface SandboxCommandResult {\n  exitCode: number;\n  stdout: string;\n  stderr: string;\n}\n\n/**\n * Minimal live-sandbox surface fleet consumers need: an id, a way to start it,\n * a way to learn the provider's reattach id, and command execution.\n */\nexport interface MaterializationSandbox {\n  readonly id: string;\n  start(): Promise<void>;\n  getInfo(): Promise<{ metadata?: Record<string, unknown> }>;\n  executeCommand(\n    command: string,\n    args?: string[],\n    options?: { timeout?: number; env?: Record<string, string | undefined> },\n  ): Promise<SandboxCommandResult>;\n  /** Update an environment variable for future commands in this sandbox. */\n  setEnvironmentVariable?(name: string, value: string): void;\n  /** Tear down the underlying VM. Optional: providers without it are no-ops. */\n  stop?(): Promise<void>;\n}\n\n/** Options for building (or reattaching) one sandbox. */\nexport interface SandboxCreateOptions {\n  /** Reattach to this existing provider VM instead of provisioning a new one. */\n  providerSandboxId?: string;\n  /** Environment variables baked into the sandbox. */\n  env?: Record<string, string>;\n  /** Provider working directory for this sandbox. */\n  workingDirectory?: string;\n  /** Idle teardown window (minutes). The provider stops the VM after this idle period. */\n  idleTimeoutMinutes?: number;\n  /** Provider checkpoint used to seed and preserve this sandbox's filesystem. */\n  checkpointName?: string;\n}\n\n/**\n * A coarse-grained step of the sandbox-preparation flow, reported as it happens\n * so the UI can show the user what the server is doing instead of a static\n * \"Preparing…\" toast. `phase` is a stable machine token; `message` is\n * user-facing copy.\n */\nexport interface PrepareProgress {\n  phase: 'reattaching' | 'provisioning' | 'preparing-workspace' | 'cloning' | 'pulling' | 'finalizing' | 'done';\n  message: string;\n}\n\n/** Callback invoked with each preparation step. Best-effort; never throws. */\nexport type ProgressFn = (event: PrepareProgress) => void;\n\n/** Invoke a progress callback without letting it break the actual work. */\nexport function reportProgress(onProgress: ProgressFn | undefined, event: PrepareProgress): void {\n  if (!onProgress) return;\n  try {\n    onProgress(event);\n  } catch {\n    // Progress reporting must never break the actual work.\n  }\n}\n\n/**\n * Factory that builds a (not-yet-started) sandbox. When `providerSandboxId` is\n * provided the sandbox should reattach to that existing VM instead of\n * provisioning a new one.\n */\nexport type SandboxFactory = (opts: SandboxCreateOptions) => MaterializationSandbox;\n\n/** Raised when provisioning would exceed the per-replica sandbox budget. */\nexport class SandboxBudgetError extends Error {\n  readonly code = 'sandbox-budget-exceeded' as const;\n  constructor(readonly max: number) {\n    super(\n      `Sandbox budget exceeded: this server already has ${max} active sandbox(es), ` +\n        `the configured per-replica maximum. Close an existing repository's sandbox and try again.`,\n    );\n    this.name = 'SandboxBudgetError';\n  }\n}\n\n/** Optional knobs for provisioning/reattaching one sandbox. */\nexport interface EnsureSandboxOptions {\n  /** Provider working directory for this sandbox. */\n  workingDirectory?: string;\n}\n\n/**\n * Where a feature persists its sandbox binding. The fleet reads the stored\n * reattach id and writes updates through this seam so it stays agnostic of\n * the owning table (GitHub projects today, anything else tomorrow).\n */\nexport interface SandboxBindingStore {\n  /** Stored provider reattach id from a previous provisioning, if any. */\n  readonly sandboxId: string | null;\n  /** Provider checkpoint used to seed and preserve this sandbox's filesystem. */\n  readonly checkpointName?: string;\n  /** Persist a freshly provisioned provider id, or clear a stale one with `null`. */\n  setSandboxId(id: string | null): Promise<void>;\n  /** Clear all stored sandbox state (reattach id + materialization mark) on teardown. */\n  clear(): Promise<void>;\n}\n\n/**\n * Adapt a cloned `WorkspaceSandbox` to the minimal surface this module needs.\n * Lifecycle goes through the `_`-prefixed wrappers when present (they add\n * status tracking and concurrency safety on `MastraSandbox` subclasses),\n * falling back to the plain methods for interface-only implementations.\n */\nfunction toMaterializationSandbox(\n  sandbox: WorkspaceSandbox,\n  initialEnvironment: Record<string, string> = {},\n): MaterializationSandbox {\n  if (typeof sandbox.executeCommand !== 'function') {\n    throw new Error(\n      `Sandbox provider '${sandbox.provider}' does not implement executeCommand() — cannot materialize repos.`,\n    );\n  }\n  const lifecycle = sandbox as { _start?(): Promise<void>; _stop?(): Promise<void> };\n  const environment = { ...initialEnvironment };\n  return {\n    id: sandbox.id,\n    start: async () => {\n      await (lifecycle._start ?? sandbox.start)?.call(sandbox);\n    },\n    getInfo: async () => (await sandbox.getInfo?.()) ?? {},\n    executeCommand: (command, args, options) =>\n      sandbox.executeCommand!(command, args, {\n        ...options,\n        env: { ...environment, ...options?.env },\n      }),\n    setEnvironmentVariable: (name, value) => {\n      environment[name] = value;\n    },\n    stop: async () => {\n      await (lifecycle._stop ?? sandbox.stop)?.call(sandbox);\n    },\n  };\n}\n\n/**\n * The provider's reattach id for a started sandbox. For Railway this is the\n * underlying `railwaySandboxId` in `getInfo().metadata`. Providers without a\n * provider-native id (e.g. local) reattach by construction id, so fall back\n * to the sandbox's own logical id.\n */\nasync function readProviderSandboxId(sandbox: MaterializationSandbox): Promise<string | undefined> {\n  const info = await sandbox.getInfo();\n  const id = info.metadata?.railwaySandboxId ?? info.metadata?.sandboxId;\n  return typeof id === 'string' ? id : sandbox.id;\n}\n\n/** Keep each path piece a single safe segment (no separators or traversal). */\nfunction sanitizeSegment(segment: string): string {\n  const cleaned = segment.replace(/[^A-Za-z0-9._-]/g, '-').replace(/^\\.+/, '');\n  return cleaned || 'repo';\n}\n\n/** Resolve a workdir under `root`, refusing any path that escapes the configured root. */\nexport function resolveContainedLocalWorkdir(root: string, ...segments: string[]): string {\n  const resolvedRoot = path.resolve(root);\n  const resolved = path.resolve(resolvedRoot, ...segments);\n  if (resolved !== resolvedRoot && resolved.startsWith(`${resolvedRoot}${path.sep}`)) return resolved;\n  throw new Error(`Refusing to use local sandbox path outside configured root: ${resolved}`);\n}\n\n/**\n * Factory-resolved sandbox runtime the fleet is constructed with: the machine\n * projects clone their per-project sandboxes from, plus the knobs the factory\n * resolved around it.\n */\nexport interface SandboxFleetConfig {\n  /**\n   * Template machine (validated by the factory to implement `clone()`).\n   * Never started — acts purely as the credential/default holder that\n   * per-project sandboxes are cloned from.\n   */\n  machine: WorkspaceSandbox;\n  /** In-sandbox base directory repos check out under (no trailing slash). */\n  workdirBase: string;\n  /** Per-replica cap on concurrently provisioned sandboxes. 0 = unlimited. */\n  maxSandboxes?: number;\n}\n\n/**\n * The sandbox fleet for one deployment. Constructed once at boot — with a\n * config when a sandbox machine was configured, or without one when sandboxes\n * are disabled (every provisioning entry point then throws and\n * {@link enabled} reports `false` so features stay off).\n */\nexport class SandboxFleet {\n  readonly #config: SandboxFleetConfig | undefined;\n  #factory: SandboxFactory | undefined;\n  #liveCount = 0;\n\n  constructor(config?: SandboxFleetConfig) {\n    this.#config = config;\n  }\n\n  /**\n   * True when a sandbox machine was configured. The factory validates the\n   * machine implements `clone()` at boot, so a configured fleet is usable —\n   * sandbox-backed projects stay off only when the slot was omitted.\n   */\n  get enabled(): boolean {\n    return this.#config !== undefined;\n  }\n\n  /**\n   * Name of the active sandbox provider — the configured machine's `provider`\n   * discriminator (`'railway'`, `'local'`, …), or `'none'` when the fleet was\n   * constructed without a config. Diagnostic only; feature gating goes\n   * through {@link enabled}.\n   */\n  get provider(): string {\n    return this.#config?.machine.provider ?? 'none';\n  }\n\n  /**\n   * Idle teardown window for provisioned sandboxes, in minutes; defaults to 30.\n   * Read back from the machine's own config when it exposes one\n   * (Railway's `idleTimeoutMinutes`) — the knob lives on the sandbox, the\n   * fleet only needs it to schedule GC and stamp sandbox clones. Advisory:\n   * providers without idle GC ignore it, and a re-open detects a torn-down VM\n   * and re-provisions cleanly.\n   */\n  get idleMinutes(): number {\n    const machine = this.#config?.machine as { idleTimeoutMinutes?: unknown } | undefined;\n    const minutes = machine?.idleTimeoutMinutes;\n    return typeof minutes === 'number' && Number.isFinite(minutes) && minutes > 0 ? minutes : 30;\n  }\n\n  /**\n   * Per-replica cap on concurrently *provisioned* sandboxes. 0 means unlimited.\n   * This is a lightweight per-process budget to keep a single replica from\n   * exhausting provider quota — it is not a global, cross-replica scheduler\n   * (that is a deferred follow-up).\n   */\n  get maxSandboxes(): number {\n    return this.#config?.maxSandboxes ?? 0;\n  }\n\n  /**\n   * Count of sandboxes this fleet has freshly provisioned and not yet torn\n   * down. Reattaches to existing VMs do not count (they reuse an already-billed\n   * sandbox). Used to enforce {@link maxSandboxes}.\n   */\n  get liveCount(): number {\n    return this.#liveCount;\n  }\n\n  /** For tests: reset the live-sandbox counter to a known state. */\n  __resetLiveCount(value = 0): void {\n    this.#liveCount = value;\n  }\n\n  /** Override the sandbox factory (tests). */\n  setFactory(factory: SandboxFactory): void {\n    this.#factory = factory;\n  }\n\n  /** Reset to the default machine-cloning factory. */\n  resetFactory(): void {\n    this.#factory = undefined;\n  }\n\n  /**\n   * Compute the in-sandbox working directory for a repo: a nested\n   * `<base>/<owner>/<name>` layout under the factory-resolved checkout base.\n   * Nesting keeps same-name repos apart (`acme/api` vs `other/api`) — cloud\n   * sandboxes are one-per-project so it's merely tidy there, but local\n   * checkouts share one host root where it prevents collisions. Server-side\n   * only; never derived from client input.\n   */\n  computeWorkdir(repoFullName: string): string {\n    if (!this.#config) throw new Error('No sandbox configured');\n    const [owner, name] = repoFullName.split('/', 2);\n    return `${this.#config.workdirBase}/${sanitizeSegment(owner || 'unknown')}/${sanitizeSegment(name || 'repo')}`;\n  }\n\n  /**\n   * Compute the host working directory for a local GitHub session checkout.\n   * This is server-derived only: repo pieces are sanitized and the trusted\n   * session id is kept as a single path segment under the configured local root.\n   */\n  computeLocalSessionWorkdir(repoFullName: string, sessionId: string): string {\n    if (!this.#config) throw new Error('No sandbox configured');\n    if (this.#config.machine.provider !== 'local') {\n      throw new Error('Local session workdirs require the local sandbox provider');\n    }\n\n    const localRoot = (this.#config.machine as { workingDirectory?: unknown }).workingDirectory;\n    if (typeof localRoot !== 'string' || localRoot.length === 0) {\n      throw new Error('Local sandbox working directory is not configured');\n    }\n\n    const [owner, name] = repoFullName.split('/', 2);\n    return resolveContainedLocalWorkdir(\n      localRoot,\n      'github-sessions',\n      sanitizeSegment(owner || 'unknown'),\n      sanitizeSegment(name || 'repo'),\n      sanitizeSegment(sessionId),\n    );\n  }\n\n  /**\n   * Build a (not-yet-started) sandbox: the test-provided factory when set,\n   * otherwise a per-project clone of the configured machine. The stored id is\n   * passed both as the logical `id` (providers that reattach by construction\n   * id, e.g. local) and as the provider-native `sandboxId` hint (Railway) so\n   * reattach works across the provider matrix.\n   */\n  #build(opts: SandboxCreateOptions): MaterializationSandbox {\n    if (this.#factory) return this.#factory(opts);\n    if (!this.#config) throw new Error('No sandbox configured');\n    const clone = this.#config.machine.clone!({\n      ...(opts.providerSandboxId ? { id: opts.providerSandboxId, sandboxId: opts.providerSandboxId } : {}),\n      ...(opts.env ? { env: opts.env } : {}),\n      ...(opts.workingDirectory ? { workingDirectory: opts.workingDirectory } : {}),\n      ...(opts.idleTimeoutMinutes !== undefined ? { idleTimeoutMinutes: opts.idleTimeoutMinutes } : {}),\n      ...(opts.checkpointName ? { checkpointName: opts.checkpointName } : {}),\n    });\n    return toMaterializationSandbox(clone, opts.env);\n  }\n\n  /**\n   * Provision a new sandbox (persisting its provider id on first open) or\n   * reattach to the stored one. Returns a started, live sandbox.\n   */\n  async ensureSandbox(store: SandboxBindingStore, onProgress?: ProgressFn): Promise<MaterializationSandbox>;\n  async ensureSandbox(\n    store: SandboxBindingStore,\n    env?: Record<string, string>,\n    onProgress?: ProgressFn,\n    options?: EnsureSandboxOptions,\n  ): Promise<MaterializationSandbox>;\n  async ensureSandbox(\n    store: SandboxBindingStore,\n    envOrProgress?: Record<string, string> | ProgressFn,\n    progressOrOptions?: ProgressFn | EnsureSandboxOptions,\n    maybeOptions: EnsureSandboxOptions = {},\n  ): Promise<MaterializationSandbox> {\n    const env = typeof envOrProgress === 'function' ? undefined : envOrProgress;\n    const onProgress =\n      typeof envOrProgress === 'function' ? envOrProgress : (progressOrOptions as ProgressFn | undefined);\n    const options =\n      typeof envOrProgress === 'function'\n        ? ((progressOrOptions as EnsureSandboxOptions | undefined) ?? {})\n        : maybeOptions;\n    const idleTimeoutMinutes = this.idleMinutes;\n    const checkpointName = store.checkpointName;\n\n    // Reattach path: if we have a stored sandbox id, try to reattach. The VM may\n    // have been torn down by the provider's idle GC (or otherwise died), in which\n    // case `start()` fails. Recover by clearing the stale id and provisioning a\n    // fresh sandbox so the next open succeeds instead of being permanently wedged.\n    if (store.sandboxId) {\n      reportProgress(onProgress, { phase: 'reattaching', message: 'Reconnecting to your sandbox…' });\n      const reattached = this.#build({\n        providerSandboxId: store.sandboxId,\n        idleTimeoutMinutes,\n        ...(checkpointName ? { checkpointName } : {}),\n        ...(env ? { env } : {}),\n        ...(options.workingDirectory ? { workingDirectory: options.workingDirectory } : {}),\n      });\n      try {\n        await reattached.start();\n        return reattached;\n      } catch {\n        await store.setSandboxId(null);\n        // fall through to fresh provision below\n      }\n    }\n\n    // Fresh provision: enforce the per-replica budget before spending quota.\n    const max = this.maxSandboxes;\n    if (max > 0 && this.#liveCount >= max) {\n      throw new SandboxBudgetError(max);\n    }\n\n    reportProgress(onProgress, { phase: 'provisioning', message: 'Provisioning a new sandbox…' });\n    const sandbox = this.#build({\n      idleTimeoutMinutes,\n      ...(checkpointName ? { checkpointName } : {}),\n      ...(env ? { env } : {}),\n      ...(options.workingDirectory ? { workingDirectory: options.workingDirectory } : {}),\n    });\n    await sandbox.start();\n    this.#liveCount += 1;\n\n    const providerSandboxId = await readProviderSandboxId(sandbox);\n    if (providerSandboxId) {\n      await store.setSandboxId(providerSandboxId);\n    }\n\n    return sandbox;\n  }\n\n  /**\n   * Tear down a sandbox binding: stop the live VM (best-effort) and clear the\n   * persisted state through the binding store so the next open re-provisions\n   * cleanly. Decrements the per-replica live-sandbox counter.\n   *\n   * @param store   the binding to tear down\n   * @param sandbox an already-reattached live sandbox to stop, when available\n   */\n  async teardownSandbox(store: SandboxBindingStore, sandbox?: MaterializationSandbox): Promise<void> {\n    if (sandbox?.stop) {\n      try {\n        await sandbox.stop();\n      } catch {\n        // Best-effort: the VM may already be gone (idle GC). Still clear the binding.\n      }\n    }\n    if (store.sandboxId) {\n      if (this.#liveCount > 0) this.#liveCount -= 1;\n      await store.clear();\n    }\n  }\n\n  /**\n   * Reattach to an already-provisioned sandbox by its provider id and start it.\n   * Used by the workspace seam when opening a project that was already\n   * materialized (sandbox id + workdir carried on controller state), so no DB\n   * round-trip is needed.\n   */\n  async reattachSandbox(\n    providerSandboxId: string,\n    options: EnsureSandboxOptions = {},\n  ): Promise<MaterializationSandbox> {\n    const sandbox = this.#build({\n      providerSandboxId,\n      idleTimeoutMinutes: this.idleMinutes,\n      ...(options.workingDirectory ? { workingDirectory: options.workingDirectory } : {}),\n    });\n    await sandbox.start();\n    return sandbox;\n  }\n}\n","import type { RequestContext } from '@mastra/core/request-context';\n\nimport type { GithubPatKind } from './pat.js';\n\nconst GITHUB_TOKEN_INJECTOR_CONTEXT_KEY = 'factoryGithubTokenInjector';\nconst GITHUB_PAT_KIND_CONTEXT_KEY = 'factoryGithubPatKind';\n\ntype GithubTokenInjector = (token: string) => void;\n\nexport function registerGithubTokenInjector(requestContext: RequestContext, injector: GithubTokenInjector): void {\n  requestContext.set(GITHUB_TOKEN_INJECTOR_CONTEXT_KEY, injector);\n}\n\n/** Record which PAT kind the active sandbox was provisioned with, so token\n * refresh re-injects the same credential (review-board sandboxes keep the\n * reviewer token instead of being clobbered with the worker token). */\nexport function registerGithubPatKind(requestContext: RequestContext, kind: GithubPatKind): void {\n  requestContext.set(GITHUB_PAT_KIND_CONTEXT_KEY, kind);\n}\n\nexport function getRegisteredGithubPatKind(requestContext: RequestContext): GithubPatKind {\n  const kind = requestContext.get(GITHUB_PAT_KIND_CONTEXT_KEY);\n  return kind === 'reviewer' ? 'reviewer' : 'default';\n}\n\nexport function injectGithubToken(requestContext: RequestContext, token: string): void {\n  const injector = requestContext.get(GITHUB_TOKEN_INJECTOR_CONTEXT_KEY) as GithubTokenInjector | undefined;\n  if (!injector) {\n    throw new Error('GitHub token refresh requires an active Factory sandbox workspace.');\n  }\n  injector(token);\n}\n","import type { AgentControllerRequestContext } from '@mastra/core/agent-controller';\nimport type { RequestContext } from '@mastra/core/request-context';\n\nimport type { FactoryAuthUser } from '../auth.js';\nimport { getFactoryAuthOrgId } from '../auth.js';\nimport type { FactoryRunBindingAddress, FactoryRunBindingSessionAddress } from '../storage/domains/work-items/base.js';\n\ninterface FactorySessionState {\n  factoryProjectId?: string;\n}\n\nexport function getFactorySessionCoordinates(\n  requestContext: RequestContext | undefined,\n): FactoryRunBindingSessionAddress | null {\n  if (!requestContext || typeof requestContext.get !== 'function') return null;\n  const context = requestContext.get('controller') as AgentControllerRequestContext<FactorySessionState> | undefined;\n  const factoryProjectId = context?.getState().factoryProjectId;\n  if (!context?.threadId || !context.resourceId || !factoryProjectId) return null;\n  return {\n    factoryProjectId,\n    threadId: context.threadId,\n    resourceId: context.resourceId,\n    sessionId: context.resourceId,\n  };\n}\n\nexport function getFactorySessionAddress(requestContext: RequestContext | undefined): FactoryRunBindingAddress | null {\n  const coordinates = getFactorySessionCoordinates(requestContext);\n  if (!coordinates || !requestContext || typeof requestContext.get !== 'function') return null;\n  const user = requestContext.get('user') as FactoryAuthUser | undefined;\n  const orgId = getFactoryAuthOrgId(user);\n  if (!orgId) return null;\n  return { orgId, ...coordinates };\n}\n"],"mappings":"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","names":["path","path"]}