@warlock.js/core 4.8.0 → 4.8.2

package/esm/ai/src/workflow/snapshot.mjs

@@ -1,77 +0,0 @@
-import { WorkflowError } from "../errors/workflow-error.mjs";
-import { WorkflowDriftError } from "../errors/workflow-drift-error.mjs";
-import "../errors/index.mjs";
-import { resolveDefaultSnapshotStore } from "../config.mjs";
-
-//#region ../@warlock.js/ai/src/workflow/snapshot.ts
-/**
-* Resolve the effective {@link SnapshotStore}: the workflow's own
-* `snapshotStore` field wins; absent that, fall back to the global
-* default set via `ai.config({ defaultSnapshotStore })`.
-*
-* The global default is typed for the supervisor snapshot shape, but
-* every store impl keys purely by `runId` and round-trips whatever
-* envelope it is handed — so it serves a `WorkflowSnapshot` just as
-* well. The cast re-tags the shape at this single boundary; the
-* workflow only ever hands it a `WorkflowSnapshot`.
-*/
-function resolveSnapshotStore(definition) {
-	return definition.snapshotStore ?? resolveDefaultSnapshotStore();
-}
-/**
-* Write the current run's state to the configured `KVStore`. Returns
-* an outcome object instead of throwing so the engine can surface
-* persistence failures via events + logs without aborting the run.
-* Callers decide whether a failed checkpoint is fatal.
-*
-* No-op (returns `{ ok: true }`) when the workflow has no store
-* configured — the common in-memory test case.
-*/
-async function persistSnapshot(params) {
-	const store = resolveSnapshotStore(params.definition);
-	if (!store) return { ok: true };
-	const snapshot = {
-		runId: params.runId,
-		workflowName: params.definition.name,
-		signature: params.signature,
-		version: params.definition.version,
-		input: params.input,
-		state: { ...params.state },
-		steps: { ...params.steps },
-		next: params.next,
-		status: params.status,
-		startedAt: params.startedAt,
-		savedAt: (/* @__PURE__ */ new Date()).toISOString()
-	};
-	try {
-		await store.save(snapshot);
-		return { ok: true };
-	} catch (err) {
-		return {
-			ok: false,
-			error: err
-		};
-	}
-}
-/**
-* Load a prior run's snapshot from the store and run the drift
-* check. Throws `WorkflowError` when no snapshot exists, and
-* `WorkflowDriftError` when the stored signature doesn't match the
-* current definition (unless `force` is set).
-*/
-async function loadSnapshotForResume(params) {
-	const store = resolveSnapshotStore(params.definition);
-	if (!store) throw new WorkflowError(`workflow "${params.definition.name}" has no store configured — set \`snapshotStore\` on the definition or call \`ai.config({ defaultSnapshotStore })\` at boot before calling resume()`);
-	const snap = await store.load(params.runId) ?? null;
-	if (!snap) throw new WorkflowError(`workflow "${params.definition.name}": no snapshot for runId "${params.runId}"`);
-	if (!params.options?.force && snap.signature !== params.signature) throw new WorkflowDriftError(`workflow "${params.definition.name}" signature drift on resume`, {
-		savedSignature: snap.signature,
-		currentSignature: params.signature,
-		runId: params.runId
-	});
-	return snap;
-}
-
-//#endregion
-export { loadSnapshotForResume, persistSnapshot };
-//# sourceMappingURL=snapshot.mjs.map

