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

package/dist/routes/contracts.d.ts

@@ -25,6 +25,173 @@ export declare const updateProjectBodySchema: z.ZodObject<{
     autoRunEnabled: z.ZodOptional<z.ZodBoolean>;
     autoApprovePlans: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
+/** The configured FactorySandbox as factory describes it: provider id, JSON Schema of its settings, capabilities. */
+export declare const environmentSandboxSchema: z.ZodObject<{
+    provider: z.ZodString;
+    settingsSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    capabilities: z.ZodObject<{
+        template: z.ZodBoolean;
+        builds: z.ZodObject<{
+            available: z.ZodBoolean;
+            history: z.ZodBoolean;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** When the environment builds on its own; present only when the sandbox can build. */
+export declare const environmentBuildTriggersSchema: z.ZodObject<{
+    schedule: z.ZodObject<{
+        enabled: z.ZodBoolean;
+        cron: z.ZodNullable<z.ZodString>;
+        timezone: z.ZodNullable<z.ZodString>;
+        scheduleAvailable: z.ZodBoolean;
+    }, z.core.$strip>;
+    push: z.ZodObject<{
+        enabled: z.ZodBoolean;
+        debounceMinutes: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/** The last build factory asked the provider for, from the project row only; status is read live. */
+export declare const environmentLastBuildSchema: z.ZodObject<{
+    buildId: z.ZodString;
+    attemptedAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export declare const projectEnvironmentResponseSchema: z.ZodObject<{
+    environment: z.ZodObject<{
+        sandbox: z.ZodObject<{
+            provider: z.ZodString;
+            settingsSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            capabilities: z.ZodObject<{
+                template: z.ZodBoolean;
+                builds: z.ZodObject<{
+                    available: z.ZodBoolean;
+                    history: z.ZodBoolean;
+                }, z.core.$strip>;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+        settings: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        sandboxWorkingDirectory: z.ZodNullable<z.ZodString>;
+        workspaceSetupCommand: z.ZodNullable<z.ZodString>;
+        activeTemplateId: z.ZodNullable<z.ZodString>;
+        activeTemplateHeads: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
+        repositories: z.ZodArray<z.ZodObject<{
+            projectRepositoryId: z.ZodString;
+            connectionId: z.ZodString;
+            repositoryId: z.ZodString;
+            slug: z.ZodNullable<z.ZodString>;
+            defaultBranch: z.ZodNullable<z.ZodString>;
+            position: z.ZodNumber;
+            inEnvironment: z.ZodBoolean;
+            setupCommand: z.ZodNullable<z.ZodString>;
+            teardownCommand: z.ZodNullable<z.ZodString>;
+            lastBuildStatus: z.ZodEnum<{
+                unbuilt: "unbuilt";
+                configured: "configured";
+                failed: "failed";
+            }>;
+            lastBuildError: z.ZodNullable<z.ZodString>;
+            lastBuiltAt: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        buildTriggers: z.ZodOptional<z.ZodObject<{
+            schedule: z.ZodObject<{
+                enabled: z.ZodBoolean;
+                cron: z.ZodNullable<z.ZodString>;
+                timezone: z.ZodNullable<z.ZodString>;
+                scheduleAvailable: z.ZodBoolean;
+            }, z.core.$strip>;
+            push: z.ZodObject<{
+                enabled: z.ZodBoolean;
+                debounceMinutes: z.ZodNumber;
+            }, z.core.$strip>;
+        }, z.core.$strip>>;
+        build: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            buildId: z.ZodString;
+            attemptedAt: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const environmentBuildStartResponseSchema: 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>;
+}, z.core.$strip>;
+export declare const environmentBuildSchema: z.ZodObject<{
+    buildId: z.ZodString;
+    status: z.ZodEnum<{
+        unknown: "unknown";
+        failed: "failed";
+        pending: "pending";
+        ready: "ready";
+        building: "building";
+    }>;
+    templateId: z.ZodOptional<z.ZodString>;
+    startedAt: z.ZodOptional<z.ZodString>;
+    finishedAt: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+    logs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const environmentBuildsResponseSchema: z.ZodObject<{
+    builds: z.ZodArray<z.ZodObject<{
+        buildId: z.ZodString;
+        status: z.ZodEnum<{
+            unknown: "unknown";
+            failed: "failed";
+            pending: "pending";
+            ready: "ready";
+            building: "building";
+        }>;
+        templateId: z.ZodOptional<z.ZodString>;
+        startedAt: z.ZodOptional<z.ZodString>;
+        finishedAt: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+        logs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const environmentBuildResponseSchema: z.ZodObject<{
+    build: z.ZodObject<{
+        buildId: z.ZodString;
+        status: z.ZodEnum<{
+            unknown: "unknown";
+            failed: "failed";
+            pending: "pending";
+            ready: "ready";
+            building: "building";
+        }>;
+        templateId: z.ZodOptional<z.ZodString>;
+        startedAt: z.ZodOptional<z.ZodString>;
+        finishedAt: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+        logs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const updateProjectEnvironmentBodySchema: z.ZodObject<{
+    sandboxWorkingDirectory: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<string | null, string>>, z.ZodNull]>>;
+    settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodUnknown>>>;
+    workspaceSetupCommand: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<string | null, string>>, z.ZodNull]>>;
+    buildTriggers: z.ZodOptional<z.ZodObject<{
+        schedule: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodBoolean;
+            cron: z.ZodOptional<z.ZodString>;
+            timezone: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        push: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
+            debounceMinutes: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    repositories: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        projectRepositoryId: z.ZodString;
+        position: z.ZodOptional<z.ZodNumber>;
+        inEnvironment: z.ZodOptional<z.ZodBoolean>;
+        setupCommand: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<string | null, string>>, z.ZodNull]>>;
+        teardownCommand: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<string | null, string>>, z.ZodNull]>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
 export declare const createWorkItemBodySchema: z.ZodObject<{
     title: z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>;
     board: z.ZodOptional<z.ZodString>;
@@ -128,7 +295,7 @@ export declare const metricsQuerySchema: z.ZodObject<{
     to: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const decisionQuerySchema: z.ZodObject<{
-    statuses: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<("dismissed" | "retry" | "pending" | "proposed" | "superseded" | "leased" | "succeeded" | "failed")[] | undefined, string | undefined>>;
+    statuses: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<("dismissed" | "retry" | "failed" | "pending" | "proposed" | "superseded" | "leased" | "succeeded")[] | undefined, string | undefined>>;
     before: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<{
         createdAt: Date;
         id: string;
@@ -212,6 +379,223 @@ export declare const FACTORY_ROUTE_CONTRACTS: {
             project: z.ZodRecord<z.ZodString, z.ZodUnknown>;
         }, z.core.$strip>;
     };
+    readonly projectEnvironmentGet: {
+        readonly method: "GET";
+        readonly path: "/web/factory/projects/:id/environment";
+        readonly description: "Get the sandbox environment of a Factory project: provider settings and its repositories in order";
+        readonly pathSchema: z.ZodObject<{
+            id: z.ZodString;
+        }, z.core.$strip>;
+        readonly responseSchema: z.ZodObject<{
+            environment: z.ZodObject<{
+                sandbox: z.ZodObject<{
+                    provider: z.ZodString;
+                    settingsSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                    capabilities: z.ZodObject<{
+                        template: z.ZodBoolean;
+                        builds: z.ZodObject<{
+                            available: z.ZodBoolean;
+                            history: z.ZodBoolean;
+                        }, z.core.$strip>;
+                    }, z.core.$strip>;
+                }, z.core.$strip>;
+                settings: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                sandboxWorkingDirectory: z.ZodNullable<z.ZodString>;
+                workspaceSetupCommand: z.ZodNullable<z.ZodString>;
+                activeTemplateId: z.ZodNullable<z.ZodString>;
+                activeTemplateHeads: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
+                repositories: z.ZodArray<z.ZodObject<{
+                    projectRepositoryId: z.ZodString;
+                    connectionId: z.ZodString;
+                    repositoryId: z.ZodString;
+                    slug: z.ZodNullable<z.ZodString>;
+                    defaultBranch: z.ZodNullable<z.ZodString>;
+                    position: z.ZodNumber;
+                    inEnvironment: z.ZodBoolean;
+                    setupCommand: z.ZodNullable<z.ZodString>;
+                    teardownCommand: z.ZodNullable<z.ZodString>;
+                    lastBuildStatus: z.ZodEnum<{
+                        unbuilt: "unbuilt";
+                        configured: "configured";
+                        failed: "failed";
+                    }>;
+                    lastBuildError: z.ZodNullable<z.ZodString>;
+                    lastBuiltAt: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>>;
+                buildTriggers: z.ZodOptional<z.ZodObject<{
+                    schedule: z.ZodObject<{
+                        enabled: z.ZodBoolean;
+                        cron: z.ZodNullable<z.ZodString>;
+                        timezone: z.ZodNullable<z.ZodString>;
+                        scheduleAvailable: z.ZodBoolean;
+                    }, z.core.$strip>;
+                    push: z.ZodObject<{
+                        enabled: z.ZodBoolean;
+                        debounceMinutes: z.ZodNumber;
+                    }, z.core.$strip>;
+                }, z.core.$strip>>;
+                build: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    buildId: z.ZodString;
+                    attemptedAt: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+    };
+    readonly projectEnvironmentUpdate: {
+        readonly method: "PATCH";
+        readonly path: "/web/factory/projects/:id/environment";
+        readonly description: "Update the sandbox environment of a Factory project: provider settings, repository order and setup";
+        readonly pathSchema: z.ZodObject<{
+            id: z.ZodString;
+        }, z.core.$strip>;
+        readonly bodySchema: z.ZodObject<{
+            sandboxWorkingDirectory: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<string | null, string>>, z.ZodNull]>>;
+            settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodUnknown>>>;
+            workspaceSetupCommand: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<string | null, string>>, z.ZodNull]>>;
+            buildTriggers: z.ZodOptional<z.ZodObject<{
+                schedule: z.ZodOptional<z.ZodObject<{
+                    enabled: z.ZodBoolean;
+                    cron: z.ZodOptional<z.ZodString>;
+                    timezone: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                push: z.ZodOptional<z.ZodObject<{
+                    enabled: z.ZodOptional<z.ZodBoolean>;
+                    debounceMinutes: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+            repositories: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                projectRepositoryId: z.ZodString;
+                position: z.ZodOptional<z.ZodNumber>;
+                inEnvironment: z.ZodOptional<z.ZodBoolean>;
+                setupCommand: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<string | null, string>>, z.ZodNull]>>;
+                teardownCommand: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodString, z.ZodTransform<string | null, string>>, z.ZodNull]>>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>;
+        readonly responseSchema: z.ZodObject<{
+            environment: z.ZodObject<{
+                sandbox: z.ZodObject<{
+                    provider: z.ZodString;
+                    settingsSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                    capabilities: z.ZodObject<{
+                        template: z.ZodBoolean;
+                        builds: z.ZodObject<{
+                            available: z.ZodBoolean;
+                            history: z.ZodBoolean;
+                        }, z.core.$strip>;
+                    }, z.core.$strip>;
+                }, z.core.$strip>;
+                settings: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                sandboxWorkingDirectory: z.ZodNullable<z.ZodString>;
+                workspaceSetupCommand: z.ZodNullable<z.ZodString>;
+                activeTemplateId: z.ZodNullable<z.ZodString>;
+                activeTemplateHeads: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>;
+                repositories: z.ZodArray<z.ZodObject<{
+                    projectRepositoryId: z.ZodString;
+                    connectionId: z.ZodString;
+                    repositoryId: z.ZodString;
+                    slug: z.ZodNullable<z.ZodString>;
+                    defaultBranch: z.ZodNullable<z.ZodString>;
+                    position: z.ZodNumber;
+                    inEnvironment: z.ZodBoolean;
+                    setupCommand: z.ZodNullable<z.ZodString>;
+                    teardownCommand: z.ZodNullable<z.ZodString>;
+                    lastBuildStatus: z.ZodEnum<{
+                        unbuilt: "unbuilt";
+                        configured: "configured";
+                        failed: "failed";
+                    }>;
+                    lastBuildError: z.ZodNullable<z.ZodString>;
+                    lastBuiltAt: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>>;
+                buildTriggers: z.ZodOptional<z.ZodObject<{
+                    schedule: z.ZodObject<{
+                        enabled: z.ZodBoolean;
+                        cron: z.ZodNullable<z.ZodString>;
+                        timezone: z.ZodNullable<z.ZodString>;
+                        scheduleAvailable: z.ZodBoolean;
+                    }, z.core.$strip>;
+                    push: z.ZodObject<{
+                        enabled: z.ZodBoolean;
+                        debounceMinutes: z.ZodNumber;
+                    }, z.core.$strip>;
+                }, z.core.$strip>>;
+                build: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    buildId: z.ZodString;
+                    attemptedAt: z.ZodNullable<z.ZodString>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+    };
+    readonly projectEnvironmentBuild: {
+        readonly method: "POST";
+        readonly path: "/web/factory/projects/:id/environment/build";
+        readonly description: "Build the sandbox environment template of a Factory project now";
+        readonly pathSchema: z.ZodObject<{
+            id: z.ZodString;
+        }, z.core.$strip>;
+        readonly responseSchema: 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>;
+        }, z.core.$strip>;
+    };
+    readonly projectEnvironmentBuilds: {
+        readonly method: "GET";
+        readonly path: "/web/factory/projects/:id/environment/builds";
+        readonly description: "List the environment template builds of a Factory project, newest first, when the provider keeps history";
+        readonly pathSchema: z.ZodObject<{
+            id: z.ZodString;
+        }, z.core.$strip>;
+        readonly responseSchema: z.ZodObject<{
+            builds: z.ZodArray<z.ZodObject<{
+                buildId: z.ZodString;
+                status: z.ZodEnum<{
+                    unknown: "unknown";
+                    failed: "failed";
+                    pending: "pending";
+                    ready: "ready";
+                    building: "building";
+                }>;
+                templateId: z.ZodOptional<z.ZodString>;
+                startedAt: z.ZodOptional<z.ZodString>;
+                finishedAt: z.ZodOptional<z.ZodString>;
+                error: z.ZodOptional<z.ZodString>;
+                logs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+    };
+    readonly projectEnvironmentBuildGet: {
+        readonly method: "GET";
+        readonly path: "/web/factory/projects/:id/environment/builds/:buildId";
+        readonly description: "Get the live status of one environment template build of a Factory project";
+        readonly pathSchema: z.ZodObject<{
+            id: z.ZodString;
+            buildId: z.ZodString;
+        }, z.core.$strip>;
+        readonly responseSchema: z.ZodObject<{
+            build: z.ZodObject<{
+                buildId: z.ZodString;
+                status: z.ZodEnum<{
+                    unknown: "unknown";
+                    failed: "failed";
+                    pending: "pending";
+                    ready: "ready";
+                    building: "building";
+                }>;
+                templateId: z.ZodOptional<z.ZodString>;
+                startedAt: z.ZodOptional<z.ZodString>;
+                finishedAt: z.ZodOptional<z.ZodString>;
+                error: z.ZodOptional<z.ZodString>;
+                logs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+    };
     readonly projectApplyDefaultModel: {
         readonly method: "POST";
         readonly path: "/web/factory/projects/:id/apply-default-model";
@@ -480,7 +864,7 @@ export declare const FACTORY_ROUTE_CONTRACTS: {
             id: z.ZodString;
         }, z.core.$strip>;
         readonly querySchema: z.ZodObject<{
-            statuses: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<("dismissed" | "retry" | "pending" | "proposed" | "superseded" | "leased" | "succeeded" | "failed")[] | undefined, string | undefined>>;
+            statuses: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<("dismissed" | "retry" | "failed" | "pending" | "proposed" | "superseded" | "leased" | "succeeded")[] | undefined, string | undefined>>;
             before: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<{
                 createdAt: Date;
                 id: string;

package/dist/routes/contracts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/routes/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;IACvB,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC;CAC3B,CAAC;AAEF,eAAO,MAAM,YAAY,kFAAkF,CAAC;AA8B5G,eAAO,MAAM,uBAAuB;;;iBAGlC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;iBAUoE,CAAC;AAiDzG,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;iBAQnC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;iBAUqE,CAAC;AAE3G,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;GAgB5B,CAAC;AAEN,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBASlC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;kBAQ9B,CAAC;AAEZ,eAAO,MAAM,kBAAkB;;;iBAG7B,CAAC;AA8CH,eAAO,MAAM,mBAAmB;;;;;;;iBAa9B,CAAC;AAWH,KAAK,uBAAuB,GAAG;IAAE,UAAU,EAAE,IAAI,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AA6ChE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;iBAS/B,CAAC;AAyBH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4PqB,CAAC;AAE1D,MAAM,MAAM,uBAAuB,GAAG,MAAM,OAAO,uBAAuB,CAAC"}
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/routes/contracts.ts"],"names":[],"mappings":"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"}

package/dist/routes/contracts.js

@@ -38,6 +38,135 @@ const updateProjectBodySchema = z.object({
 	autoRunEnabled: z.boolean().optional(),
 	autoApprovePlans: z.boolean().optional()
 }).refine((input) => Object.keys(input).length > 0, { message: "At least one project field is required" });
+const environmentRepositorySchema = z.object({
+	projectRepositoryId: z.string(),
+	connectionId: z.string(),
+	repositoryId: z.string(),
+	slug: z.string().nullable(),
+	defaultBranch: z.string().nullable(),
+	position: z.number().int(),
+	inEnvironment: z.boolean(),
+	setupCommand: z.string().nullable(),
+	teardownCommand: z.string().nullable(),
+	lastBuildStatus: z.enum([
+		"unbuilt",
+		"configured",
+		"failed"
+	]),
+	lastBuildError: z.string().nullable(),
+	lastBuiltAt: z.string().nullable()
+});
+/** The configured FactorySandbox as factory describes it: provider id, JSON Schema of its settings, capabilities. */
+const environmentSandboxSchema = z.object({
+	provider: z.string(),
+	settingsSchema: z.record(z.string(), z.unknown()),
+	capabilities: z.object({
+		template: z.boolean(),
+		builds: z.object({
+			available: z.boolean(),
+			history: z.boolean()
+		})
+	})
+});
+/** When the environment builds on its own; present only when the sandbox can build. */
+const environmentBuildTriggersSchema = z.object({
+	schedule: z.object({
+		enabled: z.boolean(),
+		cron: z.string().nullable(),
+		timezone: z.string().nullable(),
+		/** False when the host's storage has no schedules domain; the cron trigger cannot be enabled then. */
+		scheduleAvailable: z.boolean()
+	}),
+	push: z.object({
+		enabled: z.boolean(),
+		debounceMinutes: z.number().int()
+	})
+});
+/** The last build factory asked the provider for, from the project row only; status is read live. */
+const environmentLastBuildSchema = z.object({
+	buildId: z.string(),
+	attemptedAt: z.string().nullable()
+});
+const projectEnvironmentResponseSchema = z.object({ environment: z.object({
+	sandbox: environmentSandboxSchema,
+	/** The stored settings document; only keys the user set. */
+	settings: z.record(z.string(), z.unknown()),
+	sandboxWorkingDirectory: z.string().nullable(),
+	workspaceSetupCommand: z.string().nullable(),
+	activeTemplateId: z.string().nullable(),
+	activeTemplateHeads: z.record(z.string(), z.string()).nullable(),
+	repositories: z.array(environmentRepositorySchema),
+	buildTriggers: environmentBuildTriggersSchema.optional(),
+	build: environmentLastBuildSchema.nullable().optional()
+}) });
+const environmentBuildStatusSchema = z.enum([
+	"pending",
+	"building",
+	"ready",
+	"failed",
+	"unknown"
+]);
+const environmentBuildStartResponseSchema = z.object({
+	outcome: z.enum([
+		"started",
+		"skipped",
+		"unavailable",
+		"failed"
+	]),
+	buildId: z.string().optional(),
+	templateId: z.string().optional(),
+	reason: z.string().optional()
+});
+const environmentBuildSchema = z.object({
+	buildId: z.string(),
+	status: environmentBuildStatusSchema,
+	templateId: z.string().optional(),
+	startedAt: z.string().optional(),
+	finishedAt: z.string().optional(),
+	error: z.string().optional(),
+	logs: z.array(z.string()).optional()
+});
+const environmentBuildsResponseSchema = z.object({ builds: z.array(environmentBuildSchema) });
+const environmentBuildResponseSchema = z.object({ build: environmentBuildSchema });
+const buildPathSchema = projectPathSchema.extend({ buildId: z.string().min(1) });
+const environmentRepositoryPatchSchema = z.object({
+	projectRepositoryId: uuidSchema,
+	position: z.number().int().min(1).optional(),
+	inEnvironment: z.boolean().optional(),
+	setupCommand: nullableTrimmed(2e3).optional(),
+	teardownCommand: nullableTrimmed(2e3).optional()
+});
+const updateProjectEnvironmentBodySchema = z.object({
+	sandboxWorkingDirectory: nullableTrimmed(1e3).refine((value) => value === null || value.startsWith("/"), { message: "sandboxWorkingDirectory must be absolute" }).optional(),
+	/** Partial settings merged onto the stored document; null removes a key. Validated by the FactorySandbox. */
+	settings: z.record(z.string(), z.unknown().nullable()).optional(),
+	workspaceSetupCommand: nullableTrimmed(2e3).optional(),
+	/** Build triggers; only accepted when the sandbox can build. */
+	buildTriggers: z.object({
+		schedule: z.object({
+			enabled: z.boolean(),
+			cron: z.string().trim().min(1).max(100).optional(),
+			timezone: z.string().trim().min(1).max(100).optional()
+		}).optional(),
+		push: z.object({
+			enabled: z.boolean().optional(),
+			debounceMinutes: z.number().int().min(0).max(1440).optional()
+		}).optional()
+	}).optional(),
+	repositories: z.array(environmentRepositoryPatchSchema).max(100).superRefine((entries, ctx) => {
+		if (new Set(entries.map((entry) => entry.projectRepositoryId)).size !== entries.length) ctx.addIssue({
+			code: "custom",
+			message: "Each repository may be listed once"
+		});
+		const positions = entries.flatMap((entry) => entry.position === void 0 ? [] : [entry.position]);
+		if (positions.length === 0) return;
+		const expected = Array.from({ length: entries.length }, (_, index) => index + 1);
+		if (positions.length !== entries.length || [...positions].sort((a, b) => a - b).some((p, i) => p !== expected[i])) ctx.addIssue({
+			code: "custom",
+			message: "Positions must be a permutation of 1..n over the listed repositories"
+		});
+	}).optional()
+}).refine((input) => Object.keys(input).length > 0, { message: "At least one environment field is required" });
 const stagesSchema = z.array(z.string().max(64).regex(/^[a-z0-9][a-z0-9_-]*$/i)).min(1).max(16).refine((stages) => new Set(stages).size === stages.length, { message: "Stages must be unique" });
 const externalSourceSchema = z.object({
 	integrationId: z.string().min(1).max(128),
@@ -267,6 +396,42 @@ const FACTORY_ROUTE_CONTRACTS = {
 		bodySchema: updateProjectBodySchema,
 		responseSchema: projectResponseSchema
 	},
+	projectEnvironmentGet: {
+		method: "GET",
+		path: "/web/factory/projects/:id/environment",
+		description: "Get the sandbox environment of a Factory project: provider settings and its repositories in order",
+		pathSchema: projectPathSchema,
+		responseSchema: projectEnvironmentResponseSchema
+	},
+	projectEnvironmentUpdate: {
+		method: "PATCH",
+		path: "/web/factory/projects/:id/environment",
+		description: "Update the sandbox environment of a Factory project: provider settings, repository order and setup",
+		pathSchema: projectPathSchema,
+		bodySchema: updateProjectEnvironmentBodySchema,
+		responseSchema: projectEnvironmentResponseSchema
+	},
+	projectEnvironmentBuild: {
+		method: "POST",
+		path: "/web/factory/projects/:id/environment/build",
+		description: "Build the sandbox environment template of a Factory project now",
+		pathSchema: projectPathSchema,
+		responseSchema: environmentBuildStartResponseSchema
+	},
+	projectEnvironmentBuilds: {
+		method: "GET",
+		path: "/web/factory/projects/:id/environment/builds",
+		description: "List the environment template builds of a Factory project, newest first, when the provider keeps history",
+		pathSchema: projectPathSchema,
+		responseSchema: environmentBuildsResponseSchema
+	},
+	projectEnvironmentBuildGet: {
+		method: "GET",
+		path: "/web/factory/projects/:id/environment/builds/:buildId",
+		description: "Get the live status of one environment template build of a Factory project",
+		pathSchema: buildPathSchema,
+		responseSchema: environmentBuildResponseSchema
+	},
 	projectApplyDefaultModel: {
 		method: "POST",
 		path: "/web/factory/projects/:id/apply-default-model",
@@ -503,6 +668,6 @@ const FACTORY_ROUTE_CONTRACTS = {
 	}
 };
 //#endregion
-export { FACTORY_ROUTE_CONTRACTS, UUID_PATTERN, attentionQuerySchema, automationRunStartBodySchema, createProjectBodySchema, createWorkItemBodySchema, decisionQuerySchema, metricsQuerySchema, startWorkItemBodySchema, transitionBodySchema, updateProjectBodySchema, updateWorkItemBodySchema };
+export { FACTORY_ROUTE_CONTRACTS, UUID_PATTERN, attentionQuerySchema, automationRunStartBodySchema, createProjectBodySchema, createWorkItemBodySchema, decisionQuerySchema, environmentBuildResponseSchema, environmentBuildSchema, environmentBuildStartResponseSchema, environmentBuildTriggersSchema, environmentBuildsResponseSchema, environmentLastBuildSchema, environmentSandboxSchema, metricsQuerySchema, projectEnvironmentResponseSchema, startWorkItemBodySchema, transitionBodySchema, updateProjectBodySchema, updateProjectEnvironmentBodySchema, updateWorkItemBodySchema };
 
 //# sourceMappingURL=contracts.js.map