dsh-openrouter-spend 0.1.1 → 0.2.0

package/CHANGELOG.md

@@ -5,6 +5,24 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.0] - 2026-10-06
+
+### Added
+
+- Display currency in Settings: USD (default) or RUB, converted at the cbr.ru daily rate. The rate is read host-side with its own cache (`rateRefreshSeconds`), so a rate fetch never delays the spend summary.
+- When cbr.ru cannot be reached, RUB falls back to USD with a visible note — "check that cbr.ru is reachable" — plus the fetch reason.
+- `cbrUrl` and `rateRefreshSeconds` config fields.
+
+### Fixed
+
+- A negative prepaid balance prints at money precision instead of four decimals.
+
+## [0.1.2] - 2026-10-05
+
+### Added
+
+- Screenshots of the composer chip and the spend popover in the README.
+
 ## [0.1.1] - 2026-10-05
 
 ### Fixed

package/README.md

@@ -18,9 +18,19 @@
 
 ## What you get
 
+<p align="center">
+  <img src="https://raw.githubusercontent.com/RyabykinIlya/dsh-openrouter-spend/v0.2.0/docs/chip.png" width="640" alt="Spend chip under the composer"><br>
+  <sub>The chip under the composer: billed spend for the selected range, next to the session's token and context stats.</sub>
+</p>
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/RyabykinIlya/dsh-openrouter-spend/v0.2.0/docs/popover.png" width="340" alt="Spend popover"><br>
+  <sub>The popover: range and API-key filters, today's spend per model, daily bars, prepaid balance and lifetime spend.</sub>
+</p>
+
 - **Chip under the composer** — spend for the selected range and API key: today, 7 days, or 30 days.
 - **Chip popover** — range and API-key filters, today's spend per model, a daily bar chart across the window, prepaid balance and lifetime spend.
-- **Settings → OpenRouter spend** — store or clear the management key, set the refresh interval, filter by API key.
+- **Settings → OpenRouter spend** — store or clear the management key, pick the display currency (USD, or RUB at the cbr.ru rate), set the refresh interval, filter by API key.
 
 The host half caches the summary for `refreshSeconds` and coalesces concurrent refreshes, so any number of open tabs cost one OpenRouter query per refresh window. When a refresh fails, the last good figures stay on screen and the reason is shown instead of an empty panel.
 
@@ -40,7 +50,7 @@ dsh plugin --profile web add dsh-openrouter-spend
 From GitHub (plain JavaScript, no build step and no build-script permission):
 
 ```sh
-dsh plugin --profile web add github:RyabykinIlya/dsh-openrouter-spend#v0.1.1
+dsh plugin --profile web add github:RyabykinIlya/dsh-openrouter-spend#v0.2.0
 ```
 
 Then open Settings → OpenRouter spend and paste the management key.
@@ -55,9 +65,11 @@ Every field can be overridden in the profile's `cordis.patch.yml` row; the schem
 | `apiBase` | `https://openrouter.ai/api/v1` | `https://` URL | OpenRouter REST API root |
 | `refreshSeconds` | `60` | 10–3600, integer | Seconds between OpenRouter refreshes |
 | `historyDays` | `30` | 2–366, integer | Days of history the summary window covers, today included |
-| `timeoutMs` | `15000` | 1000–120000, integer | Per-request deadline against OpenRouter |
+| `cbrUrl` | `https://www.cbr.ru/scripts/XML_daily.asp` | `https://` URL | CBR daily-rates sheet read for the RUB rate |
+| `rateRefreshSeconds` | `3600` | 60–86400, integer | Seconds between cbr.ru rate reads |
+| `timeoutMs` | `15000` | 1000–120000, integer | Per-request deadline against OpenRouter and cbr.ru |
 
-Viewing preferences (per-key filter, refresh interval override) are browser-local (`localStorage`).
+Viewing preferences (display currency, per-key filter, refresh interval override) are browser-local (`localStorage`).
 
 ## What the numbers are
 