package/esm/ai/src/workflow/snapshot.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"snapshot.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/ai/src/workflow/snapshot.ts"],"sourcesContent":["import { resolveDefaultSnapshotStore } from \"../config\";\nimport type { SnapshotStore } from \"../contracts/orchestrator/snapshot-store.contract\";\nimport type { StepSnapshot } from \"../contracts/result/step-result.type\";\nimport type { WorkflowSnapshot } from \"../contracts/workflow/workflow-snapshot.type\";\nimport type {\n  WorkflowDefinition,\n  WorkflowResumeOptions,\n} from \"../contracts/workflow/workflow.contract\";\nimport { WorkflowDriftError, WorkflowError } from \"../errors\";\n\n/**\n * Resolve the effective {@link SnapshotStore}: the workflow's own\n * `snapshotStore` field wins; absent that, fall back to the global\n * default set via `ai.config({ defaultSnapshotStore })`.\n *\n * The global default is typed for the supervisor snapshot shape, but\n * every store impl keys purely by `runId` and round-trips whatever\n * envelope it is handed — so it serves a `WorkflowSnapshot` just as\n * well. The cast re-tags the shape at this single boundary; the\n * workflow only ever hands it a `WorkflowSnapshot`.\n */\nfunction resolveSnapshotStore<T>(\n  definition: WorkflowDefinition<any, T, any, any>,\n): SnapshotStore<WorkflowSnapshot> | undefined {\n  return (\n    definition.snapshotStore ??\n    (resolveDefaultSnapshotStore() as SnapshotStore<WorkflowSnapshot> | undefined)\n  );\n}\n\nexport type PersistParams<T> = {\n  definition: WorkflowDefinition<any, T, any, any>;\n  signature: string;\n  runId: string;\n  startedAt: string;\n  input: unknown;\n  state: Record<string, unknown>;\n  steps: Record<string, StepSnapshot>;\n  next: string | null;\n  status: WorkflowSnapshot[\"status\"];\n};\n\nexport type PersistOutcome = { ok: true } | { ok: false; error: unknown };\n\n/**\n * Write the current run's state to the configured `KVStore`. Returns\n * an outcome object instead of throwing so the engine can surface\n * persistence failures via events + logs without aborting the run.\n * Callers decide whether a failed checkpoint is fatal.\n *\n * No-op (returns `{ ok: true }`) when the workflow has no store\n * configured — the common in-memory test case.\n */\nexport async function persistSnapshot<T>(\n  params: PersistParams<T>,\n): Promise<PersistOutcome> {\n  const store = resolveSnapshotStore(params.definition);\n\n  if (!store) return { ok: true };\n\n  const snapshot: WorkflowSnapshot = {\n    runId: params.runId,\n    workflowName: params.definition.name,\n    signature: params.signature,\n    version: params.definition.version,\n    input: params.input,\n    state: { ...params.state },\n    steps: { ...params.steps },\n    next: params.next,\n    status: params.status,\n    startedAt: params.startedAt,\n    savedAt: new Date().toISOString(),\n  };\n\n  try {\n    await store.save(snapshot);\n    return { ok: true };\n  } catch (err) {\n    return { ok: false, error: err };\n  }\n}\n\n/**\n * Load a prior run's snapshot from the store and run the drift\n * check. Throws `WorkflowError` when no snapshot exists, and\n * `WorkflowDriftError` when the stored signature doesn't match the\n * current definition (unless `force` is set).\n */\nexport async function loadSnapshotForResume<T>(params: {\n  definition: WorkflowDefinition<any, T, any, any>;\n  signature: string;\n  runId: string;\n  options?: WorkflowResumeOptions;\n}): Promise<WorkflowSnapshot> {\n  const store = resolveSnapshotStore(params.definition);\n\n  if (!store) {\n    throw new WorkflowError(\n      `workflow \"${params.definition.name}\" has no store configured — set \\`snapshotStore\\` on the definition or call \\`ai.config({ defaultSnapshotStore })\\` at boot before calling resume()`,\n    );\n  }\n\n  const snap = (await store.load(params.runId)) ?? null;\n\n  if (!snap) {\n    throw new WorkflowError(\n      `workflow \"${params.definition.name}\": no snapshot for runId \"${params.runId}\"`,\n    );\n  }\n\n  if (!params.options?.force && snap.signature !== params.signature) {\n    throw new WorkflowDriftError(\n      `workflow \"${params.definition.name}\" signature drift on resume`,\n      {\n        savedSignature: snap.signature,\n        currentSignature: params.signature,\n        runId: params.runId,\n      },\n    );\n  }\n\n  return snap;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAqBA,SAAS,qBACP,YAC6C;CAC7C,OACE,WAAW,iBACV,4BAA4B;AAEjC;;;;;;;;;;AAyBA,eAAsB,gBACpB,QACyB;CACzB,MAAM,QAAQ,qBAAqB,OAAO,UAAU;CAEpD,IAAI,CAAC,OAAO,OAAO,EAAE,IAAI,KAAK;CAE9B,MAAM,WAA6B;EACjC,OAAO,OAAO;EACd,cAAc,OAAO,WAAW;EAChC,WAAW,OAAO;EAClB,SAAS,OAAO,WAAW;EAC3B,OAAO,OAAO;EACd,OAAO,EAAE,GAAG,OAAO,MAAM;EACzB,OAAO,EAAE,GAAG,OAAO,MAAM;EACzB,MAAM,OAAO;EACb,QAAQ,OAAO;EACf,WAAW,OAAO;EAClB,0BAAS,IAAI,KAAK,EAAC,CAAC,YAAY;CAClC;CAEA,IAAI;EACF,MAAM,MAAM,KAAK,QAAQ;EACzB,OAAO,EAAE,IAAI,KAAK;CACpB,SAAS,KAAK;EACZ,OAAO;GAAE,IAAI;GAAO,OAAO;EAAI;CACjC;AACF;;;;;;;AAQA,eAAsB,sBAAyB,QAKjB;CAC5B,MAAM,QAAQ,qBAAqB,OAAO,UAAU;CAEpD,IAAI,CAAC,OACH,MAAM,IAAI,cACR,aAAa,OAAO,WAAW,KAAK,oJACtC;CAGF,MAAM,OAAQ,MAAM,MAAM,KAAK,OAAO,KAAK,KAAM;CAEjD,IAAI,CAAC,MACH,MAAM,IAAI,cACR,aAAa,OAAO,WAAW,KAAK,4BAA4B,OAAO,MAAM,EAC/E;CAGF,IAAI,CAAC,OAAO,SAAS,SAAS,KAAK,cAAc,OAAO,WACtD,MAAM,IAAI,mBACR,aAAa,OAAO,WAAW,KAAK,8BACpC;EACE,gBAAgB,KAAK;EACrB,kBAAkB,OAAO;EACzB,OAAO,OAAO;CAChB,CACF;CAGF,OAAO;AACT"}

package/esm/ai/src/workflow/state.mjs

@@ -1,37 +0,0 @@
-import { WorkflowError } from "../errors/workflow-error.mjs";
-import "../errors/index.mjs";
-
-//#region ../@warlock.js/ai/src/workflow/state.ts
-/**
-* Deep-clone workflow state. Uses `structuredClone` — handles Date,
-* Map, Set, ArrayBuffer, nested objects, arrays, primitives. Throws
-* a typed `WorkflowError` on older runtimes (pre-Node-17) rather
-* than silently falling back to a JSON round-trip that would drop
-* non-serializable values like Dates without warning.
-*
-* Workflow state should stay serializable anyway (it round-trips
-* through `KVStore` on every checkpoint). If `structuredClone` chokes
-* on a value, that's a bug in the user's state — surface it.
-*/
-function cloneState(value) {
-	if (typeof structuredClone !== "function") throw new WorkflowError("workflow state cloning requires `structuredClone` (Node 17+ or a modern browser)");
-	return structuredClone(value);
-}
-/**
-* Recursively freeze `value` and every nested plain object / array so
-* consumers of `ctx.steps[x].state` or `report.state` can't mutate
-* historical snapshots. Already-frozen values are skipped.
-*/
-function deepFreeze(value) {
-	if (value === null || typeof value !== "object") return value;
-	if (Object.isFrozen(value)) return value;
-	for (const key of Object.keys(value)) {
-		const child = value[key];
-		if (child && typeof child === "object") deepFreeze(child);
-	}
-	return Object.freeze(value);
-}
-
-//#endregion
-export { cloneState, deepFreeze };
-//# sourceMappingURL=state.mjs.map

