@od-oneapp/ai-platform 0.1.0

package/dist/observability-analytics.d.mts

@@ -0,0 +1,107 @@
+declare namespace index_d_exports {
+  export { AnalyticsCollector, AnalyticsPricing, BudgetAlert, ModelUsage, OperationUsage, UsageEvent, UsageSummary, createAnalyticsCollector, formatCost, formatLatency, formatTokens, generateReport };
+}
+interface AnalyticsPricing {
+  readonly inputPer1kTokens: number;
+  readonly outputPer1kTokens: number;
+  readonly currency?: string;
+}
+interface UsageEvent {
+  readonly id: string;
+  readonly timestamp: number;
+  readonly model: string;
+  readonly operation: 'generate' | 'stream' | 'embed' | 'tool';
+  readonly inputTokens: number;
+  readonly outputTokens: number;
+  readonly totalTokens: number;
+  readonly cost: number;
+  readonly latencyMs: number;
+  readonly success: boolean;
+  readonly error?: string;
+  readonly metadata?: Record<string, unknown>;
+}
+interface UsageSummary {
+  readonly period: {
+    start: number;
+    end: number;
+  };
+  readonly totalRequests: number;
+  readonly successfulRequests: number;
+  readonly failedRequests: number;
+  readonly totalInputTokens: number;
+  readonly totalOutputTokens: number;
+  readonly totalTokens: number;
+  readonly totalCost: number;
+  readonly avgLatencyMs: number;
+  readonly p95LatencyMs: number;
+  readonly byModel: Record<string, ModelUsage>;
+  readonly byOperation: Record<string, OperationUsage>;
+}
+interface ModelUsage {
+  readonly model: string;
+  readonly requests: number;
+  readonly inputTokens: number;
+  readonly outputTokens: number;
+  readonly cost: number;
+  readonly avgLatencyMs: number;
+}
+interface OperationUsage {
+  readonly operation: string;
+  readonly requests: number;
+  readonly successRate: number;
+  readonly avgLatencyMs: number;
+}
+interface BudgetAlert {
+  readonly type: 'cost' | 'tokens' | 'requests';
+  readonly threshold: number;
+  readonly current: number;
+  readonly period: 'hourly' | 'daily' | 'weekly' | 'monthly';
+}
+declare function createAnalyticsCollector(options?: {
+  customPricing?: Record<string, AnalyticsPricing>;
+  budgets?: {
+    hourly?: {
+      cost?: number;
+      tokens?: number;
+      requests?: number;
+    };
+    daily?: {
+      cost?: number;
+      tokens?: number;
+      requests?: number;
+    };
+  };
+  onAlert?: (alert: BudgetAlert) => void;
+  maxHistory?: number;
+}): AnalyticsCollector;
+interface AnalyticsCollector {
+  record: (input: {
+    model: string;
+    operation: UsageEvent['operation'];
+    inputTokens: number;
+    outputTokens: number;
+    latencyMs: number;
+    success: boolean;
+    error?: string;
+    metadata?: Record<string, unknown>;
+  }) => UsageEvent;
+  getSummary: (period: 'hourly' | 'daily' | 'weekly' | 'monthly' | 'all') => UsageSummary;
+  getEvents: (options?: {
+    since?: number;
+    until?: number;
+    model?: string;
+    operation?: UsageEvent['operation'];
+    limit?: number;
+  }) => UsageEvent[];
+  calculateCost: (model: string, inputTokens: number, outputTokens: number) => number;
+  clear: () => void;
+  exportData: () => UsageEvent[];
+  importData: (data: UsageEvent[]) => void;
+}
+declare function formatCost(cost: number, currency?: string): string;
+declare function formatTokens(tokens: number): string;
+declare function formatLatency(ms: number): string;
+declare function generateReport(summary: UsageSummary): string;
+//#endregion
+export { AnalyticsCollector, AnalyticsPricing, BudgetAlert, ModelUsage, OperationUsage, UsageEvent, UsageSummary, createAnalyticsCollector, formatCost, formatLatency, formatTokens, generateReport, index_d_exports as t };
+//# sourceMappingURL=observability-analytics.d.mts.map

