/** Peak / off-peak rates for time-of-day billing (DeepSeek domestic). */
export interface PeakRates {
    inputPerM: number;
    outputPerM: number;
    cacheReadPerM?: number;
}
/** Per-million-token pricing for one model route. */
export interface ModelPricing {
    /** Price per 1M uncached input tokens, in the model's native currency. */
    inputPerM: number;
    /** Price per 1M output tokens (reasoning is a subdivision of output — not billed twice). */
    outputPerM: number;
    /** Price per 1M cache-read tokens; falls back to `inputPerM` when absent. */
    cacheReadPerM?: number;
    /** Price per 1M cache-write tokens; falls back to `inputPerM` when absent. */
    cacheWritePerM?: number;
    /** COMBINED billing (讯飞/百川 style): one rate for ALL tokens. */
    combinedPerM?: number;
    /** Whole-cost multiplier (e.g. Batch ×0.5). */
    discount?: number;
    /** Peak-hour rates (inputPerM/outputPerM/cacheReadPerM); requires `offPeak`. */
    peak?: PeakRates;
    /** Off-peak-hour rates; requires `peak`. */
    offPeak?: PeakRates;
    /** Epoch ms from which peak/off-peak pricing applies (before it, base rates). */
    peakOffPeakFrom?: number;
    /**
     * Beijing weekday numbers (0=Sun .. 6=Sat) on which peak/off-peak splitting
     * applies; days NOT listed (e.g. Sat/Sun) are billed flat. Omit → all 7 days split.
     */
    peakDays?: number[];
    /** Peak-hour windows in BEIJING MINUTES since midnight; 9:00-12:00 = start 540 / end 720. */
    peakWindows?: Array<{
        start: number;
        end: number;
    }>;
    /** Flat per-token rate for days NOT in `peakDays` (weekend); falls back to `offPeak` when absent. */
    weekend?: PeakRates;
    /** Billing currency, e.g. `CNY` / `USD`. */
    currency?: string;
    /** Epoch ms when this price was last refreshed. */
    updatedAt?: number;
    /** Where the price came from (`bundled` / `remote` / `user`). */
    source?: 'bundled' | 'remote' | 'user';
    /**
     * Custom user-defined unit-price rows (R5). When present and non-empty it is
     * the authoritative cost model: the whole cost = Σ per row `perM` × (tokens
     * of the buckets in that row). Rows bill at a FLAT rate per row (`perM`);
     * the peak/off-peak split is only applied by the legacy bucket path (v1).
     */
    customRows?: ModelPricingRow[];
}
/** One user-defined unit-price row (R5): a label + which token buckets it bills
 *  + the per-1M-token price for the SUM of those buckets. */
export interface ModelPricingRow {
    label: string;
    buckets: Array<'input' | 'cacheRead' | 'cacheWrite' | 'output'>;
    perM: number;
    /** Peak-window per-1M rate (overrides `perM` inside the peak window). */
    peakPerM?: number;
    /** Off-peak per-1M rate (defaults to `perM` when absent). */
    offPerM?: number;
}
/** One row of the per-model 用量 template: a label + which token buckets it sums. */
export interface BillingRow {
    label: string;
    buckets: Array<'input' | 'cacheRead' | 'cacheWrite' | 'output'>;
    /** Per-1M unit price carried by CUSTOM rows (R5); the readout uses it so a
     *  custom-row model shows its real unit price instead of a 0 from the legacy
     *  bucket fields. Present only on rows derived from `customRows`. */
    perM?: number;
    /** Flat-price (峰谷未启用) rows carry perM only. Peak/off-peak rows carry
     *  BOTH — the popup resolves which one applies by Beijing time. */
    peakPerM?: number;
    offPerM?: number;
}
/** Per-bucket cost breakdown of one usage sample (each in the pricing currency). */
export interface CostBreakdown {
    input: number;
    cacheRead: number;
    cacheWrite: number;
    output: number;
    total: number;
}
/** One turn's cost & token ledger (used by the 每轮费用 list). */
export interface TurnCost {
    turn: number;
    /** Native-currency cost of the turn (NOT display-converted). */
    cost: number;
    currency: string;
    model: string | null;
    /** 本轮实际归属的底层提供商（显示统计用，不参与计费）。 */
    provider: string | null;
    startedAt: number;
    endedAt: number;
    endReason: string | null;
    inputTokens: number;
    outputTokens: number;
    cacheReadTokens: number;
    cacheWriteTokens: number;
    reasoningTokens: number;
    /** 本轮各计费桶金额（实际峰谷价；分项展示用）。 */
    inputCost: number;
    cacheReadCost: number;
    cacheWriteCost: number;
    outputCost: number;
    /** True when this turn ran under peak pricing (else off-peak); false for no peak/off-peak pricing. */
    peak: boolean;
}
/** Live account balance served for one provider (DeepSeek API or funded ledger). */
export interface AccountBalance {
    currency: string;
    totalBalance: number;
    updatedAt: number;
    source: 'api' | 'computed';
}
/** Official bundled pricing + row template for the current model (for the reset button). */
export interface OfficialPrice {
    pricing: ModelPricing;
    rows: BillingRow[];
}
/**
 * The whole value the `usageCost` projection serves for one session.
 *
 * Token buckets are DISJOINT (they mirror `TokenUsage`): billed input is
 * `inputTokens + cacheReadTokens + cacheWriteTokens`, and `reasoningTokens`
 * is already inside `outputTokens` — never added again.
 */
