yandex-direct-mcp-plus 1.6.0 → 1.7.0

package/README.md

@@ -6,9 +6,9 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Node](https://img.shields.io/badge/node-%3E%3D22-green.svg)](https://nodejs.org)
 
-- **60 инструментов**, из них 25 только читают. Кампании и стратегии, группы, объявления и модерация, ключевые фразы и ставки, минус-фразы и общие наборы, быстрые ссылки, уточнения, изображения, визитки, корректировки ставок, ретаргетинг, аудиторные и динамические цели, фиды, расписание показов, статистика, поисковые запросы, баланс и справочники.
+- **59 инструментов**, из них 25 только читают. Кампании и стратегии, группы, объявления и модерация, ключевые фразы и ставки, минус-фразы и общие наборы, быстрые ссылки, уточнения, изображения, визитки, корректировки ставок, ретаргетинг, аудиторные и динамические цели, фиды, расписание показов, статистика, поисковые запросы, баланс и справочники.
 - **Деньги — в рублях**, на вводе и на выводе; в микроединицы API сервер переводит сам. Поддержан агентский режим (`Client-Login`).
-- **ID — строками** (`"1915016273214320641"`): 64-битные идентификаторы Директа не помещаются в число JavaScript и молча теряют точность. Здесь это стережёт правило линтера, а не внимательность.
+- **ID — строками** (`"1915016273214320641"`): 64-битные идентификаторы Директа не помещаются в число JavaScript и молча теряют точность.
 - **Реклама боевая.** Тестовой среды у Директа больше нет — какие инструменты тратят деньги и что удаляют необратимо, перечислено в разделе [Что меняет данные](#что-меняет-данные).
 - **Телеметрии нет.** Сервер не отправляет никуда ничего, кроме запросов к API Яндекса.
 
@@ -18,7 +18,7 @@
 - [Установка](#установка) — Claude Code, Claude Desktop, Cursor, из исходников
 - [Токен](#токен) — как получить и какие переменные окружения нужны
 - [Что меняет данные](#что-меняет-данные) — что тратит бюджет и что необратимо
-- [Инструменты](#инструменты-60) — полный список с описаниями
+- [Инструменты](#инструменты) — полный список с описаниями
 - [Разработка](#разработка) — сборка, тесты, архитектура
 
 ## Что можно делать
@@ -35,7 +35,7 @@
 Найди код региона для Новосибирска
 ```
 
-Полный список — [60 инструментов](#инструменты-60) ниже.
+Полный список — в разделе [Инструменты](#инструменты).
 
 ## Установка
 
@@ -81,17 +81,18 @@ OAuth-токен выпускается для приложения, зарег
 |------------|:-----------:|------------|
 | `YANDEX_DIRECT_TOKEN` | да | OAuth-токен Яндекс.Директ |
 | `YANDEX_DIRECT_LOGIN` | нет | Логин клиента для агентских токенов (заголовок `Client-Login`). Обязателен, если токен агентский |
-| `YANDEX_DIRECT_POLYGON_CAMPAIGN_ID` | нет | Только для `npm run test:int`: ID кампании-полигона, оставленной черновиком. Сетевые тесты пишут в неё и ни во что другое; без переменной они пропускаются |
 
 ## Что меняет данные
 
 Тестовой среды у Яндекс.Директа больше нет: песочница отключена с июля 2026, и любой вызов идёт по боевому аккаунту. Отлаживать сценарии приходится на отдельной кампании, оставленной черновиком, — показов она не даёт и потому не тратит бюджет, пока не пройдёт модерацию и не будет включена.
 
+У каждого пишущего инструмента есть параметр `dry_run`. С `dry_run: true` вызов проверяет параметры схемой, выполняет нужные ему чтения и возвращает тела запросов, которые ушли бы в Директ, ничего не отправляя.
+
 Граница проходит не по «чтение или запись», а по скорости, с которой действие превращается в деньги.
 
-**25 инструментов только читают** — все `list_*`, `get_*` и справочники. Вызвать их безопасно всегда.
+**Только читают** все `list_*`, `get_*` и справочники. Вызвать их безопасно всегда.
 
-**Тратят бюджет или запускают показы** — восемь:
+**Тратят бюджет или запускают показы:**
 
 | Инструмент | Чем именно |
 |------------|------------|
@@ -112,7 +113,9 @@ OAuth-токен выпускается для приложения, зарег
 
 Остальные инструменты создают и правят объекты. Пока кампания не прошла модерацию и не включена, показов по ней нет и бюджет не расходуется.
 
-## Инструменты (60)
+**Чего API не умеет.** Смарт-баннеры и динамические объявления Директ через API не создаёт с 22 мая 2026, визитки — тоже: в WSDL методы есть, боевой API отвечает ошибкой 3500. Такие объекты заводятся в интерфейсе Директа, а дальше сервер с ними работает: кампании читает и правит, визитки читает и удаляет. Единую перфоманс-кампанию сервер пока только читает.
+
+## Инструменты
 
 **Кампании**
 
@@ -120,7 +123,7 @@ OAuth-токен выпускается для приложения, зарег
 |------------|----------|
 | `list_campaigns` | Список кампаний (фильтр по статусу/типу, пагинация) |
 | `get_campaign` | Детальная информация о кампании по ID |
-| `create_campaign` | Создать кампанию (бюджет в рублях, выбор стратегии, часовой пояс, UTM-разметка) |
+| `create_campaign` | Создать текстово-графическую кампанию (бюджет в рублях, выбор стратегии, часовой пояс, UTM-разметка) |
 | `update_campaign` | Обновить название/бюджет/UTM-разметку и/или статус (SUSPEND/RESUME/ARCHIVE/UNARCHIVE) |
 | `manage_campaigns` | suspend/resume/archive/unarchive/delete для списка кампаний |
 | `get_strategy` | Получить стратегию текстово-графической кампании |
@@ -202,7 +205,6 @@ OAuth-токен выпускается для приложения, зарег
 | `get_search_queries` | Фактические поисковые запросы для подбора минус-фраз |
 | `get_changes` | Проверить изменения кампаний, групп, объявлений и справочников |
 | `list_vcards` | Получить виртуальные визитки |
-| `add_vcard` | Создать виртуальную визитку |
 | `delete_vcards` | Удалить визитки по ID |
 | `list_businesses` | Получить профили организаций Яндекс Бизнеса |
 | `get_account_balance` | Баланс аккаунта (Live API v4) |
@@ -221,6 +223,8 @@ npm run typecheck  # tsc --noEmit
 npm run lint:dead  # knip
 ```
 
+Сетевые тесты (`npm run test:int`) идут по боевому аккаунту и пишут только в кампанию-полигон, оставленную черновиком: её ID задаётся переменной `YANDEX_DIRECT_POLYGON_CAMPAIGN_ID`. Без переменной они пропускаются.
+
 Код разложен по слоям `app → tools → shared`; инструмент — это каталог
 `src/tools/<домен>/` с `schema.ts`, `handler.ts` и `tool.ts`. Подробности —
 в [docs/architecture.md](docs/architecture.md).
@@ -229,7 +233,7 @@ npm run lint:dead  # knip
 
 Проект начат на коде [`theYahia/yandex-direct-mcp`](https://github.com/theYahia/yandex-direct-mcp) под лицензией MIT. Расширение с 20 до 48 инструментов и перевод ID на строки — работа [**Maxim (DrSeedon)**](https://github.com/DrSeedon), [PR #7](https://github.com/theYahia/yandex-direct-mcp/pull/7); в npm эта версия не публиковалась. Дальше проект развивается самостоятельно и апстрим не отслеживает.
 
-История до отделения от апстрима (версии 3.0.0–5.0.0, включая вклад DrSeedon) — в [docs/CHANGELOG-upstream.md](docs/CHANGELOG-upstream.md); дальнейшие изменения — в [CHANGELOG.md](CHANGELOG.md). План — в [docs/roadmap.md](docs/roadmap.md), архитектура — в [docs/architecture.md](docs/architecture.md).
+История до отделения от апстрима (версии 3.0.0–5.0.0, включая вклад DrSeedon) — в [docs/CHANGELOG-upstream.md](docs/CHANGELOG-upstream.md); дальнейшие изменения — в [CHANGELOG.md](CHANGELOG.md).
 
 ## Лицензия
 

package/dist/app/dry-run.d.ts

@@ -0,0 +1,2 @@
+import type { ToolDescriptor } from "#shared/lib/tool";
+export declare function withDryRun(tool: ToolDescriptor): ToolDescriptor;

package/dist/app/dry-run.js

@@ -0,0 +1,46 @@
+// Middleware предпросмотра: пишущий инструмент получает флаг dry_run и при нём отдаёт тела
+// запросов вместо их отправки. Чтение при этом настоящее — запись строится по живым данным.
+import { z } from "zod";
+import { runDryRun } from "#shared/api/dry-run";
+import { stringifyJson } from "#shared/api/json";
+import { PREVIEW_STRING_MAX } from "#shared/config/limits";
+import { isRecord } from "#shared/lib/record";
+const dryRunField = z.boolean().optional().meta({
+    description: "true — ничего не менять: проверить параметры и вернуть тела запросов, которые ушли бы в Директ. Чтение при этом выполняется."
+});
+function shortenStrings(value) {
+    if (typeof value === "string" && value.length > PREVIEW_STRING_MAX) {
+        return `${value.slice(0, PREVIEW_STRING_MAX)}… (обрезано, всего ${value.length} символов)`;
+    }
+    if (Array.isArray(value))
+        return value.map(shortenStrings);
+    if (isRecord(value)) {
+        return Object.fromEntries(Object.entries(value).map(([key, nested]) => [key, shortenStrings(nested)]));
+    }
+    return value;
+}
+function formatPreview(requests) {
+    const bodies = requests.map(({ service, method, params }, index) => `${index + 1}. ${service}.${method}\n${stringifyJson({ method, params: shortenStrings(params) }, 2)}`);
+    return [
+        "🔍 Предпросмотр (dry_run): в Директ ничего не отправлено.",
+        "Тела запросов — в формате API: суммы в микроединицах (рубли × 1 000 000).",
+        ...bodies
+    ].join("\n\n");
+}
+export function withDryRun(tool) {
+    if (tool.annotations.readOnlyHint)
+        return tool;
+    return {
+        ...tool,
+        schema: tool.schema.extend({ dry_run: dryRunField }),
+        run: async (params) => {
+            const { dry_run: dryRun, ...toolParams } = params;
+            if (!dryRun)
+                return tool.run(toolParams);
+            const { output, requests } = await runDryRun(() => tool.run(toolParams));
+            if (requests.length > 0)
+                return formatPreview(requests);
+            return `🔍 Предпросмотр (dry_run): запись не понадобилась, вызов только читал.\n\n${output}`;
+        }
+    };
+}

package/dist/app/instructions.d.ts

@@ -0,0 +1 @@
+export declare const SERVER_INSTRUCTIONS: string;

package/dist/app/instructions.js

@@ -0,0 +1,10 @@
+// Текст, который клиент кладёт в контекст агента при подключении, до первого вызова.
+// Здесь только то, что касается нескольких инструментов сразу; частное — в их описаниях.
+export const SERVER_INSTRUCTIONS = [
+    "Сервер работает с API Яндекс.Директа v5 в боевом аккаунте: тестовой среды у Директа нет с июля 2026, любой пишущий вызов меняет настоящие кампании.",
+    "У каждого пишущего инструмента есть dry_run: с ним вызов проверяет параметры и показывает тела запросов, ничего не меняя. Перед рискованной правкой — сначала предпросмотр.",
+    "Деньги на входе и выходе — в рублях. ID — десятичные строки: 19-значные ID Директа не помещаются в число без потери точности.",
+    "Чего Директ через API не делает, хотя в WSDL методы объявлены (ошибка 3500): не создаёт смарт-баннеры и динамические объявления (с 22.05.2026) и визитки. Такие объекты заводятся в интерфейсе Директа; дальше сервер их читает, кампании — правит.",
+    "Единую перфоманс-кампанию сервер пока только читает: создать её можно в интерфейсе Директа.",
+    "Отказ по отдельному объекту приходит строкой ❌, и вызов помечается ошибкой, но остальные объекты пакета при этом обработаны: повторять только то, что не прошло. У частых кодов ошибок в тексте есть подсказка «Что делать» — ей следовать, а не повторять вызов вслепую."
+].join("\n");

package/dist/app/registry.js

@@ -1,3 +1,6 @@
+// Реестр инструментов: единственный список, который знает про все домены сразу.
+// Импорты явные, не глоб: glob прячет инструмент от knip и ломает типизацию списка.
+import { withDryRun } from "#app/dry-run";
 import { getAccountBalanceTool } from "#tools/account/tool";
 import { addAdExtensionsTool, deleteAdExtensionsTool, listAdExtensionsTool } from "#tools/ad-extensions/tool";
 import { createAdGroupTool, deleteAdGroupsTool, listAdGroupsTool } from "#tools/ad-groups/tool";
@@ -18,7 +21,7 @@ import { getSearchQueriesTool } from "#tools/search-queries/tool";
 import { deleteSitelinksTool, listSitelinksTool, setSitelinksTool } from "#tools/sitelinks/tool";
 import { getStatisticsTool } from "#tools/statistics/tool";
 import { getTimeTargetingTool, setTimeTargetingTool } from "#tools/time-targeting/tool";
-import { addVcardTool, deleteVcardsTool, listVcardsTool } from "#tools/vcards/tool";
+import { deleteVcardsTool, listVcardsTool } from "#tools/vcards/tool";
 export const tools = [
     // Кампании и стратегии
     listCampaignsTool,
@@ -64,7 +67,6 @@ export const tools = [
     deleteAdExtensionsTool,
     manageAdImagesTool,
     listVcardsTool,
-    addVcardTool,
     deleteVcardsTool,
     // Таргетинг и корректировки
     listAudienceTargetsTool,
@@ -89,4 +91,4 @@ export const tools = [
     listFeedsTool,
     getRegionsTool,
     listTimeZonesTool
-];
+].map(withDryRun);

package/dist/app/server.js

@@ -3,6 +3,8 @@ import { readFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { SERVER_INSTRUCTIONS } from "#app/instructions";
+import { hasItemErrors } from "#shared/lib/format";
 const packageRoot = join(dirname(fileURLToPath(import.meta.url)), "..", "..");
 export function readVersion() {
     try {
@@ -14,17 +16,22 @@ export function readVersion() {
         return "0.0.0";
     }
 }
+// Отказ всего запроса хендлер бросает, и isError ставит SDK. Частичный отказ приходит
+// обычным текстом — без признака клиент принял бы его за успех.
+const toCallResult = (text) => ({
+    content: [{ type: "text", text }],
+    isError: hasItemErrors(text)
+});
 export function createServer(tools) {
-    const server = new McpServer({ name: "yd-mcp", version: readVersion() });
+    const server = new McpServer({ name: "yd-mcp", version: readVersion() }, { instructions: SERVER_INSTRUCTIONS });
     for (const tool of tools) {
         server.registerTool(tool.name, {
             title: tool.title,
             description: tool.description,
-            inputSchema: tool.schema.shape,
+            // Схема целиком, не .shape: из словаря полей SDK собрал бы новый объект без .refine.
+            inputSchema: tool.schema,
             annotations: tool.annotations
-        }, async (params) => ({
-            content: [{ type: "text", text: await tool.run(params) }]
-        }));
+        }, async (params) => toCallResult(await tool.run(params)));
     }
     return server;
 }

package/dist/shared/api/client.js

@@ -1,16 +1,20 @@
 // JSON API v5 — основной клиент: один POST на сервис с телом { method, params }.
+import { holdWrite } from "#shared/api/dry-run";
 import { assertNoApiError } from "#shared/api/errors";
 import { commonHeaders, fetchWithRetry, logUnits } from "#shared/api/fetch";
 import { parseJson, stringifyJson } from "#shared/api/json";
 import { BASE_URL } from "#shared/config/endpoints";
 export async function apiPost(service, method, params = {}) {
+    const held = holdWrite(service, method, params);
+    if (held)
+        return held;
     const response = await fetchWithRetry(`${BASE_URL}${service}`, {
         method: "POST",
         headers: commonHeaders(),
         body: stringifyJson({ method, params })
     });
-    logUnits(response);
+    const units = logUnits(response);
     const data = parseJson(await response.text());
-    assertNoApiError(data);
+    assertNoApiError(data, units);
     return data;
 }

package/dist/shared/api/dry-run.d.ts

@@ -0,0 +1,10 @@
+export type HeldRequest = {
+    service: string;
+    method: string;
+    params: Record<string, unknown>;
+};
+export declare function runDryRun<T>(action: () => Promise<T>): Promise<{
+    output: T;
+    requests: HeldRequest[];
+}>;
+export declare function holdWrite(service: string, method: string, params: Record<string, unknown>): unknown;

package/dist/shared/api/dry-run.js

@@ -0,0 +1,28 @@
+// Предпросмотр записи: внутри runDryRun пишущий запрос не уходит в Директ, а откладывается.
+// Контекст — AsyncLocalStorage, чтобы хендлеры не знали о режиме и не передавали флаг вниз.
+import { AsyncLocalStorage } from "node:async_hooks";
+// Всё, чего здесь нет, считается записью: незнакомый метод безопаснее придержать, чем отправить.
+const READ_METHODS = new Set([
+    "get",
+    "getGeoRegions",
+    "check",
+    "checkCampaigns",
+    "checkDictionaries",
+    "hasSearchVolume"
+]);
+// Ответ-заглушка вместо настоящего: хендлер доходит до конца и не спотыкается о пустоту.
+const HELD_RESPONSE = { result: {} };
+const heldRequests = new AsyncLocalStorage();
+export async function runDryRun(action) {
+    const requests = [];
+    const output = await heldRequests.run(requests, action);
+    return { output, requests };
+}
+// Ответ-заглушка, если запрос отложен; undefined — запрос надо отправить.
+export function holdWrite(service, method, params) {
+    const requests = heldRequests.getStore();
+    if (!requests || READ_METHODS.has(method))
+        return undefined;
+    requests.push({ service, method, params });
+    return HELD_RESPONSE;
+}

package/dist/shared/api/errors.d.ts

@@ -1,3 +1,3 @@
-export declare function assertNoApiError(data: unknown): void;
-export declare function assertNoApiErrorV4(data: Record<string, unknown> | null): void;
+export declare function assertNoApiError(data: unknown, units?: string): void;
+export declare function assertNoApiErrorV4(data: Record<string, unknown> | null, units?: string): void;
 export declare function assertNoReportAuthError(body: string): void;

package/dist/shared/api/errors.js

@@ -1,12 +1,8 @@
 // Разбор ошибок Директа. Хендлеры сюда не заглядывают: их дело — сценарий.
-// 53 — единственная ошибка, которую не чинит ни повтор, ни другой запрос: токен истёк,
-// отозван или указан неверно. Проба 06.09.2026: v5 отдаёт её телом с HTTP 200
-// («Ошибка авторизации» / «Недействительный OAuth-токен»), v4 — тем же кодом, но с пустым
-// error_detail, а Reports — HTTP 400 и XML, где код лежит в <reports:errorCode>.
+import { getErrorHint } from "#shared/lib/error-hints";
+// 53 — токен истёк, отозван или неверен. v5 отдаёт её с HTTP 200, v4 — с пустым
+// error_detail, Reports — HTTP 400 и XML. Текст заменяется целиком: из родного не понять, что делать.
 const AUTH_ERROR_CODE = 53;
-// Текст адресован модели на другом конце протокола, а не человеку в логе: без явного
-// «повтор не поможет» она уводит вызов в ретраи, и пользователь так и не узнает, что
-// нужно перевыпустить токен.
 const AUTH_ERROR_MESSAGE = [
     "Токен Яндекс.Директа не принят: истёк, отозван или задан неверно.",
     "Это не сбой сети и не временная ошибка — повторять вызов бесполезно.",
@@ -16,9 +12,17 @@ const AUTH_ERROR_MESSAGE = [
 function isAuthError(code) {
     return Number(code) === AUTH_ERROR_CODE;
 }
-// v5 возвращает ошибку уровня запроса телом с HTTP 200 — статус проверять бесполезно,
-// признак ошибки один: ключ `error`. Док: https://yandex.ru/dev/direct/doc/en/concepts/errors-list
-export function assertNoApiError(data) {
+function withAdvice(message, code, units) {
+    const parts = [message];
+    const hint = getErrorHint(code);
+    if (hint)
+        parts.push(`Что делать: ${hint}`);
+    if (units)
+        parts.push(`Баллы API (потрачено/остаток/лимит): ${units}.`);
+    return parts.join(" ");
+}
+// v5 возвращает ошибку запроса телом с HTTP 200 — признак только ключ `error`.
+export function assertNoApiError(data, units) {
     const error = data?.error;
     if (!error || typeof error !== "object")
         return;
@@ -29,22 +33,21 @@ export function assertNoApiError(data) {
         parts.push(`— ${error.error_detail}`);
     if (error.request_id)
         parts.push(`(request_id: ${error.request_id})`);
-    throw new Error(parts.join(" "));
+    throw new Error(withAdvice(parts.join(" "), error.error_code, units));
 }
 // v4 отвечает по-своему: error_str вместо error_string, признак — любой из двух ключей.
-export function assertNoApiErrorV4(data) {
+export function assertNoApiErrorV4(data, units) {
     if (!data || (data.error_code === undefined && data.error_str === undefined))
         return;
     if (isAuthError(data.error_code))
         throw new Error(AUTH_ERROR_MESSAGE);
     const detail = data.error_detail ? ` — ${data.error_detail}` : "";
-    throw new Error(`Ошибка API v4 [${data.error_code ?? "?"}]: ${data.error_str ?? "неизвестная ошибка"}${detail}`);
+    const message = `Ошибка API v4 [${data.error_code ?? "?"}]: ${data.error_str ?? "неизвестная ошибка"}${detail}`;
+    throw new Error(withAdvice(message, data.error_code, units));
 }
 const REPORT_ERROR_CODE = /<reports:errorCode>(\d+)<\/reports:errorCode>/;
-// Reports — единственный сервис, отвечающий настоящим HTTP-кодом и XML, поэтому его
-// ошибка не доходит ни до assertNoApiError, ни до схемы: транспорт бросает раньше.
-// Вызывается из fetchWithRetry — там тело неуспешного ответа и оказывается. Код тянем
-// регуляркой: разбирать XML ради одного числа — лишняя зависимость.
+// Reports отвечает HTTP-кодом и XML, поэтому проверка живёт в транспорте. Регулярка вместо
+// разбора XML — ради одного числа.
 export function assertNoReportAuthError(body) {
     const code = REPORT_ERROR_CODE.exec(body)?.[1];
     if (code && isAuthError(code))

package/dist/shared/api/fetch.d.ts

@@ -1,5 +1,5 @@
 export declare function commonHeaders(): Record<string, string>;
-export declare function logUnits(response: Response): void;
+export declare function logUnits(response: Response): string | undefined;
 export type Transport = (url: string, options: RequestInit) => Promise<Response>;
 export declare function setTransport(next: Transport): void;
 export declare function fetchWithRetry(url: string, options?: RequestInit, retries?: number): Promise<Response>;

package/dist/shared/api/fetch.js

@@ -13,19 +13,17 @@ export function commonHeaders() {
         headers["Client-Login"] = clientLogin;
     return headers;
 }
-// Units = «израсходовано/остаток/суточный лимит» баллов API. В stdout писать нельзя —
-// там транспорт MCP, поэтому stderr.
+// Units — «потрачено/остаток/лимит». В stderr: stdout занят транспортом MCP.
 export function logUnits(response) {
-    const units = response.headers?.get?.("Units");
+    const units = response.headers?.get?.("Units") ?? undefined;
     if (units)
         console.error(`[yd-mcp] Баллы API (потрачено/остаток/лимит): ${units}`);
+    return units;
 }
 function delay(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
-// Шов для тестов. Раньше они подменяли globalThis.fetch — глобал один на процесс, и
-// подмена задевала всё, что в нём живёт, включая SDK. Здесь шов свой, объявлен типом
-// и виден в коде; сеть трогает единственная строка ниже.
+// Шов для тестов: подмена глобального fetch задела бы и SDK.
 let transport = (url, options) => fetch(url, options);
 export function setTransport(next) {
     transport = next;

package/dist/shared/api/json.d.ts

@@ -1,2 +1,2 @@
 export declare function parseJson(text: string): unknown;
-export declare function stringifyJson(value: unknown): string;
+export declare function stringifyJson(value: unknown, indent?: number): string;

package/dist/shared/api/json.js

@@ -1,13 +1,11 @@
 // biome-ignore-all lint/plugin: единственное место в проекте, где вызывается разбор JSON
-// ID Директа — 64-битные целые, в живых аккаунтах 19-значные. Родной JSON.parse молча
-// округляет их до 2^53−1, превращая ID в валидное число, указывающее на другой объект.
-// storeAsString отдаёт большие числа строками; сериализация принимает BigInt.
-// Разбор и сериализация JSON живут только здесь — держит GritQL-плагин Biome.
+// 19-значные ID родной JSON.parse молча округляет в чужой, но валидный ID; storeAsString
+// отдаёт их строками. Разбор JSON — только здесь, держит GritQL-плагин Biome.
 import JSONbigFactory from "json-bigint";
 const JSONbig = JSONbigFactory({ storeAsString: true });
 export function parseJson(text) {
     return JSONbig.parse(text);
 }
-export function stringifyJson(value) {
-    return JSONbig.stringify(value);
+export function stringifyJson(value, indent) {
+    return JSONbig.stringify(value, null, indent);
 }

package/dist/shared/api/parse.js

@@ -1,7 +1,5 @@
 import { prettifyError } from "zod";
-// Схемы ответов пишутся нестрогими (`z.looseObject`): Директ добавляет поля без
-// предупреждения, и строгая схема превратила бы такое добавление в отказ инструмента.
-// Обязательными объявляются только поля, на которые опирается сам инструмент.
+// Схемы ответов — нестрогие: новое поле Директа не должно ломать инструмент.
 export function parseApiResult(schema, value, what) {
     const parsed = schema.safeParse(value);
     if (parsed.success)

package/dist/shared/api/v4.js

@@ -11,8 +11,8 @@ export async function apiV4(method, param = {}) {
         headers: { "Content-Type": "application/json", "Accept-Language": "ru" },
         body: stringifyJson({ method, token: getToken(), param })
     });
-    logUnits(response);
+    const units = logUnits(response);
     const data = parseJson(await response.text());
-    assertNoApiErrorV4(data);
+    assertNoApiErrorV4(data, units);
     return data;
 }

package/dist/shared/config/endpoints.js

@@ -1,8 +1,5 @@
-// Эндпоинты Директа. Выбирать не из чего: песочница отключена Яндексом с июля 2026
-// (ответ поддержки 05.09.2026), контур один — боевой. Отсюда константы, а не функции.
+// Эндпоинты Директа. Контур один — боевой: песочница отключена Яндексом с июля 2026.
 export const BASE_URL = "https://api.direct.yandex.com/json/v5/";
 export const REPORT_URL = `${BASE_URL}reports`;
-// Баланс общего счёта есть только в Live API v4 (AccountManagement.Get). Финансы в v5
-// не отсутствуют вовсе — у кампании это поле Funds, у клиента Bonuses и
-// OverdraftSumAvailable, — но суммы на счёте среди них нет. Сверено с WSDL 05.09.2026.
+// Только ради баланса общего счёта: в v5 его нет, есть лишь Funds кампании и бонусы клиента.
 export const V4_URL = "https://api.direct.yandex.ru/live/v4/json/";

package/dist/shared/config/enums.d.ts

@@ -3,7 +3,7 @@ export declare const KEYWORD_ACTIONS: readonly ["suspend", "resume", "delete"];
 export declare const AD_ACTIONS: readonly ["suspend", "resume", "archive", "unarchive", "moderate", "delete"];
 export declare const CAMPAIGN_ACTIONS: readonly ["suspend", "resume", "archive", "unarchive", "delete"];
 export declare const CAMPAIGN_STATUS_ACTIONS: readonly ["SUSPEND", "RESUME", "ARCHIVE", "UNARCHIVE"];
-export declare const CAMPAIGN_TYPES_CREATABLE: readonly ["TEXT_CAMPAIGN", "DYNAMIC_TEXT_CAMPAIGN"];
+export declare const CAMPAIGN_TYPES_CREATABLE: readonly ["TEXT_CAMPAIGN"];
 export declare const CAMPAIGN_TYPES: readonly ["TEXT_CAMPAIGN", "MOBILE_APP_CAMPAIGN", "DYNAMIC_TEXT_CAMPAIGN", "CPM_BANNER_CAMPAIGN", "SMART_CAMPAIGN", "UNIFIED_CAMPAIGN"];
 export declare const SEARCH_STRATEGIES: readonly ["HIGHEST_POSITION", "IMPRESSIONS_BELOW_SEARCH", "WB_MAXIMUM_CLICKS", "WB_MAXIMUM_CONVERSION_RATE", "WEEKLY_CLICK_PACKAGE", "AVERAGE_CPC", "AVERAGE_CPA", "AVERAGE_CPA_MULTIPLE_GOALS", "AVERAGE_ROI", "AVERAGE_CRR", "PAY_FOR_CONVERSION", "PAY_FOR_CONVERSION_CRR", "PAY_FOR_CONVERSION_MULTIPLE_GOALS", "MAX_PROFIT", "SERVING_OFF"];
 export declare const NETWORK_STRATEGIES: readonly ["NETWORK_DEFAULT", "MAXIMUM_COVERAGE", "WB_MAXIMUM_CLICKS", "WB_MAXIMUM_CONVERSION_RATE", "WEEKLY_CLICK_PACKAGE", "AVERAGE_CPC", "AVERAGE_CPA", "AVERAGE_CPA_MULTIPLE_GOALS", "AVERAGE_ROI", "AVERAGE_CRR", "PAY_FOR_CONVERSION", "PAY_FOR_CONVERSION_CRR", "PAY_FOR_CONVERSION_MULTIPLE_GOALS", "MAX_PROFIT", "SERVING_OFF"];