@mastra/docker 0.10.0 → 0.11.0-alpha.0

package/dist/factory-sandbox.d.ts

@@ -0,0 +1,35 @@
+import type { PublicSchema } from '@mastra/core/schema';
+import { FactorySandbox } from '@mastra/core/workspace';
+import type { FactorySandboxBuilds, FactorySandboxContext } from '@mastra/core/workspace';
+import { DockerSandbox } from './sandbox/index.js';
+import type { DockerSandboxOptions } from './sandbox/index.js';
+import type { DockerRepoTemplateOptions, DockerRepoTemplateResolver } from './template/repo-template.js';
+/** User-tunable settings of a Docker factory sandbox. Every field is optional; absent means the provider default. */
+export interface DockerFactorySandboxSettings extends Record<string, unknown> {
+    /** Base image of the environment template. Part of the template identity. */
+    baseImage?: string;
+    /** `user[:group]` or `uid[:gid]` that owns the checkout. Part of the template identity. */
+    owner?: string;
+}
+export interface DockerFactorySandboxOptions extends Omit<DockerSandboxOptions, 'id' | 'template'> {
+    /** Options for the environment's repo template. */
+    template?: Pick<DockerRepoTemplateOptions, 'buildEnv' | 'dockerOptions'>;
+    /** Provider-side defaults used when a setting is unset. Never stored by factory. */
+    defaults?: Partial<DockerFactorySandboxSettings>;
+}
+/**
+ * The Docker host contract for factory: every session sandbox is a
+ * {@link DockerSandbox} whose template is {@link createDockerRepoTemplate}
+ * over the session's repositories, built from the factory's environment
+ * settings.
+ */
+export declare class DockerFactorySandbox extends FactorySandbox<DockerFactorySandboxSettings> {
+    #private;
+    readonly provider = "docker";
+    readonly settings: PublicSchema<DockerFactorySandboxSettings>;
+    readonly builds: FactorySandboxBuilds<DockerFactorySandboxSettings>;
+    constructor(options?: DockerFactorySandboxOptions);
+    template(ctx: FactorySandboxContext, settings: DockerFactorySandboxSettings): DockerRepoTemplateResolver | undefined;
+    create(ctx: FactorySandboxContext, settings: DockerFactorySandboxSettings): DockerSandbox;
+}
+//# sourceMappingURL=factory-sandbox.d.ts.map

package/dist/factory-sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory-sandbox.d.ts","sourceRoot":"","sources":["../src/factory-sandbox.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAGV,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAEtD,OAAO,KAAK,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAStG,qHAAqH;AACrH,MAAM,WAAW,4BAA6B,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC3E,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2FAA2F;IAC3F,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAqBD,MAAM,WAAW,2BAA4B,SAAQ,IAAI,CAAC,oBAAoB,EAAE,IAAI,GAAG,UAAU,CAAC;IAChG,mDAAmD;IACnD,QAAQ,CAAC,EAAE,IAAI,CAAC,yBAAyB,EAAE,UAAU,GAAG,eAAe,CAAC,CAAC;IACzE,oFAAoF;IACpF,QAAQ,CAAC,EAAE,OAAO,CAAC,4BAA4B,CAAC,CAAC;CAClD;AAED;;;;;GAKG;AACH,qBAAa,oBAAqB,SAAQ,cAAc,CAAC,4BAA4B,CAAC;;IACpF,QAAQ,CAAC,QAAQ,YAAY;IAC7B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC,4BAA4B,CAAC,CAAmB;IAWhF,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC,4BAA4B,CAAC,CAGjE;IAEF,YAAY,OAAO,GAAE,2BAAgC,EAGpD;IAED,QAAQ,CAAC,GAAG,EAAE,qBAAqB,EAAE,QAAQ,EAAE,4BAA4B,GAAG,0BAA0B,GAAG,SAAS,CAwBnH;IA2CD,MAAM,CAAC,GAAG,EAAE,qBAAqB,EAAE,QAAQ,EAAE,4BAA4B,GAAG,aAAa,CAYxF;CACF"}

package/dist/index.cjs