package/dist/observability-analytics.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability-analytics.d.mts","names":[],"sources":["../src/observability/analytics/index.ts"],"mappings":";;;UAmBiB,gBAAA;EAAA,SACN,gBAAA;EAAA,SACA,iBAAA;EAAA,SACA,QAAA;AAAA;AAAA,UAIM,UAAA;EAAA,SACN,EAAA;EAAA,SACA,SAAA;EAAA,SACA,KAAA;EAAA,SACA,SAAA;EAAA,SACA,WAAA;EAAA,SACA,YAAA;EAAA,SACA,WAAA;EAAA,SACA,IAAA;EAAA,SACA,SAAA;EAAA,SACA,OAAA;EAAA,SACA,KAAA;EAAA,SACA,QAAA,GAAW,MAAA;AAAA;AAAA,UAIL,YAAA;EAAA,SACN,MAAA;IAAU,KAAA;IAAe,GAAA;EAAA;EAAA,SACzB,aAAA;EAAA,SACA,kBAAA;EAAA,SACA,cAAA;EAAA,SACA,gBAAA;EAAA,SACA,iBAAA;EAAA,SACA,WAAA;EAAA,SACA,SAAA;EAAA,SACA,YAAA;EAAA,SACA,YAAA;EAAA,SACA,OAAA,EAAS,MAAA,SAAe,UAAA;EAAA,SACxB,WAAA,EAAa,MAAA,SAAe,cAAA;AAAA;AAAA,UAItB,UAAA;EAAA,SACN,KAAA;EAAA,SACA,QAAA;EAAA,SACA,WAAA;EAAA,SACA,YAAA;EAAA,SACA,IAAA;EAAA,SACA,YAAA;AAAA;AAAA,UAIM,cAAA;EAAA,SACN,SAAA;EAAA,SACA,QAAA;EAAA,SACA,WAAA;EAAA,SACA,YAAA;AAAA;AAAA,UAIM,WAAA;EAAA,SACN,IAAA;EAAA,SACA,SAAA;EAAA,SACA,OAAA;EAAA,SACA,MAAA;AAAA;AAAA,iBA8DK,wBAAA,CAAyB,OAAA;EACvC,aAAA,GAAgB,MAAA,SAAe,gBAAA;EAC/B,OAAA;IACE,MAAA;MAAW,IAAA;MAAe,MAAA;MAAiB,QAAA;IAAA;IAC3C,KAAA;MAAU,IAAA;MAAe,MAAA;MAAiB,QAAA;IAAA;EAAA;EAE5C,OAAA,IAAW,KAAA,EAAO,WAAA;EAClB,UAAA;AAAA,IACE,kBAAA;AAAA,UAmVa,kBAAA;EACf,MAAA,GAAS,KAAA;IACP,KAAA;IACA,SAAA,EAAW,UAAA;IACX,WAAA;IACA,YAAA;IACA,SAAA;IACA,OAAA;IACA,KAAA;IACA,QAAA,GAAW,MAAA;EAAA,MACP,UAAA;EACN,UAAA,GAAa,MAAA,wDAA8D,YAAA;EAC3E,SAAA,GAAY,OAAA;IACV,KAAA;IACA,KAAA;IACA,KAAA;IACA,SAAA,GAAY,UAAA;IACZ,KAAA;EAAA,MACI,UAAA;EACN,aAAA,GAAgB,KAAA,UAAe,WAAA,UAAqB,YAAA;EACpD,KAAA;EACA,UAAA,QAAkB,UAAA;EAClB,UAAA,GAAa,IAAA,EAAM,UAAA;AAAA;AAAA,iBAUL,UAAA,CAAW,IAAA,UAAc,QAAA;AAAA,iBAYzB,YAAA,CAAa,MAAA;AAAA,iBAab,aAAA,CAAc,EAAA;AAAA,iBAUd,cAAA,CAAe,OAAA,EAAS,YAAA"}

package/dist/observability-analytics.mjs