export interface UsageCostValue {
    /** Successful model completions (`assistant/message` events). */
    requestCount: number;
    /** Attempted model calls (`step/start` events), including failures/retries. */
    stepCount: number;
    inputTokens: number;
    outputTokens: number;
    cacheReadTokens: number;
    cacheWriteTokens: number;
    reasoningTokens: number;
    /** Live streamed-output estimate from text/reasoning deltas (4 chars ≈ 1 token). */
    realtimeOutputTokens: number;
    /** Epoch ms of the last streamed-delta sample (0 = none yet). */
    realtimeUpdatedAt: number;
    /** Provider route of the latest request; null before any request. */
    provider: string | null;
    /** Model id of the latest request; null before any request. */
    model: string | null;
    /** Resolved pricing for the current route at "now" (peak/off-peak applied); null while unknown. */
    pricing: ModelPricing | null;
    /** The raw (un-resolved) pricing row backing `pricing`; null while unknown. */
    basePricing: ModelPricing | null;
    /** The per-model 用量 template rows (drives the detail card's 单价 column). */
    priceRows: BillingRow[];
    /** Official bundled pricing + rows for the current model (reset baseline); null when custom. */
    officialPrice: OfficialPrice | null;
    /** Display-currency total of every turn's cost (converted from each turn's native currency). */
    estimatedCost: number;
    /** Billing currency for `estimatedCost` / `budget` / `remainingBudget`. */
    currency: string;
    /** Latest USD→CNY rate (fallback 7.2); only meaningful when a conversion is active. */
    usdToCny: number;
    /** Epoch ms of the last successful exchange-rate fetch (0 = never). */
    rateUpdatedAt: number;
    /** Live account balance (DeepSeek API or funded ledger); null while unavailable. */
    accountBalance: AccountBalance | null;
    /** True when a DeepSeek balance SHOULD be shown but no value was fetched
     *  (the DeepSeek API key is missing/invalid, or the fetch failed). */
    balanceNeedsKey: boolean;
    /** Per-turn cost ledger (most recent last). */
    turns: TurnCost[];
    /** The latest turn (in-progress or just finished); null before the first turn.
     *  Powers the popup's 本轮 readout — it starts at zero each turn and grows
     *  as usage events land. */
    lastTurn: TurnCost | null;
    /** Peak/off-peak state of the CURRENT model's pricing at "now":
     *  'peak' | 'off'; null when the model has no peak/off-peak pricing. */
    peakState: 'peak' | 'off' | null;
    /** User-configured budget in `currency`; null = no budget set. */
    budget: number | null;
    /** `budget - estimatedCost`; null when no budget is set (may be negative). */
    remainingBudget: number | null;
    /** 生效的预算告警阈值（% 使用到 budget，0 = 关闭）。 */
    alertBudgetPct: number;
    /** 生效的余额告警下限（余额低于该值预警，0 = 关闭）。 */
    alertBalanceFloor: number;
}
declare module '@deepseek-ai/dsh-session-projection/types' {
    interface SessionProjectionMap {
        usageCost: UsageCostValue;
    }
}
/** Sum the three disjoint prompt-side billing buckets. */
export declare function billedInputTokens(v: Pick<UsageCostValue, 'inputTokens' | 'cacheReadTokens' | 'cacheWriteTokens'>): number;
/** Price (per 1M tokens) for a bucket under a resolved pricing row (undefined while pricing is unknown). */
export declare function bucketPricePerM(p: ModelPricing | null, b: BillingRow['buckets'][number]): number | undefined;
/** Bucket-by-bucket cost (each bucket × its own price); 0 while pricing is unknown. */
export declare function costBreakdown(usage: Pick<UsageCostValue, 'inputTokens' | 'outputTokens' | 'cacheReadTokens' | 'cacheWriteTokens'>, pricing: ModelPricing | null): CostBreakdown;
/** Cost of one usage sample under a pricing table (0 while pricing is unknown). */
export declare function costOf(usage: Pick<UsageCostValue, 'inputTokens' | 'outputTokens' | 'cacheReadTokens' | 'cacheWriteTokens'>, pricing: ModelPricing | null): number;