package/esm/ai/src/workflow/state.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"state.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/ai/src/workflow/state.ts"],"sourcesContent":["import { WorkflowError } from \"../errors\";\n\n/**\n * Deep-clone workflow state. Uses `structuredClone` — handles Date,\n * Map, Set, ArrayBuffer, nested objects, arrays, primitives. Throws\n * a typed `WorkflowError` on older runtimes (pre-Node-17) rather\n * than silently falling back to a JSON round-trip that would drop\n * non-serializable values like Dates without warning.\n *\n * Workflow state should stay serializable anyway (it round-trips\n * through `KVStore` on every checkpoint). If `structuredClone` chokes\n * on a value, that's a bug in the user's state — surface it.\n */\nexport function cloneState<T>(value: T): T {\n  if (typeof structuredClone !== \"function\") {\n    throw new WorkflowError(\n      \"workflow state cloning requires `structuredClone` (Node 17+ or a modern browser)\",\n    );\n  }\n\n  return structuredClone(value);\n}\n\n/**\n * Recursively freeze `value` and every nested plain object / array so\n * consumers of `ctx.steps[x].state` or `report.state` can't mutate\n * historical snapshots. Already-frozen values are skipped.\n */\nexport function deepFreeze<T>(value: T): T {\n  if (value === null || typeof value !== \"object\") return value;\n  if (Object.isFrozen(value)) return value;\n\n  for (const key of Object.keys(value as Record<string, unknown>)) {\n    const child = (value as Record<string, unknown>)[key];\n    if (child && typeof child === \"object\") deepFreeze(child);\n  }\n\n  return Object.freeze(value);\n}\n"],"mappings":";;;;;;;;;;;;;;;AAaA,SAAgB,WAAc,OAAa;CACzC,IAAI,OAAO,oBAAoB,YAC7B,MAAM,IAAI,cACR,kFACF;CAGF,OAAO,gBAAgB,KAAK;AAC9B;;;;;;AAOA,SAAgB,WAAc,OAAa;CACzC,IAAI,UAAU,QAAQ,OAAO,UAAU,UAAU,OAAO;CACxD,IAAI,OAAO,SAAS,KAAK,GAAG,OAAO;CAEnC,KAAK,MAAM,OAAO,OAAO,KAAK,KAAgC,GAAG;EAC/D,MAAM,QAAS,MAAkC;EACjD,IAAI,SAAS,OAAO,UAAU,UAAU,WAAW,KAAK;CAC1D;CAEA,OAAO,OAAO,OAAO,KAAK;AAC5B"}

package/esm/ai/src/workflow/step-runner.mjs

