@mastra/platform-workspace 1.7.0 → 1.8.0

package/dist/index.d.ts

@@ -4,6 +4,7 @@ export { Template, type AptInstallOptions, type JsonPrimitive, type JsonValue, t
 export { PlatformSandbox, SandboxExecTransportError, SandboxDestroyedError, type PlatformSandboxOptions, type PlatformSandboxNetworkIsolation, type PlatformSandboxTemplate, type SandboxAddressRegistry, type SandboxTemplatePending, } from './sandbox.js';
 export { createRepoTemplate, type PlatformRepoTemplateOptions, type PlatformRepoTemplateRepository, type PlatformRepoTemplateResolver, } from './repo-template.js';
 export { platformFilesystemProvider, platformSandboxProvider } from './provider.js';
+export { PlatformFactorySandbox, type PlatformFactorySandboxOptions, type PlatformFactorySandboxSettings, } from './factory-sandbox.js';
 export { execViaPrivateNetwork, PrivateNetExecHttpError, type PrivateNetExecOptions, type PrivateNetExecResult, type PrivateNetFetch, } from './private-net-exec.js';
 export { InProcessSandboxAddressRegistry } from './address-registry.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,cAAc,EACd,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,eAAe,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,KAAK,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AACrF,OAAO,EACL,QAAQ,EACR,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAC/B,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,GAC/B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,eAAe,EACf,yBAAyB,EACzB,qBAAqB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,+BAA+B,EACpC,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,GAC5B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,kBAAkB,EAClB,KAAK,2BAA2B,EAChC,KAAK,8BAA8B,EACnC,KAAK,4BAA4B,GAClC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACpF,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,eAAe,GACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,+BAA+B,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,eAAe,GACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,KAAK,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AACrF,OAAO,EACL,QAAQ,EACR,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAC/B,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,GAC/B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,eAAe,EACf,yBAAyB,EACzB,qBAAqB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,+BAA+B,EACpC,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,GAC5B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,kBAAkB,EAClB,KAAK,2BAA2B,EAChC,KAAK,8BAA8B,EACnC,KAAK,4BAA4B,GAClC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,0BAA0B,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACpF,OAAO,EACL,sBAAsB,EACtB,KAAK,6BAA6B,EAClC,KAAK,8BAA8B,GACpC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,eAAe,GACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,+BAA+B,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -1,9 +1,9 @@
 import { Buffer as Buffer$1 } from "buffer";
 import nodePath from "path";
-import { FileExistsError, FileNotFoundError, MastraFilesystem, MastraSandbox, ProcessHandle, SandboxError, SandboxNotReadyError, SandboxProcessManager, UnsupportedStdinCloseError, WorkspaceReadOnlyError } from "@mastra/core/workspace";
+import { FactorySandbox, FileExistsError, FileNotFoundError, MastraFilesystem, MastraSandbox, ProcessHandle, SandboxError, SandboxNotReadyError, SandboxProcessManager, UnsupportedStdinCloseError, WorkspaceReadOnlyError } from "@mastra/core/workspace";
+import { createHash } from "crypto";
 import { CommandExitError, Sandbox, TimeoutError } from "e2b";
 import { execFile } from "child_process";
-import { createHash } from "crypto";
 import { promisify } from "util";
 //#region src/client.ts
 const DEFAULT_PROXY_URL = "https://workspaces.mastra.ai";
@@ -1410,7 +1410,12 @@ var PlatformSandbox = class PlatformSandbox extends MastraSandbox {
 			sessionId: this._client.sessionId,
 			mode,
 			totalMs: Date.now() - startedAt,
-			requestMs
+			requestMs,
+			...mode === "provision" && this._templateDefinition ? {
+				templateHash: templateHash(this._templateDefinition),
+				templateBoot: this.templatePending ? "pending" : "exact",
+				...this.templatePending ? { pendingTemplateId: this.templatePending.templateId } : {}
+			} : {}
 		});
 	}
 	/**
@@ -1997,6 +2002,17 @@ var PlatformSandbox = class PlatformSandbox extends MastraSandbox {
 		return defaultInstructions;
 	}
 };
+/**
+* Diagnostic fingerprint of the serialized template a sandbox was provisioned
+* with: the same definition (repositories, pinned heads, setup commands,
+* resources) hashes the same on warm and cold boots. `family` is excluded, as
+* in the server's exact-content identity. Not the server's cache digest, which
+* also normalizes resources.
+*/
+function templateHash(definition) {
+	const { family: _family, ...content } = definition;
+	return createHash("sha256").update(JSON.stringify(content)).digest("hex").slice(0, 16);
+}
 //#endregion
 //#region ../../packages/_internals/workspace/dist/index.js
 /** Directory, relative to the template's build cwd, that holds every marker below. */
@@ -2450,6 +2466,157 @@ const platformFilesystemProvider = {
 	createFilesystem: (config) => new PlatformFilesystem(config)
 };
 //#endregion