@@ -0,0 +1,409 @@
+import { t as __exportAll } from "./chunk-CkzbjWQW.mjs";
+import { Z as generateId } from "./ai-runtime-CDzQztTt.mjs";
+
+//#region src/observability/analytics/index.ts
+/**
+* Analytics Module
+*
+* AI usage analytics and monitoring:
+* - Token usage tracking
+* - Cost estimation
+* - Performance metrics
+* - Usage reporting
+*
+* @module analytics
+*/
+var analytics_exports = /* @__PURE__ */ __exportAll({
+	createAnalyticsCollector: () => createAnalyticsCollector,
+	formatCost: () => formatCost,
+	formatLatency: () => formatLatency,
+	formatTokens: () => formatTokens,
+	generateReport: () => generateReport
+});
+/**
+* Default model pricing rates.
+* Last updated: January 2026
+*
+* WARNING: These prices may become stale. For production use, consider:
+* - Providing explicit `customPricing` configuration
+* - Implementing a mechanism to fetch live pricing from providers
+*/
+const DEFAULT_PRICING = {
+	"gpt-4o": {
+		inputPer1kTokens: .005,
+		outputPer1kTokens: .015
+	},
+	"gpt-4o-mini": {
+		inputPer1kTokens: 15e-5,
+		outputPer1kTokens: 6e-4
+	},
+	"gpt-4-turbo": {
+		inputPer1kTokens: .01,
+		outputPer1kTokens: .03
+	},
+	"gpt-4": {
+		inputPer1kTokens: .03,
+		outputPer1kTokens: .06
+	},
+	"gpt-3.5-turbo": {
+		inputPer1kTokens: 5e-4,
+		outputPer1kTokens: .0015
+	},
+	"claude-3-5-sonnet": {
+		inputPer1kTokens: .003,
+		outputPer1kTokens: .015
+	},
+	"claude-3-opus": {
+		inputPer1kTokens: .015,
+		outputPer1kTokens: .075
+	},
+	"claude-3-sonnet": {
+		inputPer1kTokens: .003,
+		outputPer1kTokens: .015
+	},
+	"claude-3-haiku": {
+		inputPer1kTokens: 25e-5,
+		outputPer1kTokens: .00125
+	},
+	"text-embedding-3-small": {
+		inputPer1kTokens: 2e-5,
+		outputPer1kTokens: 0
+	},
+	"text-embedding-3-large": {
+		inputPer1kTokens: 13e-5,
+		outputPer1kTokens: 0
+	}
+};
+/**
+* Creates an analytics collector for tracking AI usage.
+*
+* @example
+* ```typescript
+* const analytics = createAnalyticsCollector({
+*   onAlert: (alert) => console.warn('Budget alert:', alert),
+*   budgets: {
+*     daily: { cost: 100, tokens: 1_000_000 }
+*   }
+* });
+*
+* analytics.record({
+*   model: 'gpt-4o',
+*   operation: 'generate',
+*   inputTokens: 100,
+*   outputTokens: 50,
+*   latencyMs: 1200,
+*   success: true
+* });
+*
+* const summary = analytics.getSummary('daily');
+* ```
+*/
+function createAnalyticsCollector(options) {
+	const { customPricing = {}, budgets, onAlert, maxHistory = 1e4 } = options ?? {};
+	const pricing = {
+		...DEFAULT_PRICING,
+		...customPricing
+	};
+	const events = [];
+	let recordsSinceLastBudgetCheck = 0;
+	const BUDGET_CHECK_INTERVAL = 100;
+	function calculateCost(model, inputTokens, outputTokens) {
+		const modelPricing = pricing[model] ?? {
+			inputPer1kTokens: 0,
+			outputPer1kTokens: 0
+		};
+		return inputTokens / 1e3 * modelPricing.inputPer1kTokens + outputTokens / 1e3 * modelPricing.outputPer1kTokens;
+	}
+	function record(input) {
+		const cost = calculateCost(input.model, input.inputTokens, input.outputTokens);
+		const event = {
+			id: generateId(),
+			timestamp: Date.now(),
+			model: input.model,
+			operation: input.operation,
+			inputTokens: input.inputTokens,
+			outputTokens: input.outputTokens,
+			totalTokens: input.inputTokens + input.outputTokens,
+			cost,
+			latencyMs: input.latencyMs,
+			success: input.success,
+			error: input.error,
+			metadata: input.metadata
+		};
+		events.push(event);
+		if (events.length > maxHistory) events.splice(0, events.length - maxHistory);
+		recordsSinceLastBudgetCheck++;
+		if (recordsSinceLastBudgetCheck >= BUDGET_CHECK_INTERVAL) {
+			checkBudgets();
+			recordsSinceLastBudgetCheck = 0;
+		}
+		return event;
+	}
+	function checkBudgets() {
+		if (!budgets || !onAlert) return;
+		const now = Date.now();
+		if (budgets.hourly) {
+			const hourStart = now - 3600 * 1e3;
+			checkBudgetThresholds(events.filter((e) => e.timestamp >= hourStart), budgets.hourly, "hourly");
+		}
+		if (budgets.daily) {
+			const dayStart = now - 1440 * 60 * 1e3;
+			checkBudgetThresholds(events.filter((e) => e.timestamp >= dayStart), budgets.daily, "daily");
+		}
+	}
+	function checkBudgetThresholds(periodEvents, budget, period) {
+		if (!onAlert) return;
+		const totalCost = periodEvents.reduce((sum, e) => sum + e.cost, 0);
+		const totalTokens = periodEvents.reduce((sum, e) => sum + e.totalTokens, 0);
+		const totalRequests = periodEvents.length;
+		if (budget.cost && totalCost >= budget.cost * .9) onAlert({
+			type: "cost",
+			threshold: budget.cost,
+			current: totalCost,
+			period
+		});
+		if (budget.tokens && totalTokens >= budget.tokens * .9) onAlert({
+			type: "tokens",
+			threshold: budget.tokens,
+			current: totalTokens,
+			period
+		});
+		if (budget.requests && totalRequests >= budget.requests * .9) onAlert({
+			type: "requests",
+			threshold: budget.requests,
+			current: totalRequests,
+			period
+		});
+	}
+	function getSummary(period) {
+		const now = Date.now();
+		let start;
+		switch (period) {
+			case "hourly":
+				start = now - 3600 * 1e3;
+				break;
+			case "daily":
+				start = now - 1440 * 60 * 1e3;
+				break;
+			case "weekly":
+				start = now - 10080 * 60 * 1e3;
+				break;
+			case "monthly":
+				start = now - 720 * 60 * 60 * 1e3;
+				break;
+			case "all":
+				start = 0;
+				break;
+			default: start = 0;
+		}
+		return computeSummary(events.filter((e) => e.timestamp >= start), start, now);
+	}
+	function computeSummary(periodEvents, start, end) {
+		const byModel = {};
+		const byOperation = {};
+		let totalInputTokens = 0;
+		let totalOutputTokens = 0;
+		let totalCost = 0;
+		let totalLatency = 0;
+		let successCount = 0;
+		const latencies = [];
+		for (const event of periodEvents) {
+			totalInputTokens += event.inputTokens;
+			totalOutputTokens += event.outputTokens;
+			totalCost += event.cost;
+			totalLatency += event.latencyMs;
+			latencies.push(event.latencyMs);
+			if (event.success) successCount++;
+			const modelUsage = byModel[event.model];
+			if (modelUsage) byModel[event.model] = {
+				...modelUsage,
+				requests: modelUsage.requests + 1,
+				inputTokens: modelUsage.inputTokens + event.inputTokens,
+				outputTokens: modelUsage.outputTokens + event.outputTokens,
+				cost: modelUsage.cost + event.cost,
+				totalLatencyMs: modelUsage.totalLatencyMs + event.latencyMs
+			};
+			else byModel[event.model] = {
+				model: event.model,
+				requests: 1,
+				inputTokens: event.inputTokens,
+				outputTokens: event.outputTokens,
+				cost: event.cost,
+				avgLatencyMs: event.latencyMs,
+				totalLatencyMs: event.latencyMs
+			};
+			const opUsage = byOperation[event.operation];
+			if (opUsage) {
+				const newRequests = opUsage.requests + 1;
+				const newSuccessCount = opUsage.successRate * opUsage.requests + (event.success ? 1 : 0);
+				byOperation[event.operation] = {
+					...opUsage,
+					requests: newRequests,
+					successRate: newSuccessCount / newRequests,
+					totalLatencyMs: opUsage.totalLatencyMs + event.latencyMs
+				};
+			} else byOperation[event.operation] = {
+				operation: event.operation,
+				requests: 1,
+				successRate: event.success ? 1 : 0,
+				avgLatencyMs: event.latencyMs,
+				totalLatencyMs: event.latencyMs
+			};
+		}
+		for (const model of Object.keys(byModel)) {
+			const modelUsage = byModel[model];
+			if (!modelUsage) continue;
+			const divisor = modelUsage.requests || 1;
+			byModel[model] = {
+				...modelUsage,
+				model,
+				avgLatencyMs: modelUsage.totalLatencyMs / divisor
+			};
+			delete byModel[model].totalLatencyMs;
+		}
+		for (const operation of Object.keys(byOperation)) {
+			const opUsage = byOperation[operation];
+			if (!opUsage) continue;
+			const divisor = opUsage.requests || 1;
+			byOperation[operation] = {
+				...opUsage,
+				operation,
+				avgLatencyMs: opUsage.totalLatencyMs / divisor
+			};
+			delete byOperation[operation].totalLatencyMs;
+		}
+		latencies.sort((a, b) => a - b);
+		const p95Latency = latencies[Math.floor(latencies.length * .95)] ?? 0;
+		return {
+			period: {
+				start,
+				end
+			},
+			totalRequests: periodEvents.length,
+			successfulRequests: successCount,
+			failedRequests: periodEvents.length - successCount,
+			totalInputTokens,
+			totalOutputTokens,
+			totalTokens: totalInputTokens + totalOutputTokens,
+			totalCost,
+			avgLatencyMs: periodEvents.length > 0 ? totalLatency / periodEvents.length : 0,
+			p95LatencyMs: p95Latency,
+			byModel,
+			byOperation
+		};
+	}
+	function getEvents(options) {
+		let filtered = [...events];
+		const { since, until, model, operation, limit } = options ?? {};
+		if (since !== void 0) filtered = filtered.filter((e) => e.timestamp >= since);
+		if (until !== void 0) filtered = filtered.filter((e) => e.timestamp <= until);
+		if (model) filtered = filtered.filter((e) => e.model === model);
+		if (operation) filtered = filtered.filter((e) => e.operation === operation);
+		if (limit !== void 0) {
+			if (limit <= 0) return [];
+			filtered = filtered.slice(-limit);
+		}
+		return filtered;
+	}
+	function clear() {
+		events.length = 0;
+	}
+	function exportData() {
+		return [...events];
+	}
+	function importData(data) {
+		const allowedOps = new Set([
+			"generate",
+			"stream",
+			"embed",
+			"tool"
+		]);
+		for (const event of data) {
+			if (typeof event.id !== "string" || typeof event.timestamp !== "number") throw new Error(`Invalid event data: missing required id or timestamp (event id: ${event.id ?? "unknown"})`);
+			if (typeof event.timestamp !== "number" || !Number.isInteger(event.timestamp) || event.timestamp <= 0) throw new Error(`Invalid event data: timestamp must be a positive integer (event id: ${event.id ?? "unknown"})`);
+			if (typeof event.model !== "string" || event.model.length === 0) throw new Error(`Invalid event data: model must be a non-empty string (event id: ${event.id ?? "unknown"})`);
+			if (typeof event.operation !== "string") throw new Error(`Invalid event data: missing required operation (event id: ${event.id ?? "unknown"})`);
+			if (!allowedOps.has(event.operation)) throw new Error(`Invalid event data: unsupported operation ${event.operation} (event id: ${event.id ?? "unknown"})`);
+			if ([
+				event.inputTokens,
+				event.outputTokens,
+				event.totalTokens,
+				event.cost,
+				event.latencyMs
+			].some((v) => !Number.isFinite(v) || v < 0)) throw new Error(`Invalid event data: numeric fields must be finite and >= 0 (event id: ${event.id ?? "unknown"})`);
+		}
+		events.push(...data);
+		if (events.length > maxHistory) events.splice(0, events.length - maxHistory);
+	}
+	return {
+		record,
+		getSummary,
+		getEvents,
+		calculateCost,
+		clear,
+		exportData,
+		importData
+	};
+}
+/**
+* Formats cost as currency string.
+*/
+function formatCost(cost, currency = "USD") {
+	return new Intl.NumberFormat("en-US", {
+		style: "currency",
+		currency,
+		minimumFractionDigits: 4,
+		maximumFractionDigits: 4
+	}).format(cost);
+}
+/**
+* Formats token count with SI prefixes.
+*/
+function formatTokens(tokens) {
+	if (tokens >= 1e6) return `${(tokens / 1e6).toFixed(2)}M`;
+	if (tokens >= 1e3) return `${(tokens / 1e3).toFixed(2)}K`;
+	return tokens.toString();
+}
+/**
+* Formats latency in human-readable form.
+*/
+function formatLatency(ms) {
+	if (ms >= 1e3) return `${(ms / 1e3).toFixed(2)}s`;
+	return `${ms.toFixed(0)}ms`;
+}
+/**
+* Generates a usage report as markdown.
+*/
+function generateReport(summary) {
+	const lines = [];
+	const periodStr = `${new Date(summary.period.start).toISOString()} - ${new Date(summary.period.end).toISOString()}`;
+	lines.push("# AI Usage Report");
+	lines.push(`\nPeriod: ${periodStr}\n`);
+	lines.push("## Summary");
+	lines.push(`- Total Requests: ${summary.totalRequests}`);
+	lines.push(`- Success Rate: ${summary.totalRequests > 0 ? (summary.successfulRequests / summary.totalRequests * 100).toFixed(1) : "0.0"}%`);
+	lines.push(`- Total Tokens: ${formatTokens(summary.totalTokens)}`);
+	lines.push(`- Total Cost: ${formatCost(summary.totalCost)}`);
+	lines.push(`- Avg Latency: ${formatLatency(summary.avgLatencyMs)}`);
+	lines.push(`- P95 Latency: ${formatLatency(summary.p95LatencyMs)}`);
+	lines.push("\n## By Model");
+	for (const [model, usage] of Object.entries(summary.byModel)) {
+		lines.push(`\n### ${model}`);
+		lines.push(`- Requests: ${usage.requests}`);
+		lines.push(`- Tokens: ${formatTokens(usage.inputTokens + usage.outputTokens)}`);
+		lines.push(`- Cost: ${formatCost(usage.cost)}`);
+		lines.push(`- Avg Latency: ${formatLatency(usage.avgLatencyMs)}`);
+	}
+	lines.push("\n## By Operation");
+	for (const [op, usage] of Object.entries(summary.byOperation)) {
+		lines.push(`\n### ${op}`);
+		lines.push(`- Requests: ${usage.requests}`);
+		lines.push(`- Success Rate: ${(usage.successRate * 100).toFixed(1)}%`);
+		lines.push(`- Avg Latency: ${formatLatency(usage.avgLatencyMs)}`);
+	}
+	return lines.join("\n");
+}
+
+//#endregion
+export { createAnalyticsCollector, formatCost, formatLatency, formatTokens, generateReport, analytics_exports as t };
+//# sourceMappingURL=observability-analytics.mjs.map

