dsh-budget 0.1.0

package/lib/types/config.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Config schema and resolution for `dsh-budget`. Every tunable is a validated
+ * {@link Config} field changeable from cordis.yml; `resolveConfig` re-judges
+ * every default and bound so programmatic construction that bypasses
+ * Schemastery normalization still fails loud (the explicit-resolve contract).
+ *
+ * @module dsh-budget/config
+ */
+import z from '@deepseek-ai/schemastery';
+/** Display currency: code, units per USD, and decimal places. */
+export interface CurrencyConfig {
+    code?: string;
+    rate?: number;
+    decimals?: number;
+}
+/** Carbon footprint estimation. */
+export interface CarbonConfig {
+    enabled?: boolean;
+    region?: 'global' | 'us' | 'eu' | 'china' | 'india' | 'uk' | 'france' | 'iceland';
+    pue?: number;
+    energyKwhPerToken?: number;
+}
+/** Per-model latency statistics. */
+export interface LatencyConfig {
+    enabled?: boolean;
+    windowSize?: number;
+}
+/** Budget caps per scope; undefined = unlimited. */
+export interface BudgetsConfig {
+    session?: number;
+    daily?: number;
+    monthly?: number;
+}
+/** Raw plugin config — every field optional; {@link resolveConfig} supplies the defaults. */
+export interface Config {
+    /** Per-model USD prices per 1M tokens, merged over the built-in table. */
+    prices?: Record<string, {
+        input: number;
+        output: number;
+        cacheRead?: number;
+        cacheWrite?: number;
+    }>;
+    /** Fallback price for models absent from both tables. */
+    defaultPrice?: {
+        input: number;
+        output: number;
+        cacheRead?: number;
+        cacheWrite?: number;
+    };
+    /** Budget caps in USD per scope; omit a scope for unlimited. */
+    budgets?: BudgetsConfig;
+    /** Alert once usage reaches this fraction of a cap (0..1). */
+    warnRatio?: number;
+    /** Behavior after a cap is crossed: alert | block | degrade. */
+    overLimit?: 'alert' | 'block' | 'degrade';
+    /** Degradation map: model id -> cheaper model id of the SAME provider. */
+    degradation?: Record<string, string>;
+    /** Optional webhook URL for threshold alerts (POST JSON). */
+    webhookUrl?: string;
+    /** Webhook request timeout in milliseconds. */
+    webhookTimeoutMs?: number;
+    /** Master switch for threshold alerts. */
+    alertsEnabled?: boolean;
+    /** Minimum milliseconds between two alerts of the same scope. */
+    alertCooldownMs?: number;
+    /** Browser desktop notifications for new alerts. */
+    desktopNotifications?: boolean;
+    /** Settings budget tab polling interval in milliseconds. */
+    refreshIntervalMs?: number;
+    /** Carbon footprint estimation. */
+    carbon?: CarbonConfig;
+    /** Per-model latency statistics. */
+    latency?: LatencyConfig;
+    /** Display currency. */
+    currency?: CurrencyConfig;
+    /** /budget command output language: en | zh. */
+    outputLanguage?: 'en' | 'zh';
+    /** Days of per-day usage history kept in the panel snapshot. */
+    historyDays?: number;
+}
+/** Fully resolved config. */
+export interface ResolvedConfig {
+    readonly prices: Record<string, {
+        input: number;
+        output: number;
+        cacheRead?: number;
+        cacheWrite?: number;
+    }>;
+    readonly defaultPrice: {
+        input: number;
+        output: number;
+        cacheRead?: number;
+        cacheWrite?: number;
+    };
+    readonly budgets: BudgetsConfig;
+    readonly warnRatio: number;
+    readonly overLimit: 'alert' | 'block' | 'degrade';
+    readonly degradation: Record<string, string>;
+    readonly webhookUrl: string | undefined;
+    readonly webhookTimeoutMs: number;
+    readonly alertsEnabled: boolean;
+    readonly alertCooldownMs: number;
+    readonly desktopNotifications: boolean;
+    readonly refreshIntervalMs: number;
+    readonly carbon: {
+        enabled: boolean;
+        region: string;
+        pue: number;
+        energyKwhPerToken: number;
+    };
+    readonly latency: {
+        enabled: boolean;
+        windowSize: number;
+    };
+    readonly currency: {
+        code: string;
+        rate: number;
+        decimals: number;
+    };
+    readonly outputLanguage: 'en' | 'zh';
+    readonly historyDays: number;
+}
+/** Schemastery schema: the loader validates and fills defaults before `apply`. */
+export declare const Config: z<Config>;
+/**
+ * Resolve raw config to the runtime policy, re-validating defaults and bounds.
+ *
+ * @param config - raw loader config; `undefined` for a bare row.
+ * @returns the frozen resolved config.
+ */
+export declare function resolveConfig(config: Config | undefined): ResolvedConfig;
+//# sourceMappingURL=config.d.ts.map

