@mastra/factory 0.21.1-alpha.2 → 0.22.0-alpha.4

package/dist/capabilities/version-control.d.ts

@@ -1,3 +1,4 @@
+import type { FactoryRepositoryAccess } from '@mastra/core/workspace';
 import type { SourceControlInstallation, SourceControlRepository, SourceControlStorageHandle } from '../storage/domains/source-control/base.js';
 import type { IntegrationConnection } from './connection.js';
 export interface InstallationInput {
@@ -12,14 +13,7 @@ export interface RepositoryInput {
     defaultBranch: string;
     metadata?: Record<string, unknown>;
 }
-export interface RepositoryAccess {
-    cloneUrl: string;
-    authorization?: {
-        scheme: 'bearer';
-        token: string;
-        username?: string;
-    };
-}
+export type RepositoryAccess = FactoryRepositoryAccess;
 export interface RepositoryTarget {
     connection: IntegrationConnection;
     sourceId: string;
@@ -232,6 +226,17 @@ export interface VersionControl {
         orgId: string;
         repositoryId: string;
     }): Promise<RepositoryAccess>;
+    /**
+     * One credential that reaches every listed repository, for providers whose
+     * per-repository tokens would otherwise leave `gh` blind to the rest of an
+     * environment. Resolves `undefined` when the provider cannot cover the set
+     * (several installations, more repositories than one token allows); the
+     * caller then falls back to `getRepositoryAccess` for the primary.
+     */
+    getRepositoriesAccess?(input: {
+        orgId: string;
+        repositoryIds: string[];
+    }): Promise<RepositoryAccess | undefined>;
     listPullRequests(input: ListPullRequestsInput): Promise<PullRequestPage>;
     getPullRequest(input: PullRequestRef): Promise<PullRequest | null>;
     createPullRequest(input: CreatePullRequestInput): Promise<PullRequest>;

package/dist/capabilities/version-control.d.ts.map

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

package/dist/environment/build-runner.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Starts `factory-environment-build` runs on the booted `Mastra`. Every
+ * trigger goes through a workflow run so the start decision and the poll are
+ * recorded the same way whether a route, the scheduler or a webhook asked.
+ */
+import type { Mastra } from '@mastra/core/mastra';
+import type { FactorySandboxContext } from '@mastra/core/workspace';
+import type { RepositoryPushEvent } from '../integrations/base.js';
+import type { ScheduleService } from './build-schedule.js';
+import type { EnvironmentBuildWorkflowOptions } from './build-workflow.js';
+import type { EnvironmentBuildDeps, EnvironmentBuildOutcome, EnvironmentBuildTrigger } from './build.js';
+export type StartEnvironmentBuild = (projectId: string, trigger: EnvironmentBuildTrigger) => Promise<EnvironmentBuildOutcome>;
+export interface EnvironmentBuildRunnerOptions extends Omit<EnvironmentBuildWorkflowOptions, 'onStart'> {
+    /** The booted instance; `undefined` until the host finished `finalize()`. */
+    getMastra: () => Mastra | undefined;
+    logger?: {
+        info: (msg: string, meta?: Record<string, unknown>) => void;
+    };
+}
+/** What a read of a build's status or history hands the provider. */
+export interface EnvironmentBuildReadContext {
+    ctx: FactorySandboxContext;
+    settings: Record<string, unknown>;
+}
+export declare class EnvironmentBuildRunner {
+    #private;
+    readonly workflow: import("@mastra/core/workflows").Workflow<import("@mastra/core/workflows").DefaultEngineType, import("@mastra/core/workflows").Step<string, unknown, unknown, unknown, unknown, unknown, any, unknown>[], "factory-environment-build", unknown, {
+        projectId: string;
+        trigger: "manual" | "push" | "schedule";
+    }, {
+        outcome: "started" | "failed" | "skipped" | "unavailable";
+        buildId?: string | undefined;
+        templateId?: string | undefined;
+        reason?: string | undefined;
+        status?: "unknown" | "failed" | "ready" | undefined;
+    }, {
+        outcome: "started" | "failed" | "skipped" | "unavailable";
+        buildId?: string | undefined;
+        templateId?: string | undefined;
+        reason?: string | undefined;
+        status?: "unknown" | "failed" | "ready" | undefined;
+    }, unknown>;
+    constructor(deps: EnvironmentBuildDeps, options: EnvironmentBuildRunnerOptions);
+    /** The schedule service of the booted host, `undefined` before boot. */
+    schedules(): ScheduleService | undefined;
+    /** Whether the host's storage implements schedules; false until `probeSchedules()` ran. */
+    get scheduleAvailable(): boolean;
+    /** Probe once after the host booted; a storage without the domain disables the cron trigger. */
+    probeSchedules(): Promise<boolean>;
+    /**
+     * The context a status or history read hands the provider. Heads come from
+     * the stored last attempt (the build being read was pinned to them), else
+     * the active template, so a read never calls GitHub; before the first build
+     * they are resolved live once.
+     */
+    readContext(projectId: string): Promise<EnvironmentBuildReadContext | undefined>;
+    /**
+     * A push to an environment repository's default branch starts a `push` run
+     * when the project opted in; the run's debounce claim decides whether it
+     * builds. Fire and forget: the webhook never waits on it.
+     */
+    readonly onRepositoryPush: (event: RepositoryPushEvent) => void;
+    /**
+     * Start a run and resolve with the first step's answer; the poll step keeps
+     * running in the background. Resolves `unavailable` before the host booted
+     * or when the host never registered the workflow, and `failed` when the run
+     * could not be created; a caller that already saved its own change must not
+     * fail on the build it merely requested.
+     */
+    readonly start: StartEnvironmentBuild;
+}
+//# sourceMappingURL=build-runner.d.ts.map

package/dist/environment/build-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-runner.d.ts","sourceRoot":"","sources":["../../src/environment/build-runner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAGnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,KAAK,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAGzG,MAAM,MAAM,qBAAqB,GAAG,CAClC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,uBAAuB,KAC7B,OAAO,CAAC,uBAAuB,CAAC,CAAC;AAEtC,MAAM,WAAW,6BAA8B,SAAQ,IAAI,CAAC,+BAA+B,EAAE,SAAS,CAAC;IACrG,6EAA6E;IAC7E,SAAS,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACpC,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;KAAE,CAAC;CAC1E;AAED,qEAAqE;AACrE,MAAM,WAAW,2BAA2B;IAC1C,GAAG,EAAE,qBAAqB,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,qBAAa,sBAAsB;;IACjC,QAAQ,CAAC,QAAQ;;;;;;;;;;;;;;;gBAAC;gBAON,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,6BAA6B;IAc9E,wEAAwE;IACxE,SAAS,IAAI,eAAe,GAAG,SAAS;IAIxC,2FAA2F;IAC3F,IAAI,iBAAiB,IAAI,OAAO,CAE/B;IAED,gGAAgG;IAC1F,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAMxC;;;;;OAKG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,2BAA2B,GAAG,SAAS,CAAC;IAgBtF;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,GAAI,OAAO,mBAAmB,KAAG,IAAI,CAa5D;IAEF;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAqCnC;CACH"}

package/dist/environment/build-runner.js

@@ -0,0 +1,131 @@
+import { environmentBuildContext, errorReason, resolveEnvironmentHeads } from "./build.js";
+import { resolveProjectEnvironment } from "../workspace.js";
+import { ENVIRONMENT_BUILD_WORKFLOW_ID, createEnvironmentBuildWorkflow } from "./build-workflow.js";
+import { probeSchedulesAvailable } from "./build-schedule.js";
+//#region src/environment/build-runner.ts
+var EnvironmentBuildRunner = class {
+	workflow;
+	#deps;
+	#getMastra;
+	#logger;
+	#pending = /* @__PURE__ */ new Map();
+	#scheduleAvailable = false;
+	constructor(deps, options) {
+		const { getMastra, logger, ...workflowOptions } = options;
+		this.#deps = deps;
+		this.#getMastra = getMastra;
+		this.#logger = logger;
+		this.workflow = createEnvironmentBuildWorkflow(deps, {
+			...workflowOptions,
+			onStart: (runId, outcome) => {
+				this.#pending.get(runId)?.(outcome);
+				this.#pending.delete(runId);
+			}
+		});
+	}
+	/** The schedule service of the booted host, `undefined` before boot. */
+	schedules() {
+		return this.#getMastra()?.schedules;
+	}
+	/** Whether the host's storage implements schedules; false until `probeSchedules()` ran. */
+	get scheduleAvailable() {
+		return this.#scheduleAvailable;
+	}
+	/** Probe once after the host booted; a storage without the domain disables the cron trigger. */
+	async probeSchedules() {
+		const schedules = this.schedules();
+		this.#scheduleAvailable = schedules ? await probeSchedulesAvailable(schedules) : false;
+		return this.#scheduleAvailable;
+	}
+	/**
+	* The context a status or history read hands the provider. Heads come from
+	* the stored last attempt (the build being read was pinned to them), else
+	* the active template, so a read never calls GitHub; before the first build
+	* they are resolved live once.
+	*/
+	async readContext(projectId) {
+		const sourceControl = this.#deps.sourceControl;
+		if (!sourceControl) return void 0;
+		const project = await this.#deps.projects.getById({ id: projectId });
+		if (!project) return void 0;
+		const environment = await resolveProjectEnvironment(sourceControl.storage, project);
+		return {
+			ctx: environmentBuildContext(project, environment, project.lastBuildHeads ?? project.activeTemplateHeads ?? await resolveEnvironmentHeads(sourceControl, project, environment), sourceControl.versionControl),
+			settings: environment.settings
+		};
+	}
+	/**
+	* A push to an environment repository's default branch starts a `push` run
+	* when the project opted in; the run's debounce claim decides whether it
+	* builds. Fire and forget: the webhook never waits on it.
+	*/
+	onRepositoryPush = (event) => {
+		if (!event.projectRepository.inEnvironment) return;
+		const branch = event.defaultBranch;
+		if (event.ref !== `refs/heads/${branch}`) return;
+		this.#deps.projects.getById({ id: event.factoryProjectId }).then((project) => project?.buildOnPushEnabled ? this.start(project.id, "push") : void 0).catch((error) => {
+			this.#logger?.info("environment build push hand-off failed", {
+				factoryProjectId: event.factoryProjectId,
+				reason: errorReason(error)
+			});
+		});
+	};
+	/**
+	* Start a run and resolve with the first step's answer; the poll step keeps
+	* running in the background. Resolves `unavailable` before the host booted
+	* or when the host never registered the workflow, and `failed` when the run
+	* could not be created; a caller that already saved its own change must not
+	* fail on the build it merely requested.
+	*/
+	start = async (projectId, trigger) => {
+		const mastra = this.#getMastra();
+		if (!mastra) return {
+			outcome: "unavailable",
+			reason: "not_ready"
+		};
+		let run;
+		try {
+			run = await mastra.getWorkflow(ENVIRONMENT_BUILD_WORKFLOW_ID).createRun();
+		} catch (error) {
+			const reason = errorReason(error);
+			this.#logger?.info("environment build run could not be created", {
+				factoryProjectId: projectId,
+				reason
+			});
+			return mastra.listWorkflows()["factory-environment-build"] ? {
+				outcome: "failed",
+				reason
+			} : {
+				outcome: "unavailable",
+				reason: "no_workflow"
+			};
+		}
+		const outcome = new Promise((resolve) => this.#pending.set(run.runId, resolve));
+		run.start({ inputData: {
+			projectId,
+			trigger
+		} }).then((result) => {
+			if (result.status !== "success") this.#logger?.info("environment build run did not succeed", {
+				factoryProjectId: projectId,
+				runId: run.runId
+			});
+		}).catch((error) => {
+			this.#logger?.info("environment build run threw", {
+				factoryProjectId: projectId,
+				runId: run.runId,
+				reason: errorReason(error)
+			});
+		}).finally(() => {
+			this.#pending.get(run.runId)?.({
+				outcome: "failed",
+				reason: "The build run ended before it started a build."
+			});
+			this.#pending.delete(run.runId);
+		});
+		return outcome;
+	};
+};
+//#endregion
+export { EnvironmentBuildRunner };
+
+//# sourceMappingURL=build-runner.js.map

