@mastra/temporal 0.3.5 → 0.4.0-alpha.1

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # @mastra/temporal
 
+## 0.4.0-alpha.1
+
+### Minor Changes
+
+- Improved Temporal worker setup so `MastraPlugin` compiles the Mastra entry file automatically when the worker is configured. ([#22438](https://github.com/mastra-ai/mastra/pull/22438))
+
+  Before:
+
+  ```ts
+  const plugin = new MastraPlugin();
+  await plugin.prebuild({ entryFile: import.meta.resolve('./mastra/index.ts') });
+  ```
+
+  After:
+
+  ```ts
+  const plugin = new MastraPlugin(import.meta.resolve('./mastra/index.ts'));
+  ```
+
+### Patch Changes
+
+- Updated dependencies [[`078affd`](https://github.com/mastra-ai/mastra/commit/078affdaea57ac5e95a77e9e7b197d1878190684), [`9e3403e`](https://github.com/mastra-ai/mastra/commit/9e3403e9868240cb18841898e84cf008ebd7a87e), [`791bf5e`](https://github.com/mastra-ai/mastra/commit/791bf5e81cd27e2e1cff66122f1380ab8a3dda41)]:
+  - @mastra/core@1.63.1-alpha.1
+  - @mastra/deployer@1.63.1-alpha.1
+
+## 0.3.6-alpha.0
+
+### Patch Changes
+
+- Updated dependencies [[`bae1502`](https://github.com/mastra-ai/mastra/commit/bae150254b06a4da6964d7c137af97f336362359)]:
+  - @mastra/core@1.63.1-alpha.0
+  - @mastra/deployer@1.63.1-alpha.0
+
 ## 0.3.5
 
 ### Patch Changes

package/LICENSE.md

@@ -1,10 +1,12 @@
 Portions of this software are licensed as follows:
 
-- All content that resides under any directory named "ee/" within this
+- All content that resides under any directory named `ee/` within this
   repository, including but not limited to:
-  - `packages/core/src/auth/ee/`
-  - `packages/server/src/server/auth/ee/`
-    is licensed under the license defined in `ee/LICENSE`.
+  - `@mastra/core/auth/ee`
+  - `@mastra/core/agent-builder/ee`
+  - `@mastra/editor/ee`
+
+  is licensed under the license defined in [`ee/LICENSE`](https://github.com/mastra-ai/mastra/blob/main/ee/LICENSE).
 
 - All third-party components incorporated into the Mastra Software are
   licensed under the original license provided by the owner of the

package/README.md

@@ -62,7 +62,7 @@ export const mastra = new Mastra({
 
 ## Start a Temporal worker
 
-Create a worker, install `MastraPlugin`, and call `await plugin.init()` before `Worker.create()`. Use the Mastra entry file as `src`.
+Create a worker and pass the Mastra entry file to `MastraPlugin`.
 
 ```ts
 import { NativeConnection, Worker } from '@temporalio/worker';
@@ -72,11 +72,7 @@ const connection = await NativeConnection.connect({
   address: 'localhost:7233',
 });
 
-const plugin = new MastraPlugin({
-  src: import.meta.resolve('./mastra/index.ts'),
-});
-
-await plugin.init();
+const plugin = new MastraPlugin(import.meta.resolve('./mastra/index.ts'));
 
 const worker = await Worker.create({
   connection,
@@ -91,16 +87,14 @@ await worker.run();
 ## How it works
 
 - `init({ client, taskQueue })`: Returns `createWorkflow()` and `createStep()` helpers for Temporal-backed Mastra workflows.
-- `MastraPlugin({ src })`: Point it at the Mastra entry file that registers workflows.
-- `await plugin.init()`: Precompiles the Mastra app into `node_modules/.mastra/output/index.mjs`, then generates `node_modules/.mastra/workflow.mjs` for workflow bundling and `node_modules/.mastra/activities.mjs` for activity execution before the Temporal worker starts.
+- `MastraPlugin(entryFile)`: Points the plugin at the Mastra entry file that registers workflows and compiles it when the worker is configured.
 - Generated activities: The plugin extracts `createStep()` handlers into `node_modules/.mastra/activities.mjs` and wires them into the worker automatically.
 - `debug: true`: Writes emitted workflow bundles to `node_modules/.mastra` for inspection.
 
 ## Notes
 
 - Workflow ids must be statically defined so the transformer can derive Temporal export names.
-- The plugin expects `src` to point to the Mastra entry file that registers workflows in `new Mastra({ workflows: ... })`.
-- Call `await plugin.init()` before `Worker.create()` so the compiled workflow entry is ready when Temporal configures the worker and bundler.
+- The plugin expects `entryFile` to point to the Mastra entry file that registers workflows in `new Mastra({ workflows: ... })`.
 
 ## License
 

package/dist/plugin.d.ts

@@ -1,8 +1,13 @@
 import type { WorkerOptions, WorkerPlugin } from '@temporalio/worker';
 export declare class MastraPlugin implements WorkerPlugin {
     #private;
+    private readonly entryFile;
+    private readonly projectRoot;
     name: string;
-    constructor();
+    constructor(entryFile: string, projectRoot?: string);
+    /**
+     * @deprecated Please use the constructor params instead.
+     */
     prebuild({ entryFile, projectRoot, }: {
         entryFile: string;
         projectRoot?: string;
@@ -11,6 +16,6 @@ export declare class MastraPlugin implements WorkerPlugin {
         workflowsPath: WorkerOptions['workflowsPath'];
         activities: WorkerOptions['activities'];
     };
-    configureWorker(options: WorkerOptions): WorkerOptions;
+    configureWorker(options: WorkerOptions): Promise<WorkerOptions>;
 }
 //# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAsBtE,qBAAa,YAAa,YAAW,YAAY;;IAG/C,IAAI,SAAY;;IAiBV,QAAQ,CAAC,EACb,SAAS,EACT,WAA2B,GAC5B,EAAE;QACD,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,IAAI,CAAC,wBAAwB,CAAC,CAAC;IAoE7D,wBAAwB,CAAC,iBAAiB,EAAE,MAAM,GAAG;QAEnD,aAAa,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;QAC9C,UAAU,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;KACzC;IAeD,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa;CAYvD"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAsBtE,qBAAa,YAAa,YAAW,YAAY;;IAO7C,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAJ9B,IAAI,SAAY;gBAGG,SAAS,EAAE,MAAM,EACjB,WAAW,GAAE,MAAsB;IAgBtD;;OAEG;IACG,QAAQ,CAAC,EACb,SAAS,EACT,WAA2B,GAC5B,EAAE;QACD,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,IAAI,CAAC,wBAAwB,CAAC,CAAC;IAwE7D,wBAAwB,CAAC,iBAAiB,EAAE,MAAM,GAAG;QAEnD,aAAa,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;QAC9C,UAAU,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;KACzC;IAeK,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;CAoBtE"}

package/dist/worker.cjs

@@ -990,10 +990,16 @@ function getActivityBindingsPath(outputDir) {
 	return path.default.join(outputDir, ACTIVITY_BINDINGS_FILE_NAME);
 }
 var MastraPlugin = class {
+	entryFile;
+	projectRoot;
 	#prebuildPath = null;
+	#prebuildPromise = null;
 	#compiledActivitiesModules = /* @__PURE__ */ new Map();
 	name = "Mastra";
-	constructor() {}
+	constructor(entryFile, projectRoot = process.cwd()) {
+		this.entryFile = entryFile;
+		this.projectRoot = projectRoot;
+	}
 	async #bundleMastra(entryFile, projectRoot, outputDirectory) {
 		const { BuildBundler } = await Promise.resolve().then(() => require("./mastra-deployer-D6fHvmFM.cjs"));
 		const normalizedEntryFile = entryFile.startsWith("file:/") ? (0, url.fileURLToPath)(entryFile) : entryFile;
@@ -1005,7 +1011,13 @@ var MastraPlugin = class {
 		});
 		return path.default.join(outputDirectory, "output", "index.mjs");
 	}
+	/**
+	* @deprecated Please use the constructor params instead.
+	*/
 	async prebuild({ entryFile, projectRoot = process.cwd() }) {
+		return this.#prebuild(entryFile, projectRoot);
+	}
+	async #prebuild(entryFile, projectRoot) {
 		const temporalOutputDir = path.default.resolve(projectRoot, CACHE_PATH);
 		const compiledEntryPath = await this.#bundleMastra(entryFile, projectRoot, temporalOutputDir);
 		await buildTemporalWorkflowModule(compiledEntryPath, temporalOutputDir, WORKFLOW_FILE_NAME);
@@ -1049,10 +1061,20 @@ var MastraPlugin = class {
 			activities: this.#generateActivityBindings(activityBindings, activitiesOutputPath)
 		};
 	}
-	configureWorker(options) {
+	async configureWorker(options) {
 		const augmentedOptions = Object.assign({}, options);
-		if (this.#prebuildPath) Object.assign(augmentedOptions, this.getTemporalWorkerOptions(this.#prebuildPath));
-		else if (!options.workflowsPath || !options.activities) throw new Error("MastraPlugin.prebuild() must be called before use");
+		if (!this.#prebuildPath) {
+			this.#prebuildPromise ??= this.#prebuild(this.entryFile, this.projectRoot).catch((error) => {
+				this.#prebuildPromise = null;
+				throw error;
+			});
+			await this.#prebuildPromise;
+		}
+		const generatedOptions = this.getTemporalWorkerOptions(this.#prebuildPath);
+		Object.assign(augmentedOptions, generatedOptions, { activities: {
+			...options.activities,
+			...generatedOptions.activities
+		} });
 		return augmentedOptions;
 	}
 };