@voltro/plugin-ai-flows 0.85.0 → 0.87.0

package/dist/index.js

@@ -1,1748 +1,53 @@
-import { FLOW_RUN_WORKFLOW as e, HUMAN_RESPONSE_SIGNAL_PREFIX as t, flowRunWorkflow as n, humanResponseSignalName as r } from "./workflow.js";
-import { A as i, B as a, C as o, D as s, E as c, F as l, H as u, I as d, L as f, M as p, N as m, O as h, P as g, R as ee, S as _, T as te, V as v, _ as ne, a as re, b as y, c as ie, d as b, f as x, g as ae, h as oe, i as S, j as se, k as ce, l as le, m as ue, n as de, o as C, p as fe, r as pe, s as me, t as he, u as ge, v as _e, w as ve, x as ye, y as be, z as xe } from "./ir-Cjk1kQl9.js";
-import { FlowBriefIncomplete as Se, FlowCapabilityMissing as w, FlowDependencyError as Ce, FlowNotAwaitingResponse as we, FlowNotFound as Te, FlowReviewDeliveryError as Ee, FlowRunNotFound as T, FlowValidationError as De } from "./errors.js";
-import { n as Oe, t as ke } from "./cadence-_9Izk_fL.js";
-import { Cause as E, Effect as D, Exit as Ae, Result as O, Schema as k } from "effect";
-import { WorkflowControlResultSchema as je, WorkflowRunHandleSchema as Me, definePlugin as Ne, pluginInstanceName as Pe } from "@voltro/protocol";
-import { and as Fe, boolean as Ie, eq as A, id as Le, inSet as Re, integer as j, json as M, notInSet as ze, queryFor as N, registerRetention as Be, table as Ve, text as P, timestamp as He } from "@voltro/database";
-import { tenant as Ue } from "@voltro/plugin-multitenancy/mixin";
-import { audit as We } from "@voltro/plugin-audit/mixin";
-import { softDelete as Ge } from "@voltro/plugin-soft-delete/mixin";
-import { SuspensionUnavailable as Ke, awaitSignalSuspending as qe, step as F } from "@voltro/workflow";
-import { defineTool as Je, estimateCostUsd as Ye, gatewayCostUsd as Xe, generateImage as Ze, generateObject as Qe, generateObjectJson as $e, generateObjectWithTools as et, generateSpeech as tt, generateText as nt, generateVideo as rt, isMeteredUsage as it } from "@voltro/ai";
-import { createHash as at } from "node:crypto";
-//#region src/registry.ts
-var I = /* @__PURE__ */ new Map(), ot = (e) => {
-	I.set(e.name, e);
-}, st = (e) => I.get(e), ct = () => [...I.values()], lt = () => I.clear(), L = Ve("_voltro_ai_flows", {
-	id: Le({ prefix: "aifl" }),
-	name: P(),
-	description: P().nullable(),
-	mode: P().default("deterministic"),
-	status: P().default("draft"),
-	visibility: P().default("private"),
-	orchestratorModel: P().nullable(),
-	orchestratorInstructions: P().nullable(),
-	maxSteps: j().default(30),
-	steps: M().nullable(),
-	inputSchema: M().nullable(),
-	chainTo: M().nullable(),
-	cadence: M().nullable(),
-	humanTimeoutMs: j().nullable(),
-	isEnabled: Ie().default(!0),
-	metadata: M().nullable(),
-	icon: P().nullable(),
-	color: P().nullable(),
-	avatarUrl: P().nullable(),
-	usageCount: j().default(0),
-	ownerId: P().nullable()
-}).renamedFrom("ai_flows").with(Ue(), We(), Ge()).index(["status"]).index(["visibility"]), R = Ve("_voltro_ai_flow_runs", {
-	id: Le({ prefix: "aifr" }),
-	flowRef: P(),
-	flowName: P().nullable(),
-	mode: P().default("deterministic"),
-	status: P().default("pending"),
-	source: P().nullable(),
-	requestId: P(),
-	workflowStart: M().nullable(),
-	input: M().nullable(),
-	output: M().nullable(),
-	steps: M().nullable(),
-	currentStep: j().default(0),
-	totalSteps: j().default(0),
-	humanResponse: M().nullable(),
-	chainPending: M().nullable(),
-	chainRefusal: P().nullable(),
-	costMicroUsd: j().default(0),
-	costCompleteness: P().default("unknown"),
-	durationMs: j().nullable(),
-	error: P().nullable(),
-	errorMessage: P().nullable(),
-	startedAt: He().nullable(),
-	completedAt: He().nullable(),
-	cancelledAt: He().nullable(),
-	sessionId: P().nullable(),
-	sessionName: P().nullable(),
-	ownerId: P().nullable(),
-	metadata: M().nullable()
-}).renamedFrom("ai_flow_runs").with(Ue(), We()).index(["flowRef"]).index(["status"]).index(["requestId"]), ut = [L, R], dt = k.Struct({
-	id: k.NonEmptyString,
-	workflowName: k.Literal(e),
-	status: k.Literal("queued")
-}), ft = (t) => ({
-	id: t,
-	workflowName: e,
-	executionId: t,
-	status: "running"
-}), pt = (e) => {
-	let t = `flow start was not executed: ${e.reason}`;
-	return e.incumbentExecutionId === null ? e.failureId === null ? t : `${t} (failure report ${e.failureId})` : `${t} (incumbent execution ${e.incumbentExecutionId})`;
-}, mt = async (e, t = {}) => {
-	let n = e.workflows;
-	if (!n) throw Error("workflow runtime unavailable; flow starts cannot be reconciled");
-	if (n.startsDeferredUntilCommit === !0) return {
-		examined: 0,
-		accepted: 0,
-		notExecuted: 0,
-		pending: 0,
-		failures: []
-	};
-	let r = t.take ?? 200, i = await e.store.query({
-		table: R.tableName,
-		predicate: A("status", "pending"),
-		order: [],
-		take: r,
-		skip: void 0,
-		projection: void 0
-	}), a = {
-		examined: 0,
-		accepted: 0,
-		notExecuted: 0,
-		pending: 0,
-		failures: []
-	};
-	for (let t of i) {
-		let r = t.id;
-		if (typeof r != "string") continue;
-		let i = k.decodeUnknownOption(dt)(t.workflowStart);
-		if (i._tag !== "None") {
-			a.examined++;
-			try {
-				let t = await n.readStart({
-					...i.value,
-					executionId: null
-				});
-				if (t.kind === "pending") {
-					a.pending++;
-					continue;
-				}
-				let o = (/* @__PURE__ */ new Date()).toISOString();
-				if (t.kind === "accepted") {
-					if (await e.store.update(R.tableName, r, { workflowStart: ft(t.executionId) }) === null) throw Error("flow run disappeared while recording its accepted start");
-					a.accepted++;
-					continue;
-				}
-				if (await e.store.update(R.tableName, r, {
-					status: "failed",
-					error: "FlowStartNotExecuted",
-					errorMessage: pt(t),
-					completedAt: o
-				}) === null) throw Error("flow run disappeared while recording that its start will not execute");
-				a.notExecuted++;
-			} catch (e) {
-				a.failures.push({
-					runId: r,
-					cause: e
-				});
-			}
-		}
-	}
-	return a;
-}, ht = 168, gt = "VOLTRO_AI_FLOW_HUMAN_REVIEW_TIMEOUT_HOURS", _t = 2160, vt = "VOLTRO_AI_FLOW_RUNS_TTL_HOURS", yt = 5, bt = "VOLTRO_AI_FLOW_MAX_CHAIN_DEPTH", xt = { current: {} }, St = (e) => {
-	xt.current = e;
-}, Ct = () => xt.current, wt = () => {
-	xt.current = {};
-}, Tt = (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;
-}, Et = (e) => Number.isFinite(e) && e > 0 ? e : Infinity, Dt = (e) => {
-	let t = e.env ?? process.env;
-	return Et(e.step?.timeoutMs ?? e.flow?.humanTimeoutMs ?? e.deps?.humanReviewTimeoutMs ?? Ct().humanReviewTimeoutMs ?? Tt(t.VOLTRO_AI_FLOW_HUMAN_REVIEW_TIMEOUT_HOURS, 168));
-}, Ot = (e) => {
-	let t = e?.env ?? process.env, n = Number(t[bt]), r = e?.maxChainDepth ?? Ct().maxChainDepth ?? (Number.isFinite(n) && n >= 1 ? n : 5);
-	return Number.isFinite(r) && r >= 1 ? r : 5;
-}, kt = /\{\{\s*([\w.-]+)\s*\}\}/g, At = (e) => {
-	let t = [];
-	for (let n of e.matchAll(kt)) t.push(n[1]);
-	return t;
-}, jt = (e, t) => e.replace(kt, (e, n) => {
-	let r = t[n];
-	return r == null ? "" : typeof r == "string" ? r : JSON.stringify(r);
-}), Mt = (e, t) => {
-	let n = /* @__PURE__ */ new Set();
-	for (let r of At(e)) t[r] == null && !n.has(r) && n.add(r);
-	return [...n];
-}, Nt = (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;
-}, Pt = (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();
-}, Ft = k.suspend(() => k.Union([
-	k.Null,
-	k.Boolean,
-	k.Finite,
-	k.String,
-	k.Array(Ft).pipe(k.mutable),
-	k.Record(k.String, Ft)
-])), z = k.Record(k.String, k.Record(k.String, Ft)), It = k.Struct({
-	maxTokens: k.optionalKey(k.Int.pipe(k.check(k.isGreaterThan(0)), k.check(k.isLessThanOrEqualTo(2 ** 53 - 1)))),
-	temperature: k.optionalKey(k.Finite.pipe(k.check(k.isGreaterThanOrEqualTo(0)))),
-	providerOptions: k.optionalKey(z)
-}), Lt = [
-	"maxTokens",
-	"temperature",
-	"providerOptions"
-], Rt = (e) => {
-	if (typeof e != "object" || !e || Array.isArray(e)) return "params must be an object";
-	let t = Object.keys(e), n = t.filter((e) => !Lt.includes(e)).sort(), r = t.filter((t) => Lt.includes(t) && k.decodeUnknownOption(It)({ [t]: e[t] })._tag === "None").sort();
-	return [...n.length > 0 ? [`unsupported field${n.length === 1 ? "" : "s"}: ${n.join(", ")}`] : [], ...r.length > 0 ? [`invalid value for: ${r.join(", ")}`] : []].join("; ");
-}, zt = (e) => D.try({
-	try: () => k.decodeUnknownSync(It, { onExcessProperty: "error" })(e === void 0 ? {} : e),
-	catch: () => `invalid text params (${Rt(e)}): expected maxTokens (positive safe integer), temperature (finite nonnegative number), and/or providerOptions (provider-keyed JSON object); other fields are not supported`
-}), B = k.String.pipe(k.check(k.makeFilter((e) => {
-	try {
-		let t = new URL(e);
-		return (t.protocol === "https:" || t.protocol === "http:") && t.username === "" && t.password === "";
-	} catch {
-		return !1;
-	}
-}))), Bt = k.Record(k.String, B), Vt = (e, t, n = {}) => D.try({
-	try: () => {
-		let r = k.decodeUnknownSync(_, { onExcessProperty: "error" })(e === void 0 ? {} : e), i = Object.fromEntries(Object.entries(r).map(([e, r]) => [e, r.from === "upload" ? r.url : r.artifact === void 0 ? Object.hasOwn(t, r.ref) ? t[r.ref] : void 0 : Object.hasOwn(n, r.ref) ? n[r.ref]?.[r.artifact]?.url : void 0]));
-		return k.decodeUnknownSync(Bt)(i);
-	},
-	catch: () => "invalid or unresolved media input: each slot must resolve to an absolute HTTP(S) URL without embedded credentials"
-}), Ht = k.Struct({
-	url: B,
-	mediaType: k.NonEmptyString
-});
-k.Record(k.String, Ht);
-var Ut = (e, t = {}) => {
-	let n = k.decodeUnknownOption(_)(e === void 0 ? {} : e);
-	if (n._tag === "None") return {};
-	let r = {};
-	for (let [e, i] of Object.entries(n.value)) {
-		if (i.from === "upload") {
-			i.mediaType !== void 0 && k.is(B)(i.url) && (r[e] = {
-				url: i.url,
-				mediaType: i.mediaType
-			});
-			continue;
-		}
-		if (i.artifact === void 0 || !Object.hasOwn(t, i.ref)) continue;
-		let n = t[i.ref]?.[i.artifact];
-		n !== void 0 && k.is(B)(n.url) && (r[e] = {
-			url: n.url,
-			mediaType: n.mediaType
-		});
-	}
-	return r;
-}, Wt = (e, t) => D.try({
-	try: () => {
-		let n = k.decodeUnknownSync(Bt)(t === void 0 ? {} : t), r = e === "image" ? ["referenceImageUrl", "maskImageUrl"] : e === "video" ? [
-			"referenceImageUrl",
-			"firstFrameImageUrl",
-			"lastFrameImageUrl",
-			"referenceVideoUrl"
-		] : [];
-		if (Object.keys(n).some((e) => !r.includes(e))) throw Error("unsupported slot");
-		if (e === "image" && n.maskImageUrl !== void 0 && n.referenceImageUrl === void 0) throw Error("mask requires reference");
-		return n;
-	},
-	catch: () => `invalid or unsupported media input for ${e}; check the built-in adapter's slot contract`
-}), Gt = k.Struct({
-	artifacts: y,
-	costMicroUsd: k.optional(k.Finite.pipe(k.check(k.isGreaterThanOrEqualTo(0)))),
-	costSource: k.optional(S),
-	requestId: k.optional(k.NonEmptyString),
-	usage: k.optional(m)
-}), Kt = (e) => D.try({
-	try: () => k.decodeUnknownSync(Gt, { onExcessProperty: "error" })(e),
-	catch: () => "invalid media result: expected artifacts with URL, mediaType and role, exactly one primary artifact, and optional storage references"
-}), V = (e) => e, qt = (e) => e._tag === "FlowAgentUnavailable" ? e.publicMessage ?? "agent unavailable" : "agent not found", Jt = k.Struct({
-	value: k.optional(k.Unknown),
-	text: k.optional(k.String),
-	url: k.optional(k.String),
-	artifacts: k.optional(y),
-	costMicroUsd: k.optional(k.Number),
-	costSource: k.optional(S),
-	requestId: k.optional(k.String),
-	usage: k.optional(m),
-	error: k.optional(k.String)
-}), Yt = (e) => Kt(e).pipe(D.map((e) => {
-	let t = e.artifacts.find((e) => e.role === "primary");
-	return {
-		value: t.url,
-		url: t.url,
-		artifacts: e.artifacts,
-		...e.requestId === void 0 ? {} : { requestId: e.requestId },
-		...e.costMicroUsd === void 0 ? {} : { costMicroUsd: e.costMicroUsd },
-		...e.costSource === void 0 ? {} : { costSource: e.costSource },
-		...e.usage === void 0 ? {} : { usage: e.usage }
-	};
-}), D.catch((e) => D.succeed({ error: e }))), H = (e) => ({
-	...e.requestId ? { requestId: e.requestId } : {},
-	...e.costMicroUsd ? { costMicroUsd: e.costMicroUsd } : {},
-	...e.costSource === void 0 ? {} : { costSource: e.costSource },
-	...e.usage === void 0 ? {} : { usage: e.usage }
-}), U = () => (/* @__PURE__ */ new Date()).toISOString(), Xt = (e) => Math.round(e * 1e6), Zt = (e) => ({
-	name: "gateway",
-	model: e
-}), W = (e, t) => e.resolveModel?.(t) ?? Zt(t), Qt = (e, t, n, r) => D.gen(function* () {
-	return t.maxSteps !== void 0 && (!Number.isSafeInteger(t.maxSteps) || t.maxSteps < 1) ? yield* D.fail(new w({
-		capability: "resolveAgent",
-		message: "agent maxSteps must be a positive safe integer"
-	})) : yield* nt({
-		...r,
-		system: t.system,
-		prompt: n,
-		provider: W(e, t.model),
-		...t.tools === void 0 ? {} : { tools: t.tools },
-		...t.maxSteps === void 0 ? {} : { maxSteps: t.maxSteps }
-	});
-}), $t = (e, t, n) => G(e, t, n).costMicroUsd, G = (e, t, n) => {
-	let r = Xe(t);
-	if (typeof r == "number") return {
-		costMicroUsd: Xt(r),
-		costSource: "gateway"
-	};
-	let i = Ye(e, { model: n ?? "unknown" });
-	return {
-		costMicroUsd: i.costMicroUsd ?? 0,
-		costSource: i.costSource ?? "unpriced"
-	};
-}, K = (e) => {
-	let t = e.filter((e) => (e.status === "succeeded" || e.status === "failed") && (e.costSource !== void 0 || e.costMicroUsd !== void 0));
-	if (t.length === 0) return "unknown";
-	let n = t.map((e) => e.costSource ?? "unpriced");
-	return n.every((e) => e === "gateway") ? "actual" : n.some((e) => e === "unpriced") ? "incomplete" : "estimated";
-}, q = (e, t, n) => D.promise(() => e.store.update(R.tableName, t, n).then(() => void 0)).pipe(D.catchCause(() => D.void)), en = (e, t, n, r) => D.promise(async () => {
-	let i = await e.store.query(N(R).where(A("id", t)).descriptor), a = i[0]?.[r];
-	i[0] !== void 0 && a == null && await e.store.update(R.tableName, t, n);
-}).pipe(D.catchCause(() => D.void)), tn = (e, t) => D.promise(async () => {
-	let n = (await e.store.query(N(R).where(A("id", t)).descriptor))[0]?.status;
-	return n === "cancelling" || n === "cancelled";
-}).pipe(D.catchCause(() => D.succeed(!1))), nn = (e, t) => D.promise(() => e.store.updateMany(R.tableName, {
-	status: "cancelled",
-	completedAt: U()
-}, { where: Fe(A("id", t), A("status", "cancelling")) }).then(() => void 0)).pipe(D.catchCause(() => D.void)), rn = (e, t) => D.gen(function* () {
-	let n = st(t);
-	if (n) return n;
-	let r = (yield* D.promise(() => e.store.query(N(L).where(A("id", t)).descriptor)))[0];
-	return r ? d({
-		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* D.fail(new Te({
-		flowRef: t,
-		message: `no flow registered or stored for "${t}"`
-	}));
-}), an = (e, t, n, r, i, a) => D.gen(function* () {
-	let e = jt(n.prompt ?? "", r), o = yield* zt(n.type === "agent" || n.type === "structured" || n.type === "generate" && (n.modality ?? "text") === "text" ? n.params : void 0).pipe(D.result);
-	if (O.isFailure(o)) return { error: `step "${n.id}": ${o.failure}` };
-	if (n.mediaInputs !== void 0 && (n.type !== "generate" || (n.modality ?? "text") === "text")) return { error: `step "${n.id}": media inputs require an image, video or audio generation step` };
-	let s = Mt(n.prompt ?? "", r);
-	if (s.length > 0) return { error: new Ce({
-		stepId: n.id,
-		unresolvedRef: s[0],
-		message: `step "${n.id}" references unresolved {{${s[0]}}}`
-	}).message };
-	switch (n.type) {
-		case "note": return {
-			value: e,
-			text: e,
-			costMicroUsd: 0,
-			costSource: "gateway"
-		};
-		case "agent": {
-			if (!n.agentRef) return { error: "agent step missing agentRef" };
-			if (!t.resolveAgent) return { error: new w({
-				capability: "resolveAgent",
-				message: "no agent resolver configured"
-			}).message };
-			let r = yield* V(t.resolveAgent(n.agentRef, i)).pipe(D.map((e) => ({
-				ok: !0,
-				a: e
-			})), D.catch((e) => D.succeed({
-				ok: !1,
-				e
-			})));
-			if (!r.ok) return { error: r.e.message };
-			let a = yield* Qt(t, r.a, e, o.success).pipe(D.map((e) => ({
-				ok: !0,
-				r: e
-			})), D.catch((e) => D.succeed({
-				ok: !1,
-				e
-			})));
-			return a.ok ? {
-				value: a.r.text,
-				text: a.r.text,
-				...G(a.r.usage, a.r.providerMetadata, r.a.model)
-			} : { error: String(a.e.message ?? a.e) };
-		}
-		case "structured": {
-			if (n.schema === void 0) return { error: `step "${n.id}": structured step requires a JSON Schema` };
-			let r = n.model ?? t.defaultModels?.text, i = yield* $e({
-				...o.success,
-				prompt: e,
-				jsonSchema: n.schema,
-				...r ? { provider: W(t, r) } : {}
-			}).pipe(D.map((e) => ({
-				ok: !0,
-				r: e
-			})), D.catch((e) => D.succeed({
-				ok: !1,
-				e
-			})));
-			return i.ok ? {
-				value: i.r.object,
-				text: JSON.stringify(i.r.object, null, 2),
-				...G(i.r.usage, i.r.providerMetadata, r)
-			} : { error: String(i.e.message ?? i.e) };
-		}
-		case "generate": {
-			let s = n.modality ?? "text";
-			if (s === "text") {
-				let r = n.model ?? t.defaultModels?.text, i = yield* nt({
-					...o.success,
-					prompt: e,
-					...r ? { provider: W(t, r) } : {}
-				}).pipe(D.map((e) => ({
-					ok: !0,
-					r: e
-				})), D.catch((e) => D.succeed({
-					ok: !1,
-					e
-				})));
-				return i.ok ? {
-					value: i.r.text,
-					text: i.r.text,
-					...G(i.r.usage, i.r.providerMetadata, r)
-				} : { error: String(i.e.message ?? i.e) };
-			}
-			if (!t.generateMedia) return { error: new w({
-				capability: `media:${s}`,
-				message: `no media generator configured for ${s}`
-			}).message };
-			let c = yield* Vt(n.mediaInputs, r, a).pipe(D.result);
-			if (O.isFailure(c)) return { error: `step "${n.id}": ${c.failure}` };
-			let l = Ut(n.mediaInputs, a), u = n.model ?? t.defaultModels?.[s], d = yield* V(t.generateMedia({
-				modality: s,
-				...u ? { model: u } : {},
-				prompt: e,
-				...n.params ? { params: n.params } : {},
-				...n.mediaInputs === void 0 ? {} : { inputs: c.success },
-				...Object.keys(l).length > 0 ? { inputRefs: l } : {},
-				run: i
-			})).pipe(D.map((e) => ({
-				ok: !0,
-				m: e
-			})), D.catch((e) => D.succeed({
-				ok: !1,
-				e
-			})));
-			if (!d.ok) {
-				let e = d.e.receipt;
-				return {
-					error: d.e.message,
-					...e === void 0 ? {} : e
-				};
-			}
-			return yield* Yt(d.m);
-		}
-		case "human": return { error: new w({
-			capability: "human",
-			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)}` };
-	}
-}), on = (e, t, n, i, o, s) => D.gen(function* () {
-	let c = Object.assign(Object.create(null), o), l = Object.create(null), u = i.steps.map((e, t) => ({
-		id: t,
-		title: e.title ?? `Step ${t + 1}`,
-		type: e.type,
-		status: "pending",
-		...e.description ? { description: e.description } : {}
-	})), d = 0;
-	yield* en(e, n, {
-		status: "running",
-		steps: u,
-		totalSteps: i.steps.length,
-		currentStep: 0,
-		startedAt: U()
-	}, "startedAt");
-	for (let o of Nt(i.steps)) {
-		if (yield* tn(e, n)) return yield* nn(e, n), {
-			runId: n,
-			status: "cancelled"
-		};
-		if (o.steps.length > 1) {
-			let r = [];
-			for (let { index: e, step: t } of o.steps) {
-				if (t.when !== void 0 && !v(t.when, c)) {
-					u[e] = {
-						...u[e],
-						status: "skipped",
-						completedAt: U(),
-						skipReason: a(t.when)
-					};
-					continue;
-				}
-				r.push({
-					index: e,
-					step: t
-				}), u[e] = {
-					...u[e],
-					status: "running",
-					startedAt: U()
-				};
-			}
-			yield* q(e, n, {
-				steps: u,
-				currentStep: o.steps[0].index
-			});
-			let i = yield* D.all(r.map(({ index: r, step: i }) => F({
-				name: `flow-${r}-${i.id}`,
-				input: { index: r },
-				success: Jt,
-				execute: an(e, t, i, c, {
-					runId: n,
-					tenantId: s.tenantId,
-					ownerId: s.ownerId
-				}, l)
-			}).pipe(D.map((e) => ({
-				index: r,
-				step: i,
-				result: e
-			})))), { concurrency: "unbounded" }), f = i.find((e) => e.result.error);
-			for (let { index: e, step: t, result: n } of i) {
-				if (n.error) {
-					d += n.costMicroUsd ?? 0, u[e] = {
-						...u[e],
-						status: "failed",
-						completedAt: U(),
-						errorMessage: n.error,
-						...H(n)
-					};
-					continue;
-				}
-				t.outputKey && n.value !== void 0 && (c[t.outputKey] = n.value), t.outputKey && n.artifacts !== void 0 && (l[t.outputKey] = n.artifacts), d += n.costMicroUsd ?? 0, u[e] = {
-					...u[e],
-					status: "succeeded",
-					completedAt: U(),
-					...n.text ? { output: { text: n.text } } : {},
-					...n.url ? { url: n.url } : {},
-					...n.artifacts === void 0 ? {} : { artifacts: n.artifacts },
-					...H(n)
-				};
-			}
-			if (f !== void 0) return yield* q(e, n, {
-				steps: u,
-				status: "failed",
-				errorMessage: f.result.error,
-				completedAt: U(),
-				costMicroUsd: d,
-				costCompleteness: K(u)
-			}), {
-				runId: n,
-				status: "failed"
-			};
-			yield* q(e, n, {
-				steps: u,
-				currentStep: o.steps[o.steps.length - 1].index + 1,
-				costMicroUsd: d,
-				costCompleteness: K(u)
-			});
-			continue;
-		}
-		let { index: f, step: p } = o.steps[0];
-		if (p.when !== void 0 && !v(p.when, c)) {
-			u[f] = {
-				...u[f],
-				status: "skipped",
-				completedAt: U(),
-				skipReason: a(p.when)
-			}, yield* q(e, n, {
-				steps: u,
-				currentStep: f + 1
-			});
-			continue;
-		}
-		if (p.type === "human") {
-			let a = {
-				mode: p.reviewMode ?? "approve",
-				...p.options ? { options: p.options } : {},
-				prompt: jt(p.prompt ?? "", c)
-			};
-			u[f] = {
-				...u[f],
-				status: "waiting",
-				startedAt: U(),
-				review: a
-			}, yield* q(e, n, {
-				steps: u,
-				status: "waiting",
-				currentStep: f
-			}), t.onEvent && (yield* V(t.onEvent({
-				kind: "review-needed",
-				runId: n,
-				flowName: i.name,
-				ownerId: s.ownerId,
-				source: s.source
-			})).pipe(D.catchCause(() => D.void)));
-			let o = Dt({
-				step: p,
-				flow: i,
-				deps: t
-			}), l = yield* qe(e, {
-				name: r(f),
-				schema: ue,
-				timeoutMs: o
-			}).pipe(D.map((e) => ({
-				ok: !0,
-				a: e
-			})), D.catchCause((e) => E.hasInterruptsOnly(e) ? D.failCause(e) : D.succeed({
-				ok: !1,
-				cause: e
-			})));
-			if (!l.ok) {
-				let t = Number.isFinite(o) ? `human review timed out after ${o}ms` : "human review failed";
-				return u[f] = {
-					...u[f],
-					status: "failed",
-					completedAt: U(),
-					errorMessage: t
-				}, yield* q(e, n, {
-					steps: u,
-					status: "failed",
-					errorMessage: t,
-					completedAt: U(),
-					costMicroUsd: d,
-					costCompleteness: K(u)
-				}), {
-					runId: n,
-					status: "failed"
-				};
-			}
-			let m = l.a;
-			if (m.decision === "reject") return u[f] = {
-				...u[f],
-				status: "failed",
-				completedAt: U(),
-				errorMessage: "rejected by reviewer"
-			}, yield* q(e, n, {
-				steps: u,
-				status: "cancelled",
-				humanResponse: m,
-				completedAt: U(),
-				costMicroUsd: d,
-				costCompleteness: K(u)
-			}), {
-				runId: n,
-				status: "cancelled"
-			};
-			p.outputKey && (c[p.outputKey] = m.value ?? m.text ?? m.decision ?? !0), u[f] = {
-				...u[f],
-				status: "succeeded",
-				completedAt: U(),
-				output: { text: String(m.text ?? m.value ?? m.decision ?? "approved") }
-			}, yield* q(e, n, {
-				steps: u,
-				status: "running",
-				humanResponse: m,
-				currentStep: f + 1
-			});
-			continue;
-		}
-		u[f] = {
-			...u[f],
-			status: "running",
-			startedAt: U()
-		}, yield* q(e, n, {
-			steps: u,
-			currentStep: f
-		});
-		let m = yield* F({
-			name: `flow-${f}-${p.id}`,
-			input: { index: f },
-			success: Jt,
-			execute: an(e, t, p, c, {
-				runId: n,
-				tenantId: s.tenantId,
-				ownerId: s.ownerId
-			}, l)
-		});
-		if (m.error) return d += m.costMicroUsd ?? 0, u[f] = {
-			...u[f],
-			status: "failed",
-			completedAt: U(),
-			errorMessage: m.error,
-			...H(m)
-		}, yield* q(e, n, {
-			steps: u,
-			status: "failed",
-			errorMessage: m.error,
-			completedAt: U(),
-			costMicroUsd: d,
-			costCompleteness: K(u)
-		}), {
-			runId: n,
-			status: "failed"
-		};
-		p.outputKey && m.value !== void 0 && (c[p.outputKey] = m.value), p.outputKey && m.artifacts !== void 0 && (l[p.outputKey] = m.artifacts), d += m.costMicroUsd ?? 0, u[f] = {
-			...u[f],
-			status: "succeeded",
-			completedAt: U(),
-			...m.text ? { output: { text: m.text } } : {},
-			...m.url ? { url: m.url } : {},
-			...m.artifacts === void 0 ? {} : { artifacts: m.artifacts },
-			...H(m)
-		}, yield* q(e, n, {
-			steps: u,
-			currentStep: f + 1,
-			costMicroUsd: d,
-			costCompleteness: K(u)
-		});
-	}
-	let f = Object.create(null);
-	for (let e of i.steps) e.outputKey && c[e.outputKey] !== void 0 && (f[e.outputKey] = c[e.outputKey]);
-	return yield* q(e, n, {
-		status: "succeeded",
-		output: f,
-		completedAt: U(),
-		costMicroUsd: d
-	}), {
-		runId: n,
-		status: "succeeded",
-		output: f
-	};
-}), sn = (e, t, n, r, i, a, o) => D.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* q(e, t, { chainRefusal: `chain to "${s.flowRef}" refused — it is already in this run's chain (${c.join(" → ")}), which would loop` });
-		return;
-	}
-	let l = Ot(o);
-	if (c.length >= l) {
-		yield* q(e, t, { chainRefusal: `chain to "${s.flowRef}" refused — depth ${c.length} reached the limit of ${l} (${c.join(" → ")})` });
-		return;
-	}
-	let u = {
-		...r,
-		...i
-	}, d = {};
-	for (let e of s.mappings) e.sourceKey in u && (d[e.targetKey] = u[e.sourceKey]);
-	if (s.requireConfirmation) {
-		yield* q(e, t, { chainPending: {
-			flowRef: s.flowRef,
-			input: d,
-			status: "pending"
-		} });
-		return;
-	}
-	let f = e.workflows;
-	if (!f) return;
-	let p = `${t}--chain`, m = `${a.requestId}--chain`;
-	yield* D.promise(async () => {
-		try {
-			await e.store.insert(R.tableName, {
-				id: p,
-				flowRef: s.flowRef,
-				flowName: s.flowRef,
-				status: "pending",
-				source: a.source,
-				requestId: m,
-				input: d
-			});
-		} catch {}
-		await f.child("flow.run", {
-			runId: p,
-			flowRef: s.flowRef,
-			input: d,
-			source: a.source,
-			requestId: m,
-			chainPath: c
-		});
-	}).pipe(D.catchCause(() => D.void));
-}), cn = (e) => e.type === "agent" ? e.agentRef ? `agent step, agent "${e.agentRef}"` : "agent step" : e.type === "generate" ? `${e.modality ?? "media"} generation step` : `${e.type} step`, ln = (e) => e.steps.length === 0 ? "" : "Suggested plan (you MAY reorder, insert, or skip steps):\n" + e.steps.map((e, t) => `${t + 1}. ${e.title ?? e.id}${e.prompt ? `: ${e.prompt}` : ""} (${cn(e)})`).join("\n"), un = "an agentic flow runs its planner and every tool inside one durable step, which cannot park. Call the provider directly from the tool (generateImage, generateVideo, …), or give the work its own deterministic flow step", dn = k.optional(k.String.annotate({ description: "One short sentence: what this call is for. Shown to the user in the run timeline." })), fn = (e) => e === void 0 || e.trim() === "" ? {} : { description: e.trim().slice(0, 200) }, pn = k.Struct({ json: k.String.annotate({ description: "The requested JSON object, serialized as a JSON string." }) }), mn = (e) => {
-	try {
-		let t = JSON.parse(e);
-		return typeof t == "object" && t && !Array.isArray(t) ? t : void 0;
-	} catch {
-		return;
-	}
-}, hn = (e) => {
-	if (Ae.isSuccess(e)) return "the tool returned without recording a result";
-	if (E.hasInterruptsOnly(e.cause)) return "interrupted before it finished — nothing waited for its result";
-	let t = E.squash(e.cause);
-	return t instanceof Error ? t.message : String(t);
-}, gn = (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");
-}, _n = (e) => [
-	e.orchestrator?.instructions ?? "You are an orchestrator that uses the available tools to produce a bundled result.",
-	ln(e),
-	"When finished, emit a JSON object mapping each deliverable name (outputKey) to its value, serialized as a string in the json field."
-].filter(Boolean).join("\n\n"), vn = k.Struct({
-	object: k.Record(k.String, k.Unknown),
-	planCostMicroUsd: k.Number,
-	planCostSource: k.optional(S),
-	toolCostMicroUsd: k.Number,
-	steps: k.Array(i),
-	error: k.optional(k.String)
-}), yn = (e, t, n, r, i, a, o, s) => D.gen(function* () {
-	yield* en(e, n, {
-		status: "running",
-		startedAt: U(),
-		totalSteps: r.steps.length
-	}, "startedAt");
-	let c = yield* F({
-		name: "flow-agentic",
-		input: { flowRef: r.name },
-		success: vn,
-		execute: D.gen(function* () {
-			let c = [], l = 0, u = (e) => {
-				let t = c.length;
-				return c.push({
-					id: t,
-					status: "running",
-					startedAt: U(),
-					...e
-				}), t;
-			}, d = (e, t) => {
-				c[e] = {
-					...c[e],
-					completedAt: U(),
-					...t
-				};
-			}, f = () => q(e, n, {
-				steps: c,
-				currentStep: c.length,
-				costMicroUsd: l
-			}), p = (e, t) => D.suspend(() => {
-				let n = u(e);
-				return D.andThen(f(), t(n)).pipe(D.onExit((e) => c[n]?.status === "running" ? (d(n, {
-					status: "failed",
-					errorMessage: hn(e)
-				}), D.ignore(f())) : D.void));
-			}), m = yield* (t.listAgents ? V(t.listAgents({
-				runId: n,
-				tenantId: o,
-				ownerId: a
-			})) : D.succeed(void 0)).pipe(D.result);
-			if (O.isFailure(m)) return yield* D.logWarning(`flow agent listing failed for run ${n}: ${m.failure.message}`).pipe(D.annotateLogs({ scope: "voltro:ai-flows" })), {
-				object: {},
-				planCostMicroUsd: 0,
-				toolCostMicroUsd: 0,
-				steps: c,
-				error: "flow agent listing failed"
-			};
-			let h = m.success, g = h ?? [...new Set(r.steps.flatMap((e) => e.type === "agent" && e.agentRef ? [e.agentRef] : []))].map((e) => ({ ref: e })), ee = g.map((e) => e.ref), _ = ee.length > 0 ? k.Literals(ee) : k.String, te = Je({
-				name: "run_agent",
-				description: "Delegate a text task to an allowed sub-agent. Returns the agent's text." + (g.length > 0 ? ` Agents you may call: ${g.map((e) => e.description ? `${e.ref} (${e.description})` : e.ref).join("; ")}.` : ""),
-				input: k.Struct({
-					agentRef: _,
-					prompt: k.String,
-					purpose: dn
-				}),
-				execute: ({ agentRef: e, prompt: r, purpose: i }) => p({
-					title: `agent:${e}`,
-					type: "agent",
-					agentRef: e,
-					...fn(i)
-				}, (i) => D.gen(function* () {
-					if (!t.resolveAgent) return d(i, {
-						status: "failed",
-						errorMessage: "no agent resolver configured"
-					}), yield* f(), "ERROR: no agent resolver configured";
-					let s = yield* V(t.resolveAgent(e, {
-						runId: n,
-						tenantId: o,
-						ownerId: a
-					})).pipe(D.map((e) => ({
-						ok: !0,
-						a: e
-					})), D.catch((e) => D.succeed({
-						ok: !1,
-						e
-					})));
-					if (!s.ok) return d(i, {
-						status: "failed",
-						errorMessage: s.e.message
-					}), yield* f(), `ERROR: ${qt(s.e)}`;
-					let c = yield* Qt(t, s.a, r, {}).pipe(D.map((e) => ({
-						ok: !0,
-						r: e
-					})), D.catch((e) => D.succeed({
-						ok: !1,
-						e
-					})));
-					if (!c.ok) {
-						let e = String(c.e.message ?? c.e);
-						return d(i, {
-							status: "failed",
-							errorMessage: e
-						}), yield* f(), `ERROR: ${e}`;
-					}
-					let u = $t(c.r.usage, c.r.providerMetadata, s.a.model);
-					return l += u, d(i, {
-						status: "succeeded",
-						output: { text: c.r.text },
-						costMicroUsd: u
-					}), yield* f(), c.r.text;
-				}))
-			}), v = Je({
-				name: "generate_media",
-				description: "Generate image, video, or audio artifacts. Returns every artifact with its URL, role, media type and optional storage reference.",
-				input: k.Struct({
-					modality: k.Literals([
-						"image",
-						"video",
-						"audio"
-					]),
-					prompt: k.String,
-					purpose: dn,
-					model: k.optional(k.String),
-					inputs: k.optional(Bt),
-					params: k.optional(k.Record(k.String, k.Unknown))
-				}),
-				execute: ({ modality: e, prompt: r, purpose: i, model: s, inputs: c, params: u }) => p({
-					title: `media:${e}`,
-					type: "generate",
-					modality: e,
-					...fn(i)
-				}, (i) => D.gen(function* () {
-					if (!t.generateMedia) return d(i, {
-						status: "failed",
-						errorMessage: `no media generator for ${e}`
-					}), yield* f(), `ERROR: no media generator configured for ${e}`;
-					let p = yield* V(t.generateMedia({
-						modality: e,
-						prompt: r,
-						...s ? { model: s } : {},
-						...c === void 0 ? {} : { inputs: c },
-						...u === void 0 ? {} : { params: u },
-						run: {
-							runId: n,
-							tenantId: o,
-							ownerId: a
-						}
-					})).pipe(D.map((e) => ({
-						ok: !0,
-						r: e
-					})), D.catch((e) => D.succeed({
-						ok: !1,
-						e
-					})));
-					if (!p.ok) return d(i, {
-						status: "failed",
-						errorMessage: p.e.message
-					}), yield* f(), `ERROR: ${p.e.message}`;
-					let m = yield* Yt(p.r);
-					return m.error ? (d(i, {
-						status: "failed",
-						errorMessage: m.error
-					}), yield* f(), { error: m.error }) : (l += m.costMicroUsd ?? 0, d(i, {
-						status: "succeeded",
-						url: m.url,
-						artifacts: m.artifacts,
-						...m.requestId ? { requestId: m.requestId } : {},
-						costMicroUsd: m.costMicroUsd ?? 0,
-						costSource: m.costSource ?? "unpriced"
-					}), yield* f(), { artifacts: m.artifacts });
-				}))
-			}), ne = Je({
-				name: "pick_structured",
-				description: "Produce a JSON object for a task. Returns the object.",
-				input: k.Struct({
-					prompt: k.String,
-					purpose: dn,
-					model: k.optional(k.String)
-				}),
-				execute: ({ prompt: e, purpose: n, model: r }) => p({
-					title: "structured",
-					type: "structured",
-					...fn(n)
-				}, (n) => D.gen(function* () {
-					let i = yield* Qe({
-						prompt: `${e}\n\nReturn the JSON object serialized as a string in the \`json\` field.`,
-						schema: pn,
-						...r ? { provider: W(t, r) } : {}
-					}).pipe(D.map((e) => ({
-						ok: !0,
-						r: e
-					})), D.catch((e) => D.succeed({
-						ok: !1,
-						e
-					})));
-					if (!i.ok) {
-						let e = String(i.e.message ?? i.e);
-						return d(n, {
-							status: "failed",
-							errorMessage: e
-						}), yield* f(), { error: e };
-					}
-					let a = $t(i.r.usage, i.r.providerMetadata, r);
-					l += a;
-					let o = mn(i.r.object.json);
-					if (o === void 0) {
-						let e = "the model's `json` field is not a JSON object";
-						return d(n, {
-							status: "failed",
-							errorMessage: e,
-							costMicroUsd: a
-						}), yield* f(), { error: e };
-					}
-					return d(n, {
-						status: "succeeded",
-						output: { text: JSON.stringify(o) },
-						costMicroUsd: a
-					}), yield* f(), o;
-				}))
-			}), re = {
-				run_agent: te,
-				generate_media: v,
-				pick_structured: ne
-			}, y = yield* (t.resolveTools ? V(t.resolveTools(s, {
-				runId: n,
-				tenantId: o,
-				ownerId: a
-			}, { provider: () => r.orchestrator?.model ? W(t, r.orchestrator.model) : void 0 })) : D.succeed({})).pipe(D.result);
-			if (O.isFailure(y)) return yield* D.logWarning(`flow tool resolution failed for run ${n}: ${y.failure.message}`).pipe(D.annotateLogs({ scope: "voltro:ai-flows" })), {
-				object: {},
-				planCostMicroUsd: 0,
-				toolCostMicroUsd: 0,
-				steps: c,
-				error: "flow tool resolution failed"
-			};
-			if (Object.keys(y.success).some((e) => Object.hasOwn(re, e))) return {
-				object: {},
-				planCostMicroUsd: 0,
-				toolCostMicroUsd: 0,
-				steps: c,
-				error: "flow tools cannot replace reserved planner tools"
-			};
-			let ie = t.memoryPrefix ? yield* V(t.memoryPrefix(a)).pipe(D.catch(() => D.succeed(""))) : "", b = ie ? `${ie}\n\n${_n(r)}` : _n(r), x = yield* et({
-				system: b,
-				prompt: gn(i),
-				schema: pn,
-				tools: {
-					...y.success,
-					...h?.length === 0 ? {
-						generate_media: v,
-						pick_structured: ne
-					} : re
-				},
-				maxSteps: r.maxSteps,
-				...r.orchestrator?.model ? { provider: W(t, r.orchestrator.model) } : {}
-			}).pipe(D.provideService(Ke, un), D.map((e) => ({
-				ok: !0,
-				r: e
-			})), D.catch((e) => D.succeed({
-				ok: !1,
-				e
-			})));
-			for (let e of c) e.status === "running" && d(e.id, {
-				status: "failed",
-				errorMessage: "not finished — the run ended first"
-			});
-			if (!x.ok) return {
-				object: {},
-				planCostMicroUsd: 0,
-				toolCostMicroUsd: l,
-				steps: c,
-				error: String(x.e.message ?? x.e)
-			};
-			let ae = mn(x.r.object.json);
-			return {
-				object: ae ?? {},
-				...ae === void 0 ? { error: "the planner's `json` field is not a JSON object" } : {},
-				planCostMicroUsd: $t(x.r.usage, x.r.providerMetadata, r.orchestrator?.model),
-				planCostSource: G(x.r.usage, x.r.providerMetadata, r.orchestrator?.model).costSource,
-				toolCostMicroUsd: l,
-				steps: c
-			};
-		})
-	}), l = c.planCostMicroUsd + c.toolCostMicroUsd, u = K([...c.steps, {
-		status: "succeeded",
-		costMicroUsd: c.planCostMicroUsd,
-		costSource: c.planCostSource ?? "unpriced"
-	}]);
-	return c.error ? (yield* q(e, n, {
-		status: "failed",
-		steps: c.steps,
-		errorMessage: c.error,
-		completedAt: U(),
-		costMicroUsd: l,
-		costCompleteness: u
-	}), {
-		runId: n,
-		status: "failed"
-	}) : (yield* q(e, n, {
-		status: "succeeded",
-		steps: c.steps,
-		output: c.object,
-		completedAt: U(),
-		costMicroUsd: l,
-		costCompleteness: u
-	}), {
-		runId: n,
-		status: "succeeded",
-		output: c.object
-	});
-}), bn = (e, t = {}) => (n, r) => D.gen(function* () {
-	let { runId: r, flowRef: i, input: a } = n, o = yield* D.tryPromise(() => e.store.query(N(R).where(A("id", r)).descriptor)).pipe(D.flatMap(k.decodeUnknownEffect(k.Tuple([k.Struct({
-		id: k.Literal(r),
-		tenantId: k.NullOr(k.NonEmptyString),
-		ownerId: k.optional(k.NullOr(k.String))
-	})]))), D.result);
-	if (O.isFailure(o)) return yield* q(e, r, {
-		status: "failed",
-		errorMessage: "flow run context unavailable: expected one matching run row with an explicit tenantId (string or null)",
-		completedAt: U()
-	}), {
-		runId: r,
-		status: "failed"
-	};
-	let { tenantId: s, ownerId: c = null } = o.success[0], l = yield* F({
-		name: "flow-0-resolve",
-		input: { flowRef: i },
-		success: k.Struct({
-			ir: k.Unknown,
-			error: k.optional(k.String)
-		}),
-		execute: rn(e, i).pipe(D.flatMap((e) => {
-			for (let t of e.steps) {
-				if (!(t.type === "agent" || t.type === "structured" || t.type === "generate" && (t.modality ?? "text") === "text") || t.params === void 0) continue;
-				let e = D.runSyncExit(zt(t.params));
-				if (Ae.isFailure(e)) return D.succeed({
-					ir: null,
-					error: `step "${t.id}": ${E.squash(e.cause)}`
-				});
-			}
-			return D.succeed({ ir: JSON.parse(JSON.stringify(e)) });
-		}), D.catch((e) => D.succeed({
-			ir: null,
-			error: e.message
-		})))
-	});
-	if (l.error || !l.ir) return yield* q(e, r, {
-		status: "failed",
-		errorMessage: l.error ?? "flow not found",
-		completedAt: U()
-	}), {
-		runId: r,
-		status: "failed"
-	};
-	let u = l.ir, d = u.mode === "agentic" ? yield* yn(e, t, r, u, a, c, s, i) : yield* on(e, t, r, u, a, {
-		ownerId: c,
-		tenantId: s,
-		source: n.source
-	});
-	return d.status === "succeeded" && u.chain && (yield* sn(e, r, u, a, d.output ?? {}, n, t)), t.onEvent && (d.status === "succeeded" || d.status === "failed") && (yield* V(t.onEvent({
-		kind: d.status,
-		runId: r,
-		flowName: u.name,
-		ownerId: c,
-		source: n.source
-	})).pipe(D.catchCause(() => D.void))), d;
-}), xn = {
-	text: (e) => ({
-		type: "generate",
-		modality: "text",
-		...e
-	}),
-	media: (e, t) => ({
-		type: "generate",
-		modality: e,
-		...t
-	}),
-	agent: (e) => ({
-		type: "agent",
-		...e
-	}),
-	structured: (e) => ({
-		type: "structured",
-		...e
-	}),
-	note: (e) => ({
-		type: "note",
-		...e
-	}),
-	human: (e) => ({
-		type: "human",
-		...e
-	})
-}, Sn = (e) => e.map((e, t) => "id" in e && e.id ? e : {
-	id: `step-${t}`,
-	...e
-}), Cn = (e) => {
-	let t = [], n = Nt(e.steps);
-	for (let e of Pt(n)) 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 r = new Set(e.brief.map((e) => e.key));
-	for (let e of n) {
-		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 i of At(n.prompt ?? "")) r.has(i) || t.push(e.steps.length > 1 ? `step "${n.id}" references {{${i}}} 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 {{${i}}} which is not a brief field or a prior step outputKey`);
-			for (let [e, i] of Object.entries(n.mediaInputs ?? {})) i.from === "step" && !r.has(i.ref) && t.push(`step "${n.id}" media input "${e}" references "${i.ref}" which is not a brief field or an earlier segment's outputKey`);
-			n.when !== void 0 && !r.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 && r.add(f(t.outputKey));
-	}
-	if (t.length > 0) throw new De({
-		flowRef: e.name,
-		message: `flow "${e.name}" has ${t.length} problem(s)`,
-		issues: t
-	});
-}, wn = (e) => {
-	let t = d({
-		name: e.name,
-		mode: e.mode,
-		steps: Sn(e.steps),
-		maxSteps: e.maxSteps,
-		brief: e.brief,
-		orchestratorModel: e.orchestrator?.model,
-		orchestratorInstructions: e.orchestrator?.instructions,
-		chain: e.chain,
-		cadence: e.cadence,
-		humanTimeoutMs: e.humanTimeoutMs
-	});
-	return Cn(t), ot(t), t;
-}, Tn = async (e, t, n) => {
-	let r = k.decodeUnknownSync(Me.pipe(k.check(k.makeFilter((e) => e.workflowName === "flow.run" && e.id.length > 0))))(n);
-	if (await e.store.update(R.tableName, t, { workflowStart: r }) === null) throw Error("flow start receipt could not be recorded; workflow submission may have succeeded");
-	return r;
-}, En = (e, t, n) => {
-	if (!Number.isFinite(t.getTime())) throw Error("cadence timestamp must be valid");
-	return `cron-${at("sha256").update(JSON.stringify([
-		n,
-		e,
-		Math.floor(t.getTime() / 6e4)
-	])).digest("hex")}`;
-}, Dn = async (e) => {
-	let t = [];
-	for (let n of ct()) n.cadence && (n.cadence.repeats?.length ?? 0) > 0 && t.push({
-		tenantId: e.request.subject.tenantId,
-		flowRef: n.name,
-		cadence: n.cadence,
-		defaultInput: n.cadence.defaultInput ?? {}
-	});
-	let n = await e.store.select("_voltro_ai_flows").where("isEnabled", !0).all();
-	for (let r of n) r.id && r.cadence && (r.cadence.repeats?.length ?? 0) > 0 && t.push({
-		tenantId: r.tenantId ?? e.request.subject.tenantId,
-		flowRef: r.id,
-		cadence: r.cadence,
-		defaultInput: r.cadence.defaultInput ?? {}
-	});
-	return t;
-}, On = async (e, t = /* @__PURE__ */ new Date()) => {
-	let r = [], i = 0, a = [], o = e.workflows ? await mt(e) : {
-		examined: 0,
-		accepted: 0,
-		notExecuted: 0,
-		pending: 0,
-		failures: []
-	};
-	a.push(...o.failures.map((e) => Error(`flow run ${e.runId}: start reconciliation failed`, { cause: e.cause })));
-	let s = await Dn(e);
-	for (let o of s) {
-		if (!ke(o.cadence, t)) continue;
-		i += 1;
-		let s = En(o.flowRef, t, o.tenantId), c = `run-${s}`;
-		try {
-			if (!e.workflows) throw Error("workflow runtime unavailable; no cadence start was submitted");
-			(await e.transaction(async (e) => {
-				let t = e.workflows;
-				if (!t) throw Error("workflow runtime unavailable in transaction; no cadence start was submitted");
-				await e.store.insertIgnoreWithOutcome("_voltro_ai_flow_runs", {
-					id: c,
-					flowRef: o.flowRef,
-					flowName: o.flowRef,
-					status: "pending",
-					source: "cron",
-					requestId: s,
-					input: o.defaultInput
-				}, { conflictColumns: ["id"] });
-				let r = await e.store.select("_voltro_ai_flow_runs").where("id", c).first();
-				if (!r) throw Error("cadence run is not readable after persistence");
-				let i = k.decodeUnknownSync(n.payloadSchema.pipe(k.check(k.makeFilter((e) => e.runId === c && e.flowRef === o.flowRef && e.requestId === s && e.source === "cron"))))({
-					...r,
-					runId: r.id
-				});
-				return Tn(e, c, await t.start("flow.run", i));
-			}, o.tenantId === null ? void 0 : { tenantId: o.tenantId })).status === "running" && r.push(s);
-		} catch (e) {
-			a.push(e);
-		}
-	}
-	if (a.length > 0) throw AggregateError(a, `${a.length} cadence submission(s) failed`);
-	return {
-		matched: i,
-		started: r,
-		reconciled: o
-	};
-}, J = (e) => k.optionalKey(e), kn = k.Int.pipe(k.check(k.isGreaterThan(0)), k.check(k.isLessThanOrEqualTo(2 ** 53 - 1))), An = k.Int.pipe(k.check(k.isBetween({
-	minimum: -(2 ** 53 - 1),
-	maximum: 2 ** 53 - 1
-}))), jn = k.TemplateLiteral([
-	k.Number,
-	"x",
-	k.Number
-]).pipe(k.check(k.isPattern(/^[1-9]\d*x[1-9]\d*$/))), Mn = k.TemplateLiteral([
-	k.Number,
-	":",
-	k.Number
-]).pipe(k.check(k.isPattern(/^[1-9]\d*:[1-9]\d*$/))), Nn = k.Struct({
-	n: J(kn),
-	seed: J(An),
-	size: J(jn),
-	aspectRatio: J(Mn),
-	providerOptions: J(z)
-}), Pn = k.Struct({
-	voice: J(k.NonEmptyString),
-	outputFormat: J(k.NonEmptyString),
-	instructions: J(k.String),
-	speed: J(k.Finite.pipe(k.check(k.isGreaterThan(0)))),
-	language: J(k.NonEmptyString),
-	providerOptions: J(z)
-}), Fn = k.Struct({
-	aspectRatio: J(Mn),
-	durationSeconds: J(k.Finite.pipe(k.check(k.isGreaterThan(0)))),
-	resolution: J(jn),
-	fps: J(k.Finite.pipe(k.check(k.isGreaterThan(0)))),
-	seed: J(An),
-	generateAudio: J(k.Boolean),
-	maxInlineBytes: J(kn),
-	providerOptions: J(z)
-}), Y = (e, t, n) => D.try({
-	try: () => k.decodeUnknownSync(e, { onExcessProperty: "error" })(t === void 0 ? {} : t),
-	catch: () => `invalid ${n} media params: check the built-in adapter's supported options and value ranges`
-}), In = (e) => Y(Nn, e, "image"), Ln = (e) => Y(Pn, e, "audio"), Rn = (e) => Y(Fn, e, "video"), zn = (e) => ({
-	name: "gateway",
-	model: e
-}), Bn = (e) => Math.round(e * 1e6), X = (e, t, n) => {
-	let r = Xe(t);
-	if (typeof r == "number") return {
-		costMicroUsd: Bn(r),
-		costSource: "gateway"
-	};
-	if (e) {
-		let t = Ye(e, { model: n ?? "unknown" });
-		return {
-			costMicroUsd: t.costMicroUsd ?? 0,
-			costSource: t.costSource ?? "unpriced"
-		};
-	}
-	return {
-		costMicroUsd: 0,
-		costSource: "unpriced"
-	};
-}, Z = (e) => {
-	if (e === void 0) return { status: "unreported" };
-	let [t, n, r] = it(e) ? [
-		e.unit,
-		e.input,
-		e.output
-	] : [
-		"tokens",
-		e.inputTokens,
-		e.outputTokens
-	];
-	return n === void 0 && r === void 0 ? { status: "unreported" } : {
-		status: "reported",
-		unit: t,
-		...n === void 0 ? {} : { input: n },
-		...r === void 0 ? {} : { output: r }
-	};
-}, Q = (e, t, n) => ({
-	...X(e, t, n),
-	usage: Z(e)
-}), Vn = (e, t) => (n) => {
-	let r = n.model, i = (e) => t?.resolveModel?.(e) ?? zn(e);
-	return D.gen(function* () {
-		let t = yield* Wt(n.modality, n.inputs).pipe(D.mapError((e) => new w({
-			capability: `media:${n.modality}`,
-			message: e
-		})));
-		if (n.modality === "image") {
-			let a = yield* In(n.params).pipe(D.mapError((e) => new w({
-				capability: "media:image",
-				message: e
-			}))), o = t.referenceImageUrl, s = t.maskImageUrl, c = yield* Ze({
-				...a,
-				prompt: n.prompt,
-				...o === void 0 ? {} : { inputs: {
-					images: [o],
-					...s === void 0 ? {} : { mask: s }
-				} },
-				...r ? { provider: i(r) } : {}
-			});
-			if (c.images.length === 0) return yield* D.fail(new w({
-				capability: "media:image",
-				message: "no image produced"
-			}));
-			let l = [];
-			for (let [t, i] of c.images.entries()) {
-				let a = yield* e.put({
-					data: i.data,
-					mediaType: i.mediaType,
-					run: n.run
-				}).pipe(D.mapError(() => new w({
-					capability: "media:image",
-					message: "media persistence failed",
-					receipt: Q(c.usage, c.providerMetadata, r)
-				})));
-				l.push({
-					url: a.url,
-					mediaType: i.mediaType,
-					role: t === 0 ? "primary" : "variant",
-					...a.refId === void 0 ? {} : { storageRefId: a.refId },
-					...i.providerMetadata === void 0 ? {} : { providerMetadata: i.providerMetadata }
-				});
-			}
-			return {
-				artifacts: l,
-				...X(c.usage, c.providerMetadata, r),
-				usage: Z(c.usage)
-			};
-		}
-		if (n.modality === "audio") {
-			let t = yield* Ln(n.params).pipe(D.mapError((e) => new w({
-				capability: "media:audio",
-				message: e
-			}))), a = yield* tt({
-				...t,
-				text: n.prompt,
-				...r ? { provider: i(r) } : {}
-			}), o = yield* e.put({
-				data: a.audio.data,
-				mediaType: a.audio.mediaType,
-				run: n.run
-			}).pipe(D.mapError(() => new w({
-				capability: "media:audio",
-				message: "media persistence failed",
-				receipt: Q(a.usage, a.providerMetadata, r)
-			})));
-			return {
-				artifacts: [{
-					url: o.url,
-					mediaType: a.audio.mediaType,
-					role: "primary",
-					...o.refId === void 0 ? {} : { storageRefId: o.refId }
-				}],
-				...X(a.usage, a.providerMetadata, r),
-				usage: Z(a.usage)
-			};
-		}
-		let { maxInlineBytes: a, providerOptions: o, ...s } = yield* Rn(n.params).pipe(D.mapError((e) => new w({
-			capability: "media:video",
-			message: e
-		}))), c = yield* rt({
-			prompt: n.prompt,
-			inputs: {
-				...t.referenceImageUrl === void 0 ? {} : { image: t.referenceImageUrl },
-				...t.referenceVideoUrl === void 0 ? {} : { references: [t.referenceVideoUrl] },
-				frameImages: [...t.firstFrameImageUrl === void 0 ? [] : [{
-					frameType: "first_frame",
-					image: t.firstFrameImageUrl
-				}], ...t.lastFrameImageUrl === void 0 ? [] : [{
-					frameType: "last_frame",
-					image: t.lastFrameImageUrl
-				}]]
-			},
-			...r ? { provider: i(r) } : {},
-			params: s,
-			...o === void 0 ? {} : { providerOptions: o },
-			...a === void 0 ? {} : { maxInlineBytes: a }
-		}), l;
-		if (c.video.url) l = e.ingestUrl ? yield* e.ingestUrl(c.video.url, n.run).pipe(D.mapError(() => new w({
-			capability: "media:video",
-			message: "media persistence failed",
-			receipt: Q(c.usage, c.providerMetadata, r)
-		}))) : { url: c.video.url };
-		else if (c.video.data) l = yield* e.put({
-			data: c.video.data,
-			mediaType: c.video.mediaType,
-			run: n.run
-		}).pipe(D.mapError(() => new w({
-			capability: "media:video",
-			message: "media persistence failed",
-			receipt: Q(c.usage, c.providerMetadata, r)
-		})));
-		else return yield* D.fail(new w({
-			capability: "media:video",
-			message: "no video produced"
-		}));
-		return {
-			artifacts: [{
-				url: l.url,
-				mediaType: c.video.mediaType,
-				role: "primary",
-				...l.refId === void 0 ? {} : { storageRefId: l.refId }
-			}],
-			...X(c.usage, c.providerMetadata, r),
-			usage: Z(c.usage)
-		};
-	}).pipe(D.catch((e) => e instanceof w ? D.fail(e) : D.fail(new w({
-		capability: `media:${n.modality}`,
-		message: String(e.message ?? e)
-	}))));
-}, Hn = () => globalThis.crypto?.randomUUID?.() ?? `req-${Date.now().toString(36)}`, Un = (e) => e.request?.subject?.id ?? null, $ = (e, t) => D.promise(() => e.store.query(N(R).where(A("id", t)).descriptor)).pipe(D.map((e) => e[0])), Wn = (e) => D.sync(() => {
-	let t = e.workflows;
-	if (!t) throw Error("workflow runtime unavailable; no flow start was submitted");
-	return t;
-}), Gn = (t, n) => D.gen(function* () {
-	yield* Wn(t);
-	let r = yield* rn(t, n.flowRef), i = n.input ?? {}, a = r.brief.filter((e) => e.required && e.type !== "boolean" && (i[e.key] === void 0 || i[e.key] === null || i[e.key] === "")).map((e) => e.key);
-	if (a.length > 0) return yield* D.fail(new Se({
-		missing: a,
-		message: `missing required brief field(s): ${a.join(", ")}`
-	}));
-	let o = Hn(), s = `run-${o}`, c = n.source ?? "manual";
-	return yield* D.promise(() => t.transaction(async (t) => {
-		let a = t.workflows;
-		if (!a) throw Error("workflow runtime unavailable in transaction; no flow start was submitted");
-		await t.store.insert(R.tableName, {
-			id: s,
-			flowRef: n.flowRef,
-			flowName: r.name,
-			mode: r.mode,
-			status: "pending",
-			source: c,
-			requestId: o,
-			input: i,
-			ownerId: Un(t)
-		});
-		let l = await Tn(t, s, await a.start(e, {
-			runId: s,
-			flowRef: n.flowRef,
-			input: i,
-			source: c,
-			requestId: o
-		}));
-		return b.make({
-			runId: s,
-			requestId: o,
-			admission: l
-		});
-	}));
-}), Kn = (t, r) => D.gen(function* () {
-	return yield* Wn(t), yield* D.tryPromise({
-		try: () => t.transaction(async (t) => {
-			let i = t.workflows;
-			if (!i) throw Error("workflow runtime unavailable in transaction; no flow start was submitted");
-			let a = (await t.store.query(N(R).where(A("id", r.runId)).descriptor))[0];
-			if (!a) throw new T({
-				runId: r.runId,
-				message: "run not found"
-			});
-			let o = a.requestId;
-			if (typeof o != "string" || o.length === 0) throw Error("stored flow run has no valid requestId; retry refused without changing the run");
-			let s = k.decodeUnknownResult(n.payloadSchema.pipe(k.check(k.makeFilter((e) => e.runId === r.runId && e.flowRef.length > 0))))({
-				...a,
-				runId: a.id
-			});
-			if (O.isFailure(s)) throw Error("stored workflow payload is incomplete or invalid; retry refused without changing the run");
-			let c = await Tn(t, r.runId, await i.start(e, s.success));
-			return b.make({
-				runId: r.runId,
-				requestId: o,
-				admission: c
-			});
-		}),
-		catch: (e) => e
-	}).pipe(D.catch((e) => e instanceof T ? D.fail(e) : D.die(e)));
-}), qn = (t, r) => D.gen(function* () {
-	let i = yield* $(t, r.runId);
-	if (!i) return yield* D.fail(new T({
-		runId: r.runId,
-		message: "run not found"
-	}));
-	if (Jn(i.status)) return C.make({
-		runId: r.runId,
-		status: i.status,
-		engine: "not-requested",
-		control: null
-	});
-	let a = (/* @__PURE__ */ new Date()).toISOString();
-	yield* D.promise(() => t.store.updateMany(R.tableName, {
-		status: "cancelling",
-		cancelledAt: a
-	}, { where: Fe(A("id", r.runId), Re("status", [
-		"pending",
-		"running",
-		"waiting"
-	])) }));
-	let o = yield* $(t, r.runId);
-	if (!o) return yield* D.fail(new T({
-		runId: r.runId,
-		message: "run not found"
-	}));
-	if (Jn(o.status)) return C.make({
-		runId: r.runId,
-		status: o.status,
-		engine: "not-requested",
-		control: null
-	});
-	let s = t.workflows, c = k.decodeUnknownOption(k.Struct({
-		runId: k.Literal(r.runId),
-		flowRef: k.NonEmptyString,
-		requestId: k.NonEmptyString,
-		input: k.Record(k.String, k.Unknown),
-		source: k.Literals(["manual", "cron"])
-	}))({
-		...i,
-		runId: i.id
-	}), l = s === void 0 || c._tag === "None" ? null : yield* D.flatMap(n.executionId(c.value), (t) => D.tryPromise(async () => {
-		let n = k.decodeUnknownSync(je)(await s.cancel(e, t));
-		if (n.operation !== "cancel" || n.snapshot.workflowName !== "flow.run" || n.snapshot.executionId !== t) throw Error("workflow cancellation receipt does not match the flow execution");
-		return n;
-	})).pipe(D.catch(() => D.succeed(null))), u = l === null ? s === void 0 || c._tag === "None" ? "unreachable" : "unknown" : l.snapshot.status === "cancelled" && (l.kind === "confirmed" || l.kind === "already-terminal") ? "cancelled" : l.kind === "accepted" ? "accepted" : l.kind === "already-terminal" ? "already-terminal" : "unknown", d = Fe(A("id", r.runId), A("status", "cancelling"), A("cancelledAt", o.cancelledAt));
-	if (u === "cancelled") yield* D.promise(() => t.store.updateMany(R.tableName, {
-		status: "cancelled",
-		completedAt: o.completedAt ?? (/* @__PURE__ */ new Date()).toISOString()
-	}, { where: d }));
-	else if (l?.kind === "already-terminal") {
-		let e = k.decodeUnknownOption(n.successSchema)(l.snapshot.output), i = l.snapshot.status === "failed" ? "failed" : e._tag === "Some" && e.value.runId === r.runId && e.value.status !== "waiting" ? e.value.status : void 0;
-		i !== void 0 && (yield* D.promise(() => t.store.updateMany(R.tableName, {
-			status: i,
-			completedAt: o.completedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
-			...i === "cancelled" ? {} : { cancelledAt: null }
-		}, { where: d })));
-	}
-	let f = yield* $(t, r.runId);
-	return f ? yield* k.decodeUnknownEffect(C)({
-		runId: r.runId,
-		status: f.status,
-		engine: u,
-		control: l
-	}).pipe(D.orDie) : yield* D.fail(new T({
-		runId: r.runId,
-		message: "run not found"
-	}));
-}), Jn = (e) => e === "succeeded" || e === "failed" || e === "cancelled", Yn = (e) => {
-	let t = e.steps?.filter((e) => e.status === "waiting"), n = t?.[0];
-	if (t?.length !== 1 || n?.type !== "human" || !Number.isSafeInteger(n.id) || n.id < 0) throw Error("expected exactly one waiting human step with a nonnegative integer index");
-	return n.id;
-}, Xn = (t, i) => D.gen(function* () {
-	let a = (e, t) => new Ee({
-		runId: i.runId,
-		reason: e,
-		message: t
-	}), o = yield* k.decodeUnknownEffect(le, { onExcessProperty: "error" })(i).pipe(D.mapError(() => a("invalid-response", "review response requires runId, displayed stepIndex and a valid response")));
-	if (o.response.decision === void 0 && o.response.text === void 0 && o.response.value === void 0) return yield* D.fail(a("invalid-response", "review response must contain a decision, text or value"));
-	let s = t.workflows;
-	if (!s) return yield* D.fail(a("runtime-unavailable", "workflow runtime unavailable; review was not sent"));
-	let c = yield* $(t, i.runId);
-	if (!c) return yield* D.fail(new T({
-		runId: i.runId,
-		message: "run not found"
-	}));
-	let l = c.status;
-	if (l !== "waiting") return yield* D.fail(new we({
-		runId: i.runId,
-		status: l ?? "unknown",
-		message: `run is "${l}", not awaiting a response`
-	}));
-	let u = yield* D.try({
-		try: () => Yn(c),
-		catch: () => a("invalid-run", "stored run has no unambiguous waiting review")
-	});
-	if (u !== o.stepIndex) return yield* D.fail(new we({
-		runId: i.runId,
-		status: l,
-		message: "this review is no longer waiting; reload the run before answering"
-	}));
-	let d = yield* k.decodeUnknownEffect(k.Struct({
-		runId: k.Literal(i.runId),
-		flowRef: k.NonEmptyString,
-		requestId: k.NonEmptyString,
-		input: k.Record(k.String, k.Unknown),
-		source: k.Literals(["manual", "cron"])
-	}))({
-		...c,
-		runId: c.id
-	}).pipe(D.mapError(() => a("invalid-run", "stored workflow payload is incomplete; review was not sent"))), f = yield* n.executionId(d), p = {
-		...o.response,
-		respondedAt: (/* @__PURE__ */ new Date()).toISOString()
-	}, m = yield* D.tryPromise({
-		try: () => s.signal({
-			workflowName: e,
-			executionId: f
-		}, r(u), p),
-		catch: () => a("delivery-unknown", "review delivery was not confirmed; observe the run before retrying")
-	}), h = yield* k.decodeUnknownEffect(k.Struct({ eventId: k.NonEmptyString }))(m).pipe(D.mapError(() => a("delivery-unknown", "workflow runtime returned no valid review delivery receipt")));
-	return yield* k.decodeUnknownEffect(ge)({
-		runId: i.runId,
-		stepIndex: u,
-		executionId: f,
-		eventId: h.eventId,
-		status: "accepted"
-	}).pipe(D.mapError(() => a("delivery-unknown", "workflow runtime returned no valid review delivery receipt")));
-}), Zn = (e, t) => D.promise(() => e.store.query(N(L).where(A("id", t.id)).descriptor)).pipe(D.map((e) => e[0])), Qn = (e) => D.promise(() => e.store.query(N(L).descriptor)), $n = (e, t) => D.promise(() => e.store.insert(L.tableName, {
-	id: t.id ?? `flow-${Hn()}`,
-	...t
-})), er = (e, t) => D.promise(() => e.store.update(L.tableName, t.id, t.patch)), tr = (e, t) => D.promise(() => e.store.delete(L.tableName, t.id)), nr = "aiFlows", rr = (e = {}) => {
-	let t = Pe({
-		base: nr,
+import { clearRegistry as e, getRegisteredFlow as t, listRegisteredFlows as n, registerFlow as r } from "./registry.js";
+import { aiFlowRunsTable as i, aiFlowsTable as a, aiFlowsTables as o } from "./table.js";
+import { FLOW_RUN_WORKFLOW as s, HUMAN_RESPONSE_SIGNAL_PREFIX as c, humanResponseSignalName as l } from "./workflow.js";
+import { admittedStartHandle as u, reconcileFlowStarts as d } from "./startReconcile.js";
+import { FLOW_RUNS_TTL_ENV as f, FLOW_RUNS_TTL_HOURS_DEFAULT as p, HUMAN_REVIEW_TIMEOUT_ENV as m, HUMAN_REVIEW_TIMEOUT_HOURS_DEFAULT as h, MAX_CHAIN_DEPTH_DEFAULT as ee, MAX_CHAIN_DEPTH_ENV as te, getAiFlowsDefaults as ne, msFromHoursEnv as re, resetAiFlowsDefaults as ie, resolveHumanReviewTimeoutMs as g, resolveMaxChainDepth as _, setAiFlowsDefaults as v } from "./defaults.js";
+import { ConditionOp as y, StepCondition as b, describeCondition as x, evaluateCondition as S, isTruthy as C } from "./condition.js";
+import { BriefField as w, ChainPending as T, CostCompleteness as E, CostSource as D, FlowCadence as O, FlowCancelReceipt as k, FlowChain as A, FlowMode as j, FlowReviewInput as M, FlowReviewReceipt as N, FlowStartReceipt as P, FlowStatus as F, FlowStep as I, HumanResponse as L, Json as R, MAX_STEPS_DEFAULT as z, MAX_STEPS_MAX as B, MAX_STEPS_MIN as V, MediaArtifact as H, MediaArtifacts as U, MediaInputSlot as W, MediaInputs as G, MediaReceipt as K, Modality as q, ReviewMode as J, ReviewOption as Y, RunReview as ae, RunSource as oe, RunStatus as se, RunStep as ce, RunStepStatus as le, StepType as ue, StepUsage as de, Visibility as fe, clampMaxSteps as pe, normalizeFlow as me, sanitizeOutputKey as he } from "./ir.js";
+import { collectRefs as ge, interpolate as _e, unresolvedRefs as ve } from "./interpolate.js";
+import { flowSegments as ye, nonContiguousGroups as be } from "./segments.js";
+import { buildFlowRunExecute as xe, resolveIr as Se } from "./engine.js";
+import { defineFlow as Ce, flowStep as we, validateFlow as Te } from "./define.js";
+import { cadenceMatches as Ee, nextRuns as De } from "./cadence.js";
+import { cronRequestId as Oe, runCadenceTick as ke } from "./cadenceTick.js";
+import { makeMediaGenerator as Ae } from "./mediaAdapter.js";
+import { cancelFlow as je, createFlow as Me, deleteFlow as Ne, getFlow as Pe, launchFlow as Fe, listFlows as Ie, respondToFlow as Le, retryFlow as X, updateFlow as Re, waitingStepIndex as ze } from "./procedures.js";
+import { Effect as Z } from "effect";
+import { definePlugin as Be, pluginInstanceName as Ve } from "@voltro/protocol";
+import { eq as Q, inSet as He, notInSet as Ue, queryFor as We, registerRetention as Ge } from "@voltro/database";
+//#region src/index.ts
+var $ = "aiFlows", Ke = (e = {}) => {
+	let t = Ve({
+		base: $,
 		alias: e.alias
 	});
-	St(e.humanReviewTimeoutMs === void 0 ? {} : { humanReviewTimeoutMs: e.humanReviewTimeoutMs }), Be({
+	v(e.humanReviewTimeoutMs === void 0 ? {} : { humanReviewTimeoutMs: e.humanReviewTimeoutMs }), Ge({
 		source: "plugin",
-		table: R.tableName,
+		table: i.tableName,
 		timeColumn: "createdAt",
-		ttlMs: e.runsTtlMs ?? Tt(process.env.VOLTRO_AI_FLOW_RUNS_TTL_HOURS, 2160),
-		envVar: vt,
+		ttlMs: e.runsTtlMs ?? re(process.env.VOLTRO_AI_FLOW_RUNS_TTL_HOURS, 2160),
+		envVar: f,
 		label: "ai flow runs",
-		where: Re("status", [
+		where: He("status", [
 			"succeeded",
 			"failed",
 			"cancelled"
 		])
 	});
-	let n = Math.max(1, e.inspectPageMax ?? 200), r = { current: void 0 }, i = (e) => ({
+	let r = Math.max(1, e.inspectPageMax ?? 200), a = { current: void 0 }, s = (e) => ({
 		kind: "json",
 		data: e
-	}), a = (e, t) => ({
+	}), c = (e, t) => ({
 		kind: "json",
 		status: e,
 		data: { error: t }
-	}), o = (e, t, n) => D.promise(async () => {
-		let o = r.current;
-		if (!o) return a(503, "store not bound yet");
-		let s = await o.query({
+	}), l = (e, t, n) => Z.promise(async () => {
+		let r = a.current;
+		if (!r) return c(503, "store not bound yet");
+		let i = await r.query({
 			table: e,
-			predicate: n === void 0 ? void 0 : A("id", n),
+			predicate: n === void 0 ? void 0 : Q("id", n),
 			order: [{
 				column: "createdAt",
 				direction: "desc"
@@ -1767,30 +72,30 @@ var Ut = (e, t = {}) => {
 				"createdAt"
 			] : void 0
 		});
-		return i({
-			count: s.length,
-			rows: s,
+		return s({
+			count: i.length,
+			rows: i,
 			take: t
 		});
-	}).pipe(D.catchCause(() => D.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 = [{
+	}).pipe(Z.catchCause(() => Z.succeed(c(500, "query failed")))), d = (e, t) => {
+		let n = /[?&]take=(\d+)/.exec(e)?.[1], i = n === void 0 ? t : Number(n);
+		return Math.min(r, Math.max(1, Number.isFinite(i) ? i : t));
+	}, p = [{
 		method: "GET",
 		path: "/flows",
 		scope: "process",
 		description: "List flow definitions (`?take=` up to the configured max).",
-		handler: (e) => D.promise(async () => {
-			let t = r.current;
-			if (!t) return a(503, "store not bound yet");
-			let o = s(e.url, Math.min(200, n)), c = [...ct()].sort((e, t) => e.name < t.name ? -1 : +(e.name > t.name)), l = c.slice(0, o).map((e) => ({
+		handler: (e) => Z.promise(async () => {
+			let t = a.current;
+			if (!t) return c(503, "store not bound yet");
+			let i = d(e.url, Math.min(200, r)), o = [...n()].sort((e, t) => e.name < t.name ? -1 : +(e.name > t.name)), l = o.slice(0, i).map((e) => ({
 				id: e.name,
 				name: e.name,
 				mode: e.mode,
 				definitionSource: "code"
-			})), u = l.length === o ? [] : await t.query({
+			})), u = l.length === i ? [] : await t.query({
 				table: "_voltro_ai_flows",
-				predicate: c.length === 0 ? void 0 : ze("id", c.map((e) => e.name)),
+				predicate: o.length === 0 ? void 0 : Ue("id", o.map((e) => e.name)),
 				order: [{
 					column: "createdAt",
 					direction: "desc"
@@ -1798,62 +103,62 @@ var Ut = (e, t = {}) => {
 					column: "id",
 					direction: "desc"
 				}],
-				take: o - l.length,
+				take: i - l.length,
 				skip: void 0,
 				projection: void 0
-			}), d = [...l, ...u.map((e) => ({
+			}), f = [...l, ...u.map((e) => ({
 				...e,
 				definitionSource: "stored"
 			}))];
-			return i({
-				count: d.length,
-				rows: d,
-				take: o
+			return s({
+				count: f.length,
+				rows: f,
+				take: i
 			});
-		}).pipe(D.catchCause(() => D.succeed(a(500, "query failed"))))
+		}).pipe(Z.catchCause(() => Z.succeed(c(500, "query failed"))))
 	}, {
 		method: "GET",
 		path: "/runs",
 		scope: "process",
 		description: "List recent run summaries (`?take=` bounded); `?runId=` reads one run with payloads and steps.",
-		handler: (e) => o("_voltro_ai_flow_runs", s(e.url, Math.min(100, n)), new URL(e.url, "http://inspect.local").searchParams.get("runId") ?? void 0)
+		handler: (e) => l("_voltro_ai_flow_runs", d(e.url, Math.min(100, r)), new URL(e.url, "http://inspect.local").searchParams.get("runId") ?? void 0)
 	}];
-	return Ne({
+	return Be({
 		name: t,
-		baseName: nr,
+		baseName: $,
 		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",
 			"store:changes:read"
 		],
-		...e.tables === !1 ? {} : { extendSchema: { tables: ut } },
-		inspectEndpoints: c,
+		...e.tables === !1 ? {} : { extendSchema: { tables: o } },
+		inspectEndpoints: p,
 		bindDataStore: (e) => {
-			r.current = e;
+			a.current = e;
 		},
-		onChangeEvent: (e) => D.gen(function* () {
+		onChangeEvent: (e) => Z.gen(function* () {
 			if (e.table !== "_voltro_workflow_runs" || e.new === null || e.op !== "update" && e.op !== "insert") return;
 			let t = e.new;
 			if (t.tag !== "flow.run") return;
-			let n = r.current;
+			let n = a.current;
 			if (n === void 0) return;
-			let i = t.payload, a = (typeof i == "string" ? JSON.parse(i) : i)?.runId;
-			if (typeof a != "string") return;
-			let o = (yield* D.promise(() => n.query(N(R).where(A("id", a)).descriptor)))[0];
-			if (o === void 0) return;
-			let s = o.status, c = t.executionId, l = o.workflowStart;
-			s === "pending" && l?.status === "queued" && typeof c == "string" && c.length > 0 && (yield* D.promise(() => n.update(R.tableName, a, { workflowStart: ft(c) })));
-			let u = e.old?.status === "cancelled";
-			if (e.op !== "update" || t.status !== "cancelled" || u || s === "cancelled" || s === "succeeded" || s === "failed") return;
-			let d = (/* @__PURE__ */ new Date()).toISOString(), f = typeof o.cancelledAt == "string" ? o.cancelledAt : d;
-			yield* D.promise(() => n.update(R.tableName, a, {
+			let r = t.payload, o = (typeof r == "string" ? JSON.parse(r) : r)?.runId;
+			if (typeof o != "string") return;
+			let s = (yield* Z.promise(() => n.query(We(i).where(Q("id", o)).descriptor)))[0];
+			if (s === void 0) return;
+			let c = s.status, l = t.executionId, d = s.workflowStart;
+			c === "pending" && d?.status === "queued" && typeof l == "string" && l.length > 0 && (yield* Z.promise(() => n.update(i.tableName, o, { workflowStart: u(l) })));
+			let f = e.old?.status === "cancelled";
+			if (e.op !== "update" || t.status !== "cancelled" || f || c === "cancelled" || c === "succeeded" || c === "failed") return;
+			let p = (/* @__PURE__ */ new Date()).toISOString(), m = typeof s.cancelledAt == "string" ? s.cancelledAt : p;
+			yield* Z.promise(() => n.update(i.tableName, o, {
 				status: "cancelled",
-				cancelledAt: f,
-				completedAt: d
+				cancelledAt: m,
+				completedAt: p
 			}));
-		}).pipe(D.catchCause(() => D.void))
+		}).pipe(Z.catchCause(() => Z.void))
 	});
 };
 //#endregion
-export { he as BriefField, de as ChainPending, ee as ConditionOp, pe as CostCompleteness, S as CostSource, vt as FLOW_RUNS_TTL_ENV, _t as FLOW_RUNS_TTL_HOURS_DEFAULT, e as FLOW_RUN_WORKFLOW, re as FlowCadence, C as FlowCancelReceipt, me as FlowChain, ie as FlowMode, le as FlowReviewInput, ge as FlowReviewReceipt, b as FlowStartReceipt, x as FlowStatus, fe as FlowStep, t as HUMAN_RESPONSE_SIGNAL_PREFIX, gt as HUMAN_REVIEW_TIMEOUT_ENV, ht as HUMAN_REVIEW_TIMEOUT_HOURS_DEFAULT, ue as HumanResponse, oe as Json, yt as MAX_CHAIN_DEPTH_DEFAULT, bt as MAX_CHAIN_DEPTH_ENV, ae as MAX_STEPS_DEFAULT, ne as MAX_STEPS_MAX, _e as MAX_STEPS_MIN, be as MediaArtifact, y as MediaArtifacts, ye as MediaInputSlot, _ as MediaInputs, o as MediaReceipt, ve as Modality, te as ReviewMode, c as ReviewOption, s as RunReview, h as RunSource, ce as RunStatus, i as RunStep, se as RunStepStatus, xe as StepCondition, p as StepType, m as StepUsage, g as Visibility, ft as admittedStartHandle, R as aiFlowRunsTable, rr as aiFlowsPlugin, L as aiFlowsTable, ut as aiFlowsTables, bn as buildFlowRunExecute, ke as cadenceMatches, qn as cancelFlow, l as clampMaxSteps, lt as clearRegistry, At as collectRefs, $n as createFlow, En as cronRequestId, wn as defineFlow, tr as deleteFlow, a as describeCondition, v as evaluateCondition, Nt as flowSegments, xn as flowStep, Ct as getAiFlowsDefaults, Zn as getFlow, st as getRegisteredFlow, r as humanResponseSignalName, jt as interpolate, u as isTruthy, Gn as launchFlow, Qn as listFlows, ct as listRegisteredFlows, Vn as makeMediaGenerator, Oe as nextRuns, Pt as nonContiguousGroups, d as normalizeFlow, mt as reconcileFlowStarts, ot as registerFlow, wt as resetAiFlowsDefaults, Dt as resolveHumanReviewTimeoutMs, rn as resolveIr, Ot as resolveMaxChainDepth, Xn as respondToFlow, Kn as retryFlow, On as runCadenceTick, f as sanitizeOutputKey, St as setAiFlowsDefaults, Mt as unresolvedRefs, er as updateFlow, Cn as validateFlow, Yn as waitingStepIndex };
+export { w as BriefField, T as ChainPending, y as ConditionOp, E as CostCompleteness, D as CostSource, f as FLOW_RUNS_TTL_ENV, p as FLOW_RUNS_TTL_HOURS_DEFAULT, s as FLOW_RUN_WORKFLOW, O as FlowCadence, k as FlowCancelReceipt, A as FlowChain, j as FlowMode, M as FlowReviewInput, N as FlowReviewReceipt, P as FlowStartReceipt, F as FlowStatus, I as FlowStep, c as HUMAN_RESPONSE_SIGNAL_PREFIX, m as HUMAN_REVIEW_TIMEOUT_ENV, h as HUMAN_REVIEW_TIMEOUT_HOURS_DEFAULT, L as HumanResponse, R as Json, ee as MAX_CHAIN_DEPTH_DEFAULT, te as MAX_CHAIN_DEPTH_ENV, z as MAX_STEPS_DEFAULT, B as MAX_STEPS_MAX, V as MAX_STEPS_MIN, H as MediaArtifact, U as MediaArtifacts, W as MediaInputSlot, G as MediaInputs, K as MediaReceipt, q as Modality, J as ReviewMode, Y as ReviewOption, ae as RunReview, oe as RunSource, se as RunStatus, ce as RunStep, le as RunStepStatus, b as StepCondition, ue as StepType, de as StepUsage, fe as Visibility, u as admittedStartHandle, i as aiFlowRunsTable, Ke as aiFlowsPlugin, a as aiFlowsTable, o as aiFlowsTables, xe as buildFlowRunExecute, Ee as cadenceMatches, je as cancelFlow, pe as clampMaxSteps, e as clearRegistry, ge as collectRefs, Me as createFlow, Oe as cronRequestId, Ce as defineFlow, Ne as deleteFlow, x as describeCondition, S as evaluateCondition, ye as flowSegments, we as flowStep, ne as getAiFlowsDefaults, Pe as getFlow, t as getRegisteredFlow, l as humanResponseSignalName, _e as interpolate, C as isTruthy, Fe as launchFlow, Ie as listFlows, n as listRegisteredFlows, Ae as makeMediaGenerator, De as nextRuns, be as nonContiguousGroups, me as normalizeFlow, d as reconcileFlowStarts, r as registerFlow, ie as resetAiFlowsDefaults, g as resolveHumanReviewTimeoutMs, Se as resolveIr, _ as resolveMaxChainDepth, Le as respondToFlow, X as retryFlow, ke as runCadenceTick, he as sanitizeOutputKey, v as setAiFlowsDefaults, ve as unresolvedRefs, Re as updateFlow, Te as validateFlow, ze as waitingStepIndex };