package/lib/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"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"}

package/lib/types/estimate/carbon.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Port of the AI-Carbon-Footprint-Calculator data and formulas
+ * (`upstream/AI-Carbon-Footprint-Calculator/src/ai_carbon_footprint/data.py`
+ * + `core.py` + `comparisons.py`, commit d8d52b5, Apache-2.0): GPU TDP table,
+ * regional grid carbon intensity (kg CO2e/kWh), PUE constants, the
+ * GPU-hours → energy → CO2 formula, and the equivalence comparisons.
+ *
+ * The plugin bridges LLM tokens onto this model through
+ * {@link tokenCarbon}: IT energy = tokens × kWh/token, total energy = IT × PUE,
+ * CO2 = total energy × regional intensity. `energyKwhPerToken` is configurable
+ * (`config.carbon.energyKwhPerToken`); its default derivation is documented in
+ * cordis.patch.yml.
+ *
+ * @module dsh-budget/estimate/carbon
+ */
+/** GPU TDP specifications, verbatim from upstream data.py. */
+export interface GpuSpec {
+    /** Thermal design power in watts. */
+    tdp: number;
+    /** Display name. */
+    name: string;
+    /** Upstream category tag. */
+    category: string;
+}
+/** The upstream GPU table (17 entries), verbatim. */
+export declare const GPU_SPECS: Readonly<Record<string, GpuSpec>>;
+/** Regional grid carbon intensity in kg CO2e per kWh, verbatim from upstream. */
+export declare const CARBON_INTENSITY: Readonly<Record<string, number>>;
+/** Upstream default power usage effectiveness. */
+export declare const DEFAULT_PUE = 1.58;
+/** Upstream "efficient" PUE reference. */
+export declare const EFFICIENT_PUE = 1.2;
+/** Upstream "hyperscale" PUE reference. */
+export declare const HYPERSCALE_PUE = 1.1;
+/** One GPU-hours workload's carbon result. */
+export interface CarbonResult {
+    /** GPU display name. */
+    gpuName: string;
+    /** GPU table key. */
+    gpuModel: string;
+    /** GPU count. */
+    numGpus: number;
+    /** Runtime in hours. */
+    hours: number;
+    /** Utilization factor (0..1]. */
+    utilization: number;
+    /** Effective PUE. */
+    pue: number;
+    /** Electricity region key. */
+    region: string;
+    /** IT energy in kWh (before PUE). */
+    energyKwh: number;
+    /** Total energy in kWh (after PUE). */
+    totalEnergyKwh: number;
+    /** Emissions in kg CO2e. */
+    co2Kg: number;
+    /** Regional intensity used, kg CO2e/kWh. */
+    carbonIntensity: number;
+}
+/**
+ * Compute the carbon footprint of a GPU-hours workload.
+ *
+ * @param gpuModel - GPU table key.
+ * @param hours - runtime in hours.
+ * @param numGpus - GPU count (default 1).
+ * @param pue - power usage effectiveness (default {@link DEFAULT_PUE}).
+ * @param region - electricity region key (default `global`).
+ * @param utilization - GPU utilization in (0, 1] (default 1).
+ * @returns the calculation result.
+ * @throws on an unknown GPU, an unknown region, or an out-of-range utilization.
+ */
+export declare function calculateCarbonFootprint(gpuModel: string, hours: number, numGpus?: number, pue?: number, region?: string, utilization?: number): CarbonResult;
+/** One real-world equivalence reference (upstream `co2_kg` comparison table). */
+export interface CarbonComparison {
+    /** Human-readable name. */
+    name: string;
+    /** Emoji marker from the upstream table. */
+    emoji: string;
+    /** Reference emissions in kg CO2e. */
+    co2Kg: number;
+}
+/** The upstream comparison references, verbatim from comparisons.py. */
+export declare const COMPARISONS: Readonly<Record<string, CarbonComparison>>;
+/** One computed equivalence: how many reference units a CO2 amount equals. */
+export interface CarbonEquivalence {
+    /** Reference name. */
+    name: string;
+    /** Reference emoji. */
+    emoji: string;
+    /** `co2Kg / reference`. */
+    equivalent: number;
+    /** Reference emissions in kg CO2e. */
+    unitCo2: number;
+}
+/**
+ * Pick the top-3 most relevant real-world equivalences for an emissions
+ * amount, upstream style: only references within 0.1×–10× qualify, sorted by
+ * closeness to 1×.
+ *
+ * @param co2Kg - emissions in kg CO2e.
+ * @returns up to three equivalences, closest first.
+ */
+export declare function getComparisons(co2Kg: number): CarbonEquivalence[];
+/** Token-bridge carbon result for one token volume. */
+export interface TokenCarbonResult {
+    /** IT energy in kWh (tokens × kWh/token). */
+    energyKwh: number;
+    /** Total energy in kWh (IT × PUE). */
+    totalEnergyKwh: number;
+    /** Emissions in kg CO2e. */
+    co2Kg: number;
+    /** Regional intensity used, kg CO2e/kWh. */
+    carbonIntensity: number;
+}
+/**
+ * Estimate the carbon footprint of a token volume (the plugin's token→carbon
+ * bridge): energy = tokens × kWh/token, total = energy × PUE,
+ * CO2 = total × regional intensity.
+ *
+ * @param tokens - total tokens processed (all buckets).
+ * @param energyKwhPerToken - IT energy per token in kWh.
+ * @param pue - power usage effectiveness.
+ * @param region - electricity region key.
+ * @returns the estimation result.
+ * @throws on an unknown region.
+ */
+export declare function tokenCarbon(tokens: number, energyKwhPerToken: number, pue: number, region: string): TokenCarbonResult;
+//# sourceMappingURL=carbon.d.ts.map

