@powerlines/engine 0.49.13 → 0.49.15

package/dist/engine-DFKgU8-G.d.cts

@@ -0,0 +1,199 @@
+import { n as EngineOptions, t as EngineExecutionOptions } from "./config-DKEmqMrh.cjs";
+import { t as EngineContext } from "./context-D0_a0kRO.cjs";
+import { r as ExecutionApiWorkerInterface, t as Engine } from "./api-D1r7WAQA.cjs";
+import { t as PowerlinesEngineContext } from "./engine-context-B8K6Jtkk.cjs";
+import { BuildInlineConfig, CleanInlineConfig, CreateInlineConfig, DeployInlineConfig, DocsInlineConfig, InlineConfig, LintInlineConfig, Mode, PrepareInlineConfig, TestInlineConfig, TypesInlineConfig } from "@powerlines/core";
+
+//#region src/_internal/execution-api-worker.d.ts
+declare const RESTARTED: unique symbol;
+interface ExecutionApiWorkerOptions {
+  /**
+   * The maximum time in milliseconds a worker can run before being terminated.
+   *
+   * @defaultValue 900000 (15 minutes)
+   */
+  timeout?: number;
+  /**
+   * True if `--max-old-space-size` should not be forwarded to the worker.
+   */
+  isolatedMemory?: boolean;
+  /**
+   * The mode to run the worker in, which can affect how the worker is initialized and how it behaves. This is determined based on the resolved configuration of the engine, and can be used to optimize the worker for different environments (e.g., development, production, etc.).
+   */
+  mode?: Mode;
+  /**
+   * An optional root to resolve the execution host path from, which can be used to specify a custom root directory for the worker to use when resolving paths and loading configuration files. If this option is not provided, the worker will use the current working directory as the root directory by default.
+   */
+  root?: string;
+  /**
+   * The context of the {@link @powerlines/engine#Engine | Engine instance}, which can be used to access the engine's state and services within the worker.
+   */
+  context: EngineContext;
+}
+declare class ExecutionApiWorker implements ExecutionApiWorkerInterface {
+  #private;
+  protected executionApiPath: string;
+  protected options: ExecutionApiWorkerOptions;
+  protected get restartPromise(): Promise<typeof RESTARTED>;
+  protected resolveRestartPromise(): void;
+  /**
+   * Creates a new instance of the Execution API Worker class, which manages a worker process for executing tasks related to the Powerlines Engine. The worker is initialized with the specified options and can be used to run tasks in an isolated environment, with support for automatic restarts and activity monitoring.
+   *
+   * @param apiPath - The path to the Execution API file.
+   * @param options - The options for configuring the worker, including the execution context, exposed methods, timeout, and mode.
+   * @returns A promise that resolves to an instance of the ExecutionApiWorker class.
+   */
+  static from(apiPath: string, options: ExecutionApiWorkerOptions): Promise<ExecutionApiWorker>;
+  /**
+   * Create a new API worker instance.
+   *
+   * @param executionApiPath - The path to the worker file.
+   * @param options - The options for the worker, including exposed commands, timeout, and hooks for activity and restart.
+   */
+  protected constructor(executionApiPath: string, options: ExecutionApiWorkerOptions);
+  execute(command: string, options: EngineExecutionOptions, inlineConfig: InlineConfig): Promise<void>;
+  /**
+   * Closes the worker process, terminating it if it's still running. This method should be called when the worker is no longer needed, to free up system resources and ensure a clean shutdown. If the worker has already been terminated, this method will have no effect.
+   */
+  finalize(): Promise<void>;
+  protected onHanging(): void;
+  protected onActivity(): void;
+  protected innerExecute(command: string, options: EngineExecutionOptions, inlineConfig: InlineConfig): Promise<void>;
+}
+//#endregion
+//#region src/engine.d.ts
+/**
+ * The Powerlines process' orchestration and coordination API.
+ *
+ * @public
+ */
+declare class PowerlinesEngine implements Engine, AsyncDisposable {
+  #private;
+  /**
+   * The Powerlines context
+   */
+  get context(): EngineContext;
+  /**
+   * The execution host, which provides methods to call the execution API functions from the engine context. This allows the engine to invoke commands and other API functions during the execution of Powerlines commands, enabling communication between the engine and the execution contexts.
+   */
+  get api(): ExecutionApiWorker;
+  /**
+   * Create a new Powerlines Engine instance
+   *
+   * @param context - The Powerlines context
+   * @param api - The API host for the execution workers
+   * @returns A new instance of the Powerlines Engine
+   */
+  constructor(context: EngineContext, api: ExecutionApiWorker);
+  /**
+   * Create a new Powerlines project
+   *
+   * @remarks
+   * This method will create a new Powerlines project in the current directory.
+   *
+   * @param inlineConfig - The inline configuration for the create command
+   * @returns A promise that resolves when the project has been created
+   */
+  create(inlineConfig: CreateInlineConfig): Promise<void>;
+  /**
+   * Generate the Powerlines typescript declaration file
+   *
+   * @remarks
+   * This method will only generate the typescript declaration file for the Powerlines project. It is generally recommended to run the full `prepare` command, which will run this method as part of its process.
+   *
+   * @param inlineConfig - The inline configuration for the types command
+   */
+  types(inlineConfig: TypesInlineConfig): Promise<void>;
+  /**
+   * Prepare the Powerlines API
+   *
+   * @remarks
+   * This method will prepare the Powerlines API for use, initializing any necessary resources.
+   *
+   * @param inlineConfig - The inline configuration for the prepare command
+   */
+  prepare(inlineConfig: PrepareInlineConfig): Promise<void>;
+  /**
+   * Clean any previously prepared artifacts
+   *
+   * @remarks
+   * This method will remove the previous Powerlines artifacts from the project.
+   *
+   * @param inlineConfig - The inline configuration for the clean command
+   * @returns A promise that resolves when the clean command has completed
+   */
+  clean(inlineConfig: CleanInlineConfig): Promise<void>;
+  /**
+   * Lint the project
+   *
+   * @param inlineConfig - The inline configuration for the lint command
+   * @returns A promise that resolves when the lint command has completed
+   */
+  lint(inlineConfig: LintInlineConfig): Promise<void>;
+  /**
+   * Test the project
+   *
+   * @remarks
+   * This method will run the tests for the Powerlines project.
+   *
+   * @param inlineConfig - The inline configuration for the test command
+   * @returns A promise that resolves when the test command has completed
+   */
+  test(inlineConfig: TestInlineConfig): Promise<void>;
+  /**
+   * Build the project
+   *
+   * @remarks
+   * This method will build the Powerlines project, generating the necessary artifacts.
+   *
+   * @param inlineConfig - The inline configuration for the build command
+   * @returns A promise that resolves when the build command has completed
+   */
+  build(inlineConfig: BuildInlineConfig): Promise<void>;
+  /**
+   * Prepare the documentation for the project
+   *
+   * @param inlineConfig - The inline configuration for the docs command
+   * @returns A promise that resolves when the documentation generation has completed
+   */
+  docs(inlineConfig: DocsInlineConfig): Promise<void>;
+  /**
+   * Deploy the project source code
+   *
+   * @remarks
+   * This method will prepare and build the Powerlines project, generating the necessary artifacts for the deployment.
+   *
+   * @param inlineConfig - The inline configuration for the deploy command
+   * @returns A promise that resolves when the deploy command has completed
+   */
+  deploy(inlineConfig: DeployInlineConfig): Promise<void>;
+  /**
+   * Finalization/cleanup processing for the Powerlines API
+   *
+   * @remarks
+   * This step includes any final processes or clean up required by Powerlines. It will be run after each Powerlines command.
+   *
+   * @returns A promise that resolves when the finalization process has completed
+   */
+  finalize(): Promise<void>;
+  /**
+   * Asynchronous disposal method for the Powerlines Engine, which will call the finalize method to perform any necessary cleanup when the engine is disposed of.
+   */
+  [Symbol.asyncDispose](): Promise<void>;
+  /**
+   * Execute a Powerlines command based on the provided execution path and inline configuration, loading the necessary executions from the context and managing their lifecycle.
+   *
+   * @remarks
+   * This method will load the executions for the specified command and inline configuration, then execute each one while managing their lifecycle, including handling their completion and any errors that may occur during execution.
+   *
+   * @param command - The path to the execution configuration to load and run, which can be used to specify different execution configurations for different commands or scenarios.
+   * @param inlineConfig - Additional configuration options provided at runtime, which can override or supplement the options defined in the user configuration file.
+   * @returns A promise that resolves when all executions for the specified command have completed
+   */
+  protected execute(command: string, inlineConfig: InlineConfig): Promise<void>;
+}
+declare function createContext(options: EngineOptions): Promise<PowerlinesEngineContext<unknown>>;
+declare function createEngine(options: EngineOptions, apiPath?: string): Promise<PowerlinesEngine>;
+//#endregion
+export { createContext as n, createEngine as r, PowerlinesEngine as t };
+//# sourceMappingURL=engine-DFKgU8-G.d.cts.map