@@ -1,370 +0,0 @@
-import { AIError } from "../errors/ai-error.mjs";
-import { WorkflowError } from "../errors/workflow-error.mjs";
-import { SchemaValidationError } from "../errors/schema-validation-error.mjs";
-import { StepFailedError } from "../errors/step-failed-error.mjs";
-import { WorkflowCancelledError } from "../errors/workflow-cancelled-error.mjs";
-import "../errors/index.mjs";
-import { mergeUsage } from "../utils/compute-cost.mjs";
-import { withoutRunFrame } from "../utils/run-context.mjs";
-import { isAbortError, resolveBackoff, resolveRetryConfig } from "./retry.mjs";
-import { createCancelledError, sleep } from "./cancellation.mjs";
-import { cloneState, deepFreeze } from "./state.mjs";
-
-//#region ../@warlock.js/ai/src/workflow/step-runner.ts
-/**
-* Narrow an `executionResult` to an `AgentResult` when the step ran
-* an agent. Custom `run` steps return arbitrary values, so the
-* `type: "agent"` discriminant keeps us honest.
-*/
-function asAgentResult(result) {
-	if (!result || typeof result !== "object") return void 0;
-	if (result.type !== "agent") return void 0;
-	return result;
-}
-/**
-* Drive one step's full lifecycle — skip evaluation, parallel
-* dispatch, retry loop around before → run|agent → output → after.
-* Returns a mutable snapshot; the engine deep-freezes it before
-* exposing.
-*/
-async function executeStep(params) {
-	const { step, emitter, executionHandlers, logger, logModule, signal } = params;
-	const startedAt = (/* @__PURE__ */ new Date()).toISOString();
-	const stepStartPerf = performance.now();
-	params.step.on?.starting?.({ step: step.name });
-	emitter.emit("workflow.step.starting", { step: step.name }, executionHandlers);
-	logger.debug(logModule, "step.starting", `${step.name} step starting`, { step: step.name });
-	const stepState = cloneState(params.state);
-	try {
-		if (step.skip) {
-			if (await step.skip(params.buildContext({ state: stepState }))) {
-				const endedAt = (/* @__PURE__ */ new Date()).toISOString();
-				const duration = performance.now() - stepStartPerf;
-				emitter.emit("workflow.step.skipped", { step: step.name }, executionHandlers);
-				logger.debug(logModule, "step.skipped", `${step.name} step skipped`, { step: step.name });
-				return {
-					output: void 0,
-					skipped: true,
-					status: "skipped",
-					startedAt,
-					endedAt,
-					duration,
-					attempts: 0,
-					attemptHistory: [],
-					state: stepState
-				};
-			}
-		}
-	} catch (err) {
-		return buildFailedSnapshot(step, stepState, startedAt, stepStartPerf, 1, [failedAttempt(1, err, (/* @__PURE__ */ new Date()).toISOString(), performance.now())]);
-	}
-	if (step.parallel && step.parallel.length > 0) return runParallelStep({
-		...params,
-		step,
-		stepState,
-		startedAt,
-		startPerf: stepStartPerf
-	});
-	const retryConfig = resolveRetryConfig(step, params.workflowDefaultRetry);
-	const attempts = [];
-	const totalAttempts = Math.max(1, retryConfig.attempts ?? 1);
-	let lastError;
-	let executionResult;
-	let output;
-	let succeeded = false;
-	for (let attempt = 1; attempt <= totalAttempts; attempt++) {
-		if (signal?.aborted) throw createCancelledError(signal);
-		const attemptStart = (/* @__PURE__ */ new Date()).toISOString();
-		const attemptStartPerf = performance.now();
-		try {
-			const attemptState = cloneState(params.state);
-			if (step.before) await step.before(params.buildContext({ state: attemptState }));
-			if (step.agent) {
-				const agent = step.agent;
-				const { prompt, ...agentOpts } = step.input ? await step.input(params.buildContext({ state: attemptState })) : { prompt: "" };
-				const result = await withoutRunFrame(() => agent.execute(prompt, {
-					...agentOpts,
-					signal
-				}));
-				executionResult = result;
-				if (result.usage) mergeUsage(params.usage, result.usage);
-				if (result.error) throw result.error;
-			} else if (step.run) executionResult = await step.run(params.buildContext({ state: attemptState }));
-			if (step.output) {
-				const extracted = await step.output.extract(params.buildContext({
-					state: attemptState,
-					agentResult: executionResult
-				}));
-				output = await validateSchema(step.output.schema, extracted);
-			} else output = void 0;
-			if (step.after) await step.after(params.buildContext({
-				state: attemptState,
-				agentResult: executionResult
-			}));
-			Object.assign(stepState, attemptState);
-			attempts.push({
-				index: attempt,
-				startedAt: attemptStart,
-				endedAt: (/* @__PURE__ */ new Date()).toISOString(),
-				duration: performance.now() - attemptStartPerf,
-				status: "success"
-			});
-			succeeded = true;
-			break;
-		} catch (err) {
-			if (isAbortError(err) || err instanceof WorkflowCancelledError) throw createCancelledError(signal);
-			attempts.push({
-				index: attempt,
-				startedAt: attemptStart,
-				endedAt: (/* @__PURE__ */ new Date()).toISOString(),
-				duration: performance.now() - attemptStartPerf,
-				status: "failed",
-				error: toAIError(err)
-			});
-			lastError = err;
-			if (!(attempt < totalAttempts && (retryConfig.retryOn ? retryConfig.retryOn(err, attempt) !== false : true))) break;
-			emitter.emit("workflow.step.retrying", {
-				step: step.name,
-				attempt: attempt + 1,
-				totalAttempts,
-				lastError: err
-			}, params.executionHandlers);
-			step.on?.retrying?.({
-				step: step.name,
-				attempt: attempt + 1,
-				totalAttempts,
-				lastError: err
-			});
-			logger.warn(logModule, "step.retrying", `${step.name} step retrying`, {
-				step: step.name,
-				attempt: attempt + 1
-			});
-			retryConfig.onRetry?.(attempt + 1, err);
-			const delay = resolveBackoff(attempt, retryConfig.backoff);
-			if (delay > 0) await sleep(delay, signal);
-		}
-	}
-	const endedAt = (/* @__PURE__ */ new Date()).toISOString();
-	const duration = performance.now() - stepStartPerf;
-	if (!succeeded) {
-		const aiError = toAIError(lastError);
-		const stepError = new StepFailedError(`step "${step.name}" failed after ${attempts.length} attempt(s): ${aiError.message}`, {
-			stepName: step.name,
-			attempts: attempts.length,
-			cause: aiError
-		});
-		emitter.emit("workflow.step.failed", {
-			step: step.name,
-			error: stepError,
-			attempts: attempts.length
-		}, params.executionHandlers);
-		step.on?.failed?.({
-			step: step.name,
-			error: stepError,
-			attempts: attempts.length
-		});
-		logger.error(logModule, "step.failed", `${step.name} step failed`, {
-			step: step.name,
-			attempts: attempts.length,
-			code: stepError.code
-		});
-		const failedAgentResult = asAgentResult(executionResult);
-		return {
-			output: void 0,
-			skipped: false,
-			status: "failed",
-			startedAt,
-			endedAt,
-			duration,
-			attempts: attempts.length,
-			attemptHistory: attempts,
-			error: stepError,
-			state: stepState,
-			executionResult: executionResult && typeof executionResult === "object" ? executionResult : void 0,
-			agentReport: failedAgentResult?.report,
-			agentUsage: failedAgentResult?.usage
-		};
-	}
-	emitter.emit("workflow.step.completed", {
-		step: step.name,
-		output,
-		duration
-	}, params.executionHandlers);
-	step.on?.completed?.({
-		step: step.name,
-		output,
-		duration
-	});
-	logger.debug(logModule, "step.completed", "step completed", {
-		step: step.name,
-		duration
-	});
-	const completedAgentResult = asAgentResult(executionResult);
-	return {
-		output,
-		skipped: false,
-		status: "completed",
-		startedAt,
-		endedAt,
-		duration,
-		attempts: attempts.length,
-		attemptHistory: attempts,
-		state: stepState,
-		executionResult: executionResult && typeof executionResult === "object" ? executionResult : void 0,
-		agentReport: completedAgentResult?.report,
-		agentUsage: completedAgentResult?.usage
-	};
-}
-async function runParallelStep(params) {
-	const { step, emitter, executionHandlers, logger, logModule, signal } = params;
-	const sharedState = params.stepState;
-	const childSnapshots = {};
-	let firstError;
-	const results = await Promise.all((step.parallel ?? []).map(async (child) => {
-		return {
-			child,
-			snap: await executeStep({
-				step: child,
-				state: sharedState,
-				emitter,
-				executionHandlers,
-				logger,
-				logModule,
-				signal,
-				buildContext: params.buildContext,
-				usage: params.usage
-			})
-		};
-	}));
-	for (const { child, snap } of results) {
-		childSnapshots[child.name] = finalizeSnapshot(snap);
-		if (step.mergeState) step.mergeState(sharedState, snap.state, child.name);
-		else Object.assign(sharedState, snap.state);
-		if (snap.status === "failed" && !firstError && snap.error) firstError = snap.error;
-	}
-	const endedAt = (/* @__PURE__ */ new Date()).toISOString();
-	const duration = performance.now() - params.startPerf;
-	let output;
-	if (step.output) try {
-		const ctx = params.buildContext({ state: sharedState });
-		const ctxWithChildren = {
-			...ctx,
-			steps: {
-				...ctx.steps,
-				[step.name]: {
-					...childSnapshots,
-					steps: childSnapshots,
-					status: firstError ? "failed" : "completed"
-				}
-			}
-		};
-		const extracted = await step.output.extract(ctxWithChildren);
-		output = await validateSchema(step.output.schema, extracted);
-	} catch (err) {
-		firstError = firstError ?? toAIError(err);
-	}
-	const status = firstError ? "failed" : "completed";
-	if (status === "completed") {
-		emitter.emit("workflow.step.completed", {
-			step: step.name,
-			output,
-			duration
-		}, executionHandlers);
-		step.on?.completed?.({
-			step: step.name,
-			output,
-			duration
-		});
-	} else {
-		emitter.emit("workflow.step.failed", {
-			step: step.name,
-			error: firstError,
-			attempts: 1
-		}, executionHandlers);
-		step.on?.failed?.({
-			step: step.name,
-			error: firstError,
-			attempts: 1
-		});
-	}
-	return {
-		output,
-		skipped: false,
-		status,
-		startedAt: params.startedAt,
-		endedAt,
-		duration,
-		attempts: 1,
-		attemptHistory: [],
-		error: firstError,
-		state: sharedState,
-		steps: childSnapshots
-	};
-}
-function finalizeSnapshot(snap) {
-	return Object.freeze({
-		output: snap.output,
-		skipped: snap.skipped,
-		status: snap.status,
-		startedAt: snap.startedAt,
-		endedAt: snap.endedAt,
-		duration: snap.duration,
-		attempts: snap.attempts,
-		attemptHistory: snap.attemptHistory,
-		error: snap.error,
-		state: deepFreeze(cloneState(snap.state)),
-		executionResult: snap.executionResult,
-		agentReport: snap.agentReport,
-		agentUsage: snap.agentUsage,
-		steps: snap.steps
-	});
-}
-function buildFailedSnapshot(step, state, startedAt, startPerf, attemptsCount, attemptHistory) {
-	const endedAt = (/* @__PURE__ */ new Date()).toISOString();
-	const duration = performance.now() - startPerf;
-	const lastErr = attemptHistory[attemptHistory.length - 1]?.error;
-	return {
-		output: void 0,
-		skipped: false,
-		status: "failed",
-		startedAt,
-		endedAt,
-		duration,
-		attempts: attemptsCount,
-		attemptHistory,
-		error: lastErr ? new StepFailedError(`step "${step.name}" skip threw: ${lastErr.message}`, {
-			stepName: step.name,
-			attempts: attemptsCount,
-			cause: lastErr
-		}) : new StepFailedError(`step "${step.name}" failed`, {
-			stepName: step.name,
-			attempts: attemptsCount
-		}),
-		state
-	};
-}
-function failedAttempt(index, err, startedAt, startPerf) {
-	return {
-		index,
-		startedAt,
-		endedAt: (/* @__PURE__ */ new Date()).toISOString(),
-		duration: performance.now() - startPerf,
-		status: "failed",
-		error: toAIError(err)
-	};
-}
-function toAIError(err) {
-	if (err instanceof AIError) return err;
-	if (err instanceof Error) return new WorkflowError(err.message, { cause: err });
-	return new WorkflowError(String(err));
-}
-async function validateSchema(schema, value) {
-	if (!schema) return value;
-	const result = await schema["~standard"].validate(value);
-	if ("issues" in result && result.issues) throw new SchemaValidationError("workflow step output failed schema validation", { issues: result.issues });
-	return result.value;
-}
-
-//#endregion
-export { executeStep, finalizeSnapshot, toAIError };
-//# sourceMappingURL=step-runner.mjs.map

