@voltro/plugin-ai-flows 0.33.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 ee, ReviewMode as m, ReviewOption as h, RunReview as te, RunSource as ne, RunStatus as re, RunStep as ie, RunStepStatus as ae, StepType as oe, Visibility as se, clampMaxSteps as ce, normalizeFlow as g, sanitizeOutputKey as _ } from "./ir.js";
-import { FLOW_RUN_WORKFLOW as v, HUMAN_RESPONSE_SIGNAL as y } from "./workflow.js";
-import { FlowBriefIncomplete as le, FlowCapabilityMissing as b, FlowDependencyError as ue, FlowNotAwaitingResponse as de, FlowNotFound as fe, FlowRunNotFound as x, FlowValidationError as pe } from "./errors.js";
-import { n as me, t as he } from "./cadence-Bt6dPelT.js";
-import { Effect as S, Schema as C } from "effect";
-import { definePlugin as ge } from "@voltro/protocol";
-import { boolean as _e, eq as w, id as ve, integer as T, json as E, queryFor as D, table as ye, text as O, timestamp as k } from "@voltro/database";
-import { tenant as A } from "@voltro/plugin-multitenancy/mixin";
-import { audit as j } from "@voltro/plugin-audit/mixin";
-import { softDelete as be } from "@voltro/plugin-soft-delete/mixin";
-import { awaitSignalSuspending as xe, step as M } from "@voltro/workflow";
-import { defineTool as N, estimateCostUsd as P, gatewayCostUsd as Se, generateImage as Ce, generateObject as we, generateObjectWithTools as Te, generateSpeech as Ee, generateText as F, generateVideo as De } 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 I = ye("_voltro_ai_flows", {
-	id: ve({ prefix: "aifl" }),
+var N = ke("_voltro_ai_flows", {
+	id: Ee({ prefix: "aifl" }),
 	name: O(),
 	description: O().nullable(),
 	mode: O().default("deterministic"),
@@ -25,15 +25,16 @@ var I = ye("_voltro_ai_flows", {
 	inputSchema: E().nullable(),
 	chainTo: E().nullable(),
 	cadence: E().nullable(),
-	isEnabled: _e().default(!0),
+	humanTimeoutMs: T().nullable(),
+	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(A(), j(), be()).index(["status"]).index(["visibility"]), L = ye("_voltro_ai_flow_runs", {
-	id: ve({ 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"),
@@ -47,6 +48,7 @@ var I = ye("_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(),
@@ -58,50 +60,138 @@ var I = ye("_voltro_ai_flows", {
 	sessionName: O().nullable(),
 	ownerId: O().nullable(),
 	metadata: E().nullable()
-}).renamedFrom("ai_flow_runs").with(A(), j()).index(["flowRef"]).index(["status"]).index(["requestId"]), Oe = [I, L], ke = /\{\{\s*([\w.-]+)\s*\}\}/g, R = (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;
+}, I = () => F.current, Ye = () => {
+	F.current = {};
+}, 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;
+}, Ze = (e) => Number.isFinite(e) && e > 0 ? e : Infinity, Qe = (e) => {
+	let t = e.env ?? process.env;
+	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;
-}, z = (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);
-}), Ae = (e, t) => {
+}), tt = (e, t) => {
 	let n = /* @__PURE__ */ new Set();
-	for (let r of R(e)) t[r] == null && !n.has(r) && n.add(r);
+	for (let r of L(e)) t[r] == null && !n.has(r) && n.add(r);
 	return [...n];
-}, B = /* @__PURE__ */ new Map(), V = (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);
-}, H = (e) => B.get(e), U = () => [...B.values()], je = () => B.clear(), W = (e) => e, Me = C.Struct({
+}, 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;
+		case "integer": return C.Int;
+		case "boolean": return C.Boolean;
+		case "null": return C.Null;
+		default: return C.Unknown;
+	}
+}, 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 }
+	});
+}, ct = (e) => e.length === 0 ? C.Unknown : e.length === 1 ? e[0] : C.Union(...e), lt = () => C.Record({
+	key: C.String,
+	value: C.Unknown
+}), W = (e) => {
+	let t = V(e);
+	if (t === void 0) return C.Unknown;
+	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 = W(i);
+		r[e] = n.has(e) ? t : C.optional(t);
+	}
+	return C.Struct(r);
+}, 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(), Ne = (e) => Math.round(e * 1e6), K = (e, t) => e.resolveModel?.(t) ?? K(e, t), q = (e, t, n) => {
-	let r = Se(t);
-	return typeof r == "number" ? Ne(r) : P(e, { model: n ?? "unknown" }).costMicroUsd ?? 0;
-}, J = (e, t, n) => S.promise(() => e.store.update(L.tableName, t, n).then(() => void 0)).pipe(S.catchAllCause(() => S.void)), Pe = (e, t) => S.promise(async () => (await e.store.query(D(L).where(w("id", t)).descriptor))[0]?.status === "cancelled").pipe(S.catchAllCause(() => S.succeed(!1))), Y = (e, t) => S.gen(function* () {
-	let n = H(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(I).where(w("id", t)).descriptor)))[0];
-	return r ? g({
-		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
-	}) : yield* S.fail(new fe({
+	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}"`
 	}));
