@objectstack/spec 0.3.0 → 0.3.2

package/dist/ai/cost.zod.d.ts

@@ -0,0 +1,2025 @@
+import { z } from 'zod';
+/**
+ * AI Cost Tracking Protocol
+ *
+ * Monitor and control AI API costs with budgets, alerts, and analytics.
+ * Provides cost optimization, budget enforcement, and financial reporting.
+ */
+/**
+ * Cost Metric Type
+ */
+export declare const CostMetricTypeSchema: z.ZodEnum<["token", "request", "character", "second", "image", "embedding"]>;
+/**
+ * Billing Period
+ */
+export declare const BillingPeriodSchema: z.ZodEnum<["hourly", "daily", "weekly", "monthly", "quarterly", "yearly", "custom"]>;
+/**
+ * Cost Entry
+ */
+export declare const CostEntrySchema: z.ZodObject<{
+    /** Identity */
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    /** Request Details */
+    modelId: z.ZodString;
+    provider: z.ZodString;
+    operation: z.ZodString;
+    /** Usage Metrics */
+    promptTokens: z.ZodOptional<z.ZodNumber>;
+    completionTokens: z.ZodOptional<z.ZodNumber>;
+    totalTokens: z.ZodOptional<z.ZodNumber>;
+    requestCount: z.ZodDefault<z.ZodNumber>;
+    /** Cost Calculation */
+    promptCost: z.ZodOptional<z.ZodNumber>;
+    completionCost: z.ZodOptional<z.ZodNumber>;
+    totalCost: z.ZodNumber;
+    currency: z.ZodDefault<z.ZodString>;
+    /** Context */
+    sessionId: z.ZodOptional<z.ZodString>;
+    userId: z.ZodOptional<z.ZodString>;
+    agentId: z.ZodOptional<z.ZodString>;
+    object: z.ZodOptional<z.ZodString>;
+    recordId: z.ZodOptional<z.ZodString>;
+    /** Metadata */
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, "strip", z.ZodTypeAny, {
+    currency: string;
+    provider: string;
+    id: string;
+    operation: string;
+    modelId: string;
+    timestamp: string;
+    requestCount: number;
+    totalCost: number;
+    object?: string | undefined;
+    userId?: string | undefined;
+    sessionId?: string | undefined;
+    metadata?: Record<string, any> | undefined;
+    tags?: string[] | undefined;
+    recordId?: string | undefined;
+    promptTokens?: number | undefined;
+    completionTokens?: number | undefined;
+    totalTokens?: number | undefined;
+    agentId?: string | undefined;
+    promptCost?: number | undefined;
+    completionCost?: number | undefined;
+}, {
+    provider: string;
+    id: string;
+    operation: string;
+    modelId: string;
+    timestamp: string;
+    totalCost: number;
+    object?: string | undefined;
+    currency?: string | undefined;
+    userId?: string | undefined;
+    sessionId?: string | undefined;
+    metadata?: Record<string, any> | undefined;
+    tags?: string[] | undefined;
+    recordId?: string | undefined;
+    promptTokens?: number | undefined;
+    completionTokens?: number | undefined;
+    totalTokens?: number | undefined;
+    agentId?: string | undefined;
+    requestCount?: number | undefined;
+    promptCost?: number | undefined;
+    completionCost?: number | undefined;
+}>;
+/**
+ * Budget Type
+ */
+export declare const BudgetTypeSchema: z.ZodEnum<["global", "user", "agent", "object", "project", "department"]>;
+/**
+ * Budget Limit
+ */
+export declare const BudgetLimitSchema: z.ZodObject<{
+    /** Limit Configuration */
+    type: z.ZodEnum<["global", "user", "agent", "object", "project", "department"]>;
+    scope: z.ZodOptional<z.ZodString>;
+    /** Limit Amount */
+    maxCost: z.ZodNumber;
+    currency: z.ZodDefault<z.ZodString>;
+    /** Period */
+    period: z.ZodEnum<["hourly", "daily", "weekly", "monthly", "quarterly", "yearly", "custom"]>;
+    customPeriodDays: z.ZodOptional<z.ZodNumber>;
+    /** Soft Limits & Warnings */
+    softLimit: z.ZodOptional<z.ZodNumber>;
+    warnThresholds: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    /** Enforcement */
+    enforced: z.ZodDefault<z.ZodBoolean>;
+    gracePeriodSeconds: z.ZodDefault<z.ZodNumber>;
+    /** Rollover */
+    allowRollover: z.ZodDefault<z.ZodBoolean>;
+    maxRolloverPercentage: z.ZodOptional<z.ZodNumber>;
+    /** Metadata */
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    active: z.ZodDefault<z.ZodBoolean>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    currency: string;
+    type: "object" | "user" | "global" | "agent" | "project" | "department";
+    active: boolean;
+    maxCost: number;
+    period: "custom" | "daily" | "weekly" | "monthly" | "hourly" | "quarterly" | "yearly";
+    enforced: boolean;
+    gracePeriodSeconds: number;
+    allowRollover: boolean;
+    name?: string | undefined;
+    description?: string | undefined;
+    scope?: string | undefined;
+    tags?: string[] | undefined;
+    customPeriodDays?: number | undefined;
+    softLimit?: number | undefined;
+    warnThresholds?: number[] | undefined;
+    maxRolloverPercentage?: number | undefined;
+}, {
+    type: "object" | "user" | "global" | "agent" | "project" | "department";
+    maxCost: number;
+    period: "custom" | "daily" | "weekly" | "monthly" | "hourly" | "quarterly" | "yearly";
+    currency?: string | undefined;
+    name?: string | undefined;
+    description?: string | undefined;
+    active?: boolean | undefined;
+    scope?: string | undefined;
+    tags?: string[] | undefined;
+    customPeriodDays?: number | undefined;
+    softLimit?: number | undefined;
+    warnThresholds?: number[] | undefined;
+    enforced?: boolean | undefined;
+    gracePeriodSeconds?: number | undefined;
+    allowRollover?: boolean | undefined;
+    maxRolloverPercentage?: number | undefined;
+}>;
+/**
+ * Budget Status
+ */
+export declare const BudgetStatusSchema: z.ZodObject<{
+    /** Budget Reference */
+    budgetId: z.ZodString;
+    type: z.ZodEnum<["global", "user", "agent", "object", "project", "department"]>;
+    scope: z.ZodOptional<z.ZodString>;
+    /** Current Period */
+    periodStart: z.ZodString;
+    periodEnd: z.ZodString;
+    /** Usage */
+    currentCost: z.ZodDefault<z.ZodNumber>;
+    maxCost: z.ZodNumber;
+    currency: z.ZodDefault<z.ZodString>;
+    /** Status */
+    percentageUsed: z.ZodNumber;
+    remainingCost: z.ZodNumber;
+    isExceeded: z.ZodDefault<z.ZodBoolean>;
+    isWarning: z.ZodDefault<z.ZodBoolean>;
+    /** Projections */
+    projectedCost: z.ZodOptional<z.ZodNumber>;
+    projectedOverage: z.ZodOptional<z.ZodNumber>;
+    /** Last Update */
+    lastUpdated: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    currency: string;
+    type: "object" | "user" | "global" | "agent" | "project" | "department";
+    maxCost: number;
+    budgetId: string;
+    periodStart: string;
+    periodEnd: string;
+    currentCost: number;
+    percentageUsed: number;
+    remainingCost: number;
+    isExceeded: boolean;
+    isWarning: boolean;
+    lastUpdated: string;
+    scope?: string | undefined;
+    projectedCost?: number | undefined;
+    projectedOverage?: number | undefined;
+}, {
+    type: "object" | "user" | "global" | "agent" | "project" | "department";
+    maxCost: number;
+    budgetId: string;
+    periodStart: string;
+    periodEnd: string;
+    percentageUsed: number;
+    remainingCost: number;
+    lastUpdated: string;
+    currency?: string | undefined;
+    scope?: string | undefined;
+    currentCost?: number | undefined;
+    isExceeded?: boolean | undefined;
+    isWarning?: boolean | undefined;
+    projectedCost?: number | undefined;
+    projectedOverage?: number | undefined;
+}>;
+/**
+ * Cost Alert Type
+ */
+export declare const CostAlertTypeSchema: z.ZodEnum<["threshold_warning", "threshold_critical", "limit_exceeded", "anomaly_detected", "projection_exceeded"]>;
+/**
+ * Cost Alert
+ */
+export declare const CostAlertSchema: z.ZodObject<{
+    /** Alert Details */
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    type: z.ZodEnum<["threshold_warning", "threshold_critical", "limit_exceeded", "anomaly_detected", "projection_exceeded"]>;
+    severity: z.ZodEnum<["info", "warning", "critical"]>;
+    /** Budget Context */
+    budgetId: z.ZodOptional<z.ZodString>;
+    budgetType: z.ZodOptional<z.ZodEnum<["global", "user", "agent", "object", "project", "department"]>>;
+    scope: z.ZodOptional<z.ZodString>;
+    /** Alert Information */
+    message: z.ZodString;
+    currentCost: z.ZodNumber;
+    maxCost: z.ZodOptional<z.ZodNumber>;
+    threshold: z.ZodOptional<z.ZodNumber>;
+    currency: z.ZodDefault<z.ZodString>;
+    /** Recommendations */
+    recommendations: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Status */
+    acknowledged: z.ZodDefault<z.ZodBoolean>;
+    acknowledgedBy: z.ZodOptional<z.ZodString>;
+    acknowledgedAt: z.ZodOptional<z.ZodString>;
+    resolved: z.ZodDefault<z.ZodBoolean>;
+    /** Metadata */
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, "strip", z.ZodTypeAny, {
+    currency: string;
+    message: string;
+    type: "threshold_warning" | "threshold_critical" | "limit_exceeded" | "anomaly_detected" | "projection_exceeded";
+    severity: "warning" | "info" | "critical";
+    id: string;
+    timestamp: string;
+    currentCost: number;
+    acknowledged: boolean;
+    resolved: boolean;
+    scope?: string | undefined;
+    metadata?: Record<string, any> | undefined;
+    threshold?: number | undefined;
+    maxCost?: number | undefined;
+    budgetId?: string | undefined;
+    budgetType?: "object" | "user" | "global" | "agent" | "project" | "department" | undefined;
+    recommendations?: string[] | undefined;
+    acknowledgedBy?: string | undefined;
+    acknowledgedAt?: string | undefined;
+}, {
+    message: string;
+    type: "threshold_warning" | "threshold_critical" | "limit_exceeded" | "anomaly_detected" | "projection_exceeded";
+    severity: "warning" | "info" | "critical";
+    id: string;
+    timestamp: string;
+    currentCost: number;
+    currency?: string | undefined;
+    scope?: string | undefined;
+    metadata?: Record<string, any> | undefined;
+    threshold?: number | undefined;
+    maxCost?: number | undefined;
+    budgetId?: string | undefined;
+    budgetType?: "object" | "user" | "global" | "agent" | "project" | "department" | undefined;
+    recommendations?: string[] | undefined;
+    acknowledged?: boolean | undefined;
+    acknowledgedBy?: string | undefined;
+    acknowledgedAt?: string | undefined;
+    resolved?: boolean | undefined;
+}>;
+/**
+ * Cost Breakdown Dimension
+ */
+export declare const CostBreakdownDimensionSchema: z.ZodEnum<["model", "provider", "user", "agent", "object", "operation", "date", "hour", "tag"]>;
+/**
+ * Cost Breakdown Entry
+ */
+export declare const CostBreakdownEntrySchema: z.ZodObject<{
+    dimension: z.ZodEnum<["model", "provider", "user", "agent", "object", "operation", "date", "hour", "tag"]>;
+    value: z.ZodString;
+    /** Metrics */
+    totalCost: z.ZodNumber;
+    requestCount: z.ZodNumber;
+    totalTokens: z.ZodOptional<z.ZodNumber>;
+    /** Share */
+    percentageOfTotal: z.ZodNumber;
+    /** Time Range */
+    periodStart: z.ZodOptional<z.ZodString>;
+    periodEnd: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    value: string;
+    requestCount: number;
+    totalCost: number;
+    dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+    percentageOfTotal: number;
+    totalTokens?: number | undefined;
+    periodStart?: string | undefined;
+    periodEnd?: string | undefined;
+}, {
+    value: string;
+    requestCount: number;
+    totalCost: number;
+    dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+    percentageOfTotal: number;
+    totalTokens?: number | undefined;
+    periodStart?: string | undefined;
+    periodEnd?: string | undefined;
+}>;
+/**
+ * Cost Analytics
+ */
+export declare const CostAnalyticsSchema: z.ZodObject<{
+    /** Time Range */
+    periodStart: z.ZodString;
+    periodEnd: z.ZodString;
+    /** Summary Metrics */
+    totalCost: z.ZodNumber;
+    totalRequests: z.ZodNumber;
+    totalTokens: z.ZodOptional<z.ZodNumber>;
+    currency: z.ZodDefault<z.ZodString>;
+    /** Averages */
+    averageCostPerRequest: z.ZodNumber;
+    averageCostPerToken: z.ZodOptional<z.ZodNumber>;
+    averageRequestsPerDay: z.ZodNumber;
+    /** Trends */
+    costTrend: z.ZodOptional<z.ZodEnum<["increasing", "decreasing", "stable"]>>;
+    trendPercentage: z.ZodOptional<z.ZodNumber>;
+    /** Breakdowns */
+    byModel: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        dimension: z.ZodEnum<["model", "provider", "user", "agent", "object", "operation", "date", "hour", "tag"]>;
+        value: z.ZodString;
+        /** Metrics */
+        totalCost: z.ZodNumber;
+        requestCount: z.ZodNumber;
+        totalTokens: z.ZodOptional<z.ZodNumber>;
+        /** Share */
+        percentageOfTotal: z.ZodNumber;
+        /** Time Range */
+        periodStart: z.ZodOptional<z.ZodString>;
+        periodEnd: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        requestCount: number;
+        totalCost: number;
+        dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+        percentageOfTotal: number;
+        totalTokens?: number | undefined;
+        periodStart?: string | undefined;
+        periodEnd?: string | undefined;
+    }, {
+        value: string;
+        requestCount: number;
+        totalCost: number;
+        dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+        percentageOfTotal: number;
+        totalTokens?: number | undefined;
+        periodStart?: string | undefined;
+        periodEnd?: string | undefined;
+    }>, "many">>;
+    byProvider: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        dimension: z.ZodEnum<["model", "provider", "user", "agent", "object", "operation", "date", "hour", "tag"]>;
+        value: z.ZodString;
+        /** Metrics */
+        totalCost: z.ZodNumber;
+        requestCount: z.ZodNumber;
+        totalTokens: z.ZodOptional<z.ZodNumber>;
+        /** Share */
+        percentageOfTotal: z.ZodNumber;
+        /** Time Range */
+        periodStart: z.ZodOptional<z.ZodString>;
+        periodEnd: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        requestCount: number;
+        totalCost: number;
+        dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+        percentageOfTotal: number;
+        totalTokens?: number | undefined;
+        periodStart?: string | undefined;
+        periodEnd?: string | undefined;
+    }, {
+        value: string;
+        requestCount: number;
+        totalCost: number;
+        dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+        percentageOfTotal: number;
+        totalTokens?: number | undefined;
+        periodStart?: string | undefined;
+        periodEnd?: string | undefined;
+    }>, "many">>;
+    byUser: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        dimension: z.ZodEnum<["model", "provider", "user", "agent", "object", "operation", "date", "hour", "tag"]>;
+        value: z.ZodString;
+        /** Metrics */
+        totalCost: z.ZodNumber;
+        requestCount: z.ZodNumber;
+        totalTokens: z.ZodOptional<z.ZodNumber>;
+        /** Share */
+        percentageOfTotal: z.ZodNumber;
+        /** Time Range */
+        periodStart: z.ZodOptional<z.ZodString>;
+        periodEnd: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        requestCount: number;
+        totalCost: number;
+        dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+        percentageOfTotal: number;
+        totalTokens?: number | undefined;
+        periodStart?: string | undefined;
+        periodEnd?: string | undefined;
+    }, {
+        value: string;
+        requestCount: number;
+        totalCost: number;
+        dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+        percentageOfTotal: number;
+        totalTokens?: number | undefined;
+        periodStart?: string | undefined;
+        periodEnd?: string | undefined;
+    }>, "many">>;
+    byAgent: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        dimension: z.ZodEnum<["model", "provider", "user", "agent", "object", "operation", "date", "hour", "tag"]>;
+        value: z.ZodString;
+        /** Metrics */
+        totalCost: z.ZodNumber;
+        requestCount: z.ZodNumber;
+        totalTokens: z.ZodOptional<z.ZodNumber>;
+        /** Share */
+        percentageOfTotal: z.ZodNumber;
+        /** Time Range */
+        periodStart: z.ZodOptional<z.ZodString>;
+        periodEnd: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        requestCount: number;
+        totalCost: number;
+        dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+        percentageOfTotal: number;
+        totalTokens?: number | undefined;
+        periodStart?: string | undefined;
+        periodEnd?: string | undefined;
+    }, {
+        value: string;
+        requestCount: number;
+        totalCost: number;
+        dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+        percentageOfTotal: number;
+        totalTokens?: number | undefined;
+        periodStart?: string | undefined;
+        periodEnd?: string | undefined;
+    }>, "many">>;
+    byOperation: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        dimension: z.ZodEnum<["model", "provider", "user", "agent", "object", "operation", "date", "hour", "tag"]>;
+        value: z.ZodString;
+        /** Metrics */
+        totalCost: z.ZodNumber;
+        requestCount: z.ZodNumber;
+        totalTokens: z.ZodOptional<z.ZodNumber>;
+        /** Share */
+        percentageOfTotal: z.ZodNumber;
+        /** Time Range */
+        periodStart: z.ZodOptional<z.ZodString>;
+        periodEnd: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        requestCount: number;
+        totalCost: number;
+        dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+        percentageOfTotal: number;
+        totalTokens?: number | undefined;
+        periodStart?: string | undefined;
+        periodEnd?: string | undefined;
+    }, {
+        value: string;
+        requestCount: number;
+        totalCost: number;
+        dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+        percentageOfTotal: number;
+        totalTokens?: number | undefined;
+        periodStart?: string | undefined;
+        periodEnd?: string | undefined;
+    }>, "many">>;
+    byDate: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        dimension: z.ZodEnum<["model", "provider", "user", "agent", "object", "operation", "date", "hour", "tag"]>;
+        value: z.ZodString;
+        /** Metrics */
+        totalCost: z.ZodNumber;
+        requestCount: z.ZodNumber;
+        totalTokens: z.ZodOptional<z.ZodNumber>;
+        /** Share */
+        percentageOfTotal: z.ZodNumber;
+        /** Time Range */
+        periodStart: z.ZodOptional<z.ZodString>;
+        periodEnd: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        requestCount: number;
+        totalCost: number;
+        dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+        percentageOfTotal: number;
+        totalTokens?: number | undefined;
+        periodStart?: string | undefined;
+        periodEnd?: string | undefined;
+    }, {
+        value: string;
+        requestCount: number;
+        totalCost: number;
+        dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+        percentageOfTotal: number;
+        totalTokens?: number | undefined;
+        periodStart?: string | undefined;
+        periodEnd?: string | undefined;
+    }>, "many">>;
+    /** Top Consumers */
+    topModels: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        dimension: z.ZodEnum<["model", "provider", "user", "agent", "object", "operation", "date", "hour", "tag"]>;
+        value: z.ZodString;
+        /** Metrics */
+        totalCost: z.ZodNumber;
+        requestCount: z.ZodNumber;
+        totalTokens: z.ZodOptional<z.ZodNumber>;
+        /** Share */
+        percentageOfTotal: z.ZodNumber;
+        /** Time Range */
+        periodStart: z.ZodOptional<z.ZodString>;
+        periodEnd: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        requestCount: number;
+        totalCost: number;
+        dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+        percentageOfTotal: number;
+        totalTokens?: number | undefined;
+        periodStart?: string | undefined;
+        periodEnd?: string | undefined;
+    }, {
+        value: string;
+        requestCount: number;
+        totalCost: number;
+        dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+        percentageOfTotal: number;
+        totalTokens?: number | undefined;
+        periodStart?: string | undefined;
+        periodEnd?: string | undefined;
+    }>, "many">>;
+    topUsers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        dimension: z.ZodEnum<["model", "provider", "user", "agent", "object", "operation", "date", "hour", "tag"]>;
+        value: z.ZodString;
+        /** Metrics */
+        totalCost: z.ZodNumber;
+        requestCount: z.ZodNumber;
+        totalTokens: z.ZodOptional<z.ZodNumber>;
+        /** Share */
+        percentageOfTotal: z.ZodNumber;
+        /** Time Range */
+        periodStart: z.ZodOptional<z.ZodString>;
+        periodEnd: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        requestCount: number;
+        totalCost: number;
+        dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+        percentageOfTotal: number;
+        totalTokens?: number | undefined;
+        periodStart?: string | undefined;
+        periodEnd?: string | undefined;
+    }, {
+        value: string;
+        requestCount: number;
+        totalCost: number;
+        dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+        percentageOfTotal: number;
+        totalTokens?: number | undefined;
+        periodStart?: string | undefined;
+        periodEnd?: string | undefined;
+    }>, "many">>;
+    topAgents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        dimension: z.ZodEnum<["model", "provider", "user", "agent", "object", "operation", "date", "hour", "tag"]>;
+        value: z.ZodString;
+        /** Metrics */
+        totalCost: z.ZodNumber;
+        requestCount: z.ZodNumber;
+        totalTokens: z.ZodOptional<z.ZodNumber>;
+        /** Share */
+        percentageOfTotal: z.ZodNumber;
+        /** Time Range */
+        periodStart: z.ZodOptional<z.ZodString>;
+        periodEnd: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        requestCount: number;
+        totalCost: number;
+        dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+        percentageOfTotal: number;
+        totalTokens?: number | undefined;
+        periodStart?: string | undefined;
+        periodEnd?: string | undefined;
+    }, {
+        value: string;
+        requestCount: number;
+        totalCost: number;
+        dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+        percentageOfTotal: number;
+        totalTokens?: number | undefined;
+        periodStart?: string | undefined;
+        periodEnd?: string | undefined;
+    }>, "many">>;
+    /** Efficiency Metrics */
+    tokensPerDollar: z.ZodOptional<z.ZodNumber>;
+    requestsPerDollar: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    currency: string;
+    totalCost: number;
+    periodStart: string;
+    periodEnd: string;
+    totalRequests: number;
+    averageCostPerRequest: number;
+    averageRequestsPerDay: number;
+    totalTokens?: number | undefined;
+    averageCostPerToken?: number | undefined;
+    costTrend?: "increasing" | "decreasing" | "stable" | undefined;
+    trendPercentage?: number | undefined;
+    byModel?: {
+        value: string;
+        requestCount: number;
+        totalCost: number;
+        dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+        percentageOfTotal: number;
+        totalTokens?: number | undefined;
+        periodStart?: string | undefined;
+        periodEnd?: string | undefined;
+    }[] | undefined;
+    byProvider?: {
+        value: string;
+        requestCount: number;
+        totalCost: number;
+        dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+        percentageOfTotal: number;
+        totalTokens?: number | undefined;
+        periodStart?: string | undefined;
+        periodEnd?: string | undefined;
+    }[] | undefined;
+    byUser?: {
+        value: string;
+        requestCount: number;
+        totalCost: number;
+        dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+        percentageOfTotal: number;
+        totalTokens?: number | undefined;
+        periodStart?: string | undefined;
+        periodEnd?: string | undefined;
+    }[] | undefined;
+    byAgent?: {
+        value: string;
+        requestCount: number;
+        totalCost: number;
+        dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+        percentageOfTotal: number;
+        totalTokens?: number | undefined;
+        periodStart?: string | undefined;
+        periodEnd?: string | undefined;
+    }[] | undefined;
+    byOperation?: {
+        value: string;
+        requestCount: number;
+        totalCost: number;
+        dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+        percentageOfTotal: number;
+        totalTokens?: number | undefined;
+        periodStart?: string | undefined;
+        periodEnd?: string | undefined;
+    }[] | undefined;
+    byDate?: {
+        value: string;
+        requestCount: number;
+        totalCost: number;
+        dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+        percentageOfTotal: number;
+        totalTokens?: number | undefined;
+        periodStart?: string | undefined;
+        periodEnd?: string | undefined;
+    }[] | undefined;
+    topModels?: {
+        value: string;
+        requestCount: number;
+        totalCost: number;
+        dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+        percentageOfTotal: number;
+        totalTokens?: number | undefined;
+        periodStart?: string | undefined;
+        periodEnd?: string | undefined;
+    }[] | undefined;
+    topUsers?: {
+        value: string;
+        requestCount: number;
+        totalCost: number;
+        dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+        percentageOfTotal: number;
+        totalTokens?: number | undefined;
+        periodStart?: string | undefined;
+        periodEnd?: string | undefined;
+    }[] | undefined;
+    topAgents?: {
+        value: string;
+        requestCount: number;
+        totalCost: number;
+        dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+        percentageOfTotal: number;
+        totalTokens?: number | undefined;
+        periodStart?: string | undefined;
+        periodEnd?: string | undefined;
+    }[] | undefined;
+    tokensPerDollar?: number | undefined;
+    requestsPerDollar?: number | undefined;
+}, {
+    totalCost: number;
+    periodStart: string;
+    periodEnd: string;
+    totalRequests: number;
+    averageCostPerRequest: number;
+    averageRequestsPerDay: number;
+    currency?: string | undefined;
+    totalTokens?: number | undefined;
+    averageCostPerToken?: number | undefined;
+    costTrend?: "increasing" | "decreasing" | "stable" | undefined;
+    trendPercentage?: number | undefined;
+    byModel?: {
+        value: string;
+        requestCount: number;
+        totalCost: number;
+        dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+        percentageOfTotal: number;
+        totalTokens?: number | undefined;
+        periodStart?: string | undefined;
+        periodEnd?: string | undefined;
+    }[] | undefined;
+    byProvider?: {
+        value: string;
+        requestCount: number;
+        totalCost: number;
+        dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+        percentageOfTotal: number;
+        totalTokens?: number | undefined;
+        periodStart?: string | undefined;
+        periodEnd?: string | undefined;
+    }[] | undefined;
+    byUser?: {
+        value: string;
+        requestCount: number;
+        totalCost: number;
+        dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+        percentageOfTotal: number;
+        totalTokens?: number | undefined;
+        periodStart?: string | undefined;
+        periodEnd?: string | undefined;
+    }[] | undefined;
+    byAgent?: {
+        value: string;
+        requestCount: number;
+        totalCost: number;
+        dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+        percentageOfTotal: number;
+        totalTokens?: number | undefined;
+        periodStart?: string | undefined;
+        periodEnd?: string | undefined;
+    }[] | undefined;
+    byOperation?: {
+        value: string;
+        requestCount: number;
+        totalCost: number;
+        dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+        percentageOfTotal: number;
+        totalTokens?: number | undefined;
+        periodStart?: string | undefined;
+        periodEnd?: string | undefined;
+    }[] | undefined;
+    byDate?: {
+        value: string;
+        requestCount: number;
+        totalCost: number;
+        dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+        percentageOfTotal: number;
+        totalTokens?: number | undefined;
+        periodStart?: string | undefined;
+        periodEnd?: string | undefined;
+    }[] | undefined;
+    topModels?: {
+        value: string;
+        requestCount: number;
+        totalCost: number;
+        dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+        percentageOfTotal: number;
+        totalTokens?: number | undefined;
+        periodStart?: string | undefined;
+        periodEnd?: string | undefined;
+    }[] | undefined;
+    topUsers?: {
+        value: string;
+        requestCount: number;
+        totalCost: number;
+        dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+        percentageOfTotal: number;
+        totalTokens?: number | undefined;
+        periodStart?: string | undefined;
+        periodEnd?: string | undefined;
+    }[] | undefined;
+    topAgents?: {
+        value: string;
+        requestCount: number;
+        totalCost: number;
+        dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+        percentageOfTotal: number;
+        totalTokens?: number | undefined;
+        periodStart?: string | undefined;
+        periodEnd?: string | undefined;
+    }[] | undefined;
+    tokensPerDollar?: number | undefined;
+    requestsPerDollar?: number | undefined;
+}>;
+/**
+ * Cost Optimization Recommendation
+ */
+export declare const CostOptimizationRecommendationSchema: z.ZodObject<{
+    /** Recommendation Details */
+    id: z.ZodString;
+    type: z.ZodEnum<["switch_model", "reduce_tokens", "batch_requests", "cache_results", "adjust_parameters", "limit_usage"]>;
+    /** Impact */
+    title: z.ZodString;
+    description: z.ZodString;
+    estimatedSavings: z.ZodOptional<z.ZodNumber>;
+    savingsPercentage: z.ZodOptional<z.ZodNumber>;
+    /** Implementation */
+    priority: z.ZodEnum<["low", "medium", "high"]>;
+    effort: z.ZodEnum<["low", "medium", "high"]>;
+    actionable: z.ZodDefault<z.ZodBoolean>;
+    actionSteps: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Context */
+    targetModel: z.ZodOptional<z.ZodString>;
+    alternativeModel: z.ZodOptional<z.ZodString>;
+    affectedUsers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Status */
+    status: z.ZodDefault<z.ZodEnum<["pending", "accepted", "rejected", "implemented"]>>;
+    implementedAt: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "switch_model" | "reduce_tokens" | "batch_requests" | "cache_results" | "adjust_parameters" | "limit_usage";
+    status: "pending" | "accepted" | "rejected" | "implemented";
+    description: string;
+    priority: "medium" | "low" | "high";
+    title: string;
+    id: string;
+    effort: "medium" | "low" | "high";
+    actionable: boolean;
+    estimatedSavings?: number | undefined;
+    savingsPercentage?: number | undefined;
+    actionSteps?: string[] | undefined;
+    targetModel?: string | undefined;
+    alternativeModel?: string | undefined;
+    affectedUsers?: string[] | undefined;
+    implementedAt?: string | undefined;
+}, {
+    type: "switch_model" | "reduce_tokens" | "batch_requests" | "cache_results" | "adjust_parameters" | "limit_usage";
+    description: string;
+    priority: "medium" | "low" | "high";
+    title: string;
+    id: string;
+    effort: "medium" | "low" | "high";
+    status?: "pending" | "accepted" | "rejected" | "implemented" | undefined;
+    estimatedSavings?: number | undefined;
+    savingsPercentage?: number | undefined;
+    actionable?: boolean | undefined;
+    actionSteps?: string[] | undefined;
+    targetModel?: string | undefined;
+    alternativeModel?: string | undefined;
+    affectedUsers?: string[] | undefined;
+    implementedAt?: string | undefined;
+}>;
+/**
+ * Cost Report
+ */
+export declare const CostReportSchema: z.ZodObject<{
+    /** Report Metadata */
+    id: z.ZodString;
+    name: z.ZodString;
+    generatedAt: z.ZodString;
+    /** Time Range */
+    periodStart: z.ZodString;
+    periodEnd: z.ZodString;
+    period: z.ZodEnum<["hourly", "daily", "weekly", "monthly", "quarterly", "yearly", "custom"]>;
+    /** Analytics */
+    analytics: z.ZodObject<{
+        /** Time Range */
+        periodStart: z.ZodString;
+        periodEnd: z.ZodString;
+        /** Summary Metrics */
+        totalCost: z.ZodNumber;
+        totalRequests: z.ZodNumber;
+        totalTokens: z.ZodOptional<z.ZodNumber>;
+        currency: z.ZodDefault<z.ZodString>;
+        /** Averages */
+        averageCostPerRequest: z.ZodNumber;
+        averageCostPerToken: z.ZodOptional<z.ZodNumber>;
+        averageRequestsPerDay: z.ZodNumber;
+        /** Trends */
+        costTrend: z.ZodOptional<z.ZodEnum<["increasing", "decreasing", "stable"]>>;
+        trendPercentage: z.ZodOptional<z.ZodNumber>;
+        /** Breakdowns */
+        byModel: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            dimension: z.ZodEnum<["model", "provider", "user", "agent", "object", "operation", "date", "hour", "tag"]>;
+            value: z.ZodString;
+            /** Metrics */
+            totalCost: z.ZodNumber;
+            requestCount: z.ZodNumber;
+            totalTokens: z.ZodOptional<z.ZodNumber>;
+            /** Share */
+            percentageOfTotal: z.ZodNumber;
+            /** Time Range */
+            periodStart: z.ZodOptional<z.ZodString>;
+            periodEnd: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }, {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }>, "many">>;
+        byProvider: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            dimension: z.ZodEnum<["model", "provider", "user", "agent", "object", "operation", "date", "hour", "tag"]>;
+            value: z.ZodString;
+            /** Metrics */
+            totalCost: z.ZodNumber;
+            requestCount: z.ZodNumber;
+            totalTokens: z.ZodOptional<z.ZodNumber>;
+            /** Share */
+            percentageOfTotal: z.ZodNumber;
+            /** Time Range */
+            periodStart: z.ZodOptional<z.ZodString>;
+            periodEnd: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }, {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }>, "many">>;
+        byUser: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            dimension: z.ZodEnum<["model", "provider", "user", "agent", "object", "operation", "date", "hour", "tag"]>;
+            value: z.ZodString;
+            /** Metrics */
+            totalCost: z.ZodNumber;
+            requestCount: z.ZodNumber;
+            totalTokens: z.ZodOptional<z.ZodNumber>;
+            /** Share */
+            percentageOfTotal: z.ZodNumber;
+            /** Time Range */
+            periodStart: z.ZodOptional<z.ZodString>;
+            periodEnd: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }, {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }>, "many">>;
+        byAgent: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            dimension: z.ZodEnum<["model", "provider", "user", "agent", "object", "operation", "date", "hour", "tag"]>;
+            value: z.ZodString;
+            /** Metrics */
+            totalCost: z.ZodNumber;
+            requestCount: z.ZodNumber;
+            totalTokens: z.ZodOptional<z.ZodNumber>;
+            /** Share */
+            percentageOfTotal: z.ZodNumber;
+            /** Time Range */
+            periodStart: z.ZodOptional<z.ZodString>;
+            periodEnd: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }, {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }>, "many">>;
+        byOperation: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            dimension: z.ZodEnum<["model", "provider", "user", "agent", "object", "operation", "date", "hour", "tag"]>;
+            value: z.ZodString;
+            /** Metrics */
+            totalCost: z.ZodNumber;
+            requestCount: z.ZodNumber;
+            totalTokens: z.ZodOptional<z.ZodNumber>;
+            /** Share */
+            percentageOfTotal: z.ZodNumber;
+            /** Time Range */
+            periodStart: z.ZodOptional<z.ZodString>;
+            periodEnd: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }, {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }>, "many">>;
+        byDate: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            dimension: z.ZodEnum<["model", "provider", "user", "agent", "object", "operation", "date", "hour", "tag"]>;
+            value: z.ZodString;
+            /** Metrics */
+            totalCost: z.ZodNumber;
+            requestCount: z.ZodNumber;
+            totalTokens: z.ZodOptional<z.ZodNumber>;
+            /** Share */
+            percentageOfTotal: z.ZodNumber;
+            /** Time Range */
+            periodStart: z.ZodOptional<z.ZodString>;
+            periodEnd: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }, {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }>, "many">>;
+        /** Top Consumers */
+        topModels: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            dimension: z.ZodEnum<["model", "provider", "user", "agent", "object", "operation", "date", "hour", "tag"]>;
+            value: z.ZodString;
+            /** Metrics */
+            totalCost: z.ZodNumber;
+            requestCount: z.ZodNumber;
+            totalTokens: z.ZodOptional<z.ZodNumber>;
+            /** Share */
+            percentageOfTotal: z.ZodNumber;
+            /** Time Range */
+            periodStart: z.ZodOptional<z.ZodString>;
+            periodEnd: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }, {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }>, "many">>;
+        topUsers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            dimension: z.ZodEnum<["model", "provider", "user", "agent", "object", "operation", "date", "hour", "tag"]>;
+            value: z.ZodString;
+            /** Metrics */
+            totalCost: z.ZodNumber;
+            requestCount: z.ZodNumber;
+            totalTokens: z.ZodOptional<z.ZodNumber>;
+            /** Share */
+            percentageOfTotal: z.ZodNumber;
+            /** Time Range */
+            periodStart: z.ZodOptional<z.ZodString>;
+            periodEnd: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }, {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }>, "many">>;
+        topAgents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            dimension: z.ZodEnum<["model", "provider", "user", "agent", "object", "operation", "date", "hour", "tag"]>;
+            value: z.ZodString;
+            /** Metrics */
+            totalCost: z.ZodNumber;
+            requestCount: z.ZodNumber;
+            totalTokens: z.ZodOptional<z.ZodNumber>;
+            /** Share */
+            percentageOfTotal: z.ZodNumber;
+            /** Time Range */
+            periodStart: z.ZodOptional<z.ZodString>;
+            periodEnd: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }, {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }>, "many">>;
+        /** Efficiency Metrics */
+        tokensPerDollar: z.ZodOptional<z.ZodNumber>;
+        requestsPerDollar: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        currency: string;
+        totalCost: number;
+        periodStart: string;
+        periodEnd: string;
+        totalRequests: number;
+        averageCostPerRequest: number;
+        averageRequestsPerDay: number;
+        totalTokens?: number | undefined;
+        averageCostPerToken?: number | undefined;
+        costTrend?: "increasing" | "decreasing" | "stable" | undefined;
+        trendPercentage?: number | undefined;
+        byModel?: {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }[] | undefined;
+        byProvider?: {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }[] | undefined;
+        byUser?: {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }[] | undefined;
+        byAgent?: {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }[] | undefined;
+        byOperation?: {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }[] | undefined;
+        byDate?: {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }[] | undefined;
+        topModels?: {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }[] | undefined;
+        topUsers?: {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }[] | undefined;
+        topAgents?: {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }[] | undefined;
+        tokensPerDollar?: number | undefined;
+        requestsPerDollar?: number | undefined;
+    }, {
+        totalCost: number;
+        periodStart: string;
+        periodEnd: string;
+        totalRequests: number;
+        averageCostPerRequest: number;
+        averageRequestsPerDay: number;
+        currency?: string | undefined;
+        totalTokens?: number | undefined;
+        averageCostPerToken?: number | undefined;
+        costTrend?: "increasing" | "decreasing" | "stable" | undefined;
+        trendPercentage?: number | undefined;
+        byModel?: {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }[] | undefined;
+        byProvider?: {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }[] | undefined;
+        byUser?: {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }[] | undefined;
+        byAgent?: {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }[] | undefined;
+        byOperation?: {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }[] | undefined;
+        byDate?: {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }[] | undefined;
+        topModels?: {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }[] | undefined;
+        topUsers?: {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }[] | undefined;
+        topAgents?: {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }[] | undefined;
+        tokensPerDollar?: number | undefined;
+        requestsPerDollar?: number | undefined;
+    }>;
+    /** Budgets */
+    budgets: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        /** Budget Reference */
+        budgetId: z.ZodString;
+        type: z.ZodEnum<["global", "user", "agent", "object", "project", "department"]>;
+        scope: z.ZodOptional<z.ZodString>;
+        /** Current Period */
+        periodStart: z.ZodString;
+        periodEnd: z.ZodString;
+        /** Usage */
+        currentCost: z.ZodDefault<z.ZodNumber>;
+        maxCost: z.ZodNumber;
+        currency: z.ZodDefault<z.ZodString>;
+        /** Status */
+        percentageUsed: z.ZodNumber;
+        remainingCost: z.ZodNumber;
+        isExceeded: z.ZodDefault<z.ZodBoolean>;
+        isWarning: z.ZodDefault<z.ZodBoolean>;
+        /** Projections */
+        projectedCost: z.ZodOptional<z.ZodNumber>;
+        projectedOverage: z.ZodOptional<z.ZodNumber>;
+        /** Last Update */
+        lastUpdated: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        currency: string;
+        type: "object" | "user" | "global" | "agent" | "project" | "department";
+        maxCost: number;
+        budgetId: string;
+        periodStart: string;
+        periodEnd: string;
+        currentCost: number;
+        percentageUsed: number;
+        remainingCost: number;
+        isExceeded: boolean;
+        isWarning: boolean;
+        lastUpdated: string;
+        scope?: string | undefined;
+        projectedCost?: number | undefined;
+        projectedOverage?: number | undefined;
+    }, {
+        type: "object" | "user" | "global" | "agent" | "project" | "department";
+        maxCost: number;
+        budgetId: string;
+        periodStart: string;
+        periodEnd: string;
+        percentageUsed: number;
+        remainingCost: number;
+        lastUpdated: string;
+        currency?: string | undefined;
+        scope?: string | undefined;
+        currentCost?: number | undefined;
+        isExceeded?: boolean | undefined;
+        isWarning?: boolean | undefined;
+        projectedCost?: number | undefined;
+        projectedOverage?: number | undefined;
+    }>, "many">>;
+    /** Alerts */
+    alerts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        /** Alert Details */
+        id: z.ZodString;
+        timestamp: z.ZodString;
+        type: z.ZodEnum<["threshold_warning", "threshold_critical", "limit_exceeded", "anomaly_detected", "projection_exceeded"]>;
+        severity: z.ZodEnum<["info", "warning", "critical"]>;
+        /** Budget Context */
+        budgetId: z.ZodOptional<z.ZodString>;
+        budgetType: z.ZodOptional<z.ZodEnum<["global", "user", "agent", "object", "project", "department"]>>;
+        scope: z.ZodOptional<z.ZodString>;
+        /** Alert Information */
+        message: z.ZodString;
+        currentCost: z.ZodNumber;
+        maxCost: z.ZodOptional<z.ZodNumber>;
+        threshold: z.ZodOptional<z.ZodNumber>;
+        currency: z.ZodDefault<z.ZodString>;
+        /** Recommendations */
+        recommendations: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** Status */
+        acknowledged: z.ZodDefault<z.ZodBoolean>;
+        acknowledgedBy: z.ZodOptional<z.ZodString>;
+        acknowledgedAt: z.ZodOptional<z.ZodString>;
+        resolved: z.ZodDefault<z.ZodBoolean>;
+        /** Metadata */
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    }, "strip", z.ZodTypeAny, {
+        currency: string;
+        message: string;
+        type: "threshold_warning" | "threshold_critical" | "limit_exceeded" | "anomaly_detected" | "projection_exceeded";
+        severity: "warning" | "info" | "critical";
+        id: string;
+        timestamp: string;
+        currentCost: number;
+        acknowledged: boolean;
+        resolved: boolean;
+        scope?: string | undefined;
+        metadata?: Record<string, any> | undefined;
+        threshold?: number | undefined;
+        maxCost?: number | undefined;
+        budgetId?: string | undefined;
+        budgetType?: "object" | "user" | "global" | "agent" | "project" | "department" | undefined;
+        recommendations?: string[] | undefined;
+        acknowledgedBy?: string | undefined;
+        acknowledgedAt?: string | undefined;
+    }, {
+        message: string;
+        type: "threshold_warning" | "threshold_critical" | "limit_exceeded" | "anomaly_detected" | "projection_exceeded";
+        severity: "warning" | "info" | "critical";
+        id: string;
+        timestamp: string;
+        currentCost: number;
+        currency?: string | undefined;
+        scope?: string | undefined;
+        metadata?: Record<string, any> | undefined;
+        threshold?: number | undefined;
+        maxCost?: number | undefined;
+        budgetId?: string | undefined;
+        budgetType?: "object" | "user" | "global" | "agent" | "project" | "department" | undefined;
+        recommendations?: string[] | undefined;
+        acknowledged?: boolean | undefined;
+        acknowledgedBy?: string | undefined;
+        acknowledgedAt?: string | undefined;
+        resolved?: boolean | undefined;
+    }>, "many">>;
+    activeAlertCount: z.ZodDefault<z.ZodNumber>;
+    /** Recommendations */
+    recommendations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        /** Recommendation Details */
+        id: z.ZodString;
+        type: z.ZodEnum<["switch_model", "reduce_tokens", "batch_requests", "cache_results", "adjust_parameters", "limit_usage"]>;
+        /** Impact */
+        title: z.ZodString;
+        description: z.ZodString;
+        estimatedSavings: z.ZodOptional<z.ZodNumber>;
+        savingsPercentage: z.ZodOptional<z.ZodNumber>;
+        /** Implementation */
+        priority: z.ZodEnum<["low", "medium", "high"]>;
+        effort: z.ZodEnum<["low", "medium", "high"]>;
+        actionable: z.ZodDefault<z.ZodBoolean>;
+        actionSteps: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** Context */
+        targetModel: z.ZodOptional<z.ZodString>;
+        alternativeModel: z.ZodOptional<z.ZodString>;
+        affectedUsers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /** Status */
+        status: z.ZodDefault<z.ZodEnum<["pending", "accepted", "rejected", "implemented"]>>;
+        implementedAt: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "switch_model" | "reduce_tokens" | "batch_requests" | "cache_results" | "adjust_parameters" | "limit_usage";
+        status: "pending" | "accepted" | "rejected" | "implemented";
+        description: string;
+        priority: "medium" | "low" | "high";
+        title: string;
+        id: string;
+        effort: "medium" | "low" | "high";
+        actionable: boolean;
+        estimatedSavings?: number | undefined;
+        savingsPercentage?: number | undefined;
+        actionSteps?: string[] | undefined;
+        targetModel?: string | undefined;
+        alternativeModel?: string | undefined;
+        affectedUsers?: string[] | undefined;
+        implementedAt?: string | undefined;
+    }, {
+        type: "switch_model" | "reduce_tokens" | "batch_requests" | "cache_results" | "adjust_parameters" | "limit_usage";
+        description: string;
+        priority: "medium" | "low" | "high";
+        title: string;
+        id: string;
+        effort: "medium" | "low" | "high";
+        status?: "pending" | "accepted" | "rejected" | "implemented" | undefined;
+        estimatedSavings?: number | undefined;
+        savingsPercentage?: number | undefined;
+        actionable?: boolean | undefined;
+        actionSteps?: string[] | undefined;
+        targetModel?: string | undefined;
+        alternativeModel?: string | undefined;
+        affectedUsers?: string[] | undefined;
+        implementedAt?: string | undefined;
+    }>, "many">>;
+    /** Comparisons */
+    previousPeriodCost: z.ZodOptional<z.ZodNumber>;
+    costChange: z.ZodOptional<z.ZodNumber>;
+    costChangePercentage: z.ZodOptional<z.ZodNumber>;
+    /** Forecasting */
+    forecastedCost: z.ZodOptional<z.ZodNumber>;
+    forecastedBudgetStatus: z.ZodOptional<z.ZodEnum<["under", "at", "over"]>>;
+    /** Export */
+    format: z.ZodDefault<z.ZodEnum<["summary", "detailed", "executive"]>>;
+    currency: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    currency: string;
+    name: string;
+    format: "summary" | "detailed" | "executive";
+    id: string;
+    generatedAt: string;
+    period: "custom" | "daily" | "weekly" | "monthly" | "hourly" | "quarterly" | "yearly";
+    periodStart: string;
+    periodEnd: string;
+    analytics: {
+        currency: string;
+        totalCost: number;
+        periodStart: string;
+        periodEnd: string;
+        totalRequests: number;
+        averageCostPerRequest: number;
+        averageRequestsPerDay: number;
+        totalTokens?: number | undefined;
+        averageCostPerToken?: number | undefined;
+        costTrend?: "increasing" | "decreasing" | "stable" | undefined;
+        trendPercentage?: number | undefined;
+        byModel?: {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }[] | undefined;
+        byProvider?: {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }[] | undefined;
+        byUser?: {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }[] | undefined;
+        byAgent?: {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }[] | undefined;
+        byOperation?: {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }[] | undefined;
+        byDate?: {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }[] | undefined;
+        topModels?: {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }[] | undefined;
+        topUsers?: {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }[] | undefined;
+        topAgents?: {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }[] | undefined;
+        tokensPerDollar?: number | undefined;
+        requestsPerDollar?: number | undefined;
+    };
+    activeAlertCount: number;
+    recommendations?: {
+        type: "switch_model" | "reduce_tokens" | "batch_requests" | "cache_results" | "adjust_parameters" | "limit_usage";
+        status: "pending" | "accepted" | "rejected" | "implemented";
+        description: string;
+        priority: "medium" | "low" | "high";
+        title: string;
+        id: string;
+        effort: "medium" | "low" | "high";
+        actionable: boolean;
+        estimatedSavings?: number | undefined;
+        savingsPercentage?: number | undefined;
+        actionSteps?: string[] | undefined;
+        targetModel?: string | undefined;
+        alternativeModel?: string | undefined;
+        affectedUsers?: string[] | undefined;
+        implementedAt?: string | undefined;
+    }[] | undefined;
+    budgets?: {
+        currency: string;
+        type: "object" | "user" | "global" | "agent" | "project" | "department";
+        maxCost: number;
+        budgetId: string;
+        periodStart: string;
+        periodEnd: string;
+        currentCost: number;
+        percentageUsed: number;
+        remainingCost: number;
+        isExceeded: boolean;
+        isWarning: boolean;
+        lastUpdated: string;
+        scope?: string | undefined;
+        projectedCost?: number | undefined;
+        projectedOverage?: number | undefined;
+    }[] | undefined;
+    alerts?: {
+        currency: string;
+        message: string;
+        type: "threshold_warning" | "threshold_critical" | "limit_exceeded" | "anomaly_detected" | "projection_exceeded";
+        severity: "warning" | "info" | "critical";
+        id: string;
+        timestamp: string;
+        currentCost: number;
+        acknowledged: boolean;
+        resolved: boolean;
+        scope?: string | undefined;
+        metadata?: Record<string, any> | undefined;
+        threshold?: number | undefined;
+        maxCost?: number | undefined;
+        budgetId?: string | undefined;
+        budgetType?: "object" | "user" | "global" | "agent" | "project" | "department" | undefined;
+        recommendations?: string[] | undefined;
+        acknowledgedBy?: string | undefined;
+        acknowledgedAt?: string | undefined;
+    }[] | undefined;
+    previousPeriodCost?: number | undefined;
+    costChange?: number | undefined;
+    costChangePercentage?: number | undefined;
+    forecastedCost?: number | undefined;
+    forecastedBudgetStatus?: "at" | "over" | "under" | undefined;
+}, {
+    name: string;
+    id: string;
+    generatedAt: string;
+    period: "custom" | "daily" | "weekly" | "monthly" | "hourly" | "quarterly" | "yearly";
+    periodStart: string;
+    periodEnd: string;
+    analytics: {
+        totalCost: number;
+        periodStart: string;
+        periodEnd: string;
+        totalRequests: number;
+        averageCostPerRequest: number;
+        averageRequestsPerDay: number;
+        currency?: string | undefined;
+        totalTokens?: number | undefined;
+        averageCostPerToken?: number | undefined;
+        costTrend?: "increasing" | "decreasing" | "stable" | undefined;
+        trendPercentage?: number | undefined;
+        byModel?: {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }[] | undefined;
+        byProvider?: {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }[] | undefined;
+        byUser?: {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }[] | undefined;
+        byAgent?: {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }[] | undefined;
+        byOperation?: {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }[] | undefined;
+        byDate?: {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }[] | undefined;
+        topModels?: {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }[] | undefined;
+        topUsers?: {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }[] | undefined;
+        topAgents?: {
+            value: string;
+            requestCount: number;
+            totalCost: number;
+            dimension: "object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag";
+            percentageOfTotal: number;
+            totalTokens?: number | undefined;
+            periodStart?: string | undefined;
+            periodEnd?: string | undefined;
+        }[] | undefined;
+        tokensPerDollar?: number | undefined;
+        requestsPerDollar?: number | undefined;
+    };
+    currency?: string | undefined;
+    format?: "summary" | "detailed" | "executive" | undefined;
+    recommendations?: {
+        type: "switch_model" | "reduce_tokens" | "batch_requests" | "cache_results" | "adjust_parameters" | "limit_usage";
+        description: string;
+        priority: "medium" | "low" | "high";
+        title: string;
+        id: string;
+        effort: "medium" | "low" | "high";
+        status?: "pending" | "accepted" | "rejected" | "implemented" | undefined;
+        estimatedSavings?: number | undefined;
+        savingsPercentage?: number | undefined;
+        actionable?: boolean | undefined;
+        actionSteps?: string[] | undefined;
+        targetModel?: string | undefined;
+        alternativeModel?: string | undefined;
+        affectedUsers?: string[] | undefined;
+        implementedAt?: string | undefined;
+    }[] | undefined;
+    budgets?: {
+        type: "object" | "user" | "global" | "agent" | "project" | "department";
+        maxCost: number;
+        budgetId: string;
+        periodStart: string;
+        periodEnd: string;
+        percentageUsed: number;
+        remainingCost: number;
+        lastUpdated: string;
+        currency?: string | undefined;
+        scope?: string | undefined;
+        currentCost?: number | undefined;
+        isExceeded?: boolean | undefined;
+        isWarning?: boolean | undefined;
+        projectedCost?: number | undefined;
+        projectedOverage?: number | undefined;
+    }[] | undefined;
+    alerts?: {
+        message: string;
+        type: "threshold_warning" | "threshold_critical" | "limit_exceeded" | "anomaly_detected" | "projection_exceeded";
+        severity: "warning" | "info" | "critical";
+        id: string;
+        timestamp: string;
+        currentCost: number;
+        currency?: string | undefined;
+        scope?: string | undefined;
+        metadata?: Record<string, any> | undefined;
+        threshold?: number | undefined;
+        maxCost?: number | undefined;
+        budgetId?: string | undefined;
+        budgetType?: "object" | "user" | "global" | "agent" | "project" | "department" | undefined;
+        recommendations?: string[] | undefined;
+        acknowledged?: boolean | undefined;
+        acknowledgedBy?: string | undefined;
+        acknowledgedAt?: string | undefined;
+        resolved?: boolean | undefined;
+    }[] | undefined;
+    activeAlertCount?: number | undefined;
+    previousPeriodCost?: number | undefined;
+    costChange?: number | undefined;
+    costChangePercentage?: number | undefined;
+    forecastedCost?: number | undefined;
+    forecastedBudgetStatus?: "at" | "over" | "under" | undefined;
+}>;
+/**
+ * Cost Query Filters
+ */
+export declare const CostQueryFiltersSchema: z.ZodObject<{
+    /** Time Range */
+    startDate: z.ZodOptional<z.ZodString>;
+    endDate: z.ZodOptional<z.ZodString>;
+    /** Dimensions */
+    modelIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    providers: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    userIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    agentIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    operations: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    sessionIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Cost Range */
+    minCost: z.ZodOptional<z.ZodNumber>;
+    maxCost: z.ZodOptional<z.ZodNumber>;
+    /** Tags */
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Aggregation */
+    groupBy: z.ZodOptional<z.ZodArray<z.ZodEnum<["model", "provider", "user", "agent", "object", "operation", "date", "hour", "tag"]>, "many">>;
+    /** Sorting */
+    orderBy: z.ZodDefault<z.ZodOptional<z.ZodEnum<["timestamp", "cost", "tokens"]>>>;
+    orderDirection: z.ZodDefault<z.ZodOptional<z.ZodEnum<["asc", "desc"]>>>;
+    /** Pagination */
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    orderBy: "timestamp" | "tokens" | "cost";
+    orderDirection: "asc" | "desc";
+    groupBy?: ("object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag")[] | undefined;
+    providers?: string[] | undefined;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    tags?: string[] | undefined;
+    maxCost?: number | undefined;
+    modelIds?: string[] | undefined;
+    userIds?: string[] | undefined;
+    agentIds?: string[] | undefined;
+    operations?: string[] | undefined;
+    sessionIds?: string[] | undefined;
+    minCost?: number | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+}, {
+    orderBy?: "timestamp" | "tokens" | "cost" | undefined;
+    groupBy?: ("object" | "date" | "provider" | "user" | "operation" | "model" | "hour" | "agent" | "tag")[] | undefined;
+    providers?: string[] | undefined;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    tags?: string[] | undefined;
+    maxCost?: number | undefined;
+    modelIds?: string[] | undefined;
+    userIds?: string[] | undefined;
+    agentIds?: string[] | undefined;
+    operations?: string[] | undefined;
+    sessionIds?: string[] | undefined;
+    minCost?: number | undefined;
+    orderDirection?: "asc" | "desc" | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+}>;
+export type CostMetricType = z.infer<typeof CostMetricTypeSchema>;
+export type BillingPeriod = z.infer<typeof BillingPeriodSchema>;
+export type CostEntry = z.infer<typeof CostEntrySchema>;
+export type BudgetType = z.infer<typeof BudgetTypeSchema>;
+export type BudgetLimit = z.infer<typeof BudgetLimitSchema>;
+export type BudgetStatus = z.infer<typeof BudgetStatusSchema>;
+export type CostAlertType = z.infer<typeof CostAlertTypeSchema>;
+export type CostAlert = z.infer<typeof CostAlertSchema>;
+export type CostBreakdownDimension = z.infer<typeof CostBreakdownDimensionSchema>;
+export type CostBreakdownEntry = z.infer<typeof CostBreakdownEntrySchema>;
+export type CostAnalytics = z.infer<typeof CostAnalyticsSchema>;
+export type CostOptimizationRecommendation = z.infer<typeof CostOptimizationRecommendationSchema>;
+export type CostReport = z.infer<typeof CostReportSchema>;
+export type CostQueryFilters = z.infer<typeof CostQueryFiltersSchema>;
+//# sourceMappingURL=cost.zod.d.ts.map