@voltro/plugin-ai-flows 0.34.0 → 0.35.0

package/dist/index.js

@@ -1,18 +1,18 @@
-import { BriefField as e, ChainPending as t, FlowCadence as n, FlowChain as r, FlowMode as i, FlowStatus as a, FlowStep as o, HumanResponse as s, Json as c, MAX_STEPS_DEFAULT as l, MAX_STEPS_MAX as u, MAX_STEPS_MIN as d, MediaInputSlot as f, MediaInputs as p, Modality as m, ReviewMode as h, ReviewOption as g, RunReview as ee, RunSource as te, RunStatus as ne, RunStep as re, RunStepStatus as ie, StepType as ae, Visibility as oe, clampMaxSteps as se, normalizeFlow as _, sanitizeOutputKey as ce } from "./ir.js";
-import { FLOW_RUN_WORKFLOW as v, HUMAN_RESPONSE_SIGNAL_PREFIX as le, humanResponseSignalName as y } from "./workflow.js";
-import { FlowBriefIncomplete as ue, FlowCapabilityMissing as b, FlowDependencyError as de, FlowNotAwaitingResponse as fe, FlowNotFound as pe, FlowRunNotFound as x, FlowValidationError as me } from "./errors.js";
-import { n as he, t as ge } from "./cadence-Bt6dPelT.js";
-import { Cause as _e, Effect as S, Schema as C } from "effect";
-import { definePlugin as ve, pluginInstanceName as ye } from "@voltro/protocol";
-import { boolean as be, eq as w, id as xe, inSet as Se, integer as T, json as E, queryFor as D, registerRetention as Ce, table as we, text as O, timestamp as k } from "@voltro/database";
-import { tenant as Te } from "@voltro/plugin-multitenancy/mixin";
-import { audit as Ee } from "@voltro/plugin-audit/mixin";
-import { softDelete as De } from "@voltro/plugin-soft-delete/mixin";
-import { awaitSignalSuspending as Oe, step as A } from "@voltro/workflow";
-import { defineTool as j, estimateCostUsd as ke, gatewayCostUsd as Ae, generateImage as je, generateObject as Me, generateObjectWithTools as Ne, generateSpeech as Pe, generateText as M, generateVideo as Fe } from "@voltro/ai";
+import { A as e, C as t, D as n, E as r, M as i, O as a, S as o, T as s, _ as c, a as l, b as u, c as d, d as f, f as p, g as m, h, i as g, j as _, k as ee, l as te, m as ne, n as re, o as ie, p as ae, r as oe, s as se, t as ce, u as le, v as ue, w as de, x as fe, y as pe } from "./ir-BOv5uwYI.js";
+import { FLOW_RUN_WORKFLOW as v, HUMAN_RESPONSE_SIGNAL_PREFIX as me, humanResponseSignalName as y } from "./workflow.js";
+import { FlowBriefIncomplete as he, FlowCapabilityMissing as b, FlowDependencyError as ge, FlowNotAwaitingResponse as _e, FlowNotFound as ve, FlowRunNotFound as x, FlowValidationError as ye } from "./errors.js";
+import { n as be, t as xe } from "./cadence-Bt6dPelT.js";
+import { Cause as Se, Effect as S, Schema as C } from "effect";
+import { definePlugin as Ce, pluginInstanceName as we } from "@voltro/protocol";
+import { boolean as Te, eq as w, id as Ee, inSet as De, integer as T, json as E, queryFor as D, registerRetention as Oe, table as ke, text as O, timestamp as k } from "@voltro/database";
+import { tenant as Ae } from "@voltro/plugin-multitenancy/mixin";
+import { audit as je } from "@voltro/plugin-audit/mixin";
+import { softDelete as Me } from "@voltro/plugin-soft-delete/mixin";
+import { awaitSignalSuspending as Ne, step as A } from "@voltro/workflow";
+import { defineTool as j, estimateCostUsd as Pe, gatewayCostUsd as Fe, generateImage as Ie, generateObject as Le, generateObjectWithTools as Re, generateSpeech as ze, generateText as M, generateVideo as Be } from "@voltro/ai";
 //#region src/table.ts