package/esm/ai/src/workflow/step-runner.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"step-runner.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/ai/src/workflow/step-runner.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type { Logger } from \"@warlock.js/logger\";\nimport type { AgentResult } from \"../contracts/result/agent-result.type\";\nimport type { AgentReport } from \"../contracts/result/execution-report.type\";\nimport type { AttemptEntry, StepSnapshot } from \"../contracts/result/step-result.type\";\nimport type { Usage } from \"../contracts/result/usage.type\";\nimport type { RetryConfig } from \"../contracts/workflow/retry-config.type\";\nimport type { StepDefinition } from \"../contracts/workflow/step.contract\";\nimport type { WorkflowContext } from \"../contracts/workflow/workflow-context.type\";\nimport type { WorkflowEventHandlers } from \"../contracts/workflow/workflow.contract\";\nimport { mergeUsage } from \"../utils/compute-cost\";\nimport { withoutRunFrame } from \"../utils/run-context\";\nimport {\n  AIError,\n  SchemaValidationError,\n  StepFailedError,\n  WorkflowCancelledError,\n  WorkflowError,\n} from \"../errors\";\nimport { createCancelledError, sleep } from \"./cancellation\";\nimport type { WorkflowEventSink } from \"./emitter\";\nimport { isAbortError, resolveBackoff, resolveRetryConfig } from \"./retry\";\nimport { cloneState, deepFreeze } from \"./state\";\n\n/**\n * Mutable snapshot used by the step runner — finalized (deep-frozen)\n * by the engine before being written to `ctx.steps` / `report.steps`.\n */\nexport type MutableStepSnapshot = {\n  output: unknown;\n  skipped: boolean;\n  status: \"completed\" | \"skipped\" | \"failed\";\n  startedAt: string;\n  endedAt: string;\n  duration: number;\n  attempts: number;\n  attemptHistory: AttemptEntry[];\n  error?: AIError;\n  state: Record<string, unknown>;\n  executionResult?: unknown;\n  agentReport?: AgentReport;\n  agentUsage?: Usage;\n  steps?: Record<string, StepSnapshot>;\n};\n\n/**\n * Narrow an `executionResult` to an `AgentResult` when the step ran\n * an agent. Custom `run` steps return arbitrary values, so the\n * `type: \"agent\"` discriminant keeps us honest.\n */\nfunction asAgentResult(result: unknown): AgentResult<unknown> | undefined {\n  if (!result || typeof result !== \"object\") return undefined;\n  if ((result as { type?: unknown }).type !== \"agent\") return undefined;\n  return result as AgentResult<unknown>;\n}\n\nexport type ExecuteStepParams = {\n  step: StepDefinition;\n  state: Record<string, unknown>;\n  emitter: WorkflowEventSink;\n  executionHandlers?: WorkflowEventHandlers;\n  logger: Logger;\n  logModule: string;\n  signal?: AbortSignal;\n  buildContext: (current?: {\n    state: Record<string, unknown>;\n    agentResult?: unknown;\n  }) => WorkflowContext;\n  usage: Usage;\n  workflowDefaultRetry?: RetryConfig | false;\n};\n\n/**\n * Drive one step's full lifecycle — skip evaluation, parallel\n * dispatch, retry loop around before → run|agent → output → after.\n * Returns a mutable snapshot; the engine deep-freezes it before\n * exposing.\n */\nexport async function executeStep(params: ExecuteStepParams): Promise<MutableStepSnapshot> {\n  const { step, emitter, executionHandlers, logger, logModule, signal } = params;\n  const startedAt = new Date().toISOString();\n  const stepStartPerf = performance.now();\n\n  params.step.on?.starting?.({ step: step.name });\n  emitter.emit(\"workflow.step.starting\", { step: step.name }, executionHandlers);\n  logger.debug(logModule, \"step.starting\", `${step.name} step starting`, {\n    step: step.name,\n  });\n\n  const stepState: Record<string, unknown> = cloneState(params.state);\n\n  // SKIP\n  try {\n    if (step.skip) {\n      const shouldSkip = await step.skip(params.buildContext({ state: stepState }));\n      if (shouldSkip) {\n        const endedAt = new Date().toISOString();\n        const duration = performance.now() - stepStartPerf;\n        emitter.emit(\"workflow.step.skipped\", { step: step.name }, executionHandlers);\n        logger.debug(logModule, \"step.skipped\", `${step.name} step skipped`, {\n          step: step.name,\n        });\n\n        return {\n          output: undefined,\n          skipped: true,\n          status: \"skipped\",\n          startedAt,\n          endedAt,\n          duration,\n          attempts: 0,\n          attemptHistory: [],\n          state: stepState,\n        };\n      }\n    }\n  } catch (err) {\n    return buildFailedSnapshot(step, stepState, startedAt, stepStartPerf, 1, [\n      failedAttempt(1, err, new Date().toISOString(), performance.now()),\n    ]);\n  }\n\n  // PARALLEL\n  if (step.parallel && step.parallel.length > 0) {\n    return runParallelStep({\n      ...params,\n      step,\n      stepState,\n      startedAt,\n      startPerf: stepStartPerf,\n    });\n  }\n\n  const retryConfig = resolveRetryConfig(step, params.workflowDefaultRetry);\n\n  const attempts: AttemptEntry[] = [];\n  const totalAttempts = Math.max(1, retryConfig.attempts ?? 1);\n  let lastError: unknown;\n  let executionResult: unknown;\n  let output: unknown;\n  let succeeded = false;\n\n  for (let attempt = 1; attempt <= totalAttempts; attempt++) {\n    if (signal?.aborted) throw createCancelledError(signal);\n\n    const attemptStart = new Date().toISOString();\n    const attemptStartPerf = performance.now();\n    try {\n      // Fresh deep-clone per attempt — retries restart cleanly.\n      const attemptState: Record<string, unknown> = cloneState(params.state);\n\n      if (step.before) {\n        await step.before(params.buildContext({ state: attemptState }));\n      }\n\n      if (step.agent) {\n        const agent = step.agent;\n        const agentInput = step.input\n          ? await step.input(params.buildContext({ state: attemptState }))\n          : { prompt: \"\" };\n\n        const { prompt, ...agentOpts } = agentInput;\n\n        // Run the step's agent inside a nested frame so observe-all does NOT\n        // also self-route it as a standalone trace — the workflow already\n        // captures it into report.steps (explicit capture, like the supervisor).\n        const result = await withoutRunFrame(() =>\n          agent.execute(prompt, {\n            ...agentOpts,\n            signal,\n          }),\n        );\n\n        executionResult = result;\n\n        if (result.usage) {\n          mergeUsage(params.usage, result.usage);\n        }\n\n        if (result.error) throw result.error;\n      } else if (step.run) {\n        executionResult = await step.run(params.buildContext({ state: attemptState }));\n      }\n\n      if (step.output) {\n        const extracted = await step.output.extract(\n          params.buildContext({\n            state: attemptState,\n            agentResult: executionResult,\n          }),\n        );\n        output = await validateSchema(step.output.schema, extracted);\n      } else {\n        output = undefined;\n      }\n\n      if (step.after) {\n        await step.after(\n          params.buildContext({\n            state: attemptState,\n            agentResult: executionResult,\n          }),\n        );\n      }\n\n      Object.assign(stepState, attemptState);\n\n      attempts.push({\n        index: attempt,\n        startedAt: attemptStart,\n        endedAt: new Date().toISOString(),\n        duration: performance.now() - attemptStartPerf,\n        status: \"success\",\n      });\n      succeeded = true;\n      break;\n    } catch (err) {\n      if (isAbortError(err) || err instanceof WorkflowCancelledError) {\n        throw createCancelledError(signal);\n      }\n\n      attempts.push({\n        index: attempt,\n        startedAt: attemptStart,\n        endedAt: new Date().toISOString(),\n        duration: performance.now() - attemptStartPerf,\n        status: \"failed\",\n        error: toAIError(err),\n      });\n\n      lastError = err;\n\n      const shouldRetry =\n        attempt < totalAttempts &&\n        (retryConfig.retryOn ? retryConfig.retryOn(err, attempt) !== false : true);\n\n      if (!shouldRetry) break;\n\n      emitter.emit(\n        \"workflow.step.retrying\",\n        {\n          step: step.name,\n          attempt: attempt + 1,\n          totalAttempts,\n          lastError: err,\n        },\n        params.executionHandlers,\n      );\n\n      step.on?.retrying?.({\n        step: step.name,\n        attempt: attempt + 1,\n        totalAttempts,\n        lastError: err,\n      });\n\n      logger.warn(logModule, \"step.retrying\", `${step.name} step retrying`, {\n        step: step.name,\n        attempt: attempt + 1,\n      });\n\n      retryConfig.onRetry?.(attempt + 1, err);\n\n      const delay = resolveBackoff(attempt, retryConfig.backoff);\n      if (delay > 0) await sleep(delay, signal);\n    }\n  }\n\n  const endedAt = new Date().toISOString();\n  const duration = performance.now() - stepStartPerf;\n\n  if (!succeeded) {\n    const aiError = toAIError(lastError);\n    const stepError = new StepFailedError(\n      `step \"${step.name}\" failed after ${attempts.length} attempt(s): ${aiError.message}`,\n      { stepName: step.name, attempts: attempts.length, cause: aiError },\n    );\n\n    emitter.emit(\n      \"workflow.step.failed\",\n      { step: step.name, error: stepError, attempts: attempts.length },\n      params.executionHandlers,\n    );\n\n    step.on?.failed?.({\n      step: step.name,\n      error: stepError,\n      attempts: attempts.length,\n    });\n\n    logger.error(logModule, \"step.failed\", `${step.name} step failed`, {\n      step: step.name,\n      attempts: attempts.length,\n      code: stepError.code,\n    });\n\n    const failedAgentResult = asAgentResult(executionResult);\n    return {\n      output: undefined,\n      skipped: false,\n      status: \"failed\",\n      startedAt,\n      endedAt,\n      duration,\n      attempts: attempts.length,\n      attemptHistory: attempts,\n      error: stepError,\n      state: stepState,\n      executionResult:\n        executionResult && typeof executionResult === \"object\" ? executionResult : undefined,\n      agentReport: failedAgentResult?.report,\n      agentUsage: failedAgentResult?.usage,\n    };\n  }\n\n  emitter.emit(\n    \"workflow.step.completed\",\n    { step: step.name, output, duration },\n    params.executionHandlers,\n  );\n  step.on?.completed?.({ step: step.name, output, duration });\n  logger.debug(logModule, \"step.completed\", \"step completed\", {\n    step: step.name,\n    duration,\n  });\n\n  const completedAgentResult = asAgentResult(executionResult);\n  return {\n    output,\n    skipped: false,\n    status: \"completed\",\n    startedAt,\n    endedAt,\n    duration,\n    attempts: attempts.length,\n    attemptHistory: attempts,\n    state: stepState,\n    executionResult:\n      executionResult && typeof executionResult === \"object\" ? executionResult : undefined,\n    agentReport: completedAgentResult?.report,\n    agentUsage: completedAgentResult?.usage,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Parallel runner\n// ---------------------------------------------------------------------------\n\ntype ParallelParams = ExecuteStepParams & {\n  stepState: Record<string, unknown>;\n  startedAt: string;\n  startPerf: number;\n};\n\nasync function runParallelStep(params: ParallelParams): Promise<MutableStepSnapshot> {\n  const { step, emitter, executionHandlers, logger, logModule, signal } = params;\n\n  const sharedState = params.stepState;\n  const childSnapshots: Record<string, StepSnapshot> = {};\n  let firstError: AIError | undefined;\n\n  const results = await Promise.all(\n    (step.parallel ?? []).map(async (child) => {\n      const snap = await executeStep({\n        step: child,\n        state: sharedState,\n        emitter,\n        executionHandlers,\n        logger,\n        logModule,\n        signal,\n        buildContext: params.buildContext,\n        usage: params.usage,\n      });\n\n      return { child, snap };\n    }),\n  );\n\n  // Merge each child's resulting state into the shared parent state in\n  // DECLARATION order — not completion order. Every child cloned the\n  // same initial `sharedState` synchronously at dispatch, so the merge\n  // here is the only thing that decides conflicting keys; `Promise.all`\n  // preserves input order in `results`, so a key written by multiple\n  // children deterministically resolves to the last-declared child's\n  // value regardless of which settled first (C3). An optional\n  // `mergeState` reducer overrides this per key for advanced workflows.\n  for (const { child, snap } of results) {\n    childSnapshots[child.name] = finalizeSnapshot(snap);\n\n    if (step.mergeState) {\n      step.mergeState(sharedState, snap.state, child.name);\n    } else {\n      Object.assign(sharedState, snap.state);\n    }\n\n    if (snap.status === \"failed\" && !firstError && snap.error) {\n      firstError = snap.error;\n    }\n  }\n\n  const endedAt = new Date().toISOString();\n  const duration = performance.now() - params.startPerf;\n\n  let output: unknown;\n\n  if (step.output) {\n    try {\n      const ctx = params.buildContext({ state: sharedState });\n      const ctxWithChildren = {\n        ...ctx,\n        steps: {\n          ...ctx.steps,\n          [step.name]: {\n            ...(childSnapshots as unknown as StepSnapshot),\n            steps: childSnapshots,\n            status: firstError ? \"failed\" : \"completed\",\n          } as StepSnapshot,\n        } as Readonly<Record<string, StepSnapshot>>,\n      };\n\n      const extracted = await step.output.extract(ctxWithChildren);\n      output = await validateSchema(step.output.schema, extracted);\n    } catch (err) {\n      firstError = firstError ?? toAIError(err);\n    }\n  }\n\n  const status: \"completed\" | \"failed\" = firstError ? \"failed\" : \"completed\";\n\n  if (status === \"completed\") {\n    emitter.emit(\n      \"workflow.step.completed\",\n      { step: step.name, output, duration },\n      executionHandlers,\n    );\n    step.on?.completed?.({ step: step.name, output, duration });\n  } else {\n    emitter.emit(\n      \"workflow.step.failed\",\n      { step: step.name, error: firstError!, attempts: 1 },\n      executionHandlers,\n    );\n    step.on?.failed?.({ step: step.name, error: firstError!, attempts: 1 });\n  }\n\n  return {\n    output,\n    skipped: false,\n    status,\n    startedAt: params.startedAt,\n    endedAt,\n    duration,\n    attempts: 1,\n    attemptHistory: [],\n    error: firstError,\n    state: sharedState,\n    steps: childSnapshots,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nexport function finalizeSnapshot(snap: MutableStepSnapshot): StepSnapshot {\n  return Object.freeze({\n    output: snap.output,\n    skipped: snap.skipped,\n    status: snap.status,\n    startedAt: snap.startedAt,\n    endedAt: snap.endedAt,\n    duration: snap.duration,\n    attempts: snap.attempts,\n    attemptHistory: snap.attemptHistory,\n    error: snap.error,\n    state: deepFreeze(cloneState(snap.state)),\n    executionResult: snap.executionResult as StepSnapshot[\"executionResult\"],\n    agentReport: snap.agentReport,\n    agentUsage: snap.agentUsage,\n    steps: snap.steps,\n  }) as StepSnapshot;\n}\n\nfunction buildFailedSnapshot(\n  step: StepDefinition,\n  state: Record<string, unknown>,\n  startedAt: string,\n  startPerf: number,\n  attemptsCount: number,\n  attemptHistory: AttemptEntry[],\n): MutableStepSnapshot {\n  const endedAt = new Date().toISOString();\n  const duration = performance.now() - startPerf;\n  const lastErr = attemptHistory[attemptHistory.length - 1]?.error;\n  const wrapped = lastErr\n    ? new StepFailedError(`step \"${step.name}\" skip threw: ${lastErr.message}`, {\n        stepName: step.name,\n        attempts: attemptsCount,\n        cause: lastErr,\n      })\n    : new StepFailedError(`step \"${step.name}\" failed`, {\n        stepName: step.name,\n        attempts: attemptsCount,\n      });\n\n  return {\n    output: undefined,\n    skipped: false,\n    status: \"failed\",\n    startedAt,\n    endedAt,\n    duration,\n    attempts: attemptsCount,\n    attemptHistory,\n    error: wrapped,\n    state,\n  };\n}\n\nfunction failedAttempt(\n  index: number,\n  err: unknown,\n  startedAt: string,\n  startPerf: number,\n): AttemptEntry {\n  return {\n    index,\n    startedAt,\n    endedAt: new Date().toISOString(),\n    duration: performance.now() - startPerf,\n    status: \"failed\",\n    error: toAIError(err),\n  };\n}\n\nexport function toAIError(err: unknown): AIError {\n  if (err instanceof AIError) return err;\n  if (err instanceof Error) return new WorkflowError(err.message, { cause: err });\n  return new WorkflowError(String(err));\n}\n\nasync function validateSchema(\n  schema: StandardSchemaV1<unknown> | undefined,\n  value: unknown,\n): Promise<unknown> {\n  if (!schema) return value;\n  const result = await schema[\"~standard\"].validate(value);\n\n  if (\"issues\" in result && result.issues) {\n    throw new SchemaValidationError(\"workflow step output failed schema validation\", {\n      issues: result.issues,\n    });\n  }\n\n  return (result as { value: unknown }).value;\n}\n"],"mappings":"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"}