@@ -65,6 +77,7 @@ Viewing preferences (per-key filter, refresh interval override) are browser-loca
 - "Today" is the current UTC day.
 - Balance is `total_credits − total_usage` from `GET /api/v1/credits`: what remains of prepaid credits.
 - The 7-day and 30-day ranges cover at most `historyDays` days; keep `historyDays ≥ 30` for full coverage.
+- RUB display converts those USD figures at the cbr.ru daily rate, read host-side and cached for `rateRefreshSeconds`. When cbr.ru cannot be reached, the figures stay in USD and the panel says so, with the fetch reason and a hint to check the connection.
 
 ## Security
 
@@ -77,4 +90,4 @@ Viewing preferences (per-key filter, refresh interval override) are browser-loca
 
 ## По-русски
 
-Плагин для DeepSeek Harness показывает реальные списания аккаунта OpenRouter (данные из аналитики OpenRouter, в долларах, по UTC-дням): чип под полем ввода с выбором периода сегодня / 7 дней / 30 дней, в поповере — разбивка по моделям за сегодня, график по дням, фильтр по API-ключам и остаток предоплаченных кредитов. В Settings → OpenRouter spend задаётся управляющий ключ и интервал обновления. Установка: `dsh plugin --profile web add dsh-openrouter-spend`; нужен Management API key из кабинета OpenRouter (Settings → Management API Keys) — обычный ключ модели для аналитики не подходит.
+Плагин для DeepSeek Harness показывает реальные списания аккаунта OpenRouter (данные из аналитики OpenRouter, в долларах, по UTC-дням): чип под полем ввода с выбором периода сегодня / 7 дней / 30 дней, в поповере — разбивка по моделям за сегодня, график по дням, фильтр по API-ключам и остаток предоплаченных кредитов. В Settings → OpenRouter spend задаётся управляющий ключ, валюта отображения (USD или RUB по курсу ЦБ РФ), интервал обновления и фильтр по API-ключу. Если cbr.ru недоступен, суммы остаются в USD, а панель просит проверить подключение к cbr.ru. Установка: `dsh plugin --profile web add dsh-openrouter-spend`; нужен Management API key из кабинета OpenRouter (Settings → Management API Keys) — обычный ключ модели для аналитики не подходит.

package/client.js

