@voltro/plugin-ai-flows 0.33.0 → 0.34.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 { 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";
 //#region src/table.ts
-var I = ye("_voltro_ai_flows", {
-	id: ve({ prefix: "aifl" }),
+var N = we("_voltro_ai_flows", {
+	id: xe({ 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: be().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(Te(), Ee(), De()).index(["status"]).index(["visibility"]), P = we("_voltro_ai_flow_runs", {
+	id: xe({ prefix: "aifr" }),
 	flowRef: O(),
 	flowName: O().nullable(),
 	mode: O().default("deterministic"),
@@ -58,34 +59,85 @@ 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(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) => {
+	F.current = e;
+}, He = () => F.current, Ue = () => {
+	F.current = {};
+}, I = (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) => {
+	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) => {
 	let t = [];
-	for (let n of e.matchAll(ke)) t.push(n[1]);
+	for (let n of e.matchAll(Ke)) t.push(n[1]);
 	return t;
-}, z = (e, t) => e.replace(ke, (e, n) => {
+}, R = (e, t) => e.replace(Ke, (e, n) => {
 	let r = t[n];
 	return r == null ? "" : typeof r == "string" ? r : JSON.stringify(r);
-}), Ae = (e, t) => {
+}), qe = (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) => {
-	B.set(e.name, e);
-}, H = (e) => B.get(e), U = () => [...B.values()], je = () => B.clear(), W = (e) => e, Me = C.Struct({
+}, 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) => {
+	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;
+	}
+}, H = (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({
+	key: C.String,
+	value: C.Unknown
+}), U = (e) => {
+	let t = B(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 = {};
+	for (let [e, i] of Object.entries(t)) {
+		let t = U(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({
 	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);
+}), 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);
 	if (n) return n;
-	let r = (yield* S.promise(() => e.store.query(D(I).where(w("id", t)).descriptor)))[0];
-	return r ? g({
+	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 ?? [],
@@ -94,14 +146,15 @@ var I = ye("_voltro_ai_flows", {
 		orchestratorModel: r.orchestratorModel ?? null,
 		orchestratorInstructions: r.orchestratorInstructions ?? null,
 		chain: r.chainTo ?? null,
-		cadence: r.cadence ?? null
-	}) : yield* S.fail(new fe({
+		cadence: r.cadence ?? null,
+		humanTimeoutMs: r.humanTimeoutMs ?? null
+	}) : yield* S.fail(new pe({
 		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({
+}), 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({
 		stepId: n.id,
 		unresolvedRef: a[0],
 		message: `step "${n.id}" references unresolved {{${a[0]}}}`
@@ -126,7 +179,7 @@ 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)
@@ -144,12 +197,9 @@ var I = ye("_voltro_ai_flows", {
 			} : { 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* Me({
 				prompt: e,
-				schema: C.Record({
-					key: C.String,
-					value: C.Unknown
-				}),
+				schema: nt(n.schema),
 				...r ? { provider: K(t, r) } : {}
 			}).pipe(S.map((e) => ({
 				ok: !0,
@@ -167,7 +217,7 @@ var I = ye("_voltro_ai_flows", {
 		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) } : {}
 				}).pipe(S.map((e) => ({
@@ -209,11 +259,11 @@ 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* () {
+}), st = (e, t, n, r, i, a) => S.gen(function* () {
 	let o = { ...i }, c = r.steps.map((e, t) => ({
 		id: t,
 		title: e.title ?? `Step ${t + 1}`,
@@ -229,7 +279,7 @@ var I = ye("_voltro_ai_flows", {
 		startedAt: G()
 	});
 	for (let [i, u] of r.steps.entries()) {
-		if (yield* Pe(e, n)) return {
+		if (yield* at(e, n)) return {
 			runId: n,
 			status: "cancelled"
 		};
@@ -237,7 +287,7 @@ var I = ye("_voltro_ai_flows", {
 			let d = {
 				mode: u.reviewMode ?? "approve",
 				...u.options ? { options: u.options } : {},
-				prompt: z(u.prompt ?? "", o)
+				prompt: R(u.prompt ?? "", o)
 			};
 			c[i] = {
 				...c[i],
@@ -255,33 +305,41 @@ var I = ye("_voltro_ai_flows", {
 				ownerId: a.ownerId,
 				source: a.source
 			})).pipe(S.catchAllCause(() => S.void)));
-			let f = yield* xe(e, {
-				name: y,
-				schema: s
+			let f = Ge({
+				step: u,
+				flow: r,
+				deps: t
+			}), p = yield* Oe(e, {
+				name: y(i),
+				schema: s,
+				timeoutMs: f
 			}).pipe(S.map((e) => ({
 				ok: !0,
 				a: e
-			})), S.catchAll((e) => S.succeed({
+			})), S.catchAllCause((e) => _e.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] = {
+			if (!p.ok) {
+				let t = Number.isFinite(f) ? `human review timed out after ${f}ms` : "human review failed";
+				return c[i] = {
+					...c[i],
+					status: "failed",
+					completedAt: G(),
+					errorMessage: t
+				}, yield* J(e, n, {
+					steps: c,
+					status: "failed",
+					errorMessage: t,
+					completedAt: G(),
+					costMicroUsd: l
+				}), {
+					runId: n,
+					status: "failed"
+				};
+			}
+			let m = p.a;
+			if (m.decision === "reject") return c[i] = {
 				...c[i],
 				status: "failed",
 				completedAt: G(),
@@ -295,11 +353,11 @@ var I = ye("_voltro_ai_flows", {
 				runId: n,
 				status: "cancelled"
 			};
-			u.outputKey && (o[u.outputKey] = p.value ?? p.text ?? p.decision ?? !0), c[i] = {
+			u.outputKey && (o[u.outputKey] = m.value ?? m.text ?? m.decision ?? !0), c[i] = {
 				...c[i],
 				status: "succeeded",
 				completedAt: G(),
-				output: { text: String(p.text ?? p.value ?? p.decision ?? "approved") }
+				output: { text: String(m.text ?? m.value ?? m.decision ?? "approved") }
 			}, yield* J(e, n, {
 				steps: c,
 				status: "running",
@@ -315,11 +373,11 @@ var I = ye("_voltro_ai_flows", {
 			steps: c,
 			currentStep: i
 		});
-		let d = yield* M({
+		let d = yield* A({
 			name: `flow-${i}-${u.id}`,
 			input: { index: i },
-			success: Me,
-			execute: Fe(e, t, u, o, {
+			success: rt,
+			execute: ot(e, t, u, o, {
 				runId: n,
 				tenantId: a.tenantId
 			})
@@ -365,7 +423,7 @@ var I = ye("_voltro_ai_flows", {
 		status: "succeeded",
 		output: u
 	};
-}), Le = (e, t, n, r, i, a) => S.gen(function* () {
+}), 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 = {
@@ -386,7 +444,7 @@ var I = ye("_voltro_ai_flows", {
 	let u = `${t}--chain`, d = `${a.requestId}--chain`;
 	yield* S.promise(async () => {
 		try {
-			await e.store.insert(L.tableName, {
+			await e.store.insert(P.tableName, {
 				id: u,
 				flowRef: o.flowRef,
 				flowName: o.flowRef,
@@ -404,32 +462,32 @@ var I = ye("_voltro_ai_flows", {
 			requestId: d
 		});
 	}).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) => {
+}), 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) => {
 	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) => [
+}, dt = (e) => [
 	e.orchestrator?.instructions ?? "You are an orchestrator that uses the available tools to produce a bundled result.",
-	Re(e),
+	lt(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"), ft = C.Struct({
 	object: C.Record({
 		key: C.String,
 		value: C.Unknown
 	}),
 	planCostMicroUsd: C.Number,
 	toolCostMicroUsd: C.Number,
-	steps: C.Array(ie),
+	steps: C.Array(re),
 	error: C.optional(C.String)
-}), He = (e, t, n, r, i, a, o) => S.gen(function* () {
+}), pt = (e, t, n, r, i, a, o) => S.gen(function* () {
 	yield* J(e, n, {
 		status: "running",
 		startedAt: G(),
 		totalSteps: r.steps.length
 	});
-	let s = yield* M({
+	let s = yield* A({
 		name: "flow-agentic",
 		input: { flowRef: r.name },
-		success: Ve,
+		success: ft,
 		execute: S.gen(function* () {
 			let s = [], c = 0, l = (e) => {
 				let t = s.length;
@@ -449,7 +507,7 @@ var I = ye("_voltro_ai_flows", {
 				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({
@@ -476,7 +534,7 @@ 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)
@@ -501,7 +559,7 @@ var I = ye("_voltro_ai_flows", {
 						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({
@@ -543,7 +601,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,7 +614,7 @@ var I = ye("_voltro_ai_flows", {
 						type: "structured"
 					});
 					yield* d();
-					let i = yield* we({
+					let i = yield* Me({
 						prompt: e,
 						schema: C.Record({
 							key: C.String,
@@ -584,9 +642,9 @@ var I = ye("_voltro_ai_flows", {
 						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* W(t.memoryPrefix(a)).pipe(S.catchAll(() => S.succeed(""))) : "", g = yield* Ne({
+				system: h ? `${h}\n\n${dt(r)}` : dt(r),
+				prompt: ut(i),
 				schema: C.Record({
 					key: C.String,
 					value: C.Unknown
@@ -594,7 +652,7 @@ 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) } : {}
@@ -605,9 +663,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: q(g.r.usage, g.r.providerMetadata, r.orchestrator?.model),
 				toolCostMicroUsd: c,
 				steps: s
 			} : {
@@ -615,7 +673,7 @@ 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;
@@ -639,8 +697,8 @@ var I = ye("_voltro_ai_flows", {
 		status: "succeeded",
 		output: s.object
 	});
-}), Ue = (e, t = {}) => (n, r) => S.gen(function* () {
-	let { runId: r, flowRef: i, input: a } = n, o = yield* M({
+}), mt = (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({
@@ -660,19 +718,19 @@ var I = ye("_voltro_ai_flows", {
 		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* pt(e, t, r, s, a, l, u) : yield* st(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* ct(e, r, s, a, d.output ?? {}, n)), t.onEvent && (d.status === "succeeded" || d.status === "failed") && (yield* W(t.onEvent({
 		kind: d.status,
 		runId: r,
 		flowName: s.name,
 		ownerId: l,
 		source: n.source
 	})).pipe(S.catchAllCause(() => S.void))), d;
-}), We = {
+}), ht = {
 	text: (e) => ({
 		type: "generate",
 		modality: "text",
@@ -699,36 +757,37 @@ var I = ye("_voltro_ai_flows", {
 		type: "human",
 		...e
 	})
-}, Ge = (e) => e.map((e, t) => "id" in e && e.id ? e : {
+}, gt = (e) => e.map((e, t) => "id" in e && e.id ? e : {
 	id: `step-${t}`,
 	...e
-}), Ke = (e) => {
+}), _t = (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));
+		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));
 	}
-	if (n.length > 0) throw new pe({
+	if (n.length > 0) throw new me({
 		flowRef: e.name,
 		message: `flow "${e.name}" has ${n.length} unresolved reference(s)`,
 		issues: n
 	});
-}, qe = (e) => {
-	let t = g({
+}, vt = (e) => {
+	let t = _({
 		name: e.name,
 		mode: e.mode,
-		steps: Ge(e.steps),
+		steps: gt(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 _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) => {
 	let t = [];
-	for (let e of U()) e.cadence && (e.cadence.repeats?.length ?? 0) > 0 && t.push({
+	for (let e of Xe()) e.cadence && (e.cadence.repeats?.length ?? 0) > 0 && t.push({
 		flowRef: e.name,
 		cadence: e.cadence,
 		defaultInput: e.cadence.defaultInput ?? {}
@@ -740,11 +799,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(() => []);
+}, xt = async (e, t = /* @__PURE__ */ new Date()) => {
+	let n = e.workflows, r = [], i = 0, a = await bt(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 (!ge(o.cadence, t) || (i += 1, !n)) continue;
+		let a = yt(o.flowRef, t), s = `run-${a}`;
 		try {
 			try {
 				await e.store.insert("_voltro_ai_flow_runs", {
@@ -770,17 +829,17 @@ var I = ye("_voltro_ai_flows", {
 		matched: i,
 		started: r
 	};
-}, Ze = (e) => ({
+}, St = (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);
+}), 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);
 	return S.gen(function* () {
 		if (n.modality === "image") {
-			let t = yield* Ce({
+			let t = yield* je({
 				prompt: n.prompt,
 				...r ? { provider: i(r) } : {}
 			}), a = t.images[0];
@@ -800,7 +859,7 @@ var I = ye("_voltro_ai_flows", {
 			};
 		}
 		if (n.modality === "audio") {
-			let t = yield* Ee({
+			let t = yield* Pe({
 				text: n.prompt,
 				...r ? { provider: i(r) } : {}
 			}), a = yield* S.promise(() => e.put({
@@ -814,7 +873,7 @@ var I = ye("_voltro_ai_flows", {
 				costMicroUsd: Z(t.usage, t.providerMetadata, r)
 			};
 		}
-		let t = yield* De({
+		let t = yield* Fe({
 			prompt: n.prompt,
 			...r ? { provider: i(r) } : {},
 			...n.params ? { params: n.params } : {}
@@ -838,14 +897,14 @@ var I = ye("_voltro_ai_flows", {
 		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* () {
+}, 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 le({
+	if (i.length > 0) return yield* S.fail(new ue({
 		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 +913,7 @@ var I = ye("_voltro_ai_flows", {
 		source: s,
 		requestId: a,
 		input: r,
-		ownerId: et(e)
+		ownerId: Tt(e)
 	}));
 	let c = e.workflows;
 	return c && (yield* S.promise(() => c.start(v, {
@@ -868,14 +927,14 @@ var I = ye("_voltro_ai_flows", {
 		requestId: a,
 		status: "pending"
 	};
-}), nt = (e, t) => S.gen(function* () {
+}), Dt = (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 +951,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, {
+}), Ot = (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 +962,19 @@ var I = ye("_voltro_ai_flows", {
 		runId: t.runId,
 		message: "run not found"
 	}));
-}), it = (e, t) => S.gen(function* () {
+}), kt = (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* () {
 	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 fe({
 		runId: t.runId,
 		status: r ?? "unknown",
 		message: `run is "${r}", not awaiting a response`
@@ -919,27 +983,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 = kt(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
+	};
+}), 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, {
 	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) => ({
+})), 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,
+		alias: e.alias
+	});
+	Ve(e.humanReviewTimeoutMs === void 0 ? {} : { humanReviewTimeoutMs: e.humanReviewTimeoutMs }), Ce({
+		source: "plugin",
+		table: P.tableName,
+		timeColumn: "createdAt",
+		ttlMs: e.runsTtlMs ?? I(process.env.VOLTRO_AI_FLOW_RUNS_TTL_HOURS, 2160),
+		envVar: Be,
+		label: "ai flow runs",
+		where: Se("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 +1031,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 ve({
 		name: t,
+		baseName: It,
 		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: Ie } },
+		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 { 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 };