package/dist/engine-DFKgU8-G.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-DFKgU8-G.d.cts","names":[],"sources":["../src/_internal/execution-api-worker.ts","../src/engine.ts"],"mappings":";;;;;;;cAuCM,SAAA;AAAA,UA8DW,yBAAA;;AAhEgC;;;;EAgF/C,OAAA;EAhBe;;;EAqBf,cAAA;EALA;;;EAUA,IAAA,GAAO,IAAA;EAKP;;;EAAA,IAAA;EAKsB;AAGxB;;EAHE,OAAA,EAAS,aAAa;AAAA;AAAA,cAGX,kBAAA,YAA8B,2BAAA;EAAA;YAsF7B,gBAAA;EAAA,UACA,OAAA,EAAS,yBAAA;EAAA,cAxEP,cAAA,CAAA,GAAc,OAAA,QAAA,SAAA;EAAA,UASlB,qBAAA,CAAA;EA6WC;;;;;;;EAAA,OA9VS,IAAA,CAClB,OAAA,UACA,OAAA,EAAS,yBAAA,GAAyB,OAAA,CAAA,kBAAA;EAzCgC;;;;;;EAAA,UAqF3D,WAAA,CACG,gBAAA,UACA,OAAA,EAAS,yBAAA;EA4SR,OAAA,CACX,OAAA,UACA,OAAA,EAAS,sBAAA,EACT,YAAA,EAAc,YAAA,GAAY,OAAA;EAvXA;;;EA0Zf,QAAA,CAAA,GAAY,OAAA;EAAA,UAYf,SAAA,CAAA;EAAA,UAoBA,UAAA,CAAA;EAAA,UAUM,YAAA,CACd,OAAA,UACA,OAAA,EAAS,sBAAA,EACT,YAAA,EAAc,YAAA,GAAY,OAAA;AAAA;;;;;AA7jBmB;;;cCSpC,gBAAA,YAA4B,MAAA,EAAQ,eAAA;EAAA;EDuDhC;;;EAAA,ICzCJ,OAAA,CAAA,GAAW,aAAA;EDyDtB;;;EAAA,IClDW,GAAA,CAAA,GAAO,kBAAA;EDiElB;;;;AAKsB;AAGxB;;cC9DqB,OAAA,EAAS,aAAA,EAAe,GAAA,EAAK,kBAAA;EDqJ3B;;;;;;;;;ECvIR,MAAA,CAAO,YAAA,EAAc,kBAAA,GAAkB,OAAA;EDyd3B;;;;;;;;ECvcZ,KAAA,CAAM,YAAA,EAAc,iBAAA,GAAiB,OAAA;EDoHtC;;;;;;;;EClGC,OAAA,CAAQ,YAAA,EAAc,mBAAA,GAAmB,OAAA;EDqD3C;;;;;;;;;EClCE,KAAA,CAAM,YAAA,EAAc,iBAAA,GAAiB,OAAA;ED8XvC;;;;;;EC9WE,IAAA,CAAK,YAAA,EAAc,gBAAA,GAAgB,OAAA;ED8ZtC;;;;;;;;;EC3YG,IAAA,CAAK,YAAA,EAAc,gBAAA,GAAgB,OAAA;ED4apB;;;;ACpjB9B;;;;;EA2Je,KAAA,CAAM,YAAA,EAAc,iBAAA,GAAiB,OAAA;EA3HF;;;;;;EA2InC,IAAA,CAAK,YAAA,EAAc,gBAAA,GAAgB,OAAA;EAtEf;;;;;;;;;EAyFpB,MAAA,CAAO,YAAA,EAAc,kBAAA,GAAkB,OAAA;EAAlB;;;;;;;;EAkBrB,QAAA,CAAA,GAAQ,OAAA;EAhNyC;;;EAAA,CA6NhD,MAAA,CAAO,YAAA,KAAa,OAAA;;;;;;;;;;;YAclB,OAAA,CAAQ,OAAA,UAAiB,YAAA,EAAc,YAAA,GAAY,OAAA;AAAA;AAAA,iBA8B/C,aAAA,CAAc,OAAA,EAAS,aAAA,GAAa,OAAA,CAAA,uBAAA;AAAA,iBAuBpC,YAAA,CACpB,OAAA,EAAS,aAAA,EACT,OAAA,YAAkC,OAAA,CAAA,gBAAA"}