+//#region src/factory-sandbox.ts
+/** Applied when neither the environment setting nor a host default is set. */
+const DEFAULT_SETTINGS = {
+	cpuCount: 2,
+	memoryMb: 1024,
+	idleTimeoutMinutes: 5
+};
+const SETTINGS_SCHEMA = {
+	type: "object",
+	properties: {
+		cpuCount: {
+			type: "integer",
+			title: "CPU",
+			description: "vCPUs for the sandbox template",
+			default: DEFAULT_SETTINGS.cpuCount,
+			minimum: 1,
+			maximum: 64
+		},
+		memoryMb: {
+			type: "integer",
+			title: "Memory (MB)",
+			description: "Memory in MB for the sandbox template",
+			default: DEFAULT_SETTINGS.memoryMb,
+			minimum: 512,
+			maximum: 65536
+		},
+		idleTimeoutMinutes: {
+			type: "integer",
+			title: "Idle timeout (minutes)",
+			description: "Minutes idle before the sandbox pauses",
+			default: DEFAULT_SETTINGS.idleTimeoutMinutes,
+			minimum: 1,
+			maximum: 1440
+		}
+	},
+	additionalProperties: false
+};
+/**
+* The settings schema with the provider's effective defaults as `default`:
+* the built-in values, overridden by the host's `idleTimeoutMinutes` option and
+* then its `defaults` option. The schema
+* is what clients show as placeholders, so it must match what the provider
+* applies when a setting is unset.
+*/
+function settingsSchema(defaults) {
+	const effective = {
+		...DEFAULT_SETTINGS,
+		...defaults
+	};
+	const properties = Object.fromEntries(Object.entries(SETTINGS_SCHEMA.properties).map(([key, property]) => [key, {
+		...property,
+		default: effective[key]
+	}]));
+	return {
+		...SETTINGS_SCHEMA,
+		properties
+	};
+}
+/**
+* The platform host contract for factory: every session sandbox is a
+* {@link PlatformSandbox} whose template is {@link createRepoTemplate} over
+* the session's repositories, sized by the factory's environment settings.
+*/
+var PlatformFactorySandbox = class extends FactorySandbox {
+	provider = "platform";
+	settings;
+	#options;
+	/**
+	* Builders by template id from this process's `builds.start` calls. Platform
+	* has no build status endpoint; re-calling the same builder's idempotent
+	* `build()` is the status poll. After a restart earlier builds read as
+	* `unknown`.
+	*
+	* TODO: once the platform API exposes build status and build history, read
+	* `get` from the API instead of this in-memory cache and add `builds.list`.
+	*/
+	#builders = /* @__PURE__ */ new Map();
+	builds = {
+		start: (ctx, settings) => this.#startBuild(ctx, settings),
+		get: (ctx, settings, buildId) => this.#getBuild(ctx, settings, buildId)
+	};
+	constructor(options = {}) {
+		super();
+		this.#options = options;
+		this.settings = settingsSchema({
+			...options.idleTimeoutMinutes !== void 0 ? { idleTimeoutMinutes: options.idleTimeoutMinutes } : {},
+			...options.defaults
+		});
+	}
+	template(ctx, settings) {
+		const { defaults, template } = this.#options;
+		return createRepoTemplate({
+			...ctx,
+			...template?.buildEnv ? { buildEnv: template.buildEnv } : {},
+			cpuCount: settings.cpuCount ?? defaults?.cpuCount ?? DEFAULT_SETTINGS.cpuCount,
+			memoryMB: settings.memoryMb ?? defaults?.memoryMb ?? DEFAULT_SETTINGS.memoryMb
+		});
+	}
+	create(ctx, settings) {
+		const { defaults, template: _template, ...options } = this.#options;
+		return new PlatformSandbox({
+			...options,
+			id: ctx.sessionId,
+			sessionId: ctx.sessionId,
+			sandboxId: ctx.sandboxId,
+			template: this.template(ctx, settings),
+			...ctx.workingDirectory ? { workingDirectory: ctx.workingDirectory } : {},
+			idleTimeoutMinutes: settings.idleTimeoutMinutes ?? defaults?.idleTimeoutMinutes ?? options.idleTimeoutMinutes ?? DEFAULT_SETTINGS.idleTimeoutMinutes
+		});
+	}
+	async #startBuild(ctx, settings) {
+		const builder = await this.#resolveBuilder(ctx, settings);
+		const result = await builder.build(this.#buildOptions());
+		this.#builders.set(result.templateId, builder);
+		return {
+			buildId: result.templateId,
+			templateId: result.templateId,
+			status: mapStatus(result.status)
+		};
+	}
+	async #getBuild(_ctx, _settings, buildId) {
+		const builder = this.#builders.get(buildId);
+		if (!builder) return {
+			buildId,
+			status: "unknown",
+			error: `Build ${buildId} was not started by this process; its status cannot be read.`
+		};
+		return toBuild(await builder.build(this.#buildOptions()));
+	}
+	async #resolveBuilder(ctx, settings) {
+		const builder = await this.template(ctx, settings)?.();
+		if (!builder) throw new Error("PlatformFactorySandbox.builds: the session context yields no template to build");
+		return builder;
+	}
+	#buildOptions() {
+		const { defaults: _defaults, template: _template, env: _env, ...options } = this.#options;
+		return options;
+	}
+};
+function mapStatus(status) {
+	return status;
+}
+function toBuild(result) {
+	return {
+		buildId: result.templateId,
+		templateId: result.templateId,
+		status: mapStatus(result.status),
+		...result.error ? { error: result.error } : {}
+	};
+}
+//#endregion
 //#region src/address-registry.ts
 /**
 * Concrete in-process {@link SandboxAddressRegistry}. Backed by a `Map`; no
@@ -2483,6 +2650,6 @@ var InProcessSandboxAddressRegistry = class {
 	}
 };
 //#endregion
-export { InProcessSandboxAddressRegistry, PlatformApiError, PlatformClient, PlatformFilesystem, PlatformSandbox, PrivateNetExecHttpError, SandboxDestroyedError, SandboxExecTransportError, Template, createRepoTemplate, execViaPrivateNetwork, platformFilesystemProvider, platformSandboxProvider };
+export { InProcessSandboxAddressRegistry, PlatformApiError, PlatformClient, PlatformFactorySandbox, PlatformFilesystem, PlatformSandbox, PrivateNetExecHttpError, SandboxDestroyedError, SandboxExecTransportError, Template, createRepoTemplate, execViaPrivateNetwork, platformFilesystemProvider, platformSandboxProvider };
 
 //# sourceMappingURL=index.js.map