@voltro/ai 0.73.0 → 0.75.0

package/dist/{inferenceQueue-CXEVU6mI.js → inferenceQueue-CdWTzRp7.js}

@@ -1,45 +1,45 @@
 import { c as e, o as t, r as n } from "./provider-Cts1BRhY.js";
 import { NoObjectGeneratedError as r, Output as i, experimental_transcribe as a, generateObject as o, generateText as s, jsonSchema as c, stepCountIs as l, tool as u } from "ai";
-import { Context as d, Effect as f, JSONSchema as p, Metric as m, MetricBoundaries as ee, Runtime as te, Schema as h, Stream as ne } from "effect";
-import { and as g, bigint as re, eq as _, generateId as v, gte as ie, id as y, integer as b, isNull as ae, json as x, queryFor as S, registerRetention as C, retentionTtlMsFromEnv as w, table as T, text as E, timestamp as D } from "@voltro/database";
-import { Ajv as oe } from "ajv";
-import { Ajv2019 as se } from "ajv/dist/2019.js";
-import { Ajv2020 as ce } from "ajv/dist/2020.js";
-import le from "ajv-formats";
-import { createHash as ue } from "node:crypto";
+import { Context as d, Data as f, Effect as p, JSONSchema as m, Metric as h, MetricBoundaries as ee, Runtime as te, Schema as g, Stream as ne } from "effect";
+import { and as _, bigint as re, eq as v, generateId as y, gte as ie, id as b, integer as x, isNull as ae, json as S, queryFor as C, registerRetention as w, retentionTtlMsFromEnv as oe, table as T, text as E, timestamp as D } from "@voltro/database";
+import { Ajv as se } from "ajv";
+import { Ajv2019 as ce } from "ajv/dist/2019.js";
+import { Ajv2020 as le } from "ajv/dist/2020.js";
+import ue from "ajv-formats";
+import { createHash as de } from "node:crypto";
 //#region src/tools.ts