@@ -11,6 +11,7 @@ window.__ModuleLoader__.load({
     /** Preferences are viewing choices: a browser-local store, not host state. */
     const PREF_KEY_ID = 'ors.keyId';
     const PREF_INTERVAL = 'ors.intervalSeconds';
+    const PREF_CURRENCY = 'ors.currency';
     const PREFS_CHANGED = 'ors:prefs';
 
     const CSS = `
@@ -83,13 +84,33 @@ window.__ModuleLoader__.load({
 }
 `;
 
-    /** Money with the precision a sub-cent figure needs, and none it does not. */
-    function fmtUsd(value) {
+    /**
+     * Money with the precision a sub-cent figure needs, and none it does not.
+     * USD prints as an invoice writes it (`$1.23`), RUB as a receipt does
+     * (`1.23 ₽`).
+     */
+    function fmtMoney(value, currency) {
       const amount = Number(value) || 0;
-      if (amount === 0) return '$0.00';
-      if (amount < 0.01) return `$${amount.toFixed(4)}`;
-      if (amount < 1) return `$${amount.toFixed(3)}`;
-      return `$${amount.toFixed(2)}`;
+      const magnitude = Math.abs(amount);
+      const digits = magnitude === 0 ? 2 : magnitude < 0.01 ? 4 : magnitude < 1 ? 3 : 2;
+      return currency === 'RUB' ? `${amount.toFixed(digits)} ₽` : `$${amount.toFixed(digits)}`;
+    }
+
+    /**
+     * The display money for one currency choice. OpenRouter bills USD and the
+     * wire stays USD; RUB is that figure at the cbr.ru rate. Without a rate the
+     * USD presentation is kept — the caller adds the "check cbr.ru" note — so a
+     * dead cbr.ru costs the conversion, never the numbers.
+     */
+    function makeMoney(currency, perUsd) {
+      const rate = Number(perUsd);
+      const rub = currency === 'RUB' && Number.isFinite(rate) && rate > 0;
+      return {
+        rub,
+        perUsd: rub ? rate : undefined,
+        symbol: rub ? '₽' : '$',
+        fmt: value => fmtMoney(rub ? (Number(value) || 0) * rate : value, rub ? 'RUB' : 'USD'),
+      };
     }
 
     const fmtInt = value => Number(value || 0).toLocaleString('en-US');
@@ -111,6 +132,11 @@ window.__ModuleLoader__.load({
       }
     }
 
+    /** The display currency preference; anything else in storage reads as USD. */
+    function readCurrency() {
+      return readPref(PREF_CURRENCY, 'USD') === 'RUB' ? 'RUB' : 'USD';
+    }
+
     /** Store one viewing preference and tell the other component about it. */
     function writePref(name, value) {
       try {
@@ -136,6 +162,7 @@ window.__ModuleLoader__.load({
       const [range, setRange] = useState('today');
       const [keyId, setKeyId] = useState(() => readPref(PREF_KEY_ID, ''));
       const [intervalSeconds, setIntervalSeconds] = useState(() => Number(readPref(PREF_INTERVAL, '0')));
+      const [currency, setCurrency] = useState(readCurrency);
       const rootRef = useRef(null);
 
       useEffect(() => { void fetchSummary().then(reply => { if (reply !== undefined) setData(reply); }); }, []);
@@ -153,6 +180,7 @@ window.__ModuleLoader__.load({
         const sync = () => {
           setKeyId(readPref(PREF_KEY_ID, ''));
           setIntervalSeconds(Number(readPref(PREF_INTERVAL, '0')));
+          setCurrency(readCurrency());
         };
         window.addEventListener(PREFS_CHANGED, sync);
         return () => window.removeEventListener(PREFS_CHANGED, sync);
@@ -196,6 +224,9 @@ window.__ModuleLoader__.load({
       const peak = bars.reduce((max, entry) => Math.max(max, entry.usd), 0);
       const balance = data?.credits ? data.credits.totalCredits - data.credits.totalUsage : undefined;
       const rangeLabel = range === 'today' ? t('today') : range === 'last7' ? t('last7') : t('last30');
+      const money = makeMoney(currency, data?.rate?.perUsd);
+      // RUB was chosen but cbr.ru answered no rate: figures stay in USD and say so.
+      const rubUnavailable = currency === 'RUB' && data !== null && !money.rub;
 
       if (data !== null && data.status === 'no-credential') {
         return h('span', { className: 'ors-root' },
@@ -216,16 +247,22 @@ window.__ModuleLoader__.load({
           onClick: () => setOpen(value => !value),
         },
         h('span', { className: 'ors-chip-dot', 'data-state': data?.status ?? 'loading' }),
-        h('span', { className: 'ors-chip-amount' }, data === null ? t('loading') : fmtUsd(view.usd))),
+        h('span', { className: 'ors-chip-amount' }, data === null ? t('loading') : money.fmt(view.usd))),
         open && h('div', { className: 'ors-panel' },
           h('div', { className: 'ors-head' },
             h('span', { className: 'ors-label' }, rangeLabel),
-            h('span', { className: 'ors-figure' }, fmtUsd(view.usd))),
+            h('span', { className: 'ors-figure' }, money.fmt(view.usd))),
           h('div', { className: 'ors-sub' },
             `${fmtInt(view.requests)} ${t('requests')}`
             + (data?.refreshedAt === undefined
               ? ''
               : ` · ${t('updated')} ${new Date(data.refreshedAt).toLocaleTimeString()}`)),
+          money.rub && h('div', { className: 'ors-sub' },
+            `${t('cbrRate')}: 1 USD = ${money.perUsd.toFixed(2)} ₽`),
+          rubUnavailable && h('div', { className: 'ors-note' }, t('rubFallback')),
+          rubUnavailable && data?.rateError !== undefined
+            ? h('div', { className: 'ors-sub' }, data.rateError)
+            : null,
           h('div', { className: 'ors-range' },
             ['today', 'last7', 'last30'].map(id => h('button', {
               key: id,
@@ -234,7 +271,7 @@ window.__ModuleLoader__.load({
               onClick: () => setRange(id),
             }, id === 'today' ? t('today') : id === 'last7' ? t('last7') : t('last30')))),
           balance === undefined ? null : h('div', { className: 'ors-sub' },
-            `${t('balance')}: ${fmtUsd(balance)} · ${t('lifetime')}: ${fmtUsd(data.credits.totalUsage)}`),
+            `${t('balance')}: ${money.fmt(balance)} · ${t('lifetime')}: ${money.fmt(data.credits.totalUsage)}`),
           keys.length > 0 && h('div', null,
             h('div', { className: 'ors-sub' }, t('byKey')),
             h('div', { className: 'ors-keyrow' },
@@ -250,13 +287,13 @@ window.__ModuleLoader__.load({
           h('table', { className: 'ors-table' },
             h('thead', null, h('tr', null,
               h('th', null, t('byModel')),
-              h('th', null, '$'),
+              h('th', null, money.symbol),
               h('th', null, t('requests')))),
             h('tbody', null, rows.length === 0
               ? h('tr', null, h('td', { colSpan: 3, className: 'ors-label' }, '—'))
               : rows.map(entry => h('tr', { key: entry.id },
                 h('td', null, entry.id),
-                h('td', { className: 'ors-num' }, fmtUsd(entry.usd)),
+                h('td', { className: 'ors-num' }, money.fmt(entry.usd)),
                 h('td', { className: 'ors-num' }, fmtInt(entry.requests)))))),
           bars.length > 0 && peak > 0 && h('div', { className: 'ors-bars' },
             bars.map(entry => h('div', {
@@ -264,7 +301,7 @@ window.__ModuleLoader__.load({
               className: 'ors-bar',
               'data-today': entry.date === data.today,
               style: { height: `${Math.max(2, Math.round((entry.usd / peak) * 34))}px` },
-              title: `${entry.date} · ${fmtUsd(entry.usd)}`,
+              title: `${entry.date} · ${money.fmt(entry.usd)}`,
             }))),
           data?.error === undefined ? null : h('div', { className: 'ors-note' }, data.error)));
     }
@@ -274,6 +311,7 @@ window.__ModuleLoader__.load({
       const [data, setData] = useState(null);
       const [keyId, setKeyId] = useState(() => readPref(PREF_KEY_ID, ''));
       const [intervalSeconds, setIntervalSeconds] = useState(() => readPref(PREF_INTERVAL, '0'));
+      const [currency, setCurrency] = useState(readCurrency);
       const [draft, setDraft] = useState('');
       const [notice, setNotice] = useState(null);
 
@@ -308,6 +346,9 @@ window.__ModuleLoader__.load({
 
       const credential = data?.credential;
       const keys = data?.byKey ?? [];
+      const money = makeMoney(currency, data?.rate?.perUsd);
+      // RUB was chosen but cbr.ru answered no rate: figures stay in USD and say so.
+      const rubUnavailable = currency === 'RUB' && data !== null && !money.rub;
       const selectKey = value => {
         setKeyId(value);
         writePref(PREF_KEY_ID, value);
@@ -316,6 +357,10 @@ window.__ModuleLoader__.load({
         setIntervalSeconds(value);
         writePref(PREF_INTERVAL, value);
       };
+      const selectCurrency = value => {
+        setCurrency(value);
+        writePref(PREF_CURRENCY, value);
+      };
 
       return h('div', { className: 'ors-settings' },
         h('style', null, CSS),
@@ -323,19 +368,31 @@ window.__ModuleLoader__.load({
           h('div', { className: 'ors-head' },
             h('span', { className: 'ors-label' }, t('today')),
             h('span', { className: 'ors-figure' },
-              fmtUsd(data?.todaySpend?.usd ?? 0))),
+              money.fmt(data?.todaySpend?.usd ?? 0))),
           h('div', { className: 'ors-sub' },
             `${fmtInt(data?.todaySpend?.requests ?? 0)} ${t('requests')}`
             + (data?.credits === undefined
               ? ''
-              : ` · ${t('balance')}: ${fmtUsd(data.credits.totalCredits - data.credits.totalUsage)}`)),
+              : ` · ${t('balance')}: ${money.fmt(data.credits.totalCredits - data.credits.totalUsage)}`)),
           data?.error === undefined ? null : h('div', { className: 'ors-note' }, data.error)),
+        h('div', { className: 'ors-field' },
+          h('label', { className: 'ors-sub' }, t('currency')),
+          h('select', { value: currency, onChange: event => selectCurrency(event.target.value) },
+            h('option', { value: 'USD' }, t('currencyUsd')),
+            h('option', { value: 'RUB' }, t('currencyRub'))),
+          money.rub
+            ? h('div', { className: 'ors-sub' }, `${t('cbrRate')}: 1 USD = ${money.perUsd.toFixed(2)} ₽`)
+            : null,
+          rubUnavailable ? h('div', { className: 'ors-note' }, t('rubFallback')) : null,
+          rubUnavailable && data?.rateError !== undefined
+            ? h('div', { className: 'ors-sub' }, data.rateError)
+            : null),
         h('div', { className: 'ors-field' },
           h('label', { className: 'ors-sub' }, t('countByKey')),
           h('select', { value: keyId, onChange: event => selectKey(event.target.value) },
             h('option', { value: '' }, t('allKeys')),
             keys.map(entry => h('option', { key: entry.id, value: entry.id },
-              `${entry.id} · ${fmtUsd(entry.todayUsd)} ${t('today')}`)),
+              `${entry.id} · ${money.fmt(entry.todayUsd)} ${t('today')}`)),
             keyId !== '' && keys.every(entry => entry.id !== keyId)
               ? h('option', { value: keyId }, `${keyId} · ${t('unknownKey')}`)
               : null)),
@@ -400,6 +457,11 @@ window.__ModuleLoader__.load({
             countByKey: 'Count only this API key',
             refreshEvery: 'Refresh every',
             serverDefault: 'Plugin default',
+            currency: 'Display currency',
+            currencyUsd: 'USD (billed by OpenRouter)',
+            currencyRub: 'RUB (converted at the CBR rate)',
+            cbrRate: 'CBR rate',
+            rubFallback: 'RUB is unavailable: the rate could not be fetched from cbr.ru. Amounts are shown in USD — check that cbr.ru is reachable.',
             managementKey: 'Management API key',
             keyStored: 'Stored as',
             keyHint: 'Needs an OpenRouter management key: Settings → API keys → Management.',
@@ -427,6 +489,11 @@ window.__ModuleLoader__.load({
             countByKey: '只统计这个 API 密钥',
             refreshEvery: '刷新间隔',
             serverDefault: '插件默认',
+            currency: '显示货币',
+            currencyUsd: 'USD（OpenRouter 计费货币）',
+            currencyRub: 'RUB（按俄罗斯央行汇率换算）',
+            cbrRate: '央行汇率',
+            rubFallback: 'RUB 不可用：无法从 cbr.ru 获取汇率。金额以 USD 显示——请检查到 cbr.ru 的连接。',
             managementKey: '管理密钥',
             keyStored: '已保存为',
             keyHint: '需要 OpenRouter 管理密钥：Settings → API keys → Management。',
@@ -454,6 +521,11 @@ window.__ModuleLoader__.load({
             countByKey: 'Учитывать только этот API-ключ',
             refreshEvery: 'Обновлять каждые',
             serverDefault: 'По умолчанию',
+            currency: 'Валюта',
+            currencyUsd: 'USD (как списывает OpenRouter)',
+            currencyRub: 'RUB (по курсу ЦБ РФ)',
+            cbrRate: 'Курс ЦБ',
+            rubFallback: 'RUB недоступен: не удалось получить курс с cbr.ru. Суммы показаны в USD — проверьте подключение к cbr.ru.',
             managementKey: 'Управляющий API-ключ',
             keyStored: 'Сохранён как',
             keyHint: 'Нужен управляющий ключ OpenRouter: Settings → API keys → Management.',

package/index.js

@@ -4,7 +4,9 @@
  * Reads what the OpenRouter account actually charged with a management key and
  * serves it to the browser half as one cached summary. Every figure comes from
  * OpenRouter's own analytics (`total_usage`), so it is billed money rather than
- * a token estimate priced from a local table.
+ * a token estimate priced from a local table. The one figure that is not
+ * OpenRouter's is the RUB rate, read from the CBR daily sheet so the browser
+ * can show the same money in rubles.
  */
 
 import Schema from 'schemastery'
@@ -30,6 +32,9 @@ const MAX_REPLY_BYTES = 4 * 1024 * 1024
 /** Rows beyond this are refused rather than truncated: a partial split misreports cost. */
 const MAX_ANALYTICS_ROWS = 500
 
+/** The CBR sheet is a dozen kilobytes; a larger reply is not a rate sheet. */
+const MAX_RATE_BYTES = 256 * 1024
+
 /**
  * The row's `config` schema: validated by the Loader before `apply`, so a
  * wrong value fails the row at activation instead of misreporting spend later.
@@ -45,8 +50,12 @@ export const Config = Schema.object({
     .description('Seconds between OpenRouter refreshes; one poll serves every open tab.'),
   historyDays: Schema.number().step(1).min(2).max(366).default(30)
     .description('Days of history the summary window covers, today included.'),
+  cbrUrl: Schema.string().pattern(/^https:\/\//).default('https://www.cbr.ru/scripts/XML_daily.asp')
+    .description('CBR daily-rates sheet read for the RUB rate; https only.'),
+  rateRefreshSeconds: Schema.number().step(1).min(60).max(86_400).default(3600)
+    .description('Seconds between cbr.ru rate reads; the rate moves at most once a day.'),
   timeoutMs: Schema.number().step(1).min(1000).max(120_000).default(15_000)
-    .description('Per-request deadline against the OpenRouter API, in milliseconds.'),
+    .description('Per-request deadline against the OpenRouter API and cbr.ru, in milliseconds.'),
 })
 
 /**
@@ -114,6 +123,44 @@ async function queryCredits(config, credential, signal) {
   return { totalCredits: data.total_credits, totalUsage: data.total_usage }
 }
 
+/**
+ * Read one numeric tag (`<Value>`, `<Nominal>`) out of a `<Valute>` block.
+ * The sheet is windows-1251, but every tag read here is ASCII, so decoding the
+ * reply as UTF-8 cannot corrupt a rate; the garbled names are never touched.
+ */
+function readRateTag(block, tag) {
+  const match = block.match(new RegExp(`<${tag}>\\s*([\\d\\s,\\.]+)\\s*</${tag}>`))
+  return match === null ? undefined : match[1].replace(/\s/g, '').replace(',', '.')
+}
+
+/**
+ * Pull the USD rate out of a CBR daily-rates sheet.
+ * @returns rubles for one US dollar.
+ */
+function parseUsdRub(sheet) {
+  const blocks = sheet.match(/<Valute[\s\S]*?<\/Valute>/g) ?? []
+  const usd = blocks.find(block => /<CharCode>\s*USD\s*<\/CharCode>/.test(block))
+  if (usd === undefined) throw new Error('cbr daily sheet carries no USD row')
+  // `Value` is the price of `Nominal` dollars; the rate is their quotient.
+  const value = Number(readRateTag(usd, 'Value'))
+  const nominal = Number(readRateTag(usd, 'Nominal') ?? '1')
+  const perUsd = value / nominal
+  if (!Number.isFinite(perUsd) || perUsd <= 0) throw new Error('cbr daily sheet carries no usable USD rate')
+  return perUsd
+}
+
+/** Fetch today's USD rate from the CBR daily sheet; one number out of the XML. */
+async function queryUsdRub(config, signal) {
+  const response = await fetch(config.cbrUrl, {
+    headers: { accept: 'application/xml, text/xml' },
+    signal,
+  })
+  if (!response.ok) throw new Error(`cbr daily sheet answered ${response.status}`)
+  const sheet = await response.text()
+  if (sheet.length > MAX_RATE_BYTES) throw new Error(`cbr daily sheet exceeds ${MAX_RATE_BYTES} bytes`)
+  return parseUsdRub(sheet)
+}
+
 /** UTC calendar day of a timestamp, the bucket OpenRouter answers `date__day` with. */
 function utcDay(now) {
   return now.toISOString().slice(0, 10)
@@ -217,14 +264,17 @@ function byModel(rows, today) {
 /**
  * Build the one summary the browser half renders: today's spend, trailing
  * windows, the daily series, per-model and per-key splits, and the balance.
+ * `rateInfo` answers the RUB rate (or the reason it is missing) on the same
+ * refresh, so RUB display costs no extra round trip.
  */
-async function collect(config, credential, signal) {
+async function collect(config, credential, signal, rateInfo) {
   const now = new Date()
   const end = new Date(now.getTime() + 60_000).toISOString()
   const start = startOfUtcDay(now, config.historyDays - 1)
-  const [rows, credits] = await Promise.all([
+  const [rows, credits, rate] = await Promise.all([
     queryAnalytics(config, credential, start, end, signal),
     queryCredits(config, credential, signal),
+    rateInfo(),
   ])
   const today = utcDay(now)
   const series = dailySeries(rows, config.historyDays, now)
@@ -240,6 +290,9 @@ async function collect(config, credential, signal) {
     byDay: series,
     byModel: byModel(rows, today),
     byKey: byKey(rows, today, series),
+    // `rate` is always present: rubles per dollar, or null when cbr.ru failed
+    // — then `rateError` carries the reason for the panel to show.
+    ...rate,
     credits,
   }
 }
@@ -295,6 +348,7 @@ function emptyPayload(config) {
     byDay: [],
     byModel: [],
     byKey: [],
+    rate: null,
   }
 }
 
@@ -305,6 +359,44 @@ function emptyPayload(config) {
 export function apply(ctx, config) {
   let cached = undefined
   let inFlight = undefined
+  let rateCached = undefined
+  let rateInFlight = undefined
+
+  /**
+   * The RUB rate, on its own clock: the CBR sheet moves at most once a day, so
+   * a good rate is kept for `rateRefreshSeconds`. A failure is kept for one
+   * refresh window only — a down cbr.ru is retried gently but recovers fast.
+   * Never throws: it answers `{ rate }`, or `{ rate: null, rateError }` for
+   * the payload to carry to the panel.
+   */
+  const rateInfo = async () => {
+    const fresh = rateCached !== undefined && Date.now() - rateCached.fetchedAt < rateCached.ttlMs
+    if (fresh) return rateCached.value
+    if (rateInFlight !== undefined) return rateInFlight
+    rateInFlight = (async () => {
+      const now = Date.now()
+      try {
+        const perUsd = await queryUsdRub(config, AbortSignal.timeout(config.timeoutMs))
+        rateCached = {
+          fetchedAt: now,
+          ttlMs: config.rateRefreshSeconds * 1000,
+          value: { rate: { perUsd, fetchedAt: new Date(now).toISOString() } },
+        }
+      } catch (error) {
+        const reason = error instanceof Error ? error.message : String(error)
+        ctx.logger.warn('openrouter-spend: cbr rate unavailable', reason)
+        rateCached = {
+          fetchedAt: now,
+          ttlMs: config.refreshSeconds * 1000,
+          value: { rate: null, rateError: reason },
+        }
+      } finally {
+        rateInFlight = undefined
+      }
+      return rateCached.value
+    })()
+    return rateInFlight
+  }
 
   const summary = async () => {
     const resolved = await ctx.credentials.resolve(config.credentialRef)
@@ -320,7 +412,7 @@ export function apply(ctx, config) {
     }
     const signal = AbortSignal.timeout(config.timeoutMs)
     try {
-      return { ...(await collect(config, resolved.value, signal)), credential }
+      return { ...(await collect(config, resolved.value, signal, rateInfo)), credential }
     } catch (error) {
       // A stale reply beats an empty panel: keep the last good figures and say why.
       const reason = error instanceof Error ? error.message : String(error)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-openrouter-spend",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "DeepSeek Harness plugin: shows what the OpenRouter account actually charged today — under the composer and in Settings, split by model and API key.",
   "keywords": ["dsh", "dsh-plugin", "cordis", "openrouter", "spend", "cost", "analytics"],
   "license": "MIT",