package/dist/environment/build-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-runner.js","names":["#deps","#getMastra","#logger","#pending","#scheduleAvailable"],"sources":["../../src/environment/build-runner.ts"],"sourcesContent":["/**\n * Starts `factory-environment-build` runs on the booted `Mastra`. Every\n * trigger goes through a workflow run so the start decision and the poll are\n * recorded the same way whether a route, the scheduler or a webhook asked.\n */\n\nimport type { Mastra } from '@mastra/core/mastra';\nimport type { FactorySandboxContext } from '@mastra/core/workspace';\nimport type { RepositoryPushEvent } from '../integrations/base.js';\nimport { resolveProjectEnvironment } from '../workspace.js';\nimport { probeSchedulesAvailable } from './build-schedule.js';\nimport type { ScheduleService } from './build-schedule.js';\nimport { createEnvironmentBuildWorkflow, ENVIRONMENT_BUILD_WORKFLOW_ID } from './build-workflow.js';\nimport type { EnvironmentBuildWorkflowOptions } from './build-workflow.js';\nimport type { EnvironmentBuildDeps, EnvironmentBuildOutcome, EnvironmentBuildTrigger } from './build.js';\nimport { environmentBuildContext, errorReason, resolveEnvironmentHeads } from './build.js';\n\nexport type StartEnvironmentBuild = (\n  projectId: string,\n  trigger: EnvironmentBuildTrigger,\n) => Promise<EnvironmentBuildOutcome>;\n\nexport interface EnvironmentBuildRunnerOptions extends Omit<EnvironmentBuildWorkflowOptions, 'onStart'> {\n  /** The booted instance; `undefined` until the host finished `finalize()`. */\n  getMastra: () => Mastra | undefined;\n  logger?: { info: (msg: string, meta?: Record<string, unknown>) => void };\n}\n\n/** What a read of a build's status or history hands the provider. */\nexport interface EnvironmentBuildReadContext {\n  ctx: FactorySandboxContext;\n  settings: Record<string, unknown>;\n}\n\nexport class EnvironmentBuildRunner {\n  readonly workflow;\n  readonly #deps: EnvironmentBuildDeps;\n  readonly #getMastra: () => Mastra | undefined;\n  readonly #logger: EnvironmentBuildRunnerOptions['logger'];\n  readonly #pending = new Map<string, (outcome: EnvironmentBuildOutcome) => void>();\n  #scheduleAvailable = false;\n\n  constructor(deps: EnvironmentBuildDeps, options: EnvironmentBuildRunnerOptions) {\n    const { getMastra, logger, ...workflowOptions } = options;\n    this.#deps = deps;\n    this.#getMastra = getMastra;\n    this.#logger = logger;\n    this.workflow = createEnvironmentBuildWorkflow(deps, {\n      ...workflowOptions,\n      onStart: (runId, outcome) => {\n        this.#pending.get(runId)?.(outcome);\n        this.#pending.delete(runId);\n      },\n    });\n  }\n\n  /** The schedule service of the booted host, `undefined` before boot. */\n  schedules(): ScheduleService | undefined {\n    return this.#getMastra()?.schedules;\n  }\n\n  /** Whether the host's storage implements schedules; false until `probeSchedules()` ran. */\n  get scheduleAvailable(): boolean {\n    return this.#scheduleAvailable;\n  }\n\n  /** Probe once after the host booted; a storage without the domain disables the cron trigger. */\n  async probeSchedules(): Promise<boolean> {\n    const schedules = this.schedules();\n    this.#scheduleAvailable = schedules ? await probeSchedulesAvailable(schedules) : false;\n    return this.#scheduleAvailable;\n  }\n\n  /**\n   * The context a status or history read hands the provider. Heads come from\n   * the stored last attempt (the build being read was pinned to them), else\n   * the active template, so a read never calls GitHub; before the first build\n   * they are resolved live once.\n   */\n  async readContext(projectId: string): Promise<EnvironmentBuildReadContext | undefined> {\n    const sourceControl = this.#deps.sourceControl;\n    if (!sourceControl) return undefined;\n    const project = await this.#deps.projects.getById({ id: projectId });\n    if (!project) return undefined;\n    const environment = await resolveProjectEnvironment(sourceControl.storage, project);\n    const heads =\n      project.lastBuildHeads ??\n      project.activeTemplateHeads ??\n      (await resolveEnvironmentHeads(sourceControl, project, environment));\n    return {\n      ctx: environmentBuildContext(project, environment, heads, sourceControl.versionControl),\n      settings: environment.settings,\n    };\n  }\n\n  /**\n   * A push to an environment repository's default branch starts a `push` run\n   * when the project opted in; the run's debounce claim decides whether it\n   * builds. Fire and forget: the webhook never waits on it.\n   */\n  readonly onRepositoryPush = (event: RepositoryPushEvent): void => {\n    if (!event.projectRepository.inEnvironment) return;\n    const branch = event.defaultBranch;\n    if (event.ref !== `refs/heads/${branch}`) return;\n    void this.#deps.projects\n      .getById({ id: event.factoryProjectId })\n      .then(project => (project?.buildOnPushEnabled ? this.start(project.id, 'push') : undefined))\n      .catch((error: unknown) => {\n        this.#logger?.info('environment build push hand-off failed', {\n          factoryProjectId: event.factoryProjectId,\n          reason: errorReason(error),\n        });\n      });\n  };\n\n  /**\n   * Start a run and resolve with the first step's answer; the poll step keeps\n   * running in the background. Resolves `unavailable` before the host booted\n   * or when the host never registered the workflow, and `failed` when the run\n   * could not be created; a caller that already saved its own change must not\n   * fail on the build it merely requested.\n   */\n  readonly start: StartEnvironmentBuild = async (projectId, trigger) => {\n    const mastra = this.#getMastra();\n    if (!mastra) return { outcome: 'unavailable', reason: 'not_ready' };\n    let run: Awaited<ReturnType<typeof this.workflow.createRun>>;\n    try {\n      run = await mastra.getWorkflow(ENVIRONMENT_BUILD_WORKFLOW_ID).createRun();\n    } catch (error) {\n      const reason = errorReason(error);\n      this.#logger?.info('environment build run could not be created', { factoryProjectId: projectId, reason });\n      return mastra.listWorkflows()[ENVIRONMENT_BUILD_WORKFLOW_ID]\n        ? { outcome: 'failed', reason }\n        : { outcome: 'unavailable', reason: 'no_workflow' };\n    }\n    const outcome = new Promise<EnvironmentBuildOutcome>(resolve => this.#pending.set(run.runId, resolve));\n    run\n      .start({ inputData: { projectId, trigger } })\n      .then(result => {\n        if (result.status !== 'success') {\n          this.#logger?.info('environment build run did not succeed', {\n            factoryProjectId: projectId,\n            runId: run.runId,\n          });\n        }\n      })\n      .catch((error: unknown) => {\n        this.#logger?.info('environment build run threw', {\n          factoryProjectId: projectId,\n          runId: run.runId,\n          reason: errorReason(error),\n        });\n      })\n      .finally(() => {\n        // A run that failed before its first step answered must not hang the caller.\n        this.#pending.get(run.runId)?.({ outcome: 'failed', reason: 'The build run ended before it started a build.' });\n        this.#pending.delete(run.runId);\n      });\n    return outcome;\n  };\n}\n"],"mappings":"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"}