package/esm/ai/src/workflow/step.mjs

@@ -1,37 +0,0 @@
-import { WorkflowError } from "../errors/workflow-error.mjs";
-import "../errors/index.mjs";
-
-//#region ../@warlock.js/ai/src/workflow/step.ts
-/**
-* `ai.step(def)` — pass-through factory used for authoring. Returns
-* the definition object verbatim so the workflow engine can read it
-* during execution; the factory exists for API symmetry with
-* `ai.workflow()` and to leave room for future validation or
-* metadata annotation.
-*
-* Generics flow from the enclosing `ai.workflow<...>()` call when the
-* step is declared inline inside `steps: [...]`. To author a step
-* outside that context with full typing, pass them explicitly:
-* `ai.step<MyInput, MyState, MyContext>({ ... })`.
-*/
-function step(definition) {
-	validate(definition);
-	return definition;
-}
-function validate(def) {
-	if (!def.name || typeof def.name !== "string") throw new WorkflowError("ai.step: `name` is required");
-	const hasRun = typeof def.run === "function";
-	const hasAgent = def.agent !== void 0;
-	const modes = [
-		hasRun,
-		hasAgent,
-		Array.isArray(def.parallel) && def.parallel.length > 0
-	].filter(Boolean).length;
-	if (modes === 0) throw new WorkflowError(`ai.step("${def.name}"): must define exactly one of run | agent | parallel`);
-	if (modes > 1) throw new WorkflowError(`ai.step("${def.name}"): define only one of run | agent | parallel`);
-	if (hasAgent && typeof def.input !== "function") throw new WorkflowError(`ai.step("${def.name}"): \`input(ctx)\` is required when \`agent\` is set`);
-}
-
-//#endregion
-export { step };
-//# sourceMappingURL=step.mjs.map