@@ -2512,6 +2512,119 @@ function shellQuote(value) {
 	return `'${value.replace(/'/g, `'\\''`)}'`;
 }
 //#endregion
+//#region src/factory-sandbox.ts
+const SETTINGS_SCHEMA = {
+	type: "object",
+	properties: {
+		baseImage: {
+			type: "string",
+			title: "Base image",
+			description: "Docker image the environment template builds from (default node:22-slim)",
+			minLength: 1
+		},
+		owner: {
+			type: "string",
+			title: "Owner",
+			description: "user[:group] or uid[:gid] that owns the repositories in the image (default root)",
+			pattern: "^[\\w.-]+(:[\\w.-]+)?$"
+		}
+	},
+	additionalProperties: false
+};
+/**
+* The Docker host contract for factory: every session sandbox is a
+* {@link DockerSandbox} whose template is {@link createDockerRepoTemplate}
+* over the session's repositories, built from the factory's environment
+* settings.
+*/
+var DockerFactorySandbox = class extends _mastra_core_workspace.FactorySandbox {
+	provider = "docker";
+	settings = SETTINGS_SCHEMA;
+	#options;
+	/**
+	* Image builds started by this process, keyed by image tag. Docker builds
+	* locally, so a build only exists while the daemon runs it; after a host
+	* restart `get` answers `unknown` for ids it does not hold.
+	*/
+	#builds = /* @__PURE__ */ new Map();
+	builds = {
+		start: (ctx, settings) => this.#startBuild(ctx, settings),
+		get: (_ctx, _settings, buildId) => Promise.resolve(this.#getBuild(buildId))
+	};
+	constructor(options = {}) {
+		super();
+		this.#options = options;
+	}
+	template(ctx, settings) {
+		const { defaults, template, image, workingDirectory, workingDir, dockerOptions } = this.#options;
+		const baseImage = settings.baseImage ?? defaults?.baseImage ?? image;
+		const templateWorkingDirectory = ctx.workingDirectory ?? workingDirectory ?? workingDir;
+		const owner = settings.owner ?? defaults?.owner;
+		const { resolveHead: _resolveHead, sessionId: _sessionId, sandboxId: _sandboxId, repoFullName: _name, ...rest } = ctx;
+		return createDockerRepoTemplate({
+			...rest,
+			...dockerOptions !== void 0 ? { dockerOptions } : {},
+			...template,
+			...baseImage !== void 0 ? { baseImage } : {},
+			...owner !== void 0 ? { owner } : {},
+			...templateWorkingDirectory !== void 0 ? { workingDirectory: templateWorkingDirectory } : {}
+		});
+	}
+	async #startBuild(ctx, settings) {
+		const template = await this.template(ctx, settings)?.();
+		if (!template) throw new Error("DockerFactorySandbox.builds: the session context yields no template to build");
+		const buildId = template.templateId;
+		const running = this.#builds.get(buildId);
+		if (running && !running.result) return {
+			buildId,
+			templateId: buildId,
+			status: "building"
+		};
+		const build = { startedAt: (/* @__PURE__ */ new Date()).toISOString() };
+		this.#builds.set(buildId, build);
+		template.build().then((result) => result, (error) => ({
+			status: "failed",
+			templateId: buildId,
+			error: error instanceof Error ? error.message : String(error)
+		})).then((result) => {
+			build.result = result;
+			build.finishedAt = (/* @__PURE__ */ new Date()).toISOString();
+		});
+		return {
+			buildId,
+			templateId: buildId,
+			status: "building"
+		};
+	}
+	#getBuild(buildId) {
+		const build = this.#builds.get(buildId);
+		if (!build) return {
+			buildId,
+			status: "unknown"
+		};
+		return {
+			buildId,
+			templateId: buildId,
+			status: build.result?.status ?? "building",
+			startedAt: build.startedAt,
+			...build.finishedAt ? { finishedAt: build.finishedAt } : {},
+			...build.result?.error ? { error: build.result.error } : {}
+		};
+	}
+	create(ctx, settings) {
+		const { defaults: _defaults, template: _template, image, ...options } = this.#options;
+		const template = this.template(ctx, settings);
+		return new DockerSandbox({
+			...options,
+			...template === void 0 && image !== void 0 ? { image } : {},
+			id: ctx.sessionId,
+			template,
+			...ctx.workingDirectory ? { workingDirectory: ctx.workingDirectory } : {}
+		});
+	}
+};
+//#endregion
+exports.DockerFactorySandbox = DockerFactorySandbox;
 exports.DockerProcessManager = DockerProcessManager;
 exports.DockerSandbox = DockerSandbox;
 exports.DockerTemplate = DockerTemplate;