package/dist/observability-analytics.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability-analytics.mjs","names":[],"sources":["../src/observability/analytics/index.ts"],"sourcesContent":["/**\n * Analytics Module\n *\n * AI usage analytics and monitoring:\n * - Token usage tracking\n * - Cost estimation\n * - Performance metrics\n * - Usage reporting\n *\n * @module analytics\n */\n\nimport { generateId } from '../../shared';\n\n// -----------------------------------------------------------------------------\n// Types\n// -----------------------------------------------------------------------------\n\n/** Model pricing configuration for analytics */\nexport interface AnalyticsPricing {\n  readonly inputPer1kTokens: number;\n  readonly outputPer1kTokens: number;\n  readonly currency?: string;\n}\n\n/** Usage event */\nexport interface UsageEvent {\n  readonly id: string;\n  readonly timestamp: number;\n  readonly model: string;\n  readonly operation: 'generate' | 'stream' | 'embed' | 'tool';\n  readonly inputTokens: number;\n  readonly outputTokens: number;\n  readonly totalTokens: number;\n  readonly cost: number;\n  readonly latencyMs: number;\n  readonly success: boolean;\n  readonly error?: string;\n  readonly metadata?: Record<string, unknown>;\n}\n\n/** Usage summary */\nexport interface UsageSummary {\n  readonly period: { start: number; end: number };\n  readonly totalRequests: number;\n  readonly successfulRequests: number;\n  readonly failedRequests: number;\n  readonly totalInputTokens: number;\n  readonly totalOutputTokens: number;\n  readonly totalTokens: number;\n  readonly totalCost: number;\n  readonly avgLatencyMs: number;\n  readonly p95LatencyMs: number;\n  readonly byModel: Record<string, ModelUsage>;\n  readonly byOperation: Record<string, OperationUsage>;\n}\n\n/** Model-specific usage */\nexport interface ModelUsage {\n  readonly model: string;\n  readonly requests: number;\n  readonly inputTokens: number;\n  readonly outputTokens: number;\n  readonly cost: number;\n  readonly avgLatencyMs: number;\n}\n\n/** Operation-specific usage */\nexport interface OperationUsage {\n  readonly operation: string;\n  readonly requests: number;\n  readonly successRate: number;\n  readonly avgLatencyMs: number;\n}\n\n/** Budget alert */\nexport interface BudgetAlert {\n  readonly type: 'cost' | 'tokens' | 'requests';\n  readonly threshold: number;\n  readonly current: number;\n  readonly period: 'hourly' | 'daily' | 'weekly' | 'monthly';\n}\n\n// -----------------------------------------------------------------------------\n// Default Pricing\n// -----------------------------------------------------------------------------\n\n/**\n * Default model pricing rates.\n * Last updated: January 2026\n *\n * WARNING: These prices may become stale. For production use, consider:\n * - Providing explicit `customPricing` configuration\n * - Implementing a mechanism to fetch live pricing from providers\n */\nconst DEFAULT_PRICING: Record<string, AnalyticsPricing> = {\n  // OpenAI\n  'gpt-4o': { inputPer1kTokens: 0.005, outputPer1kTokens: 0.015 },\n  'gpt-4o-mini': { inputPer1kTokens: 0.00015, outputPer1kTokens: 0.0006 },\n  'gpt-4-turbo': { inputPer1kTokens: 0.01, outputPer1kTokens: 0.03 },\n  'gpt-4': { inputPer1kTokens: 0.03, outputPer1kTokens: 0.06 },\n  'gpt-3.5-turbo': { inputPer1kTokens: 0.0005, outputPer1kTokens: 0.0015 },\n\n  // Anthropic\n  'claude-3-5-sonnet': { inputPer1kTokens: 0.003, outputPer1kTokens: 0.015 },\n  'claude-3-opus': { inputPer1kTokens: 0.015, outputPer1kTokens: 0.075 },\n  'claude-3-sonnet': { inputPer1kTokens: 0.003, outputPer1kTokens: 0.015 },\n  'claude-3-haiku': { inputPer1kTokens: 0.00025, outputPer1kTokens: 0.00125 },\n\n  // Embeddings\n  'text-embedding-3-small': { inputPer1kTokens: 0.00002, outputPer1kTokens: 0 },\n  'text-embedding-3-large': { inputPer1kTokens: 0.00013, outputPer1kTokens: 0 },\n};\n\n// -----------------------------------------------------------------------------\n// Analytics Collector\n// -----------------------------------------------------------------------------\n\n/**\n * Creates an analytics collector for tracking AI usage.\n *\n * @example\n * ```typescript\n * const analytics = createAnalyticsCollector({\n *   onAlert: (alert) => console.warn('Budget alert:', alert),\n *   budgets: {\n *     daily: { cost: 100, tokens: 1_000_000 }\n *   }\n * });\n *\n * analytics.record({\n *   model: 'gpt-4o',\n *   operation: 'generate',\n *   inputTokens: 100,\n *   outputTokens: 50,\n *   latencyMs: 1200,\n *   success: true\n * });\n *\n * const summary = analytics.getSummary('daily');\n * ```\n */\nexport function createAnalyticsCollector(options?: {\n  customPricing?: Record<string, AnalyticsPricing>;\n  budgets?: {\n    hourly?: { cost?: number; tokens?: number; requests?: number };\n    daily?: { cost?: number; tokens?: number; requests?: number };\n  };\n  onAlert?: (alert: BudgetAlert) => void;\n  maxHistory?: number;\n}): AnalyticsCollector {\n  const { customPricing = {}, budgets, onAlert, maxHistory = 10000 } = options ?? {};\n  const pricing = { ...DEFAULT_PRICING, ...customPricing };\n  const events: UsageEvent[] = [];\n  let recordsSinceLastBudgetCheck = 0;\n  const BUDGET_CHECK_INTERVAL = 100;\n\n  function calculateCost(model: string, inputTokens: number, outputTokens: number): number {\n    const modelPricing = pricing[model] ?? { inputPer1kTokens: 0, outputPer1kTokens: 0 };\n    return (\n      (inputTokens / 1000) * modelPricing.inputPer1kTokens +\n      (outputTokens / 1000) * modelPricing.outputPer1kTokens\n    );\n  }\n\n  function record(input: {\n    model: string;\n    operation: UsageEvent['operation'];\n    inputTokens: number;\n    outputTokens: number;\n    latencyMs: number;\n    success: boolean;\n    error?: string;\n    metadata?: Record<string, unknown>;\n  }): UsageEvent {\n    const cost = calculateCost(input.model, input.inputTokens, input.outputTokens);\n\n    const event: UsageEvent = {\n      id: generateId(),\n      timestamp: Date.now(),\n      model: input.model,\n      operation: input.operation,\n      inputTokens: input.inputTokens,\n      outputTokens: input.outputTokens,\n      totalTokens: input.inputTokens + input.outputTokens,\n      cost,\n      latencyMs: input.latencyMs,\n      success: input.success,\n      error: input.error,\n      metadata: input.metadata,\n    };\n\n    events.push(event);\n\n    // Trim history efficiently (single splice instead of repeated shift)\n    if (events.length > maxHistory) {\n      events.splice(0, events.length - maxHistory);\n    }\n\n    // Check budgets periodically to avoid O(n) per record\n    recordsSinceLastBudgetCheck++;\n    if (recordsSinceLastBudgetCheck >= BUDGET_CHECK_INTERVAL) {\n      checkBudgets();\n      recordsSinceLastBudgetCheck = 0;\n    }\n\n    return event;\n  }\n\n  function checkBudgets(): void {\n    if (!budgets || !onAlert) return;\n\n    const now = Date.now();\n\n    if (budgets.hourly) {\n      const hourStart = now - 60 * 60 * 1000;\n      const hourEvents = events.filter(e => e.timestamp >= hourStart);\n      checkBudgetThresholds(hourEvents, budgets.hourly, 'hourly');\n    }\n\n    if (budgets.daily) {\n      const dayStart = now - 24 * 60 * 60 * 1000;\n      const dayEvents = events.filter(e => e.timestamp >= dayStart);\n      checkBudgetThresholds(dayEvents, budgets.daily, 'daily');\n    }\n  }\n\n  function checkBudgetThresholds(\n    periodEvents: UsageEvent[],\n    budget: { cost?: number; tokens?: number; requests?: number },\n    period: 'hourly' | 'daily' | 'weekly' | 'monthly',\n  ): void {\n    if (!onAlert) return;\n\n    const totalCost = periodEvents.reduce((sum, e) => sum + e.cost, 0);\n    const totalTokens = periodEvents.reduce((sum, e) => sum + e.totalTokens, 0);\n    const totalRequests = periodEvents.length;\n\n    if (budget.cost && totalCost >= budget.cost * 0.9) {\n      onAlert({ type: 'cost', threshold: budget.cost, current: totalCost, period });\n    }\n    if (budget.tokens && totalTokens >= budget.tokens * 0.9) {\n      onAlert({ type: 'tokens', threshold: budget.tokens, current: totalTokens, period });\n    }\n    if (budget.requests && totalRequests >= budget.requests * 0.9) {\n      onAlert({ type: 'requests', threshold: budget.requests, current: totalRequests, period });\n    }\n  }\n\n  function getSummary(period: 'hourly' | 'daily' | 'weekly' | 'monthly' | 'all'): UsageSummary {\n    const now = Date.now();\n    let start: number;\n\n    switch (period) {\n      case 'hourly':\n        start = now - 60 * 60 * 1000;\n        break;\n      case 'daily':\n        start = now - 24 * 60 * 60 * 1000;\n        break;\n      case 'weekly':\n        start = now - 7 * 24 * 60 * 60 * 1000;\n        break;\n      case 'monthly':\n        start = now - 30 * 24 * 60 * 60 * 1000;\n        break;\n      case 'all':\n        start = 0;\n        break;\n      default:\n        start = 0;\n    }\n\n    const periodEvents = events.filter(e => e.timestamp >= start);\n    return computeSummary(periodEvents, start, now);\n  }\n\n  function computeSummary(periodEvents: UsageEvent[], start: number, end: number): UsageSummary {\n    const byModel: Record<string, ModelUsage & { totalLatencyMs: number }> = {};\n    const byOperation: Record<string, OperationUsage & { totalLatencyMs: number }> = {};\n\n    let totalInputTokens = 0;\n    let totalOutputTokens = 0;\n    let totalCost = 0;\n    let totalLatency = 0;\n    let successCount = 0;\n    const latencies: number[] = [];\n\n    for (const event of periodEvents) {\n      totalInputTokens += event.inputTokens;\n      totalOutputTokens += event.outputTokens;\n      totalCost += event.cost;\n      totalLatency += event.latencyMs;\n      latencies.push(event.latencyMs);\n      if (event.success) successCount++;\n\n      // By model - track totals instead of running average\n      const modelUsage = byModel[event.model];\n      if (modelUsage) {\n        byModel[event.model] = {\n          ...modelUsage,\n          requests: modelUsage.requests + 1,\n          inputTokens: modelUsage.inputTokens + event.inputTokens,\n          outputTokens: modelUsage.outputTokens + event.outputTokens,\n          cost: modelUsage.cost + event.cost,\n          totalLatencyMs: modelUsage.totalLatencyMs + event.latencyMs,\n        };\n      } else {\n        byModel[event.model] = {\n          model: event.model,\n          requests: 1,\n          inputTokens: event.inputTokens,\n          outputTokens: event.outputTokens,\n          cost: event.cost,\n          avgLatencyMs: event.latencyMs,\n          totalLatencyMs: event.latencyMs,\n        };\n      }\n\n      // By operation - track totals instead of running average\n      const opUsage = byOperation[event.operation];\n      if (opUsage) {\n        const newRequests = opUsage.requests + 1;\n        const newSuccessCount = opUsage.successRate * opUsage.requests + (event.success ? 1 : 0);\n        byOperation[event.operation] = {\n          ...opUsage,\n          requests: newRequests,\n          successRate: newSuccessCount / newRequests,\n          totalLatencyMs: opUsage.totalLatencyMs + event.latencyMs,\n        };\n      } else {\n        byOperation[event.operation] = {\n          operation: event.operation,\n          requests: 1,\n          successRate: event.success ? 1 : 0,\n          avgLatencyMs: event.latencyMs,\n          totalLatencyMs: event.latencyMs,\n        };\n      }\n    }\n\n    // Compute final averages from totals\n    for (const model of Object.keys(byModel)) {\n      const modelUsage = byModel[model];\n      if (!modelUsage) continue;\n      const divisor = modelUsage.requests || 1;\n      byModel[model] = {\n        ...modelUsage,\n        model,\n        avgLatencyMs: modelUsage.totalLatencyMs / divisor,\n      };\n      delete (byModel[model] as { totalLatencyMs?: number }).totalLatencyMs;\n    }\n\n    for (const operation of Object.keys(byOperation)) {\n      const opUsage = byOperation[operation];\n      if (!opUsage) continue;\n      const divisor = opUsage.requests || 1;\n      byOperation[operation] = {\n        ...opUsage,\n        operation,\n        avgLatencyMs: opUsage.totalLatencyMs / divisor,\n      };\n      delete (byOperation[operation] as { totalLatencyMs?: number }).totalLatencyMs;\n    }\n\n    // Calculate p95 latency\n    latencies.sort((a, b) => a - b);\n    const p95Index = Math.floor(latencies.length * 0.95);\n    const p95Latency = latencies[p95Index] ?? 0;\n\n    return {\n      period: { start, end },\n      totalRequests: periodEvents.length,\n      successfulRequests: successCount,\n      failedRequests: periodEvents.length - successCount,\n      totalInputTokens,\n      totalOutputTokens,\n      totalTokens: totalInputTokens + totalOutputTokens,\n      totalCost,\n      avgLatencyMs: periodEvents.length > 0 ? totalLatency / periodEvents.length : 0,\n      p95LatencyMs: p95Latency,\n      byModel,\n      byOperation,\n    };\n  }\n\n  function getEvents(options?: {\n    since?: number;\n    until?: number;\n    model?: string;\n    operation?: UsageEvent['operation'];\n    limit?: number;\n  }): UsageEvent[] {\n    let filtered = [...events];\n    const { since, until, model, operation, limit } = options ?? {};\n\n    if (since !== undefined) {\n      filtered = filtered.filter(e => e.timestamp >= since);\n    }\n    if (until !== undefined) {\n      filtered = filtered.filter(e => e.timestamp <= until);\n    }\n    if (model) {\n      filtered = filtered.filter(e => e.model === model);\n    }\n    if (operation) {\n      filtered = filtered.filter(e => e.operation === operation);\n    }\n    if (limit !== undefined) {\n      if (limit <= 0) return [];\n      filtered = filtered.slice(-limit);\n    }\n\n    return filtered;\n  }\n\n  function clear(): void {\n    events.length = 0;\n  }\n\n  function exportData(): UsageEvent[] {\n    return [...events];\n  }\n\n  function importData(data: UsageEvent[]): void {\n    // Validate imported events have required fields\n    const allowedOps = new Set(['generate', 'stream', 'embed', 'tool']);\n    for (const event of data) {\n      if (typeof event.id !== 'string' || typeof event.timestamp !== 'number') {\n        throw new Error(\n          `Invalid event data: missing required id or timestamp (event id: ${event.id ?? 'unknown'})`,\n        );\n      }\n      if (\n        typeof event.timestamp !== 'number' ||\n        !Number.isInteger(event.timestamp) ||\n        event.timestamp <= 0\n      ) {\n        throw new Error(\n          `Invalid event data: timestamp must be a positive integer (event id: ${event.id ?? 'unknown'})`,\n        );\n      }\n      if (typeof event.model !== 'string' || event.model.length === 0) {\n        throw new Error(\n          `Invalid event data: model must be a non-empty string (event id: ${event.id ?? 'unknown'})`,\n        );\n      }\n      if (typeof event.operation !== 'string') {\n        throw new Error(\n          `Invalid event data: missing required operation (event id: ${event.id ?? 'unknown'})`,\n        );\n      }\n      if (!allowedOps.has(event.operation)) {\n        throw new Error(\n          `Invalid event data: unsupported operation ${event.operation} (event id: ${event.id ?? 'unknown'})`,\n        );\n      }\n      const numericFields = [\n        event.inputTokens,\n        event.outputTokens,\n        event.totalTokens,\n        event.cost,\n        event.latencyMs,\n      ];\n      if (numericFields.some(v => !Number.isFinite(v) || v < 0)) {\n        throw new Error(\n          `Invalid event data: numeric fields must be finite and >= 0 (event id: ${event.id ?? 'unknown'})`,\n        );\n      }\n    }\n    events.push(...data);\n    // Trim efficiently with single splice instead of repeated shift\n    if (events.length > maxHistory) {\n      events.splice(0, events.length - maxHistory);\n    }\n  }\n\n  return {\n    record,\n    getSummary,\n    getEvents,\n    calculateCost,\n    clear,\n    exportData,\n    importData,\n  };\n}\n\nexport interface AnalyticsCollector {\n  record: (input: {\n    model: string;\n    operation: UsageEvent['operation'];\n    inputTokens: number;\n    outputTokens: number;\n    latencyMs: number;\n    success: boolean;\n    error?: string;\n    metadata?: Record<string, unknown>;\n  }) => UsageEvent;\n  getSummary: (period: 'hourly' | 'daily' | 'weekly' | 'monthly' | 'all') => UsageSummary;\n  getEvents: (options?: {\n    since?: number;\n    until?: number;\n    model?: string;\n    operation?: UsageEvent['operation'];\n    limit?: number;\n  }) => UsageEvent[];\n  calculateCost: (model: string, inputTokens: number, outputTokens: number) => number;\n  clear: () => void;\n  exportData: () => UsageEvent[];\n  importData: (data: UsageEvent[]) => void;\n}\n\n// -----------------------------------------------------------------------------\n// Reporting Helpers\n// -----------------------------------------------------------------------------\n\n/**\n * Formats cost as currency string.\n */\nexport function formatCost(cost: number, currency = 'USD'): string {\n  return new Intl.NumberFormat('en-US', {\n    style: 'currency',\n    currency,\n    minimumFractionDigits: 4,\n    maximumFractionDigits: 4,\n  }).format(cost);\n}\n\n/**\n * Formats token count with SI prefixes.\n */\nexport function formatTokens(tokens: number): string {\n  if (tokens >= 1_000_000) {\n    return `${(tokens / 1_000_000).toFixed(2)}M`;\n  }\n  if (tokens >= 1_000) {\n    return `${(tokens / 1_000).toFixed(2)}K`;\n  }\n  return tokens.toString();\n}\n\n/**\n * Formats latency in human-readable form.\n */\nexport function formatLatency(ms: number): string {\n  if (ms >= 1000) {\n    return `${(ms / 1000).toFixed(2)}s`;\n  }\n  return `${ms.toFixed(0)}ms`;\n}\n\n/**\n * Generates a usage report as markdown.\n */\nexport function generateReport(summary: UsageSummary): string {\n  const lines: string[] = [];\n\n  const periodStr = `${new Date(summary.period.start).toISOString()} - ${new Date(summary.period.end).toISOString()}`;\n\n  lines.push('# AI Usage Report');\n  lines.push(`\\nPeriod: ${periodStr}\\n`);\n\n  lines.push('## Summary');\n  lines.push(`- Total Requests: ${summary.totalRequests}`);\n  lines.push(\n    `- Success Rate: ${summary.totalRequests > 0 ? ((summary.successfulRequests / summary.totalRequests) * 100).toFixed(1) : '0.0'}%`,\n  );\n  lines.push(`- Total Tokens: ${formatTokens(summary.totalTokens)}`);\n  lines.push(`- Total Cost: ${formatCost(summary.totalCost)}`);\n  lines.push(`- Avg Latency: ${formatLatency(summary.avgLatencyMs)}`);\n  lines.push(`- P95 Latency: ${formatLatency(summary.p95LatencyMs)}`);\n\n  lines.push('\\n## By Model');\n  for (const [model, usage] of Object.entries(summary.byModel)) {\n    lines.push(`\\n### ${model}`);\n    lines.push(`- Requests: ${usage.requests}`);\n    lines.push(`- Tokens: ${formatTokens(usage.inputTokens + usage.outputTokens)}`);\n    lines.push(`- Cost: ${formatCost(usage.cost)}`);\n    lines.push(`- Avg Latency: ${formatLatency(usage.avgLatencyMs)}`);\n  }\n\n  lines.push('\\n## By Operation');\n  for (const [op, usage] of Object.entries(summary.byOperation)) {\n    lines.push(`\\n### ${op}`);\n    lines.push(`- Requests: ${usage.requests}`);\n    lines.push(`- Success Rate: ${(usage.successRate * 100).toFixed(1)}%`);\n    lines.push(`- Avg Latency: ${formatLatency(usage.avgLatencyMs)}`);\n  }\n\n  return lines.join('\\n');\n}\n"],"mappings":"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"}

