@voltro/ai 0.84.0 → 0.86.0

package/dist/appTools.js

@@ -0,0 +1,80 @@
+import { defineTool as e } from "./tools.js";
+//#region src/appTools.ts
+var t = /* @__PURE__ */ new Map(), n = (e) => {
+	let n = t.get(e);
+	if (n !== void 0) return n;
+	let r = RegExp("^" + e.split("*").map((e) => e.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join(".*") + "$");
+	return t.size >= 256 && t.delete(t.keys().next().value), t.set(e, r), r;
+}, r = (e, t) => {
+	let n = t.lastIndex;
+	try {
+		return t.lastIndex = 0, t.test(e);
+	} finally {
+		t.lastIndex = n;
+	}
+}, i = (e, t) => t instanceof RegExp ? r(e, t) : t.some((t) => n(t).test(e)), a = (e, t) => !(t.deny !== void 0 && i(e, t.deny) || t.allow !== void 0 && !i(e, t.allow)), o = (e) => e === "mutation" || e === "action", s = (e) => ({
+	id: e,
+	via: "agent"
+}), c = (e, t) => {
+	let n = e.exposeAsTool;
+	if (n === void 0 || n === !1 || n === !0) return null;
+	let r = o(e.kind), i = n.confirm ?? (r && (t.requireConfirmForWrites ?? !0));
+	return {
+		description: n.description,
+		confirm: i,
+		...n.maxPerRun === void 0 ? {} : { maxPerRun: n.maxPerRun }
+	};
+}, l = (e, t) => {
+	if (!a(e.name, t)) return {
+		admitted: !1,
+		reason: "blocked by the allow/deny policy"
+	};
+	let n = c(e, t);
+	if (n === null) return {
+		admitted: !1,
+		reason: "not exposed as a tool (no `exposeAsTool: { description }` on the descriptor)"
+	};
+	let r = o(e.kind);
+	if (r && t.includeWrites !== !0) return {
+		admitted: !1,
+		reason: "a write tool, and includeWrites is not enabled"
+	};
+	let i = e.requiresApproval !== void 0 && e.requiresApproval !== null;
+	return n.confirm && !i ? {
+		admitted: !1,
+		reason: "the tool requires human confirmation (`confirm`) and nothing enforces it — add `requiresApproval: { approvers: [...] }` to the descriptor so the call parks as a durable approval, or set `exposeAsTool: { confirm: false }` if an agent may run it unattended"
+	} : {
+		admitted: !0,
+		spec: {
+			name: e.name,
+			kind: e.kind,
+			description: n.description,
+			write: r,
+			confirm: n.confirm,
+			approvalBacked: i,
+			...n.maxPerRun === void 0 ? {} : { maxPerRun: n.maxPerRun }
+		}
+	};
+}, u = (e, t = {}) => e.filter((e) => a(e.descriptor.name, t)).map((e) => ({
+	entry: e,
+	exposure: c(e.descriptor, t)
+})).filter((e) => e.exposure !== null).map(({ entry: e, exposure: t }) => ({
+	name: e.descriptor.name,
+	kind: e.descriptor.kind,
+	description: t.description,
+	write: o(e.descriptor.kind),
+	confirm: t.confirm,
+	approvalBacked: e.descriptor.requiresApproval !== void 0 && e.descriptor.requiresApproval !== null,
+	...t.maxPerRun === void 0 ? {} : { maxPerRun: t.maxPerRun }
+})).sort((e, t) => e.name.localeCompare(t.name)), d = (t, n = {}) => t.map((e) => ({
+	entry: e,
+	decision: l(e.descriptor, n)
+})).filter((e) => e.decision.admitted).map(({ entry: t, decision: n }) => e({
+	name: t.descriptor.name,
+	description: n.spec.description,
+	input: t.descriptor.input,
+	...t.descriptor.output === void 0 ? {} : { output: t.descriptor.output },
+	handler: (e) => Promise.resolve(t.invoke(e))
+}));
+//#endregion
+export { s as agentActor, l as appToolDecision, d as appTools, a as passesPolicy, u as synthesizeToolSpecs };

package/dist/budget.js

@@ -0,0 +1,201 @@
+import { Effect as e, Schema as t } from "effect";
+import { and as n, bigint as r, eq as i, generateId as a, id as o, isNull as s, queryFor as c, registerRetention as l, retentionTtlMsFromEnv as u, table as d, text as f, timestamp as p } from "@voltro/database";
+//#region src/budget.ts
+var m = class extends t.TaggedError()("AiBudgetExceeded", {
+	tenantId: t.NullOr(t.String),
+	limitUsd: t.Number,
+	spentUsd: t.Number,
+	attemptedUsd: t.Number
+}) {}, h = class extends t.TaggedError()("AiBudgetInvalidInput", {
+	field: t.Literals([
+		"limitUsd",
+		"addUsd",
+		"since",
+		"reservationId",
+		"tenantId"
+	]),
+	message: t.String
+}) {}, g = class extends t.TaggedError()("AiBudgetReservationConflict", {
+	reason: t.Literals(["identity-bound", "already-released"]),
+	message: t.String
+}) {}, _ = "_voltro_ai_budget", v = "_voltro_ai_budget_reservations", y = d(_, {
+	id: o({ prefix: "aib" }),
+	bucket: f().maxLength(191),
+	tenantId: f().nullable(),
+	reservedMicroUsd: r().default("0").narrowedFrom("integer"),
+	updatedAt: p().default("now")
+}).unique("byAiBudgetBucket", ["bucket"]), b = d(v, {
+	id: o({ prefix: "air" }),
+	reservationId: f().maxLength(191),
+	bucket: f().maxLength(191),
+	tenantId: f().nullable(),
+	amountMicroUsd: r(),
+	releasedAt: p().nullable(),
+	updatedAt: p().default("now")
+}).unique("byAiBudgetReservation", ["reservationId"]), x = class extends Error {}, S = (e, t, n) => {
+	if (!Number.isFinite(e) || e < 0) throw new h({
+		field: t,
+		message: `${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 new h({
+		field: t,
+		message: `${t} exceeds the safe micro-USD range`
+	});
+	return BigInt(i);
+}, C = (e) => {
+	if (typeof e == "number" && !Number.isSafeInteger(e)) throw Error("AI budget counter is not an exact integer");
+	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);
+}, w = (e) => {
+	if (typeof e != "string" || e.length === 0 || e.length > 191) throw new h({
+		field: "reservationId",
+		message: "AI budget reservationId must contain 1–191 characters"
+	});
+	return e;
+}, T = () => {
+	let e = u(process.env.VOLTRO_AI_USAGE_TTL_HOURS, 8760);
+	for (let t of [_, v]) l({
+		source: "plugin",
+		table: t,
+		timeColumn: "updatedAt",
+		ttlMs: e
+	});
+}, E = async (e, t) => {
+	for (let n = 0;; n++) try {
+		return await e.transactional(t);
+	} catch (e) {
+		if (!(e instanceof x) || n >= 31) throw e;
+		await new Promise((e) => setTimeout(e, n + 1));
+	}
+}, D = (t) => t instanceof m || t instanceof h || t instanceof g ? e.fail(t) : e.die(t), O = (t) => e.tryPromise({
+	try: t,
+	catch: (e) => e
+}).pipe(e.catch(D)), k = (t, r) => e.gen(function* () {
+	let { limit: o, amount: s, tenantId: l, bucket: u, reservationId: d } = yield* e.try({
+		try: () => {
+			let e = S(r.limitUsd, "limitUsd", "down"), t = S(r.addUsd ?? 0, "addUsd", "up"), n = r.tenantId ?? null;
+			if (r.since !== void 0 && (!(r.since instanceof Date) || !Number.isFinite(r.since.getTime()))) throw new h({
+				field: "since",
+				message: "AI budget since must be a valid Date"
+			});
+			let i = `${n ?? "global"}::${r.since === void 0 ? "all" : r.since.getTime()}`;
+			if (i.length > 191) throw new h({
+				field: "tenantId",
+				message: "AI budget tenant/window key exceeds 191 characters"
+			});
+			return {
+				limit: e,
+				amount: t,
+				tenantId: n,
+				bucket: i,
+				reservationId: w(r.reservationId ?? a({
+					kind: "typeid",
+					prefix: "air"
+				}, "_voltro_ai_budget_reservations"))
+			};
+		},
+		catch: (e) => e
+	}).pipe(e.catch(D));
+	T();
+	let f = async (e) => {
+		let [t] = await e.query(c(y).where(i("bucket", u)).descriptor);
+		if (t && t.tenantId !== l) throw Error("AI budget bucket belongs to a different tenant");
+		return t;
+	}, p = (e) => {
+		if (s === 0n ? e >= o : e + s > o) throw new m({
+			tenantId: l,
+			limitUsd: r.limitUsd,
+			spentUsd: Number(e) / 1e6,
+			attemptedUsd: r.addUsd ?? 0
+		});
+	};
+	return s === 0n ? yield* O(async () => {
+		let e = await f(t);
+		return p(e ? C(e.reservedMicroUsd) : 0n), null;
+	}) : yield* O(() => E(t, async (e) => {
+		let t = a({
+			kind: "typeid",
+			prefix: "air"
+		}, v), r = /* @__PURE__ */ new Date(), o = await e.insertIgnore(v, {
+			id: t,
+			reservationId: d,
+			bucket: u,
+			tenantId: l,
+			amountMicroUsd: String(s),
+			releasedAt: null,
+			updatedAt: r
+		}, { conflictColumns: ["reservationId"] });
+		if (o.id !== t) {
+			if (o.tenantId !== l || o.bucket !== u || C(o.amountMicroUsd) !== s) throw new g({
+				reason: "identity-bound",
+				message: "AI budget reservationId is already bound to another tenant, amount or window"
+			});
+			if (o.releasedAt !== null) throw new g({
+				reason: "already-released",
+				message: "AI budget reservation was released; new spend requires a new reservationId"
+			});
+			return {
+				reservationId: d,
+				tenantId: l,
+				amountMicroUsd: String(s),
+				status: "replayed"
+			};
+		}
+		let c = await f(e), m = c ? C(c.reservedMicroUsd) : 0n;
+		if (p(m), c) {
+			if (await e.updateMany("_voltro_ai_budget", {
+				reservedMicroUsd: String(m + s),
+				updatedAt: r
+			}, { where: n(i("id", c.id), i("reservedMicroUsd", c.reservedMicroUsd)) }) !== 1) throw new x("AI budget counter changed; discard this receipt and retry");
+		} else {
+			let t = a({
+				kind: "typeid",
+				prefix: "aib"
+			}, _);
+			if ((await e.insertIgnore("_voltro_ai_budget", {
+				id: t,
+				bucket: u,
+				tenantId: l,
+				reservedMicroUsd: String(s),
+				updatedAt: r
+			}, { conflictColumns: ["bucket"] })).id !== t) throw new x("AI budget counter was created concurrently; discard this receipt and retry");
+		}
+		return {
+			reservationId: d,
+			tenantId: l,
+			amountMicroUsd: String(s),
+			status: "reserved"
+		};
+	}));
+}), A = (t, r) => e.gen(function* () {
+	return yield* e.try({
+		try: () => w(r.reservationId),
+		catch: (e) => e
+	}).pipe(e.catch((t) => t instanceof h ? e.fail(t) : e.die(t))), yield* e.promise(() => E(t, async (e) => {
+		let t = c(b).where(n(i("reservationId", r.reservationId), r.tenantId === null ? s("tenantId") : i("tenantId", r.tenantId))).descriptor, [a] = await e.query(t);
+		if (!a) return "not-found";
+		if (a.releasedAt !== null) return "already-released";
+		let o = /* @__PURE__ */ new Date();
+		if (await e.updateMany("_voltro_ai_budget_reservations", {
+			releasedAt: o,
+			updatedAt: o
+		}, { where: n(i("id", a.id), s("releasedAt")) }) !== 1) {
+			let [n] = await e.query(t);
+			if (n !== void 0 && n.releasedAt !== null) return "already-released";
+			throw new x("AI budget release raced; retry");
+		}
+		let [l] = await e.query(c(y).where(i("bucket", a.bucket)).descriptor);
+		if (!l || l.tenantId !== r.tenantId) throw Error("AI budget counter missing or mismatched; refusing unproved credit");
+		let u = C(l.reservedMicroUsd), d = C(a.amountMicroUsd);
+		if (d > u) throw Error("AI budget receipt exceeds its counter; refusing unproved credit");
+		if (await e.updateMany("_voltro_ai_budget", {
+			reservedMicroUsd: String(u - d),
+			updatedAt: o
+		}, { where: n(i("id", l.id), i("reservedMicroUsd", l.reservedMicroUsd)) }) !== 1) throw new x("AI budget counter changed; discard this release and retry");
+		return "released";
+	}));
+});
+//#endregion
+export { v as AI_BUDGET_RESERVATIONS_TABLE, _ as AI_BUDGET_TABLE, m as AiBudgetExceeded, h as AiBudgetInvalidInput, g as AiBudgetReservationConflict, b as aiBudgetReservationsTable, y as aiBudgetTable, A as releaseAiBudget, k as requireAiBudget };

package/dist/callEvidence.js

@@ -0,0 +1,51 @@
+import { gatewayCostUsd as e } from "./cost.js";
+import { Schema as t } from "effect";
+//#region src/callEvidence.ts
+var n = t.Number.pipe(t.check(t.isInt()), t.check(t.isGreaterThanOrEqualTo(0)), t.check(t.isLessThanOrEqualTo(2 ** 53 - 1))), r = t.Struct({
+	provider: t.String,
+	model: t.String,
+	usage: t.Struct({
+		inputTokens: t.optional(n),
+		outputTokens: t.optional(n),
+		totalTokens: t.optional(n),
+		completeness: t.Literals([
+			"complete",
+			"partial",
+			"unknown"
+		])
+	}),
+	cost: t.Union([t.Struct({
+		status: t.Literal("actual"),
+		source: t.Literal("gateway"),
+		usd: t.Number.pipe(t.check(t.isFinite()), t.check(t.isGreaterThanOrEqualTo(0)))
+	}), t.Struct({
+		status: t.Literal("unknown"),
+		source: t.Literal("unreported")
+	})])
+}), i = (e) => typeof e == "number" && Number.isSafeInteger(e) && e >= 0 ? e : void 0, a = (t, n, r, a) => {
+	let o = typeof r == "object" && r ? r : {}, s = i("inputTokens" in o ? o.inputTokens : void 0), c = i("outputTokens" in o ? o.outputTokens : void 0), l = i("totalTokens" in o ? o.totalTokens : void 0), u = [
+		s,
+		c,
+		l
+	].filter((e) => e !== void 0).length, d = e(a);
+	return {
+		provider: t,
+		model: n,
+		usage: {
+			...s === void 0 ? {} : { inputTokens: s },
+			...c === void 0 ? {} : { outputTokens: c },
+			...l === void 0 ? {} : { totalTokens: l },
+			completeness: u === 3 ? "complete" : u === 0 ? "unknown" : "partial"
+		},
+		cost: d === void 0 ? {
+			status: "unknown",
+			source: "unreported"
+		} : {
+			status: "actual",
+			source: "gateway",
+			usd: d
+		}
+	};
+};
+//#endregion
+export { r as AiCallEvidenceSchema, a as normalizeAiCallEvidence };

package/dist/copilot.js

@@ -0,0 +1,126 @@
+import { Schema as e } from "effect";
+import { and as t, contains as n, eq as r, gt as i, gte as a, inSet as o, lt as s, lte as c, neq as l } from "@voltro/database";
+//#region src/copilot.ts
+var u = class extends e.TaggedError()("CopilotRejected", {
+	reason: e.Literals([
+		"unknown-table",
+		"unknown-column",
+		"bad-op",
+		"bad-aggregate",
+		"empty"
+	]),
+	detail: e.String
+}) {}, d = 200, f = 50, p = /* @__PURE__ */ new Set([
+	"eq",
+	"neq",
+	"gt",
+	"gte",
+	"lt",
+	"lte",
+	"contains",
+	"in"
+]), m = (e) => {
+	switch (e.op) {
+		case "eq": return r(e.column, e.value);
+		case "neq": return l(e.column, e.value);
+		case "gt": return i(e.column, e.value);
+		case "gte": return a(e.column, e.value);
+		case "lt": return s(e.column, e.value);
+		case "lte": return c(e.column, e.value);
+		case "contains": return n(e.column, e.value);
+		case "in": return o(e.column, Array.isArray(e.value) ? e.value : [e.value]);
+	}
+}, h = (e, t) => ({
+	ok: !1,
+	rejection: new u({
+		reason: e,
+		detail: t
+	})
+}), g = (e, n) => {
+	let r = n.tables.find((t) => t.name === e.table);
+	if (r === void 0) return h("unknown-table", e.table);
+	let i = new Set(r.columns.map((e) => e.name));
+	for (let t of e.columns ?? []) if (!i.has(t)) return h("unknown-column", `${e.table}.${t}`);
+	for (let t of e.filters ?? []) {
+		if (!p.has(t.op)) return h("bad-op", String(t.op));
+		if (!i.has(t.column)) return h("unknown-column", `${e.table}.${t.column}`);
+	}
+	if (e.orderBy !== void 0 && !i.has(e.orderBy.column)) return h("unknown-column", `${e.table}.${e.orderBy.column}`);
+	if (e.aggregate !== void 0) {
+		let { fn: t, column: n } = e.aggregate;
+		if (t !== "count" && (n === void 0 || !i.has(n))) return h("bad-aggregate", `${t}(${n ?? "∅"})`);
+	}
+	let a = e.filters ?? [], o = a.length === 0 ? void 0 : a.length === 1 ? m(a[0]) : t(...a.map(m)), s = Math.min(Math.max(1, e.limit ?? f), 200), c = {
+		table: e.table,
+		predicate: o,
+		order: e.orderBy ? [{
+			column: e.orderBy.column,
+			direction: e.orderBy.direction ?? "asc"
+		}] : [],
+		take: s,
+		skip: void 0,
+		projection: e.columns && e.columns.length > 0 ? [...e.columns] : void 0
+	};
+	return e.aggregate ? {
+		ok: !0,
+		descriptor: c,
+		table: e.table,
+		aggregate: e.aggregate
+	} : {
+		ok: !0,
+		descriptor: c,
+		table: e.table
+	};
+}, _ = e.Struct({
+	table: e.String,
+	columns: e.optional(e.Array(e.String)),
+	filters: e.optional(e.Array(e.Struct({
+		column: e.String,
+		op: e.Literals([
+			"eq",
+			"neq",
+			"gt",
+			"gte",
+			"lt",
+			"lte",
+			"contains",
+			"in"
+		]),
+		value: e.Unknown
+	}))),
+	orderBy: e.optional(e.Struct({
+		column: e.String,
+		direction: e.optional(e.Literals(["asc", "desc"]))
+	})),
+	limit: e.optional(e.Number),
+	aggregate: e.optional(e.Struct({
+		fn: e.Literals([
+			"count",
+			"sum",
+			"avg",
+			"min",
+			"max"
+		]),
+		column: e.optional(e.String)
+	}))
+}), v = (e) => [
+	"You are a data copilot. Translate the user question into a JSON query proposal.",
+	"",
+	"You may ONLY reference these tables and columns:",
+	e.tables.map((e) => `- ${e.name}(${e.columns.map((e) => e.name).join(", ")})`).join("\n"),
+	"",
+	"Rules:",
+	"- Pick EXACTLY ONE table from the list as `table`.",
+	"- Every column in `columns`, `filters`, `orderBy`, and `aggregate` MUST be one of that table's listed columns.",
+	"- NEVER invent a table or column. If the question cannot be answered from the listed schema, pick the closest table and leave filters empty.",
+	"- The query is READ-ONLY. You cannot insert, update, or delete.",
+	"- Keep the result small (limit ≤ 200)."
+].join("\n"), y = async (e, t, n) => {
+	let r = v(t);
+	return g(await n.propose({
+		system: r,
+		prompt: e
+	}), t);
+};
+//#endregion
+export { d as COPILOT_MAX_LIMIT, _ as CopilotProposalSchema, u as CopilotRejected, v as buildCopilotSystemPrompt, y as runDataCopilot, g as validateCopilotProposal };

package/dist/cost.js

@@ -0,0 +1,242 @@
+import { AI_BUDGET_RESERVATIONS_TABLE as e, AI_BUDGET_TABLE as t, AiBudgetExceeded as n, AiBudgetInvalidInput as r, AiBudgetReservationConflict as i, aiBudgetReservationsTable as a, aiBudgetTable as o, releaseAiBudget as s, requireAiBudget as c } from "./budget.js";
+import { Data as l, Effect as u } from "effect";
+import { and as d, eq as f, generateId as p, gte as m, id as h, integer as g, queryFor as _, registerRetention as v, retentionTtlMsFromEnv as y, table as b, text as x, timestamp as S } from "@voltro/database";
+//#region src/cost.ts
+var C = {
+	"claude-opus-4-8": {
+		inputPer1M: 15,
+		outputPer1M: 75
+	},
+	"claude-opus-4-6": {
+		inputPer1M: 15,
+		outputPer1M: 75
+	},
+	"claude-sonnet-4-6": {
+		inputPer1M: 3,
+		outputPer1M: 15
+	},
+	"claude-haiku-4-5": {
+		inputPer1M: 1,
+		outputPer1M: 5
+	},
+	"claude-haiku-4-5-20251001": {
+		inputPer1M: 1,
+		outputPer1M: 5
+	},
+	"gpt-5.5": {
+		inputPer1M: 5,
+		outputPer1M: 30
+	},
+	"gpt-4o": {
+		inputPer1M: 2.5,
+		outputPer1M: 10
+	},
+	"gpt-4o-mini": {
+		inputPer1M: .15,
+		outputPer1M: .6
+	},
+	"gemini-2.5-pro": {
+		inputPer1M: 1.25,
+		outputPer1M: 10
+	},
+	"gemini-2.5-flash": {
+		inputPer1M: .3,
+		outputPer1M: 2.5
+	},
+	"gemini-2.0-flash": {
+		inputPer1M: .1,
+		outputPer1M: .4
+	}
+}, w = {}, T = (e) => {
+	let t = w;
+	return w = { ...e }, t;
+}, E = () => ({
+	...C,
+	...w
+}), D = (e) => {
+	let t = E();
+	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];
+	}
+}, O = (e) => typeof e.unit == "string", k = (e) => O(e) ? {
+	unit: e.unit,
+	input: e.input ?? 0,
+	output: e.output ?? 0
+} : {
+	unit: "tokens",
+	input: e.inputTokens ?? 0,
+	output: e.outputTokens ?? 0
+}, A = (e, t) => {
+	let { unit: n, input: r, output: i } = k(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.");
+		let e = r + i, a = e > 0 ? r / e : 0;
+		return {
+			inputTokens: r,
+			outputTokens: i,
+			inputCostUsd: t.actualCostUsd * a,
+			outputCostUsd: t.actualCostUsd * (1 - a),
+			totalCostUsd: t.actualCostUsd,
+			costSource: "gateway",
+			unit: n
+		};
+	}
+	if (n !== "tokens" && t.price === void 0) return {
+		inputTokens: r,
+		outputTokens: i,
+		inputCostUsd: 0,
+		outputCostUsd: 0,
+		totalCostUsd: 0,
+		costSource: "unpriced",
+		unit: n
+	};
+	let a = t.price ?? D(t.model) ?? {
+		inputPer1M: 0,
+		outputPer1M: 0
+	}, o = r / 1e6 * a.inputPer1M, s = i / 1e6 * a.outputPer1M;
+	return {
+		inputTokens: r,
+		outputTokens: i,
+		inputCostUsd: o,
+		outputCostUsd: s,
+		totalCostUsd: o + s,
+		costSource: "estimated",
+		unit: n
+	};
+}, j = "_voltro_ai_usage", M = b(j, {
+	id: h({ prefix: "aiu" }),
+	tenantId: x().nullable(),
+	provider: x(),
+	model: x(),
+	operation: x(),
+	agent: x().nullable(),
+	inputTokens: g().default(0),
+	outputTokens: g().default(0),
+	costMicroUsd: g().default(0),
+	costSource: x().default("estimated"),
+	unit: x().default("tokens"),
+	promptId: x().nullable(),
+	promptDigest: x().nullable(),
+	promptRevision: g().nullable(),
+	requestId: x().maxLength(191).nullable(),
+	attempt: g().nullable(),
+	receiptKey: x().maxLength(191).backfill((e) => `aiu-pre-receipt-${String(e.id)}`),
+	calledAt: S().default("now")
+}).index(["tenantId"]).index(["promptDigest"]).unique("byAiUsageReceipt", ["receiptKey"]), N = (e) => {
+	let t = typeof e == "string" ? e.trim() : void 0, n = typeof e == "number" ? e : t !== void 0 && /^(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?$/i.test(t) ? Number(t) : NaN;
+	return Number.isFinite(n) && n >= 0 ? n : void 0;
+}, P = (e) => {
+	let t = e?.gateway, n = N(t?.cost);
+	if (n === void 0) return;
+	let r = (Array.isArray(t?.routing?.modelAttempts) ? t.routing.modelAttempts : []).findLast((e) => e?.success === !0);
+	if ((Array.isArray(r?.providerAttempts) ? r.providerAttempts : []).findLast((e) => e?.success === !0)?.credentialType !== "byok") return n;
+	let i = N(t?.marketCost);
+	return i === void 0 ? void 0 : n + i;
+}, F = class extends l.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.`;
+	}
+}, I = class extends l.TaggedError("AiUsageLedgerError") {
+	get message() {
+		return `AI usage receipt ${this.receiptKey} could not be written: ${this.cause instanceof Error ? this.cause.message : String(this.cause)}`;
+	}
+}, L = (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)
+}), R = (e, t) => (v({
+	source: "plugin",
+	table: j,
+	timeColumn: "calledAt",
+	ttlMs: y(process.env.VOLTRO_AI_USAGE_TTL_HOURS, 8760)
+}), u.gen(function* () {
+	let n = A(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 ? p({
+		kind: "typeid",
+		prefix: "aiu"
+	}, "_voltro_ai_usage") : `${t.requestId}#${t.attempt ?? 0}`), i = {
+		tenantId: t.tenantId ?? null,
+		provider: t.provider,
+		model: t.model,
+		operation: t.operation,
+		agent: t.agent ?? null,
+		inputTokens: n.inputTokens,
+		outputTokens: n.outputTokens,
+		costMicroUsd: Math.round(n.totalCostUsd * 1e6),
+		costSource: n.costSource,
+		unit: n.unit,
+		promptId: t.prompt?.promptId ?? null,
+		promptDigest: t.prompt?.digest ?? null,
+		promptRevision: t.prompt?.revision ?? null,
+		requestId: t.requestId ?? null,
+		attempt: t.attempt ?? null,
+		receiptKey: r,
+		calledAt: t.calledAt ?? /* @__PURE__ */ new Date()
+	}, a = yield* u.tryPromise({
+		try: () => e.insertIgnoreWithOutcome(j, i, { conflictColumns: ["receiptKey"] }),
+		catch: (e) => new I({
+			receiptKey: String(r),
+			cause: e
+		})
+	});
+	if (a.outcome === "inserted") return {
+		...n,
+		receipt: "recorded"
+	};
+	let o = L(a.row), s = L(i);
+	return Object.keys(o).some((e) => o[e] !== s[e]) ? yield* u.fail(new F({
+		receiptKey: String(r),
+		recorded: o,
+		attempted: s
+	})) : {
+		...z(a.row, n),
+		receipt: "replayed"
+	};
+})), z = (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
+	};
+}, B = (e, t) => R(e, t).pipe(u.asVoid, u.catchCause((e) => u.logError("AI usage NOT booked as recorded — the call itself succeeded and was returned", e).pipe(u.annotateLogs({
+	scope: "voltro:ai:usage",
+	provider: t.provider,
+	model: t.model,
+	operation: t.operation,
+	...O(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 }
+})))), V = (e, t = {}) => u.promise(async () => {
+	let n = [
+		...t.tenantId === void 0 ? [] : [f("tenantId", t.tenantId)],
+		...t.since === void 0 ? [] : [m("calledAt", t.since)],
+		...t.promptDigest === void 0 ? [] : [f("promptDigest", t.promptDigest)]
+	], r = _(M), i = n.length === 0 ? r : r.where(n.length === 1 ? n[0] : d(...n));
+	return (await e.query(i.descriptor)).reduce((e, t) => e + (Number(t.costMicroUsd) || 0), 0) / 1e6;
+});
+//#endregion
+export { e as AI_BUDGET_RESERVATIONS_TABLE, t as AI_BUDGET_TABLE, j as AI_USAGE_TABLE, n as AiBudgetExceeded, r as AiBudgetInvalidInput, i as AiBudgetReservationConflict, I as AiUsageLedgerError, F as AiUsageReceiptConflict, C as MODEL_PRICING_DEFAULTS, a as aiBudgetReservationsTable, o as aiBudgetTable, V as aiSpendUsd, M as aiUsageTable, A as estimateCostUsd, P as gatewayCostUsd, O as isMeteredUsage, E as modelPricing, k as normaliseUsage, D as priceForModel, R as recordAiUsage, B as recordAiUsageBestEffort, s as releaseAiBudget, c as requireAiBudget, T as setModelPricing };