-}), Fe = (e, t, n, r, i) => S.gen(function* () {
-	let e = z(n.prompt ?? "", r), a = Ae(n.prompt ?? "", r);
-	if (a.length > 0) return { error: new ue({
+}), 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]}}}`
@@ -118,7 +208,7 @@ var I = ye("_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({
@@ -126,10 +216,10 @@ var I = ye("_voltro_ai_flows", {
 				e
 			})));
 			if (!r.ok) return { error: r.e.message };
-			let i = yield* F({
+			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
@@ -140,17 +230,14 @@ var I = ye("_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* we({
+			let r = n.model ?? t.defaultModels?.text, i = yield* Le({
 				prompt: e,
-				schema: C.Record({
-					key: C.String,
-					value: C.Unknown
-				}),
-				...r ? { provider: K(t, r) } : {}
+				schema: dt(n.schema),
+				...r ? { provider: q(t, r) } : {}
 			}).pipe(S.map((e) => ({
 				ok: !0,
 				r: e
@@ -161,15 +248,15 @@ var I = ye("_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": {
 			let r = n.modality ?? "text";
 			if (r === "text") {
-				let r = n.model ?? t.defaultModels?.text, i = yield* F({
+				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
@@ -180,14 +267,14 @@ var I = ye("_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,
@@ -209,247 +296,355 @@ var I = ye("_voltro_ai_flows", {
 		}
 		case "human": return { error: new b({
 			capability: "human",
-			message: "human-in-the-loop steps are not yet wired (task #35)"
+			message: "human step reached the step interpreter — it should have been parked by the deterministic executor (routing bug)"
 		}).message };
 		default: return { error: `unknown step type: ${String(n.type)}` };
 	}
-}), Ie = (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* Pe(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: z(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 = yield* xe(e, {
-				name: y,
-				schema: s
+			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.catchAll((e) => S.succeed({
+			})), S.catchAllCause((e) => Se.isInterruptedOnly(e) ? S.failCause(e) : S.succeed({
 				ok: !1,
-				e
+				cause: e
 			})));
-			if (!f.ok) return c[i] = {
-				...c[i],
-				status: "failed",
-				completedAt: G(),
-				errorMessage: "human review timed out or failed to decode"
-			}, yield* J(e, n, {
-				steps: c,
-				status: "failed",
-				errorMessage: "human review timed out",
-				completedAt: G(),
-				costMicroUsd: l
-			}), {
-				runId: n,
-				status: "failed"
-			};
-			let p = f.a;
-			if (p.decision === "reject") return c[i] = {
-				...c[i],
+			if (!p.ok) {
+				let e = Number.isFinite(a) ? `human review timed out after ${a}ms` : "human review failed";
+				return c[u] = {
+					...c[u],
+					status: "failed",
+					completedAt: K(),
+					errorMessage: e
+				}, yield* Y(t, r, {
+					steps: c,
+					status: "failed",
+					errorMessage: e,
+					completedAt: K(),
+					costMicroUsd: l
+				}), {
+					runId: r,
+					status: "failed"
+				};
+			}
+			let m = p.a;
+			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] = p.value ?? p.text ?? p.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(),
-				output: { text: String(p.text ?? p.value ?? p.decision ?? "approved") }
-			}, yield* J(e, n, {
+				completedAt: K(),
+				output: { text: String(m.text ?? m.value ?? m.decision ?? "approved") }
+			}, 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* M({
-			name: `flow-${i}-${u.id}`,
-			input: { index: i },
-			success: Me,
-			execute: Fe(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
 	};
-}), Le = (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(L.tableName, {
-				id: u,
-				flowRef: o.flowRef,
-				flowName: o.flowRef,
+			await e.store.insert(P.tableName, {
+				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));
-}), Re = (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"), ze = (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");
-}, Be = (e) => [
+}, bt = (e) => [
 	e.orchestrator?.instructions ?? "You are an orchestrator that uses the available tools to produce a bundled result.",
-	Re(e),
+	vt(e),
 	"When finished, emit a JSON object mapping each deliverable name (outputKey) to its value."
-].filter(Boolean).join("\n\n"), Ve = 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(ie),
+	steps: C.Array(fe),
 	error: C.optional(C.String)
-}), He = (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* M({
+	let s = yield* A({
 		name: "flow-agentic",
 		input: { flowRef: r.name },
-		success: Ve,
+		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
-			}), f = N({
+			}), f = j({
 				name: "run_agent",
 				description: "Delegate a text task to an allowed sub-agent. Returns the agent's text.",
 				input: C.Struct({
@@ -465,7 +660,7 @@ var I = ye("_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({
@@ -476,10 +671,10 @@ var I = ye("_voltro_ai_flows", {
 						status: "failed",
 						errorMessage: i.e.message
 					}), yield* d(), `ERROR: ${i.e.message}`;
-					let a = yield* F({
+					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
@@ -494,14 +689,14 @@ var I = ye("_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 },
 						costMicroUsd: o
 					}), yield* d(), a.r.text;
 				})
-			}), p = N({
+			}), p = j({
 				name: "generate_media",
 				description: "Generate an image, video, or audio artifact. Returns the hosted URL.",
 				input: C.Struct({
@@ -518,7 +713,7 @@ var I = ye("_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 } : {},
@@ -543,7 +738,7 @@ var I = ye("_voltro_ai_flows", {
 						errorMessage: s.e.message
 					}), yield* d(), `ERROR: ${s.e.message}`);
 				})
-			}), ee = N({
+			}), m = j({
 				name: "pick_structured",
 				description: "Produce a JSON object for a task. Returns the object.",
 				input: C.Struct({
@@ -556,13 +751,13 @@ var I = ye("_voltro_ai_flows", {
 						type: "structured"
 					});
 					yield* d();
-					let i = yield* we({
+					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
@@ -577,16 +772,16 @@ var I = ye("_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;
 				})
-			}), m = t.memoryPrefix ? yield* W(t.memoryPrefix(a)).pipe(S.catchAll(() => S.succeed(""))) : "", h = yield* Te({
-				system: m ? `${m}\n\n${Be(r)}` : Be(r),
-				prompt: ze(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
@@ -594,10 +789,10 @@ var I = ye("_voltro_ai_flows", {
 				tools: {
 					run_agent: f,
 					generate_media: p,
-					pick_structured: ee
+					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
@@ -605,9 +800,9 @@ var I = ye("_voltro_ai_flows", {
 				ok: !1,
 				e
 			})));
-			return h.ok ? {
-				object: h.r.object,
-				planCostMicroUsd: q(h.r.usage, h.r.providerMetadata, r.orchestrator?.model),
+			return g.ok ? {
+				object: g.r.object,
+				planCostMicroUsd: J(g.r.usage, g.r.providerMetadata, r.orchestrator?.model),
 				toolCostMicroUsd: c,
 				steps: s
 			} : {
@@ -615,64 +810,64 @@ var I = ye("_voltro_ai_flows", {
 				planCostMicroUsd: 0,
 				toolCostMicroUsd: c,
 				steps: s,
-				error: String(h.e.message ?? h.e)
+				error: String(g.e.message ?? g.e)
 			};
 		})
 	}), 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
 	});
-}), Ue = (e, t = {}) => (n, r) => S.gen(function* () {
-	let { runId: r, flowRef: i, input: a } = n, o = yield* M({
+}), 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 },
 		success: C.Struct({
 			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(L).where(w("id", r)).descriptor)).pipe(S.catchAllCause(() => S.succeed([]))))[0], l = c?.ownerId ?? null, u = c?.tenantId ?? null, d = s.mode === "agentic" ? yield* He(e, t, r, s, a, l, u) : yield* Ie(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* Le(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;
-}), We = {
+}), wt = {
 	text: (e) => ({
 		type: "generate",
 		modality: "text",
@@ -699,36 +894,43 @@ var I = ye("_voltro_ai_flows", {
 		type: "human",
 		...e
 	})
-}, Ge = (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
-}), Ke = (e) => {
-	let t = new Set(e.brief.map((e) => e.key)), n = [];
-	for (let r of e.steps) {
-		for (let e of R(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(_(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 pe({
+	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
 	});
-}, qe = (e) => {
-	let t = g({
+}, Dt = (e) => {
+	let t = r({
 		name: e.name,
 		mode: e.mode,
-		steps: Ge(e.steps),
+		steps: Tt(e.steps),
 		maxSteps: e.maxSteps,
 		brief: e.brief,
 		orchestratorModel: e.orchestrator?.model,
 		orchestratorInstructions: e.orchestrator?.instructions,
 		chain: e.chain,
-		cadence: e.cadence
+		cadence: e.cadence,
+		humanTimeoutMs: e.humanTimeoutMs
 	});
-	return Ke(t), V(t), t;
-}, X = (e) => String(e).padStart(2, "0"), Je = (e, t) => `cron-${e}-${t.getFullYear()}${X(t.getMonth() + 1)}${X(t.getDate())}-${X(t.getHours())}${X(t.getMinutes())}`, Ye = 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 U()) 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 ?? {}
@@ -740,11 +942,11 @@ var I = ye("_voltro_ai_flows", {
 		defaultInput: e.cadence.defaultInput ?? {}
 	});
 	return t;
-}, Xe = async (e, t = /* @__PURE__ */ new Date()) => {
-	let n = e.workflows, r = [], i = 0, a = await Ye(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 (!he(o.cadence, t) || (i += 1, !n)) continue;
-		let a = Je(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", {
@@ -770,17 +972,17 @@ var I = ye("_voltro_ai_flows", {
 		matched: i,
 		started: r
 	};
-}, Ze = (e) => ({
+}, jt = (e) => ({
 	name: "gateway",
 	model: e
-}), Qe = (e) => Math.round(e * 1e6), Z = (e, t, n) => {
-	let r = Se(t);
-	return typeof r == "number" ? Qe(r) : e ? P(e, { model: n ?? "unknown" }).costMicroUsd ?? 0 : 0;
-}, $e = (e, t) => (n) => {
-	let r = n.model, i = (e) => t?.resolveModel?.(e) ?? Ze(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* Ce({
+			let t = yield* Ie({
 				prompt: n.prompt,
 				...r ? { provider: i(r) } : {}
 			}), a = t.images[0];
@@ -796,11 +998,11 @@ var I = ye("_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* Ee({
+			let t = yield* ze({
 				text: n.prompt,
 				...r ? { provider: i(r) } : {}
 			}), a = yield* S.promise(() => e.put({
@@ -811,10 +1013,10 @@ var I = ye("_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* De({
+		let t = yield* Be({
 			prompt: n.prompt,
 			...r ? { provider: i(r) } : {},
 			...n.params ? { params: n.params } : {}
@@ -832,20 +1034,20 @@ var I = ye("_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)}`, et = (e) => e.request?.subject?.id ?? null, $ = (e, t) => S.promise(() => e.store.query(D(L).where(w("id", t)).descriptor)).pipe(S.map((e) => e[0])), tt = (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 le({
+}, 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(", ")}`
 	}));
 	let a = Q(), o = `run-${a}`, s = t.source ?? "manual";
-	yield* S.promise(() => e.store.insert(L.tableName, {
+	yield* S.promise(() => e.store.insert(P.tableName, {
 		id: o,
 		flowRef: t.flowRef,
 		flowName: n.name,
@@ -854,7 +1056,7 @@ var I = ye("_voltro_ai_flows", {
 		source: s,
 		requestId: a,
 		input: r,
-		ownerId: et(e)
+		ownerId: Ft(e)
 	}));
 	let c = e.workflows;
 	return c && (yield* S.promise(() => c.start(v, {
@@ -868,14 +1070,14 @@ var I = ye("_voltro_ai_flows", {
 		requestId: a,
 		status: "pending"
 	};
-}), nt = (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,
 		message: "run not found"
 	}));
 	let r = n.requestId ?? Q(), i = n.flowRef, a = n.input ?? {}, o = n.source ?? "manual";
-	yield* S.promise(() => e.store.update(L.tableName, t.runId, {
+	yield* S.promise(() => e.store.update(P.tableName, t.runId, {
 		status: "pending",
 		error: null,
 		errorMessage: null
@@ -892,8 +1094,8 @@ var I = ye("_voltro_ai_flows", {
 		requestId: r,
 		status: "pending"
 	};
-}), rt = (e, t) => S.gen(function* () {
-	return (yield* $(e, t.runId)) ? (yield* S.promise(() => e.store.update(L.tableName, t.runId, {
+}), 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()
 	})), {
@@ -903,14 +1105,19 @@ var I = ye("_voltro_ai_flows", {
 		runId: t.runId,
 		message: "run not found"
 	}));
-}), it = (e, t) => S.gen(function* () {
+}), 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;
+}, 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 de({
+	if (r !== "waiting") return yield* S.fail(new _e({
 		runId: t.runId,
 		status: r ?? "unknown",
 		message: `run is "${r}", not awaiting a response`
@@ -919,27 +1126,47 @@ var I = ye("_voltro_ai_flows", {
 		...t.response,
 		respondedAt: (/* @__PURE__ */ new Date()).toISOString()
 	};
-	yield* S.promise(() => e.store.update(L.tableName, t.runId, { humanResponse: i }));
-	let a = e.workflows, o = n.requestId;
+	yield* S.promise(() => e.store.update(P.tableName, t.runId, { humanResponse: i }));
+	let a = e.workflows, o = n.requestId, s = zt(n);
 	return a && o && (yield* S.promise(() => a.signal({
 		workflowName: v,
 		executionId: `flow-run:${o}`
-	}, y, i)).pipe(S.catchAllCause(() => S.void))), { runId: t.runId };
-}), at = (e, t) => S.promise(() => e.store.query(D(I).where(w("id", t.id)).descriptor)).pipe(S.map((e) => e[0])), ot = (e) => S.promise(() => e.store.query(D(I).descriptor)), st = (e, t) => S.promise(() => e.store.insert(I.tableName, {
+	}, y(s), i)).pipe(S.catchAllCause(() => S.void))), {
+		runId: t.runId,
+		stepIndex: s
+	};
+}), 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
-})), ct = (e, t) => S.promise(() => e.store.update(I.tableName, t.id, t.patch)), lt = (e, t) => S.promise(() => e.store.delete(I.tableName, t.id)), ut = (e = {}) => {
-	let t = e.alias ?? "aiFlows", n = { current: void 0 }, r = (e) => ({
+})), 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
+	});
+	Je(e.humanReviewTimeoutMs === void 0 ? {} : { humanReviewTimeoutMs: e.humanReviewTimeoutMs }), Oe({
+		source: "plugin",
+		table: P.tableName,
+		timeColumn: "createdAt",
+		ttlMs: e.runsTtlMs ?? Xe(process.env.VOLTRO_AI_FLOW_RUNS_TTL_HOURS, 2160),
+		envVar: Ge,
+		label: "ai flow runs",
+		where: De("status", [
+			"succeeded",
+			"failed",
+			"cancelled"
+		])
+	});
+	let n = Math.max(1, e.inspectPageMax ?? 200), r = { current: void 0 }, i = (e) => ({
 		kind: "json",
 		data: e
-	}), i = (e, t) => ({
+	}), a = (e, t) => ({
 		kind: "json",
 		status: e,
 		data: { error: t }
-	}), a = (e, t) => S.promise(async () => {
-		let a = n.current;
-		if (!a) return i(503, "store not bound yet");
-		let o = await a.query({
+	}), o = (e, t) => S.promise(async () => {
+		let n = r.current;
+		if (!n) return a(503, "store not bound yet");
+		let o = await n.query({
 			table: e,
 			predicate: void 0,
 			order: [],
@@ -947,31 +1174,36 @@ var I = ye("_voltro_ai_flows", {
 			skip: void 0,
 			projection: void 0
 		});
-		return r({
+		return i({
 			count: o.length,
-			rows: o
+			rows: o,
+			take: t
 		});
-	}).pipe(S.catchAllCause(() => S.succeed(i(500, "query failed"))));
-	return ge({
+	}).pipe(S.catchAllCause(() => S.succeed(a(500, "query failed")))), s = (e, t) => {
+		let r = /[?&]take=(\d+)/.exec(e)?.[1], i = r === void 0 ? t : Number(r);
+		return Math.min(n, Math.max(1, Number.isFinite(i) ? i : t));
+	}, c = [{
+		method: "GET",
+		path: "/flows",
+		description: "List flow definitions (`?take=` up to the configured max).",
+		handler: (e) => o("_voltro_ai_flows", s(e.url, Math.min(200, n)))
+	}, {
+		method: "GET",
+		path: "/runs",
+		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 Ce({
 		name: t,
+		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"],
-		extendSchema: { tables: Oe },
-		inspectEndpoints: [{
-			method: "GET",
-			path: "/flows",
-			description: "List flow definitions.",
-			handler: () => a("_voltro_ai_flows", 200)
-		}, {
-			method: "GET",
-			path: "/runs",
-			description: "List recent flow runs.",
-			handler: () => a("_voltro_ai_flow_runs", 100)
-		}],
+		...e.tables === !1 ? {} : { extendSchema: { tables: Ve } },
+		inspectEndpoints: c,
 		bindDataStore: (e) => {
-			n.current = e;
+			r.current = e;
 		}
 	});
 };
 //#endregion
-export { e as BriefField, t as ChainPending, v as FLOW_RUN_WORKFLOW, n as FlowCadence, r as FlowChain, i as FlowMode, a as FlowStatus, o as FlowStep, y as HUMAN_RESPONSE_SIGNAL, 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, ee as Modality, m as ReviewMode, h as ReviewOption, te as RunReview, ne as RunSource, re as RunStatus, ie as RunStep, ae as RunStepStatus, oe as StepType, se as Visibility, L as aiFlowRunsTable, ut as aiFlowsPlugin, I as aiFlowsTable, Oe as aiFlowsTables, Ue as buildFlowRunExecute, he as cadenceMatches, rt as cancelFlow, ce as clampMaxSteps, je as clearRegistry, R as collectRefs, st as createFlow, Je as cronRequestId, qe as defineFlow, lt as deleteFlow, We as flowStep, at as getFlow, H as getRegisteredFlow, z as interpolate, tt as launchFlow, ot as listFlows, U as listRegisteredFlows, $e as makeMediaGenerator, me as nextRuns, g as normalizeFlow, V as registerFlow, Y as resolveIr, it as respondToFlow, nt as retryFlow, Xe as runCadenceTick, _ as sanitizeOutputKey, Ae as unresolvedRefs, ct as updateFlow, Ke as validateFlow };
+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 };