-var de = (e, t) => e(t), fe = Symbol.for("@voltro/ai/Tool"), pe = (e) => ({
+var fe = (e, t) => e(t), pe = Symbol.for("@voltro/ai/Tool"), me = (e) => ({
 	...e,
-	[fe]: !0
-}), me = (e) => typeof e == "object" && !!e && e[fe] === !0, he = (e) => {
+	[pe]: !0
+}), he = (e) => typeof e == "object" && !!e && e[pe] === !0, ge = (e) => {
 	let t = e.default;
 	if (typeof t != "function") return 0;
 	let n = 0;
-	for (let r of Object.values(e)) me(r) && r.execute === void 0 && r.handler === void 0 && (r.handler = t, n += 1);
+	for (let r of Object.values(e)) he(r) && r.execute === void 0 && r.handler === void 0 && (r.handler = t, n += 1);
 	return n;
-}, ge = (e, t, n) => {
+}, _e = (e, t, n) => {
 	let r = t ?? te.defaultRuntime;
 	return te.runPromise(r)(e, n === void 0 ? {} : { signal: n });
-}, _e = (e, t, n) => n ? e.pipe(f.timeoutFail({
+}, ve = (e, t, n) => n ? e.pipe(p.timeoutFail({
 	duration: `${n} millis`,
 	onTimeout: () => /* @__PURE__ */ Error(`tool '${t}' timed out`)
-})) : e, ve = (e, t, n) => {
-	if (e.execute) return ge(_e(de(e.execute, t), e.name, e.timeoutMs), n.runtime, n.abortSignal);
+})) : e, ye = (e, t, n) => {
+	if (e.execute) return _e(ve(fe(e.execute, t), e.name, e.timeoutMs), n.runtime, n.abortSignal);
 	if (e.handler) {
 		let r = e.handler, i = r(t, n);
-		return f.isEffect(i) ? ge(_e(i, e.name, e.timeoutMs), n.runtime, n.abortSignal) : i;
+		return p.isEffect(i) ? _e(ve(i, e.name, e.timeoutMs), n.runtime, n.abortSignal) : i;
 	}
 	return Promise.reject(/* @__PURE__ */ Error(`tool '${e.name}' has neither execute nor handler`));
-}, ye = (e) => {
-	let t = p.make(e);
+}, be = (e) => {
+	let t = m.make(e);
 	return t && t.type === "object" ? t : {
 		type: "object",
 		properties: {},
 		additionalProperties: !1
 	};
-}, be = (e) => {
+}, xe = (e) => {
 	let t = e.inputJsonSchema;
-	return t === void 0 ? ye(e.input) : t.type === "object" ? t : {
+	return t === void 0 ? be(e.input) : t.type === "object" ? t : {
 		type: "object",
 		properties: {},
 		additionalProperties: !0
@@ -48,7 +48,7 @@ var de = (e, t) => e(t), fe = Symbol.for("@voltro/ai/Tool"), pe = (e) => ({
 	let n = {};
 	for (let [r, i] of Object.entries(e)) n[i.name || r] = u({
 		description: i.description,
-		inputSchema: c(be(i)),
+		inputSchema: c(xe(i)),
 		execute: async (e, n) => {
 			let r = n?.abortSignal ?? t.abortSignal;
 			r?.throwIfAborted();
@@ -56,33 +56,33 @@ var de = (e, t) => e(t), fe = Symbol.for("@voltro/ai/Tool"), pe = (e) => ({
 				...t,
 				...n?.toolCallId === void 0 ? {} : { invocationId: n.toolCallId },
 				...r === void 0 ? {} : { abortSignal: r }
-			}, o = await f.runPromise(h.decodeUnknown(i.input)(e));
+			}, o = await p.runPromise(g.decodeUnknown(i.input)(e));
 			r?.throwIfAborted();
-			let s = await ve(i, o, a);
-			return i.output ? f.runPromise(h.decodeUnknown(i.output)(s)) : s;
+			let s = await ye(i, o, a);
+			return i.output ? p.runPromise(g.decodeUnknown(i.output)(s)) : s;
 		}
 	});
 	return n;
-}, k = class extends h.TaggedError()("AiBudgetExceeded", {
-	tenantId: h.NullOr(h.String),
-	limitUsd: h.Number,
-	spentUsd: h.Number,
-	attemptedUsd: h.Number
+}, k = class extends g.TaggedError()("AiBudgetExceeded", {
+	tenantId: g.NullOr(g.String),
+	limitUsd: g.Number,
+	spentUsd: g.Number,
+	attemptedUsd: g.Number
 }) {}, A = "_voltro_ai_budget", j = "_voltro_ai_budget_reservations", M = T(A, {
-	id: y({ prefix: "aib" }),
+	id: b({ prefix: "aib" }),
 	bucket: E().maxLength(191),
 	tenantId: E().nullable(),
 	reservedMicroUsd: re().default("0").narrowedFrom("integer"),
 	updatedAt: D().default("now")
-}).unique("byAiBudgetBucket", ["bucket"]), xe = T(j, {
-	id: y({ prefix: "air" }),
+}).unique("byAiBudgetBucket", ["bucket"]), Se = T(j, {
+	id: b({ prefix: "air" }),
 	reservationId: E().maxLength(191),
 	bucket: E().maxLength(191),
 	tenantId: E().nullable(),
 	amountMicroUsd: re(),
 	releasedAt: D().nullable(),
 	updatedAt: D().default("now")
-}).unique("byAiBudgetReservation", ["reservationId"]), N = class extends Error {}, Se = (e, t, n) => {
+}).unique("byAiBudgetReservation", ["reservationId"]), N = class extends Error {}, Ce = (e, t, n) => {
 	if (!Number.isFinite(e) || e < 0) throw RangeError(`${t} must be finite and non-negative`);
 	let r = e * 1e6, i = n === "up" ? Math.ceil(r) : Math.floor(r);
 	if (!Number.isSafeInteger(i)) throw RangeError(`${t} exceeds the safe micro-USD range`);
@@ -92,39 +92,39 @@ var de = (e, t) => e(t), fe = Symbol.for("@voltro/ai/Tool"), pe = (e) => ({
 	let t = String(e);
 	if (!/^(0|[1-9][0-9]*)$/.test(t)) throw Error("AI budget counter is invalid; refusing to assume zero");
 	return BigInt(t);
-}, Ce = (e) => {
+}, we = (e) => {
 	if (typeof e != "string" || e.length === 0 || e.length > 191) throw RangeError("AI budget reservationId must contain 1–191 characters");
 	return e;
-}, we = () => {
-	let e = w(process.env.VOLTRO_AI_USAGE_TTL_HOURS, 8760);
-	for (let t of [A, j]) C({
+}, Te = () => {
+	let e = oe(process.env.VOLTRO_AI_USAGE_TTL_HOURS, 8760);
+	for (let t of [A, j]) w({
 		source: "plugin",
 		table: t,
 		timeColumn: "updatedAt",
 		ttlMs: e
 	});
-}, Te = async (e, t) => {
+}, Ee = async (e, t) => {
 	for (let n = 0;; n++) try {
 		return await e.transactional(t);
 	} catch (e) {
 		if (!(e instanceof N) || n >= 31) throw e;
 		await new Promise((e) => setTimeout(e, n + 1));
 	}
-}, Ee = (e) => f.tryPromise({
+}, De = (e) => p.tryPromise({
 	try: e,
 	catch: (e) => e
-}).pipe(f.catchAll((e) => e instanceof k ? f.fail(e) : f.die(e))), De = (e, t) => f.gen(function* () {
-	let n = Se(t.limitUsd, "limitUsd", "down"), r = Se(t.addUsd ?? 0, "addUsd", "up"), i = t.tenantId ?? null;
+}).pipe(p.catchAll((e) => e instanceof k ? p.fail(e) : p.die(e))), Oe = (e, t) => p.gen(function* () {
+	let n = Ce(t.limitUsd, "limitUsd", "down"), r = Ce(t.addUsd ?? 0, "addUsd", "up"), i = t.tenantId ?? null;
 	if (t.since !== void 0 && !Number.isFinite(t.since.getTime())) throw RangeError("AI budget since must be a valid Date");
 	let a = `${i ?? "global"}::${t.since === void 0 ? "all" : t.since.getTime()}`;
 	if (a.length > 191) throw RangeError("AI budget tenant/window key exceeds 191 characters");
-	let o = Ce(t.reservationId ?? v({
+	let o = we(t.reservationId ?? y({
 		kind: "typeid",
 		prefix: "air"
 	}, "_voltro_ai_budget_reservations"));
-	we();
+	Te();
 	let s = async (e) => {
-		let [t] = await e.query(S(M).where(_("bucket", a)).descriptor);
+		let [t] = await e.query(C(M).where(v("bucket", a)).descriptor);
 		if (t && t.tenantId !== i) throw Error("AI budget bucket belongs to a different tenant");
 		return t;
 	}, c = (e) => {
@@ -135,11 +135,11 @@ var de = (e, t) => e(t), fe = Symbol.for("@voltro/ai/Tool"), pe = (e) => ({
 			attemptedUsd: t.addUsd ?? 0
 		});
 	};
-	return r === 0n ? yield* Ee(async () => {
+	return r === 0n ? yield* De(async () => {
 		let t = await s(e);
 		return c(t ? P(t.reservedMicroUsd) : 0n), null;
-	}) : yield* Ee(() => Te(e, async (e) => {
-		let t = v({
+	}) : yield* De(() => Ee(e, async (e) => {
+		let t = y({
 			kind: "typeid",
 			prefix: "air"
 		}, j), n = /* @__PURE__ */ new Date(), l = await e.insertIgnore(j, {
@@ -166,9 +166,9 @@ var de = (e, t) => e(t), fe = Symbol.for("@voltro/ai/Tool"), pe = (e) => ({
 			if (await e.updateMany("_voltro_ai_budget", {
 				reservedMicroUsd: String(d + r),
 				updatedAt: n
-			}, { where: g(_("id", u.id), _("reservedMicroUsd", u.reservedMicroUsd)) }) !== 1) throw new N("AI budget counter changed; discard this receipt and retry");
+			}, { where: _(v("id", u.id), v("reservedMicroUsd", u.reservedMicroUsd)) }) !== 1) throw new N("AI budget counter changed; discard this receipt and retry");
 		} else {
-			let t = v({
+			let t = y({
 				kind: "typeid",
 				prefix: "aib"
 			}, A);
@@ -187,31 +187,31 @@ var de = (e, t) => e(t), fe = Symbol.for("@voltro/ai/Tool"), pe = (e) => ({
 			status: "reserved"
 		};
 	}));
-}), Oe = (e, t) => f.gen(function* () {
-	return Ce(t.reservationId), yield* f.promise(() => Te(e, async (e) => {
-		let n = S(xe).where(g(_("reservationId", t.reservationId), t.tenantId === null ? ae("tenantId") : _("tenantId", t.tenantId))).descriptor, [r] = await e.query(n);
+}), ke = (e, t) => p.gen(function* () {
+	return we(t.reservationId), yield* p.promise(() => Ee(e, async (e) => {
+		let n = C(Se).where(_(v("reservationId", t.reservationId), t.tenantId === null ? ae("tenantId") : v("tenantId", t.tenantId))).descriptor, [r] = await e.query(n);
 		if (!r) return "not-found";
 		if (r.releasedAt !== null) return "already-released";
 		let i = /* @__PURE__ */ new Date();
 		if (await e.updateMany("_voltro_ai_budget_reservations", {
 			releasedAt: i,
 			updatedAt: i
-		}, { where: g(_("id", r.id), ae("releasedAt")) }) !== 1) {
+		}, { where: _(v("id", r.id), ae("releasedAt")) }) !== 1) {
 			let [t] = await e.query(n);
 			if (t !== void 0 && t.releasedAt !== null) return "already-released";
 			throw new N("AI budget release raced; retry");
 		}
-		let [a] = await e.query(S(M).where(_("bucket", r.bucket)).descriptor);
+		let [a] = await e.query(C(M).where(v("bucket", r.bucket)).descriptor);
 		if (!a || a.tenantId !== t.tenantId) throw Error("AI budget counter missing or mismatched; refusing unproved credit");
 		let o = P(a.reservedMicroUsd), s = P(r.amountMicroUsd);
 		if (s > o) throw Error("AI budget receipt exceeds its counter; refusing unproved credit");
 		if (await e.updateMany("_voltro_ai_budget", {
 			reservedMicroUsd: String(o - s),
 			updatedAt: i
-		}, { where: g(_("id", a.id), _("reservedMicroUsd", a.reservedMicroUsd)) }) !== 1) throw new N("AI budget counter changed; discard this release and retry");
+		}, { where: _(v("id", a.id), v("reservedMicroUsd", a.reservedMicroUsd)) }) !== 1) throw new N("AI budget counter changed; discard this release and retry");
 		return "released";
 	}));
-}), ke = {
+}), Ae = {
 	"claude-opus-4-8": {
 		inputPer1M: 15,
 		outputPer1M: 75
@@ -256,21 +256,21 @@ var de = (e, t) => e(t), fe = Symbol.for("@voltro/ai/Tool"), pe = (e) => ({
 		inputPer1M: .1,
 		outputPer1M: .4
 	}
-}, F = {}, Ae = (e) => {
+}, F = {}, je = (e) => {
 	let t = F;
 	return F = { ...e }, t;
-}, je = () => ({
-	...ke,
+}, Me = () => ({
+	...Ae,
 	...F
-}), Me = (e) => {
-	let t = je();
+}), Ne = (e) => {
+	let t = Me();
 	if (t[e] !== void 0) return t[e];
 	let n = e.indexOf("/");
 	if (n > 0) {
 		let r = e.slice(n + 1);
 		if (t[r] !== void 0) return t[r];
 	}
-}, Ne = (e) => typeof e.unit == "string", Pe = (e) => Ne(e) ? {
+}, I = (e) => typeof e.unit == "string", Pe = (e) => I(e) ? {
 	unit: e.unit,
 	input: e.input ?? 0,
 	output: e.output ?? 0
@@ -278,7 +278,7 @@ var de = (e, t) => e(t), fe = Symbol.for("@voltro/ai/Tool"), pe = (e) => ({
 	unit: "tokens",
 	input: e.inputTokens ?? 0,
 	output: e.outputTokens ?? 0
-}, I = (e, t) => {
+}, L = (e, t) => {
 	let { unit: n, input: r, output: i } = Pe(e);
 	if (t.actualCostUsd !== void 0) {
 		if (!Number.isFinite(t.actualCostUsd) || t.actualCostUsd < 0) throw RangeError("estimateCostUsd: actualCostUsd must be a finite, non-negative USD amount.");
@@ -302,7 +302,7 @@ var de = (e, t) => e(t), fe = Symbol.for("@voltro/ai/Tool"), pe = (e) => ({
 		costSource: "unpriced",
 		unit: n
 	};
-	let a = t.price ?? Me(t.model) ?? {
+	let a = t.price ?? Ne(t.model) ?? {
 		inputPer1M: 0,
 		outputPer1M: 0
 	}, o = r / 1e6 * a.inputPer1M, s = i / 1e6 * a.outputPer1M;
@@ -315,42 +315,59 @@ var de = (e, t) => e(t), fe = Symbol.for("@voltro/ai/Tool"), pe = (e) => ({
 		costSource: "estimated",
 		unit: n
 	};
-}, L = "_voltro_ai_usage", Fe = T(L, {
-	id: y({ prefix: "aiu" }),
+}, R = "_voltro_ai_usage", Fe = T(R, {
+	id: b({ prefix: "aiu" }),
 	tenantId: E().nullable(),
 	provider: E(),
 	model: E(),
 	operation: E(),
 	agent: E().nullable(),
-	inputTokens: b().default(0),
-	outputTokens: b().default(0),
-	costMicroUsd: b().default(0),
+	inputTokens: x().default(0),
+	outputTokens: x().default(0),
+	costMicroUsd: x().default(0),
 	costSource: E().default("estimated"),
 	unit: E().default("tokens"),
 	promptId: E().nullable(),
 	promptDigest: E().nullable(),
-	promptRevision: b().nullable(),
+	promptRevision: x().nullable(),
 	requestId: E().maxLength(191).nullable(),
-	attempt: b().nullable(),
+	attempt: x().nullable(),
 	receiptKey: E().maxLength(191).backfill((e) => `aiu-pre-receipt-${String(e.id)}`),
 	calledAt: D().default("now")
 }).index(["tenantId"]).index(["promptDigest"]).unique("byAiUsageReceipt", ["receiptKey"]), Ie = (e) => {
 	let t = e?.gateway?.cost, n = typeof t == "string" ? t.trim() : void 0, r = typeof t == "number" ? t : n !== void 0 && /^(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?$/i.test(n) ? Number(n) : NaN;
 	return Number.isFinite(r) && r >= 0 ? r : void 0;
-}, Le = (e, t) => (C({
+}, Le = class extends f.TaggedError("AiUsageReceiptConflict") {
+	get message() {
+		let e = Object.keys(this.recorded).filter((e) => this.recorded[e] !== this.attempted[e]).map((e) => `${e} ${String(this.recorded[e])} → ${String(this.attempted[e])}`);
+		return `AI usage receipt ${this.receiptKey} was recorded again with different values (${e.join(", ")}). A replay of the same paid call has the same values; the row keeps what was recorded first.`;
+	}
+}, Re = class extends f.TaggedError("AiUsageLedgerError") {
+	get message() {
+		return `AI usage receipt ${this.receiptKey} could not be written: ${this.cause instanceof Error ? this.cause.message : String(this.cause)}`;
+	}
+}, ze = (e) => ({
+	tenantId: e.tenantId ?? null,
+	provider: String(e.provider),
+	model: String(e.model),
+	operation: String(e.operation),
+	inputTokens: Number(e.inputTokens),
+	outputTokens: Number(e.outputTokens),
+	costMicroUsd: Number(e.costMicroUsd)
+}), Be = (e, t) => (w({
 	source: "plugin",
-	table: L,
+	table: R,
 	timeColumn: "calledAt",
-	ttlMs: w(process.env.VOLTRO_AI_USAGE_TTL_HOURS, 8760)
-}), f.promise(async () => {
-	let n = I(t.usage, {
+	ttlMs: oe(process.env.VOLTRO_AI_USAGE_TTL_HOURS, 8760)
+}), p.gen(function* () {
+	let n = L(t.usage, {
 		model: t.model,
 		...t.price === void 0 ? {} : { price: t.price },
 		...t.actualCostUsd === void 0 ? {} : { actualCostUsd: t.actualCostUsd }
-	}), r = t.receiptKey ?? (t.requestId === void 0 ? v({
+	}), r = t.receiptKey ?? (t.requestId === void 0 ? y({
 		kind: "typeid",
 		prefix: "aiu"
-	}, "_voltro_ai_usage") : `${t.requestId}#${t.attempt ?? 0}`), i = await e.insertIgnoreWithOutcome(L, {
+	}, "_voltro_ai_usage") : `${t.requestId}#${t.attempt ?? 0}`), i = {
 		tenantId: t.tenantId ?? null,
 		provider: t.provider,
 		model: t.model,
@@ -368,68 +385,110 @@ var de = (e, t) => e(t), fe = Symbol.for("@voltro/ai/Tool"), pe = (e) => ({
 		attempt: t.attempt ?? null,
 		receiptKey: r,
 		calledAt: t.calledAt ?? /* @__PURE__ */ new Date()
-	}, { conflictColumns: ["receiptKey"] });
-	return {
+	}, a = yield* p.tryPromise({
+		try: () => e.insertIgnoreWithOutcome(R, i, { conflictColumns: ["receiptKey"] }),
+		catch: (e) => new Re({
+			receiptKey: String(r),
+			cause: e
+		})
+	});
+	if (a.outcome === "inserted") return {
 		...n,
-		receipt: i.outcome === "inserted" ? "recorded" : "replayed"
+		receipt: "recorded"
+	};
+	let o = ze(a.row), s = ze(i);
+	return Object.keys(o).some((e) => o[e] !== s[e]) ? yield* p.fail(new Le({
+		receiptKey: String(r),
+		recorded: o,
+		attempted: s
+	})) : {
+		...Ve(a.row, n),
+		receipt: "replayed"
+	};
+})), Ve = (e, t) => {
+	let n = Number(e.costMicroUsd) / 1e6;
+	return {
+		...t,
+		inputTokens: Number(e.inputTokens),
+		outputTokens: Number(e.outputTokens),
+		totalCostUsd: n,
+		costSource: e.costSource ?? t.costSource
 	};
-})), Re = (e, t = {}) => f.promise(async () => {
+}, He = (e, t) => Be(e, t).pipe(p.asVoid, p.catchAllCause((e) => p.logError("AI usage NOT booked as recorded — the call itself succeeded and was returned", e).pipe(p.annotateLogs({
+	scope: "voltro:ai:usage",
+	provider: t.provider,
+	model: t.model,
+	operation: t.operation,
+	...I(t.usage) ? {
+		unit: t.usage.unit,
+		input: t.usage.input ?? null,
+		output: t.usage.output ?? null
+	} : {
+		inputTokens: t.usage.inputTokens ?? null,
+		outputTokens: t.usage.outputTokens ?? null
+	},
+	...t.requestId === void 0 ? {} : {
+		requestId: t.requestId,
+		attempt: t.attempt ?? 0
+	},
+	...t.actualCostUsd === void 0 ? {} : { actualCostUsd: t.actualCostUsd }
+})))), Ue = (e, t = {}) => p.promise(async () => {
 	let n = [
-		...t.tenantId === void 0 ? [] : [_("tenantId", t.tenantId)],
+		...t.tenantId === void 0 ? [] : [v("tenantId", t.tenantId)],
 		...t.since === void 0 ? [] : [ie("calledAt", t.since)],
-		...t.promptDigest === void 0 ? [] : [_("promptDigest", t.promptDigest)]
-	], r = S(Fe), i = n.length === 0 ? r : r.where(n.length === 1 ? n[0] : g(...n));
+		...t.promptDigest === void 0 ? [] : [v("promptDigest", t.promptDigest)]
+	], r = C(Fe), i = n.length === 0 ? r : r.where(n.length === 1 ? n[0] : _(...n));
 	return (await e.query(i.descriptor)).reduce((e, t) => e + (Number(t.costMicroUsd) || 0), 0) / 1e6;
-}), ze = ee.exponential({
+}), We = ee.exponential({
 	start: .001,
 	factor: 2,
 	count: 16
-}), R = m.counter("voltro_ai_calls_total", { description: "Total AI provider calls (generate + stream)." }), Be = m.counter("voltro_ai_call_errors_total", { description: "AI provider calls that errored." }), z = m.histogram("voltro_ai_call_duration_seconds", ze, "AI provider call duration in seconds."), Ve = m.counter("voltro_ai_input_tokens_total", {
+}), z = h.counter("voltro_ai_calls_total", { description: "Total AI provider calls (generate + stream)." }), Ge = h.counter("voltro_ai_call_errors_total", { description: "AI provider calls that errored." }), B = h.histogram("voltro_ai_call_duration_seconds", We, "AI provider call duration in seconds."), Ke = h.counter("voltro_ai_input_tokens_total", {
 	description: "Total prompt (input) tokens across AI calls.",
 	incremental: !0
-}), He = m.counter("voltro_ai_output_tokens_total", {
+}), qe = h.counter("voltro_ai_output_tokens_total", {
 	description: "Total completion (output) tokens across AI calls.",
 	incremental: !0
-}), Ue = m.counter("voltro_ai_cost_microusd_total", {
+}), Je = h.counter("voltro_ai_cost_microusd_total", {
 	description: "Total estimated AI spend in micro-USD (USD × 1e6).",
 	incremental: !0
-}), B = (e, t) => ({
+}), V = (e, t) => ({
 	provider: e.name,
 	model: e.model ?? e.name,
 	operation: t
-}), V = (e, t, n) => e.pipe(f.tagMetrics("provider", t.provider), f.tagMetrics("model", t.model), f.tagMetrics("operation", t.operation), f.tagMetrics("status", n)), We = (e, t) => {
-	let n = t.inputTokens ?? 0, r = t.outputTokens ?? 0, i = I({
+}), H = (e, t, n) => e.pipe(p.tagMetrics("provider", t.provider), p.tagMetrics("model", t.model), p.tagMetrics("operation", t.operation), p.tagMetrics("status", n)), Ye = (e, t) => {
+	let n = t.inputTokens ?? 0, r = t.outputTokens ?? 0, i = L({
 		inputTokens: n,
 		outputTokens: r
 	}, { model: e.model }), a = Math.round(i.totalCostUsd * 1e6);
-	return f.all([
-		V(m.incrementBy(Ve, n), e, "ok"),
-		V(m.incrementBy(He, r), e, "ok"),
-		V(m.incrementBy(Ue, a), e, "ok")
+	return p.all([
+		H(h.incrementBy(Ke, n), e, "ok"),
+		H(h.incrementBy(qe, r), e, "ok"),
+		H(h.incrementBy(Je, a), e, "ok")
 	], { discard: !0 });
-}, H = (e, t, n) => f.gen(function* () {
-	let r = yield* f.clockWith((e) => e.currentTimeMillis);
-	return yield* n.pipe(f.tap((n) => We(e, t(n))), f.tap(() => V(m.increment(R), e, "ok").pipe(f.zipRight(f.clockWith((e) => e.currentTimeMillis).pipe(f.flatMap((t) => V(m.update(z, (t - r) / 1e3), e, "ok")))))), f.tapError(() => V(m.increment(R), e, "error").pipe(f.zipRight(V(m.increment(Be), e, "error")), f.zipRight(f.clockWith((e) => e.currentTimeMillis).pipe(f.flatMap((t) => V(m.update(z, (t - r) / 1e3), e, "error")))))), f.withSpan("voltro.ai.call", { attributes: {
+}, U = (e, t, n) => p.gen(function* () {
+	let r = yield* p.clockWith((e) => e.currentTimeMillis);
+	return yield* n.pipe(p.tap((n) => Ye(e, t(n))), p.tap(() => H(h.increment(z), e, "ok").pipe(p.zipRight(p.clockWith((e) => e.currentTimeMillis).pipe(p.flatMap((t) => H(h.update(B, (t - r) / 1e3), e, "ok")))))), p.tapError(() => H(h.increment(z), e, "error").pipe(p.zipRight(H(h.increment(Ge), e, "error")), p.zipRight(p.clockWith((e) => e.currentTimeMillis).pipe(p.flatMap((t) => H(h.update(B, (t - r) / 1e3), e, "error")))))), p.withSpan("voltro.ai.call", { attributes: {
 		"ai.provider": e.provider,
 		"ai.model": e.model,
 		"ai.operation": e.operation
 	} }));
-}), Ge = (e, t) => {
+}), Xe = (e, t) => {
 	let n = Date.now();
-	return t.pipe(ne.tap((t) => t._tag === "done" ? V(m.increment(R), e, "ok").pipe(f.zipRight(V(m.update(z, (Date.now() - n) / 1e3), e, "ok")), f.zipRight(We(e, t.usage ?? {}))) : t._tag === "error" ? V(m.increment(R), e, "error").pipe(f.zipRight(V(m.increment(Be), e, "error")), f.zipRight(V(m.update(z, (Date.now() - n) / 1e3), e, "error"))) : f.void), ne.withSpan("voltro.ai.call", { attributes: {
+	return t.pipe(ne.tap((t) => t._tag === "done" ? H(h.increment(z), e, "ok").pipe(p.zipRight(H(h.update(B, (Date.now() - n) / 1e3), e, "ok")), p.zipRight(Ye(e, t.usage ?? {}))) : t._tag === "error" ? H(h.increment(z), e, "error").pipe(p.zipRight(H(h.increment(Ge), e, "error")), p.zipRight(H(h.update(B, (Date.now() - n) / 1e3), e, "error"))) : p.void), ne.withSpan("voltro.ai.call", { attributes: {
 		"ai.provider": e.provider,
 		"ai.model": e.model,
 		"ai.operation": e.operation
 	} }));
-}, Ke = (e) => {
+}, Ze = (e) => {
 	let t = structuredClone(e), n = {
 		strict: !0,
 		strictTypes: !1,
 		strictTuples: !1,
 		strictRequired: !1,
 		allowUnionTypes: !0
-	}, r = t.$schema, i = r === "https://json-schema.org/draft/2020-12/schema" ? new ce(n) : r === "https://json-schema.org/draft/2019-09/schema" ? new se(n) : new oe(n);
-	le(i);
+	}, r = t.$schema, i = r === "https://json-schema.org/draft/2020-12/schema" ? new le(n) : r === "https://json-schema.org/draft/2019-09/schema" ? new ce(n) : new se(n);
+	ue(i);
 	let a = i.compile(t);
 	if ("$async" in a && a.$async === !0) throw Error("asynchronous output schemas are not supported");
 	return c(t, { validate: (e) => a(e) ? {
@@ -439,25 +498,25 @@ var de = (e, t) => e(t), fe = Symbol.for("@voltro/ai/Tool"), pe = (e) => ({
 		success: !1,
 		error: /* @__PURE__ */ Error("model output does not satisfy the declared JSON Schema")
 	} });
-}, U = h.Number.pipe(h.int(), h.nonNegative(), h.lessThanOrEqualTo(2 ** 53 - 1)), qe = h.Struct({
-	provider: h.String,
-	model: h.String,
-	usage: h.Struct({
-		inputTokens: h.optional(U),
-		outputTokens: h.optional(U),
-		totalTokens: h.optional(U),
-		completeness: h.Literal("complete", "partial", "unknown")
+}, W = g.Number.pipe(g.int(), g.nonNegative(), g.lessThanOrEqualTo(2 ** 53 - 1)), Qe = g.Struct({
+	provider: g.String,
+	model: g.String,
+	usage: g.Struct({
+		inputTokens: g.optional(W),
+		outputTokens: g.optional(W),
+		totalTokens: g.optional(W),
+		completeness: g.Literal("complete", "partial", "unknown")
 	}),
-	cost: h.Union(h.Struct({
-		status: h.Literal("actual"),
-		source: h.Literal("gateway"),
-		usd: h.Number.pipe(h.finite(), h.nonNegative())
-	}), h.Struct({
-		status: h.Literal("unknown"),
-		source: h.Literal("unreported")
+	cost: g.Union(g.Struct({
+		status: g.Literal("actual"),
+		source: g.Literal("gateway"),
+		usd: g.Number.pipe(g.finite(), g.nonNegative())
+	}), g.Struct({
+		status: g.Literal("unknown"),
+		source: g.Literal("unreported")
 	}))
-}), W = (e) => typeof e == "number" && Number.isSafeInteger(e) && e >= 0 ? e : void 0, G = (e, t, n, r) => {
-	let i = typeof n == "object" && n ? n : {}, a = W("inputTokens" in i ? i.inputTokens : void 0), o = W("outputTokens" in i ? i.outputTokens : void 0), s = W("totalTokens" in i ? i.totalTokens : void 0), c = [
+}), G = (e) => typeof e == "number" && Number.isSafeInteger(e) && e >= 0 ? e : void 0, K = (e, t, n, r) => {
+	let i = typeof n == "object" && n ? n : {}, a = G("inputTokens" in i ? i.inputTokens : void 0), o = G("outputTokens" in i ? i.outputTokens : void 0), s = G("totalTokens" in i ? i.totalTokens : void 0), c = [
 		a,
 		o,
 		s
@@ -480,26 +539,45 @@ var de = (e, t) => e(t), fe = Symbol.for("@voltro/ai/Tool"), pe = (e) => ({
 			usd: l
 		}
 	};
-}, K = class extends h.TaggedError()("AiError", {
-	reason: h.Literal("generation", "decode"),
-	message: h.String,
-	evidence: h.optional(qe)
-}) {}, q = (e, t, n) => {
-	let r = [e, ...t ?? []], i = (e) => n(r[e]).pipe(f.catchTag("AiError", (t) => t.reason === "generation" && e + 1 < r.length ? i(e + 1) : f.fail(t)));
+}, q = class extends g.TaggedError()("AiError", {
+	reason: g.Literal("generation", "decode"),
+	message: g.String,
+	evidence: g.optional(Qe)
+}) {}, J = (e, t = {}) => {
+	let n = String(e?.message ?? e), r = $e(e), i = new q({
+		reason: "generation",
+		message: `${t.prefix === void 0 ? "" : `${t.prefix}: `}${n}${r.length > 0 ? ` (${r.join(" <- ")})` : ""}`,
+		...t.evidence === void 0 ? {} : { evidence: t.evidence }
+	});
+	return Object.defineProperty(i, "cause", {
+		value: e,
+		enumerable: !1,
+		configurable: !0,
+		writable: !0
+	}), i;
+}, $e = (e) => {
+	let t = [], n = e;
+	for (let e = 0; e < 8 && typeof n == "object" && n; e++) {
+		let e = n;
+		typeof e.code == "string" && e.code.length > 0 && !t.includes(e.code) && t.push(e.code), n = typeof e.lastError == "object" && e.lastError !== null ? e.lastError : e.cause;
+	}
+	return t;
+}, et = (e, t, n) => {
+	let r = [e, ...t ?? []], i = (e) => n(r[e]).pipe(p.catchTag("AiError", (t) => t.reason === "generation" && e + 1 < r.length ? i(e + 1) : p.fail(t)));
 	return i(0);
-}, Je = (e) => f.gen(function* () {
+}, tt = (e) => p.gen(function* () {
 	let r = e.messages === void 0 ? e.prompt === void 0 ? void 0 : { prompt: e.prompt } : { messages: [...e.messages] };
-	if (r === void 0 || e.prompt !== void 0 && e.messages !== void 0) return yield* f.fail(new K({
+	if (r === void 0 || e.prompt !== void 0 && e.messages !== void 0) return yield* p.fail(new q({
 		reason: "generation",
 		message: "generateText: supply exactly one of prompt or messages"
 	}));
-	let i = e.tools === void 0 ? void 0 : yield* f.runtime(), a = e.tools === void 0 || i === void 0 ? void 0 : O(e.tools, {
+	let i = e.tools === void 0 ? void 0 : yield* p.runtime(), a = e.tools === void 0 || i === void 0 ? void 0 : O(e.tools, {
 		store: void 0,
 		...e.toolContext,
 		...e.abortSignal === void 0 ? {} : { abortSignal: e.abortSignal },
 		runtime: i
 	});
-	return yield* q(e.provider ?? n(), e.fallbacks, (n) => H(B(n, "generateText"), (e) => e.usage, f.tryPromise({
+	return yield* et(e.provider ?? n(), e.fallbacks, (n) => U(V(n, "generateText"), (e) => e.usage, p.tryPromise({
 		try: async () => {
 			let i = t(n), o = await s({
 				model: i,
@@ -525,29 +603,26 @@ var de = (e, t) => e(t), fe = Symbol.for("@voltro/ai/Tool"), pe = (e) => ({
 				providerMetadata: o.providerMetadata
 			};
 		},
-		catch: (e) => new K({
-			reason: "generation",
-			message: String(e?.message ?? e)
-		})
+		catch: (e) => J(e)
 	})));
-}), J = (e, t) => f.gen(function* () {
-	let n = p.make(e);
+}), nt = (e, t) => p.gen(function* () {
+	let n = m.make(e);
 	if (n?.type !== "object") {
 		let e = n?.anyOf === void 0 ? `type:${JSON.stringify(n?.type ?? null)}` : "anyOf (e.g. Schema.Struct({}) or a union)";
-		return yield* f.fail(new K({
+		return yield* p.fail(new q({
 			reason: "generation",
 			message: `${t}: the output schema must render as a top-level JSON object (type:"object"), but got ${e}. Use a Schema.Struct({ ... }) as the output schema — wrap arrays/scalars in a field (e.g. Schema.Struct({ items: Schema.Array(...) })).`
 		}));
 	}
 	return n;
-}), Ye = (e, t) => J(e, t), Xe = (e) => q(e.provider ?? n(), e.fallbacks, (n) => H(B(n, "generateObject"), (e) => e.usage, f.gen(function* () {
-	let i = yield* f.try({
-		try: () => Ke(e.jsonSchema),
-		catch: () => new K({
+}), rt = (e, t) => nt(e, t), it = (e) => et(e.provider ?? n(), e.fallbacks, (n) => U(V(n, "generateObject"), (e) => e.usage, p.gen(function* () {
+	let i = yield* p.try({
+		try: () => Ze(e.jsonSchema),
+		catch: () => new q({
 			reason: "decode",
 			message: "generateObjectJson: invalid or unsupported output JSON Schema; no provider call was made"
 		})
-	}), a = t(n), s = yield* f.tryPromise({
+	}), a = t(n), s = yield* p.tryPromise({
 		try: () => o({
 			model: a,
 			schema: i,
@@ -557,19 +632,18 @@ var de = (e, t) => e(t), fe = Symbol.for("@voltro/ai/Tool"), pe = (e) => ({
 			...e.temperature === void 0 ? {} : { temperature: e.temperature },
 			...e.providerOptions === void 0 ? {} : { providerOptions: e.providerOptions }
 		}),
-		catch: (e) => r.isInstance(e) ? new K({
+		catch: (e) => r.isInstance(e) ? new q({
 			reason: "decode",
 			message: "model output failed JSON Schema validation",
-			evidence: G(n.name, a.modelId, e.usage)
-		}) : new K({
-			reason: "generation",
-			message: "structured provider call failed",
-			evidence: G(n.name, a.modelId, void 0)
+			evidence: K(n.name, a.modelId, e.usage)
+		}) : J(e, {
+			prefix: "structured provider call failed",
+			evidence: K(n.name, a.modelId, void 0)
 		})
 	});
 	return {
 		object: s.object,
-		evidence: G(n.name, a.modelId, s.usage, s.providerMetadata),
+		evidence: K(n.name, a.modelId, s.usage, s.providerMetadata),
 		usage: {
 			inputTokens: s.usage.inputTokens,
 			outputTokens: s.usage.outputTokens,
@@ -577,9 +651,9 @@ var de = (e, t) => e(t), fe = Symbol.for("@voltro/ai/Tool"), pe = (e) => ({
 		},
 		providerMetadata: s.providerMetadata
 	};
-}))), Ze = (e) => f.gen(function* () {
-	let t = yield* Xe({
-		jsonSchema: yield* J(e.schema, "generateObject"),
+}))), at = (e) => p.gen(function* () {
+	let t = yield* it({
+		jsonSchema: yield* nt(e.schema, "generateObject"),
 		prompt: e.prompt,
 		...e.system === void 0 ? {} : { system: e.system },
 		...e.provider === void 0 ? {} : { provider: e.provider },
@@ -587,7 +661,7 @@ var de = (e, t) => e(t), fe = Symbol.for("@voltro/ai/Tool"), pe = (e) => ({
 		...e.maxTokens === void 0 ? {} : { maxTokens: e.maxTokens },
 		...e.temperature === void 0 ? {} : { temperature: e.temperature },
 		...e.providerOptions === void 0 ? {} : { providerOptions: e.providerOptions }
-	}), n = yield* h.decodeUnknown(e.schema)(t.object).pipe(f.mapError(() => new K({
+	}), n = yield* g.decodeUnknown(e.schema)(t.object).pipe(p.mapError(() => new q({
 		reason: "decode",
 		message: "model output failed schema decode",
 		evidence: t.evidence
@@ -596,15 +670,15 @@ var de = (e, t) => e(t), fe = Symbol.for("@voltro/ai/Tool"), pe = (e) => ({
 		...t,
 		object: n
 	};
-}), Qe = (e) => f.gen(function* () {
-	let a = yield* f.runtime(), o = yield* J(e.schema, "generateObjectWithTools"), u = {
+}), ot = (e) => p.gen(function* () {
+	let a = yield* p.runtime(), o = yield* nt(e.schema, "generateObjectWithTools"), u = {
 		store: void 0,
 		...e.toolContext,
 		...e.abortSignal === void 0 ? {} : { abortSignal: e.abortSignal },
 		runtime: a
 	}, d = O(e.tools, u);
-	return yield* q(e.provider ?? n(), e.fallbacks, (n) => H(B(n, "generateObjectWithTools"), (e) => e.usage, f.gen(function* () {
-		let a = t(n), u = yield* f.tryPromise({
+	return yield* et(e.provider ?? n(), e.fallbacks, (n) => U(V(n, "generateObjectWithTools"), (e) => e.usage, p.gen(function* () {
+		let a = t(n), u = yield* p.tryPromise({
 			try: () => s({
 				model: a,
 				prompt: e.prompt,
@@ -617,42 +691,41 @@ var de = (e, t) => e(t), fe = Symbol.for("@voltro/ai/Tool"), pe = (e) => ({
 				...e.temperature === void 0 ? {} : { temperature: e.temperature },
 				...e.providerOptions === void 0 ? {} : { providerOptions: e.providerOptions }
 			}),
-			catch: (e) => r.isInstance(e) ? new K({
+			catch: (e) => r.isInstance(e) ? new q({
 				reason: "decode",
 				message: "model output failed structured decode",
-				evidence: G(n.name, a.modelId, e.usage)
-			}) : new K({
-				reason: "generation",
-				message: "structured provider call failed",
-				evidence: G(n.name, a.modelId, void 0)
+				evidence: K(n.name, a.modelId, e.usage)
+			}) : J(e, {
+				prefix: "structured provider call failed",
+				evidence: K(n.name, a.modelId, void 0)
 			})
-		}), p = u.totalUsage, m = G(n.name, a.modelId, p, u.steps.length === 1 ? u.providerMetadata : void 0), ee = yield* f.try({
+		}), f = u.totalUsage, m = K(n.name, a.modelId, f, u.steps.length === 1 ? u.providerMetadata : void 0), h = yield* p.try({
 			try: () => u.output,
-			catch: () => new K({
+			catch: () => new q({
 				reason: "decode",
 				message: "model output failed structured decode",
 				evidence: m
 			})
 		});
 		return {
-			object: yield* h.decodeUnknown(e.schema)(ee).pipe(f.mapError(() => new K({
+			object: yield* g.decodeUnknown(e.schema)(h).pipe(p.mapError(() => new q({
 				reason: "decode",
 				message: "model output failed schema decode",
 				evidence: m
 			}))),
 			evidence: m,
 			usage: {
-				inputTokens: p.inputTokens,
-				outputTokens: p.outputTokens,
-				totalTokens: p.totalTokens
+				inputTokens: f.inputTokens,
+				outputTokens: f.outputTokens,
+				totalTokens: f.totalTokens
 			},
 			providerMetadata: u.providerMetadata
 		};
 	})));
-}), $e = class extends d.Tag("@voltro/AiService")() {}, et = {
-	generateText: (e) => Je(e),
-	generateObject: (e) => Ze(e)
-}, tt = async (e, t) => {
+}), st = class extends d.Tag("@voltro/AiService")() {}, ct = {
+	generateText: (e) => tt(e),
+	generateObject: (e) => at(e)
+}, lt = async (e, t) => {
 	if ("bytes" in e) return {
 		audio: e.bytes,
 		mediaType: e.mediaType
@@ -672,7 +745,7 @@ var de = (e, t) => e(t), fe = Symbol.for("@voltro/ai/Tool"), pe = (e) => ({
 		audio: n,
 		mediaType: r
 	};
-}, nt = (e) => {
+}, ut = (e) => {
 	if (!Array.isArray(e) || e.length === 0) return;
 	let t = [];
 	for (let n of e) {
@@ -687,16 +760,16 @@ var de = (e, t) => e(t), fe = Symbol.for("@voltro/ai/Tool"), pe = (e) => ({
 		});
 	}
 	return t.length > 0 ? t : void 0;
-}, rt = (t) => {
+}, dt = (t) => {
 	let r = t.provider ?? n();
-	return H(B(r, "transcribe"), () => ({}), f.tryPromise({
+	return U(V(r, "transcribe"), () => ({}), p.tryPromise({
 		try: async () => {
-			let { audio: n, mediaType: i } = await tt(t.source, t.resolveRef), o = await a({
+			let { audio: n, mediaType: i } = await lt(t.source, t.resolveRef), o = await a({
 				model: e(r),
 				audio: n,
 				...i === void 0 ? {} : { mediaType: i },
 				...t.providerOptions === void 0 ? {} : { providerOptions: t.providerOptions }
-			}), s = t.timestamps === "none" ? void 0 : nt(o.segments);
+			}), s = t.timestamps === "none" ? void 0 : ut(o.segments);
 			return {
 				text: o.text,
 				...o.language === void 0 ? {} : { language: o.language },
@@ -705,37 +778,34 @@ var de = (e, t) => e(t), fe = Symbol.for("@voltro/ai/Tool"), pe = (e) => ({
 				...o.providerMetadata === void 0 ? {} : { providerMetadata: o.providerMetadata }
 			};
 		},
-		catch: (e) => new K({
-			reason: "generation",
-			message: String(e?.message ?? e)
-		})
+		catch: (e) => J(e)
 	}));
-}, it = (e) => `sha256:${ue("sha256").update(e).digest("hex").slice(0, 16)}`, at = class extends h.TaggedError()("PromptRenderError", {
-	promptId: h.String,
-	missing: h.Array(h.String),
-	message: h.String
-}) {}, ot = /\{\{\s*([A-Za-z0-9_.]+)\s*\}\}/g, st = (e) => {
+}, ft = (e) => `sha256:${de("sha256").update(e).digest("hex").slice(0, 16)}`, pt = class extends g.TaggedError()("PromptRenderError", {
+	promptId: g.String,
+	missing: g.Array(g.String),
+	message: g.String
+}) {}, mt = /\{\{\s*([A-Za-z0-9_.]+)\s*\}\}/g, ht = (e) => {
 	let t = /* @__PURE__ */ new Set();
-	for (let n of e.matchAll(ot)) {
+	for (let n of e.matchAll(mt)) {
 		let e = n[1];
 		e !== void 0 && t.add(e);
 	}
 	return [...t];
-}, ct = (e, t) => it(`${e.length}:${e}${(t ?? "").length}:${t ?? ""}`), lt = (e) => {
-	let t = ct(e.template, e.system), n = st(e.template);
+}, gt = (e, t) => ft(`${e.length}:${e}${(t ?? "").length}:${t ?? ""}`), _t = (e) => {
+	let t = gt(e.template, e.system), n = ht(e.template);
 	return {
 		...e,
 		digest: t,
 		variables: n,
-		render: (r = {}) => f.suspend(() => {
+		render: (r = {}) => p.suspend(() => {
 			let i = n.filter((e) => r[e] === void 0);
-			if (i.length > 0) return f.fail(new at({
+			if (i.length > 0) return p.fail(new pt({
 				promptId: e.id,
 				missing: i,
 				message: `prompt '${e.id}' needs ${i.map((e) => `{{${e}}}`).join(", ")}, which ${i.length === 1 ? "was" : "were"} not supplied.`
 			}));
-			let a = e.template.replace(ot, (e, t) => String(r[t]));
-			return f.succeed({
+			let a = e.template.replace(mt, (e, t) => String(r[t]));
+			return p.succeed({
 				promptId: e.id,
 				digest: t,
 				...e.label === void 0 ? {} : { label: e.label },
@@ -745,23 +815,23 @@ var de = (e, t) => e(t), fe = Symbol.for("@voltro/ai/Tool"), pe = (e) => ({
 			});
 		})
 	};
-}, ut = (e) => typeof e == "object" && !!e && typeof e.prompt == "string" && typeof e.digest == "string" && typeof e.promptId == "string", Y = "_voltro_prompts", X = T(Y, {
-	id: y({ prefix: "prm" }),
+}, vt = (e) => typeof e == "object" && !!e && typeof e.prompt == "string" && typeof e.digest == "string" && typeof e.promptId == "string", Y = "_voltro_prompts", X = T(Y, {
+	id: b({ prefix: "prm" }),
 	promptId: E().maxLength(191),
 	digest: E().maxLength(191),
-	revision: b().default(1),
+	revision: x().default(1),
 	label: E().nullable(),
 	template: E().nullable(),
 	system: E().nullable(),
-	templateChars: b().default(0),
+	templateChars: x().default(0),
 	firstSeenAt: D().default("now"),
 	lastUsedAt: D().default("now")
-}).unique("byPromptsVersion", ["promptId", "digest"]).index(["promptId"]), dt = 8760, ft = () => {
-	C({
+}).unique("byPromptsVersion", ["promptId", "digest"]).index(["promptId"]), yt = 8760, bt = () => {
+	w({
 		source: "framework",
 		table: Y,
 		timeColumn: "lastUsedAt",
-		ttlMs: w(process.env.VOLTRO_AI_PROMPTS_TTL_HOURS, dt),
+		ttlMs: oe(process.env.VOLTRO_AI_PROMPTS_TTL_HOURS, yt),
 		envVar: "VOLTRO_AI_PROMPTS_TTL_HOURS",
 		label: "ai prompt versions"
 	});
@@ -774,20 +844,20 @@ var de = (e, t) => e(t), fe = Symbol.for("@voltro/ai/Tool"), pe = (e) => ({
 	system: e.system ?? null,
 	firstSeenAt: e.firstSeenAt ?? null,
 	lastUsedAt: e.lastUsedAt ?? null
-}), pt = (e, t) => f.gen(function* () {
-	ft();
-	let n = t.digest ?? lt(t).digest;
-	return yield* f.promise(async () => {
-		let r = (await e.query(S(X).where(g(_("promptId", t.id), _("digest", n))).descriptor))[0];
+}), xt = (e, t) => p.gen(function* () {
+	bt();
+	let n = t.digest ?? _t(t).digest;
+	return yield* p.promise(async () => {
+		let r = (await e.query(C(X).where(_(v("promptId", t.id), v("digest", n))).descriptor))[0];
 		if (r !== void 0) {
 			let t = /* @__PURE__ */ new Date();
-			return await e.updateMany(Y, { lastUsedAt: t }, { where: _("id", String(r.id)) }), Z({
+			return await e.updateMany(Y, { lastUsedAt: t }, { where: v("id", String(r.id)) }), Z({
 				...r,
 				lastUsedAt: t
 			});
 		}
-		let i = (await e.query(S(X).where(_("promptId", t.id)).descriptor)).reduce((e, t) => Math.max(e, Number(t.revision) || 0), 0) + 1, a = /* @__PURE__ */ new Date(), o = {
-			id: v({
+		let i = (await e.query(C(X).where(v("promptId", t.id)).descriptor)).reduce((e, t) => Math.max(e, Number(t.revision) || 0), 0) + 1, a = /* @__PURE__ */ new Date(), o = {
+			id: y({
 				kind: "typeid",
 				prefix: "prm"
 			}, Y),
@@ -803,11 +873,11 @@ var de = (e, t) => e(t), fe = Symbol.for("@voltro/ai/Tool"), pe = (e) => ({
 		};
 		return Z(await e.insertIgnore(Y, o, { conflictColumns: ["promptId", "digest"] }) ?? o);
 	});
-}), mt = (e, t) => f.promise(async () => {
-	let n = (await e.query(S(X).where(_("digest", t)).descriptor))[0];
+}), St = (e, t) => p.promise(async () => {
+	let n = (await e.query(C(X).where(v("digest", t)).descriptor))[0];
 	return n === void 0 ? null : Z(n);
-}), ht = (e, t) => f.promise(async () => [...await e.query(S(X).where(_("promptId", t)).orderBy("revision", "desc").descriptor)].sort((e, t) => (Number(t.revision) || 0) - (Number(e.revision) || 0)).map(Z)), gt = "_voltro_ai_inferences", _t = T(gt, {
-	id: y({ prefix: "aiinf" }),
+}), Ct = (e, t) => p.promise(async () => [...await e.query(C(X).where(v("promptId", t)).orderBy("revision", "desc").descriptor)].sort((e, t) => (Number(t.revision) || 0) - (Number(e.revision) || 0)).map(Z)), wt = "_voltro_ai_inferences", Tt = T(wt, {
+	id: b({ prefix: "aiinf" }),
 	tenantId: E().nullable(),
 	executionId: E(),
 	workflowName: E(),
@@ -832,26 +902,35 @@ var de = (e, t) => e(t), fe = Symbol.for("@voltro/ai/Tool"), pe = (e) => ({
 	system: E().nullable(),
 	promptId: E().nullable(),
 	promptDigest: E().nullable(),
-	promptRevision: b().nullable(),
-	maxTokens: b().nullable(),
-	providerOptions: x().nullable(),
-	jsonSchema: x().nullable(),
-	transcription: x().nullable(),
-	media: x().nullable(),
-	result: x().nullable(),
+	promptRevision: x().nullable(),
+	maxTokens: x().nullable(),
+	providerOptions: S().nullable(),
+	jsonSchema: S().nullable(),
+	transcription: S().nullable(),
+	media: S().nullable(),
+	taskHandle: S().nullable(),
+	taskSubmittedAt: D().nullable(),
+	result: S().nullable(),
 	errorMessage: E().nullable(),
-	attempts: b().default(0),
-	fence: b().default(0),
+	attempts: x().default(0),
+	fence: x().default(0),
 	leaseUntil: D().nullable(),
 	claimedBy: E().nullable(),
 	enqueuedAt: D().default("now"),
 	startedAt: D().nullable(),
 	completedAt: D().nullable(),
-	durationMs: b().nullable()
-}).index(["status", "enqueuedAt"]).index(["status", "leaseUntil"]).index(["executionId"]).index(["tenantId"]), vt = 3e5, yt = 4, Q = (e, t) => {
+	durationMs: x().nullable()
+}).index(["status", "enqueuedAt"]).index(["status", "leaseUntil"]).index(["executionId"]).index(["tenantId"]), Et = 3e5, Dt = 4, Q = (e, t) => {
 	let n = typeof e == "number" ? e : Number(e);
 	return Number.isFinite(n) ? Math.trunc(n) : t;
-}, $ = (e) => e == null ? null : String(e), bt = (e) => ({
+}, $ = (e) => e == null ? null : String(e), Ot = (e) => {
+	if (e instanceof Date) return e;
+	if (typeof e == "string" || typeof e == "number") {
+		let t = new Date(e);
+		return Number.isNaN(t.getTime()) ? null : t;
+	}
+	return null;
+}, kt = (e) => ({
 	id: String(e.id),
 	tenantId: $(e.tenantId),
 	executionId: String(e.executionId),
@@ -872,9 +951,11 @@ var de = (e, t) => e(t), fe = Symbol.for("@voltro/ai/Tool"), pe = (e) => ({
 	jsonSchema: e.jsonSchema ?? null,
 	transcription: e.transcription ?? null,
 	media: e.media ?? null,
+	taskHandle: typeof e.taskHandle == "object" ? e.taskHandle : null,
+	taskSubmittedAt: Ot(e.taskSubmittedAt),
 	attempts: Q(e.attempts, 0),
 	fence: Q(e.fence, 0)
-}), xt = (e) => {
+}), At = (e) => {
 	let t = e.attempts + 1;
 	return t >= e.maxAttempts ? {
 		kind: "give-up",
@@ -884,6 +965,6 @@ var de = (e, t) => e(t), fe = Symbol.for("@voltro/ai/Tool"), pe = (e) => ({
 		attempts: t,
 		delayMs: e.retryAfterMs !== void 0 && e.retryAfterMs > 0 ? e.retryAfterMs : Math.min(e.baseDelayMs * 2 ** (t - 1), e.maxDelayMs)
 	};
-}, St = (e) => `voltro.ai.infer:${e}`, Ct = (e, t) => `aiinf_${ue("sha256").update(`${e}\u0000${t}`).digest("hex").slice(0, 40)}`;
+}, jt = (e) => `voltro.ai.infer:${e}`, Mt = (e, t) => `aiinf_${de("sha256").update(`${e}\u0000${t}`).digest("hex").slice(0, 40)}`;
 //#endregion
-export { pe as $, B as A, je as B, et as C, Je as D, Qe as E, Re as F, j as G, Me as H, Fe as I, xe as J, A as K, I as L, H as M, L as N, Ye as O, ke as P, O as Q, Ie as R, $e as S, Xe as T, Le as U, Pe as V, Ae as W, Oe as X, M as Y, De as Z, ht as _, xt as a, rt as b, bt as c, at as d, me as et, lt as f, ct as g, mt as h, _t as i, Ge as j, qe as k, dt as l, it as m, yt as n, St as o, ut as p, k as q, vt as r, Ct as s, gt as t, he as tt, Y as u, X as v, Ze as w, K as x, pt as y, Ne as z };
+export { M as $, Qe as A, L as B, J as C, ot as D, it as E, Re as F, Ne as G, I as H, Le as I, je as J, Be as K, Ae as L, Xe as M, U as N, tt as O, R as P, Se as Q, Ue as R, st as S, at as T, Me as U, Ie as V, Pe as W, A as X, j as Y, k as Z, Ct as _, At as a, ge as at, dt as b, kt as c, pt as d, ke as et, _t as f, gt as g, St as h, Tt as i, he as it, V as j, rt as k, yt as l, ft as m, Dt as n, O as nt, jt as o, vt as p, He as q, Et as r, me as rt, Mt as s, wt as t, Oe as tt, Y as u, X as v, ct as w, q as x, xt as y, Fe as z };