package/lib/types/estimate/carbon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"carbon.d.ts","sourceRoot":"","sources":["../../../src/estimate/carbon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,8DAA8D;AAC9D,MAAM,WAAW,OAAO;IACtB,qCAAqC;IACrC,GAAG,EAAE,MAAM,CAAA;IACX,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,qDAAqD;AACrD,eAAO,MAAM,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkBtD,CAAA;AAEF,iFAAiF;AACjF,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAS5D,CAAA;AAEF,kDAAkD;AAClD,eAAO,MAAM,WAAW,OAAO,CAAA;AAC/B,0CAA0C;AAC1C,eAAO,MAAM,aAAa,MAAM,CAAA;AAChC,2CAA2C;AAC3C,eAAO,MAAM,cAAc,MAAM,CAAA;AAEjC,8CAA8C;AAC9C,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,iBAAiB;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAA;IACnB,qBAAqB;IACrB,GAAG,EAAE,MAAM,CAAA;IACX,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAA;IACjB,uCAAuC;IACvC,cAAc,EAAE,MAAM,CAAA;IACtB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,4CAA4C;IAC5C,eAAe,EAAE,MAAM,CAAA;CACxB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,SAAI,EACX,GAAG,GAAE,MAAoB,EACzB,MAAM,SAAW,EACjB,WAAW,SAAM,GAChB,YAAY,CAsBd;AAED,iFAAiF;AACjF,MAAM,WAAW,gBAAgB;IAC/B,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAA;IACb,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAA;CACd;AAED,wEAAwE;AACxE,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAMjE,CAAA;AAEF,8EAA8E;AAC9E,MAAM,WAAW,iBAAiB;IAChC,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAA;IAClB,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAUjE;AAED,uDAAuD;AACvD,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAA;IACjB,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAA;IACtB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,4CAA4C;IAC5C,eAAe,EAAE,MAAM,CAAA;CACxB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,MAAM,EACzB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GACb,iBAAiB,CAMnB"}

