@mastra/factory 0.0.0-aggregate-trace-20261015182851

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

@@ -0,0 +1,268 @@
+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 {
+    externalId: string;
+    accountName?: string | null;
+    accountType?: string | null;
+    metadata?: Record<string, unknown>;
+}
+export interface RepositoryInput {
+    externalId: string;
+    slug: string;
+    defaultBranch: string;
+    metadata?: Record<string, unknown>;
+}
+export type RepositoryAccess = FactoryRepositoryAccess;
+export interface RepositoryTarget {
+    connection: IntegrationConnection;
+    sourceId: string;
+}
+export type PullRequestState = 'open' | 'closed';
+export interface PullRequest {
+    id: string;
+    title: string;
+    url: string;
+    author: string | null;
+    assignees?: string[];
+    requestedReviewers?: string[];
+    labels?: string[];
+    body: string | null;
+    state: PullRequestState;
+    draft: boolean;
+    merged: boolean;
+    mergeable: boolean | null;
+    baseBranch: string;
+    headBranch: string;
+    headSha: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface PullRequestPage {
+    pullRequests: PullRequest[];
+    nextCursor: string | null;
+}
+export interface PullRequestRef {
+    connection: IntegrationConnection;
+    sourceId: string;
+    pullRequestId: string;
+    /** End user the write should be attributed to, when the provider supports acting on a user's behalf. */
+    actingUserId?: string;
+}
+export interface ListPullRequestsInput {
+    connection: IntegrationConnection;
+    sourceId: string;
+    state?: PullRequestState | 'all';
+    includeDrafts?: boolean;
+    cursor?: string;
+}
+export interface CreatePullRequestInput {
+    connection: IntegrationConnection;
+    sourceId: string;
+    title: string;
+    body?: string;
+    baseBranch: string;
+    headBranch: string;
+    draft?: boolean;
+    /** End user the write should be attributed to, when the provider supports acting on a user's behalf. */
+    actingUserId?: string;
+}
+export interface UpdatePullRequestInput extends PullRequestRef {
+    title?: string;
+    body?: string | null;
+    baseBranch?: string;
+    state?: PullRequestState;
+}
+export interface MergePullRequestInput extends PullRequestRef {
+    commitTitle?: string;
+    commitMessage?: string;
+    method?: 'merge' | 'squash' | 'rebase';
+}
+export interface MergePullRequestResult {
+    merged: boolean;
+    message: string;
+    sha: string | null;
+}
+export interface PullRequestComment {
+    id: string;
+    url: string;
+    author: string | null;
+    body: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface PullRequestCommentPage {
+    comments: PullRequestComment[];
+    nextCursor: string | null;
+}
+export interface ListPullRequestCommentsInput extends PullRequestRef {
+    cursor?: string;
+}
+export interface CreatePullRequestCommentInput extends PullRequestRef {
+    body: string;
+}
+export interface UpdatePullRequestCommentInput {
+    connection: IntegrationConnection;
+    sourceId: string;
+    commentId: string;
+    body: string;
+    actingUserId?: string;
+}
+export interface DeletePullRequestCommentInput {
+    connection: IntegrationConnection;
+    sourceId: string;
+    commentId: string;
+    actingUserId?: string;
+}
+export type ReviewState = 'pending' | 'commented' | 'approved' | 'changes-requested' | 'dismissed';
+export interface Review {
+    id: string;
+    url: string | null;
+    author: string | null;
+    body: string | null;
+    state: ReviewState;
+    commitId: string | null;
+    submittedAt: string | null;
+}
+export interface ReviewPage {
+    reviews: Review[];
+    nextCursor: string | null;
+}
+export interface ListReviewsInput extends PullRequestRef {
+    cursor?: string;
+}
+type CreateReviewBase = PullRequestRef & {
+    commitId?: string;
+};
+type ReviewSubmission = {
+    event: 'approve';
+    body?: string;
+} | {
+    event: 'request-changes' | 'comment';
+    body: string;
+};
+export type CreateReviewInput = CreateReviewBase & (ReviewSubmission | {
+    event?: undefined;
+    body?: string;
+});
+export interface ReviewRef extends PullRequestRef {
+    reviewId: string;
+}
+export interface UpdateReviewInput extends ReviewRef {
+    body: string;
+}
+export type SubmitReviewInput = ReviewRef & ReviewSubmission;
+export interface DismissReviewInput extends ReviewRef {
+    message: string;
+}
+export interface ReviewComment extends PullRequestComment {
+    path: string;
+    line: number | null;
+    side: 'left' | 'right' | null;
+    commitId: string;
+    replyToId: string | null;
+}
+export interface ReviewCommentPage {
+    comments: ReviewComment[];
+    nextCursor: string | null;
+}
+export interface ListReviewCommentsInput extends PullRequestRef {
+    cursor?: string;
+}
+interface CreateReviewCommentBase extends PullRequestRef {
+    body: string;
+}
+export type CreateReviewCommentInput = CreateReviewCommentBase & ({
+    replyToId: string;
+    commitId?: never;
+    path?: never;
+    line?: never;
+    side?: never;
+    startLine?: never;
+    startSide?: never;
+} | {
+    replyToId?: never;
+    commitId: string;
+    path: string;
+    line: number;
+    side: 'left' | 'right';
+    startLine?: number;
+    startSide?: 'left' | 'right';
+});
+export type UpdateReviewCommentInput = UpdatePullRequestCommentInput;
+export type DeleteReviewCommentInput = DeletePullRequestCommentInput;
+export interface ResolveReviewThreadInput extends DeleteReviewCommentInput {
+    resolved: boolean;
+}
+export interface RequestedReviewers {
+    users: string[];
+    teams: string[];
+}
+export interface UpdateReviewersInput extends PullRequestRef {
+    users?: string[];
+    teams?: string[];
+}
+/** Fixed repository, pull-request lifecycle, review, comment, and reviewer contract. */
+export interface VersionControl {
+    initialize(input: {
+        storage: SourceControlStorageHandle;
+    }): void;
+    registerInstallation(input: {
+        orgId: string;
+        userId: string;
+        installation: InstallationInput;
+    }): Promise<SourceControlInstallation>;
+    registerRepositories(input: {
+        orgId: string;
+        installationId: string;
+        repositories: RepositoryInput[];
+    }): Promise<SourceControlRepository[]>;
+    /** Resolve the provider-owned reference for a durably registered repository. */
+    getRepositoryTarget(input: {
+        orgId: string;
+        repositoryId: string;
+    }): Promise<RepositoryTarget>;
+    getRepositoryAccess(input: {
+        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>;
+    updatePullRequest(input: UpdatePullRequestInput): Promise<PullRequest>;
+    closePullRequest(input: PullRequestRef): Promise<PullRequest>;
+    mergePullRequest(input: MergePullRequestInput): Promise<MergePullRequestResult>;
+    listComments(input: ListPullRequestCommentsInput): Promise<PullRequestCommentPage>;
+    createComment(input: CreatePullRequestCommentInput): Promise<PullRequestComment>;
+    updateComment(input: UpdatePullRequestCommentInput): Promise<PullRequestComment>;
+    deleteComment(input: DeletePullRequestCommentInput): Promise<void>;
+    listReviews(input: ListReviewsInput): Promise<ReviewPage>;
+    getReview(input: ReviewRef): Promise<Review | null>;
+    createReview(input: CreateReviewInput): Promise<Review>;
+    updateReview(input: UpdateReviewInput): Promise<Review>;
+    submitReview(input: SubmitReviewInput): Promise<Review>;
+    dismissReview(input: DismissReviewInput): Promise<Review>;
+    deletePendingReview(input: ReviewRef): Promise<void>;
+    /** Optional because not every provider exposes resolvable review threads. */
+    resolveReviewThread?(input: ResolveReviewThreadInput): Promise<void>;
+    listReviewComments(input: ListReviewCommentsInput): Promise<ReviewCommentPage>;
+    createReviewComment(input: CreateReviewCommentInput): Promise<ReviewComment>;
+    updateReviewComment(input: UpdateReviewCommentInput): Promise<ReviewComment>;
+    deleteReviewComment(input: DeleteReviewCommentInput): Promise<void>;
+    listRequestedReviewers(input: PullRequestRef): Promise<RequestedReviewers>;
+    requestReviewers(input: UpdateReviewersInput): Promise<RequestedReviewers>;
+    removeRequestedReviewers(input: UpdateReviewersInput): Promise<RequestedReviewers>;
+}
+export {};
+//# sourceMappingURL=version-control.d.ts.map

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

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

package/dist/capabilities/version-control.js

@@ -0,0 +1 @@
+export {};

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