package/dist/observability-cost.d.mts

@@ -0,0 +1,10 @@
+import "./ai-runtime-DIwOEc6g.mjs";
+import { a as extractMetadata, c as CostMetadata, d as UsageSummary, i as createUsageTracker, l as UsageCallback, n as createBudgetGuard, o as BudgetConfig, r as calculateCost, s as BudgetExceededError, t as GetCurrentUsage, u as UsageEvent } from "./budget-guard-C83KCH9V.mjs";
+
+//#region src/observability/cost/index.d.ts
+declare namespace index_d_exports {
+  export { BudgetConfig, BudgetExceededError, CostMetadata, GetCurrentUsage, UsageCallback, UsageEvent, UsageSummary, calculateCost, createBudgetGuard, createUsageTracker, extractMetadata };
+}
+//#endregion
+export { type BudgetConfig, BudgetExceededError, type CostMetadata, type GetCurrentUsage, type UsageCallback, type UsageEvent, type UsageSummary, calculateCost, createBudgetGuard, createUsageTracker, extractMetadata, index_d_exports as t };
+//# sourceMappingURL=observability-cost.d.mts.map

package/dist/observability-cost.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability-cost.d.mts","names":[],"sources":["../src/observability/cost/index.ts"],"mappings":""}

package/dist/observability-cost.mjs