package/lib/types/estimate/cost.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Port of the LLM-Cost-Estimator-CN cost formulas
+ * (`upstream/LLM-Cost-Estimator-CN/src/llm_cost_estimator_cn/core.py` +
+ * `utils.py`, commit aa6cc2f, Apache-2.0): per-1k-token pricing, cheapest-first
+ * sorting, the ¥ currency formatter and the percentage-diff helper.
+ *
+ * @module dsh-budget/estimate/cost
+ */
+/** A price entry used by {@link calculateCosts}. */
+export interface CostPriceEntry {
+    /** Input price per 1000 tokens. */
+    inputPricePer1k: number;
+    /** Output price per 1000 tokens. */
+    outputPricePer1k: number;
+}
+/** One model's cost estimate, as produced by the upstream calculator. */
+export interface CostEstimate {
+    /** Model table key. */
+    modelId: string;
+    /** Provider display name. */
+    provider: string;
+    /** Model display name. */
+    modelName: string;
+    /** Input cost for the requested tokens. */
+    inputCost: number;
+    /** Output cost for the requested tokens. */
+    outputCost: number;
+    /** `inputCost + outputCost`. */
+    totalCost: number;
+}
+/** Entry shape the upstream calculator iterates (id → price + display fields). */
+export interface CostTableEntry extends CostPriceEntry {
+    /** Provider display name. */
+    provider: string;
+    /** Model display name. */
+    name: string;
+}
+/**
+ * Calculate every model's cost for the given token counts, cheapest first.
+ *
+ * @param models - id → price/display entry table.
+ * @param inputTokens - number of input tokens.
+ * @param outputTokens - number of output tokens.
+ * @returns the estimates sorted by ascending `totalCost`.
+ */
+export declare function calculateCosts(models: Readonly<Record<string, CostTableEntry>>, inputTokens: number, outputTokens: number): CostEstimate[];
+/**
+ * Estimate every built-in upstream model's cost, cheapest first.
+ *
+ * @param inputTokens - number of input tokens.
+ * @param outputTokens - number of output tokens.
+ * @returns the estimates sorted by ascending `totalCost`.
+ */
+export declare function calculateUpstreamCosts(inputTokens: number, outputTokens: number): CostEstimate[];
+/**
+ * Format an amount with the upstream ¥ style (4 decimal places).
+ *
+ * @param amount - numeric amount.
+ * @returns `¥` plus the amount fixed to 4 decimals.
+ */
+export declare function formatCurrencyCny(amount: number): string;
+/**
+ * Compute the percentage difference against a baseline, upstream style.
+ *
+ * @param value - the value to compare.
+ * @param baseline - the reference value.
+ * @returns `N/A` for a zero baseline, a literal `基准` marker when equal,
+ *   otherwise a signed percentage with one decimal.
+ */
+export declare function percentageDiff(value: number, baseline: number): string;
+//# sourceMappingURL=cost.d.ts.map