package/dist/{engine-CYesECu-.cjs → engine-DlOFwFgt.cjs}

@@ -2,9 +2,6 @@ const require_chunk = require('./chunk-C_NdSu1c.cjs');
 const require_helpers_stream = require('./helpers/stream.cjs');
 const require_context_engine_context = require('./context/engine-context.cjs');
 let _stryke_path_append = require("@stryke/path/append");
-let _stryke_convert_to_array = require("@stryke/convert/to-array");
-let _stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
-let _stryke_type_checks_is_function = require("@stryke/type-checks/is-function");
 let _stryke_type_checks_is_number = require("@stryke/type-checks/is-number");
 let _stryke_type_checks_is_set = require("@stryke/type-checks/is-set");
 let node_events = require("node:events");
@@ -19,13 +16,12 @@ let _stryke_fs_resolve = require("@stryke/fs/resolve");
 let _stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
 let _stryke_type_checks_is_string = require("@stryke/type-checks/is-string");
 let date_fns_formatDuration = require("date-fns/formatDuration");
-let jiti = require("jiti");
 let node_util = require("node:util");
 let node_worker_threads = require("node:worker_threads");
 let piscina = require("piscina");
 piscina = require_chunk.__toESM(piscina, 1);
 
-//#region src/_internal/execution-host-worker.ts
+//#region src/_internal/execution-api-worker.ts
 const RESTARTED = Symbol("powerlines-worker:restarted");
 /**
 * Formats the debug address into a string.
@@ -65,54 +61,57 @@ function getNodeDebugType(nodeOptions) {
 	if (nodeOptions.inspect) return "inspect";
 	if (nodeOptions["inspect-brk"] || nodeOptions.inspect_brk) return "inspect-brk";
 }
-var ExecutionHostWorker = class ExecutionHostWorker {
-	executionHostPath;
-	exposedMethods;
+var ExecutionApiWorker = class ExecutionApiWorker {
+	executionApiPath;
 	options;
 	#worker;
+	#logger;
+	#activeTasks = 0;
+	#restartPromise = null;
+	#resolveRestartPromise = null;
+	#hangingTimer = false;
+	#createWorker;
+	get restartPromise() {
+		if (!this.#restartPromise) this.#restartPromise = new Promise((resolve) => {
+			this.#resolveRestartPromise = resolve;
+		});
+		return this.#restartPromise;
+	}
+	resolveRestartPromise() {
+		if (this.#resolveRestartPromise) {
+			this.#resolveRestartPromise(RESTARTED);
+			this.#restartPromise = null;
+			this.#resolveRestartPromise = null;
+		}
+	}
 	/**
-	* Creates a new instance of the ExecutionHostWorker class, which manages a worker process for executing tasks related to the Powerlines Engine. The worker is initialized with the specified options and can be used to run tasks in an isolated environment, with support for automatic restarts and activity monitoring.
+	* Creates a new instance of the Execution API Worker class, which manages a worker process for executing tasks related to the Powerlines Engine. The worker is initialized with the specified options and can be used to run tasks in an isolated environment, with support for automatic restarts and activity monitoring.
 	*
-	* @param apiPath - The path to the Execution Host file.
+	* @param apiPath - The path to the Execution API file.
 	* @param options - The options for configuring the worker, including the execution context, exposed methods, timeout, and mode.
-	* @returns A promise that resolves to an instance of the ExecutionHostWorker class.
+	* @returns A promise that resolves to an instance of the ExecutionApiWorker class.
 	*/
 	static async from(apiPath, options) {
 		const mode = await (0, _powerlines_core_lib_config.getDefaultMode)(options.context.cwd);
 		const resolvedPath = await (0, _stryke_fs_resolve.resolve)(apiPath, { paths: [options.context.cwd, options.root ? (0, _stryke_path_append.appendPath)(options.root, options.context.cwd) : void 0].filter(Boolean) });
-		if (!resolvedPath) throw new Error(`Could not resolve the provided Execution Host path: \`${apiPath}\`.`);
-		let exposedMethods = (0, _stryke_convert_to_array.toArray)(options.apiMethods ?? []);
-		if (exposedMethods.length === 0) {
-			const jiti$1 = (0, jiti.createJiti)(require("url").pathToFileURL(__filename).href, {
-				cache: false,
-				interopDefault: true,
-				tsconfigPaths: true
-			});
-			const mod = await jiti$1.import(jiti$1.esmResolve(resolvedPath));
-			if ((0, _stryke_type_checks_is_function.isFunction)(mod)) exposedMethods.push(...exposedMethods, "default");
-			else if ((0, _stryke_type_checks_is_set_object.isSetObject)(mod)) exposedMethods = Object.keys(mod).filter((name) => (0, _stryke_type_checks_is_function.isFunction)(mod[name]));
-		}
-		return new ExecutionHostWorker(resolvedPath, exposedMethods, {
+		if (!resolvedPath) throw new Error(`Could not resolve the provided Execution API path: \`${apiPath}\`.`);
+		return new ExecutionApiWorker(resolvedPath, {
 			mode,
 			...options
 		});
 	}
 	/**
-	* Create a new worker instance.
+	* Create a new API worker instance.
 	*
-	* @param executionHostPath - The path to the worker file.
-	* @param exposedMethods - An array of method names that the worker exposes.
-	* @param options - The options for the worker, including exposed methods, timeout, and hooks for activity and restart.
+	* @param executionApiPath - The path to the worker file.
+	* @param options - The options for the worker, including exposed commands, timeout, and hooks for activity and restart.
 	*/
-	constructor(executionHostPath, exposedMethods, options) {
-		this.executionHostPath = executionHostPath;
-		this.exposedMethods = exposedMethods;
+	constructor(executionApiPath, options) {
+		this.executionApiPath = executionApiPath;
 		this.options = options;
-		const { timeout = 9e5, isolatedMemory = false, mode = "production", context } = this.options;
-		const logger = context.extendLogger({ category: "communication" });
-		let restartPromise;
-		let resolveRestartPromise;
-		let activeTasks = 0;
+		const { isolatedMemory = false, mode = "production", context } = this.options;
+		this.options.timeout ??= 9e5;
+		this.#logger = context.extendLogger({ category: "communication" });
 		this.#worker = void 0;
 		process.on("exit", () => {
 			this.finalize();
@@ -209,103 +208,64 @@ var ExecutionHostWorker = class ExecutionHostWorker {
 			].includes(key)) execArgv.push(formatted);
 			else nodeOptionsParts.push(formatted);
 		}
-		const onHanging = () => {
-			if (!this.#worker) return;
-			const resolve = resolveRestartPromise;
-			createWorker();
-			logger.warn(`Sending SIGTERM signal to worker due to timeout${timeout ? ` of ${(0, date_fns_formatDuration.formatDuration)({ seconds: timeout / 1e3 })}` : ""}. Subsequent errors may be a result of the worker exiting.`);
-			this.finalize().then(() => {
-				resolve(RESTARTED);
-			});
-		};
-		let hangingTimer = false;
-		const onActivity = () => {
-			if (hangingTimer) clearTimeout(hangingTimer);
-			hangingTimer = activeTasks > 0 && setTimeout(onHanging, timeout);
-		};
-		const createWorker = () => {
+		this.#createWorker = () => {
 			const env = {
 				...process.env,
 				NODE_ENV: mode,
 				NODE_OPTIONS: nodeOptionsParts.join(" "),
-				POWERLINES_EXECUTION_HOST_WORKER: "true"
+				POWERLINES_EXECUTION_WORKER: "true"
 			};
 			if (env.FORCE_COLOR === void 0 && !env.NO_COLOR && !env.CI && env.TERM !== "dumb" && (process.stdout.isTTY || process.stderr?.isTTY)) env.FORCE_COLOR = "1";
-			logger.debug(`Creating worker from file ${executionHostPath} with execution arguments: ${JSON.stringify(execArgv, null, 2)}`);
+			this.#logger.debug(`Creating worker from file ${executionApiPath} with execution arguments: ${JSON.stringify(execArgv, null, 2)}`);
 			this.#worker = new piscina.default({
-				filename: executionHostPath,
+				filename: executionApiPath,
 				execArgv,
 				env
 			});
-			restartPromise = new Promise((resolve) => {
-				resolveRestartPromise = resolve;
+			this.#restartPromise = new Promise((resolve) => {
+				this.#resolveRestartPromise = resolve;
 			});
 			this.#worker.on("exit", (code, signal) => {
-				logger.debug(`Worker process exited with code ${code} and signal ${signal}`);
+				this.#logger.debug(`Worker process exited with code ${code} and signal ${signal}`);
 				if ((code || signal && signal !== "SIGINT") && this.#worker) {
 					const error = /* @__PURE__ */ new Error(`Execution Host Worker exited unexpectedly with code ${code} and signal ${signal}`);
-					logger.error(error);
+					this.#logger.error(error);
 					this.finalize().then(() => {
 						throw error;
 					});
 				}
 			});
 			this.#worker.on("error", (error) => {
-				logger.error({
+				this.#logger.error({
 					meta: { category: "communication" },
 					message: `Worker process emitted an error: ${error.message}`,
 					error
 				});
 			});
 			this.#worker.on("message", (data) => {
