mirror of
https://github.com/diegosouzapw/OmniRoute.git
synced 2026-08-02 13:22:11 +03:00
* chore(release): open v3.8.14 development cycle Version bump 3.8.13 -> 3.8.14 (root + electron + open-sse + openapi + lockfiles). Seed the v3.8.14 changelog with the four post-tag hotfixes that shipped to Docker/Electron in v3.8.13 but missed the immutable npm 3.8.13 (#3336 SSRF / CodeQL #323, #3334/#3335/#3339 Electron packaging). i18n CHANGELOG mirrors get the in-progress placeholder section. * feat: add per-provider custom headers support for OpenAI/Anthropic-compatible nodes (#3338) Integrated into release/v3.8.14 * fix: Kiro Builder ID token import fails with Bad credentials (#3333) Integrated into release/v3.8.14 — adds Builder ID cached-creds + OIDC refresh path for Kiro token import, with regression tests (#3333). * Improve code quality: auto-pr/docstrings-1780792063 (#3337) Integrated into release/v3.8.14 — docstring for context analytics route re-export. * fix(catalog): remove minimaxai/minimax-m3 from NVIDIA NIM tier (404 upstream) (#3329) (#3341) NVIDIA NIM does not host minimaxai/minimax-m3 — every request returns 404 page not found, while sibling minimaxai/minimax-m2.7 on the same provider works. Advertising a model that 404s is a catalog bug; remove it from the nvidia tier (it remains on the tiers that actually serve MiniMax M3). Re-add only once NVIDIA serves it. Co-authored-by: mikmaneggahommie <mikmaneggahommie@users.noreply.github.com> * fix(cli): write OpenCode config to ~/.config on all platforms incl. Windows (#3330) (#3343) resolveOpencodeConfigDir used %APPDATA% on Windows, but OpenCode reads its config from XDG ~/.config/opencode/ on every platform (on Windows: %USERPROFILE%\.config\opencode\, NOT %APPDATA%). So a Windows user who configured OpenCode via the dashboard had the file written where OpenCode never looks — it silently had no effect. Use the XDG path (XDG_CONFIG_HOME || ~/.config) unconditionally. Update the UI note + route JSDoc, and flip the three tests that encoded the old %APPDATA% behavior (t40 per-platform + card-note, cli-runtime-extended getCliConfigPaths). Co-authored-by: abdulkadirozyurt <abdulkadirozyurt@users.noreply.github.com> * fix(proxy): make auto-selection fallback opt-in (#3332) (#3344) selectWorkingProxyFallback (Step 11 of resolveProxyForConnection) listed ALL registry proxies, ignoring assignments and per-connection proxy_enabled, and returned the first working one with level:'autoSelect'. So a single proxy added to the registry silently became a global fallback for every connection's traffic. Gate it behind a new PROXY_AUTO_SELECT_ENABLED feature flag (default off): the fallback now no-ops unless the operator opts in. No registry proxy becomes a silent global default anymore. Co-authored-by: hertznsk <hertznsk@users.noreply.github.com> * fix(sse): treat MiniMax M3 as multimodal so vision isn't stripped (#3328) (#3342) MiniMax M3 via the opencode provider (oc/minimax-m3-free) appeared blind: image inputs didn't reach the model, while the same model in Cline could see them. Verified empirically that MiniMax M3 on the opencode upstream IS multimodal -- a base64 image is described correctly (it returns 403 only for remote image URLs, which it doesn't accept). Root cause: OmniRoute treated MiniMax M3 as a non-vision model in two places, so when compression was active the image was replaced with a text placeholder before dispatch: - compression's modelSupportsVision() heuristic (lite.ts) only matched gpt-4/4o/claude-3/gemini/vision -- minimax was absent -> replaceImageUrls stripped the image. - the opencode minimax-m3-free catalog entry lacked supportsVision, so the combo vision-capability gate could also exclude/mishandle it. Add 'minimax-m3' to the vision heuristic and supportsVision: true to the opencode minimax-m3-free entry. TDD: a failing-then-passing test in compression/lite.test.ts proves replaceImageUrls now keeps images for minimax-m3 ids, plus a registry assertion mirroring the #2822 qwen test. Reported-by: @mikmaneggahommie * docs(i18n): translate 25 core documentation files to Indonesian (#3348) Integrated into release/v3.8.14 — Indonesian i18n docs. * fix(review): resolve /review-reviews battery findings (LEDGER-1..11) on v3.8.14 (#3350) Integrated into release/v3.8.14 — /review-reviews battery hardening (LEDGER-1..11) for #3338 custom-headers + #3333 kiro, plus cycle-test drift fixes (#3329/#3330/#3332). * fix(provider-proxy): honor per-account proxy toggles (#3349) Integrated into release/v3.8.14 — honor per-account proxy toggles + auto-fallback opt-in via PROXY_AUTO_SELECT_ENABLED. * fix(dashboard): remove duplicate Distribute Proxies button on provider page (#3352) * fix(providers): reduce proxy label noise (#3346) Integrated into release/v3.8.14 — reduce proxy label noise + a11y (aria-label/sr-only). * fix(duckduckgo): restore bare Response contract and rebase onto release/v3.8.14 (#3323) Integrated into release/v3.8.14 — browser-backed cookie providers (duckduckgo/claude-web) with restored executor contract + unit tests. * fix(noauth): expose only usable model aliases (#3345) Integrated into release/v3.8.14 — noauth usable-alias filtering + registry alias plumbing (veo-free). * fix(dashboard): stop infinite config-load loop on Hermes Agent detail page (#3353) * fix(electron): tree-kill the server on exit/update to release the omniroute.exe lock (#3347) (#3354) * chore(release): finalize v3.8.14 changelog + clear release-gate drift - CHANGELOG: finalize the v3.8.14 section (date, full New Features/Bug Fixes/ Maintenance coverage of all 16 cycle commits, Contributors hall of 12). - docs: document OMNIROUTE_BROWSER_POOL + WEB_COOKIE_USE_BROWSER (#3323) in .env.example + ENVIRONMENT.md; regenerate the id/llm.txt strict mirror (#3348 had translated it; llm.txt mirrors must match root). - test(proxy-fetch): #3323 made tlsClient.available a computed getter — stub it via Object.defineProperty instead of assignment (5 tests were red on the base). * fix(translator): coerce Gemini functionDeclaration parameters to an OBJECT schema (#3357) (#3360) * fix(gemini): resolve truncation/suppression of false positive textual tool call markers in backticks (#3358) Integrated into release/v3.8.14 — Gemini/Antigravity textual tool-call marker normalization (no false-positive suppression + split-chunk buffering). * docs(changelog): add #3358 Gemini textual tool-call normalization to v3.8.14 * fix(dashboard): surface real analytics error instead of generic placeholder (#3356) (#3361) The Analytics page discarded the server's error body on a non-OK response and rendered a generic "An error occurred", so users (and maintainers) could not see why /api/usage/analytics 500'd after an upgrade. Now the route returns the real reason via buildErrorBody (sanitized, Hard Rule #12) and the page surfaces it via a new readFetchErrorMessage helper that handles both the OpenAI-style and legacy error shapes. Reported-by: @superti4r --------- Co-authored-by: PizzaV <103120356+pizzav-xyz@users.noreply.github.com> Co-authored-by: Someres <168349709+quanturbo@users.noreply.github.com> Co-authored-by: Dong Mengzhe <154944819+Lang-Qiu@users.noreply.github.com> Co-authored-by: mikmaneggahommie <mikmaneggahommie@users.noreply.github.com> Co-authored-by: abdulkadirozyurt <abdulkadirozyurt@users.noreply.github.com> Co-authored-by: hertznsk <hertznsk@users.noreply.github.com> Co-authored-by: Krisna Santosa <54174372+KrisnaSantosa15@users.noreply.github.com> Co-authored-by: Randi <55005611+rdself@users.noreply.github.com> Co-authored-by: Wilson <pedbookmed@gmail.com> Co-authored-by: Paijo <14921983+oyi77@users.noreply.github.com> Co-authored-by: Ardem2025 <ardemb22@gmail.com>
415 lines
14 KiB
TypeScript
415 lines
14 KiB
TypeScript
"use client";
|
|
|
|
import { useState, useEffect, useCallback, useMemo, useRef } from "react";
|
|
import { useTranslations } from "next-intl";
|
|
import Card from "./Card";
|
|
import { CardSkeleton } from "./Loading";
|
|
import { fmtCompact as fmt, fmtFull, fmtCost } from "@/shared/utils/formatting";
|
|
import { readFetchErrorMessage } from "@/shared/utils/fetchError";
|
|
import {
|
|
StatCard,
|
|
CompactStatGrid,
|
|
ActivityHeatmap,
|
|
DailyTrendChart,
|
|
AccountDonut,
|
|
ApiKeyDonut,
|
|
ApiKeyTable,
|
|
MostActiveDay7d,
|
|
WeeklySquares7d,
|
|
ModelTable,
|
|
ProviderCostDonut,
|
|
ModelOverTimeChart,
|
|
ProviderTable,
|
|
ServiceTierBreakdown,
|
|
ApiKeyFilterDropdown,
|
|
CustomRangePicker,
|
|
} from "./analytics";
|
|
|
|
// ============================================================================
|
|
// Main Component
|
|
// ============================================================================
|
|
|
|
export default function UsageAnalytics() {
|
|
const t = useTranslations("analytics");
|
|
const tCommon = useTranslations("common");
|
|
const [range, setRange] = useState("30d");
|
|
const [analytics, setAnalytics] = useState<any>(null);
|
|
const [loading, setLoading] = useState(true);
|
|
const [error, setError] = useState<string | null>(null);
|
|
|
|
// Custom date range state
|
|
const [customStart, setCustomStart] = useState("");
|
|
const [customEnd, setCustomEnd] = useState("");
|
|
const [showCustomPicker, setShowCustomPicker] = useState(false);
|
|
const customPickerAnchorRef = useRef<HTMLDivElement>(null);
|
|
|
|
// API key filter state
|
|
const [selectedApiKeys, setSelectedApiKeys] = useState<string[]>([]);
|
|
const [availableApiKeys, setAvailableApiKeys] = useState<{ id: string; name: string }[]>([]);
|
|
|
|
const fetchAnalytics = useCallback(async () => {
|
|
try {
|
|
setLoading(true);
|
|
const params = new URLSearchParams();
|
|
params.set("range", range);
|
|
if (range === "custom" && customStart && customEnd) {
|
|
params.set("startDate", customStart);
|
|
params.set("endDate", customEnd);
|
|
}
|
|
if (selectedApiKeys.length > 0) {
|
|
params.set("apiKeyIds", selectedApiKeys.join(","));
|
|
}
|
|
const res = await fetch(`/api/usage/analytics?${params.toString()}`);
|
|
if (!res.ok) throw new Error(await readFetchErrorMessage(res, tCommon("error")));
|
|
const data = await res.json();
|
|
setAnalytics(data);
|
|
setError(null);
|
|
|
|
// Update available keys from unfiltered data (only when no filter is active).
|
|
if (selectedApiKeys.length === 0 && data.byApiKey?.length > 0) {
|
|
const seen = new Set<string>();
|
|
const keys: { id: string; name: string }[] = [];
|
|
for (const k of data.byApiKey) {
|
|
const id = k.apiKeyId || k.apiKeyName || tCommon("unknownProvider");
|
|
const name = k.apiKeyName || k.apiKeyId || tCommon("unknownProvider");
|
|
if (seen.has(id)) continue;
|
|
seen.add(id);
|
|
keys.push({ id, name });
|
|
}
|
|
setAvailableApiKeys(keys);
|
|
}
|
|
} catch (err) {
|
|
setError((err as any).message);
|
|
} finally {
|
|
setLoading(false);
|
|
}
|
|
}, [range, customStart, customEnd, selectedApiKeys, tCommon]);
|
|
|
|
useEffect(() => {
|
|
fetchAnalytics();
|
|
}, [fetchAnalytics]);
|
|
|
|
const handleRangeSelect = useCallback((value: string) => {
|
|
if (value === "custom") {
|
|
setShowCustomPicker(true);
|
|
} else {
|
|
setRange(value);
|
|
setShowCustomPicker(false);
|
|
}
|
|
}, []);
|
|
|
|
const handleCustomApply = useCallback((start: string, end: string) => {
|
|
setCustomStart(start);
|
|
setCustomEnd(end);
|
|
setRange("custom");
|
|
setShowCustomPicker(false);
|
|
}, []);
|
|
|
|
// Format custom range label for display
|
|
const customRangeLabel = useMemo(() => {
|
|
if (range !== "custom" || !customStart || !customEnd) return null;
|
|
const fmt = (iso: string) => {
|
|
const d = new Date(iso);
|
|
return d.toLocaleDateString(undefined, {
|
|
month: "short",
|
|
day: "numeric",
|
|
hour: "2-digit",
|
|
minute: "2-digit",
|
|
});
|
|
};
|
|
return `${fmt(customStart)} — ${fmt(customEnd)}`;
|
|
}, [range, customStart, customEnd]);
|
|
|
|
const ranges = [
|
|
{ value: "1d", label: t("period1D") },
|
|
{ value: "7d", label: t("period7D") },
|
|
{ value: "30d", label: t("period30D") },
|
|
{ value: "90d", label: t("period90D") },
|
|
{ value: "ytd", label: t("periodYTD") },
|
|
{ value: "all", label: t("periodAll") },
|
|
];
|
|
|
|
const topModel = useMemo(() => {
|
|
const models = analytics?.byModel || [];
|
|
return models.length > 0 ? models[0].model : "—";
|
|
}, [analytics]);
|
|
|
|
const topProvider = useMemo(() => {
|
|
const providers = analytics?.byProvider || [];
|
|
return providers.length > 0 ? providers[0].provider : "—";
|
|
}, [analytics]);
|
|
|
|
const busiestDay = useMemo(() => {
|
|
const wp = analytics?.weeklyPattern || [];
|
|
if (!wp.length) return "—";
|
|
const max = wp.reduce((a, b) => (a.avgTokens > b.avgTokens ? a : b), wp[0]);
|
|
return max.avgTokens > 0 ? max.day : "—";
|
|
}, [analytics]);
|
|
|
|
const providerCount = useMemo(() => {
|
|
return (analytics?.byProvider || []).length;
|
|
}, [analytics]);
|
|
|
|
const providerDiversity = useMemo(() => {
|
|
const providers = analytics?.byProvider || [];
|
|
if (providers.length <= 1) return 0;
|
|
|
|
let totalCalls = 0;
|
|
for (const p of providers) {
|
|
totalCalls += p.totalRequests || p.apiCalls || 0;
|
|
}
|
|
if (totalCalls === 0) return 0;
|
|
|
|
let h = 0;
|
|
for (const p of providers) {
|
|
const p_i = (p.totalRequests || p.apiCalls || 0) / totalCalls;
|
|
if (p_i > 0) h -= p_i * Math.log2(p_i);
|
|
}
|
|
|
|
const maxH = Math.log2(providers.length);
|
|
return maxH > 0 ? (h / maxH) * 100 : 0;
|
|
}, [analytics]);
|
|
|
|
if (loading && !analytics) return <CardSkeleton />;
|
|
if (error)
|
|
return (
|
|
<Card className="p-6 text-center text-red-500">
|
|
{tCommon("errorShort")}: {error}
|
|
</Card>
|
|
);
|
|
|
|
const s = analytics?.summary || {};
|
|
|
|
// ── Derived insight values ──
|
|
const avgTokensPerReq = s.totalRequests > 0 ? Math.round(s.totalTokens / s.totalRequests) : 0;
|
|
const costPerReq = s.totalRequests > 0 ? s.totalCost / s.totalRequests : 0;
|
|
const ioRatio = s.completionTokens > 0 ? (s.promptTokens / s.completionTokens).toFixed(1) : "—";
|
|
|
|
return (
|
|
<div className="flex flex-col gap-5 min-w-0">
|
|
{/* Header + Filters */}
|
|
<div className="flex items-center justify-between flex-wrap gap-3">
|
|
<h2 className="text-xl font-semibold flex items-center gap-2">
|
|
<span className="material-symbols-outlined text-primary text-[22px]">analytics</span>
|
|
{t("usageAnalyticsTitle")}
|
|
</h2>
|
|
<div className="flex items-center gap-2.5">
|
|
{/* API Key Filter */}
|
|
<ApiKeyFilterDropdown
|
|
available={availableApiKeys}
|
|
selected={selectedApiKeys}
|
|
onChange={setSelectedApiKeys}
|
|
/>
|
|
|
|
{/* Period Selector + Custom */}
|
|
<div
|
|
className="relative flex items-center gap-1 bg-black/[0.03] dark:bg-white/[0.03] rounded-lg p-1 border border-black/5 dark:border-white/5"
|
|
ref={customPickerAnchorRef}
|
|
>
|
|
{ranges.map((r) => (
|
|
<button
|
|
key={r.value}
|
|
onClick={() => handleRangeSelect(r.value)}
|
|
className={`px-3 py-1 rounded-md text-xs font-semibold transition-all ${
|
|
range === r.value
|
|
? "bg-primary text-white shadow-sm"
|
|
: "text-text-muted hover:text-text-main hover:bg-black/5 dark:hover:bg-white/5"
|
|
}`}
|
|
>
|
|
{r.label}
|
|
</button>
|
|
))}
|
|
<button
|
|
onClick={() => handleRangeSelect("custom")}
|
|
className={`px-3 py-1 rounded-md text-xs font-semibold transition-all flex items-center gap-1 ${
|
|
range === "custom"
|
|
? "bg-primary text-white shadow-sm"
|
|
: "text-text-muted hover:text-text-main hover:bg-black/5 dark:hover:bg-white/5"
|
|
}`}
|
|
>
|
|
<span className="material-symbols-outlined text-[13px]">date_range</span>
|
|
{customRangeLabel || t("customRange")}
|
|
{range === "custom" && customRangeLabel && (
|
|
<span
|
|
role="button"
|
|
onClick={(e) => {
|
|
e.stopPropagation();
|
|
setRange("30d");
|
|
setCustomStart("");
|
|
setCustomEnd("");
|
|
}}
|
|
className="ml-0.5 opacity-70 hover:opacity-100"
|
|
>
|
|
<span className="material-symbols-outlined text-[11px]">close</span>
|
|
</span>
|
|
)}
|
|
</button>
|
|
|
|
{/* Custom Range Picker Popover */}
|
|
{showCustomPicker && (
|
|
<CustomRangePicker
|
|
start={customStart}
|
|
end={customEnd}
|
|
onApply={handleCustomApply}
|
|
onClose={() => setShowCustomPicker(false)}
|
|
/>
|
|
)}
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
{/* Primary KPI Cards */}
|
|
<div className="grid grid-cols-2 md:grid-cols-4 gap-3">
|
|
<StatCard
|
|
icon="generating_tokens"
|
|
label={t("totalTokens")}
|
|
value={fmt(s.totalTokens)}
|
|
subValue={`${fmtFull(s.totalRequests)} ${t("chartRequests")}`}
|
|
/>
|
|
<StatCard
|
|
icon="input"
|
|
label={t("inputTokens")}
|
|
value={fmt(s.promptTokens)}
|
|
color="text-primary"
|
|
/>
|
|
<StatCard
|
|
icon="output"
|
|
label={t("outputTokens")}
|
|
value={fmt(s.completionTokens)}
|
|
color="text-emerald-500"
|
|
/>
|
|
<StatCard
|
|
icon="payments"
|
|
label={t("estCost")}
|
|
value={fmtCost(s.totalCost)}
|
|
color="text-amber-500"
|
|
/>
|
|
</div>
|
|
|
|
{/* Secondary Metrics — compact grid with sections */}
|
|
<CompactStatGrid
|
|
sections={[
|
|
{
|
|
title: t("infraTitle"),
|
|
items: [
|
|
{ icon: "group", label: t("infraAccounts"), value: s.uniqueAccounts || 0 },
|
|
{
|
|
icon: "dns",
|
|
label: t("infraProviders"),
|
|
value: providerCount,
|
|
color: "text-indigo-500",
|
|
},
|
|
{ icon: "vpn_key", label: t("infraApiKeys"), value: s.uniqueApiKeys || 0 },
|
|
{ icon: "model_training", label: t("infraModels"), value: s.uniqueModels || 0 },
|
|
],
|
|
},
|
|
{
|
|
title: t("perfTitle"),
|
|
items: [
|
|
{
|
|
icon: "speed",
|
|
label: t("perfAvgTokens"),
|
|
value: fmt(avgTokensPerReq),
|
|
color: "text-cyan-500",
|
|
},
|
|
{
|
|
icon: "request_quote",
|
|
label: t("perfCostReq"),
|
|
value: fmtCost(costPerReq),
|
|
color: "text-orange-500",
|
|
},
|
|
{
|
|
icon: "compare_arrows",
|
|
label: t("perfIoRatio"),
|
|
value: `${ioRatio}x`,
|
|
color: "text-violet-500",
|
|
},
|
|
{
|
|
icon: "bolt",
|
|
label: t("perfFastReq"),
|
|
value: fmt(s.fastRequests || 0),
|
|
color: "text-sky-500",
|
|
},
|
|
],
|
|
},
|
|
{
|
|
title: t("highlightsTitle"),
|
|
wideValues: true,
|
|
items: [
|
|
{
|
|
icon: "star",
|
|
label: t("highlightsTopModel"),
|
|
value: topModel,
|
|
color: "text-pink-500",
|
|
},
|
|
{
|
|
icon: "cloud",
|
|
label: t("highlightsTopProvider"),
|
|
value: topProvider,
|
|
color: "text-teal-500",
|
|
},
|
|
{
|
|
icon: "today",
|
|
label: t("highlightsBusiestDay"),
|
|
value: busiestDay,
|
|
color: "text-rose-500",
|
|
},
|
|
{
|
|
icon: "network_node",
|
|
label: t("highlightsDiversity"),
|
|
value: `${providerDiversity.toFixed(1)}%`,
|
|
color: "text-sky-500",
|
|
},
|
|
{
|
|
icon: "swap_horiz",
|
|
label: t("highlightsFallbackRate"),
|
|
value: `${Number(s.fallbackRatePct || 0).toFixed(1)}%`,
|
|
color: "text-amber-500",
|
|
},
|
|
],
|
|
},
|
|
]}
|
|
/>
|
|
|
|
{/* Activity Heatmap + Weekly Widgets */}
|
|
<div className="grid grid-cols-1 lg:grid-cols-[2fr_1fr] gap-4 items-stretch">
|
|
<ActivityHeatmap activityMap={analytics?.activityMap} />
|
|
<div className="flex flex-col gap-4">
|
|
<MostActiveDay7d activityMap={analytics?.activityMap} />
|
|
<WeeklySquares7d activityMap={analytics?.activityMap} />
|
|
</div>
|
|
</div>
|
|
|
|
{/* Token & Cost Trend + Provider Cost Donut */}
|
|
<div className="grid grid-cols-1 md:grid-cols-2 gap-4">
|
|
<DailyTrendChart dailyTrend={analytics?.dailyTrend} />
|
|
<ProviderCostDonut byProvider={analytics?.byProvider} />
|
|
</div>
|
|
|
|
{/* Fast / Standard service tier split */}
|
|
<ServiceTierBreakdown byServiceTier={analytics?.byServiceTier} summary={s} />
|
|
|
|
{/* Model Usage Over Time (stacked area) */}
|
|
<ModelOverTimeChart
|
|
dailyByModel={analytics?.dailyByModel}
|
|
modelNames={analytics?.modelNames}
|
|
/>
|
|
|
|
{/* Account Donut + API Key Donut */}
|
|
<div className="grid grid-cols-1 md:grid-cols-2 gap-4">
|
|
<AccountDonut byAccount={analytics?.byAccount} />
|
|
<ApiKeyDonut byApiKey={analytics?.byApiKey} />
|
|
</div>
|
|
|
|
{/* Provider Breakdown Table */}
|
|
<ProviderTable byProvider={analytics?.byProvider} />
|
|
|
|
{/* API Key Table */}
|
|
<ApiKeyTable byApiKey={analytics?.byApiKey} />
|
|
|
|
{/* Model Breakdown Table */}
|
|
<ModelTable byModel={analytics?.byModel} summary={s} />
|
|
</div>
|
|
);
|
|
}
|