package/dist/environment/build-schedule.d.ts

@@ -0,0 +1,40 @@
+/**
+ * The per-project cron that fires the `factory-environment-build` workflow,
+ * kept in core `Schedules` (one row per project) rather than a factory
+ * column: the scheduler owns firing, claims and the run trigger log, factory
+ * only creates, pauses, resumes and reads the row.
+ */
+import type { Schedules } from '@mastra/core/schedules';
+export declare const SCHEDULES_UNAVAILABLE_ERROR_ID = "SCHEDULES_NO_SCHEDULES_STORAGE";
+/**
+ * The project's schedule id in its stored form. Core normalizes a created
+ * id to `schedule_<slug>` and resolves a bare id to `agent_<slug>` on reads,
+ * so factory always addresses the row by the normalized id (a project id is
+ * a lower-case uuid, which slugifies to itself).
+ */
+export declare function scheduleIdFor(projectId: string): string;
+export interface EnvironmentBuildSchedule {
+    enabled: boolean;
+    cron: string | null;
+    timezone: string | null;
+}
+export type ScheduleService = Pick<Schedules, 'create' | 'get' | 'list' | 'update' | 'pause' | 'resume' | 'delete'>;
+/**
+ * Whether the host's storage implements the schedules domain. `mastra.schedules`
+ * never throws on access; the missing store surfaces on the first call.
+ */
+export declare function probeSchedulesAvailable(schedules: ScheduleService): Promise<boolean>;
+/** `undefined` when the cron parses; otherwise the validator's message. */
+export declare function invalidCronMessage(cron: string, timezone?: string): string | undefined;
+/** The project's build schedule as the environment reports it. */
+export declare function readSchedule(schedules: ScheduleService, projectId: string): Promise<EnvironmentBuildSchedule>;
+/**
+ * Create, update, pause or resume the project's schedule so it matches
+ * `input`. Disabling a project that never had a schedule creates nothing.
+ */
+export declare function ensureSchedule(schedules: ScheduleService, projectId: string, input: {
+    enabled: boolean;
+    cron: string;
+    timezone?: string;
+}): Promise<EnvironmentBuildSchedule>;
+//# sourceMappingURL=build-schedule.d.ts.map

