@mastra/docker 0.10.0 → 0.11.0-alpha.0

package/dist/index.d.ts

@@ -2,4 +2,6 @@ export { DockerSandbox, type DockerSandboxOptions, type DockerSandboxStartOption
 export { DockerProcessManager } from './sandbox/process-manager.js';
 export { dockerSandboxProvider } from './provider.js';
 export * from './template/index.js';
+export { DockerFactorySandbox } from './factory-sandbox.js';
+export type { DockerFactorySandboxOptions, DockerFactorySandboxSettings } from './factory-sandbox.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,GACxB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,GACxB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,YAAY,EAAE,2BAA2B,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 import { posix } from "path";
 import { isDeepStrictEqual, promisify } from "util";
-import { MastraSandbox, ProcessHandle, SandboxAbortError, SandboxError, SandboxNotReadyError, SandboxProcessManager, validateSandboxFileMode } from "@mastra/core/workspace";
+import { FactorySandbox, MastraSandbox, ProcessHandle, SandboxAbortError, SandboxError, SandboxNotReadyError, SandboxProcessManager, validateSandboxFileMode } from "@mastra/core/workspace";
 import Docker from "dockerode";
 import { pack } from "tar-stream";
 import { StringDecoder } from "string_decoder";
@@ -2487,6 +2487,118 @@ function shellQuote(value) {
 	return `'${value.replace(/'/g, `'\\''`)}'`;
 }
 //#endregion
-export { DockerProcessManager, DockerSandbox, DockerTemplate, TEMPLATE_IMAGE_REPO, createDockerRepoTemplate, dockerSandboxProvider, secretNames, synthesizeDockerfile, templateIdentity, templateImageTag };
+//#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 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
+export { DockerFactorySandbox, DockerProcessManager, DockerSandbox, DockerTemplate, TEMPLATE_IMAGE_REPO, createDockerRepoTemplate, dockerSandboxProvider, secretNames, synthesizeDockerfile, templateIdentity, templateImageTag };
 
 //# sourceMappingURL=index.js.map