@warlock.js/ai 4.2.11 → 4.4.0

package/esm/supervisor/execution.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"execution.d.mts","names":[],"sources":["../../../../../../../@warlock.js/ai/src/supervisor/execution.ts"],"mappings":"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"}
+{"version":3,"file":"execution.d.mts","names":[],"sources":["../../../../../../../@warlock.js/ai/src/supervisor/execution.ts"],"mappings":"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"}

package/esm/supervisor/execution.mjs

@@ -6,8 +6,9 @@ import { SupervisorCancelledError } from "../errors/supervisor-cancelled-error.m
 import "../errors/index.mjs";
 import { stampReportLineage } from "../utils/stamp-report-lineage.mjs";
 import "../utils/index.mjs";
-import { isAgentResult, isWorkflowResult } from "./entries.mjs";
+import { runPipeline } from "../middleware/pipeline.mjs";
 import { END } from "../contracts/end.type.mjs";
+import { isAgentResult, isWorkflowResult } from "./entries.mjs";
 import { createCancelledError } from "./cancellation.mjs";
 import { decide } from "./decide.mjs";
 import { persistSupervisorSnapshot } from "./snapshot.mjs";
@@ -46,6 +47,7 @@ const LOG_MODULE_BASE = "ai.supervisor";
 var SupervisorExecution = class {
 	constructor(params) {
 		this.logger = log;
+		this.middlewareState = /* @__PURE__ */ new Map();
 		this.snapshots = [];
 		this.childReports = [];
 		this.usage = {
@@ -73,6 +75,7 @@ var SupervisorExecution = class {
 		this.resumeFrom = params.resumeFrom;
 		this.maxIterations = params.config.maxIterations ?? DEFAULT_MAX_ITERATIONS;
 		this.logModule = `${LOG_MODULE_BASE}.${params.config.name}`;
+		this.middleware = params.config.middleware ?? [];
 		this.context = Object.freeze({ ...params.options?.context ?? {} });
 		this.history = Object.freeze([...params.options?.history ?? params.config.history ?? []]);
 		if (typeof params.config.goal === "string") this.goal = params.config.goal;
@@ -129,22 +132,19 @@ var SupervisorExecution = class {
 		return this.history.slice(-window);
 	}
 	/**
-	* Entry point. Drives the iteration loop, finalizes the result, and
-	* emits terminal events. Returns the uniform
-	* `{ data, report, usage, error }` shape and closes the stream if
-	* one was attached. Never throws.
+	* Entry point. Wraps the core run (`runCore`) in the
+	* `supervisor`-level middleware pipeline, then emits the terminal
+	* `supervisor.cancelled` / `supervisor.error` / `supervisor.completed`
+	* events and closes the stream (if any) with the post-pipeline result
+	* — so a middleware that short-circuits or transforms the final
+	* result still produces a well-formed public outcome. Returns the
+	* uniform `{ data, report, usage, error }` shape. Never throws.
 	*/
 	async run() {
-		this.emit("supervisor.starting", {
-			supervisorName: this.config.name,
-			input: this.input
-		});
-		this.logger.info(this.logModule, "starting", "supervisor starting", {
-			runId: this.runId,
-			maxIterations: this.maxIterations
-		});
+		const context = this.buildSupervisorContext();
+		let result;
 		try {
-			await this.runIterationLoop();
+			result = await runPipeline(this.middleware, "supervisor", context, () => this.runCore(), this.logger);
 		} catch (thrown) {
 			this.error = toAIError(thrown);
 			this.status = this.error instanceof SupervisorCancelledError ? "cancelled" : "failed";
@@ -154,8 +154,8 @@ var SupervisorExecution = class {
 				this.status = "max-iterations";
 				this.terminatedBy = "max-iterations";
 			}
+			result = await this.finalize();
 		}
-		const result = await this.finalize();
 		if (result.error) if (this.status === "cancelled") this.emit("supervisor.cancelled", {
 			cancelledAt: this.cancelledAtIso ?? (/* @__PURE__ */ new Date()).toISOString(),
 			reason: result.error.reason
@@ -172,6 +172,56 @@ var SupervisorExecution = class {
 		return result;
 	}
 	/**
+	* Build the `supervisor`-level middleware context — the stable
+	* identity of this run plus the per-run shared-state bag every hook
+	* sees. Constructed once per run, before the pipeline `before` hooks
+	* fire. Mirrors the agent's `buildExecuteContext`, one level up.
+	*/
+	buildSupervisorContext() {
+		return {
+			supervisor: {
+				name: this.config.name,
+				signature: this.signature
+			},
+			input: this.input,
+			options: this.options,
+			state: this.middlewareState,
+			signal: this.options?.signal
+		};
+	}
+	/**
+	* Inner body wrapped by the `supervisor`-level pipeline. Emits the
+	* `supervisor.starting` event, drives the iteration loop, absorbs
+	* every iteration-loop failure into `this.error` (so the run never
+	* throws from here), and returns the assembled `SupervisorResult`.
+	* `supervisor`-level `after` hooks receive this result, with `error`
+	* populated when the loop failed; `before` hooks can short-circuit
+	* before this ever runs.
+	*/
+	async runCore() {
+		this.emit("supervisor.starting", {
+			supervisorName: this.config.name,
+			input: this.input
+		});
+		this.logger.info(this.logModule, "starting", "supervisor starting", {
+			runId: this.runId,
+			maxIterations: this.maxIterations
+		});
+		try {
+			await this.runIterationLoop();
+		} catch (thrown) {
+			this.error = toAIError(thrown);
+			this.status = this.error instanceof SupervisorCancelledError ? "cancelled" : "failed";
+			this.terminatedBy = this.error instanceof SupervisorCancelledError ? "cancelled" : "error";
+			if (this.error instanceof SupervisorCancelledError) this.cancelledAtIso = this.error.cancelledAt;
+			if (this.error instanceof MaxIterationsError) {
+				this.status = "max-iterations";
+				this.terminatedBy = "max-iterations";
+			}
+		}
+		return this.finalize();
+	}
+	/**
 	* Drive the iteration loop until a terminal condition fires:
 	* `END` / `satisfied:true` / `maxIterations` / signal abort /
 	* routing error. Between-iteration cancellation is guaranteed —
@@ -1605,7 +1655,7 @@ var SupervisorExecution = class {
 			this.terminatedBy = "error";
 		}
 		const endedAt = /* @__PURE__ */ new Date();
-		const finalStatus = this.status === "max-iterations" ? "failed" : this.status;
+		const finalStatus = this.status === "max-iterations" || this.status === "awaiting-input" ? "failed" : this.status;
 		await this.checkpoint(finalStatus);
 		const report = {
 			runId: this.runId,