package/lib/types/estimate/cost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost.d.ts","sourceRoot":"","sources":["../../../src/estimate/cost.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,oDAAoD;AACpD,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,eAAe,EAAE,MAAM,CAAA;IACvB,oCAAoC;IACpC,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAED,yEAAyE;AACzE,MAAM,WAAW,YAAY;IAC3B,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAA;IACjB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAA;IAClB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,kFAAkF;AAClF,MAAM,WAAW,cAAe,SAAQ,cAAc;IACpD,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,EAChD,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,YAAY,EAAE,CAgBhB;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,YAAY,EAAE,CAEhG;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKtE"}

package/lib/types/estimate/latency-stats.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Port of the Mode-Latency-Benchmark provider table and request builders
+ * (`upstream/Mode-Latency-Benchmark/src/model_latency_benchmark/core.py`,
+ * commit 8123838, Apache-2.0), plus the percentile statistics the plugin
+ * aggregates from measured call durations.
+ *
+ * The upstream tool probes providers over HTTP; the plugin reuses its
+ * `BenchmarkResult` vocabulary (ttft / total time / tokens / error) and adds
+ * `latencyStats` for per-model percentile aggregation over the llm/stream
+ * wrapper.
+ *
+ * @module dsh-budget/estimate/latency-stats
+ */
+/** Authentication style of one upstream provider config. */
+export type ProviderAuthType = 'bearer' | 'query_param';
+/** One provider config entry, verbatim from upstream core.py. */
+export interface ProviderSpec {
+    /** Display name. */
+    name: string;
+    /** HTTP endpoint. */
+    endpoint: string;
+    /** Environment variable carrying the API key. */
+    envKey: string;
+    /** Default model id. */
+    model: string;
+    /** Authentication style. */
+    authType: ProviderAuthType;
+    /** Terminal color tag. */
+    color: string;
+    /** Terminal icon. */
+    icon: string;
+}
+/** The upstream provider table (4 entries), verbatim. */
+export declare const PROVIDERS: Readonly<Record<string, ProviderSpec>>;
+/** One benchmark outcome (upstream BenchmarkResult vocabulary). */
+export interface BenchmarkResult {
+    /** Provider table key. */
+    providerId: string;
+    /** Provider display name. */
+    providerName: string;
+    /** Time to first token in seconds; null when never reached. */
+    ttft: number | null;
+    /** Total response time in seconds; null on failure. */
+    totalTime: number | null;
+    /** Chunk/token count observed. */
+    tokens: number;
+    /** Failure detail; null on success. */
+    error: string | null;
+    /** Whether the run completed. */
+    success: boolean;
+}
+/**
+ * Build the request headers for one provider, upstream style.
+ *
+ * @param provider - provider config (reads `authType` only).
+ * @param apiKey - provider API key (used only for bearer auth).
+ * @returns the header map.
+ */
+export declare function buildRequestHeaders(provider: Readonly<ProviderSpec>, apiKey: string): Record<string, string>;
+/**
+ * Build the request body for one provider, upstream style.
+ *
+ * @param provider - provider config.
+ * @param prompt - the user prompt.
+ * @returns the JSON body object.
+ */
+export declare function buildRequestBody(provider: Readonly<ProviderSpec>, prompt: string): Record<string, unknown>;
+/**
+ * Build the request URL for one provider, upstream style (query-param auth
+ * appends the key).
+ *
+ * @param provider - provider config.
+ * @param apiKey - provider API key (used only for query-param auth).
+ * @returns the request URL.
+ */
+export declare function buildRequestUrl(provider: Readonly<ProviderSpec>, apiKey: string): string;
+/** Percentile statistics over one duration sample window (milliseconds). */
+export interface LatencyStats {
+    /** Sample count. */
+    count: number;
+    /** Arithmetic mean (ms). */
+    mean: number;
+    /** Minimum (ms). */
+    min: number;
+    /** Maximum (ms). */
+    max: number;
+    /** 50th percentile (ms). */
+    p50: number;
+    /** 95th percentile (ms). */
+    p95: number;
+    /** 99th percentile (ms). */
+    p99: number;
+    /** Population standard deviation (ms). */
+    stdev: number;
+}
+/**
+ * Aggregate latency statistics over a sample window. Deterministic and pure:
+ * callers own the sample retention policy.
+ *
+ * @param samples - durations in milliseconds (any order, may be empty).
+ * @returns the statistics; every field is 0 for an empty window.
+ */
+export declare function latencyStats(samples: readonly number[]): LatencyStats;
+/**
+ * Format a millisecond duration the way the upstream tool displays it.
+ *
+ * @param ms - duration in milliseconds.
+ * @returns `123ms` for sub-second values, `1.23s` otherwise.
+ */
+export declare function formatMs(ms: number): string;
+//# sourceMappingURL=latency-stats.d.ts.map

