@goodandready/dsh-cost-meter 0.8.0 → 0.8.1

package/README.md

@@ -138,3 +138,10 @@ npm test
 ## 📄 License
 
 MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)
+
+### Performance & Smart Cost Features (v0.8.1)
+- **O(K) Rate Change Calculation**: Next schedule transition is resolved in $O(K)$ boundary hops instead of full-day iterations.
+- **Server Cache & ETag**: High-throughput state polling with `304 Not Modified` support and internal tariff LRU cache.
+- **Manual Catalog Sync**: On-demand catalog fetch via `POST /dsh-cost-meter/refresh` or UI "Sync Now" button.
+- **Savings Advice & Budget Threshold**: Popover hints on impending off-peak discounts (50% off) and optional warning thresholds (`budgetThreshold`).
+- **Quick Summary Export**: Instant markdown/text summary copy to clipboard.

package/docs/README.ru.md

@@ -138,3 +138,9 @@ npm test
 ## 📄 Лицензия
 
 MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)
+
+### Производительность и интеллектуальные подсказки (v0.8.1)
+- **Алгоритм O(K)**: Моментальный расчёт границ смены тарифов и мемоизация экстремумов без лишних циклов в браузере.
+- **Серверный кэш и ETag**: Поддержка заголовка `304 Not Modified` для маршрута `/state` и кэширование сопоставлений моделей.
+- **Ручная синхронизация**: Кнопка «Синхронизировать сейчас» в настройках с защитой от флуда (`POST /dsh-cost-meter/refresh`).
+- **Подсказки экономии и порог бюджета**: Отсчёт времени до льготного окна (скидка 50%), порог сессии (`budgetThreshold`) и экспорт сводки в буфер обмена.

package/docs/design/DESIGN.md

@@ -86,6 +86,15 @@
   - Не допускать утечек локальных путей и инфраструктурных данных в коде или документации.
 
 ## History & Decisions
