@voltro/plugin-ai-flows 0.71.1 → 0.72.0

package/dist/index.js

@@ -1,19 +1,19 @@
-import { A as e, C as t, D as n, E as r, F as i, I as a, L as o, M as s, N as c, O as l, P as u, S as d, T as f, _ as p, a as m, b as ee, c as h, d as g, f as te, g as ne, h as re, i as ie, j as _, k as ae, l as oe, m as se, n as ce, o as le, p as ue, r as de, s as fe, t as pe, u as me, v as he, w as ge, x as _e, y as ve } from "./ir-B0rox9qW.js";
-import { FLOW_RUN_WORKFLOW as v, HUMAN_RESPONSE_SIGNAL_PREFIX as ye, flowRunWorkflow as y, humanResponseSignalName as b } from "./workflow.js";
-import { FlowBriefIncomplete as be, FlowCapabilityMissing as x, FlowDependencyError as xe, FlowNotAwaitingResponse as Se, FlowNotFound as Ce, FlowReviewDeliveryError as we, FlowRunNotFound as S, FlowValidationError as Te } from "./errors.js";
-import { n as Ee, t as De } from "./cadence-_9Izk_fL.js";
-import { Cause as Oe, Effect as C, Schema as w } from "effect";
-import { WorkflowRunHandleSchema as ke, definePlugin as Ae, pluginInstanceName as je } from "@voltro/protocol";
-import { boolean as Me, eq as T, id as Ne, inSet as Pe, integer as E, json as D, queryFor as O, registerRetention as Fe, table as Ie, text as k, timestamp as A } from "@voltro/database";
-import { tenant as Le } from "@voltro/plugin-multitenancy/mixin";
-import { audit as Re } from "@voltro/plugin-audit/mixin";
-import { softDelete as ze } from "@voltro/plugin-soft-delete/mixin";
-import { awaitSignalSuspending as Be, step as j } from "@voltro/workflow";
-import { defineTool as M, estimateCostUsd as Ve, gatewayCostUsd as He, generateImage as Ue, generateObject as We, generateObjectJson as Ge, generateObjectWithTools as Ke, generateSpeech as qe, generateText as Je, generateVideo as Ye } from "@voltro/ai";
-import { createHash as Xe } from "node:crypto";
+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, C as a, D as o, E as s, F as c, I as l, L as u, M as d, N as f, O as p, P as m, R as h, S as ee, T as g, _ as te, a as ne, b as re, c as ie, d as ae, f as oe, g as se, h as ce, i as _, j as le, k as ue, l as de, m as fe, n as pe, o as me, p as he, r as ge, s as _e, t as ve, u as v, v as ye, w as be, x as y, y as b, z as xe } from "./ir-BP8rOTuf.js";
+import { FlowBriefIncomplete as Se, FlowCapabilityMissing as x, FlowDependencyError as Ce, FlowNotAwaitingResponse as we, FlowNotFound as Te, FlowReviewDeliveryError as Ee, FlowRunNotFound as S, FlowValidationError as De } from "./errors.js";
+import { n as Oe, t as ke } from "./cadence-_9Izk_fL.js";
+import { Cause as Ae, Effect as C, Schema as w } from "effect";
+import { WorkflowRunHandleSchema as je, definePlugin as Me, pluginInstanceName as Ne } from "@voltro/protocol";
+import { boolean as Pe, eq as T, id as Fe, inSet as Ie, integer as E, json as D, queryFor as O, registerRetention as Le, table as Re, text as k, timestamp as A } from "@voltro/database";
+import { tenant as ze } from "@voltro/plugin-multitenancy/mixin";
+import { audit as Be } from "@voltro/plugin-audit/mixin";
+import { softDelete as Ve } from "@voltro/plugin-soft-delete/mixin";
+import { awaitSignalSuspending as He, step as j } from "@voltro/workflow";
+import { defineTool as Ue, estimateCostUsd as We, gatewayCostUsd as Ge, generateImage as Ke, generateObject as qe, generateObjectJson as Je, generateObjectWithTools as Ye, generateSpeech as Xe, generateText as Ze, generateVideo as Qe } from "@voltro/ai";
+import { createHash as $e } from "node:crypto";
 //#region src/table.ts
