vkusvill 0.0.0-dev.0 → 0.0.0-stage

package/README.md

@@ -1,91 +1,3 @@
-# vkusvill-cli
+# Temporary Holding Version
 
-**English** · [Русский](README.ru.md)
-
-An unofficial VkusVill client for the terminal. A full-screen app drawn in text graphics on top of the [official VkusVill MCP server](https://github.com/vkustech/vkusvill-mcp-server-manifest): the catalog, deals, recipes, shops and a cart you check out on your phone by scanning a QR code straight from the terminal.
-
-```bash
-npx vkusvill-cli            # once published to npm
-npx ./vv-cli                # from this folder, today
-npx vkusvill-cli сырники    # open straight into a search
-```
-
-Needs Node 18.17+ and a terminal of at least 64×18. It looks best with 24-bit colour: iTerm2, WezTerm, Ghostty, kitty, the VS Code terminal. Terminal.app is limited to 256 colours.
-
-The interface speaks Russian, like the store.
-
-## What's inside
-
-- **Catalog.** Search as you type, categories from VkusVill's answer, suggestions and recent searches. An empty search shows today's deals. The side card shows the photo in half-blocks, the price in postal-envelope digits, the rating, nutrition facts with the energy split, ingredient flags and the ingredient list with sugar, additives, gluten and lactose highlighted.
-- **Sorting and filters.** VkusVill's own sorts plus local ones over loaded results: price per kg, protein per rouble, calories, discount size. Filters: no sugar, gluten, lactose, additives or palm oil; on sale only; rating 4.8+; protein 10 g+; under 150 kcal. When filters leave too few results, more pages load by themselves.
-- **Product page.** Photo gallery, a Braille doughnut of the protein/fat/carb energy split, description and every property (shelf life, storage, maker, allergens). `[` and `]` step through neighbouring products, `a` shows analogues.
-- **Compare.** Up to four products side by side, with the best value in each row marked.
-- **Deals.** Loyalty-card discounts and "buy N or more" offers, VkusVill brand only or every brand.
-- **Recipes.** VkusVill's search and filters: exclude allergens, cooking time, difficulty, method. A recipe page has the steps and an ingredient checklist; `+` puts every ticked ingredient in the cart.
-- **Shops.** Region, city, metro and amenities. City and metro lists narrow to the chosen region. Search by address with `/`, an "open now" count, opening hours turned into "open until 23:00" or "closed", courier-only dark stores marked as such. The map is drawn in Braille dots over the outline of the MKAD ring road and the Garden Ring; `z` zooms to the selected shop, `L` loads every shop of the filter onto the map.
-- **Cart.** Quantities change with the arrows; the total is in big digits, with savings from deals, the nutrition of the whole cart and a breakdown by category. Prices older than six hours are re-checked quietly. Checkout creates a VkusVill link and shows a QR code: point your phone at it and the cart opens in the VkusVill app. Payment and delivery stay with VkusVill.
-- **Profile.** Favourites and history are kept locally. Orders, "favourite product" and personal discounts are only available to signed-in users; pass a token via `VV_TOKEN` if you have one.
-- **Everywhere.** Mouse (click, double click, wheel), a command palette on `Ctrl+K`, barcode lookup (`b`), help (`?`). Hotkeys also work with the Russian keyboard layout. The last tab, sorts and filters are remembered between runs.
-
-## Keys
-
-| Key | Action |
-|---|---|
-| `1`…`6`, `Tab` | tabs |
-| `/` | search |
-| `↑↓`, `j k` | move |
-| `⏎` | open |
-| `+ −` | add to / remove from cart |
-| `*` | favourite |
-| `s`, `f`, `g` | sort, filters, category |
-| `x`, `X` | mark for comparison, compare |
-| `o` | open on the website; in the cart — check out |
-| `Ctrl+K` | command palette |
-| `?` | all keys |
-| `esc` | back |
-| `q` | quit |
-
-## Commands for scripts
-
-```bash
-vv search творог --sort price_asc   # a table; --json prints VkusVill's answer
-vv deals --quantity
-vv product 27695
-vv barcode 4607167640050
-vv recipes тыква
-vv shops Речной вокзал
-vv cart add 27695 2
-vv cart link                        # link and QR code right in the output
-```
-
-## How it works
-
-- `src/term` — a dependency-free terminal engine: a cell buffer that sends only changed cells, synchronised output without flicker, truecolor with a 256-colour fallback, SGR mouse, bracketed paste, wide characters.
-- `src/api.js` — JSON-RPC to `https://mcp.vkusvill.ru/mcp`. A disk cache (catalog 6 h, deals 1 h, shops a week, photos a month), a priority queue where interactive requests go before background ones, at most 55 requests a minute, retries on 429.
-- `src/image.js` — WebP photos are decoded inside Node via wasm (`@jsquash/webp`), no system libraries. Plain margins are trimmed and the picture is averaged down to the cell grid.
-- Big prices are drawn with background-filled cells rather than glyphs, so they stay solid whatever the line spacing.
-- The QR code comes from `qrcode-generator`; `test/qr-check.mjs` decodes the code rebuilt from screen cells.
-
-## Privacy and safety
-
-- **Nothing leaves your machine except requests to VkusVill.** No analytics, no third-party servers.
-- **Text from the network is cleaned** before it reaches the screen or the command output: terminal control characters (ESC, C1 codes such as `\x9b`) and bidi overrides are removed, so a product name cannot drive your terminal or disguise itself.
-- **Links open only to `https://` VkusVill and Yandex hosts**, without a shell (on Windows via `rundll32`, not `cmd`). Photos load only from VkusVill hosts, with size limits.
-- **The token is sent to `mcp.vkusvill.ru` only**, even if `VV_ENDPOINT` points elsewhere. Orders, personal discounts and personalised results are never written to disk.
-- **State** lives in `~/.config/vv-cli/state.json`, readable by you only (0600). Writes are atomic; a damaged file is kept as `state.json.broken-<time>` instead of being overwritten; a second running copy or `vv cart add` updates the open app instead of clobbering it.
-- **The cache** lives in `~/Library/Caches/vv-cli` or `~/.cache/vv-cli`, expires by itself and is capped at 300 MB. Crashes are logged to `vv-cli.log` next to it.
-
-Ingredient flags ("sugar", "additives ×3" and so on) are heuristics over the first manufacturer's ingredient list, not medical advice. Shop hours are compared with Moscow time.
-
-## Development
-
-```bash
-npm install
-node bin/vv.js --no-splash
-npm test                      # offline checks: terminal safety, links, state file, command line
-node test/snap.js 120 36      # scripted run without a terminal → test/out/*.html (xterm.js) and gallery.html
-```
-
-Environment: `VV_TOKEN`, `VV_COLOR=256|truecolor`, `NO_COLOR`, `VV_NO_SPLASH`, `VV_CACHE_DIR`, `VV_CONFIG_DIR`, `VV_ENDPOINT`.
-
-Not affiliated with VkusVill. Data and trademarks belong to their owners.
+This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.

package/package.json

@@ -1,39 +1,6 @@
 {
   "name": "vkusvill",
-  "version": "0.0.0-dev.0",
-  "description": "Unofficial VkusVill in your terminal: catalog, deals, recipes, shops and a cart with a QR code, drawn in text graphics on top of VkusVill's official MCP server",
-  "type": "module",
-  "bin": {
-    "vkusvill-cli": "bin/vv.js",
-    "vv": "bin/vv.js"
-  },
-  "files": [
-    "bin",
-    "src",
-    "README.md",
-    "README.ru.md",
-    "LICENSE"
-  ],
-  "engines": {
-    "node": ">=18.17"
-  },
-  "scripts": {
-    "start": "node bin/vv.js",
-    "test": "node test/check.mjs",
-    "snap": "node test/snap.js"
-  },
-  "keywords": [
-    "vkusvill",
-    "вкусвилл",
-    "tui",
-    "cli",
-    "mcp",
-    "terminal",
-    "grocery"
-  ],
-  "license": "MIT",
-  "dependencies": {
-    "@jsquash/webp": "1.5.0",
-    "qrcode-generator": "1.5.2"
-  }
-}
+  "version": "0.0.0-stage",
+  "stub": true,
+  "description": "Temporary package placeholder for staged publishing"
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Anton Golub
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/README.ru.md

@@ -1,89 +0,0 @@
-# vkusvill-cli
-
-[English](README.md) · **Русский**
-
-Неофициальный ВкусВилл в терминале. Полноэкранное приложение на псевдографике поверх [официального MCP-сервера ВкусВилла](https://github.com/vkustech/vkusvill-mcp-server-manifest): каталог, акции, рецепты, магазины и корзина, которую можно оформить на телефоне по QR-коду прямо из терминала.
-
-```bash
-npx vkusvill-cli            # после публикации в npm
-npx ./vv-cli                # из этой папки, уже сейчас
-npx vkusvill-cli сырники    # открыть сразу с поиском
-```
-
-Нужен Node 18.17+ и терминал от 64×18. Лучше всего выглядит с 24-битным цветом: iTerm2, WezTerm, Ghostty, kitty, терминал VS Code. В Terminal.app цветов 256.
-
-## Что внутри
-
-- **Каталог.** Поиск по мере набора, категории из ответа ВкусВилла, подсказки и недавние запросы. Пустой запрос показывает товары дня со скидкой. Справа карточка: фото полублоками, цена цифрами почтового индекса, рейтинг, КБЖУ и доли энергии, флаги состава и сам состав с подсветкой сахара, добавок, глютена и лактозы.
-- **Сортировка и фильтры.** Сортировки ВкусВилла плюс свои по загруженному: цена за кг, белок на рубль, калории, скидка. Фильтры: без сахара, глютена, лактозы, добавок или пальмового масла, только со скидкой, рейтинг от 4,8, белок от 10 г, до 150 ккал. Если фильтры отсеяли почти всё, страницы догружаются сами.
-- **Карточка товара.** Галерея фото, «бублик» энергии БЖУ точками Брайля, описание, все свойства (срок годности, хранение, производитель, аллергены). `[` и `]` листают соседние товары, `a` показывает аналоги.
-- **Сравнение.** До четырёх товаров бок о бок, лучшее значение в каждой строке помечено.
-- **Акции.** Скидки по карте и «от N штук», только ВкусВилл или все бренды.
-- **Рецепты.** Поиск и фильтры ВкусВилла: исключить аллергены, время, сложность, способ готовки. На странице рецепта шаги и чек-лист ингредиентов; `+` кладёт все отмеченные ингредиенты в корзину.
-- **Магазины.** Регион, город, метро, особенности. Списки городов и метро сужаются по выбранному региону. Поиск по адресу клавишей `/`, сводка «открыто сейчас», часы работы превращаются в «открыт до 23:00» или «закрыт», склады «только для курьеров» помечены отдельно. Карта нарисована точками Брайля поверх контура МКАД и Садового кольца; `z` приближает к выбранному магазину, `L` загружает на карту все магазины фильтра.
-- **Корзина.** Количество меняется стрелками; итог крупными цифрами, экономия по акциям, КБЖУ всей корзины и доли по категориям. Цены старше шести часов сверяются сами. Оформление создаёт ссылку ВкусВилла и показывает QR-код: наведите камеру телефона, и корзина откроется в приложении ВкусВилла. Оплата и доставка остаются на стороне ВкусВилла.
-- **Профиль.** Избранное и история хранятся локально. Заказы, любимый продукт и «6 скидок» ВкусВилл отдаёт только после входа; если у вас есть токен, передайте его через `VV_TOKEN`.
-- **Везде.** Мышь (клик, двойной клик, колесо), палитра команд по `Ctrl+K`, поиск по штрихкоду (`b`), справка (`?`). Горячие клавиши работают и в русской раскладке. Последняя вкладка, сортировки и фильтры запоминаются между запусками.
-
-## Клавиши
-
-| Клавиша | Действие |
-|---|---|
-| `1`…`6`, `Tab` | вкладки |
-| `/` | поиск |
-| `↑↓`, `j k` | выбор |
-| `⏎` | открыть |
-| `+ −` | в корзину / убрать |
-| `*` | избранное |
-| `s`, `f`, `g` | сортировка, фильтры, категория |
-| `x`, `X` | отметить для сравнения, сравнить |
-| `o` | открыть на сайте; в корзине — оформить |
-| `Ctrl+K` | палитра команд |
-| `?` | все клавиши |
-| `esc` | назад |
-| `q` | выход |
-
-## Команды для скриптов
-
-```bash
-vv search творог --sort price_asc   # таблица; --json — ответ ВкусВилла
-vv deals --quantity
-vv product 27695
-vv barcode 4607167640050
-vv recipes тыква
-vv shops Речной вокзал
-vv cart add 27695 2
-vv cart link                        # ссылка и QR-код прямо в выводе
-```
-
-## Как это устроено
-
-- `src/term` — свой движок терминала без зависимостей: буфер ячеек, в терминал уходят только изменения, синхронный вывод без мерцания, truecolor с откатом на 256 цветов, мышь SGR, вставка из буфера обмена, широкие символы.
-- `src/api.js` — JSON-RPC к `https://mcp.vkusvill.ru/mcp`. Дисковый кэш (каталог 6 ч, акции 1 ч, магазины неделя, фото месяц), очередь с приоритетами: интерактивные запросы идут раньше фоновых, не больше 55 запросов в минуту, повтор при 429.
-- `src/image.js` — фото в WebP декодируются внутри Node через wasm (`@jsquash/webp`), без системных библиотек. Однотонные поля обрезаются, картинка усредняется под сетку ячеек.
-- Крупные цены рисуются ячейками, залитыми фоном, а не символами, поэтому не рвутся при любом межстрочном интервале.
-- QR рисует `qrcode-generator`; `test/qr-check.mjs` распознаёт код, восстановленный из ячеек экрана.
-
-## Приватность и безопасность
-
-- **С компьютера уходят только запросы к ВкусВиллу.** Никакой аналитики и сторонних серверов.
-- **Текст из сети очищается**, прежде чем попасть на экран или в вывод команд: управляющие символы терминала (ESC, C1-коды вроде `\x9b`) и символы смены направления текста удаляются, так что название товара не может управлять терминалом или выдавать себя за другое.
-- **Ссылки открываются только на `https://`-адреса ВкусВилла и Яндекса**, без оболочки (на Windows — через `rundll32`, а не `cmd`). Фото грузятся только с адресов ВкусВилла и с ограничением размера.
-- **Токен уходит только на `mcp.vkusvill.ru`**, даже если `VV_ENDPOINT` указывает в другое место. Заказы, персональные скидки и персонализированная выдача на диск не пишутся.
-- **Состояние** хранится в `~/.config/vv-cli/state.json`, доступном только вам (0600). Запись атомарная; повреждённый файл сохраняется как `state.json.broken-<время>`, а не затирается; второй запущенный экземпляр или `vv cart add` обновляют открытое приложение, а не перезаписывают его корзину.
-- **Кэш** лежит в `~/Library/Caches/vv-cli` или `~/.cache/vv-cli`, устаревает сам и не превышает 300 МБ. Падения записываются в `vv-cli.log` рядом с ним.
-
-Флаги состава («сахар», «добавки ×3» и т. п.) — эвристика по составу первого производителя, а не медицинская оценка. Часы работы магазинов сравниваются с московским временем.
-
-## Разработка
-
-```bash
-npm install
-node bin/vv.js --no-splash
-npm test                      # проверки без сети: безопасность вывода, ссылки, файл состояния, команды
-node test/snap.js 120 36      # сценарий без терминала → test/out/*.html (xterm.js) и gallery.html
-```
-
-Окружение: `VV_TOKEN`, `VV_COLOR=256|truecolor`, `NO_COLOR`, `VV_NO_SPLASH`, `VV_CACHE_DIR`, `VV_CONFIG_DIR`, `VV_ENDPOINT`.
-
-Проект не связан с ВкусВиллом. Данные и товарные знаки принадлежат их владельцам.

package/bin/vv.js

@@ -1,12 +0,0 @@
-#!/usr/bin/env node
-// VkusVill in the terminal. With no arguments, opens the full-screen interface; with a command, prints plain output for scripts.
-
-import { main } from "../src/main.js";
-
-// `vv search … | head` closes the pipe early; that is not an error
-process.stdout.on("error", (e) => { if (e.code === "EPIPE") process.exit(0); throw e; });
-
-main(process.argv.slice(2)).catch((e) => {
-  console.error(e?.message ?? e);
-  process.exit(1);
-});

package/src/api.js

@@ -1,228 +0,0 @@
-// Client for the official VkusVill MCP server (https://mcp.vkusvill.ru/mcp): JSON-RPC tools/call,
-// a disk cache, a priority queue under the ~60 requests/minute limit and an optional OAuth token.
-
-import { createHash } from "node:crypto";
-import { mkdir, readFile, writeFile, stat, readdir, unlink, utimes } from "node:fs/promises";
-import { homedir } from "node:os";
-import path from "node:path";
-import { clean, cleanDeep } from "./safe.js";
-
-export const ENDPOINT = process.env.VV_ENDPOINT ?? "https://mcp.vkusvill.ru/mcp";
-export const TOKEN = process.env.VV_TOKEN || null;
-// The token is only ever sent to the official server, even when VV_ENDPOINT points elsewhere
-const OFFICIAL = (() => {
-  try { const u = new URL(ENDPOINT); return u.protocol === "https:" && u.hostname === "mcp.vkusvill.ru"; } catch { return false; }
-})();
-
-const MAX_RESPONSE = 20 * 1024 * 1024;
-const MEM_LIMIT = 400;
-const DAY = 24 * 3600e3;
-
-function cacheBase() {
-  if (process.env.XDG_CACHE_HOME) return process.env.XDG_CACHE_HOME;
-  if (process.platform === "darwin") return path.join(homedir(), "Library", "Caches");
-  if (process.platform === "win32" && process.env.LOCALAPPDATA) return process.env.LOCALAPPDATA;
-  return path.join(homedir(), ".cache");
-}
-export const CACHE_DIR = process.env.VV_CACHE_DIR ?? path.join(cacheBase(), "vv-cli");
-
-const TTL = { default: 6 * 3600e3, vkusvill_shops: 7 * DAY, vkusvill_recipes: DAY, vkusvill_products_discount: 3600e3 };
-// Personal data and one-off links never touch the disk
-const NO_CACHE = new Set(["vkusvill_cart_link_create", "vkusvill_orders_history", "vkusvill_product_lp", "vkusvill_discounts_personal"]);
-
-const mem = new Map();
-const inflight = new Map();
-export const stats = { requests: 0, cacheHits: 0, active: 0, queued: 0, lastError: null };
-
-// ——— Disk cache ———
-
-function keyFile(kind, key) {
-  return path.join(CACHE_DIR, kind, createHash("sha1").update(key).digest("hex").slice(0, 20) + ".json");
-}
-
-export async function diskGet(kind, key, ttl) {
-  try {
-    const f = keyFile(kind, key);
-    if (Date.now() - (await stat(f)).mtimeMs > ttl) return undefined;
-    return JSON.parse(await readFile(f, "utf8"));
-  } catch {
-    return undefined;
-  }
-}
-
-export async function diskPut(kind, key, value) {
-  try {
-    const f = keyFile(kind, key);
-    await mkdir(path.dirname(f), { recursive: true, mode: 0o700 });
-    await writeFile(f, JSON.stringify(value), { mode: 0o600 });
-  } catch {}
-}
-
-// Removes expired entries and keeps the cache under a size cap; runs at most once a day
-const PRUNE = { api: 8 * DAY, img: 31 * DAY };
-const CACHE_CAP = 300 * 1024 * 1024;
-export async function pruneCache() {
-  const marker = path.join(CACHE_DIR, ".pruned");
-  try { if (Date.now() - (await stat(marker)).mtimeMs < DAY) return; } catch {}
-  const files = [];
-  for (const [kind, maxAge] of Object.entries(PRUNE)) {
-    const dir = path.join(CACHE_DIR, kind);
-    let names = [];
-    try { names = await readdir(dir); } catch { continue; }
-    for (const name of names) {
-      const f = path.join(dir, name);
-      try {
-        const st = await stat(f);
-        if (Date.now() - st.mtimeMs > maxAge) await unlink(f);
-        else files.push({ f, size: st.size, t: st.mtimeMs });
-      } catch {}
-    }
-  }
-  let total = files.reduce((s, x) => s + x.size, 0);
-  for (const x of files.sort((a, b) => a.t - b.t)) {
-    if (total <= CACHE_CAP) break;
-    try { await unlink(x.f); total -= x.size; } catch {}
-  }
-  try {
-    await mkdir(CACHE_DIR, { recursive: true, mode: 0o700 });
-    await writeFile(marker, "", { mode: 0o600 });
-    await utimes(marker, new Date(), new Date());
-  } catch {}
-}
-
-// ——— Request queue ———
-// Interactive requests (hi) go before background ones (lo); at most 4 in flight
-// and at most 55 within any sliding minute.
-
-const queue = { hi: [], lo: [] };
-const sent = [];
-let running = 0;
-let onChange = () => {};
-export function onActivity(fn) { onChange = fn; }
-
-function pump() {
-  stats.queued = queue.hi.length + queue.lo.length;
-  while (running < 4 && (queue.hi.length || queue.lo.length)) {
-    const now = Date.now();
-    while (sent.length && now - sent[0] > 60e3) sent.shift();
-    if (sent.length >= 55) { setTimeout(pump, 60e3 - (now - sent[0]) + 50); return; }
-    const job = queue.hi.shift() ?? queue.lo.shift();
-    sent.push(now);
-    running++;
-    stats.active = running;
-    onChange();
-    job().finally(() => { running--; stats.active = running; onChange(); pump(); });
-  }
-  stats.queued = queue.hi.length + queue.lo.length;
-}
-
-function enqueue(fn, prio) {
-  return new Promise((resolve, reject) => {
-    queue[prio === "lo" ? "lo" : "hi"].push(() => fn().then(resolve, reject));
-    pump();
-  });
-}
-
-// ——— Calls ———
-
-export class VVError extends Error {
-  constructor(message, code) { super(message); this.code = code; }
-}
-
-function parseJSON(text, what) {
-  try { return JSON.parse(text); } catch { throw new VVError(`ВкусВилл прислал некорректный ${what}`, "rpc"); }
-}
-
-async function post(body) {
-  const headers = { "Content-Type": "application/json", Accept: "application/json, text/event-stream" };
-  if (TOKEN && OFFICIAL) headers.Authorization = `Bearer ${TOKEN}`;
-  try {
-    return await fetch(ENDPOINT, { method: "POST", headers, body, signal: AbortSignal.timeout(20e3) });
-  } catch (e) {
-    if (e?.name === "TimeoutError") throw new VVError("ВкусВилл не ответил за 20 секунд", "net");
-    throw new VVError("Нет связи с ВкусВиллом", "net");
-  }
-}
-
-async function rawCall(tool, args) {
-  const body = JSON.stringify({ jsonrpc: "2.0", id: Date.now(), method: "tools/call", params: { name: tool, arguments: args } });
-  for (let attempt = 0; ; attempt++) {
-    stats.requests++;
-    const res = await post(body);
-    if (res.status === 429 && attempt < 3) { await new Promise((r) => setTimeout(r, 2000 * (attempt + 1))); continue; }
-    if (res.status === 401) throw new VVError(TOKEN && !OFFICIAL ? "Токен отправляется только на mcp.vkusvill.ru" : "Нужен вход во ВкусВилл (VV_TOKEN)", "auth");
-    if (!res.ok) throw new VVError(`ВкусВилл ответил ${res.status}`, "http");
-    if (+(res.headers.get("content-length") ?? 0) > MAX_RESPONSE) throw new VVError("Слишком большой ответ", "http");
-    let text = await res.text();
-    if (text.length > MAX_RESPONSE) throw new VVError("Слишком большой ответ", "http");
-    // The server may answer with an SSE stream: take the last data event
-    if (text.startsWith("event:") || text.startsWith("data:")) {
-      const datas = text.split("\n").filter((l) => l.startsWith("data:"));
-      text = datas.at(-1)?.slice(5) ?? "{}";
-    }
-    const env = parseJSON(text, "ответ");
-    if (env.error) throw new VVError(clean(env.error.message).slice(0, 200), "rpc");
-    const content = env.result?.content?.[0]?.text ?? "{}";
-    const payload = parseJSON(content, "ответ инструмента");
-    if (env.result?.isError || payload.ok === false) {
-      const msg = clean(payload.error?.message ?? content).slice(0, 200);
-      throw new VVError(msg, /auth|token|jwt|unauthor/i.test(msg) ? "auth" : payload.error?.code ?? "rpc");
-    }
-    // Everything downstream — the UI, command output, the cache — gets strings with control characters removed
-    return cleanDeep(payload.data ?? payload);
-  }
-}
-
-// LRU in memory: old responses are evicted
-function remember(key, value) {
-  mem.delete(key);
-  mem.set(key, value);
-  while (mem.size > MEM_LIMIT) mem.delete(mem.keys().next().value);
-}
-
-export async function call(tool, args = {}, { prio = "hi", fresh = false } = {}) {
-  const key = JSON.stringify([tool, args]);
-  const cacheable = !NO_CACHE.has(tool);
-  if (cacheable && !fresh && mem.has(key)) { stats.cacheHits++; const v = mem.get(key); remember(key, v); return v; }
-  if (inflight.has(key)) return inflight.get(key);
-  const p = (async () => {
-    const ttl = TTL[tool] ?? TTL.default;
-    if (cacheable && !fresh) {
-      const hit = await diskGet("api", key, ttl);
-      if (hit !== undefined) { stats.cacheHits++; remember(key, hit); return hit; }
-    }
-    const data = await enqueue(() => rawCall(tool, args), prio);
-    if (cacheable) {
-      remember(key, data);
-      // Results personalised for a signed-in user stay in memory only
-      if (!data?.meta?.personalized) diskPut("api", key, data);
-    }
-    return data;
-  })();
-  inflight.set(key, p);
-  p.then(() => { stats.lastError = null; }, (e) => { stats.lastError = e.message; }).finally(() => inflight.delete(key));
-  return p;
-}
-
-// ——— Tool wrappers ———
-
-export const search = (q, { page = 1, sort = "popularity", category = 0, vvonly = 1 } = {}, o) =>
-  call("vkusvill_products_search", { q, page, limit: 10, sort, category_id: category, vvonly, mode: "full" }, o);
-
-export const details = (id, o) => call("vkusvill_product_details", { id: +id }, o);
-export const barcode = (code) => call("vkusvill_product_barcode", { barcode: code });
-export const analogs = (id) => call("vkusvill_product_analogs", { id: +id });
-export const discounts = ({ type = "card", page = 1, sort = "popularity", vvonly = 1 } = {}, o) =>
-  call("vkusvill_products_discount", { type, page, sort, vvonly }, o);
-export const cartLink = (products) => call("vkusvill_cart_link_create", { products });
-export const shops = ({ page = 1, region = 0, city = 0, subway = 0, feature = 0 } = {}, o) =>
-  call("vkusvill_shops", { page, id_region_filter: region, id_city_filter: city, id_subway_filter: subway, id_feature_filter: feature }, o);
-export const recipes = ({ q = "", page = 1, sort = "popularity", feature = 0, time = 0, method = 0, complexity = 0, category = 0, allergens = [] } = {}, o) =>
-  call("vkusvill_recipes", {
-    q, page, sort,
-    id_feature_filter: feature, id_cooking_time_filter: time, id_cooking_method_filter: method,
-    id_complexity_filter: complexity, id_category_filter: category, id_exclude_allergens_filter: allergens,
-  }, o);
-export const orders = (page = 1) => call("vkusvill_orders_history", { page });
-export const favoriteProduct = () => call("vkusvill_product_lp", {});
-export const personalDiscounts = () => call("vkusvill_discounts_personal", {});