-				onActivity();
-				if (Array.isArray(data) && data.length > 1 && (0, _stryke_type_checks_is_number.isNumber)(data[0])) if (data[0] === 0) logger.trace(`Received message from worker: ${JSON.stringify(data.slice(1), null, 2)}`);
-				else logger.debug(`Received error message from worker: ${JSON.stringify(data.slice(1), null, 2)}`);
-				logger.trace(`Received message from worker: ${JSON.stringify(data, null, 2)}`);
+				this.onActivity();
+				if (Array.isArray(data) && data.length > 1 && (0, _stryke_type_checks_is_number.isNumber)(data[0])) if (data[0] === 0) this.#logger.trace(`Received message from worker: ${JSON.stringify(data.slice(1), null, 2)}`);
+				else this.#logger.debug(`Received error message from worker: ${JSON.stringify(data.slice(1), null, 2)}`);
+				this.#logger.trace(`Received message from worker: ${JSON.stringify(data, null, 2)}`);
 			});
 		};
-		createWorker();
-		for (const method of this.exposedMethods) {
-			if (method.startsWith("_")) continue;
-			const callWorker = async (options, inlineConfig) => {
-				if (!this.#worker) throw new Error("Execution Host Worker is not initialized");
-				const { port1, port2 } = new node_worker_threads.MessageChannel();
-				const promise = this.#worker.run({
-					options,
-					inlineConfig,
-					port: port2
-				}, {
-					name: method,
-					transferList: [port2]
-				});
-				let aborted = false;
-				const onActivityAbort = () => {
-					if (!aborted) aborted = true;
-				};
-				(0, node_stream.pipeline)(new require_helpers_stream.MessagePortDuplex(port1, { onActivityAbort }), process.stdout, (err) => {
-					if (err) {
-						logger.debug(`Received exception message from worker: ${JSON.stringify(err, null, 2)}`);
-						throw err;
-					}
-				});
-				await promise;
-			};
-			this[method] = timeout ? async (options, inlineConfig) => {
-				activeTasks++;
-				try {
-					let attempts = 0;
-					for (;;) {
-						onActivity();
-						const result = await Promise.race([callWorker(options, inlineConfig), restartPromise]);
-						if (result !== RESTARTED) return result;
-						logger.warn(`Execution Host Worker was restarted while calling method "${method}" (attempt ${attempts++}). Retrying the call...`);
-					}
-				} finally {
-					activeTasks--;
-					onActivity();
+		this.#createWorker();
+	}
+	async execute(command, options, inlineConfig) {
+		if (this.options.timeout) {
+			this.#activeTasks++;
+			try {
+				let attempts = 0;
+				for (;;) {
+					this.onActivity();
+					if (await Promise.race([this.innerExecute(command, options, inlineConfig), this.#restartPromise]) !== RESTARTED) return;
+					this.#logger.warn(`Execution Host Worker was restarted while calling method "${command}" (attempt ${attempts++}). Retrying the call...`);
 				}
-			} : callWorker.bind(this);
-		}
+			} finally {
+				this.#activeTasks--;
+				this.onActivity();
+			}
+		} else await this.innerExecute(command, options, inlineConfig);
 	}
 	/**
 	* Closes the worker process, terminating it if it's still running. This method should be called when the worker is no longer needed, to free up system resources and ensure a clean shutdown. If the worker has already been terminated, this method will have no effect.
@@ -316,6 +276,39 @@ var ExecutionHostWorker = class ExecutionHostWorker {
 		await worker.close({ force: true });
 		this.#worker = void 0;
 	}
+	onHanging() {
+		if (!this.#worker) return;
+		this.#createWorker();
+		this.#logger.warn(`Sending SIGTERM signal to worker due to timeout${this.options.timeout ? ` of ${(0, date_fns_formatDuration.formatDuration)({ seconds: this.options.timeout / 1e3 })}` : ""}. Subsequent errors may be a result of the worker exiting.`);
+		this.finalize().then(() => {
+			this.#resolveRestartPromise?.(RESTARTED);
+		});
+	}
+	onActivity() {
+		if (this.#hangingTimer) clearTimeout(this.#hangingTimer);
+		this.#hangingTimer = this.#activeTasks > 0 && setTimeout(() => this.onHanging(), this.options.timeout);
+	}
+	async innerExecute(command, options, inlineConfig) {
+		if (!this.#worker) throw new Error("Execution Host Worker is not initialized");
+		const { port1, port2 } = new node_worker_threads.MessageChannel();
+		const promise = this.#worker.run({
+			command,
+			options,
+			inlineConfig,
+			port: port2
+		}, { transferList: [port2] });
+		let aborted = false;
+		const onActivityAbort = () => {
+			if (!aborted) aborted = true;
+		};
+		(0, node_stream.pipeline)(new require_helpers_stream.MessagePortDuplex(port1, { onActivityAbort }), process.stdout, (err) => {
+			if (err) {
+				this.#logger.debug(`Received exception message from worker: ${JSON.stringify(err, null, 2)}`);
+				throw err;
+			}
+		});
+		await promise;
+	}
 };
 
 //#endregion
@@ -333,7 +326,7 @@ var PowerlinesEngine = class {
 	/**
 	* The execution host, which provides methods to call the execution API functions from the engine context. This allows the engine to invoke commands and other API functions during the execution of Powerlines commands, enabling communication between the engine and the execution contexts.
 	*/
-	#host;
+	#api;
 	/**
 	* The Powerlines context
 	*/
@@ -343,19 +336,19 @@ var PowerlinesEngine = class {
 	/**
 	* The execution host, which provides methods to call the execution API functions from the engine context. This allows the engine to invoke commands and other API functions during the execution of Powerlines commands, enabling communication between the engine and the execution contexts.
 	*/
-	get host() {
-		return this.#host;
+	get api() {
+		return this.#api;
 	}
 	/**
 	* Create a new Powerlines Engine instance
 	*
 	* @param context - The Powerlines context
-	* @param host - The API host for the execution workers
+	* @param api - The API host for the execution workers
 	* @returns A new instance of the Powerlines Engine
 	*/
-	constructor(context, host) {
+	constructor(context, api) {
 		this.#context = context;
-		this.#host = host;
+		this.#api = api;
 	}
 	/**
 	* Create a new Powerlines project
@@ -504,7 +497,7 @@ var PowerlinesEngine = class {
 	async finalize() {
 		const timer = this.context.timer("Finalize");
 		this.context.info("🏁 Finalization processes started");
-		await this.host.finalize();
+		await this.api.finalize();
 		this.context.debug("✔ Finalization completed successfully");
 		timer();
 	}
@@ -520,16 +513,16 @@ var PowerlinesEngine = class {
 	* @remarks
 	* This method will load the executions for the specified command and inline configuration, then execute each one while managing their lifecycle, including handling their completion and any errors that may occur during execution.
 	*
-	* @param method - The path to the execution configuration to load and run, which can be used to specify different execution configurations for different commands or scenarios.
+	* @param command - The path to the execution configuration to load and run, which can be used to specify different execution configurations for different commands or scenarios.
 	* @param inlineConfig - Additional configuration options provided at runtime, which can override or supplement the options defined in the user configuration file.
 	* @returns A promise that resolves when all executions for the specified command have completed
 	*/
-	async execute(method, inlineConfig) {
-		await Promise.all((await this.context.loadExecutions(method, inlineConfig)).map(async (execution) => {
+	async execute(command, inlineConfig) {
+		await Promise.all((await this.context.loadExecutions(command, inlineConfig)).map(async (execution) => {
 			try {
-				await this.host[method](execution.options, inlineConfig);
+				await this.api.execute(command, execution.options, inlineConfig);
 			} catch (error) {
-				this.context.error(`Execution of method "${method}" failed for execution with invocation ID "${execution.invocationId}" and execution ID "${execution.options.executionId}": \n\n${error instanceof Error ? error.stack || error.message : String(error)}`);
+				this.context.error(`Execution of method "${command}" failed for execution with invocation ID "${execution.invocationId}" and execution ID "${execution.options.executionId}": \n\n${error instanceof Error ? error.stack || error.message : String(error)}`);
 				throw error;
 			} finally {
 				this.context.completeExecution(execution.invocationId, execution.options.executionId);
@@ -558,13 +551,12 @@ async function createContext(options) {
 		websocket: port
 	});
 }
-async function createEngine(options, apiPath = "@powerlines/engine/api", apiMethods) {
+async function createEngine(options, apiPath = "@powerlines/engine/api") {
 	node_events.EventEmitter.setMaxListeners(Infinity);
 	const context = await createContext(options);
-	return new PowerlinesEngine(context, await ExecutionHostWorker.from(apiPath, {
+	return new PowerlinesEngine(context, await ExecutionApiWorker.from(apiPath, {
 		root: options.root,
-		context,
-		apiMethods
+		context
 	}));
 }
 

package/dist/engine.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_engine = require('./engine-CYesECu-.cjs');
+const require_engine = require('./engine-DlOFwFgt.cjs');
 
 exports.PowerlinesEngine = require_engine.PowerlinesEngine;
 exports.createContext = require_engine.createContext;