-var N = Ie("_voltro_ai_flows", {
-	id: Ne({ prefix: "aifl" }),
+var M = Re("_voltro_ai_flows", {
+	id: Fe({ prefix: "aifl" }),
 	name: k(),
 	description: k().nullable(),
 	mode: k().default("deterministic"),
@@ -27,15 +27,15 @@ var N = Ie("_voltro_ai_flows", {
 	chainTo: D().nullable(),
 	cadence: D().nullable(),
 	humanTimeoutMs: E().nullable(),
-	isEnabled: Me().default(!0),
+	isEnabled: Pe().default(!0),
 	metadata: D().nullable(),
 	icon: k().nullable(),
 	color: k().nullable(),
 	avatarUrl: k().nullable(),
 	usageCount: E().default(0),
 	ownerId: k().nullable()
-}).renamedFrom("ai_flows").with(Le(), Re(), ze()).index(["status"]).index(["visibility"]), P = Ie("_voltro_ai_flow_runs", {
-	id: Ne({ prefix: "aifr" }),
+}).renamedFrom("ai_flows").with(ze(), Be(), Ve()).index(["status"]).index(["visibility"]), N = Re("_voltro_ai_flow_runs", {
+	id: Fe({ prefix: "aifr" }),
 	flowRef: k(),
 	flowName: k().nullable(),
 	mode: k().default("deterministic"),
@@ -52,6 +52,7 @@ var N = Ie("_voltro_ai_flows", {
 	chainPending: D().nullable(),
 	chainRefusal: k().nullable(),
 	costMicroUsd: E().default(0),
+	costCompleteness: k().default("unknown"),
 	durationMs: E().nullable(),
 	error: k().nullable(),
 	errorMessage: k().nullable(),
@@ -62,28 +63,101 @@ var N = Ie("_voltro_ai_flows", {
 	sessionName: k().nullable(),
 	ownerId: k().nullable(),
 	metadata: D().nullable()
-}).renamedFrom("ai_flow_runs").with(Le(), Re()).index(["flowRef"]).index(["status"]).index(["requestId"]), Ze = [N, P], Qe = 168, $e = "VOLTRO_AI_FLOW_HUMAN_REVIEW_TIMEOUT_HOURS", et = 2160, tt = "VOLTRO_AI_FLOW_RUNS_TTL_HOURS", nt = 5, rt = "VOLTRO_AI_FLOW_MAX_CHAIN_DEPTH", F = { current: {} }, it = (e) => {
+}).renamedFrom("ai_flow_runs").with(ze(), Be()).index(["flowRef"]).index(["status"]).index(["requestId"]), et = [M, N], tt = w.Struct({
+	id: w.NonEmptyString,
+	workflowName: w.Literal(e),
+	status: w.Literal("queued")
+}), P = (t) => ({
+	id: t,
+	workflowName: e,
+	executionId: t,
+	status: "running"
+}), nt = (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})`;
+}, rt = 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: N.tableName,
+		predicate: T("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 = w.decodeUnknownOption(tt)(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(N.tableName, r, { workflowStart: P(t.executionId) }) === null) throw Error("flow run disappeared while recording its accepted start");
+					a.accepted++;
+					continue;
+				}
+				if (await e.store.update(N.tableName, r, {
+					status: "failed",
+					error: "FlowStartNotExecuted",
+					errorMessage: nt(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;
+}, it = 168, at = "VOLTRO_AI_FLOW_HUMAN_REVIEW_TIMEOUT_HOURS", ot = 2160, st = "VOLTRO_AI_FLOW_RUNS_TTL_HOURS", ct = 5, lt = "VOLTRO_AI_FLOW_MAX_CHAIN_DEPTH", F = { current: {} }, ut = (e) => {
 	F.current = e;
-}, I = () => F.current, at = () => {
+}, I = () => F.current, dt = () => {
 	F.current = {};
-}, ot = (e, t) => {
+}, ft = (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;
-}, st = (e) => Number.isFinite(e) && e > 0 ? e : Infinity, ct = (e) => {
+}, pt = (e) => Number.isFinite(e) && e > 0 ? e : Infinity, mt = (e) => {
 	let t = e.env ?? process.env;
-	return st(e.step?.timeoutMs ?? e.flow?.humanTimeoutMs ?? e.deps?.humanReviewTimeoutMs ?? I().humanReviewTimeoutMs ?? ot(t.VOLTRO_AI_FLOW_HUMAN_REVIEW_TIMEOUT_HOURS, 168));
-}, lt = (e) => {
-	let t = e?.env ?? process.env, n = Number(t[rt]), r = e?.maxChainDepth ?? I().maxChainDepth ?? (Number.isFinite(n) && n >= 1 ? n : 5);
+	return pt(e.step?.timeoutMs ?? e.flow?.humanTimeoutMs ?? e.deps?.humanReviewTimeoutMs ?? I().humanReviewTimeoutMs ?? ft(t.VOLTRO_AI_FLOW_HUMAN_REVIEW_TIMEOUT_HOURS, 168));
+}, ht = (e) => {
+	let t = e?.env ?? process.env, n = Number(t[lt]), r = e?.maxChainDepth ?? I().maxChainDepth ?? (Number.isFinite(n) && n >= 1 ? n : 5);
 	return Number.isFinite(r) && r >= 1 ? r : 5;
-}, ut = /\{\{\s*([\w.-]+)\s*\}\}/g, L = (e) => {
+}, gt = /\{\{\s*([\w.-]+)\s*\}\}/g, L = (e) => {
 	let t = [];
-	for (let n of e.matchAll(ut)) t.push(n[1]);
+	for (let n of e.matchAll(gt)) t.push(n[1]);
 	return t;
-}, R = (e, t) => e.replace(ut, (e, n) => {
+}, R = (e, t) => e.replace(gt, (e, n) => {
 	let r = t[n];
 	return r == null ? "" : typeof r == "string" ? r : JSON.stringify(r);
-}), dt = (e, t) => {
+}), _t = (e, t) => {
 	let n = /* @__PURE__ */ new Set();
 	for (let r of L(e)) t[r] == null && !n.has(r) && n.add(r);
 	return [...n];
@@ -116,13 +190,13 @@ var N = Ie("_voltro_ai_flows", {
 		});
 	}
 	return t;
-}, ft = (e) => {
+}, vt = (e) => {
 	let t = /* @__PURE__ */ new Map();
 	for (let n of e) n.group !== void 0 && t.set(n.group, (t.get(n.group) ?? 0) + 1);
 	return [...t.entries()].filter(([, e]) => e > 1).map(([e]) => e).sort();
-}, B = /* @__PURE__ */ new Map(), pt = (e) => {
+}, B = /* @__PURE__ */ new Map(), yt = (e) => {
 	B.set(e.name, e);
-}, mt = (e) => B.get(e), ht = () => [...B.values()], gt = () => B.clear(), V = w.suspend(() => w.Union(w.Null, w.Boolean, w.Finite, w.String, w.Array(V).pipe(w.mutable), w.Record({
+}, bt = (e) => B.get(e), xt = () => [...B.values()], St = () => B.clear(), V = w.suspend(() => w.Union(w.Null, w.Boolean, w.Finite, w.String, w.Array(V).pipe(w.mutable), w.Record({
 	key: w.String,
 	value: V
 }))), H = w.Record({
@@ -131,32 +205,68 @@ var N = Ie("_voltro_ai_flows", {
 		key: w.String,
 		value: V
 	})
-}), _t = w.Struct({
+}), Ct = w.Struct({
 	maxTokens: w.optionalWith(w.Int.pipe(w.positive(), w.lessThanOrEqualTo(2 ** 53 - 1)), { exact: !0 }),
 	temperature: w.optionalWith(w.Finite.pipe(w.nonNegative()), { exact: !0 }),
 	providerOptions: w.optionalWith(H, { exact: !0 })
-}), vt = (e) => C.try({
-	try: () => w.decodeUnknownSync(_t, { onExcessProperty: "error" })(e === void 0 ? {} : e),
-	catch: () => "invalid text params: expected maxTokens (positive safe integer), temperature (finite nonnegative number), and/or providerOptions (provider-keyed JSON object); other fields are not supported"
-}), yt = w.String.pipe(w.filter((e) => {
+}), wt = [
+	"maxTokens",
+	"temperature",
+	"providerOptions"
+], Tt = (e) => {
+	if (typeof e != "object" || !e || Array.isArray(e)) return "params must be an object";
+	let t = Object.keys(e), n = t.filter((e) => !wt.includes(e)).sort(), r = t.filter((t) => wt.includes(t) && w.decodeUnknownOption(Ct)({ [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("; ");
+}, Et = (e) => C.try({
+	try: () => w.decodeUnknownSync(Ct, { onExcessProperty: "error" })(e === void 0 ? {} : e),
+	catch: () => `invalid text params (${Tt(e)}): expected maxTokens (positive safe integer), temperature (finite nonnegative number), and/or providerOptions (provider-keyed JSON object); other fields are not supported`
+}), U = w.String.pipe(w.filter((e) => {
 	try {
 		let t = new URL(e);
 		return (t.protocol === "https:" || t.protocol === "http:") && t.username === "" && t.password === "";
 	} catch {
 		return !1;
 	}
-})), U = w.Record({
+})), W = w.Record({
 	key: w.String,
-	value: yt
-}), bt = (e, t, n = {}) => C.try({
+	value: U
+}), Dt = (e, t, n = {}) => C.try({
 	try: () => {
-		let r = w.decodeUnknownSync(ve, { 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 w.decodeUnknownSync(U)(i);
+		let r = w.decodeUnknownSync(y, { 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 w.decodeUnknownSync(W)(i);
 	},
 	catch: () => "invalid or unresolved media input: each slot must resolve to an absolute HTTP(S) URL without embedded credentials"
-}), xt = (e, t) => C.try({
+}), Ot = w.Struct({
+	url: U,
+	mediaType: w.NonEmptyString
+});
+w.Record({
+	key: w.String,
+	value: Ot
+});
+var kt = (e, t = {}) => {
+	let n = w.decodeUnknownOption(y)(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 && w.is(U)(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 && w.is(U)(n.url) && (r[e] = {
+			url: n.url,
+			mediaType: n.mediaType
+		});
+	}
+	return r;
+}, At = (e, t) => C.try({
 	try: () => {
-		let n = w.decodeUnknownSync(U)(t === void 0 ? {} : t), r = e === "image" ? ["referenceImageUrl", "maskImageUrl"] : e === "video" ? [
+		let n = w.decodeUnknownSync(W)(t === void 0 ? {} : t), r = e === "image" ? ["referenceImageUrl", "maskImageUrl"] : e === "video" ? [
 			"referenceImageUrl",
 			"firstFrameImageUrl",
 			"lastFrameImageUrl",
@@ -167,53 +277,72 @@ var N = Ie("_voltro_ai_flows", {
 		return n;
 	},
 	catch: () => `invalid or unsupported media input for ${e}; check the built-in adapter's slot contract`
-}), St = w.Struct({
-	artifacts: p,
+}), jt = w.Struct({
+	artifacts: b,
 	costMicroUsd: w.optional(w.Finite.pipe(w.nonNegative())),
+	costSource: w.optional(_),
 	requestId: w.optional(w.NonEmptyString)
-}), Ct = (e) => C.try({
-	try: () => w.decodeUnknownSync(St, { onExcessProperty: "error" })(e),
+}), Mt = (e) => C.try({
+	try: () => w.decodeUnknownSync(jt, { onExcessProperty: "error" })(e),
 	catch: () => "invalid media result: expected artifacts with URL, mediaType and role, exactly one primary artifact, and optional storage references"
-}), W = (e) => e, wt = w.Struct({
+}), G = (e) => e, Nt = (e) => e._tag === "FlowAgentUnavailable" ? e.publicMessage ?? "agent unavailable" : "agent not found", Pt = w.Struct({
 	value: w.optional(w.Unknown),
 	text: w.optional(w.String),
 	url: w.optional(w.String),
-	artifacts: w.optional(p),
+	artifacts: w.optional(b),
 	costMicroUsd: w.optional(w.Number),
+	costSource: w.optional(_),
 	requestId: w.optional(w.String),
 	error: w.optional(w.String)
-}), Tt = (e) => Ct(e).pipe(C.map((e) => {
+}), Ft = (e) => Mt(e).pipe(C.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.costMicroUsd === void 0 ? {} : { costMicroUsd: e.costMicroUsd },
+		...e.costSource === void 0 ? {} : { costSource: e.costSource }
 	};
-}), C.catchAll((e) => C.succeed({ error: e }))), G = () => (/* @__PURE__ */ new Date()).toISOString(), Et = (e) => Math.round(e * 1e6), Dt = (e) => ({
+}), C.catchAll((e) => C.succeed({ error: e }))), K = () => (/* @__PURE__ */ new Date()).toISOString(), It = (e) => Math.round(e * 1e6), Lt = (e) => ({
 	name: "gateway",
 	model: e
-}), K = (e, t) => e.resolveModel?.(t) ?? Dt(t), Ot = (e, t, n, r) => C.gen(function* () {
+}), q = (e, t) => e.resolveModel?.(t) ?? Lt(t), Rt = (e, t, n, r) => C.gen(function* () {
 	return t.maxSteps !== void 0 && (!Number.isSafeInteger(t.maxSteps) || t.maxSteps < 1) ? yield* C.fail(new x({
 		capability: "resolveAgent",
 		message: "agent maxSteps must be a positive safe integer"
-	})) : yield* Je({
+	})) : yield* Ze({
 		...r,
 		system: t.system,
 		prompt: n,
-		provider: K(e, t.model),
+		provider: q(e, t.model),
 		...t.tools === void 0 ? {} : { tools: t.tools },
 		...t.maxSteps === void 0 ? {} : { maxSteps: t.maxSteps }
 	});
-}), q = (e, t, n) => {
-	let r = He(t);
-	return typeof r == "number" ? Et(r) : Ve(e, { model: n ?? "unknown" }).costMicroUsd ?? 0;
-}, J = (e, t, n) => C.promise(() => e.store.update(P.tableName, t, n).then(() => void 0)).pipe(C.catchAllCause(() => C.void)), kt = (e, t) => C.promise(async () => (await e.store.query(O(P).where(T("id", t)).descriptor))[0]?.status === "cancelled").pipe(C.catchAllCause(() => C.succeed(!1))), Y = (e, t) => C.gen(function* () {
-	let n = mt(t);
+}), J = (e, t, n) => Y(e, t, n).costMicroUsd, Y = (e, t, n) => {
+	let r = Ge(t);
+	if (typeof r == "number") return {
+		costMicroUsd: It(r),
+		costSource: "gateway"
+	};
+	let i = We(e, { model: n ?? "unknown" });
+	return {
+		costMicroUsd: i.costMicroUsd ?? 0,
+		costSource: i.costSource ?? "unpriced"
+	};
+}, X = (e) => {
+	let t = e.filter((e) => e.status === "succeeded" && (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";
+}, Z = (e, t, n) => C.promise(() => e.store.update(N.tableName, t, n).then(() => void 0)).pipe(C.catchAllCause(() => C.void)), zt = (e, t, n, r) => C.promise(async () => {
+	let i = await e.store.query(O(N).where(T("id", t)).descriptor), a = i[0]?.[r];
+	i[0] !== void 0 && a == null && await e.store.update(N.tableName, t, n);
+}).pipe(C.catchAllCause(() => C.void)), Bt = (e, t) => C.promise(async () => (await e.store.query(O(N).where(T("id", t)).descriptor))[0]?.status === "cancelled").pipe(C.catchAllCause(() => C.succeed(!1))), Q = (e, t) => C.gen(function* () {
+	let n = bt(t);
 	if (n) return n;
-	let r = (yield* C.promise(() => e.store.query(O(N).where(T("id", t)).descriptor)))[0];
-	return r ? _({
+	let r = (yield* C.promise(() => e.store.query(O(M).where(T("id", t)).descriptor)))[0];
+	return r ? f({
 		name: r.name ?? t,
 		mode: r.mode,
 		steps: r.steps ?? [],
@@ -224,16 +353,16 @@ var N = Ie("_voltro_ai_flows", {
 		chain: r.chainTo ?? null,
 		cadence: r.cadence ?? null,
 		humanTimeoutMs: r.humanTimeoutMs ?? null
-	}) : yield* C.fail(new Ce({
+	}) : yield* C.fail(new Te({
 		flowRef: t,
 		message: `no flow registered or stored for "${t}"`
 	}));
-}), At = (e, t, n, r, i, a) => C.gen(function* () {
-	let e = R(n.prompt ?? "", r), o = yield* vt(n.type === "agent" || n.type === "structured" || n.type === "generate" && (n.modality ?? "text") === "text" ? n.params : void 0).pipe(C.either);
+}), Vt = (e, t, n, r, i, a) => C.gen(function* () {
+	let e = R(n.prompt ?? "", r), o = yield* Et(n.type === "agent" || n.type === "structured" || n.type === "generate" && (n.modality ?? "text") === "text" ? n.params : void 0).pipe(C.either);
 	if (o._tag === "Left") return { error: `step "${n.id}": ${o.left}` };
 	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 = dt(n.prompt ?? "", r);
-	if (s.length > 0) return { error: new xe({
+	let s = _t(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]}}}`
@@ -242,7 +371,8 @@ var N = Ie("_voltro_ai_flows", {
 		case "note": return {
 			value: e,
 			text: e,
-			costMicroUsd: 0
+			costMicroUsd: 0,
+			costSource: "gateway"
 		};
 		case "agent": {
 			if (!n.agentRef) return { error: "agent step missing agentRef" };
@@ -250,7 +380,7 @@ var N = Ie("_voltro_ai_flows", {
 				capability: "resolveAgent",
 				message: "no agent resolver configured"
 			}).message };
-			let r = yield* W(t.resolveAgent(n.agentRef, i)).pipe(C.map((e) => ({
+			let r = yield* G(t.resolveAgent(n.agentRef, i)).pipe(C.map((e) => ({
 				ok: !0,
 				a: e
 			})), C.catchAll((e) => C.succeed({
@@ -258,7 +388,7 @@ var N = Ie("_voltro_ai_flows", {
 				e
 			})));
 			if (!r.ok) return { error: r.e.message };
-			let a = yield* Ot(t, r.a, e, o.right).pipe(C.map((e) => ({
+			let a = yield* Rt(t, r.a, e, o.right).pipe(C.map((e) => ({
 				ok: !0,
 				r: e
 			})), C.catchAll((e) => C.succeed({
@@ -268,16 +398,16 @@ var N = Ie("_voltro_ai_flows", {
 			return a.ok ? {
 				value: a.r.text,
 				text: a.r.text,
-				costMicroUsd: q(a.r.usage, a.r.providerMetadata, r.a.model)
+				...Y(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* Ge({
+			let r = n.model ?? t.defaultModels?.text, i = yield* Je({
 				...o.right,
 				prompt: e,
 				jsonSchema: n.schema,
-				...r ? { provider: K(t, r) } : {}
+				...r ? { provider: q(t, r) } : {}
 			}).pipe(C.map((e) => ({
 				ok: !0,
 				r: e
@@ -288,16 +418,16 @@ var N = Ie("_voltro_ai_flows", {
 			return i.ok ? {
 				value: i.r.object,
 				text: JSON.stringify(i.r.object, null, 2),
-				costMicroUsd: q(i.r.usage, i.r.providerMetadata, r)
+				...Y(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* Je({
+				let r = n.model ?? t.defaultModels?.text, i = yield* Ze({
 					...o.right,
 					prompt: e,
-					...r ? { provider: K(t, r) } : {}
+					...r ? { provider: q(t, r) } : {}
 				}).pipe(C.map((e) => ({
 					ok: !0,
 					r: e
@@ -308,21 +438,22 @@ var N = Ie("_voltro_ai_flows", {
 				return i.ok ? {
 					value: i.r.text,
 					text: i.r.text,
-					costMicroUsd: q(i.r.usage, i.r.providerMetadata, r)
+					...Y(i.r.usage, i.r.providerMetadata, r)
 				} : { error: String(i.e.message ?? i.e) };
 			}
 			if (!t.generateMedia) return { error: new x({
 				capability: `media:${s}`,
 				message: `no media generator configured for ${s}`
 			}).message };
-			let c = yield* bt(n.mediaInputs, r, a).pipe(C.either);
+			let c = yield* Dt(n.mediaInputs, r, a).pipe(C.either);
 			if (c._tag === "Left") return { error: `step "${n.id}": ${c.left}` };
-			let l = n.model ?? t.defaultModels?.[s], u = yield* W(t.generateMedia({
+			let l = kt(n.mediaInputs, a), u = n.model ?? t.defaultModels?.[s], d = yield* G(t.generateMedia({
 				modality: s,
-				...l ? { model: l } : {},
+				...u ? { model: u } : {},
 				prompt: e,
 				...n.params ? { params: n.params } : {},
 				...n.mediaInputs === void 0 ? {} : { inputs: c.right },
+				...Object.keys(l).length > 0 ? { inputRefs: l } : {},
 				run: i
 			})).pipe(C.map((e) => ({
 				ok: !0,
@@ -331,7 +462,7 @@ var N = Ie("_voltro_ai_flows", {
 				ok: !1,
 				e
 			})));
-			return u.ok ? yield* Tt(u.m) : { error: u.e.message };
+			return d.ok ? yield* Ft(d.m) : { error: d.e.message };
 		}
 		case "human": return { error: new x({
 			capability: "human",
@@ -339,270 +470,279 @@ var N = Ie("_voltro_ai_flows", {
 		}).message };
 		default: return { error: `unknown step type: ${String(n.type)}` };
 	}
-}), jt = (e, t, n, r, o, s) => C.gen(function* () {
-	let c = Object.assign(Object.create(null), o), l = Object.create(null), u = r.steps.map((e, t) => ({
+}), Ht = (e, t, n, i, a, o) => C.gen(function* () {
+	let s = Object.assign(Object.create(null), a), c = Object.create(null), l = 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* J(e, n, {
+	yield* zt(e, n, {
 		status: "running",
-		steps: u,
-		totalSteps: r.steps.length,
+		steps: l,
+		totalSteps: i.steps.length,
 		currentStep: 0,
-		startedAt: G()
-	});
-	for (let o of z(r.steps)) {
-		if (yield* kt(e, n)) return {
+		startedAt: K()
+	}, "startedAt");
+	for (let a of z(i.steps)) {
+		if (yield* Bt(e, n)) return {
 			runId: n,
 			status: "cancelled"
 		};
-		if (o.steps.length > 1) {
+		if (a.steps.length > 1) {
 			let r = [];
-			for (let { index: e, step: t } of o.steps) {
-				if (t.when !== void 0 && !a(t.when, c)) {
-					u[e] = {
-						...u[e],
+			for (let { index: e, step: t } of a.steps) {
+				if (t.when !== void 0 && !h(t.when, s)) {
+					l[e] = {
+						...l[e],
 						status: "skipped",
-						completedAt: G(),
-						skipReason: i(t.when)
+						completedAt: K(),
+						skipReason: u(t.when)
 					};
 					continue;
 				}
 				r.push({
 					index: e,
 					step: t
-				}), u[e] = {
-					...u[e],
+				}), l[e] = {
+					...l[e],
 					status: "running",
-					startedAt: G()
+					startedAt: K()
 				};
 			}
-			yield* J(e, n, {
-				steps: u,
-				currentStep: o.steps[0].index
+			yield* Z(e, n, {
+				steps: l,
+				currentStep: a.steps[0].index
 			});
-			let f = yield* C.all(r.map(({ index: r, step: i }) => j({
+			let i = yield* C.all(r.map(({ index: r, step: i }) => j({
 				name: `flow-${r}-${i.id}`,
 				input: { index: r },
-				success: wt,
-				execute: At(e, t, i, c, {
+				success: Pt,
+				execute: Vt(e, t, i, s, {
 					runId: n,
-					tenantId: s.tenantId
-				}, l)
+					tenantId: o.tenantId,
+					ownerId: o.ownerId
+				}, c)
 			}).pipe(C.map((e) => ({
 				index: r,
 				step: i,
 				result: e
-			})))), { concurrency: "unbounded" }), p = f.find((e) => e.result.error);
-			for (let { index: e, step: t, result: n } of f) {
+			})))), { concurrency: "unbounded" }), f = i.find((e) => e.result.error);
+			for (let { index: e, step: t, result: n } of i) {
 				if (n.error) {
-					u[e] = {
-						...u[e],
+					l[e] = {
+						...l[e],
 						status: "failed",
-						completedAt: G(),
+						completedAt: K(),
 						errorMessage: n.error
 					};
 					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],
+				t.outputKey && n.value !== void 0 && (s[t.outputKey] = n.value), t.outputKey && n.artifacts !== void 0 && (c[t.outputKey] = n.artifacts), d += n.costMicroUsd ?? 0, l[e] = {
+					...l[e],
 					status: "succeeded",
-					completedAt: G(),
+					completedAt: K(),
 					...n.text ? { output: { text: n.text } } : {},
 					...n.url ? { url: n.url } : {},
 					...n.artifacts === void 0 ? {} : { artifacts: n.artifacts },
 					...n.requestId ? { requestId: n.requestId } : {},
-					...n.costMicroUsd ? { costMicroUsd: n.costMicroUsd } : {}
+					...n.costMicroUsd ? { costMicroUsd: n.costMicroUsd } : {},
+					...n.costSource === void 0 ? {} : { costSource: n.costSource }
 				};
 			}
-			if (p !== void 0) return yield* J(e, n, {
-				steps: u,
+			if (f !== void 0) return yield* Z(e, n, {
+				steps: l,
 				status: "failed",
-				errorMessage: p.result.error,
-				completedAt: G(),
-				costMicroUsd: d
+				errorMessage: f.result.error,
+				completedAt: K(),
+				costMicroUsd: d,
+				costCompleteness: X(l)
 			}), {
 				runId: n,
 				status: "failed"
 			};
-			yield* J(e, n, {
-				steps: u,
-				currentStep: o.steps[o.steps.length - 1].index + 1,
-				costMicroUsd: d
+			yield* Z(e, n, {
+				steps: l,
+				currentStep: a.steps[a.steps.length - 1].index + 1,
+				costMicroUsd: d,
+				costCompleteness: X(l)
 			});
 			continue;
 		}
-		let { index: f, step: p } = o.steps[0];
-		if (p.when !== void 0 && !a(p.when, c)) {
-			u[f] = {
-				...u[f],
+		let { index: f, step: p } = a.steps[0];
+		if (p.when !== void 0 && !h(p.when, s)) {
+			l[f] = {
+				...l[f],
 				status: "skipped",
-				completedAt: G(),
-				skipReason: i(p.when)
-			}, yield* J(e, n, {
-				steps: u,
+				completedAt: K(),
+				skipReason: u(p.when)
+			}, yield* Z(e, n, {
+				steps: l,
 				currentStep: f + 1
 			});
 			continue;
 		}
 		if (p.type === "human") {
-			let i = {
+			let a = {
 				mode: p.reviewMode ?? "approve",
 				...p.options ? { options: p.options } : {},
-				prompt: R(p.prompt ?? "", c)
+				prompt: R(p.prompt ?? "", s)
 			};
-			u[f] = {
-				...u[f],
+			l[f] = {
+				...l[f],
 				status: "waiting",
-				startedAt: G(),
-				review: i
-			}, yield* J(e, n, {
-				steps: u,
+				startedAt: K(),
+				review: a
+			}, yield* Z(e, n, {
+				steps: l,
 				status: "waiting",
 				currentStep: f
-			}), t.onEvent && (yield* W(t.onEvent({
+			}), t.onEvent && (yield* G(t.onEvent({
 				kind: "review-needed",
 				runId: n,
-				flowName: r.name,
-				ownerId: s.ownerId,
-				source: s.source
+				flowName: i.name,
+				ownerId: o.ownerId,
+				source: o.source
 			})).pipe(C.catchAllCause(() => C.void)));
-			let a = ct({
+			let c = mt({
 				step: p,
-				flow: r,
+				flow: i,
 				deps: t
-			}), o = yield* Be(e, {
-				name: b(f),
-				schema: g,
-				timeoutMs: a
+			}), u = yield* He(e, {
+				name: r(f),
+				schema: he,
+				timeoutMs: c
 			}).pipe(C.map((e) => ({
 				ok: !0,
 				a: e
-			})), C.catchAllCause((e) => Oe.isInterruptedOnly(e) ? C.failCause(e) : C.succeed({
+			})), C.catchAllCause((e) => Ae.isInterruptedOnly(e) ? C.failCause(e) : C.succeed({
 				ok: !1,
 				cause: e
 			})));
-			if (!o.ok) {
-				let t = Number.isFinite(a) ? `human review timed out after ${a}ms` : "human review failed";
-				return u[f] = {
-					...u[f],
+			if (!u.ok) {
+				let t = Number.isFinite(c) ? `human review timed out after ${c}ms` : "human review failed";
+				return l[f] = {
+					...l[f],
 					status: "failed",
-					completedAt: G(),
+					completedAt: K(),
 					errorMessage: t
-				}, yield* J(e, n, {
-					steps: u,
+				}, yield* Z(e, n, {
+					steps: l,
 					status: "failed",
 					errorMessage: t,
-					completedAt: G(),
-					costMicroUsd: d
+					completedAt: K(),
+					costMicroUsd: d,
+					costCompleteness: X(l)
 				}), {
 					runId: n,
 					status: "failed"
 				};
 			}
-			let l = o.a;
-			if (l.decision === "reject") return u[f] = {
-				...u[f],
+			let m = u.a;
+			if (m.decision === "reject") return l[f] = {
+				...l[f],
 				status: "failed",
-				completedAt: G(),
+				completedAt: K(),
 				errorMessage: "rejected by reviewer"
-			}, yield* J(e, n, {
-				steps: u,
+			}, yield* Z(e, n, {
+				steps: l,
 				status: "cancelled",
-				humanResponse: l,
-				completedAt: G(),
-				costMicroUsd: d
+				humanResponse: m,
+				completedAt: K(),
+				costMicroUsd: d,
+				costCompleteness: X(l)
 			}), {
 				runId: n,
 				status: "cancelled"
 			};
-			p.outputKey && (c[p.outputKey] = l.value ?? l.text ?? l.decision ?? !0), u[f] = {
-				...u[f],
+			p.outputKey && (s[p.outputKey] = m.value ?? m.text ?? m.decision ?? !0), l[f] = {
+				...l[f],
 				status: "succeeded",
-				completedAt: G(),
-				output: { text: String(l.text ?? l.value ?? l.decision ?? "approved") }
-			}, yield* J(e, n, {
-				steps: u,
+				completedAt: K(),
+				output: { text: String(m.text ?? m.value ?? m.decision ?? "approved") }
+			}, yield* Z(e, n, {
+				steps: l,
 				status: "running",
-				humanResponse: l,
+				humanResponse: m,
 				currentStep: f + 1
 			});
 			continue;
 		}
-		u[f] = {
-			...u[f],
+		l[f] = {
+			...l[f],
 			status: "running",
-			startedAt: G()
-		}, yield* J(e, n, {
-			steps: u,
+			startedAt: K()
+		}, yield* Z(e, n, {
+			steps: l,
 			currentStep: f
 		});
 		let m = yield* j({
 			name: `flow-${f}-${p.id}`,
 			input: { index: f },
-			success: wt,
-			execute: At(e, t, p, c, {
+			success: Pt,
+			execute: Vt(e, t, p, s, {
 				runId: n,
-				tenantId: s.tenantId
-			}, l)
+				tenantId: o.tenantId,
+				ownerId: o.ownerId
+			}, c)
 		});
-		if (m.error) return u[f] = {
-			...u[f],
+		if (m.error) return l[f] = {
+			...l[f],
 			status: "failed",
-			completedAt: G(),
+			completedAt: K(),
 			errorMessage: m.error
-		}, yield* J(e, n, {
-			steps: u,
+		}, yield* Z(e, n, {
+			steps: l,
 			status: "failed",
 			errorMessage: m.error,
-			completedAt: G(),
+			completedAt: K(),
 			costMicroUsd: d
 		}), {
 			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],
+		p.outputKey && m.value !== void 0 && (s[p.outputKey] = m.value), p.outputKey && m.artifacts !== void 0 && (c[p.outputKey] = m.artifacts), d += m.costMicroUsd ?? 0, l[f] = {
+			...l[f],
 			status: "succeeded",
-			completedAt: G(),
+			completedAt: K(),
 			...m.text ? { output: { text: m.text } } : {},
 			...m.url ? { url: m.url } : {},
 			...m.artifacts === void 0 ? {} : { artifacts: m.artifacts },
 			...m.requestId ? { requestId: m.requestId } : {},
-			...m.costMicroUsd ? { costMicroUsd: m.costMicroUsd } : {}
-		}, yield* J(e, n, {
-			steps: u,
+			...m.costMicroUsd ? { costMicroUsd: m.costMicroUsd } : {},
+			...m.costSource === void 0 ? {} : { costSource: m.costSource }
+		}, yield* Z(e, n, {
+			steps: l,
 			currentStep: f + 1,
-			costMicroUsd: d
+			costMicroUsd: d,
+			costCompleteness: X(l)
 		});
 	}
 	let f = Object.create(null);
-	for (let e of r.steps) e.outputKey && c[e.outputKey] !== void 0 && (f[e.outputKey] = c[e.outputKey]);
-	return yield* J(e, n, {
+	for (let e of i.steps) e.outputKey && s[e.outputKey] !== void 0 && (f[e.outputKey] = s[e.outputKey]);
+	return yield* Z(e, n, {
 		status: "succeeded",
 		output: f,
-		completedAt: G(),
+		completedAt: K(),
 		costMicroUsd: d
 	}), {
 		runId: n,
 		status: "succeeded",
 		output: f
 	};
-}), Mt = (e, t, n, r, i, a, o) => C.gen(function* () {
+}), Ut = (e, t, n, r, i, a, o) => C.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* J(e, t, { chainRefusal: `chain to "${s.flowRef}" refused — it is already in this run's chain (${c.join(" → ")}), which would loop` });
+		yield* Z(e, t, { chainRefusal: `chain to "${s.flowRef}" refused — it is already in this run's chain (${c.join(" → ")}), which would loop` });
 		return;
 	}
-	let l = lt(o);
+	let l = ht(o);
 	if (c.length >= l) {
-		yield* J(e, t, { chainRefusal: `chain to "${s.flowRef}" refused — depth ${c.length} reached the limit of ${l} (${c.join(" → ")})` });
+		yield* Z(e, t, { chainRefusal: `chain to "${s.flowRef}" refused — depth ${c.length} reached the limit of ${l} (${c.join(" → ")})` });
 		return;
 	}
 	let u = {
@@ -611,7 +751,7 @@ var N = Ie("_voltro_ai_flows", {
 	}, d = {};
 	for (let e of s.mappings) e.sourceKey in u && (d[e.targetKey] = u[e.sourceKey]);
 	if (s.requireConfirmation) {
-		yield* J(e, t, { chainPending: {
+		yield* Z(e, t, { chainPending: {
 			flowRef: s.flowRef,
 			input: d,
 			status: "pending"
@@ -623,7 +763,7 @@ var N = Ie("_voltro_ai_flows", {
 	let p = `${t}--chain`, m = `${a.requestId}--chain`;
 	yield* C.promise(async () => {
 		try {
-			await e.store.insert(P.tableName, {
+			await e.store.insert(N.tableName, {
 				id: p,
 				flowRef: s.flowRef,
 				flowName: s.flowRef,
@@ -642,53 +782,54 @@ var N = Ie("_voltro_ai_flows", {
 			chainPath: c
 		});
 	}).pipe(C.catchAllCause(() => C.void));
-}), Nt = (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"), Pt = (e) => {
+}), Wt = (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"), Gt = (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");
-}, Ft = (e) => [
+}, Kt = (e) => [
 	e.orchestrator?.instructions ?? "You are an orchestrator that uses the available tools to produce a bundled result.",
-	Nt(e),
+	Wt(e),
 	"When finished, emit a JSON object mapping each deliverable name (outputKey) to its value."
-].filter(Boolean).join("\n\n"), It = w.Struct({
+].filter(Boolean).join("\n\n"), qt = w.Struct({
 	object: w.Record({
 		key: w.String,
 		value: w.Unknown
 	}),
 	planCostMicroUsd: w.Number,
+	planCostSource: w.optional(_),
 	toolCostMicroUsd: w.Number,
-	steps: w.Array(r),
+	steps: w.Array(p),
 	error: w.optional(w.String)
-}), Lt = (e, t, n, r, i, a, o, s) => C.gen(function* () {
-	yield* J(e, n, {
+}), Jt = (e, t, n, r, i, a, o, s) => C.gen(function* () {
+	yield* zt(e, n, {
 		status: "running",
-		startedAt: G(),
+		startedAt: K(),
 		totalSteps: r.steps.length
-	});
+	}, "startedAt");
 	let c = yield* j({
 		name: "flow-agentic",
 		input: { flowRef: r.name },
-		success: It,
+		success: qt,
 		execute: C.gen(function* () {
 			let c = [], l = 0, u = (e) => {
 				let t = c.length;
 				return c.push({
 					id: t,
 					status: "running",
-					startedAt: G(),
+					startedAt: K(),
 					...e
 				}), t;
 			}, d = (e, t) => {
 				c[e] = {
 					...c[e],
-					completedAt: G(),
+					completedAt: K(),
 					...t
 				};
-			}, f = () => J(e, n, {
+			}, f = () => Z(e, n, {
 				steps: c,
 				currentStep: c.length,
 				costMicroUsd: l
 			}), p = {
-				run_agent: M({
+				run_agent: Ue({
 					name: "run_agent",
 					description: "Delegate a text task to an allowed sub-agent. Returns the agent's text.",
 					input: w.Struct({
@@ -704,9 +845,10 @@ var N = Ie("_voltro_ai_flows", {
 							status: "failed",
 							errorMessage: "no agent resolver configured"
 						}), yield* f(), "ERROR: no agent resolver configured";
-						let a = yield* W(t.resolveAgent(e, {
+						let s = yield* G(t.resolveAgent(e, {
 							runId: n,
-							tenantId: o
+							tenantId: o,
+							ownerId: a
 						})).pipe(C.map((e) => ({
 							ok: !0,
 							a: e
@@ -714,63 +856,64 @@ var N = Ie("_voltro_ai_flows", {
 							ok: !1,
 							e
 						})));
-						if (!a.ok) return d(i, {
+						if (!s.ok) return d(i, {
 							status: "failed",
-							errorMessage: a.e.message
-						}), yield* f(), `ERROR: ${a.e.message}`;
-						let s = yield* Ot(t, a.a, r, {}).pipe(C.map((e) => ({
+							errorMessage: s.e.message
+						}), yield* f(), `ERROR: ${Nt(s.e)}`;
+						let c = yield* Rt(t, s.a, r, {}).pipe(C.map((e) => ({
 							ok: !0,
 							r: e
 						})), C.catchAll((e) => C.succeed({
 							ok: !1,
 							e
 						})));
-						if (!s.ok) {
-							let e = String(s.e.message ?? s.e);
+						if (!c.ok) {
+							let e = String(c.e.message ?? c.e);
 							return d(i, {
 								status: "failed",
 								errorMessage: e
 							}), yield* f(), `ERROR: ${e}`;
 						}
-						let c = q(s.r.usage, s.r.providerMetadata, a.a.model);
-						return l += c, d(i, {
+						let p = J(c.r.usage, c.r.providerMetadata, s.a.model);
+						return l += p, d(i, {
 							status: "succeeded",
-							output: { text: s.r.text },
-							costMicroUsd: c
-						}), yield* f(), s.r.text;
+							output: { text: c.r.text },
+							costMicroUsd: p
+						}), yield* f(), c.r.text;
 					})
 				}),
-				generate_media: M({
+				generate_media: Ue({
 					name: "generate_media",
 					description: "Generate image, video, or audio artifacts. Returns every artifact with its URL, role, media type and optional storage reference.",
 					input: w.Struct({
 						modality: w.Literal("image", "video", "audio"),
 						prompt: w.String,
 						model: w.optional(w.String),
-						inputs: w.optional(U),
+						inputs: w.optional(W),
 						params: w.optional(w.Record({
 							key: w.String,
 							value: w.Unknown
 						}))
 					}),
-					execute: ({ modality: e, prompt: r, model: i, inputs: a, params: s }) => C.gen(function* () {
-						let c = u({
+					execute: ({ modality: e, prompt: r, model: i, inputs: s, params: c }) => C.gen(function* () {
+						let p = u({
 							title: `media:${e}`,
 							type: "generate"
 						});
-						if (yield* f(), !t.generateMedia) return d(c, {
+						if (yield* f(), !t.generateMedia) return d(p, {
 							status: "failed",
 							errorMessage: `no media generator for ${e}`
 						}), yield* f(), `ERROR: no media generator configured for ${e}`;
-						let p = yield* W(t.generateMedia({
+						let m = yield* G(t.generateMedia({
 							modality: e,
 							prompt: r,
 							...i ? { model: i } : {},
-							...a === void 0 ? {} : { inputs: a },
-							...s === void 0 ? {} : { params: s },
+							...s === void 0 ? {} : { inputs: s },
+							...c === void 0 ? {} : { params: c },
 							run: {
 								runId: n,
-								tenantId: o
+								tenantId: o,
+								ownerId: a
 							}
 						})).pipe(C.map((e) => ({
 							ok: !0,
@@ -779,24 +922,25 @@ var N = Ie("_voltro_ai_flows", {
 							ok: !1,
 							e
 						})));
-						if (!p.ok) return d(c, {
+						if (!m.ok) return d(p, {
 							status: "failed",
-							errorMessage: p.e.message
-						}), yield* f(), `ERROR: ${p.e.message}`;
-						let m = yield* Tt(p.r);
-						return m.error ? (d(c, {
+							errorMessage: m.e.message
+						}), yield* f(), `ERROR: ${m.e.message}`;
+						let h = yield* Ft(m.r);
+						return h.error ? (d(p, {
 							status: "failed",
-							errorMessage: m.error
-						}), yield* f(), { error: m.error }) : (l += m.costMicroUsd ?? 0, d(c, {
+							errorMessage: h.error
+						}), yield* f(), { error: h.error }) : (l += h.costMicroUsd ?? 0, d(p, {
 							status: "succeeded",
-							url: m.url,
-							artifacts: m.artifacts,
-							...m.requestId ? { requestId: m.requestId } : {},
-							costMicroUsd: m.costMicroUsd ?? 0
-						}), yield* f(), { artifacts: m.artifacts });
+							url: h.url,
+							artifacts: h.artifacts,
+							...h.requestId ? { requestId: h.requestId } : {},
+							costMicroUsd: h.costMicroUsd ?? 0,
+							costSource: h.costSource ?? "unpriced"
+						}), yield* f(), { artifacts: h.artifacts });
 					})
 				}),
-				pick_structured: M({
+				pick_structured: Ue({
 					name: "pick_structured",
 					description: "Produce a JSON object for a task. Returns the object.",
 					input: w.Struct({
@@ -809,13 +953,13 @@ var N = Ie("_voltro_ai_flows", {
 							type: "structured"
 						});
 						yield* f();
-						let i = yield* We({
+						let i = yield* qe({
 							prompt: e,
 							schema: w.Record({
 								key: w.String,
 								value: w.Unknown
 							}),
-							...n ? { provider: K(t, n) } : {}
+							...n ? { provider: q(t, n) } : {}
 						}).pipe(C.map((e) => ({
 							ok: !0,
 							r: e
@@ -830,7 +974,7 @@ var N = Ie("_voltro_ai_flows", {
 								errorMessage: e
 							}), yield* f(), { error: e };
 						}
-						let a = q(i.r.usage, i.r.providerMetadata, n);
+						let a = J(i.r.usage, i.r.providerMetadata, n);
 						return l += a, d(r, {
 							status: "succeeded",
 							output: { text: JSON.stringify(i.r.object) },
@@ -838,11 +982,12 @@ var N = Ie("_voltro_ai_flows", {
 						}), yield* f(), i.r.object;
 					})
 				})
-			}, m = yield* (t.resolveTools ? W(t.resolveTools(s, {
+			}, m = yield* (t.resolveTools ? G(t.resolveTools(s, {
 				runId: n,
-				tenantId: o
-			})) : C.succeed({})).pipe(C.either);
-			if (m._tag === "Left") return {
+				tenantId: o,
+				ownerId: a
+			}, { provider: () => r.orchestrator?.model ? q(t, r.orchestrator.model) : void 0 })) : C.succeed({})).pipe(C.either);
+			if (m._tag === "Left") return yield* C.logWarning(`flow tool resolution failed for run ${n}: ${m.left.message}`).pipe(C.annotateLogs({ scope: "voltro:ai-flows" })), {
 				object: {},
 				planCostMicroUsd: 0,
 				toolCostMicroUsd: 0,
@@ -856,9 +1001,9 @@ var N = Ie("_voltro_ai_flows", {
 				steps: c,
 				error: "flow tools cannot replace reserved planner tools"
 			};
-			let ee = t.memoryPrefix ? yield* W(t.memoryPrefix(a)).pipe(C.catchAll(() => C.succeed(""))) : "", h = ee ? `${ee}\n\n${Ft(r)}` : Ft(r), g = yield* Ke({
-				system: h,
-				prompt: Pt(i),
+			let h = t.memoryPrefix ? yield* G(t.memoryPrefix(a)).pipe(C.catchAll(() => C.succeed(""))) : "", ee = h ? `${h}\n\n${Kt(r)}` : Kt(r), g = yield* Ye({
+				system: ee,
+				prompt: Gt(i),
 				schema: w.Record({
 					key: w.String,
 					value: w.Unknown
@@ -868,7 +1013,7 @@ var N = Ie("_voltro_ai_flows", {
 					...p
 				},
 				maxSteps: r.maxSteps,
-				...r.orchestrator?.model ? { provider: K(t, r.orchestrator.model) } : {}
+				...r.orchestrator?.model ? { provider: q(t, r.orchestrator.model) } : {}
 			}).pipe(C.map((e) => ({
 				ok: !0,
 				r: e
@@ -878,7 +1023,8 @@ var N = Ie("_voltro_ai_flows", {
 			})));
 			return g.ok ? {
 				object: g.r.object,
-				planCostMicroUsd: q(g.r.usage, g.r.providerMetadata, r.orchestrator?.model),
+				planCostMicroUsd: J(g.r.usage, g.r.providerMetadata, r.orchestrator?.model),
+				planCostSource: Y(g.r.usage, g.r.providerMetadata, r.orchestrator?.model).costSource,
 				toolCostMicroUsd: l,
 				steps: c
 			} : {
@@ -889,37 +1035,43 @@ var N = Ie("_voltro_ai_flows", {
 				error: String(g.e.message ?? g.e)
 			};
 		})
-	}), l = c.planCostMicroUsd + c.toolCostMicroUsd;
-	return c.error ? (yield* J(e, n, {
+	}), l = c.planCostMicroUsd + c.toolCostMicroUsd, u = X([...c.steps, {
+		status: "succeeded",
+		costMicroUsd: c.planCostMicroUsd,
+		costSource: c.planCostSource ?? "unpriced"
+	}]);
+	return c.error ? (yield* Z(e, n, {
 		status: "failed",
 		steps: c.steps,
 		errorMessage: c.error,
-		completedAt: G(),
-		costMicroUsd: l
+		completedAt: K(),
+		costMicroUsd: l,
+		costCompleteness: u
 	}), {
 		runId: n,
 		status: "failed"
-	}) : (yield* J(e, n, {
+	}) : (yield* Z(e, n, {
 		status: "succeeded",
 		steps: c.steps,
 		output: c.object,
-		completedAt: G(),
-		costMicroUsd: l
+		completedAt: K(),
+		costMicroUsd: l,
+		costCompleteness: u
 	}), {
 		runId: n,
 		status: "succeeded",
 		output: c.object
 	});
-}), Rt = (e, t = {}) => (n, r) => C.gen(function* () {
-	let { runId: r, flowRef: i, input: a } = n, o = yield* C.tryPromise(() => e.store.query(O(P).where(T("id", r)).descriptor)).pipe(C.flatMap(w.decodeUnknown(w.Tuple(w.Struct({
+}), Yt = (e, t = {}) => (n, r) => C.gen(function* () {
+	let { runId: r, flowRef: i, input: a } = n, o = yield* C.tryPromise(() => e.store.query(O(N).where(T("id", r)).descriptor)).pipe(C.flatMap(w.decodeUnknown(w.Tuple(w.Struct({
 		id: w.Literal(r),
 		tenantId: w.NullOr(w.NonEmptyString),
 		ownerId: w.optional(w.NullOr(w.String))
 	})))), C.either);
-	if (o._tag === "Left") return yield* J(e, r, {
+	if (o._tag === "Left") return yield* Z(e, r, {
 		status: "failed",
 		errorMessage: "flow run context unavailable: expected one matching run row with an explicit tenantId (string or null)",
-		completedAt: G()
+		completedAt: K()
 	}), {
 		runId: r,
 		status: "failed"
@@ -931,32 +1083,32 @@ var N = Ie("_voltro_ai_flows", {
 			ir: w.Unknown,
 			error: w.optional(w.String)
 		}),
-		execute: Y(e, i).pipe(C.map((e) => ({ ir: e })), C.catchAll((e) => C.succeed({
+		execute: Q(e, i).pipe(C.map((e) => ({ ir: e })), C.catchAll((e) => C.succeed({
 			ir: void 0,
 			error: e.message
 		})))
 	});
-	if (l.error || !l.ir) return yield* J(e, r, {
+	if (l.error || !l.ir) return yield* Z(e, r, {
 		status: "failed",
 		errorMessage: l.error ?? "flow not found",
-		completedAt: G()
+		completedAt: K()
 	}), {
 		runId: r,
 		status: "failed"
 	};
-	let u = l.ir, d = u.mode === "agentic" ? yield* Lt(e, t, r, u, a, c, s, i) : yield* jt(e, t, r, u, a, {
+	let u = l.ir, d = u.mode === "agentic" ? yield* Jt(e, t, r, u, a, c, s, i) : yield* Ht(e, t, r, u, a, {
 		ownerId: c,
 		tenantId: s,
 		source: n.source
 	});
-	return d.status === "succeeded" && u.chain && (yield* Mt(e, r, u, a, d.output ?? {}, n, t)), t.onEvent && (d.status === "succeeded" || d.status === "failed") && (yield* W(t.onEvent({
+	return d.status === "succeeded" && u.chain && (yield* Ut(e, r, u, a, d.output ?? {}, n, t)), t.onEvent && (d.status === "succeeded" || d.status === "failed") && (yield* G(t.onEvent({
 		kind: d.status,
 		runId: r,
 		flowName: u.name,
 		ownerId: c,
 		source: n.source
 	})).pipe(C.catchAllCause(() => C.void))), d;
-}), zt = {
+}), Xt = {
 	text: (e) => ({
 		type: "generate",
 		modality: "text",
@@ -983,12 +1135,12 @@ var N = Ie("_voltro_ai_flows", {
 		type: "human",
 		...e
 	})
-}, Bt = (e) => e.map((e, t) => "id" in e && e.id ? e : {
+}, Zt = (e) => e.map((e, t) => "id" in e && e.id ? e : {
 	id: `step-${t}`,
 	...e
-}), Vt = (e) => {
+}), Qt = (e) => {
 	let t = [], n = z(e.steps);
-	for (let e of ft(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`);
+	for (let e of vt(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) {
@@ -997,18 +1149,18 @@ var N = Ie("_voltro_ai_flows", {
 			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(s(t.outputKey));
+		for (let { step: t } of e.steps) t.outputKey && r.add(m(t.outputKey));
 	}
-	if (t.length > 0) throw new Te({
+	if (t.length > 0) throw new De({
 		flowRef: e.name,
 		message: `flow "${e.name}" has ${t.length} problem(s)`,
 		issues: t
 	});
-}, Ht = (e) => {
-	let t = _({
+}, $t = (e) => {
+	let t = f({
 		name: e.name,
 		mode: e.mode,
-		steps: Bt(e.steps),
+		steps: Zt(e.steps),
 		maxSteps: e.maxSteps,
 		brief: e.brief,
 		orchestratorModel: e.orchestrator?.model,
@@ -1017,21 +1169,21 @@ var N = Ie("_voltro_ai_flows", {
 		cadence: e.cadence,
 		humanTimeoutMs: e.humanTimeoutMs
 	});
-	return Vt(t), pt(t), t;
-}, X = async (e, t, n) => {
-	let r = w.decodeUnknownSync(ke.pipe(w.filter((e) => e.workflowName === "flow.run" && e.id.length > 0)))(n);
-	if (await e.store.update(P.tableName, t, { workflowStart: r }) === null) throw Error("flow start receipt could not be recorded; workflow submission may have succeeded");
+	return Qt(t), yt(t), t;
+}, en = async (e, t, n) => {
+	let r = w.decodeUnknownSync(je.pipe(w.filter((e) => e.workflowName === "flow.run" && e.id.length > 0)))(n);
+	if (await e.store.update(N.tableName, t, { workflowStart: r }) === null) throw Error("flow start receipt could not be recorded; workflow submission may have succeeded");
 	return r;
-}, Ut = (e, t, n) => {
+}, tn = (e, t, n) => {
 	if (!Number.isFinite(t.getTime())) throw Error("cadence timestamp must be valid");
-	return `cron-${Xe("sha256").update(JSON.stringify([
+	return `cron-${$e("sha256").update(JSON.stringify([
 		n,
 		e,
 		Math.floor(t.getTime() / 6e4)
 	])).digest("hex")}`;
-}, Wt = async (e) => {
+}, nn = async (e) => {
 	let t = [];
-	for (let n of ht()) n.cadence && (n.cadence.repeats?.length ?? 0) > 0 && t.push({
+	for (let n of xt()) n.cadence && (n.cadence.repeats?.length ?? 0) > 0 && t.push({
 		tenantId: e.request.subject.tenantId,
 		flowRef: n.name,
 		cadence: n.cadence,
@@ -1045,86 +1197,109 @@ var N = Ie("_voltro_ai_flows", {
 		defaultInput: r.cadence.defaultInput ?? {}
 	});
 	return t;
-}, Gt = async (e, t = /* @__PURE__ */ new Date()) => {
-	let n = [], r = 0, i = await Wt(e), a = [];
-	for (let o of i) {
-		if (!De(o.cadence, t)) continue;
-		r += 1;
-		let i = Ut(o.flowRef, t, o.tenantId), s = `run-${i}`;
+}, rn = async (e, t = /* @__PURE__ */ new Date()) => {
+	let r = [], i = 0, a = [], o = e.workflows ? await rt(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 nn(e);
+	for (let o of s) {
+		if (!ke(o.cadence, t)) continue;
+		i += 1;
+		let s = tn(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: s,
+					id: c,
 					flowRef: o.flowRef,
 					flowName: o.flowRef,
 					status: "pending",
 					source: "cron",
-					requestId: i,
+					requestId: s,
 					input: o.defaultInput
 				}, { conflictColumns: ["id"] });
-				let n = await e.store.select("_voltro_ai_flow_runs").where("id", s).first();
-				if (!n) throw Error("cadence run is not readable after persistence");
-				let r = w.decodeUnknownSync(y.payloadSchema.pipe(w.filter((e) => e.runId === s && e.flowRef === o.flowRef && e.requestId === i && e.source === "cron")))({
-					...n,
-					runId: n.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 = w.decodeUnknownSync(n.payloadSchema.pipe(w.filter((e) => e.runId === c && e.flowRef === o.flowRef && e.requestId === s && e.source === "cron")))({
+					...r,
+					runId: r.id
 				});
-				return X(e, s, await t.start("flow.run", r));
-			}, o.tenantId === null ? void 0 : { tenantId: o.tenantId })).status === "running" && n.push(i);
+				return en(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: r,
-		started: n
+		matched: i,
+		started: r,
+		reconciled: o
 	};
-}, Z = (e) => w.optionalWith(e, { exact: !0 }), Kt = w.Int.pipe(w.positive(), w.lessThanOrEqualTo(2 ** 53 - 1)), qt = w.Int.pipe(w.between(-(2 ** 53 - 1), 2 ** 53 - 1)), Jt = w.TemplateLiteral(w.Number, "x", w.Number).pipe(w.pattern(/^[1-9]\d*x[1-9]\d*$/)), Yt = w.TemplateLiteral(w.Number, ":", w.Number).pipe(w.pattern(/^[1-9]\d*:[1-9]\d*$/)), Xt = w.Struct({
-	n: Z(Kt),
-	seed: Z(qt),
-	size: Z(Jt),
-	aspectRatio: Z(Yt),
-	providerOptions: Z(H)
-}), Zt = w.Struct({
-	voice: Z(w.NonEmptyString),
-	outputFormat: Z(w.NonEmptyString),
-	instructions: Z(w.String),
-	speed: Z(w.Finite.pipe(w.positive())),
-	language: Z(w.NonEmptyString),
-	providerOptions: Z(H)
-}), Qt = w.Struct({
-	aspectRatio: Z(Yt),
-	durationSeconds: Z(w.Finite.pipe(w.positive())),
-	resolution: Z(Jt),
-	fps: Z(w.Finite.pipe(w.positive())),
-	seed: Z(qt),
-	generateAudio: Z(w.Boolean),
-	maxInlineBytes: Z(Kt),
-	providerOptions: Z(H)
-}), Q = (e, t, n) => C.try({
+}, $ = (e) => w.optionalWith(e, { exact: !0 }), an = w.Int.pipe(w.positive(), w.lessThanOrEqualTo(2 ** 53 - 1)), on = w.Int.pipe(w.between(-(2 ** 53 - 1), 2 ** 53 - 1)), sn = w.TemplateLiteral(w.Number, "x", w.Number).pipe(w.pattern(/^[1-9]\d*x[1-9]\d*$/)), cn = w.TemplateLiteral(w.Number, ":", w.Number).pipe(w.pattern(/^[1-9]\d*:[1-9]\d*$/)), ln = w.Struct({
+	n: $(an),
+	seed: $(on),
+	size: $(sn),
+	aspectRatio: $(cn),
+	providerOptions: $(H)
+}), un = w.Struct({
+	voice: $(w.NonEmptyString),
+	outputFormat: $(w.NonEmptyString),
+	instructions: $(w.String),
+	speed: $(w.Finite.pipe(w.positive())),
+	language: $(w.NonEmptyString),
+	providerOptions: $(H)
+}), dn = w.Struct({
+	aspectRatio: $(cn),
+	durationSeconds: $(w.Finite.pipe(w.positive())),
+	resolution: $(sn),
+	fps: $(w.Finite.pipe(w.positive())),
+	seed: $(on),
+	generateAudio: $(w.Boolean),
+	maxInlineBytes: $(an),
+	providerOptions: $(H)
+}), fn = (e, t, n) => C.try({
 	try: () => w.decodeUnknownSync(e, { onExcessProperty: "error" })(t === void 0 ? {} : t),
 	catch: () => `invalid ${n} media params: check the built-in adapter's supported options and value ranges`
-}), $t = (e) => Q(Xt, e, "image"), en = (e) => Q(Zt, e, "audio"), tn = (e) => Q(Qt, e, "video"), nn = (e) => ({
+}), pn = (e) => fn(ln, e, "image"), mn = (e) => fn(un, e, "audio"), hn = (e) => fn(dn, e, "video"), gn = (e) => ({
 	name: "gateway",
 	model: e
-}), rn = (e) => Math.round(e * 1e6), $ = (e, t, n) => {
-	let r = He(t);
-	return typeof r == "number" ? rn(r) : e ? Ve(e, { model: n ?? "unknown" }).costMicroUsd ?? 0 : 0;
-}, an = (e, t) => (n) => {
-	let r = n.model, i = (e) => t?.resolveModel?.(e) ?? nn(e);
+}), _n = (e) => Math.round(e * 1e6), vn = (e, t, n) => {
+	let r = Ge(t);
+	if (typeof r == "number") return {
+		costMicroUsd: _n(r),
+		costSource: "gateway"
+	};
+	if (e) {
+		let t = We(e, { model: n ?? "unknown" });
+		return {
+			costMicroUsd: t.costMicroUsd ?? 0,
+			costSource: t.costSource ?? "unpriced"
+		};
+	}
+	return {
+		costMicroUsd: 0,
+		costSource: "unpriced"
+	};
+}, yn = (e, t) => (n) => {
+	let r = n.model, i = (e) => t?.resolveModel?.(e) ?? gn(e);
 	return C.gen(function* () {
-		let t = yield* xt(n.modality, n.inputs).pipe(C.mapError((e) => new x({
+		let t = yield* At(n.modality, n.inputs).pipe(C.mapError((e) => new x({
 			capability: `media:${n.modality}`,
 			message: e
 		})));
 		if (n.modality === "image") {
-			let a = yield* $t(n.params).pipe(C.mapError((e) => new x({
+			let a = yield* pn(n.params).pipe(C.mapError((e) => new x({
 				capability: "media:image",
 				message: e
-			}))), o = t.referenceImageUrl, s = t.maskImageUrl, c = yield* Ue({
+			}))), o = t.referenceImageUrl, s = t.maskImageUrl, c = yield* Ke({
 				...a,
 				prompt: n.prompt,
 				...o === void 0 ? {} : { inputs: {
@@ -1157,14 +1332,14 @@ var N = Ie("_voltro_ai_flows", {
 			}
 			return {
 				artifacts: l,
-				costMicroUsd: $(c.usage, c.providerMetadata, r)
+				...vn(c.usage, c.providerMetadata, r)
 			};
 		}
 		if (n.modality === "audio") {
-			let t = yield* en(n.params).pipe(C.mapError((e) => new x({
+			let t = yield* mn(n.params).pipe(C.mapError((e) => new x({
 				capability: "media:audio",
 				message: e
-			}))), a = yield* qe({
+			}))), a = yield* Xe({
 				...t,
 				text: n.prompt,
 				...r ? { provider: i(r) } : {}
@@ -1183,13 +1358,13 @@ var N = Ie("_voltro_ai_flows", {
 					role: "primary",
 					...o.refId === void 0 ? {} : { storageRefId: o.refId }
 				}],
-				costMicroUsd: $(a.usage, a.providerMetadata, r)
+				...vn(a.usage, a.providerMetadata, r)
 			};
 		}
-		let { maxInlineBytes: a, providerOptions: o, ...s } = yield* tn(n.params).pipe(C.mapError((e) => new x({
+		let { maxInlineBytes: a, providerOptions: o, ...s } = yield* hn(n.params).pipe(C.mapError((e) => new x({
 			capability: "media:video",
 			message: e
-		}))), c = yield* Ye({
+		}))), c = yield* Qe({
 			prompt: n.prompt,
 			inputs: {
 				...t.referenceImageUrl === void 0 ? {} : { image: t.referenceImageUrl },
@@ -1230,123 +1405,142 @@ var N = Ie("_voltro_ai_flows", {
 				role: "primary",
 				...l.refId === void 0 ? {} : { storageRefId: l.refId }
 			}],
-			costMicroUsd: $(c.usage, c.providerMetadata, r)
+			...vn(c.usage, c.providerMetadata, r)
 		};
 	}).pipe(C.catchAll((e) => e instanceof x ? C.fail(e) : C.fail(new x({
 		capability: `media:${n.modality}`,
 		message: String(e.message ?? e)
 	}))));
-}, on = () => globalThis.crypto?.randomUUID?.() ?? `req-${Date.now().toString(36)}`, sn = (e) => e.request?.subject?.id ?? null, cn = (e, t) => C.promise(() => e.store.query(O(P).where(T("id", t)).descriptor)).pipe(C.map((e) => e[0])), ln = (e) => C.sync(() => {
+}, bn = () => globalThis.crypto?.randomUUID?.() ?? `req-${Date.now().toString(36)}`, xn = (e) => e.request?.subject?.id ?? null, Sn = (e, t) => C.promise(() => e.store.query(O(N).where(T("id", t)).descriptor)).pipe(C.map((e) => e[0])), Cn = (e) => C.sync(() => {
 	let t = e.workflows;
 	if (!t) throw Error("workflow runtime unavailable; no flow start was submitted");
 	return t;
-}), un = (e, t) => C.gen(function* () {
-	yield* ln(e);
-	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* C.fail(new be({
-		missing: i,
-		message: `missing required brief field(s): ${i.join(", ")}`
+}), wn = (t, n) => C.gen(function* () {
+	yield* Cn(t);
+	let r = yield* Q(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* C.fail(new Se({
+		missing: a,
+		message: `missing required brief field(s): ${a.join(", ")}`
 	}));
-	let a = on(), o = `run-${a}`, s = t.source ?? "manual";
-	return yield* C.promise(() => e.transaction(async (e) => {
-		let i = e.workflows;
-		if (!i) throw Error("workflow runtime unavailable in transaction; no flow start was submitted");
-		await e.store.insert(P.tableName, {
-			id: o,
-			flowRef: t.flowRef,
-			flowName: n.name,
-			mode: n.mode,
+	let o = bn(), s = `run-${o}`, c = n.source ?? "manual";
+	return yield* C.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(N.tableName, {
+			id: s,
+			flowRef: n.flowRef,
+			flowName: r.name,
+			mode: r.mode,
 			status: "pending",
-			source: s,
-			requestId: a,
-			input: r,
-			ownerId: sn(e)
+			source: c,
+			requestId: o,
+			input: i,
+			ownerId: xn(t)
 		});
-		let c = await X(e, o, await i.start(v, {
-			runId: o,
-			flowRef: t.flowRef,
-			input: r,
-			source: s,
-			requestId: a
+		let l = await en(t, s, await a.start(e, {
+			runId: s,
+			flowRef: n.flowRef,
+			input: i,
+			source: c,
+			requestId: o
 		}));
-		return h.make({
-			runId: o,
-			requestId: a,
-			admission: c
+		return v.make({
+			runId: s,
+			requestId: o,
+			admission: l
 		});
 	}));
-}), dn = (e, t) => C.gen(function* () {
-	return yield* ln(e), yield* C.tryPromise({
-		try: () => e.transaction(async (e) => {
-			let n = e.workflows;
-			if (!n) throw Error("workflow runtime unavailable in transaction; no flow start was submitted");
-			let r = (await e.store.query(O(P).where(T("id", t.runId)).descriptor))[0];
-			if (!r) throw new S({
-				runId: t.runId,
+}), Tn = (t, r) => C.gen(function* () {
+	return yield* Cn(t), yield* C.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(O(N).where(T("id", r.runId)).descriptor))[0];
+			if (!a) throw new S({
+				runId: r.runId,
 				message: "run not found"
 			});
-			let i = r.requestId;
-			if (typeof i != "string" || i.length === 0) throw Error("stored flow run has no valid requestId; retry refused without changing the run");
-			let a = w.decodeUnknownEither(y.payloadSchema.pipe(w.filter((e) => e.runId === t.runId && e.flowRef.length > 0)))({
-				...r,
-				runId: r.id
+			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 = w.decodeUnknownEither(n.payloadSchema.pipe(w.filter((e) => e.runId === r.runId && e.flowRef.length > 0)))({
+				...a,
+				runId: a.id
 			});
-			if (a._tag === "Left") throw Error("stored workflow payload is incomplete or invalid; retry refused without changing the run");
-			let o = await X(e, t.runId, await n.start(v, a.right));
-			return h.make({
-				runId: t.runId,
-				requestId: i,
-				admission: o
+			if (s._tag === "Left") throw Error("stored workflow payload is incomplete or invalid; retry refused without changing the run");
+			let c = await en(t, r.runId, await i.start(e, s.right));
+			return v.make({
+				runId: r.runId,
+				requestId: o,
+				admission: c
 			});
 		}),
 		catch: (e) => e
 	}).pipe(C.catchAll((e) => e instanceof S ? C.fail(e) : C.die(e)));
-}), fn = (e, t) => C.gen(function* () {
-	return (yield* cn(e, t.runId)) ? (yield* C.promise(() => e.store.update(P.tableName, t.runId, {
-		status: "cancelled",
-		cancelledAt: (/* @__PURE__ */ new Date()).toISOString()
-	})), {
-		runId: t.runId,
-		status: "cancelled"
-	}) : yield* C.fail(new S({
-		runId: t.runId,
+}), En = (t, r) => C.gen(function* () {
+	let i = yield* Sn(t, r.runId);
+	if (!i) return yield* C.fail(new S({
+		runId: r.runId,
 		message: "run not found"
 	}));
-}), pn = (e) => {
+	let a = (/* @__PURE__ */ new Date()).toISOString();
+	yield* C.promise(() => t.store.update(N.tableName, r.runId, {
+		status: "cancelled",
+		cancelledAt: a,
+		completedAt: a
+	}));
+	let o = t.workflows, s = w.decodeUnknownOption(w.Struct({
+		runId: w.Literal(r.runId),
+		flowRef: w.NonEmptyString,
+		requestId: w.NonEmptyString,
+		input: w.Record({
+			key: w.String,
+			value: w.Unknown
+		}),
+		source: w.Literal("manual", "cron")
+	}))({
+		...i,
+		runId: i.id
+	}), c = o === void 0 || s._tag === "None" ? "unreachable" : yield* C.flatMap(n.executionId(s.value), (t) => C.tryPromise(() => o.cancel(e, t))).pipe(C.map(() => "cancelled"), C.catchAll(() => C.succeed("unreachable")));
+	return {
+		runId: r.runId,
+		status: "cancelled",
+		engine: c
+	};
+}), Dn = (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;
-}, mn = (e, t) => C.gen(function* () {
-	let n = (e, n) => new we({
-		runId: t.runId,
+}, On = (t, i) => C.gen(function* () {
+	let a = (e, t) => new Ee({
+		runId: i.runId,
 		reason: e,
-		message: n
-	}), r = yield* w.decodeUnknown(le, { onExcessProperty: "error" })(t).pipe(C.mapError(() => n("invalid-response", "review response requires runId, displayed stepIndex and a valid response")));
-	if (r.response.decision === void 0 && r.response.text === void 0 && r.response.value === void 0) return yield* C.fail(n("invalid-response", "review response must contain a decision, text or value"));
-	let i = e.workflows;
-	if (!i) return yield* C.fail(n("runtime-unavailable", "workflow runtime unavailable; review was not sent"));
-	let a = yield* cn(e, t.runId);
-	if (!a) return yield* C.fail(new S({
-		runId: t.runId,
+		message: t
+	}), o = yield* w.decodeUnknown(ie, { onExcessProperty: "error" })(i).pipe(C.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* C.fail(a("invalid-response", "review response must contain a decision, text or value"));
+	let s = t.workflows;
+	if (!s) return yield* C.fail(a("runtime-unavailable", "workflow runtime unavailable; review was not sent"));
+	let c = yield* Sn(t, i.runId);
+	if (!c) return yield* C.fail(new S({
+		runId: i.runId,
 		message: "run not found"
 	}));
-	let o = a.status;
-	if (o !== "waiting") return yield* C.fail(new Se({
-		runId: t.runId,
-		status: o ?? "unknown",
-		message: `run is "${o}", not awaiting a response`
+	let l = c.status;
+	if (l !== "waiting") return yield* C.fail(new we({
+		runId: i.runId,
+		status: l ?? "unknown",
+		message: `run is "${l}", not awaiting a response`
 	}));
-	let s = yield* C.try({
-		try: () => pn(a),
-		catch: () => n("invalid-run", "stored run has no unambiguous waiting review")
+	let u = yield* C.try({
+		try: () => Dn(c),
+		catch: () => a("invalid-run", "stored run has no unambiguous waiting review")
 	});
-	if (s !== r.stepIndex) return yield* C.fail(new Se({
-		runId: t.runId,
-		status: o,
+	if (u !== o.stepIndex) return yield* C.fail(new we({
+		runId: i.runId,
+		status: l,
 		message: "this review is no longer waiting; reload the run before answering"
 	}));
-	let c = yield* w.decodeUnknown(w.Struct({
-		runId: w.Literal(t.runId),
+	let d = yield* w.decodeUnknown(w.Struct({
+		runId: w.Literal(i.runId),
 		flowRef: w.NonEmptyString,
 		requestId: w.NonEmptyString,
 		input: w.Record({
@@ -1355,41 +1549,41 @@ var N = Ie("_voltro_ai_flows", {
 		}),
 		source: w.Literal("manual", "cron")
 	}))({
-		...a,
-		runId: a.id
-	}).pipe(C.mapError(() => n("invalid-run", "stored workflow payload is incomplete; review was not sent"))), l = yield* y.executionId(c), u = {
-		...r.response,
+		...c,
+		runId: c.id
+	}).pipe(C.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()
-	}, d = yield* C.tryPromise({
-		try: () => i.signal({
-			workflowName: v,
-			executionId: l
-		}, b(s), u),
-		catch: () => n("delivery-unknown", "review delivery was not confirmed; observe the run before retrying")
-	}), f = yield* w.decodeUnknown(w.Struct({ eventId: w.NonEmptyString }))(d).pipe(C.mapError(() => n("delivery-unknown", "workflow runtime returned no valid review delivery receipt")));
-	return yield* w.decodeUnknown(fe)({
-		runId: t.runId,
-		stepIndex: s,
-		executionId: l,
-		eventId: f.eventId,
+	}, m = yield* C.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* w.decodeUnknown(w.Struct({ eventId: w.NonEmptyString }))(m).pipe(C.mapError(() => a("delivery-unknown", "workflow runtime returned no valid review delivery receipt")));
+	return yield* w.decodeUnknown(de)({
+		runId: i.runId,
+		stepIndex: u,
+		executionId: f,
+		eventId: h.eventId,
 		status: "accepted"
-	}).pipe(C.mapError(() => n("delivery-unknown", "workflow runtime returned no valid review delivery receipt")));
-}), hn = (e, t) => C.promise(() => e.store.query(O(N).where(T("id", t.id)).descriptor)).pipe(C.map((e) => e[0])), gn = (e) => C.promise(() => e.store.query(O(N).descriptor)), _n = (e, t) => C.promise(() => e.store.insert(N.tableName, {
-	id: t.id ?? `flow-${on()}`,
+	}).pipe(C.mapError(() => a("delivery-unknown", "workflow runtime returned no valid review delivery receipt")));
+}), kn = (e, t) => C.promise(() => e.store.query(O(M).where(T("id", t.id)).descriptor)).pipe(C.map((e) => e[0])), An = (e) => C.promise(() => e.store.query(O(M).descriptor)), jn = (e, t) => C.promise(() => e.store.insert(M.tableName, {
+	id: t.id ?? `flow-${bn()}`,
 	...t
-})), vn = (e, t) => C.promise(() => e.store.update(N.tableName, t.id, t.patch)), yn = (e, t) => C.promise(() => e.store.delete(N.tableName, t.id)), bn = "aiFlows", xn = (e = {}) => {
-	let t = je({
-		base: bn,
+})), Mn = (e, t) => C.promise(() => e.store.update(M.tableName, t.id, t.patch)), Nn = (e, t) => C.promise(() => e.store.delete(M.tableName, t.id)), Pn = "aiFlows", Fn = (e = {}) => {
+	let t = Ne({
+		base: Pn,
 		alias: e.alias
 	});
-	it(e.humanReviewTimeoutMs === void 0 ? {} : { humanReviewTimeoutMs: e.humanReviewTimeoutMs }), Fe({
+	ut(e.humanReviewTimeoutMs === void 0 ? {} : { humanReviewTimeoutMs: e.humanReviewTimeoutMs }), Le({
 		source: "plugin",
-		table: P.tableName,
+		table: N.tableName,
 		timeColumn: "createdAt",
-		ttlMs: e.runsTtlMs ?? ot(process.env.VOLTRO_AI_FLOW_RUNS_TTL_HOURS, 2160),
-		envVar: tt,
+		ttlMs: e.runsTtlMs ?? ft(process.env.VOLTRO_AI_FLOW_RUNS_TTL_HOURS, 2160),
+		envVar: st,
 		label: "ai flow runs",
-		where: Pe("status", [
+		where: Ie("status", [
 			"succeeded",
 			"failed",
 			"cancelled"
@@ -1451,17 +1645,42 @@ var N = Ie("_voltro_ai_flows", {
 		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)
 	}];
-	return Ae({
+	return Me({
 		name: t,
-		baseName: bn,
+		baseName: Pn,
 		description: "AI Flows — durable multi-step AI pipelines (deterministic + agentic) with human-in-the-loop, chaining, and cadence. Code-first (defineFlow) or data-driven.",
-		permissions: ["store:write", "inspect:read"],
-		...e.tables === !1 ? {} : { extendSchema: { tables: Ze } },
+		permissions: [
+			"store:write",
+			"inspect:read",
+			"store:changes:read"
+		],
+		...e.tables === !1 ? {} : { extendSchema: { tables: et } },
 		inspectEndpoints: c,
 		bindDataStore: (e) => {
 			r.current = e;
-		}
+		},
+		onChangeEvent: (e) => C.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;
+			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* C.promise(() => n.query(O(N).where(T("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* C.promise(() => n.update(N.tableName, a, { workflowStart: P(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();
+			yield* C.promise(() => n.update(N.tableName, a, {
+				status: "cancelled",
+				cancelledAt: d,
+				completedAt: d
+			}));
+		}).pipe(C.catchAllCause(() => C.void))
 	});
 };
 //#endregion
-export { pe as BriefField, ce as ChainPending, c as ConditionOp, tt as FLOW_RUNS_TTL_ENV, et as FLOW_RUNS_TTL_HOURS_DEFAULT, v as FLOW_RUN_WORKFLOW, de as FlowCadence, ie as FlowChain, m as FlowMode, le as FlowReviewInput, fe as FlowReviewReceipt, h as FlowStartReceipt, oe as FlowStatus, me as FlowStep, ye as HUMAN_RESPONSE_SIGNAL_PREFIX, $e as HUMAN_REVIEW_TIMEOUT_ENV, Qe as HUMAN_REVIEW_TIMEOUT_HOURS_DEFAULT, g as HumanResponse, te as Json, nt as MAX_CHAIN_DEPTH_DEFAULT, rt as MAX_CHAIN_DEPTH_ENV, ue as MAX_STEPS_DEFAULT, se as MAX_STEPS_MAX, re as MAX_STEPS_MIN, ne as MediaArtifact, p as MediaArtifacts, he as MediaInputSlot, ve as MediaInputs, ee as Modality, _e as ReviewMode, d as ReviewOption, t as RunReview, ge as RunSource, f as RunStatus, r as RunStep, n as RunStepStatus, u as StepCondition, l as StepType, ae as Visibility, P as aiFlowRunsTable, xn as aiFlowsPlugin, N as aiFlowsTable, Ze as aiFlowsTables, Rt as buildFlowRunExecute, De as cadenceMatches, fn as cancelFlow, e as clampMaxSteps, gt as clearRegistry, L as collectRefs, _n as createFlow, Ut as cronRequestId, Ht as defineFlow, yn as deleteFlow, i as describeCondition, a as evaluateCondition, z as flowSegments, zt as flowStep, I as getAiFlowsDefaults, hn as getFlow, mt as getRegisteredFlow, b as humanResponseSignalName, R as interpolate, o as isTruthy, un as launchFlow, gn as listFlows, ht as listRegisteredFlows, an as makeMediaGenerator, Ee as nextRuns, ft as nonContiguousGroups, _ as normalizeFlow, pt as registerFlow, at as resetAiFlowsDefaults, ct as resolveHumanReviewTimeoutMs, Y as resolveIr, lt as resolveMaxChainDepth, mn as respondToFlow, dn as retryFlow, Gt as runCadenceTick, s as sanitizeOutputKey, it as setAiFlowsDefaults, dt as unresolvedRefs, vn as updateFlow, Vt as validateFlow, pn as waitingStepIndex };
+export { ve as BriefField, pe as ChainPending, c as ConditionOp, ge as CostCompleteness, _ as CostSource, st as FLOW_RUNS_TTL_ENV, ot as FLOW_RUNS_TTL_HOURS_DEFAULT, e as FLOW_RUN_WORKFLOW, ne as FlowCadence, me as FlowChain, _e as FlowMode, ie as FlowReviewInput, de as FlowReviewReceipt, v as FlowStartReceipt, ae as FlowStatus, oe as FlowStep, t as HUMAN_RESPONSE_SIGNAL_PREFIX, at as HUMAN_REVIEW_TIMEOUT_ENV, it as HUMAN_REVIEW_TIMEOUT_HOURS_DEFAULT, he as HumanResponse, fe as Json, ct as MAX_CHAIN_DEPTH_DEFAULT, lt as MAX_CHAIN_DEPTH_ENV, ce as MAX_STEPS_DEFAULT, se as MAX_STEPS_MAX, te as MAX_STEPS_MIN, ye as MediaArtifact, b as MediaArtifacts, re as MediaInputSlot, y as MediaInputs, ee as Modality, a as ReviewMode, be as ReviewOption, g as RunReview, s as RunSource, o as RunStatus, p as RunStep, ue as RunStepStatus, l as StepCondition, i as StepType, le as Visibility, P as admittedStartHandle, N as aiFlowRunsTable, Fn as aiFlowsPlugin, M as aiFlowsTable, et as aiFlowsTables, Yt as buildFlowRunExecute, ke as cadenceMatches, En as cancelFlow, d as clampMaxSteps, St as clearRegistry, L as collectRefs, jn as createFlow, tn as cronRequestId, $t as defineFlow, Nn as deleteFlow, u as describeCondition, h as evaluateCondition, z as flowSegments, Xt as flowStep, I as getAiFlowsDefaults, kn as getFlow, bt as getRegisteredFlow, r as humanResponseSignalName, R as interpolate, xe as isTruthy, wn as launchFlow, An as listFlows, xt as listRegisteredFlows, yn as makeMediaGenerator, Oe as nextRuns, vt as nonContiguousGroups, f as normalizeFlow, rt as reconcileFlowStarts, yt as registerFlow, dt as resetAiFlowsDefaults, mt as resolveHumanReviewTimeoutMs, Q as resolveIr, ht as resolveMaxChainDepth, On as respondToFlow, Tn as retryFlow, rn as runCadenceTick, m as sanitizeOutputKey, ut as setAiFlowsDefaults, _t as unresolvedRefs, Mn as updateFlow, Qt as validateFlow, Dn as waitingStepIndex };