package/dist/environment/build-schedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-schedule.d.ts","sourceRoot":"","sources":["../../src/environment/build-schedule.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAe,SAAS,EAAoB,MAAM,wBAAwB,CAAC;AAIvF,eAAO,MAAM,8BAA8B,mCAAmC,CAAC;AAE/E;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAAC;AAQpH;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,SAAS,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ1F;AAED,2EAA2E;AAC3E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOtF;AAWD,kEAAkE;AAClE,wBAAsB,YAAY,CAAC,SAAS,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAGnH;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,eAAe,EAC1B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3D,OAAO,CAAC,wBAAwB,CAAC,CA2BnC"}

package/dist/environment/build-schedule.js

@@ -0,0 +1,94 @@
+import { ENVIRONMENT_BUILD_WORKFLOW_ID } from "./build-workflow.js";
+import { validateCron } from "@mastra/core/workflows";
+//#region src/environment/build-schedule.ts
+const SCHEDULES_UNAVAILABLE_ERROR_ID = "SCHEDULES_NO_SCHEDULES_STORAGE";
+/**
+* The project's schedule id in its stored form. Core normalizes a created
+* id to `schedule_<slug>` and resolves a bare id to `agent_<slug>` on reads,
+* so factory always addresses the row by the normalized id (a project id is
+* a lower-case uuid, which slugifies to itself).
+*/
+function scheduleIdFor(projectId) {
+	return `schedule_factory-environment-build-${projectId}`;
+}
+function isSchedulesUnavailable(error) {
+	return typeof error === "object" && error !== null && error.id === "SCHEDULES_NO_SCHEDULES_STORAGE";
+}
+/**
+* Whether the host's storage implements the schedules domain. `mastra.schedules`
+* never throws on access; the missing store surfaces on the first call.
+*/
+async function probeSchedulesAvailable(schedules) {
+	try {
+		await schedules.list({ workflowId: ENVIRONMENT_BUILD_WORKFLOW_ID });
+		return true;
+	} catch (error) {
+		if (isSchedulesUnavailable(error)) return false;
+		throw error;
+	}
+}
+/** `undefined` when the cron parses; otherwise the validator's message. */
+function invalidCronMessage(cron, timezone) {
+	try {
+		validateCron(cron, timezone);
+		return;
+	} catch (error) {
+		return error instanceof Error ? error.message : String(error);
+	}
+}
+function isWorkflowSchedule(schedule) {
+	return schedule !== null && schedule.agentId === void 0;
+}
+function toView(schedule) {
+	if (!schedule) return {
+		enabled: false,
+		cron: null,
+		timezone: null
+	};
+	return {
+		enabled: schedule.status === "active",
+		cron: schedule.cron,
+		timezone: schedule.timezone ?? null
+	};
+}
+/** The project's build schedule as the environment reports it. */
+async function readSchedule(schedules, projectId) {
+	const schedule = await schedules.get(scheduleIdFor(projectId));
+	return toView(isWorkflowSchedule(schedule) ? schedule : null);
+}
+/**
+* Create, update, pause or resume the project's schedule so it matches
+* `input`. Disabling a project that never had a schedule creates nothing.
+*/
+async function ensureSchedule(schedules, projectId, input) {
+	const id = scheduleIdFor(projectId);
+	const existing = await schedules.get(id);
+	const current = isWorkflowSchedule(existing) ? existing : null;
+	if (!current) {
+		if (!input.enabled) return toView(null);
+		return toView(await schedules.create({
+			id,
+			workflowId: ENVIRONMENT_BUILD_WORKFLOW_ID,
+			cron: input.cron,
+			...input.timezone ? { timezone: input.timezone } : {},
+			inputData: {
+				projectId,
+				trigger: "schedule"
+			},
+			resourceId: projectId
+		}));
+	}
+	const timingChanged = current.cron !== input.cron || (current.timezone ?? void 0) !== input.timezone;
+	let next = current;
+	if (timingChanged) next = await schedules.update(current.id, {
+		cron: input.cron,
+		...input.timezone ? { timezone: input.timezone } : {}
+	});
+	if (input.enabled && next.status === "paused") next = await schedules.resume(current.id);
+	if (!input.enabled && next.status === "active") next = await schedules.pause(current.id);
+	return toView(isWorkflowSchedule(next) ? next : null);
+}
+//#endregion
+export { SCHEDULES_UNAVAILABLE_ERROR_ID, ensureSchedule, invalidCronMessage, probeSchedulesAvailable, readSchedule, scheduleIdFor };
+
+//# sourceMappingURL=build-schedule.js.map