+- 2026-09-12 (v0.8.1):
+  - Оптимизация производительности расчёта тарифов: замена 1440-минутного цикла на алгоритм O(K) по точкам перехода и мемоизация экстремумов через WeakMap.
+  - Серверный кэш разрешения тарифов resolveTariffCache (Map) с автоматической очисткой при обновлении каталога.
+  - Поддержка ETag и ответа 304 Not Modified на эндпоинте /dsh-cost-meter/state.
+  - Кнопка ручной синхронизации каталога цен в секции OpenRouter с защитой от флуда (cooldown 30 сек).
+  - Интеллектуальные подсказки экономии: плашка скорого наступления льготного тарифа (скидка 50%) и отсчёт времени.
+  - Поддержка настраиваемого порога бюджета сессии (budgetThreshold) с предупреждающей подсветкой чипа.
+  - Кнопка быстрого копирования текстового отчёта о расходах в буфер обмена.
+  - Таблица нормализации алиасов вендоров (z-ai -> zai, deepseek-official -> deepseek, gemini -> google).
 - 2026-09-05 (v0.7.9):
   - Hotfix: исправлен ReferenceError (t is not defined) в объекте словаря ru (lib/client.js) (#15).
   - Добавлен автоматический тест на чистое исполнение фабрики client loader (`test/public-route.test.mjs`).

package/docs/plans/findings.md

@@ -1,13 +1,17 @@
-# Findings: Issue #23
-
-## Архитектурные паттерны dsh-clinebot
-- Изолированный тег `<style id="dsh-cost-meter-unified-css" data-dsh-plugin="dsh-cost-meter">` с переменными `--dsw-alias-...`.
-- `createErrorBoundary()` защищает слоты от падений при сбоях рендеринга.
-- `refreshMirrorUntilVisible(ctx)` обеспечивает доступность зеркала настроек в `settingsScope`.
-- Бейджи статуса (`cb-badge-ok`, `cb-badge-warn`, `cb-badge-bad`) позволяют пользователю моментально оценить состояние плагина.
-
-## Найденные баги в dsh-cost-meter
-1. Строка 427 `lib/index.js`: `catalog = { index: { byId: {}, bySuffix: {} }, fetchedAt: 0, error: null }` не содержала `byLowerId`. При обращении к `matchModel` до первой загрузки каталога вызывался `index.byLowerId[lower]`, что приводило к `TypeError`.
-2. `slotOf(event.time)`: при `undefined` возвращал `NaN`, повреждая ключи слотов в проекции.
-3. `fetch(CATALOG_URL)`: без таймаута мог блокировать цикл обновлений при сетевых лагах.
-4. `splitRoute`: отбрасывал модели без слэша.
+# Findings: Issue #25 (v0.8.1)
+
+## 1. Клиентские вычисления расписания
+- В `lib/client.js`: `extremes()` и `minutesUntilChange()` вызывались на каждом тике таймера (15 сек) и перерисовывали 1440-минутный цикл:
+  `for (let minute = 0; minute < 1440; minute++)` с поиском в `windows`.
+- В сутках конечное число окон $K$ (обычно 2–4). Смена тарифа может происходить только на границах интервалов: `window.start` и `window.end`.
+- Замена на $O(K)$ даёт мгновенный расчёт без аллокации сотен объектов в секунду при активных сессиях.
+
+## 2. Разрешение тарифов на сервере
+- `resolveTariff(cfg, catalog.index, route)` перебирает регулярные выражения и суффиксы.
+- Кэширование в `Map<string, ResolvedTariff>` с очисткой при обновлении каталога полностью снимает нагрузку на CPU при частом пуллинге `/state` клиентами DSH.
+
+## 3. Поддержка ETag
+- Для `/dsh-cost-meter/state` генерация слабого ETag (`W/"<hash>"`) на основе `updatedAt`, `fetchedAt` и счетчиков токенов позволяет клиентам передавать `If-None-Match` и получать `304 Not Modified`, экономя полосу пропускания и парсинг JSON.
+
+## 4. Алиасы вендоров
+- Разные провайдеры в DSH могут передавать вендоров как `z-ai`, `zai`, `google`, `gemini`, `deepseek-ai`, `deepseek`. Единая нормализация исключит ситуации fallback на generic тариф.

package/docs/plans/progress.md

@@ -1,25 +1,12 @@
-<!-- id: issue-23-progress -->
-# Progress: Issue #23 — Стабилизация кода и редизайн UI по стандарту dsh-clinebot
+# Progress: Issue #25 (v0.8.1)
 
-- [x] Создана Issue #23 в Gitea
-- [x] Создан worktree `.worktrees/issue-23` на ветке `feat/stability-and-ui-clinebot`
-- [x] Инициализированы файлы планирования (`task_plan.md`, `findings.md`, `progress.md`)
-- [x] Применены серверные исправления (`lib/index.js`):
-  - [x] Инициализация `byLowerId` в начальном состоянии `catalog.index` (устранён крах холодного старта)
-  - [x] Защита `slotOf(timeMs)` от `NaN` при невалидных временных метках
-  - [x] Добавлен таймаут (15с) для внешних запросов к OpenRouter
-  - [x] Расширен `splitRoute` для поддержки моделей без слэша (`deepseek-chat`)
-  - [x] Экспорт `catalogModelsCount` в ответе `/dsh-cost-meter/state`
-- [x] Применён визуальный редизайн по стандарту `dsh-clinebot` (`lib/client.js`):
-  - [x] Внедрён `createErrorBoundary()` для защиты слотов от падений
-  - [x] Внедрён `refreshMirrorUntilVisible(ctx)` для синхронизации настроек
-  - [x] Внедрена нативная CSS-система дизайн-токенов (`--dsw-alias-*`)
-  - [x] Шапка карточки снабжена бейджами статуса каталога, тарифа и таймзоны
-  - [x] Настройки структурированы по 3 секциям (`Основные параметры`, `Каталог OpenRouter`, `Диагностика`)
-  - [x] Модернизирован поповер шапки сессии
-- [x] Обновлена документация (`DESIGN.md`, `README.md`, `docs/README.ru.md`)
-- [x] Поднята версия до `0.7.10` в `package.json`
-- [x] Написаны и успешно пройдены 16 тестов в `test/stability-and-visual.test.mjs` (`npm test` 16/16 pass)
-- [ ] Оформление коммита, push ветки и создание PR #24
-- [ ] Merge PR в `main` и сборка тарбола
-- [ ] Тестирование на проде, публикация релиза v0.7.10 и закрытие Issue #23
+- **2026-09-12 19:10**:
+  - Создана Gitea Issue #25.
+  - Создан worktree `.worktrees/issue-25` от `origin/main` (ветка `feat/issue-25-perf-and-smart-features`).
+  - Инициализированы планы в `docs/plans/`.
+
+- **2026-09-12 19:16**:
+  - Реализованы оптимизации в `lib/index.js` (resolveTariffCache, ETag / 304, POST /refresh, budgetThreshold, VENDOR_ALIASES).
+  - Реализованы улучшения в `lib/client.js` (O(K) minutesUntilChange, memoized extremes, кнопка синхронизации с cooldown, порог бюджета, плашка экономии, копирование сводки).
+  - Добавлены тесты в `test/v081-perf-smart.test.mjs` (все 20 тестов успешно пройдены).
+  - Версия поднята до `0.8.1`.

package/docs/plans/task_plan.md

@@ -1,25 +1,31 @@
-# Task Plan: Issue #23 — Стабилизация кода и редизайн UI карточки настроек по стандарту dsh-clinebot
+# Task Plan: Issue #25 (v0.8.1) — Оптимизация производительности, ручная синхронизация каталога и подсказки экономии
 
-## Цель
-Устранить дефекты стабильности (холодный старт, event.time, таймаут OpenRouter, модели без слэша) и обновить UI плагина до единого стандарта dsh-clinebot (ErrorBoundary, дизайн-токены, бейджи, секции, адаптивная сетка, поповер).
+## Цели
+1. **Скорость**:
+   - Оптимизация алгоритма расчета времени смены тарифа (`minutesUntilChange`) и экстремумов (`extremes`) с $O(1440)$ до $O(K)$ без полного минутного цикла.
+   - Серверный кэш `resolveTariffCache` для быстрого разрешения моделей.
+   - Поддержка ETag / 304 Not Modified на эндпоинте `/dsh-cost-meter/state`.
+2. **Качество и управление**:
+   - Маршрут `POST /dsh-cost-meter/refresh` с rate limit (cooldown 30 сек) и кнопка «Синхронизировать сейчас» в настройках.
+   - Таблица нормализации алиасов вендоров (Smart Vendor Aliases).
+   - Индикация stale-кэша каталога в UI.
+3. **Экономия**:
+   - Подсказка в поповере о приближении льготного тарифа (50% скидка).
+   - Конфигурируемый порог сессии `budgetThreshold` с предупреждающей подсветкой чипа.
+   - Кнопка «Скопировать сводку» в поповере.
+4. **Стандарты и релиз**:
+   - 100% прохождение тестов `npm test`.
+   - Проверка размера файлов (< 256 KiB).
+   - Тестирование на test server (MiniPC :3082), затем на MiniAI candidate (:3080).
+   - Запрос подтверждения пользователя -> публикация v0.8.1 в npm/GitHub -> rollout на прод.
 
-## Задачи
-- [ ] 1. Исправление серверной части (`lib/index.js`):
-  - [ ] Инициализация `byLowerId` в начальном состоянии каталога
-  - [ ] Валидация `timeMs` в `slotOf(timeMs)`
-  - [ ] Добавление таймаута (15с) для запросов к `openrouter.ai`
-  - [ ] Поддержка моделей без префикса в `splitRoute`
-  - [ ] Экспорт диагностических метаданных (`catalogModelsCount`, `fetchedAt`, `error`) в `/dsh-cost-meter/state`
-- [ ] 2. Обновление клиентской части (`lib/client.js`):
-  - [ ] Внедрение `createErrorBoundary()` и обёртка карточки и поповера
-  - [ ] Внедрение `refreshMirrorUntilVisible(ctx)`
-  - [ ] Единая CSS-система дизайн-токенов (`.dcm-section-card`, `.dcm-badge`, `.dcm-grid-2`, `.dcm-btn`, `.dcm-alert-*`)
-  - [ ] Структурирование настроек по 3 логическим секциям с бейджами статуса в шапке
-  - [ ] Модернизация поповера шапки на классы дизайн-системы
-  - [ ] Локализация новых ключей (`ru`, `en`)
-- [ ] 3. Обновление документации:
-  - [ ] Актуализация `docs/design/DESIGN.md`, `README.md`, `docs/README.ru.md`
-- [ ] 4. Тестирование:
-  - [ ] Написание юнит-тестов `test/stability-and-visual.test.mjs`
-  - [ ] Прогон всех тестов (`npm test`)
-- [ ] 5. Сборка, PR, релиз v0.7.10, верификация на MiniAI и закрытие Issue #23
+## Статус выполнения
+- [x] Issue #25 создана
+- [x] Worktree `.worktrees/issue-25` развёрнут
+- [x] Реализация серверной части (`lib/index.js`)
+- [x] Реализация клиентской части (`lib/client.js`)
+- [x] Добавление unit-тестов в `test/`
+- [x] Обновление документации (`DESIGN.md`, `README.md`, `README.ru.md`)
+- [ ] Тестирование на стендах (:3082, :3080)
+- [ ] Публикация релиза v0.8.1
+- [ ] Закрытие Issue #25 и очистка worktree

package/lib/client.js

@@ -11,6 +11,7 @@ window.__ModuleLoader__.load({
 
     const NS = 'dsh-cost-meter'
     const STATE_PATH = '/dsh-cost-meter/state'
+    const REFRESH_PATH = '/dsh-cost-meter/refresh'
     const DAY = 1440
 
     // ----------------------------------------------------------- localization
@@ -24,9 +25,10 @@ window.__ModuleLoader__.load({
       'badge.catalog_empty': 'Каталог: загрузка…',
       'badge.catalog_off': 'Каталог: выключен',
       'badge.catalog_err': 'Каталог: ошибка',
+      'badge.catalog_stale': 'Кэш: офлайн',
       'badge.deepseek': 'Тариф DeepSeek: активен',
       'section.general': 'Основные параметры',
-      'section.general_desc': 'Отображение валюты, курса пересчёта и часового пояса в интерфейсе',
+      'section.general_desc': 'Отображение валюты, курса пересчёта, лимита бюджета и часового пояса',
       'section.openrouter': 'Каталог цен OpenRouter',
       'section.openrouter_desc': 'Публичный каталог моделей для автоматического определения ставок и окон скидок',
       'section.diagnostics': 'Диагностика и статус',
@@ -39,12 +41,23 @@ window.__ModuleLoader__.load({
       'hint.currency': 'Символ валюты для отображения расходов (например, $, ₽, €).',
       'field.usdRate': 'Курс валюты к USD',
       'hint.usdRate': 'Количество единиц вашей валюты за 1 USD (1 для долларов).',
+      'field.budgetThreshold': 'Порог бюджета сессии (USD)',
+      'hint.budgetThreshold': 'Оповещать цветом чипа при превышении суммы за сессию (0 — выключено).',
       'field.displayTimeZone': 'Временная зона (IANA)',
       'hint.displayTimeZone': 'Временная зона для отображения пиковых окон (например, Europe/Moscow, UTC).',
       'field.useOpenRouter': 'Использовать каталог OpenRouter',
       'hint.useOpenRouter': 'Автоматически загружать ставки и скидочные окна для моделей через OpenRouter API.',
       'field.refreshHours': 'Период обновления каталога (часов)',
       'hint.refreshHours': 'Интервал фонового обновления каталога в часах (от 1 до 168).',
+      'action.sync_now': 'Синхронизировать сейчас',
+      'action.syncing': 'Синхронизация…',
+      'action.sync_ok': 'Каталог обновлён',
+      'action.sync_err': 'Ошибка синхронизации',
+      'action.sync_rate_limited': 'Подождите {seconds} сек',
+      'action.copy_report': 'Скопировать сводку',
+      'action.copied': 'Скопировано!',
+      'savings.hint': '💡 Скидка 50% начнётся через {time} ({clock} {zone})',
+      'budget.exceeded': '⚠️ Превышен лимит сессии: {limit}',
       'settings.save': 'Сохранить настройки',
       'settings.saving': 'Сохранение…',
       'settings.saved': 'Настройки успешно сохранены',
@@ -68,9 +81,10 @@ window.__ModuleLoader__.load({
       'badge.catalog_empty': 'Catalog: loading…',
       'badge.catalog_off': 'Catalog: disabled',
       'badge.catalog_err': 'Catalog: error',
+      'badge.catalog_stale': 'Cache: offline',
       'badge.deepseek': 'DeepSeek tariff: active',
       'section.general': 'General Parameters',
-      'section.general_desc': 'Display currency, conversion rate and time zone configuration',
+      'section.general_desc': 'Display currency, conversion rate, budget threshold and time zone configuration',
       'section.openrouter': 'OpenRouter Pricing Catalog',
       'section.openrouter_desc': 'Public catalog for dynamic model pricing and discount windows',
       'section.diagnostics': 'Diagnostics & Status',
@@ -83,12 +97,23 @@ window.__ModuleLoader__.load({
       'hint.currency': 'Currency symbol shown in the UI (e.g. $, ₽, €).',
       'field.usdRate': 'USD Exchange Rate',
       'hint.usdRate': 'Units of currency per 1 USD (1 keeps USD).',
+      'field.budgetThreshold': 'Session Budget Threshold (USD)',
+      'hint.budgetThreshold': 'Warn via chip color when session spend exceeds this amount (0 disables).',
       'field.displayTimeZone': 'Time Zone (IANA)',
       'hint.displayTimeZone': 'IANA time zone for peak hours display (e.g. Europe/Moscow, UTC).',
       'field.useOpenRouter': 'Use OpenRouter Catalog',
       'hint.useOpenRouter': 'Pull rates and discount windows dynamically from public OpenRouter API.',
       'field.refreshHours': 'Catalog Refresh Interval (hours)',
       'hint.refreshHours': 'Background catalog fetch interval in hours (1 to 168).',
+      'action.sync_now': 'Sync Now',
+      'action.syncing': 'Syncing…',
+      'action.sync_ok': 'Catalog updated',
+      'action.sync_err': 'Sync failed',
+      'action.sync_rate_limited': 'Wait {seconds}s',
+      'action.copy_report': 'Copy Summary',
+      'action.copied': 'Copied!',
+      'savings.hint': '💡 50% discount starts in {time} ({clock} {zone})',
+      'budget.exceeded': '⚠️ Budget limit exceeded: {limit}',
       'settings.save': 'Save Settings',
       'settings.saving': 'Saving…',
       'settings.saved': 'Settings saved successfully',
@@ -159,11 +184,12 @@ window.__ModuleLoader__.load({
 .dcm-btn-primary { background: var(--dsw-alias-label-primary); color: var(--dsw-alias-bg-layer-3); border-color: transparent; }
 .dcm-btn-primary:hover:not(:disabled) { opacity: 0.9; }
 .dcm-btn:disabled { opacity: 0.5; cursor: not-allowed; }
+.dcm-btn-sm { padding: 4px 10px; font-size: 12px; border-radius: 6px; }
 
 .dcm-alert { padding: 10px 14px; border-radius: 8px; font-size: 13px; line-height: 1.4; }
 .dcm-alert-ok { background: rgba(16,185,129,0.1); color: var(--dsw-alias-state-success-primary); }
 .dcm-alert-err { background: rgba(239,68,68,0.1); color: var(--dsw-alias-state-error-primary); }
-.dcm-banner-warn { padding: 10px 14px; border-radius: 8px; background: rgba(245,158,11,0.1); color: var(--dsw-alias-state-warning-primary); font-size: 13px; }
+.dcm-tip-box { padding: 8px 12px; border-radius: 8px; background: rgba(99,102,241,0.08); border: 1px solid rgba(99,102,241,0.2); color: var(--dsw-alias-label-primary); font-size: 12px; line-height: 1.4; display: flex; align-items: center; justify-content: space-between; gap: 8px; }
 
 .dcm-stat-box { padding: 10px 12px; border: 1px solid var(--dsw-alias-border-l2); border-radius: 8px; background: var(--dsw-alias-bg-layer-3); display: flex; flex-direction: column; gap: 2px; }
 .dcm-stat-val { font-size: 14px; font-weight: 600; color: var(--dsw-alias-label-primary); font-variant-numeric: tabular-nums; }
@@ -173,6 +199,8 @@ window.__ModuleLoader__.load({
 
 .dcm-chip { display: inline-flex; align-items: center; gap: 6px; height: 22px; padding: 0 8px; border-radius: 6px; border: 1px solid transparent; cursor: pointer; font: inherit; font-size: 12px; font-variant-numeric: tabular-nums; line-height: 22px; transition: opacity .15s ease; }
 .dcm-chip:hover { opacity: 0.88; }
+.dcm-chip-budget-warn { animation: dcm-pulse 2s infinite ease-in-out; }
+@keyframes dcm-pulse { 0%, 100% { border-color: rgba(239,68,68,0.4); } 50% { border-color: rgba(239,68,68,0.9); } }
 
 .dcm-panel { position: absolute; top: 28px; right: 0; z-index: 40; width: 330px; padding: 14px 16px; border-radius: 12px; border: 1px solid var(--dsw-alias-border-l2); background: var(--dsw-alias-bg-layer-2, var(--dsw-alias-bg-base)); box-shadow: 0 10px 30px rgba(0,0,0,.28); font-size: 12px; line-height: 1.5; color: var(--dsw-alias-label-primary); text-align: left; font-variant-numeric: tabular-nums; }
 .dcm-panel-title { font-weight: 600; padding-bottom: 4px; font-size: 13px; }
@@ -318,6 +346,10 @@ window.__ModuleLoader__.load({
       const [saved, setSaved] = React.useState(false)
       const [diagState, setDiagState] = React.useState(null)
 
+      // Manual sync button state
+      const [syncing, setSyncing] = React.useState(false)
+      const [syncMsg, setSyncMsg] = React.useState('')
+
       const settingsScope = (ctx && typeof ctx.get === 'function' ? ctx.get('settingsScope') : null) || (ctx && ctx.settingsScope) || (ctx && ctx.services && ctx.services.settingsScope)
       const scope = React.useMemo(
         () => (settingsScope ? settingsScope.bind({ namespace: NS }) : undefined),
@@ -332,14 +364,17 @@ window.__ModuleLoader__.load({
 
       React.useEffect(() => { ensureStyles() }, [])
 
-      // Poll state for live diagnostics
-      React.useEffect(() => {
-        if (!open) return
+      const fetchDiag = React.useCallback(() => {
         fetch(STATE_PATH, { headers: { accept: 'application/json' } })
           .then((r) => (r.ok ? r.json() : null))
           .then((data) => { if (data) setDiagState(data) })
           .catch(() => {})
-      }, [open])
+      }, [])
+
+      React.useEffect(() => {
+        if (!open) return
+        fetchDiag()
+      }, [open, fetchDiag])
 
       const status = (snapshot && snapshot.status) || 'loading'
       const stored = (snapshot && snapshot.value) || {}
@@ -349,6 +384,7 @@ window.__ModuleLoader__.load({
           setDraft({
             currency: stored.currency !== undefined ? String(stored.currency) : '$',
             usdRate: stored.usdRate !== undefined ? String(stored.usdRate) : '1',
+            budgetThreshold: stored.budgetThreshold !== undefined ? String(stored.budgetThreshold) : '0',
             displayTimeZone: stored.displayTimeZone !== undefined ? String(stored.displayTimeZone) : 'Europe/Moscow',
             useOpenRouter: stored.useOpenRouter !== undefined ? Boolean(stored.useOpenRouter) : true,
             refreshHours: stored.refreshHours !== undefined ? String(stored.refreshHours) : '24',
@@ -358,8 +394,33 @@ window.__ModuleLoader__.load({
 
       const tzValid = draft ? isValidTimeZone(draft.displayTimeZone) : true
       const rateValid = draft ? (!isNaN(Number(draft.usdRate)) && Number(draft.usdRate) > 0) : true
+      const budgetValid = draft ? (!isNaN(Number(draft.budgetThreshold)) && Number(draft.budgetThreshold) >= 0) : true
       const hoursValid = draft ? (!isNaN(Number(draft.refreshHours)) && Number(draft.refreshHours) >= 1 && Number(draft.refreshHours) <= 168) : true
 
+      const handleManualSync = async () => {
+        if (syncing) return
+        setSyncing(true)
+        setSyncMsg('')
+        try {
+          const res = await fetch(REFRESH_PATH, { method: 'POST', headers: { accept: 'application/json' } })
+          if (res.status === 429) {
+            const data = await res.json().catch(() => ({}))
+            const retryAfter = data.retryAfter || 30
+            setSyncMsg(t('action.sync_rate_limited', { seconds: retryAfter }))
+          } else if (res.ok) {
+            setSyncMsg(t('action.sync_ok'))
+            fetchDiag()
+          } else {
+            setSyncMsg(t('action.sync_err'))
+          }
+        } catch (_) {
+          setSyncMsg(t('action.sync_err'))
+        } finally {
+          setSyncing(false)
+          setTimeout(() => setSyncMsg(''), 4000)
+        }
+      }
+
       const save = async () => {
         if (!scope || !draft) return
         setSaving(true); setErr(''); setSaved(false)
@@ -378,6 +439,15 @@ window.__ModuleLoader__.load({
           } catch (e) { broken.push('usdRate: ' + (e && e.message || String(e))) }
         }
 
+        const budgetNum = Number(String(draft.budgetThreshold).trim())
+        if (!Number.isFinite(budgetNum) || budgetNum < 0) {
+          broken.push('budgetThreshold: must be non-negative')
+        } else {
+          try {
+            await scope.set('budgetThreshold', budgetNum)
+          } catch (e) { broken.push('budgetThreshold: ' + (e && e.message || String(e))) }
+        }
+
         const tzVal = String(draft.displayTimeZone || 'Europe/Moscow').trim()
         if (!isValidTimeZone(tzVal)) {
           broken.push('displayTimeZone: invalid IANA time zone')
@@ -432,6 +502,7 @@ window.__ModuleLoader__.load({
                         ? React.createElement('span', { className: 'dcm-badge dcm-badge-ok' }, t('badge.catalog_ok', { count: modelsCount }))
                         : React.createElement('span', { className: 'dcm-badge dcm-badge-warn' }, t('badge.catalog_empty'))))
                 : React.createElement('span', { className: 'dcm-badge dcm-badge-warn' }, t('badge.catalog_off')),
+              catalogHasErr && modelsCount ? React.createElement('span', { className: 'dcm-badge dcm-badge-warn' }, t('badge.catalog_stale')) : null,
               draft && draft.displayTimeZone
                 ? React.createElement('span', { className: 'dcm-badge' }, draft.displayTimeZone)
                 : null,
@@ -471,25 +542,48 @@ window.__ModuleLoader__.load({
                         React.createElement('span', { className: 'dcm-hint' }, t('hint.usdRate')),
                       ),
                     ),
-                    React.createElement('div', { className: 'dcm-field' },
-                      React.createElement('label', { className: 'dcm-label' }, t('field.displayTimeZone')),
-                      React.createElement('input', {
-                        className: 'dcm-input' + (tzValid ? '' : ' dcm-input-err'),
-                        value: (draft && draft.displayTimeZone) !== undefined ? draft.displayTimeZone : '',
-                        onChange: (e) => setDraft({ ...draft, displayTimeZone: e.target.value }),
-                      }),
-                      React.createElement('span', { className: 'dcm-hint' },
-                        tzValid
-                          ? t('hint.displayTimeZone')
-                          : 'Некорректный идентификатор временной зоны IANA'
+                    React.createElement('div', { className: 'dcm-grid-2' },
+                      React.createElement('div', { className: 'dcm-field' },
+                        React.createElement('label', { className: 'dcm-label' }, t('field.budgetThreshold')),
+                        React.createElement('input', {
+                          className: 'dcm-input' + (budgetValid ? '' : ' dcm-input-err'),
+                          type: 'number',
+                          step: 'any',
+                          min: 0,
+                          value: (draft && draft.budgetThreshold) !== undefined ? draft.budgetThreshold : '',
+                          onChange: (e) => setDraft({ ...draft, budgetThreshold: e.target.value }),
+                        }),
+                        React.createElement('span', { className: 'dcm-hint' }, t('hint.budgetThreshold')),
+                      ),
+                      React.createElement('div', { className: 'dcm-field' },
+                        React.createElement('label', { className: 'dcm-label' }, t('field.displayTimeZone')),
+                        React.createElement('input', {
+                          className: 'dcm-input' + (tzValid ? '' : ' dcm-input-err'),
+                          value: (draft && draft.displayTimeZone) !== undefined ? draft.displayTimeZone : '',
+                          onChange: (e) => setDraft({ ...draft, displayTimeZone: e.target.value }),
+                        }),
+                        React.createElement('span', { className: 'dcm-hint' },
+                          tzValid ? t('hint.displayTimeZone') : 'Некорректный идентификатор временной зоны IANA'
+                        ),
                       ),
                     ),
                   ),
 
                   // Section 2: OpenRouter Pricing Catalog
                   React.createElement('div', { className: 'dcm-section-card' },
-                    React.createElement('div', { className: 'dcm-section-title' }, t('section.openrouter')),
+                    React.createElement('div', { className: 'dcm-section-title' },
+                      React.createElement('span', null, t('section.openrouter')),
+                      openRouterEnabled
+                        ? React.createElement('button', {
+                            type: 'button',
+                            className: 'dcm-btn dcm-btn-sm',
+                            disabled: syncing,
+                            onClick: handleManualSync,
+                          }, syncing ? t('action.syncing') : t('action.sync_now'))
+                        : null
+                    ),
                     React.createElement('div', { className: 'dcm-section-desc' }, t('section.openrouter_desc')),
+                    syncMsg ? React.createElement('div', { className: 'dcm-alert dcm-alert-ok', style: { padding: '6px 10px', fontSize: 12 } }, syncMsg) : null,
                     React.createElement('div', { className: 'dcm-row-check' },
                       React.createElement('input', {
                         id: 'dcm-use-openrouter',
@@ -554,7 +648,7 @@ window.__ModuleLoader__.load({
                     React.createElement('button', {
                       type: 'button',
                       className: 'dcm-btn dcm-btn-primary',
-                      disabled: saving || !tzValid || !rateValid || !hoursValid,
+                      disabled: saving || !tzValid || !rateValid || !budgetValid || !hoursValid,
                       onClick: save,
                     }, saving ? t('settings.saving') : t('settings.save')),
                   ),
@@ -575,24 +669,55 @@ window.__ModuleLoader__.load({
       return (schedule && schedule.base) || { cacheHit: 0, input: 0, cacheWrite: 0, output: 0 }
     }
 
+    /**
+     * Fast O(K) lookup of next tariff rate boundary instead of a 1440-minute loop.
+     */
     function minutesUntilChange(schedule, minute) {
+      const windows = (schedule && schedule.windows) || []
+      if (!windows.length) return null
       const now = ratesAt(schedule, minute)
-      for (let step = 1; step <= DAY; step += 1) {
-        const probe = ratesAt(schedule, (minute + step) % DAY)
-        if (probe.output !== now.output || probe.input !== now.input) return step
+      // Transition points can only occur at window start or window end
+      const transitions = new Set()
+      for (const w of windows) {
+        transitions.add(w.start % DAY)
+        transitions.add(w.end % DAY)
+      }
+      let minDiff = null
+      for (const t of transitions) {
+        let diff = (t - minute + DAY) % DAY
+        if (diff === 0) diff = DAY
+        const probe = ratesAt(schedule, (minute + diff) % DAY)
+        if (probe.output !== now.output || probe.input !== now.input) {
+          if (minDiff === null || diff < minDiff) minDiff = diff
+        }
       }
-      return null
+      return minDiff
     }
 
+    /**
+     * Memoized calculation of low and high rate extremes for a schedule.
+     */
+    const extremesMemo = new WeakMap()
     function extremes(schedule) {
-      let low = null
-      let high = null
-      for (let minute = 0; minute < DAY; minute += 1) {
-        const r = ratesAt(schedule, minute)
-        if (!low || r.output < low.output) low = r
-        if (!high || r.output > high.output) high = r
+      if (!schedule) return { low: {}, high: {}, flat: true }
+      if (extremesMemo.has(schedule)) return extremesMemo.get(schedule)
+
+      const base = schedule.base || { cacheHit: 0, input: 0, cacheWrite: 0, output: 0 }
+      const candidates = [base]
+      for (const w of (schedule.windows || [])) {
+        if (w.rates) candidates.push(w.rates)
+      }
+
+      let low = candidates[0]
+      let high = candidates[0]
+      for (const r of candidates) {
+        if (r.output < low.output) low = r
+        if (r.output > high.output) high = r
       }
-      return { low: low || {}, high: high || {}, flat: !low || !high || low.output === high.output }
+
+      const res = { low, high, flat: low.output === high.output }
+      extremesMemo.set(schedule, res)
+      return res
     }
 
     function sumSlots(slots) {
@@ -682,6 +807,7 @@ window.__ModuleLoader__.load({
       const [state, setState] = React.useState(null)
       const [open, setOpen] = React.useState(false)
       const [now, setNow] = React.useState(() => new Date())
+      const [copied, setCopied] = React.useState(false)
       const box = React.useRef(null)
 
       React.useEffect(() => { ensureStyles() }, [])
@@ -732,6 +858,7 @@ window.__ModuleLoader__.load({
       const stored = (settingsSnap && settingsSnap.value) || {}
       const currency = stored.currency !== undefined ? String(stored.currency) : (state.currency || '$')
       const fx = stored.usdRate !== undefined && !isNaN(Number(stored.usdRate)) ? Number(stored.usdRate) : (Number(state.usdRate) || 1)
+      const budgetThreshold = stored.budgetThreshold !== undefined ? Number(stored.budgetThreshold) : (Number(state.budgetThreshold) || 0)
       const schedule = state.schedule
       const hasUsage = usage !== undefined && usage !== null
       const minute = now.getUTCHours() * 60 + now.getUTCMinutes()
@@ -758,7 +885,8 @@ window.__ModuleLoader__.load({
       const active = ratesAt(schedule, minute)
       const { low, high, flat } = extremes(schedule)
       const cheapNow = !flat && active.output === low.output
-      const left = clock(minutesUntilChange(schedule, minute))
+      const leftMinutes = minutesUntilChange(schedule, minute)
+      const left = clock(leftMinutes)
 
       const schedules = state.schedules || {}
       const perModel = used.map((m) => {
@@ -778,8 +906,16 @@ window.__ModuleLoader__.load({
         ? perModel.reduce((sum, m) => sum + m.cost, 0)
         : spendUsd(usage, active) * fx
 
-      const fg = cheapNow ? 'var(--dsw-alias-state-success-primary)' : 'var(--dsw-alias-state-warning-primary)'
-      const bg = cheapNow ? 'rgba(16,185,129,0.12)' : 'rgba(245,158,11,0.12)'
+      // Check budget threshold in USD
+      const totalUsd = fx > 0 ? total / fx : total
+      const budgetExceeded = budgetThreshold > 0 && totalUsd >= budgetThreshold
+
+      const fg = budgetExceeded
+        ? 'var(--dsw-alias-state-error-primary)'
+        : (cheapNow ? 'var(--dsw-alias-state-success-primary)' : 'var(--dsw-alias-state-warning-primary)')
+      const bg = budgetExceeded
+        ? 'rgba(239,68,68,0.14)'
+        : (cheapNow ? 'rgba(16,185,129,0.12)' : 'rgba(245,158,11,0.12)')
       const activeCell = { textAlign: 'right', padding: '3px 6px', borderRadius: 4, background: bg, color: fg, fontWeight: 600 }
 
       const rateRow = (label, key) => flat
@@ -820,13 +956,56 @@ window.__ModuleLoader__.load({
         .join(', ')
       const nowLocal = hhmmInZone(minute, zone, now)
 
+      // Copy textual report to clipboard
+      const copyReport = () => {
+        const lines = [
+          '=== ' + (state.route ? state.route.model : 'Cost Meter Report') + ' ===',
+          'Сессия: ' + (hasUsage ? money(total, currency) : '—') + (budgetThreshold > 0 ? ' (порог ' + money(budgetThreshold * fx, currency) + ')' : ''),
+          'Тариф: ' + (cheapNow ? 'Льготный (не-пик)' : 'Полный (пик)'),
+          'Ставки (1M): вход ' + rate(active.input) + ', выход ' + rate(active.output) + ', кэш ' + rate(active.cacheHit),
+        ]
+        if (hasUsage && usage) {
+          lines.push('Токены: вход ' + tokens(usage.inputTokens) + ', выход ' + tokens(usage.outputTokens) + ', кэш-хит ' + tokens(usage.cacheReadTokens))
+        }
+        const text = lines.join('\n')
+        if (typeof navigator !== 'undefined' && navigator.clipboard && navigator.clipboard.writeText) {
+          navigator.clipboard.writeText(text).then(() => {
+            setCopied(true)
+            setTimeout(() => setCopied(false), 2000)
+          }).catch(() => {})
+        } else {
+          setCopied(true)
+          setTimeout(() => setCopied(false), 2000)
+        }
+      }
+
+      // Calculate upcoming discount hint
+      let discountHint = null
+      if (!flat && !cheapNow && leftMinutes) {
+        const nextTimeMinutes = (minute + leftMinutes) % DAY
+        const clockTime = hhmmInZone(nextTimeMinutes, zone, now)
+        discountHint = t('savings.hint', {
+          time: left,
+          clock: clockTime,
+          zone: zl,
+        })
+      }
+
       return h('div', { ref: box, style: { position: 'relative' } }, [
         h('button', {
           key: 'chip', type: 'button',
-          className: 'dcm-chip',
-          style: { background: bg, color: fg, borderColor: cheapNow ? 'rgba(16,185,129,0.3)' : 'rgba(245,158,11,0.3)' },
+          className: 'dcm-chip' + (budgetExceeded ? ' dcm-chip-budget-warn' : ''),
+          style: {
+            background: bg,
+            color: fg,
+            borderColor: budgetExceeded
+              ? 'rgba(239,68,68,0.5)'
+              : (cheapNow ? 'rgba(16,185,129,0.3)' : 'rgba(245,158,11,0.3)'),
+          },
           onClick: () => setOpen((v) => !v),
-          title: flat ? 'Единый тариф' : cheapNow ? 'Льготный тариф' : 'Полный тариф',
+          title: budgetExceeded
+            ? t('budget.exceeded', { limit: money(budgetThreshold * fx, currency) })
+            : (flat ? 'Единый тариф' : cheapNow ? 'Льготный тариф' : 'Полный тариф'),
         }, [
           h('span', { key: 'sum' }, hasUsage ? '≈ ' + money(total, currency) : '—'),
           left ? h('span', { key: 'left', style: { opacity: 0.75 } }, left) : null,
@@ -848,6 +1027,11 @@ window.__ModuleLoader__.load({
             : h('div', { key: 'clock', className: 'dcm-panel-note' },
                 'Пик: ' + windowText + ' ' + zl + ' · сейчас ' + nowLocal + ' ' + zl),
 
+          discountHint ? h('div', { key: 'savings-box', className: 'dcm-tip-box', style: { marginTop: 6 } }, discountHint) : null,
+
+          budgetExceeded ? h('div', { key: 'budget-warn', className: 'dcm-alert dcm-alert-err', style: { marginTop: 6, padding: '6px 10px', fontSize: 11 } },
+            t('budget.exceeded', { limit: money(budgetThreshold * fx, currency) })) : null,
+
           h('hr', { key: 'hr1', className: 'dcm-hr' }),
 
           h('div', { key: 'rates', className: flat ? 'dcm-panel-grid-flat' : 'dcm-panel-grid' }, [
@@ -934,6 +1118,14 @@ window.__ModuleLoader__.load({
 
           hasUsage ? null : h('div', { key: 'nodata', className: 'dcm-panel-note', style: { paddingTop: 6 } },
             'Провайдер ещё не сообщил usage для этой сессии.'),
+
+          h('div', { key: 'footer-actions', style: { display: 'flex', justifyContent: 'flex-end', marginTop: 10 } },
+            h('button', {
+              type: 'button',
+              className: 'dcm-btn dcm-btn-sm',
+              onClick: copyReport,
+            }, copied ? t('action.copied') : t('action.copy_report'))
+          ),
         ]) : null,
       ])
     }
@@ -962,7 +1154,17 @@ window.__ModuleLoader__.load({
       }
     }
 
-    module.exports = { apply, inject: ['slots', 'locale', 'settingsScope'], CostMeterCard, CostMeter, ErrorBoundary, ensureStyles }
+    module.exports = {
+      apply,
+      inject: ['slots', 'locale', 'settingsScope'],
+      CostMeterCard,
+      CostMeter,
+      ErrorBoundary,
+      ensureStyles,
+      minutesUntilChange,
+      extremes,
+      ratesAt,
+    }
     return module.exports
   },
 })

package/lib/index.js

@@ -13,6 +13,7 @@
 //
 // No agent hooks: the widget only reads, so it cannot corrupt a session.
 
+import { createHash } from 'node:crypto'
 import { mkdirSync, readFileSync, writeFileSync } from 'node:fs'
 import { homedir } from 'node:os'
 import { dirname, join } from 'node:path'
@@ -24,6 +25,7 @@ export const inject = ['webServer']
 
 const NS = 'dsh-cost-meter'
 const STATE_PATH = '/dsh-cost-meter/state'
+const REFRESH_PATH = '/dsh-cost-meter/refresh'
 const CATALOG_URL = 'https://openrouter.ai/api/v1/models'
 const CACHE_FILE = join(process.env.DSH_HOME || join(homedir(), '.dsh'), 'storages', 'dsh-cost-meter-catalog.json')
 
@@ -48,10 +50,21 @@ const DEEPSEEK_PEAK_RATES = {
 }
 const DEEPSEEK_PEAK_WINDOWS = [{ start: 60, end: 240 }, { start: 360, end: 600 }]
 
-// ponytail: a DeepSeek model reached THROUGH OpenRouter is still priced from
-// this table, though the bill comes from OpenRouter. Fix by classifying the
-// route (provider id / baseURL) before the model, and for a `:floor` slug take
-// the minimum over /models/{id}/endpoints rather than the base listing.
+/** Common provider / vendor aliases for seamless catalog matching. */
+export const VENDOR_ALIASES = {
+  'z-ai': 'zai',
+  'zai': 'zai',
+  'google': 'google',
+  'gemini': 'google',
+  'deepseek-ai': 'deepseek',
+  'deepseek-official': 'deepseek',
+  'deepseek': 'deepseek',
+  'anthropic-ai': 'anthropic',
+  'anthropic': 'anthropic',
+  'openai': 'openai',
+  'meta-llama': 'meta-llama',
+  'meta': 'meta-llama',
+}
 
 export const Config = z.object({
   currency: z.string().description('Currency symbol shown in the widget.').default('$'),
@@ -60,6 +73,10 @@ export const Config = z.object({
     .string()
     .description('IANA zone the widget shows tariff hours in.')
     .default('Europe/Moscow'),
+  budgetThreshold: z
+    .number()
+    .description('Optional session budget threshold in USD. 0 disables threshold warnings.')
+    .default(0),
   deepseekPeakPrices: z
     .dict(PriceRow)
     .description('Override the built-in DeepSeek peak rates, by model id.')
@@ -146,9 +163,8 @@ function scheduleOf(entry) {
 }
 
 /**
- * Map a harness route onto an OpenRouter id. Exact id first, then the vendor
- * suffix (`deepseek-official/deepseek-v4-flash` -> `deepseek/deepseek-v4-flash`),
- * which is what the shared model names make possible.
+ * Map a harness route onto an OpenRouter id. Exact id first, then normalized
+ * vendor alias + model, then vendor suffix.
  */
 export function matchModel(index, route, modelMap) {
   if (!route || !index) return undefined
@@ -157,6 +173,15 @@ export function matchModel(index, route, modelMap) {
   if (mapped && index.byId && index.byId[mapped]) return mapped
   if (index.byId && index.byId[key]) return key
   if (index.byId && index.byId[route.model]) return route.model
+
+  // Provider alias check (e.g. z-ai -> zai, deepseek-official -> deepseek)
+  const prov = String(route.provider || '').toLowerCase()
+  const aliasProv = VENDOR_ALIASES[prov]
+  if (aliasProv && route.model) {
+    const aliasKey = (aliasProv + '/' + route.model).toLowerCase()
+    if (index.byLowerId && index.byLowerId[aliasKey]) return index.byLowerId[aliasKey]
+  }
+
   // Harness routes name models in their own casing (`MiniMax-M3`), the catalog
   // is lower-case (`minimax/minimax-m3`), so matching is case-insensitive.
   const lower = String(route.model).toLowerCase()
@@ -188,23 +213,10 @@ export function indexCatalog(models) {
 
 // ---------------------------------------------------------------------------
 // Per-model usage projection
-//
-// `tokenUsage` from dsh-token-meter totals the whole session, which prices
-// wrongly the moment the model changes mid-session. The log has what is
-// needed: `request/header` carries `header.config = {provider, model}`, and
-// usage arrives afterwards for that same step. So this unit keeps the last
-// header's route and files every usage sample under it.
-//
-// The replace-if-same-step guard mirrors token-meter: a streamed usage chunk
-// and the finalized assistant message report the same numbers for one step.
 // ---------------------------------------------------------------------------
 
 const ZERO = { uncachedInputTokens: 0, outputTokens: 0, cacheReadTokens: 0, cacheWriteTokens: 0 }
 
-// Projection schemas are validated with ZOD, not schemastery: the registry
-// calls `schema.parse(view)` at the boundary, and a schemastery schema has no
-// `.parse`, which fails every history read with
-// "registration.def.schema.parse is not a function".
 const bucketSchema = zod.object({
   uncachedInputTokens: zod.number().nonnegative(),
   outputTokens: zod.number().nonnegative(),
@@ -246,10 +258,7 @@ function usageOf(event) {
 }
 
 /**
- * Half-hour slot of the UTC day an event falls into (0..47). Tariff windows are
- * expressed in UTC clock time, and every real schedule so far lands on a whole
- * or half hour, so 48 slots reproduce the rate exactly while keeping the state
- * small enough to ship on every projection frame.
+ * Half-hour slot of the UTC day an event falls into (0..47).
  */
 export function slotOf(timeMs) {
   let ms = typeof timeMs === 'number' && Number.isFinite(timeMs) ? timeMs : NaN
@@ -270,9 +279,6 @@ const usageByModelProjection = {
     models: zod.array(zod.object({
       provider: zod.string(),
       model: zod.string(),
-      // Usage split by the half-hour of the UTC day it was spent in. Spend is
-      // priced at the rate in force THEN; a later tariff switch must not
-      // reprice tokens that are already paid for.
       slots: zod.record(zod.string(), bucketSchema),
     })),
   }).strict(),
@@ -292,8 +298,6 @@ const usageByModelProjection = {
     const key = route.provider + '/' + route.model
     const slot = String(slotOf(event.time))
     const buckets = bucketsFromUsage(sample.usage)
-    // A streamed usage chunk and the finalized assistant message report the
-    // same step twice; the second one replaces the first instead of adding.
     const previous =
       state.last !== null &&
       state.last.turn === sample.turn &&
@@ -344,12 +348,11 @@ function defaultRoute(ctx) {
 
 /**
  * Resolve one route's tariff: manual config wins, then DeepSeek's own table,
- * then the OpenRouter catalog. Returns `schedule: null` when nothing knows it,
- * so the widget can say so instead of pricing at zero.
+ * then the OpenRouter catalog.
  */
 export function resolveTariff(cfg, index, route) {
   if (!route) return { schedule: null, source: 'none', matchedId: null }
-  const key = route.provider + '/' + route.model
+  const key = route.provider ? route.provider + '/' + route.model : route.model
   const prices = cfg.prices || {}
   const manual = prices[key] || prices[route.model] || prices['*']
 
@@ -380,15 +383,10 @@ export function resolveTariff(cfg, index, route) {
     return { schedule, source: 'manual', matchedId: key }
   }
 
-  // Keyed by MODEL, not provider: a DeepSeek model is billed at DeepSeek's
-  // published rate whoever routes it (deepseek-official, opencode-go, ollama).
-  // Date/variant suffixes (`deepseek-v4-flash:0731`) name the same product.
-  const providerLower = String(route.provider || "").toLowerCase();
-  // #3: Provider-aware routing: if routed explicitly through OpenRouter,
-  // consult OpenRouter catalog first to honor actual provider billing.
-  if (providerLower === "openrouter" && cfg.useOpenRouter !== false) {
-    const matchedId = matchModel(index, route, cfg.modelMap);
-    if (matchedId) return { schedule: index.byId[matchedId], source: "openrouter", matchedId };
+  const providerLower = String(route.provider || '').toLowerCase()
+  if (providerLower === 'openrouter' && cfg.useOpenRouter !== false) {
+    const matchedId = matchModel(index, route, cfg.modelMap)
+    if (matchedId) return { schedule: index.byId[matchedId], source: 'openrouter', matchedId }
   }
 
   const base = String(route.model).toLowerCase().split(':')[0]
@@ -434,6 +432,25 @@ export function splitRoute(key) {
 export function apply(ctx, config) {
   let current = config
   let catalog = { index: { byId: {}, byLowerId: {}, bySuffix: {} }, fetchedAt: 0, error: null }
+  let lastManualRefreshAt = 0
+
+  // Server-side cache for resolved tariffs: key -> { schedule, source, matchedId }
+  const resolveCache = new Map()
+
+  function getCachedTariff(cfg, route) {
+    if (!route) return resolveTariff(cfg, catalog.index, route)
+    const cacheKey = (route.provider || '') + '/' + (route.model || '')
+    if (resolveCache.has(cacheKey)) return resolveCache.get(cacheKey)
+    const res = resolveTariff(cfg, catalog.index, route)
+    // Limit cache size to prevent runaway memory
+    if (resolveCache.size >= 500) resolveCache.clear()
+    resolveCache.set(cacheKey, res)
+    return res
+  }
+
+  function clearResolveCache() {
+    resolveCache.clear()
+  }
 
   // Disk cache survives restarts, so a boot without network still prices.
   try {
@@ -445,11 +462,11 @@ export function apply(ctx, config) {
     // absent or unreadable cache is normal on first run
   }
 
-  async function refresh(signal) {
+  async function refresh(signal, force = false) {
     const cfg = current ?? config
     if (cfg.useOpenRouter === false) return
     const ageMs = Date.now() - catalog.fetchedAt
-    if (catalog.fetchedAt && ageMs < (Number(cfg.refreshHours) || 24) * 3600e3) return
+    if (!force && catalog.fetchedAt && ageMs < (Number(cfg.refreshHours) || 24) * 3600e3) return
     try {
       const timeoutSignal = AbortSignal.timeout(15000)
       const combinedSignal = signal ? (AbortSignal.any ? AbortSignal.any([signal, timeoutSignal]) : timeoutSignal) : timeoutSignal
@@ -458,9 +475,9 @@ export function apply(ctx, config) {
       const body = await response.json()
       const models = Array.isArray(body && body.data) ? body.data : []
       if (models.length === 0) throw new Error('empty catalog')
-      // Keep only what pricing needs — the raw payload is mostly prose.
       const slim = models.map((m) => ({ id: m.id, pricing: m.pricing }))
       catalog = { index: indexCatalog(slim), fetchedAt: Date.now(), error: null }
+      clearResolveCache()
       try {
         mkdirSync(dirname(CACHE_FILE), { recursive: true })
         writeFileSync(CACHE_FILE, JSON.stringify({ fetchedAt: catalog.fetchedAt, models: slim }))
@@ -478,16 +495,17 @@ export function apply(ctx, config) {
     current = scope.get() ?? config
     const stop = scope.watch(() => {
       current = scope.get() ?? config
+      clearResolveCache()
       void refresh()
     })
     sctx.effect(() => () => {
       stop()
       current = config
+      clearResolveCache()
     })
   })
 
-  // Optional capability: headless assemblies without the registry keep working,
-  // the widget just falls back to the session-wide tokenUsage projection.
+  // Optional capability: headless assemblies without the registry keep working
   ctx.inject(['sessionProjections'], (pctx) => {
     pctx.sessionProjections.register(usageByModelProjection)
   })
@@ -502,6 +520,46 @@ export function apply(ctx, config) {
     }
   }, 'dsh-cost-meter: catalog refresh')
 
+  // Route 1: POST /dsh-cost-meter/refresh (manual on-demand sync with 30s cooldown)
+  ctx.effect(
+    () =>
+      ctx.webServer.register({
+        kind: 'exact',
+        path: REFRESH_PATH,
+        handler: async (req, res) => {
+          if (req.method !== 'POST') {
+            res.writeHead(405, { 'Content-Type': 'application/json' })
+            res.end(JSON.stringify({ error: 'method not allowed' }))
+            return
+          }
+          const now = Date.now()
+          const COOLDOWN_MS = 30000
+          if (now - lastManualRefreshAt < COOLDOWN_MS) {
+            const retryAfter = Math.ceil((COOLDOWN_MS - (now - lastManualRefreshAt)) / 1000)
+            res.writeHead(429, {
+              'Content-Type': 'application/json',
+              'Retry-After': String(retryAfter),
+            })
+            res.end(JSON.stringify({ error: 'rate limit exceeded', retryAfter }))
+            return
+          }
+          lastManualRefreshAt = now
+          const controller = new AbortController()
+          await refresh(controller.signal, true)
+          const modelsCount = Object.keys((catalog.index && catalog.index.byId) || {}).length
+          res.writeHead(200, { 'Content-Type': 'application/json' })
+          res.end(JSON.stringify({
+            ok: !catalog.error,
+            fetchedAt: catalog.fetchedAt,
+            modelsCount,
+            error: catalog.error,
+          }))
+        },
+      }),
+    'dsh-cost-meter: refresh route',
+  )
+
+  // Route 2: GET /dsh-cost-meter/state (with ETag and 304 Not Modified)
   ctx.effect(
     () =>
       ctx.webServer.register({
@@ -515,10 +573,8 @@ export function apply(ctx, config) {
           }
           const cfg = current ?? config
           const route = defaultRoute(ctx) ?? null
-          const own = resolveTariff(cfg, catalog.index, route)
+          const own = getCachedTariff(cfg, route)
 
-          // The client asks for every model the session actually used, so a
-          // session that switched models can price each part on its own tariff.
           const schedules = {}
           const asked = new URL(req.url, 'http://localhost').searchParams.get('models')
           for (const key of (asked ? asked.split(',') : []).slice(0, 24)) {
@@ -526,7 +582,7 @@ export function apply(ctx, config) {
             if (!trimmed || trimmed.length > 128) continue
             const parsed = splitRoute(trimmed)
             if (!parsed) continue
-            const resolved = resolveTariff(cfg, catalog.index, parsed)
+            const resolved = getCachedTariff(cfg, parsed)
             schedules[trimmed] = {
               schedule: resolved.schedule,
               source: resolved.source,
@@ -534,11 +590,11 @@ export function apply(ctx, config) {
             }
           }
 
-          res.writeHead(200, { 'Content-Type': 'application/json', 'Cache-Control': 'no-store' })
-          res.end(JSON.stringify({
+          const payloadObj = {
             currency: cfg.currency,
             usdRate: cfg.usdRate,
             displayTimeZone: cfg.displayTimeZone || 'Europe/Moscow',
+            budgetThreshold: Number(cfg.budgetThreshold) || 0,
             route,
             source: own.source,
             matchedId: own.matchedId,
@@ -547,7 +603,26 @@ export function apply(ctx, config) {
             catalogError: catalog.error,
             catalogModelsCount: Object.keys((catalog.index && catalog.index.byId) || {}).length,
             schedule: own.schedule,
-          }))
+          }
+
+          const serialized = JSON.stringify(payloadObj)
+          const etag = 'W/"' + createHash('sha1').update(serialized).digest('base64url').slice(0, 16) + '"'
+
+          if (req.headers['if-none-match'] === etag) {
+            res.writeHead(304, {
+              'ETag': etag,
+              'Cache-Control': 'no-cache',
+            })
+            res.end()
+            return
+          }
+
+          res.writeHead(200, {
+            'Content-Type': 'application/json',
+            'Cache-Control': 'no-cache',
+            'ETag': etag,
+          })
+          res.end(serialized)
         },
       }),
     'dsh-cost-meter: state route',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodandready/dsh-cost-meter",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "DeepSeek Harness plugin: a session cost chip in the conversation header - live token usage by bucket, peak/off-peak tariff, and a countdown to the next tariff switch.",
   "type": "module",
   "main": "lib/index.js",