package/lib/types/estimate/latency-stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"latency-stats.d.ts","sourceRoot":"","sources":["../../../src/estimate/latency-stats.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,4DAA4D;AAC5D,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,aAAa,CAAA;AAEvD,iEAAiE;AACjE,MAAM,WAAW,YAAY;IAC3B,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAA;IACd,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,4BAA4B;IAC5B,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,yDAAyD;AACzD,eAAO,MAAM,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAqC3D,CAAA;AAEF,mEAAmE;AACnE,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAA;IAClB,6BAA6B;IAC7B,YAAY,EAAE,MAAM,CAAA;IACpB,+DAA+D;IAC/D,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,uDAAuD;IACvD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAA;IACd,uCAAuC;IACvC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,iCAAiC;IACjC,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAI5G;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAK1G;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGxF;AAED,4EAA4E;AAC5E,MAAM,WAAW,YAAY;IAC3B,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,oBAAoB;IACpB,GAAG,EAAE,MAAM,CAAA;IACX,oBAAoB;IACpB,GAAG,EAAE,MAAM,CAAA;IACX,4BAA4B;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,4BAA4B;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,4BAA4B;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAA;CACd;AAoBD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,YAAY,CAkBrE;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAG3C"}

package/lib/types/estimate/models.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Port of the LLM-Cost-Estimator-CN price table
+ * (`upstream/LLM-Cost-Estimator-CN/src/llm_cost_estimator_cn/data/models.json`,
+ * commit aa6cc2f, Apache-2.0). Values are kept VERBATIM: CNY per 1k tokens.
+ *
+ * This table is the fixture source for the ported cost formulas in
+ * {@link ./cost.ts}; the plugin's operational USD-per-1M price table lives in
+ * {@link ./prices.ts} and is maintained separately.
+ *
+ * @module dsh-budget/estimate/models
+ */
+/** One entry of the upstream Chinese-model price table (CNY per 1k tokens). */
+export interface UpstreamCostModelEntry {
+    /** Upstream provider display name. */
+    provider: string;
+    /** Upstream model display name. */
+    name: string;
+    /** Input price, CNY per 1000 tokens. */
+    inputPricePer1k: number;
+    /** Output price, CNY per 1000 tokens. */
+    outputPricePer1k: number;
+    /** Upstream price currency code. */
+    currency: string;
+    /** Upstream free-form note. */
+    notes?: string;
+}
+/** The upstream price table, verbatim from models.json. */
+export declare const UPSTREAM_MODELS: Readonly<Record<string, UpstreamCostModelEntry>>;
+//# sourceMappingURL=models.d.ts.map

package/lib/types/estimate/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../../src/estimate/models.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,+EAA+E;AAC/E,MAAM,WAAW,sBAAsB;IACrC,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAA;IAChB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAA;IACZ,wCAAwC;IACxC,eAAe,EAAE,MAAM,CAAA;IACvB,yCAAyC;IACzC,gBAAgB,EAAE,MAAM,CAAA;IACxB,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAA;IAChB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,2DAA2D;AAC3D,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAyD3E,CAAA"}