@@ -0,0 +1,15 @@
+import { t as __exportAll } from "./chunk-CkzbjWQW.mjs";
+import { a as BudgetExceededError, i as extractMetadata, n as calculateCost, r as createUsageTracker, t as createBudgetGuard } from "./budget-guard-d_b5rq4u.mjs";
+
+//#region src/observability/cost/index.ts
+var cost_exports = /* @__PURE__ */ __exportAll({
+	BudgetExceededError: () => BudgetExceededError,
+	calculateCost: () => calculateCost,
+	createBudgetGuard: () => createBudgetGuard,
+	createUsageTracker: () => createUsageTracker,
+	extractMetadata: () => extractMetadata
+});
+
+//#endregion
+export { BudgetExceededError, calculateCost, createBudgetGuard, createUsageTracker, extractMetadata, cost_exports as t };
+//# sourceMappingURL=observability-cost.mjs.map

package/dist/observability-cost.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability-cost.mjs","names":[],"sources":["../src/observability/cost/index.ts"],"sourcesContent":["/**\n * Cost tracking and attribution module\n *\n * Provides middleware for tracking AI usage costs, enforcing budgets,\n * and attributing costs to users, teams, and features.\n *\n * @module @od-oneapp/ai-platform/cost\n */\n\n// Types\nexport type { UsageEvent, CostMetadata, BudgetConfig, UsageSummary, UsageCallback } from './types';\nexport { BudgetExceededError } from './types';\n\n// Tracking\nexport { createUsageTracker, calculateCost, extractMetadata } from './tracking/usage-tracker';\nexport { createBudgetGuard, type GetCurrentUsage } from './tracking/budget-guard';\n"],"mappings":""}