package/dist/environment/build-schedule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-schedule.js","names":[],"sources":["../../src/environment/build-schedule.ts"],"sourcesContent":["/**\n * The per-project cron that fires the `factory-environment-build` workflow,\n * kept in core `Schedules` (one row per project) rather than a factory\n * column: the scheduler owns firing, claims and the run trigger log, factory\n * only creates, pauses, resumes and reads the row.\n */\n\nimport type { AnySchedule, Schedules, WorkflowSchedule } from '@mastra/core/schedules';\nimport { validateCron } from '@mastra/core/workflows';\nimport { ENVIRONMENT_BUILD_WORKFLOW_ID } from './build-workflow.js';\n\nexport const SCHEDULES_UNAVAILABLE_ERROR_ID = 'SCHEDULES_NO_SCHEDULES_STORAGE';\n\n/**\n * The project's schedule id in its stored form. Core normalizes a created\n * id to `schedule_<slug>` and resolves a bare id to `agent_<slug>` on reads,\n * so factory always addresses the row by the normalized id (a project id is\n * a lower-case uuid, which slugifies to itself).\n */\nexport function scheduleIdFor(projectId: string): string {\n  return `schedule_factory-environment-build-${projectId}`;\n}\n\nexport interface EnvironmentBuildSchedule {\n  enabled: boolean;\n  cron: string | null;\n  timezone: string | null;\n}\n\nexport type ScheduleService = Pick<Schedules, 'create' | 'get' | 'list' | 'update' | 'pause' | 'resume' | 'delete'>;\n\nfunction isSchedulesUnavailable(error: unknown): boolean {\n  return (\n    typeof error === 'object' && error !== null && (error as { id?: unknown }).id === SCHEDULES_UNAVAILABLE_ERROR_ID\n  );\n}\n\n/**\n * Whether the host's storage implements the schedules domain. `mastra.schedules`\n * never throws on access; the missing store surfaces on the first call.\n */\nexport async function probeSchedulesAvailable(schedules: ScheduleService): Promise<boolean> {\n  try {\n    await schedules.list({ workflowId: ENVIRONMENT_BUILD_WORKFLOW_ID });\n    return true;\n  } catch (error) {\n    if (isSchedulesUnavailable(error)) return false;\n    throw error;\n  }\n}\n\n/** `undefined` when the cron parses; otherwise the validator's message. */\nexport function invalidCronMessage(cron: string, timezone?: string): string | undefined {\n  try {\n    validateCron(cron, timezone);\n    return undefined;\n  } catch (error) {\n    return error instanceof Error ? error.message : String(error);\n  }\n}\n\nfunction isWorkflowSchedule(schedule: AnySchedule | null): schedule is WorkflowSchedule {\n  return schedule !== null && schedule.agentId === undefined;\n}\n\nfunction toView(schedule: WorkflowSchedule | null): EnvironmentBuildSchedule {\n  if (!schedule) return { enabled: false, cron: null, timezone: null };\n  return { enabled: schedule.status === 'active', cron: schedule.cron, timezone: schedule.timezone ?? null };\n}\n\n/** The project's build schedule as the environment reports it. */\nexport async function readSchedule(schedules: ScheduleService, projectId: string): Promise<EnvironmentBuildSchedule> {\n  const schedule = await schedules.get(scheduleIdFor(projectId));\n  return toView(isWorkflowSchedule(schedule) ? schedule : null);\n}\n\n/**\n * Create, update, pause or resume the project's schedule so it matches\n * `input`. Disabling a project that never had a schedule creates nothing.\n */\nexport async function ensureSchedule(\n  schedules: ScheduleService,\n  projectId: string,\n  input: { enabled: boolean; cron: string; timezone?: string },\n): Promise<EnvironmentBuildSchedule> {\n  const id = scheduleIdFor(projectId);\n  const existing = await schedules.get(id);\n  const current = isWorkflowSchedule(existing) ? existing : null;\n  if (!current) {\n    if (!input.enabled) return toView(null);\n    const created = await schedules.create({\n      id,\n      workflowId: ENVIRONMENT_BUILD_WORKFLOW_ID,\n      cron: input.cron,\n      ...(input.timezone ? { timezone: input.timezone } : {}),\n      inputData: { projectId, trigger: 'schedule' },\n      resourceId: projectId,\n    });\n    return toView(created);\n  }\n  const timingChanged = current.cron !== input.cron || (current.timezone ?? undefined) !== input.timezone;\n  let next: AnySchedule = current;\n  if (timingChanged) {\n    next = await schedules.update(current.id, {\n      cron: input.cron,\n      ...(input.timezone ? { timezone: input.timezone } : {}),\n    });\n  }\n  if (input.enabled && next.status === 'paused') next = await schedules.resume(current.id);\n  if (!input.enabled && next.status === 'active') next = await schedules.pause(current.id);\n  return toView(isWorkflowSchedule(next) ? next : null);\n}\n"],"mappings":";;;AAWA,MAAa,iCAAiC;;;;;;;AAQ9C,SAAgB,cAAc,WAA2B;CACvD,OAAO,sCAAsC;AAC/C;AAUA,SAAS,uBAAuB,OAAyB;CACvD,OACE,OAAO,UAAU,YAAY,UAAU,QAAS,MAA2B,OAAA;AAE/E;;;;;AAMA,eAAsB,wBAAwB,WAA8C;CAC1F,IAAI;EACF,MAAM,UAAU,KAAK,EAAE,YAAY,8BAA8B,CAAC;EAClE,OAAO;CACT,SAAS,OAAO;EACd,IAAI,uBAAuB,KAAK,GAAG,OAAO;EAC1C,MAAM;CACR;AACF;;AAGA,SAAgB,mBAAmB,MAAc,UAAuC;CACtF,IAAI;EACF,aAAa,MAAM,QAAQ;EAC3B;CACF,SAAS,OAAO;EACd,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;CAC9D;AACF;AAEA,SAAS,mBAAmB,UAA4D;CACtF,OAAO,aAAa,QAAQ,SAAS,YAAY,KAAA;AACnD;AAEA,SAAS,OAAO,UAA6D;CAC3E,IAAI,CAAC,UAAU,OAAO;EAAE,SAAS;EAAO,MAAM;EAAM,UAAU;CAAK;CACnE,OAAO;EAAE,SAAS,SAAS,WAAW;EAAU,MAAM,SAAS;EAAM,UAAU,SAAS,YAAY;CAAK;AAC3G;;AAGA,eAAsB,aAAa,WAA4B,WAAsD;CACnH,MAAM,WAAW,MAAM,UAAU,IAAI,cAAc,SAAS,CAAC;CAC7D,OAAO,OAAO,mBAAmB,QAAQ,IAAI,WAAW,IAAI;AAC9D;;;;;AAMA,eAAsB,eACpB,WACA,WACA,OACmC;CACnC,MAAM,KAAK,cAAc,SAAS;CAClC,MAAM,WAAW,MAAM,UAAU,IAAI,EAAE;CACvC,MAAM,UAAU,mBAAmB,QAAQ,IAAI,WAAW;CAC1D,IAAI,CAAC,SAAS;EACZ,IAAI,CAAC,MAAM,SAAS,OAAO,OAAO,IAAI;EAStC,OAAO,OAAO,MARQ,UAAU,OAAO;GACrC;GACA,YAAY;GACZ,MAAM,MAAM;GACZ,GAAI,MAAM,WAAW,EAAE,UAAU,MAAM,SAAS,IAAI,CAAC;GACrD,WAAW;IAAE;IAAW,SAAS;GAAW;GAC5C,YAAY;EACd,CAAC,CACoB;CACvB;CACA,MAAM,gBAAgB,QAAQ,SAAS,MAAM,SAAS,QAAQ,YAAY,KAAA,OAAe,MAAM;CAC/F,IAAI,OAAoB;CACxB,IAAI,eACF,OAAO,MAAM,UAAU,OAAO,QAAQ,IAAI;EACxC,MAAM,MAAM;EACZ,GAAI,MAAM,WAAW,EAAE,UAAU,MAAM,SAAS,IAAI,CAAC;CACvD,CAAC;CAEH,IAAI,MAAM,WAAW,KAAK,WAAW,UAAU,OAAO,MAAM,UAAU,OAAO,QAAQ,EAAE;CACvF,IAAI,CAAC,MAAM,WAAW,KAAK,WAAW,UAAU,OAAO,MAAM,UAAU,MAAM,QAAQ,EAAE;CACvF,OAAO,OAAO,mBAAmB,IAAI,IAAI,OAAO,IAAI;AACtD"}