package/lib/types/estimate/prices.d.ts

@@ -0,0 +1,85 @@
+/**
+ * The plugin's operational price table: USD per 1M tokens, merged with
+ * `config.prices` at load. Entries marked `source: 'vendor'` were authored
+ * from vendor pricing pages at porting time; entries marked
+ * `source: 'upstream-cny'` were converted from the ported
+ * LLM-Cost-Estimator-CN table (CNY per 1k tokens) with the fixed rate
+ * {@link UPSTREAM_CNY_PER_USD} captured at porting time. Prices drift — treat
+ * this table as a starting point and override entries via `config.prices`.
+ *
+ * @module dsh-budget/estimate/prices
+ */
+/** Where a built-in entry's numbers came from. */
+export type PriceSource = 'vendor' | 'upstream-cny';
+/** USD price per 1M tokens. Cache fields follow the harness TokenUsage split. */
+export interface PriceEntry {
+    /** Uncached input tokens. */
+    input: number;
+    /** Output tokens. */
+    output: number;
+    /** Cached (hit) input tokens; defaults to `input` when absent. */
+    cacheRead?: number;
+    /** Cache-miss (written) input tokens; defaults to `input` when absent. */
+    cacheWrite?: number;
+    /** Provenance metadata for built-in entries. */
+    source?: PriceSource;
+}
+/**
+ * Fixed CNY→USD rate used when converting the upstream CNY-per-1k table into
+ * USD-per-1M entries, captured at porting time. It is a conversion constant
+ * of the shipped DATA, not a runtime exchange rate; override any converted
+ * entry via `config.prices` when vendor USD pricing is available.
+ */
+export declare const UPSTREAM_CNY_PER_USD = 7.2;
+/**
+ * Convert an upstream CNY-per-1k price into USD per 1M tokens.
+ *
+ * @param cnyPer1k - price in CNY per 1000 tokens.
+ * @returns the price in USD per 1,000,000 tokens.
+ */
+export declare function cnyPer1kToUsdPer1m(cnyPer1k: number): number;
+/** The built-in price table (USD per 1M tokens). */
+export declare const BUILTIN_PRICES: Readonly<Record<string, PriceEntry>>;
+/**
+ * Merge the user table over the built-in table (per-model override).
+ *
+ * @param custom - `config.prices` entries.
+ * @returns the merged table; custom entries win per model id.
+ */
+export declare function mergePrices(custom: Readonly<Record<string, PriceEntry>>): Record<string, PriceEntry>;
+/**
+ * Resolve the price for one exact route: `${provider}/${model}` first, then
+ * the bare model id, then the fallback.
+ *
+ * @param table - merged price table.
+ * @param fallback - price for models absent from the table.
+ * @param provider - registered provider route.
+ * @param model - model id.
+ * @returns the effective price entry (never undefined).
+ */
+export declare function priceFor(table: Readonly<Record<string, PriceEntry>>, fallback: Readonly<PriceEntry>, provider: string, model: string): PriceEntry;
+/** Cost breakdown for one usage record. */
+export interface UsageCost {
+    /** Uncached input cost (USD). */
+    inputCost: number;
+    /** Output cost (USD). */
+    outputCost: number;
+    /** Cache-hit input cost (USD). */
+    cacheReadCost: number;
+    /** Cache-miss input cost (USD). */
+    cacheWriteCost: number;
+    /** Sum of all four buckets (USD). */
+    totalCost: number;
+}
+/**
+ * Price one disjoint token usage record.
+ *
+ * @param price - effective price entry.
+ * @param inputTokens - uncached input tokens.
+ * @param outputTokens - output tokens.
+ * @param cacheReadTokens - cache-hit tokens (0 when absent).
+ * @param cacheWriteTokens - cache-miss tokens (0 when absent).
+ * @returns the USD cost breakdown.
+ */
+export declare function estimateUsageCost(price: Readonly<PriceEntry>, inputTokens: number, outputTokens: number, cacheReadTokens: number, cacheWriteTokens: number): UsageCost;
+//# sourceMappingURL=prices.d.ts.map