package/esm/ai/src/workflow/step.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"step.mjs","names":[],"sources":["../../../../../../../../../@warlock.js/ai/src/workflow/step.ts"],"sourcesContent":["import type { StepDefinition } from \"../contracts/workflow/step.contract\";\nimport { WorkflowError } from \"../errors\";\n\n/**\n * `ai.step(def)` — pass-through factory used for authoring. Returns\n * the definition object verbatim so the workflow engine can read it\n * during execution; the factory exists for API symmetry with\n * `ai.workflow()` and to leave room for future validation or\n * metadata annotation.\n *\n * Generics flow from the enclosing `ai.workflow<...>()` call when the\n * step is declared inline inside `steps: [...]`. To author a step\n * outside that context with full typing, pass them explicitly:\n * `ai.step<MyInput, MyState, MyContext>({ ... })`.\n */\nexport function step<\n  TInput = unknown,\n  TState = Record<string, unknown>,\n  TContext = unknown,\n>(\n  definition: StepDefinition<TInput, TState, TContext>,\n): StepDefinition<TInput, TState, TContext> {\n  validate(definition);\n  return definition;\n}\n\nfunction validate<TInput, TState, TContext>(\n  def: StepDefinition<TInput, TState, TContext>,\n): void {\n  if (!def.name || typeof def.name !== \"string\") {\n    throw new WorkflowError(\"ai.step: `name` is required\");\n  }\n\n  const hasRun = typeof def.run === \"function\";\n  const hasAgent = def.agent !== undefined;\n  const hasParallel = Array.isArray(def.parallel) && def.parallel.length > 0;\n\n  const modes = [hasRun, hasAgent, hasParallel].filter(Boolean).length;\n\n  if (modes === 0) {\n    throw new WorkflowError(\n      `ai.step(\"${def.name}\"): must define exactly one of run | agent | parallel`,\n    );\n  }\n\n  if (modes > 1) {\n    throw new WorkflowError(\n      `ai.step(\"${def.name}\"): define only one of run | agent | parallel`,\n    );\n  }\n\n  if (hasAgent && typeof def.input !== \"function\") {\n    throw new WorkflowError(\n      `ai.step(\"${def.name}\"): \\`input(ctx)\\` is required when \\`agent\\` is set`,\n    );\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAeA,SAAgB,KAKd,YAC0C;CAC1C,SAAS,UAAU;CACnB,OAAO;AACT;AAEA,SAAS,SACP,KACM;CACN,IAAI,CAAC,IAAI,QAAQ,OAAO,IAAI,SAAS,UACnC,MAAM,IAAI,cAAc,6BAA6B;CAGvD,MAAM,SAAS,OAAO,IAAI,QAAQ;CAClC,MAAM,WAAW,IAAI,UAAU;CAG/B,MAAM,QAAQ;EAAC;EAAQ;EAFH,MAAM,QAAQ,IAAI,QAAQ,KAAK,IAAI,SAAS,SAAS;CAE7B,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC;CAE9D,IAAI,UAAU,GACZ,MAAM,IAAI,cACR,YAAY,IAAI,KAAK,sDACvB;CAGF,IAAI,QAAQ,GACV,MAAM,IAAI,cACR,YAAY,IAAI,KAAK,8CACvB;CAGF,IAAI,YAAY,OAAO,IAAI,UAAU,YACnC,MAAM,IAAI,cACR,YAAY,IAAI,KAAK,qDACvB;AAEJ"}