-var N = we("_voltro_ai_flows", {
-	id: xe({ prefix: "aifl" }),
+var N = ke("_voltro_ai_flows", {
+	id: Ee({ prefix: "aifl" }),
 	name: O(),
 	description: O().nullable(),
 	mode: O().default("deterministic"),
@@ -26,15 +26,15 @@ var N = we("_voltro_ai_flows", {
 	chainTo: E().nullable(),
 	cadence: E().nullable(),
 	humanTimeoutMs: T().nullable(),
-	isEnabled: be().default(!0),
+	isEnabled: Te().default(!0),
 	metadata: E().nullable(),
 	icon: O().nullable(),
 	color: O().nullable(),
 	avatarUrl: O().nullable(),
 	usageCount: T().default(0),
 	ownerId: O().nullable()
-}).renamedFrom("ai_flows").with(Te(), Ee(), De()).index(["status"]).index(["visibility"]), P = we("_voltro_ai_flow_runs", {
-	id: xe({ prefix: "aifr" }),
+}).renamedFrom("ai_flows").with(Ae(), je(), Me()).index(["status"]).index(["visibility"]), P = ke("_voltro_ai_flow_runs", {
+	id: Ee({ prefix: "aifr" }),
 	flowRef: O(),
 	flowName: O().nullable(),
 	mode: O().default("deterministic"),
@@ -48,6 +48,7 @@ var N = we("_voltro_ai_flows", {
 	totalSteps: T().default(0),
 	humanResponse: E().nullable(),
 	chainPending: E().nullable(),
+	chainRefusal: O().nullable(),
 	costMicroUsd: T().default(0),
 	durationMs: T().nullable(),
 	error: O().nullable(),
@@ -59,31 +60,67 @@ var N = we("_voltro_ai_flows", {
 	sessionName: O().nullable(),
 	ownerId: O().nullable(),
 	metadata: E().nullable()
-}).renamedFrom("ai_flow_runs").with(Te(), Ee()).index(["flowRef"]).index(["status"]).index(["requestId"]), Ie = [N, P], Le = 168, Re = "VOLTRO_AI_FLOW_HUMAN_REVIEW_TIMEOUT_HOURS", ze = 2160, Be = "VOLTRO_AI_FLOW_RUNS_TTL_HOURS", F = { current: {} }, Ve = (e) => {
+}).renamedFrom("ai_flow_runs").with(Ae(), je()).index(["flowRef"]).index(["status"]).index(["requestId"]), Ve = [N, P], He = 168, Ue = "VOLTRO_AI_FLOW_HUMAN_REVIEW_TIMEOUT_HOURS", We = 2160, Ge = "VOLTRO_AI_FLOW_RUNS_TTL_HOURS", Ke = 5, qe = "VOLTRO_AI_FLOW_MAX_CHAIN_DEPTH", F = { current: {} }, Je = (e) => {
 	F.current = e;
-}, He = () => F.current, Ue = () => {
+}, I = () => F.current, Ye = () => {
 	F.current = {};
-}, I = (e, t) => {
+}, Xe = (e, t) => {
 	if (e === void 0 || e.trim() === "") return t * 36e5;
 	let n = Number(e);
 	return !Number.isFinite(n) || n < 0 ? t * 36e5 : n * 36e5;
-}, We = (e) => Number.isFinite(e) && e > 0 ? e : Infinity, Ge = (e) => {
+}, Ze = (e) => Number.isFinite(e) && e > 0 ? e : Infinity, Qe = (e) => {
 	let t = e.env ?? process.env;
-	return We(e.step?.timeoutMs ?? e.flow?.humanTimeoutMs ?? e.deps?.humanReviewTimeoutMs ?? He().humanReviewTimeoutMs ?? I(t.VOLTRO_AI_FLOW_HUMAN_REVIEW_TIMEOUT_HOURS, 168));
-}, Ke = /\{\{\s*([\w.-]+)\s*\}\}/g, L = (e) => {
+	return Ze(e.step?.timeoutMs ?? e.flow?.humanTimeoutMs ?? e.deps?.humanReviewTimeoutMs ?? I().humanReviewTimeoutMs ?? Xe(t.VOLTRO_AI_FLOW_HUMAN_REVIEW_TIMEOUT_HOURS, 168));
+}, $e = (e) => {
+	let t = e?.env ?? process.env, n = Number(t[qe]), r = e?.maxChainDepth ?? I().maxChainDepth ?? (Number.isFinite(n) && n >= 1 ? n : 5);
+	return Number.isFinite(r) && r >= 1 ? r : 5;
+}, et = /\{\{\s*([\w.-]+)\s*\}\}/g, L = (e) => {
 	let t = [];
-	for (let n of e.matchAll(Ke)) t.push(n[1]);
+	for (let n of e.matchAll(et)) t.push(n[1]);
 	return t;
-}, R = (e, t) => e.replace(Ke, (e, n) => {
+}, R = (e, t) => e.replace(et, (e, n) => {
 	let r = t[n];
 	return r == null ? "" : typeof r == "string" ? r : JSON.stringify(r);
-}), qe = (e, t) => {
+}), tt = (e, t) => {
 	let n = /* @__PURE__ */ new Set();
 	for (let r of L(e)) t[r] == null && !n.has(r) && n.add(r);
 	return [...n];
-}, z = /* @__PURE__ */ new Map(), Je = (e) => {
-	z.set(e.name, e);
-}, Ye = (e) => z.get(e), Xe = () => [...z.values()], Ze = () => z.clear(), B = (e) => typeof e == "object" && e && !Array.isArray(e) ? e : void 0, V = (e) => Array.isArray(e) ? e : void 0, Qe = (e) => {
+}, z = (e) => {
+	let t = [], n;
+	if (e.forEach((e, r) => {
+		let i = e.group;
+		if (i !== void 0 && n !== void 0 && n.group === i) {
+			n.steps.push({
+				index: r,
+				step: e
+			});
+			return;
+		}
+		n !== void 0 && t.push({
+			...n.group === void 0 ? {} : { group: n.group },
+			steps: n.steps
+		}), n = {
+			...i === void 0 ? {} : { group: i },
+			steps: [{
+				index: r,
+				step: e
+			}]
+		};
+	}), n !== void 0) {
+		let e = n;
+		t.push({
+			...e.group === void 0 ? {} : { group: e.group },
+			steps: e.steps
+		});
+	}
+	return t;
+}, nt = (e) => {
+	let t = /* @__PURE__ */ new Map();
+	for (let n of e) n.group !== void 0 && t.set(n.group, (t.get(n.group) ?? 0) + 1);
+	return [...t.entries()].filter(([, e]) => e > 1).map(([e]) => e).sort();
+}, B = /* @__PURE__ */ new Map(), rt = (e) => {
+	B.set(e.name, e);
+}, it = (e) => B.get(e), at = () => [...B.values()], ot = () => B.clear(), V = (e) => typeof e == "object" && e && !Array.isArray(e) ? e : void 0, H = (e) => Array.isArray(e) ? e : void 0, st = (e) => {
 	switch (e) {
 		case "string": return C.String;
 		case "number": return C.Number;
@@ -92,69 +129,69 @@ var N = we("_voltro_ai_flows", {
 		case "null": return C.Null;
 		default: return C.Unknown;
 	}
-}, H = (e, t) => {
+}, U = (e, t) => {
 	let n = typeof t.description == "string" ? t.description : void 0, r = typeof t.title == "string" ? t.title : void 0;
 	return n === void 0 && r === void 0 ? e : e.annotations({
 		...n === void 0 ? {} : { description: n },
 		...r === void 0 ? {} : { title: r }
 	});
-}, $e = (e) => e.length === 0 ? C.Unknown : e.length === 1 ? e[0] : C.Union(...e), et = () => C.Record({
+}, ct = (e) => e.length === 0 ? C.Unknown : e.length === 1 ? e[0] : C.Union(...e), lt = () => C.Record({
 	key: C.String,
 	value: C.Unknown
-}), U = (e) => {
-	let t = B(e);
+}), W = (e) => {
+	let t = V(e);
 	if (t === void 0) return C.Unknown;
-	if ("const" in t) return H(C.Literal(t.const), t);
-	let n = V(t.enum);
-	if (n !== void 0 && n.length > 0) return H(C.Literal(...n), t);
-	let r = V(t.anyOf) ?? V(t.oneOf);
-	if (r !== void 0) return H($e(r.map(U)), t);
-	let i = t.type, a = typeof i == "string" ? [i] : V(i)?.filter((e) => typeof e == "string") ?? [], o = t.nullable === !0 || a.includes("null"), s = a.find((e) => e !== "null"), c = s === "object" || s === void 0 && t.properties !== void 0 ? tt(t) : s === "array" || s === void 0 && t.items !== void 0 ? C.Array(U(t.items)) : s === void 0 ? C.Unknown : Qe(s);
-	return H(o ? C.NullOr(c) : c, t);
-}, tt = (e) => {
-	let t = B(e.properties);
-	if (t === void 0) return et();
-	let n = new Set((V(e.required) ?? []).filter((e) => typeof e == "string")), r = {};
+	if ("const" in t) return U(C.Literal(t.const), t);
+	let n = H(t.enum);
+	if (n !== void 0 && n.length > 0) return U(C.Literal(...n), t);
+	let r = H(t.anyOf) ?? H(t.oneOf);
+	if (r !== void 0) return U(ct(r.map(W)), t);
+	let i = t.type, a = typeof i == "string" ? [i] : H(i)?.filter((e) => typeof e == "string") ?? [], o = t.nullable === !0 || a.includes("null"), s = a.find((e) => e !== "null"), c = s === "object" || s === void 0 && t.properties !== void 0 ? ut(t) : s === "array" || s === void 0 && t.items !== void 0 ? C.Array(W(t.items)) : s === void 0 ? C.Unknown : st(s);
+	return U(o ? C.NullOr(c) : c, t);
+}, ut = (e) => {
+	let t = V(e.properties);
+	if (t === void 0) return lt();
+	let n = new Set((H(e.required) ?? []).filter((e) => typeof e == "string")), r = {};
 	for (let [e, i] of Object.entries(t)) {
-		let t = U(i);
+		let t = W(i);
 		r[e] = n.has(e) ? t : C.optional(t);
 	}
 	return C.Struct(r);
-}, nt = (e) => {
-	let t = B(e);
-	return t === void 0 || Object.keys(t).length === 0 ? et() : U(t);
-}, W = (e) => e, rt = C.Struct({
+}, dt = (e) => {
+	let t = V(e);
+	return t === void 0 || Object.keys(t).length === 0 ? lt() : W(t);
+}, G = (e) => e, ft = C.Struct({
 	value: C.optional(C.Unknown),
 	text: C.optional(C.String),
 	url: C.optional(C.String),
 	costMicroUsd: C.optional(C.Number),
 	requestId: C.optional(C.String),
 	error: C.optional(C.String)
-}), G = () => (/* @__PURE__ */ new Date()).toISOString(), it = (e) => Math.round(e * 1e6), K = (e, t) => e.resolveModel?.(t) ?? K(e, t), q = (e, t, n) => {
-	let r = Ae(t);
-	return typeof r == "number" ? it(r) : ke(e, { model: n ?? "unknown" }).costMicroUsd ?? 0;
-}, J = (e, t, n) => S.promise(() => e.store.update(P.tableName, t, n).then(() => void 0)).pipe(S.catchAllCause(() => S.void)), at = (e, t) => S.promise(async () => (await e.store.query(D(P).where(w("id", t)).descriptor))[0]?.status === "cancelled").pipe(S.catchAllCause(() => S.succeed(!1))), Y = (e, t) => S.gen(function* () {
-	let n = Ye(t);
+}), K = () => (/* @__PURE__ */ new Date()).toISOString(), pt = (e) => Math.round(e * 1e6), q = (e, t) => e.resolveModel?.(t) ?? q(e, t), J = (e, t, n) => {
+	let r = Fe(t);
+	return typeof r == "number" ? pt(r) : Pe(e, { model: n ?? "unknown" }).costMicroUsd ?? 0;
+}, Y = (e, t, n) => S.promise(() => e.store.update(P.tableName, t, n).then(() => void 0)).pipe(S.catchAllCause(() => S.void)), mt = (e, t) => S.promise(async () => (await e.store.query(D(P).where(w("id", t)).descriptor))[0]?.status === "cancelled").pipe(S.catchAllCause(() => S.succeed(!1))), X = (e, t) => S.gen(function* () {
+	let n = it(t);
 	if (n) return n;
-	let r = (yield* S.promise(() => e.store.query(D(N).where(w("id", t)).descriptor)))[0];
-	return r ? _({
-		name: r.name ?? t,
-		mode: r.mode,
-		steps: r.steps ?? [],
-		maxSteps: r.maxSteps ?? null,
-		brief: r.inputSchema ?? [],
-		orchestratorModel: r.orchestratorModel ?? null,
-		orchestratorInstructions: r.orchestratorInstructions ?? null,
-		chain: r.chainTo ?? null,
-		cadence: r.cadence ?? null,
-		humanTimeoutMs: r.humanTimeoutMs ?? null
-	}) : yield* S.fail(new pe({
+	let i = (yield* S.promise(() => e.store.query(D(N).where(w("id", t)).descriptor)))[0];
+	return i ? r({
+		name: i.name ?? t,
+		mode: i.mode,
+		steps: i.steps ?? [],
+		maxSteps: i.maxSteps ?? null,
+		brief: i.inputSchema ?? [],
+		orchestratorModel: i.orchestratorModel ?? null,
+		orchestratorInstructions: i.orchestratorInstructions ?? null,
+		chain: i.chainTo ?? null,
+		cadence: i.cadence ?? null,
+		humanTimeoutMs: i.humanTimeoutMs ?? null
+	}) : yield* S.fail(new ve({
 		flowRef: t,
 		message: `no flow registered or stored for "${t}"`
 	}));
-}), ot = (e, t, n, r, i) => S.gen(function* () {
-	let e = R(n.prompt ?? "", r), a = qe(n.prompt ?? "", r);
-	if (a.length > 0) return { error: new de({
+}), ht = (e, t, n, r, i) => S.gen(function* () {
+	let e = R(n.prompt ?? "", r), a = tt(n.prompt ?? "", r);
+	if (a.length > 0) return { error: new ge({
 		stepId: n.id,
 		unresolvedRef: a[0],
 		message: `step "${n.id}" references unresolved {{${a[0]}}}`
@@ -171,7 +208,7 @@ var N = we("_voltro_ai_flows", {
 				capability: "resolveAgent",
 				message: "no agent resolver configured"
 			}).message };
-			let r = yield* W(t.resolveAgent(n.agentRef)).pipe(S.map((e) => ({
+			let r = yield* G(t.resolveAgent(n.agentRef)).pipe(S.map((e) => ({
 				ok: !0,
 				a: e
 			})), S.catchAll((e) => S.succeed({
@@ -182,7 +219,7 @@ var N = we("_voltro_ai_flows", {
 			let i = yield* M({
 				system: r.a.system,
 				prompt: e,
-				provider: K(t, r.a.model)
+				provider: q(t, r.a.model)
 			}).pipe(S.map((e) => ({
 				ok: !0,
 				r: e
@@ -193,14 +230,14 @@ var N = we("_voltro_ai_flows", {
 			return i.ok ? {
 				value: i.r.text,
 				text: i.r.text,
-				costMicroUsd: q(i.r.usage, i.r.providerMetadata, r.a.model)
+				costMicroUsd: J(i.r.usage, i.r.providerMetadata, r.a.model)
 			} : { error: String(i.e.message ?? i.e) };
 		}
 		case "structured": {
-			let r = n.model ?? t.defaultModels?.text, i = yield* Me({
+			let r = n.model ?? t.defaultModels?.text, i = yield* Le({
 				prompt: e,
-				schema: nt(n.schema),
-				...r ? { provider: K(t, r) } : {}
+				schema: dt(n.schema),
+				...r ? { provider: q(t, r) } : {}
 			}).pipe(S.map((e) => ({
 				ok: !0,
 				r: e
@@ -211,7 +248,7 @@ var N = we("_voltro_ai_flows", {
 			return i.ok ? {
 				value: i.r.object,
 				text: JSON.stringify(i.r.object, null, 2),
-				costMicroUsd: q(i.r.usage, i.r.providerMetadata, r)
+				costMicroUsd: J(i.r.usage, i.r.providerMetadata, r)
 			} : { error: String(i.e.message ?? i.e) };
 		}
 		case "generate": {
@@ -219,7 +256,7 @@ var N = we("_voltro_ai_flows", {
 			if (r === "text") {
 				let r = n.model ?? t.defaultModels?.text, i = yield* M({
 					prompt: e,
-					...r ? { provider: K(t, r) } : {}
+					...r ? { provider: q(t, r) } : {}
 				}).pipe(S.map((e) => ({
 					ok: !0,
 					r: e
@@ -230,14 +267,14 @@ var N = we("_voltro_ai_flows", {
 				return i.ok ? {
 					value: i.r.text,
 					text: i.r.text,
-					costMicroUsd: q(i.r.usage, i.r.providerMetadata, r)
+					costMicroUsd: J(i.r.usage, i.r.providerMetadata, r)
 				} : { error: String(i.e.message ?? i.e) };
 			}
 			if (!t.generateMedia) return { error: new b({
 				capability: `media:${r}`,
 				message: `no media generator configured for ${r}`
 			}).message };
-			let a = n.model ?? t.defaultModels?.[r], o = yield* W(t.generateMedia({
+			let a = n.model ?? t.defaultModels?.[r], o = yield* G(t.generateMedia({
 				modality: r,
 				...a ? { model: a } : {},
 				prompt: e,
@@ -263,247 +300,347 @@ var N = we("_voltro_ai_flows", {
 		}).message };
 		default: return { error: `unknown step type: ${String(n.type)}` };
 	}
-}), st = (e, t, n, r, i, a) => S.gen(function* () {
-	let o = { ...i }, c = r.steps.map((e, t) => ({
+}), gt = (t, n, r, i, a, o) => S.gen(function* () {
+	let s = { ...a }, c = i.steps.map((e, t) => ({
 		id: t,
 		title: e.title ?? `Step ${t + 1}`,
 		type: e.type,
 		status: "pending",
 		...e.description ? { description: e.description } : {}
 	})), l = 0;
-	yield* J(e, n, {
+	yield* Y(t, r, {
 		status: "running",
 		steps: c,
-		totalSteps: r.steps.length,
+		totalSteps: i.steps.length,
 		currentStep: 0,
-		startedAt: G()
+		startedAt: K()
 	});
-	for (let [i, u] of r.steps.entries()) {
-		if (yield* at(e, n)) return {
-			runId: n,
+	for (let a of z(i.steps)) {
+		if (yield* mt(t, r)) return {
+			runId: r,
 			status: "cancelled"
 		};
-		if (u.type === "human") {
-			let d = {
-				mode: u.reviewMode ?? "approve",
-				...u.options ? { options: u.options } : {},
-				prompt: R(u.prompt ?? "", o)
+		if (a.steps.length > 1) {
+			let i = [];
+			for (let { index: t, step: n } of a.steps) {
+				if (n.when !== void 0 && !_(n.when, s)) {
+					c[t] = {
+						...c[t],
+						status: "skipped",
+						completedAt: K(),
+						skipReason: e(n.when)
+					};
+					continue;
+				}
+				i.push({
+					index: t,
+					step: n
+				}), c[t] = {
+					...c[t],
+					status: "running",
+					startedAt: K()
+				};
+			}
+			yield* Y(t, r, {
+				steps: c,
+				currentStep: a.steps[0].index
+			});
+			let u = yield* S.all(i.map(({ index: e, step: i }) => A({
+				name: `flow-${e}-${i.id}`,
+				input: { index: e },
+				success: ft,
+				execute: ht(t, n, i, s, {
+					runId: r,
+					tenantId: o.tenantId
+				})
+			}).pipe(S.map((t) => ({
+				index: e,
+				step: i,
+				result: t
+			})))), { concurrency: "unbounded" }), d = u.find((e) => e.result.error);
+			for (let { index: e, step: t, result: n } of u) {
+				if (n.error) {
+					c[e] = {
+						...c[e],
+						status: "failed",
+						completedAt: K(),
+						errorMessage: n.error
+					};
+					continue;
+				}
+				t.outputKey && n.value !== void 0 && (s[t.outputKey] = n.value), l += n.costMicroUsd ?? 0, c[e] = {
+					...c[e],
+					status: "succeeded",
+					completedAt: K(),
+					...n.text ? { output: { text: n.text } } : {},
+					...n.url ? { url: n.url } : {},
+					...n.requestId ? { requestId: n.requestId } : {},
+					...n.costMicroUsd ? { costMicroUsd: n.costMicroUsd } : {}
+				};
+			}
+			if (d !== void 0) return yield* Y(t, r, {
+				steps: c,
+				status: "failed",
+				errorMessage: d.result.error,
+				completedAt: K(),
+				costMicroUsd: l
+			}), {
+				runId: r,
+				status: "failed"
 			};
-			c[i] = {
-				...c[i],
+			yield* Y(t, r, {
+				steps: c,
+				currentStep: a.steps[a.steps.length - 1].index + 1,
+				costMicroUsd: l
+			});
+			continue;
+		}
+		let { index: u, step: f } = a.steps[0];
+		if (f.when !== void 0 && !_(f.when, s)) {
+			c[u] = {
+				...c[u],
+				status: "skipped",
+				completedAt: K(),
+				skipReason: e(f.when)
+			}, yield* Y(t, r, {
+				steps: c,
+				currentStep: u + 1
+			});
+			continue;
+		}
+		if (f.type === "human") {
+			let e = {
+				mode: f.reviewMode ?? "approve",
+				...f.options ? { options: f.options } : {},
+				prompt: R(f.prompt ?? "", s)
+			};
+			c[u] = {
+				...c[u],
 				status: "waiting",
-				startedAt: G(),
-				review: d
-			}, yield* J(e, n, {
+				startedAt: K(),
+				review: e
+			}, yield* Y(t, r, {
 				steps: c,
 				status: "waiting",
-				currentStep: i
-			}), t.onEvent && (yield* W(t.onEvent({
+				currentStep: u
+			}), n.onEvent && (yield* G(n.onEvent({
 				kind: "review-needed",
-				runId: n,
-				flowName: r.name,
-				ownerId: a.ownerId,
-				source: a.source
+				runId: r,
+				flowName: i.name,
+				ownerId: o.ownerId,
+				source: o.source
 			})).pipe(S.catchAllCause(() => S.void)));
-			let f = Ge({
-				step: u,
-				flow: r,
-				deps: t
-			}), p = yield* Oe(e, {
-				name: y(i),
-				schema: s,
-				timeoutMs: f
+			let a = Qe({
+				step: f,
+				flow: i,
+				deps: n
+			}), p = yield* Ne(t, {
+				name: y(u),
+				schema: d,
+				timeoutMs: a
 			}).pipe(S.map((e) => ({
 				ok: !0,
 				a: e
-			})), S.catchAllCause((e) => _e.isInterruptedOnly(e) ? S.failCause(e) : S.succeed({
+			})), S.catchAllCause((e) => Se.isInterruptedOnly(e) ? S.failCause(e) : S.succeed({
 				ok: !1,
 				cause: e
 			})));
 			if (!p.ok) {
-				let t = Number.isFinite(f) ? `human review timed out after ${f}ms` : "human review failed";
-				return c[i] = {
-					...c[i],
+				let e = Number.isFinite(a) ? `human review timed out after ${a}ms` : "human review failed";
+				return c[u] = {
+					...c[u],
 					status: "failed",
-					completedAt: G(),
-					errorMessage: t
-				}, yield* J(e, n, {
+					completedAt: K(),
+					errorMessage: e
+				}, yield* Y(t, r, {
 					steps: c,
 					status: "failed",
-					errorMessage: t,
-					completedAt: G(),
+					errorMessage: e,
+					completedAt: K(),
 					costMicroUsd: l
 				}), {
-					runId: n,
+					runId: r,
 					status: "failed"
 				};
 			}
 			let m = p.a;
-			if (m.decision === "reject") return c[i] = {
-				...c[i],
+			if (m.decision === "reject") return c[u] = {
+				...c[u],
 				status: "failed",
-				completedAt: G(),
+				completedAt: K(),
 				errorMessage: "rejected by reviewer"
-			}, yield* J(e, n, {
+			}, yield* Y(t, r, {
 				steps: c,
 				status: "cancelled",
-				completedAt: G(),
+				completedAt: K(),
 				costMicroUsd: l
 			}), {
-				runId: n,
+				runId: r,
 				status: "cancelled"
 			};
-			u.outputKey && (o[u.outputKey] = m.value ?? m.text ?? m.decision ?? !0), c[i] = {
-				...c[i],
+			f.outputKey && (s[f.outputKey] = m.value ?? m.text ?? m.decision ?? !0), c[u] = {
+				...c[u],
 				status: "succeeded",
-				completedAt: G(),
+				completedAt: K(),
 				output: { text: String(m.text ?? m.value ?? m.decision ?? "approved") }
-			}, yield* J(e, n, {
+			}, yield* Y(t, r, {
 				steps: c,
 				status: "running",
-				currentStep: i + 1
+				currentStep: u + 1
 			});
 			continue;
 		}
-		c[i] = {
-			...c[i],
+		c[u] = {
+			...c[u],
 			status: "running",
-			startedAt: G()
-		}, yield* J(e, n, {
+			startedAt: K()
+		}, yield* Y(t, r, {
 			steps: c,
-			currentStep: i
+			currentStep: u
 		});
-		let d = yield* A({
-			name: `flow-${i}-${u.id}`,
-			input: { index: i },
-			success: rt,
-			execute: ot(e, t, u, o, {
-				runId: n,
-				tenantId: a.tenantId
+		let p = yield* A({
+			name: `flow-${u}-${f.id}`,
+			input: { index: u },
+			success: ft,
+			execute: ht(t, n, f, s, {
+				runId: r,
+				tenantId: o.tenantId
 			})
 		});
-		if (d.error) return c[i] = {
-			...c[i],
+		if (p.error) return c[u] = {
+			...c[u],
 			status: "failed",
-			completedAt: G(),
-			errorMessage: d.error
-		}, yield* J(e, n, {
+			completedAt: K(),
+			errorMessage: p.error
+		}, yield* Y(t, r, {
 			steps: c,
 			status: "failed",
-			errorMessage: d.error,
-			completedAt: G(),
+			errorMessage: p.error,
+			completedAt: K(),
 			costMicroUsd: l
 		}), {
-			runId: n,
+			runId: r,
 			status: "failed"
 		};
-		u.outputKey && d.value !== void 0 && (o[u.outputKey] = d.value), l += d.costMicroUsd ?? 0, c[i] = {
-			...c[i],
+		f.outputKey && p.value !== void 0 && (s[f.outputKey] = p.value), l += p.costMicroUsd ?? 0, c[u] = {
+			...c[u],
 			status: "succeeded",
-			completedAt: G(),
-			...d.text ? { output: { text: d.text } } : {},
-			...d.url ? { url: d.url } : {},
-			...d.requestId ? { requestId: d.requestId } : {},
-			...d.costMicroUsd ? { costMicroUsd: d.costMicroUsd } : {}
-		}, yield* J(e, n, {
+			completedAt: K(),
+			...p.text ? { output: { text: p.text } } : {},
+			...p.url ? { url: p.url } : {},
+			...p.requestId ? { requestId: p.requestId } : {},
+			...p.costMicroUsd ? { costMicroUsd: p.costMicroUsd } : {}
+		}, yield* Y(t, r, {
 			steps: c,
-			currentStep: i + 1,
+			currentStep: u + 1,
 			costMicroUsd: l
 		});
 	}
 	let u = {};
-	for (let e of r.steps) e.outputKey && o[e.outputKey] !== void 0 && (u[e.outputKey] = o[e.outputKey]);
-	return yield* J(e, n, {
+	for (let e of i.steps) e.outputKey && s[e.outputKey] !== void 0 && (u[e.outputKey] = s[e.outputKey]);
+	return yield* Y(t, r, {
 		status: "succeeded",
 		output: u,
-		completedAt: G(),
+		completedAt: K(),
 		costMicroUsd: l
 	}), {
-		runId: n,
+		runId: r,
 		status: "succeeded",
 		output: u
 	};
-}), ct = (e, t, n, r, i, a) => S.gen(function* () {
-	let o = n.chain;
-	if (!o || o.flowRef === n.name || o.flowRef === a.flowRef) return;
-	let s = {
+}), _t = (e, t, n, r, i, a, o) => S.gen(function* () {
+	let s = n.chain;
+	if (!s) return;
+	let c = [...a.chainPath ?? [], a.flowRef];
+	if (s.flowRef === n.name || s.flowRef === a.flowRef) return;
+	if (c.includes(s.flowRef)) {
+		yield* Y(e, t, { chainRefusal: `chain to "${s.flowRef}" refused — it is already in this run's chain (${c.join(" → ")}), which would loop` });
+		return;
+	}
+	let l = $e(o);
+	if (c.length >= l) {
+		yield* Y(e, t, { chainRefusal: `chain to "${s.flowRef}" refused — depth ${c.length} reached the limit of ${l} (${c.join(" → ")})` });
+		return;
+	}
+	let u = {
 		...r,
 		...i
-	}, c = {};
-	for (let e of o.mappings) e.sourceKey in s && (c[e.targetKey] = s[e.sourceKey]);
-	if (o.requireConfirmation) {
-		yield* J(e, t, { chainPending: {
-			flowRef: o.flowRef,
-			input: c,
+	}, d = {};
+	for (let e of s.mappings) e.sourceKey in u && (d[e.targetKey] = u[e.sourceKey]);
+	if (s.requireConfirmation) {
+		yield* Y(e, t, { chainPending: {
+			flowRef: s.flowRef,
+			input: d,
 			status: "pending"
 		} });
 		return;
 	}
-	let l = e.workflows;
-	if (!l) return;
-	let u = `${t}--chain`, d = `${a.requestId}--chain`;
+	let f = e.workflows;
+	if (!f) return;
+	let p = `${t}--chain`, m = `${a.requestId}--chain`;
 	yield* S.promise(async () => {
 		try {
 			await e.store.insert(P.tableName, {
-				id: u,
-				flowRef: o.flowRef,
-				flowName: o.flowRef,
+				id: p,
+				flowRef: s.flowRef,
+				flowName: s.flowRef,
 				status: "pending",
 				source: a.source,
-				requestId: d,
-				input: c
+				requestId: m,
+				input: d
 			});
 		} catch {}
-		await l.child("flow.run", {
-			runId: u,
-			flowRef: o.flowRef,
-			input: c,
+		await f.child("flow.run", {
+			runId: p,
+			flowRef: s.flowRef,
+			input: d,
 			source: a.source,
-			requestId: d
+			requestId: m,
+			chainPath: c
 		});
 	}).pipe(S.catchAllCause(() => S.void));
-}), lt = (e) => e.steps.length === 0 ? "" : "Suggested plan (you MAY reorder, insert, or skip steps):\n" + e.steps.map((e, t) => `${t + 1}. [${e.type}${e.modality ? `/${e.modality}` : ""}] ${e.title ?? e.id}${e.prompt ? `: ${e.prompt}` : ""}`).join("\n"), ut = (e) => {
+}), vt = (e) => e.steps.length === 0 ? "" : "Suggested plan (you MAY reorder, insert, or skip steps):\n" + e.steps.map((e, t) => `${t + 1}. [${e.type}${e.modality ? `/${e.modality}` : ""}] ${e.title ?? e.id}${e.prompt ? `: ${e.prompt}` : ""}`).join("\n"), yt = (e) => {
 	let t = Object.entries(e);
 	return t.length === 0 ? "Execute the flow." : "Brief for this run:\n" + t.map(([e, t]) => `- ${e}: ${typeof t == "string" ? t : JSON.stringify(t)}`).join("\n");
-}, dt = (e) => [
+}, bt = (e) => [
 	e.orchestrator?.instructions ?? "You are an orchestrator that uses the available tools to produce a bundled result.",
-	lt(e),
+	vt(e),
 	"When finished, emit a JSON object mapping each deliverable name (outputKey) to its value."
-].filter(Boolean).join("\n\n"), ft = C.Struct({
+].filter(Boolean).join("\n\n"), xt = C.Struct({
 	object: C.Record({
 		key: C.String,
 		value: C.Unknown
 	}),
 	planCostMicroUsd: C.Number,
 	toolCostMicroUsd: C.Number,
-	steps: C.Array(re),
+	steps: C.Array(fe),
 	error: C.optional(C.String)
-}), pt = (e, t, n, r, i, a, o) => S.gen(function* () {
-	yield* J(e, n, {
+}), St = (e, t, n, r, i, a, o) => S.gen(function* () {
+	yield* Y(e, n, {
 		status: "running",
-		startedAt: G(),
+		startedAt: K(),
 		totalSteps: r.steps.length
 	});
 	let s = yield* A({
 		name: "flow-agentic",
 		input: { flowRef: r.name },
-		success: ft,
+		success: xt,
 		execute: S.gen(function* () {
 			let s = [], c = 0, l = (e) => {
 				let t = s.length;
 				return s.push({
 					id: t,
 					status: "running",
-					startedAt: G(),
+					startedAt: K(),
 					...e
 				}), t;
 			}, u = (e, t) => {
 				s[e] = {
 					...s[e],
-					completedAt: G(),
+					completedAt: K(),
 					...t
 				};
-			}, d = () => J(e, n, {
+			}, d = () => Y(e, n, {
 				steps: s,
 				currentStep: s.length,
 				costMicroUsd: c
@@ -523,7 +660,7 @@ var N = we("_voltro_ai_flows", {
 						status: "failed",
 						errorMessage: "no agent resolver configured"
 					}), yield* d(), "ERROR: no agent resolver configured";
-					let i = yield* W(t.resolveAgent(e)).pipe(S.map((e) => ({
+					let i = yield* G(t.resolveAgent(e)).pipe(S.map((e) => ({
 						ok: !0,
 						a: e
 					})), S.catchAll((e) => S.succeed({
@@ -537,7 +674,7 @@ var N = we("_voltro_ai_flows", {
 					let a = yield* M({
 						system: i.a.system,
 						prompt: n,
-						provider: K(t, i.a.model)
+						provider: q(t, i.a.model)
 					}).pipe(S.map((e) => ({
 						ok: !0,
 						r: e
@@ -552,7 +689,7 @@ var N = we("_voltro_ai_flows", {
 							errorMessage: e
 						}), yield* d(), `ERROR: ${e}`;
 					}
-					let o = q(a.r.usage, a.r.providerMetadata, i.a.model);
+					let o = J(a.r.usage, a.r.providerMetadata, i.a.model);
 					return c += o, u(r, {
 						status: "succeeded",
 						output: { text: a.r.text },
@@ -576,7 +713,7 @@ var N = we("_voltro_ai_flows", {
 						status: "failed",
 						errorMessage: `no media generator for ${e}`
 					}), yield* d(), `ERROR: no media generator configured for ${e}`;
-					let s = yield* W(t.generateMedia({
+					let s = yield* G(t.generateMedia({
 						modality: e,
 						prompt: r,
 						...i ? { model: i } : {},
@@ -614,13 +751,13 @@ var N = we("_voltro_ai_flows", {
 						type: "structured"
 					});
 					yield* d();
-					let i = yield* Me({
+					let i = yield* Le({
 						prompt: e,
 						schema: C.Record({
 							key: C.String,
 							value: C.Unknown
 						}),
-						...n ? { provider: K(t, n) } : {}
+						...n ? { provider: q(t, n) } : {}
 					}).pipe(S.map((e) => ({
 						ok: !0,
 						r: e
@@ -635,16 +772,16 @@ var N = we("_voltro_ai_flows", {
 							errorMessage: e
 						}), yield* d(), { error: e };
 					}
-					let a = q(i.r.usage, i.r.providerMetadata, n);
+					let a = J(i.r.usage, i.r.providerMetadata, n);
 					return c += a, u(r, {
 						status: "succeeded",
 						output: { text: JSON.stringify(i.r.object) },
 						costMicroUsd: a
 					}), yield* d(), i.r.object;
 				})
-			}), h = t.memoryPrefix ? yield* W(t.memoryPrefix(a)).pipe(S.catchAll(() => S.succeed(""))) : "", g = yield* Ne({
-				system: h ? `${h}\n\n${dt(r)}` : dt(r),
-				prompt: ut(i),
+			}), h = t.memoryPrefix ? yield* G(t.memoryPrefix(a)).pipe(S.catchAll(() => S.succeed(""))) : "", g = yield* Re({
+				system: h ? `${h}\n\n${bt(r)}` : bt(r),
+				prompt: yt(i),
 				schema: C.Record({
 					key: C.String,
 					value: C.Unknown
@@ -655,7 +792,7 @@ var N = we("_voltro_ai_flows", {
 					pick_structured: m
 				},
 				maxSteps: r.maxSteps,
-				...r.orchestrator?.model ? { provider: K(t, r.orchestrator.model) } : {}
+				...r.orchestrator?.model ? { provider: q(t, r.orchestrator.model) } : {}
 			}).pipe(S.map((e) => ({
 				ok: !0,
 				r: e
@@ -665,7 +802,7 @@ var N = we("_voltro_ai_flows", {
 			})));
 			return g.ok ? {
 				object: g.r.object,
-				planCostMicroUsd: q(g.r.usage, g.r.providerMetadata, r.orchestrator?.model),
+				planCostMicroUsd: J(g.r.usage, g.r.providerMetadata, r.orchestrator?.model),
 				toolCostMicroUsd: c,
 				steps: s
 			} : {
@@ -677,27 +814,27 @@ var N = we("_voltro_ai_flows", {
 			};
 		})
 	}), c = s.planCostMicroUsd + s.toolCostMicroUsd;
-	return s.error ? (yield* J(e, n, {
+	return s.error ? (yield* Y(e, n, {
 		status: "failed",
 		steps: s.steps,
 		errorMessage: s.error,
-		completedAt: G(),
+		completedAt: K(),
 		costMicroUsd: c
 	}), {
 		runId: n,
 		status: "failed"
-	}) : (yield* J(e, n, {
+	}) : (yield* Y(e, n, {
 		status: "succeeded",
 		steps: s.steps,
 		output: s.object,
-		completedAt: G(),
+		completedAt: K(),
 		costMicroUsd: c
 	}), {
 		runId: n,
 		status: "succeeded",
 		output: s.object
 	});
-}), mt = (e, t = {}) => (n, r) => S.gen(function* () {
+}), Ct = (e, t = {}) => (n, r) => S.gen(function* () {
 	let { runId: r, flowRef: i, input: a } = n, o = yield* A({
 		name: "flow-0-resolve",
 		input: { flowRef: i },
@@ -705,32 +842,32 @@ var N = we("_voltro_ai_flows", {
 			ir: C.Unknown,
 			error: C.optional(C.String)
 		}),
-		execute: Y(e, i).pipe(S.map((e) => ({ ir: e })), S.catchAll((e) => S.succeed({
+		execute: X(e, i).pipe(S.map((e) => ({ ir: e })), S.catchAll((e) => S.succeed({
 			ir: void 0,
 			error: e.message
 		})))
 	});
-	if (o.error || !o.ir) return yield* J(e, r, {
+	if (o.error || !o.ir) return yield* Y(e, r, {
 		status: "failed",
 		errorMessage: o.error ?? "flow not found",
-		completedAt: G()
+		completedAt: K()
 	}), {
 		runId: r,
 		status: "failed"
 	};
-	let s = o.ir, c = (yield* S.promise(() => e.store.query(D(P).where(w("id", r)).descriptor)).pipe(S.catchAllCause(() => S.succeed([]))))[0], l = c?.ownerId ?? null, u = c?.tenantId ?? null, d = s.mode === "agentic" ? yield* pt(e, t, r, s, a, l, u) : yield* st(e, t, r, s, a, {
+	let s = o.ir, c = (yield* S.promise(() => e.store.query(D(P).where(w("id", r)).descriptor)).pipe(S.catchAllCause(() => S.succeed([]))))[0], l = c?.ownerId ?? null, u = c?.tenantId ?? null, d = s.mode === "agentic" ? yield* St(e, t, r, s, a, l, u) : yield* gt(e, t, r, s, a, {
 		ownerId: l,
 		tenantId: u,
 		source: n.source
 	});
-	return d.status === "succeeded" && s.chain && (yield* ct(e, r, s, a, d.output ?? {}, n)), t.onEvent && (d.status === "succeeded" || d.status === "failed") && (yield* W(t.onEvent({
+	return d.status === "succeeded" && s.chain && (yield* _t(e, r, s, a, d.output ?? {}, n, t)), t.onEvent && (d.status === "succeeded" || d.status === "failed") && (yield* G(t.onEvent({
 		kind: d.status,
 		runId: r,
 		flowName: s.name,
 		ownerId: l,
 		source: n.source
 	})).pipe(S.catchAllCause(() => S.void))), d;
-}), ht = {
+}), wt = {
 	text: (e) => ({
 		type: "generate",
 		modality: "text",
@@ -757,25 +894,31 @@ var N = we("_voltro_ai_flows", {
 		type: "human",
 		...e
 	})
-}, gt = (e) => e.map((e, t) => "id" in e && e.id ? e : {
+}, Tt = (e) => e.map((e, t) => "id" in e && e.id ? e : {
 	id: `step-${t}`,
 	...e
-}), _t = (e) => {
-	let t = new Set(e.brief.map((e) => e.key)), n = [];
-	for (let r of e.steps) {
-		for (let e of L(r.prompt ?? "")) t.has(e) || n.push(`step "${r.id}" references {{${e}}} which is not a brief field or a prior step outputKey`);
-		r.outputKey && t.add(ce(r.outputKey));
+}), Et = (e) => {
+	let t = [], r = z(e.steps);
+	for (let e of nt(r)) t.push(`group "${e}" is not contiguous — only CONSECUTIVE steps sharing a group run concurrently, so this would execute as two separate fan-outs`);
+	let i = new Set(e.brief.map((e) => e.key));
+	for (let e of r) {
+		for (let { step: n } of e.steps) {
+			n.type === "human" && n.group !== void 0 && t.push(`step "${n.id}" is a human review inside group "${n.group}" — a review SUSPENDS the whole run, which one branch of a fan-out cannot do`);
+			for (let r of L(n.prompt ?? "")) i.has(r) || t.push(e.steps.length > 1 ? `step "${n.id}" references {{${r}}} which is produced inside its OWN group "${n.group}" or does not exist — grouped steps run concurrently, so they cannot read each other` : `step "${n.id}" references {{${r}}} which is not a brief field or a prior step outputKey`);
+			n.when !== void 0 && !i.has(n.when.ref) && t.push(`step "${n.id}" has a when-condition on {{${n.when.ref}}} which is not a brief field or a prior step outputKey — it would never run`);
+		}
+		for (let { step: t } of e.steps) t.outputKey && i.add(n(t.outputKey));
 	}
-	if (n.length > 0) throw new me({
+	if (t.length > 0) throw new ye({
 		flowRef: e.name,
-		message: `flow "${e.name}" has ${n.length} unresolved reference(s)`,
-		issues: n
+		message: `flow "${e.name}" has ${t.length} problem(s)`,
+		issues: t
 	});
-}, vt = (e) => {
-	let t = _({
+}, Dt = (e) => {
+	let t = r({
 		name: e.name,
 		mode: e.mode,
-		steps: gt(e.steps),
+		steps: Tt(e.steps),
 		maxSteps: e.maxSteps,
 		brief: e.brief,
 		orchestratorModel: e.orchestrator?.model,
@@ -784,10 +927,10 @@ var N = we("_voltro_ai_flows", {
 		cadence: e.cadence,
 		humanTimeoutMs: e.humanTimeoutMs
 	});
-	return _t(t), Je(t), t;
-}, X = (e) => String(e).padStart(2, "0"), yt = (e, t) => `cron-${e}-${t.getFullYear()}${X(t.getMonth() + 1)}${X(t.getDate())}-${X(t.getHours())}${X(t.getMinutes())}`, bt = async (e) => {
+	return Et(t), rt(t), t;
+}, Z = (e) => String(e).padStart(2, "0"), Ot = (e, t) => `cron-${e}-${t.getFullYear()}${Z(t.getMonth() + 1)}${Z(t.getDate())}-${Z(t.getHours())}${Z(t.getMinutes())}`, kt = async (e) => {
 	let t = [];
-	for (let e of Xe()) e.cadence && (e.cadence.repeats?.length ?? 0) > 0 && t.push({
+	for (let e of at()) e.cadence && (e.cadence.repeats?.length ?? 0) > 0 && t.push({
 		flowRef: e.name,
 		cadence: e.cadence,
 		defaultInput: e.cadence.defaultInput ?? {}
@@ -799,11 +942,11 @@ var N = we("_voltro_ai_flows", {
 		defaultInput: e.cadence.defaultInput ?? {}
 	});
 	return t;
-}, xt = async (e, t = /* @__PURE__ */ new Date()) => {
-	let n = e.workflows, r = [], i = 0, a = await bt(e).catch(() => []);
+}, At = async (e, t = /* @__PURE__ */ new Date()) => {
+	let n = e.workflows, r = [], i = 0, a = await kt(e).catch(() => []);
 	for (let o of a) {
-		if (!ge(o.cadence, t) || (i += 1, !n)) continue;
-		let a = yt(o.flowRef, t), s = `run-${a}`;
+		if (!xe(o.cadence, t) || (i += 1, !n)) continue;
+		let a = Ot(o.flowRef, t), s = `run-${a}`;
 		try {
 			try {
 				await e.store.insert("_voltro_ai_flow_runs", {
@@ -829,17 +972,17 @@ var N = we("_voltro_ai_flows", {
 		matched: i,
 		started: r
 	};
-}, St = (e) => ({
+}, jt = (e) => ({
 	name: "gateway",
 	model: e
-}), Ct = (e) => Math.round(e * 1e6), Z = (e, t, n) => {
-	let r = Ae(t);
-	return typeof r == "number" ? Ct(r) : e ? ke(e, { model: n ?? "unknown" }).costMicroUsd ?? 0 : 0;
-}, wt = (e, t) => (n) => {
-	let r = n.model, i = (e) => t?.resolveModel?.(e) ?? St(e);
+}), Mt = (e) => Math.round(e * 1e6), Nt = (e, t, n) => {
+	let r = Fe(t);
+	return typeof r == "number" ? Mt(r) : e ? Pe(e, { model: n ?? "unknown" }).costMicroUsd ?? 0 : 0;
+}, Pt = (e, t) => (n) => {
+	let r = n.model, i = (e) => t?.resolveModel?.(e) ?? jt(e);
 	return S.gen(function* () {
 		if (n.modality === "image") {
-			let t = yield* je({
+			let t = yield* Ie({
 				prompt: n.prompt,
 				...r ? { provider: i(r) } : {}
 			}), a = t.images[0];
@@ -855,11 +998,11 @@ var N = we("_voltro_ai_flows", {
 			return {
 				url: o.url,
 				...o.refId ? { requestId: o.refId } : {},
-				costMicroUsd: Z(t.usage, t.providerMetadata, r)
+				costMicroUsd: Nt(t.usage, t.providerMetadata, r)
 			};
 		}
 		if (n.modality === "audio") {
-			let t = yield* Pe({
+			let t = yield* ze({
 				text: n.prompt,
 				...r ? { provider: i(r) } : {}
 			}), a = yield* S.promise(() => e.put({
@@ -870,10 +1013,10 @@ var N = we("_voltro_ai_flows", {
 			return {
 				url: a.url,
 				...a.refId ? { requestId: a.refId } : {},
-				costMicroUsd: Z(t.usage, t.providerMetadata, r)
+				costMicroUsd: Nt(t.usage, t.providerMetadata, r)
 			};
 		}
-		let t = yield* Fe({
+		let t = yield* Be({
 			prompt: n.prompt,
 			...r ? { provider: i(r) } : {},
 			...n.params ? { params: n.params } : {}
@@ -891,15 +1034,15 @@ var N = we("_voltro_ai_flows", {
 		return {
 			url: a.url,
 			...a.refId ? { requestId: a.refId } : {},
-			costMicroUsd: Z(t.usage, t.providerMetadata, r)
+			costMicroUsd: Nt(t.usage, t.providerMetadata, r)
 		};
 	}).pipe(S.catchAll((e) => e instanceof b ? S.fail(e) : S.fail(new b({
 		capability: `media:${n.modality}`,
 		message: String(e.message ?? e)
 	}))));
-}, Q = () => globalThis.crypto?.randomUUID?.() ?? `req-${Date.now().toString(36)}`, Tt = (e) => e.request?.subject?.id ?? null, $ = (e, t) => S.promise(() => e.store.query(D(P).where(w("id", t)).descriptor)).pipe(S.map((e) => e[0])), Et = (e, t) => S.gen(function* () {
-	let n = yield* Y(e, t.flowRef), r = t.input ?? {}, i = n.brief.filter((e) => e.required && e.type !== "boolean" && (r[e.key] === void 0 || r[e.key] === null || r[e.key] === "")).map((e) => e.key);
-	if (i.length > 0) return yield* S.fail(new ue({
+}, Q = () => globalThis.crypto?.randomUUID?.() ?? `req-${Date.now().toString(36)}`, Ft = (e) => e.request?.subject?.id ?? null, $ = (e, t) => S.promise(() => e.store.query(D(P).where(w("id", t)).descriptor)).pipe(S.map((e) => e[0])), It = (e, t) => S.gen(function* () {
+	let n = yield* X(e, t.flowRef), r = t.input ?? {}, i = n.brief.filter((e) => e.required && e.type !== "boolean" && (r[e.key] === void 0 || r[e.key] === null || r[e.key] === "")).map((e) => e.key);
+	if (i.length > 0) return yield* S.fail(new he({
 		missing: i,
 		message: `missing required brief field(s): ${i.join(", ")}`
 	}));
@@ -913,7 +1056,7 @@ var N = we("_voltro_ai_flows", {
 		source: s,
 		requestId: a,
 		input: r,
-		ownerId: Tt(e)
+		ownerId: Ft(e)
 	}));
 	let c = e.workflows;
 	return c && (yield* S.promise(() => c.start(v, {
@@ -927,7 +1070,7 @@ var N = we("_voltro_ai_flows", {
 		requestId: a,
 		status: "pending"
 	};
-}), Dt = (e, t) => S.gen(function* () {
+}), Lt = (e, t) => S.gen(function* () {
 	let n = yield* $(e, t.runId);
 	if (!n) return yield* S.fail(new x({
 		runId: t.runId,
@@ -951,7 +1094,7 @@ var N = we("_voltro_ai_flows", {
 		requestId: r,
 		status: "pending"
 	};
-}), Ot = (e, t) => S.gen(function* () {
+}), Rt = (e, t) => S.gen(function* () {
 	return (yield* $(e, t.runId)) ? (yield* S.promise(() => e.store.update(P.tableName, t.runId, {
 		status: "cancelled",
 		cancelledAt: (/* @__PURE__ */ new Date()).toISOString()
@@ -962,19 +1105,19 @@ var N = we("_voltro_ai_flows", {
 		runId: t.runId,
 		message: "run not found"
 	}));
-}), kt = (e) => {
+}), zt = (e) => {
 	let t = e.steps?.find((e) => e.status === "waiting");
 	if (t !== void 0) return t.id;
 	let n = e.currentStep;
 	return typeof n == "number" ? n : 0;
-}, At = (e, t) => S.gen(function* () {
+}, Bt = (e, t) => S.gen(function* () {
 	let n = yield* $(e, t.runId);
 	if (!n) return yield* S.fail(new x({
 		runId: t.runId,
 		message: "run not found"
 	}));
 	let r = n.status;
-	if (r !== "waiting") return yield* S.fail(new fe({
+	if (r !== "waiting") return yield* S.fail(new _e({
 		runId: t.runId,
 		status: r ?? "unknown",
 		message: `run is "${r}", not awaiting a response`
@@ -984,7 +1127,7 @@ var N = we("_voltro_ai_flows", {
 		respondedAt: (/* @__PURE__ */ new Date()).toISOString()
 	};
 	yield* S.promise(() => e.store.update(P.tableName, t.runId, { humanResponse: i }));
-	let a = e.workflows, o = n.requestId, s = kt(n);
+	let a = e.workflows, o = n.requestId, s = zt(n);
 	return a && o && (yield* S.promise(() => a.signal({
 		workflowName: v,
 		executionId: `flow-run:${o}`
@@ -992,22 +1135,22 @@ var N = we("_voltro_ai_flows", {
 		runId: t.runId,
 		stepIndex: s
 	};
-}), jt = (e, t) => S.promise(() => e.store.query(D(N).where(w("id", t.id)).descriptor)).pipe(S.map((e) => e[0])), Mt = (e) => S.promise(() => e.store.query(D(N).descriptor)), Nt = (e, t) => S.promise(() => e.store.insert(N.tableName, {
+}), Vt = (e, t) => S.promise(() => e.store.query(D(N).where(w("id", t.id)).descriptor)).pipe(S.map((e) => e[0])), Ht = (e) => S.promise(() => e.store.query(D(N).descriptor)), Ut = (e, t) => S.promise(() => e.store.insert(N.tableName, {
 	id: t.id ?? `flow-${Q()}`,
 	...t
-})), Pt = (e, t) => S.promise(() => e.store.update(N.tableName, t.id, t.patch)), Ft = (e, t) => S.promise(() => e.store.delete(N.tableName, t.id)), It = "aiFlows", Lt = (e = {}) => {
-	let t = ye({
-		base: It,
+})), Wt = (e, t) => S.promise(() => e.store.update(N.tableName, t.id, t.patch)), Gt = (e, t) => S.promise(() => e.store.delete(N.tableName, t.id)), Kt = "aiFlows", qt = (e = {}) => {
+	let t = we({
+		base: Kt,
 		alias: e.alias
 	});
-	Ve(e.humanReviewTimeoutMs === void 0 ? {} : { humanReviewTimeoutMs: e.humanReviewTimeoutMs }), Ce({
+	Je(e.humanReviewTimeoutMs === void 0 ? {} : { humanReviewTimeoutMs: e.humanReviewTimeoutMs }), Oe({
 		source: "plugin",
 		table: P.tableName,
 		timeColumn: "createdAt",
-		ttlMs: e.runsTtlMs ?? I(process.env.VOLTRO_AI_FLOW_RUNS_TTL_HOURS, 2160),
-		envVar: Be,
+		ttlMs: e.runsTtlMs ?? Xe(process.env.VOLTRO_AI_FLOW_RUNS_TTL_HOURS, 2160),
+		envVar: Ge,
 		label: "ai flow runs",
-		where: Se("status", [
+		where: De("status", [
 			"succeeded",
 			"failed",
 			"cancelled"
@@ -1050,12 +1193,12 @@ var N = we("_voltro_ai_flows", {
 		description: "List recent flow runs (`?take=` up to the configured max).",
 		handler: (e) => o("_voltro_ai_flow_runs", s(e.url, Math.min(100, n)))
 	}];
-	return ve({
+	return Ce({
 		name: t,
-		baseName: It,
+		baseName: Kt,
 		description: "AI Flows — durable multi-step AI pipelines (deterministic + agentic) with human-in-the-loop, chaining, and cadence. Code-first (defineFlow) or data-driven.",
 		permissions: ["store:write", "inspect:read"],
-		...e.tables === !1 ? {} : { extendSchema: { tables: Ie } },
+		...e.tables === !1 ? {} : { extendSchema: { tables: Ve } },
 		inspectEndpoints: c,
 		bindDataStore: (e) => {
 			r.current = e;
@@ -1063,4 +1206,4 @@ var N = we("_voltro_ai_flows", {
 	});
 };
 //#endregion
-export { e as BriefField, t as ChainPending, Be as FLOW_RUNS_TTL_ENV, ze as FLOW_RUNS_TTL_HOURS_DEFAULT, v as FLOW_RUN_WORKFLOW, n as FlowCadence, r as FlowChain, i as FlowMode, a as FlowStatus, o as FlowStep, le as HUMAN_RESPONSE_SIGNAL_PREFIX, Re as HUMAN_REVIEW_TIMEOUT_ENV, Le as HUMAN_REVIEW_TIMEOUT_HOURS_DEFAULT, s as HumanResponse, c as Json, l as MAX_STEPS_DEFAULT, u as MAX_STEPS_MAX, d as MAX_STEPS_MIN, f as MediaInputSlot, p as MediaInputs, m as Modality, h as ReviewMode, g as ReviewOption, ee as RunReview, te as RunSource, ne as RunStatus, re as RunStep, ie as RunStepStatus, ae as StepType, oe as Visibility, P as aiFlowRunsTable, Lt as aiFlowsPlugin, N as aiFlowsTable, Ie as aiFlowsTables, mt as buildFlowRunExecute, ge as cadenceMatches, Ot as cancelFlow, se as clampMaxSteps, Ze as clearRegistry, L as collectRefs, Nt as createFlow, yt as cronRequestId, vt as defineFlow, Ft as deleteFlow, ht as flowStep, He as getAiFlowsDefaults, jt as getFlow, Ye as getRegisteredFlow, y as humanResponseSignalName, R as interpolate, nt as jsonSchemaToEffectSchema, Et as launchFlow, Mt as listFlows, Xe as listRegisteredFlows, wt as makeMediaGenerator, he as nextRuns, _ as normalizeFlow, Je as registerFlow, Ue as resetAiFlowsDefaults, Ge as resolveHumanReviewTimeoutMs, Y as resolveIr, At as respondToFlow, Dt as retryFlow, xt as runCadenceTick, ce as sanitizeOutputKey, Ve as setAiFlowsDefaults, qe as unresolvedRefs, Pt as updateFlow, _t as validateFlow, kt as waitingStepIndex };
+export { ce as BriefField, re as ChainPending, a as ConditionOp, Ge as FLOW_RUNS_TTL_ENV, We as FLOW_RUNS_TTL_HOURS_DEFAULT, v as FLOW_RUN_WORKFLOW, oe as FlowCadence, g as FlowChain, l as FlowMode, ie as FlowStatus, se as FlowStep, me as HUMAN_RESPONSE_SIGNAL_PREFIX, Ue as HUMAN_REVIEW_TIMEOUT_ENV, He as HUMAN_REVIEW_TIMEOUT_HOURS_DEFAULT, d as HumanResponse, te as Json, Ke as MAX_CHAIN_DEPTH_DEFAULT, qe as MAX_CHAIN_DEPTH_ENV, le as MAX_STEPS_DEFAULT, f as MAX_STEPS_MAX, p as MAX_STEPS_MIN, ae as MediaInputSlot, ne as MediaInputs, h as Modality, m as ReviewMode, c as ReviewOption, ue as RunReview, pe as RunSource, u as RunStatus, fe as RunStep, o as RunStepStatus, ee as StepCondition, t as StepType, de as Visibility, P as aiFlowRunsTable, qt as aiFlowsPlugin, N as aiFlowsTable, Ve as aiFlowsTables, Ct as buildFlowRunExecute, xe as cadenceMatches, Rt as cancelFlow, s as clampMaxSteps, ot as clearRegistry, L as collectRefs, Ut as createFlow, Ot as cronRequestId, Dt as defineFlow, Gt as deleteFlow, e as describeCondition, _ as evaluateCondition, z as flowSegments, wt as flowStep, I as getAiFlowsDefaults, Vt as getFlow, it as getRegisteredFlow, y as humanResponseSignalName, R as interpolate, i as isTruthy, dt as jsonSchemaToEffectSchema, It as launchFlow, Ht as listFlows, at as listRegisteredFlows, Pt as makeMediaGenerator, be as nextRuns, nt as nonContiguousGroups, r as normalizeFlow, rt as registerFlow, Ye as resetAiFlowsDefaults, Qe as resolveHumanReviewTimeoutMs, X as resolveIr, $e as resolveMaxChainDepth, Bt as respondToFlow, Lt as retryFlow, At as runCadenceTick, n as sanitizeOutputKey, Je as setAiFlowsDefaults, tt as unresolvedRefs, Wt as updateFlow, Et as validateFlow, zt as waitingStepIndex };