package/lib/types/estimate/prices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prices.d.ts","sourceRoot":"","sources":["../../../src/estimate/prices.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,kDAAkD;AAClD,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,cAAc,CAAA;AAEnD,iFAAiF;AACjF,MAAM,WAAW,UAAU;IACzB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,gDAAgD;IAChD,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,MAAM,CAAA;AAEvC;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,oDAAoD;AACpD,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAmB9D,CAAA;AAEF;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAEpG;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,EAC3C,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,EAC9B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,UAAU,CAEZ;AAED,2CAA2C;AAC3C,MAAM,WAAW,SAAS;IACxB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,kCAAkC;IAClC,aAAa,EAAE,MAAM,CAAA;IACrB,mCAAmC;IACnC,cAAc,EAAE,MAAM,CAAA;IACtB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,EAC3B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,EACvB,gBAAgB,EAAE,MAAM,GACvB,SAAS,CAMX"}

package/lib/types/estimate/sanitize.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Sanitization and formatting pure functions. Every display/log surface of
+ * dsh-budget goes through these: webhook URLs, alert text, token counts and
+ * money amounts. Never log or render a raw config or wire value.
+ *
+ * @module dsh-budget/estimate/sanitize
+ */
+/**
+ * Make arbitrary text safe for one-line display and logs: strip control and
+ * invisible characters, collapse whitespace runs, truncate with an ellipsis.
+ *
+ * @param input - raw text (possibly hostile).
+ * @param maxLength - output length cap (default 200).
+ * @returns the sanitized text.
+ */
+export declare function sanitizeText(input: string, maxLength?: number): string;
+/**
+ * Redact credentials from a URL for display and logs: the userinfo component
+ * (`user:pass@`) is replaced, the rest is kept, and overlong URLs are cut.
+ * Query parameters are preserved verbatim — a webhook URL's own secret query
+ * tokens are the operator's responsibility to rotate, but the userinfo is
+ * always redacted.
+ *
+ * @param input - raw URL (possibly hostile).
+ * @param maxLength - output length cap (default 512).
+ * @returns the redacted URL, or '' when it cannot be parsed.
+ */
+export declare function sanitizeUrl(input: string, maxLength?: number): string;
+/** Display-currency options for {@link formatMoney}. */
+export interface MoneyFormat {
+    /** Currency code placed before the amount (display only). */
+    code: string;
+    /** Display-currency units per 1 USD (1 = USD). */
+    rate: number;
+    /** Decimal places. */
+    decimals: number;
+}
+/**
+ * Format a USD amount in the configured display currency, deterministically
+ * (no locale-dependent grouping): converted by `rate`, rounded to `decimals`
+ * places, grouped with commas, prefixed with the currency code.
+ *
+ * @param usd - amount in USD.
+ * @param format - display options.
+ * @returns e.g. `USD 1,234.57`; non-finite input renders as `USD 0.00`.
+ */
+export declare function formatMoney(usd: number, format: Readonly<MoneyFormat>): string;
+/**
+ * Format a token count compactly: `999` stays as-is, `1234` → `1.23k`,
+ * `4_500_000` → `4.50M`.
+ *
+ * @param tokens - non-negative token count.
+ * @returns the compact string.
+ */
+export declare function formatTokens(tokens: number): string;
+//# sourceMappingURL=sanitize.d.ts.map

package/lib/types/estimate/sanitize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../../src/estimate/sanitize.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG,MAAM,CAKnE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,SAAM,GAAG,MAAM,CAclE;AAED,wDAAwD;AACxD,MAAM,WAAW,WAAW;IAC1B,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAA;IACZ,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAA;IACZ,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAcD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,MAAM,CAW9E;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKnD"}