package/dist/environment/build-workflow.d.ts

@@ -0,0 +1,62 @@
+/**
+ * The `factory-environment-build` workflow: step one decides and starts a
+ * build (`runEnvironmentBuild`), step two polls the provider until the build
+ * settles and pins the active template on the project row. Registered by
+ * `MastraFactory.prepare()` only when the sandbox has `builds`, and driven by
+ * the Build now route, the per-project cron schedule and the GitHub push
+ * hand-off. Saving settings never starts it.
+ */
+import { z } from 'zod';
+import type { EnvironmentBuildDeps, EnvironmentBuildOutcome } from './build.js';
+export declare const ENVIRONMENT_BUILD_WORKFLOW_ID = "factory-environment-build";
+export declare const DEFAULT_BUILD_POLL_MS = 15000;
+export declare const MAX_BUILD_WAIT_MS: number;
+export declare const environmentBuildInputSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    trigger: z.ZodEnum<{
+        manual: "manual";
+        push: "push";
+        schedule: "schedule";
+    }>;
+}, z.core.$strip>;
+export declare const environmentBuildOutputSchema: z.ZodObject<{
+    outcome: z.ZodEnum<{
+        started: "started";
+        failed: "failed";
+        skipped: "skipped";
+        unavailable: "unavailable";
+    }>;
+    buildId: z.ZodOptional<z.ZodString>;
+    templateId: z.ZodOptional<z.ZodString>;
+    reason: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        unknown: "unknown";
+        failed: "failed";
+        ready: "ready";
+    }>>;
+}, z.core.$strip>;
+export type EnvironmentBuildWorkflowResult = z.infer<typeof environmentBuildOutputSchema>;
+export interface EnvironmentBuildWorkflowOptions {
+    sleep?: (ms: number) => Promise<void>;
+    pollMs?: number;
+    maxWaitMs?: number;
+    /** Called with the first step's answer so a caller can return it without waiting for the poll. */
+    onStart?: (runId: string, outcome: EnvironmentBuildOutcome) => void;
+}
+export declare function createEnvironmentBuildWorkflow(deps: EnvironmentBuildDeps, options?: EnvironmentBuildWorkflowOptions): import("@mastra/core/workflows").Workflow<import("@mastra/core/workflows").DefaultEngineType, import("@mastra/core/workflows").Step<string, unknown, unknown, unknown, unknown, unknown, any, unknown>[], "factory-environment-build", unknown, {
+    projectId: string;
+    trigger: "manual" | "push" | "schedule";
+}, {
+    outcome: "started" | "failed" | "skipped" | "unavailable";
+    buildId?: string | undefined;
+    templateId?: string | undefined;
+    reason?: string | undefined;
+    status?: "unknown" | "failed" | "ready" | undefined;
+}, {
+    outcome: "started" | "failed" | "skipped" | "unavailable";
+    buildId?: string | undefined;
+    templateId?: string | undefined;
+    reason?: string | undefined;
+    status?: "unknown" | "failed" | "ready" | undefined;
+}, unknown>;
+//# sourceMappingURL=build-workflow.d.ts.map

package/dist/environment/build-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-workflow.d.ts","sourceRoot":"","sources":["../../src/environment/build-workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,OAAO,KAAK,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAEhF,eAAO,MAAM,6BAA6B,8BAA8B,CAAC;AACzE,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAC5C,eAAO,MAAM,iBAAiB,QAAc,CAAC;AAE7C,eAAO,MAAM,2BAA2B;;;;;;;iBAGtC,CAAC;AAWH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;iBAOvC,CAAC;AAEH,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAE1F,MAAM,WAAW,+BAA+B;IAC9C,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kGAAkG;IAClG,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,KAAK,IAAI,CAAC;CACrE;AAED,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,oBAAoB,EAC1B,OAAO,GAAE,+BAAoC;;;;;;;;;;;;;;;YAoF9C"}