@oneentry/mcp-platform-server 0.1.1 → 0.1.3

package/dist/knowledge/loader.d.ts

@@ -1,10 +1,8 @@
 import { type KnowledgeFile } from './github.js';
 import type { KnowledgeOrigin, KnowledgePack } from './types.js';
-/** Настройки источника знаний, как их отдаёт конфигурация. */
 export interface KnowledgeConfig {
     repo: string;
     ref: string;
-    /** Локальный клон репозитория знаний: приоритетнее сети. */
     path?: string;
     cacheDir: string;
     refreshTtlMs: number;
@@ -12,22 +10,9 @@ export interface KnowledgeConfig {
     token?: string;
     timeoutMs: number;
 }
-/** Каталог с вшитым минимумом знаний (`operating-rules.md`). */
 export declare const seedDir: () => string;
-/** Каталог со сгенерированными данными пакета (`permissions.json`). */
 export declare const dataDir: () => string;
-/**
- * docId из пути внутри `knowledge/`.
- * `<имя>/index.md` даёт docId `<имя>`: это позволяет разрезать большой документ
- * на каталог из мелких файлов, не меняя идентификатор, на который уже ссылаются
- * `docLinks` каталога операций и золотые запросы тестов.
- */
 export declare const docIdFromPath: (path: string) => string;
-/**
- * Собирает пакет знаний из плоского списка файлов.
- * Один вход для всех трёх источников — сети, кэша и локального клона, — поэтому
- * поведение поиска не может разойтись между ними.
- */
 export declare const packFromFiles: (params: {
     files: readonly KnowledgeFile[];
     source: KnowledgeOrigin;
@@ -37,18 +22,5 @@ export declare const packFromFiles: (params: {
     sha?: string;
     warning?: string;
 }) => KnowledgePack;
-/**
- * Вшитый минимум: собственные правила эксплуатации пакета.
- * Существует только затем, чтобы сервер без сети всё равно мог ответить на вопрос
- * «как безопасно писать в эту CMS». Всё остальное живёт в репозитории знаний.
- */
 export declare const seedPack: (warning?: string) => KnowledgePack;
-/**
- * Выбирает источник знаний: локальный клон -> GitHub (через кэш) -> вшитый минимум.
- * Недоступный GitHub не мешает серверу подняться: пакет беднеет до вшитого минимума,
- * а причина уезжает в `warning`, потому что сеть — не ошибка конфигурации.
- * Единственное исключение бросается на нечитаемый локальный путь: его оператор указал
- * явно, и молчаливое падение до вшитых правил выглядело бы как пустой корпус.
- */
 export declare const resolveKnowledge: (config: KnowledgeConfig) => Promise<KnowledgePack>;
-//# sourceMappingURL=loader.d.ts.map

package/dist/knowledge/loader.js

@@ -4,22 +4,9 @@ import { fileURLToPath } from 'node:url';
 import { chunkDocument } from './chunk.js';
 import { fetchKnowledgeTree, readLocalTree } from './github.js';
 const messageOf = (error) => error instanceof Error ? error.message : String(error);
-/** Каталог с вшитым минимумом знаний (`operating-rules.md`). */
 export const seedDir = () => resolve(fileURLToPath(new URL('.', import.meta.url)), '../../knowledge');
-/** Каталог со сгенерированными данными пакета (`permissions.json`). */
 export const dataDir = () => resolve(fileURLToPath(new URL('.', import.meta.url)), '../../data');
-/**
- * docId из пути внутри `knowledge/`.
- * `<имя>/index.md` даёт docId `<имя>`: это позволяет разрезать большой документ
- * на каталог из мелких файлов, не меняя идентификатор, на который уже ссылаются
- * `docLinks` каталога операций и золотые запросы тестов.
- */
 export const docIdFromPath = (path) => path.replace(/\.md$/, '').replace(/\/index$/, '');
-/**
- * Собирает пакет знаний из плоского списка файлов.
- * Один вход для всех трёх источников — сети, кэша и локального клона, — поэтому
- * поведение поиска не может разойтись между ними.
- */
 export const packFromFiles = (params) => {
     const docs = [];
     const chunks = [];
@@ -46,11 +33,6 @@ export const packFromFiles = (params) => {
         chunks,
     };
 };
-/**
- * Вшитый минимум: собственные правила эксплуатации пакета.
- * Существует только затем, чтобы сервер без сети всё равно мог ответить на вопрос
- * «как безопасно писать в эту CMS». Всё остальное живёт в репозитории знаний.
- */
 export const seedPack = (warning) => packFromFiles({
     files: [
         {
@@ -62,13 +44,6 @@ export const seedPack = (warning) => packFromFiles({
     builtAt: new Date().toISOString(),
     ...(warning ? { warning } : {}),
 });
-/**
- * Выбирает источник знаний: локальный клон -> GitHub (через кэш) -> вшитый минимум.
- * Недоступный GitHub не мешает серверу подняться: пакет беднеет до вшитого минимума,
- * а причина уезжает в `warning`, потому что сеть — не ошибка конфигурации.
- * Единственное исключение бросается на нечитаемый локальный путь: его оператор указал
- * явно, и молчаливое падение до вшитых правил выглядело бы как пустой корпус.
- */
 export const resolveKnowledge = async (config) => {
     const builtAt = new Date().toISOString();
     if (config.path) {
@@ -109,4 +84,3 @@ export const resolveKnowledge = async (config) => {
             'Only the bundled operating rules are available — module reference docs will not be found.');
     }
 };
-//# sourceMappingURL=loader.js.map

package/dist/knowledge/search.d.ts

@@ -1,5 +1,4 @@
 import type { KnowledgeChunk, KnowledgeDoc, KnowledgePack } from './types.js';
-/** Найденный раздел с оценкой и вырезкой вокруг совпадения. */
 export interface KnowledgeHit {
     id: string;
     docId: string;
@@ -10,36 +9,15 @@ export interface KnowledgeHit {
     score: number;
     snippet: string;
 }
-/**
- * Выбрасывает из запроса слова короче трёх букв.
- * Заголовок весит вчетверо больше текста, поэтому раздел «Не входит в scope»
- * выигрывал у описания модуля на вопросе «почему атрибут не попал в индекс»:
- * два служебных слова совпадали с заголовком, а значащие — с телом. Предлоги и
- * частицы (`не`, `в`, `на`, `of`, `to`) не несут смысла ни в русском запросе,
- * ни в английском, и участвовать в ранжировании не должны.
- * Если после отбора не осталось ничего, запрос возвращается как есть —
- * поиск по одному короткому слову лучше поиска ни по чему.
- */
 export declare const meaningfulQuery: (query: string) => string;
-/**
- * Поисковый индекс по разделам документации.
- * Хранит только идентификаторы в индексе, а тексты — в отдельной карте:
- * так `cms_docs_search` отдаёт вырезки, не поднимая в память дубли корпуса.
- */
 export declare class KnowledgeIndex {
     private readonly mini;
     private readonly byId;
     private readonly byDocId;
     readonly pack: KnowledgePack;
     constructor(pack: KnowledgePack);
-    /** Разделы документа в порядке следования — для листания в cms_docs_read. */
     doc(docId: string): KnowledgeDoc | undefined;
     chunk(id: string): KnowledgeChunk | undefined;
     docs(): readonly KnowledgeDoc[];
-    /**
-     * Ищет разделы по запросу. Оценка minisearch домножается на веса источника и вида
-     * документа, поэтому правила эксплуатации всегда всплывают выше истории фиксов.
-     */
     search(query: string, limit?: number): KnowledgeHit[];
 }
-//# sourceMappingURL=search.d.ts.map

package/dist/knowledge/search.js

@@ -1,9 +1,4 @@
 import MiniSearch from 'minisearch';
-/**
- * Веса источников. `mcp` — собственные правила эксплуатации, они всегда должны
- * побеждать первичную документацию; `fixes` — история багов, полезна, но шумна,
- * поэтому опускается вниз, чтобы не вытеснять описание модуля.
- */
 const REPO_WEIGHT = { mcp: 1.6, back: 1, front: 0.9 };
 const KIND_WEIGHT = {
     docs: 1.15,
@@ -12,13 +7,6 @@ const KIND_WEIGHT = {
     fixes: 0.6,
     specs: 0.6,
 };
-/**
- * Вид документа. Обычно это второй сегмент docId (`back/docs/…` -> `docs`),
- * но каталог `specs` третьим сегментом разбирается отдельно: это датированные
- * описания задач и merge request'ов. По форме документация, по сути — та же история изменений,
- * что и `fixes`: длинная прозаическая, богатая случайными совпадениями и
- * вытесняющая описание модуля. Вес у них поэтому такой же.
- */
 const kindOf = (docId) => {
     const parts = docId.split('/');
     if (parts[2] === 'specs') {
@@ -27,21 +15,10 @@ const kindOf = (docId) => {
     return parts[1] ?? 'docs';
 };
 const SNIPPET_RADIUS = 180;
-/**
- * Выбрасывает из запроса слова короче трёх букв.
- * Заголовок весит вчетверо больше текста, поэтому раздел «Не входит в scope»
- * выигрывал у описания модуля на вопросе «почему атрибут не попал в индекс»:
- * два служебных слова совпадали с заголовком, а значащие — с телом. Предлоги и
- * частицы (`не`, `в`, `на`, `of`, `to`) не несут смысла ни в русском запросе,
- * ни в английском, и участвовать в ранжировании не должны.
- * Если после отбора не осталось ничего, запрос возвращается как есть —
- * поиск по одному короткому слову лучше поиска ни по чему.
- */
 export const meaningfulQuery = (query) => {
     const kept = query.split(/\s+/).filter((word) => word.replace(/[^\p{L}\p{N}]/gu, '').length > 2);
     return kept.length > 0 ? kept.join(' ') : query;
 };
-/** Вырезка вокруг первого совпавшего терма; при отсутствии — начало раздела. */
 const makeSnippet = (text, terms) => {
     const flat = text.replace(/\s+/g, ' ').trim();
     const lower = flat.toLowerCase();
@@ -59,11 +36,6 @@ const makeSnippet = (text, terms) => {
     const end = Math.min(flat.length, at + SNIPPET_RADIUS);
     return `${start > 0 ? '…' : ''}${flat.slice(start, end)}${end < flat.length ? '…' : ''}`;
 };
-/**
- * Поисковый индекс по разделам документации.
- * Хранит только идентификаторы в индексе, а тексты — в отдельной карте:
- * так `cms_docs_search` отдаёт вырезки, не поднимая в память дубли корпуса.
- */
 export class KnowledgeIndex {
     mini;
     byId;
@@ -86,7 +58,6 @@ export class KnowledgeIndex {
         });
         this.mini.addAll(pack.chunks);
     }
-    /** Разделы документа в порядке следования — для листания в cms_docs_read. */
     doc(docId) {
         return this.byDocId.get(docId);
     }
@@ -96,10 +67,6 @@ export class KnowledgeIndex {
     docs() {
         return this.pack.docs;
     }
-    /**
-     * Ищет разделы по запросу. Оценка minisearch домножается на веса источника и вида
-     * документа, поэтому правила эксплуатации всегда всплывают выше истории фиксов.
-     */
     search(query, limit = 8) {
         const terms = query.split(/\s+/).filter((t) => t.length > 1);
         const raw = this.mini.search(meaningfulQuery(query));
@@ -125,4 +92,3 @@ export class KnowledgeIndex {
         return hits.slice(0, limit);
     }
 }
-//# sourceMappingURL=search.js.map

package/dist/knowledge/tar.d.ts

@@ -1,22 +1,7 @@
-/** Один распакованный файл архива. */
 export interface TarEntry {
-    /** Путь внутри архива, уже без корневого каталога. */
     path: string;
     content: string;
 }
-/**
- * Разбирает несжатый tar и возвращает только обычные файлы.
- * Своя реализация вместо зависимости: пакету нужен один сценарий чтения,
- * а каждая зависимость опубликованного npm-пакета — это ещё одна поверхность атаки.
- * Поддержаны оба способа записать длинный путь: расширенный заголовок pax
- * (`git archive`, а значит и GitHub) и GNU longname.
- */
 export declare const readTar: (buffer: Buffer) => TarEntry[];
-/**
- * Убирает общий первый сегмент пути. GitHub кладёт весь архив в каталог
- * `<repo>-<sha>/`, и без этого docId у каждого документа начинался бы с хэша коммита.
- */
 export declare const stripRoot: (entries: readonly TarEntry[]) => TarEntry[];
-/** Распаковывает `.tar.gz` целиком: gzip снимается встроенным zlib. */
 export declare const readTarGz: (buffer: Buffer) => TarEntry[];
-//# sourceMappingURL=tar.d.ts.map

package/dist/knowledge/tar.js

@@ -1,26 +1,16 @@
 import { gunzipSync } from 'node:zlib';
-/** Размер блока формата tar — и заголовок, и выравнивание данных кратны ему. */
 const BLOCK = 512;
-/** Смещения полей заголовка ustar. */
 const FIELD = {
     name: [0, 100],
     size: [124, 12],
     typeflag: [156, 1],
     prefix: [345, 155],
 };
-/**
- * Читает строковое поле заголовка: оно дополнено нулями до фиксированной длины.
- */
 const readString = (block, [offset, length]) => {
     const raw = block.subarray(offset, offset + length);
     const end = raw.indexOf(0);
     return raw.subarray(0, end === -1 ? raw.length : end).toString('utf8').trim();
 };
-/**
- * Читает размер файла. В tar он записан восьмеричной строкой; GNU-расширение
- * с базой 256 (старший бит первого байта) в архивах GitHub не встречается,
- * но молча вернуть из него мусор нельзя — такой архив лучше отвергнуть.
- */
 const readSize = (block) => {
     const [offset, length] = FIELD.size;
     const first = block[offset] ?? 0;
@@ -34,23 +24,16 @@ const readSize = (block) => {
     }
     return parsed;
 };
-/**
- * Достаёт `path=` из расширенного заголовка pax.
- * Записи имеют вид `<длина> <ключ>=<значение>\n`; нас интересует только путь,
- * которым pax подменяет имя следующей записи, когда оно не влезает в ustar.
- */
 const readPaxPath = (data) => {
     const text = data.toString('utf8');
     const match = /(?:^|\n)\d+ path=([^\n]*)\n/.exec(text);
     return match?.[1];
 };
-/** Полное имя записи: ustar разбивает длинный путь на `prefix` и `name`. */
 const fullName = (block) => {
     const name = readString(block, FIELD.name);
     const prefix = readString(block, FIELD.prefix);
     return prefix === '' ? name : `${prefix}/${name}`;
 };
-/** Блок из одних нулей — маркер конца архива. */
 const isZeroBlock = (block) => {
     for (const byte of block) {
         if (byte !== 0) {
@@ -59,17 +42,9 @@ const isZeroBlock = (block) => {
     }
     return true;
 };
-/**
- * Разбирает несжатый tar и возвращает только обычные файлы.
- * Своя реализация вместо зависимости: пакету нужен один сценарий чтения,
- * а каждая зависимость опубликованного npm-пакета — это ещё одна поверхность атаки.
- * Поддержаны оба способа записать длинный путь: расширенный заголовок pax
- * (`git archive`, а значит и GitHub) и GNU longname.
- */
 export const readTar = (buffer) => {
     const entries = [];
     let offset = 0;
-    /** Имя, навязанное предыдущим заголовком pax или GNU longname. */
     let pendingName;
     while (offset + BLOCK <= buffer.length) {
         const header = buffer.subarray(offset, offset + BLOCK);
@@ -84,7 +59,6 @@ export const readTar = (buffer) => {
             throw new Error('tar: truncated archive');
         }
         const data = buffer.subarray(dataStart, dataEnd);
-        /** Данные записи выровнены по границе блока. */
         offset = dataStart + Math.ceil(size / BLOCK) * BLOCK;
         if (typeflag === 'x' || typeflag === 'X') {
             pendingName = readPaxPath(data) ?? pendingName;
@@ -94,7 +68,6 @@ export const readTar = (buffer) => {
             pendingName = data.toString('utf8').replace(/\0+$/, '');
             continue;
         }
-        /** Глобальные заголовки pax и всё, что не является обычным файлом, нас не интересуют. */
         if (typeflag === 'g') {
             continue;
         }
@@ -107,14 +80,8 @@ export const readTar = (buffer) => {
     }
     return entries;
 };
-/**
- * Убирает общий первый сегмент пути. GitHub кладёт весь архив в каталог
- * `<repo>-<sha>/`, и без этого docId у каждого документа начинался бы с хэша коммита.
- */
 export const stripRoot = (entries) => entries.map((entry) => {
     const cut = entry.path.indexOf('/');
     return cut === -1 ? entry : { path: entry.path.slice(cut + 1), content: entry.content };
 });
-/** Распаковывает `.tar.gz` целиком: gzip снимается встроенным zlib. */
 export const readTarGz = (buffer) => stripRoot(readTar(gunzipSync(buffer)));
-//# sourceMappingURL=tar.js.map

package/dist/knowledge/types.d.ts

@@ -1,31 +1,13 @@
-/**
- * Один раздел документации — единица поиска и чтения.
- * Резать документы на разделы обязательно: даже при ограничении на размер файла
- * модели нужен ровно тот раздел, который отвечает на её вопрос.
- */
 export interface KnowledgeChunk {
-    /** Стабильный идентификатор `<docId>#<anchor>`. */
     id: string;
-    /** Идентификатор документа, например `back/docs/menus-module`. */
     docId: string;
-    /**
-     * Первый сегмент docId: `mcp`, `back`, `front`. Строка, а не перечисление —
-     * репозиторий знаний живёт отдельно от этого пакета и может завести новый раздел,
-     * не требуя релиза сервера. Неизвестный источник получает вес 1.
-     */
     repo: string;
-    /** Путь файла в репозитории знаний, например `knowledge/back/docs/menus-module.md`. */
     path: string;
-    /** Слаг заголовка раздела; пустая строка — преамбула документа. */
     anchor: string;
-    /** Текст заголовка раздела. */
     title: string;
-    /** Заголовок документа (первый `#`), нужен для ранжирования и вывода. */
     docTitle: string;
-    /** Тело раздела без заголовка. */
     text: string;
 }
-/** Документ целиком: список его разделов, чтобы агент мог листать соседние. */
 export interface KnowledgeDoc {
     docId: string;
     repo: string;
@@ -37,32 +19,15 @@ export interface KnowledgeDoc {
         bytes: number;
     }>;
 }
-/**
- * Откуда взялся пакет знаний.
- * `github` — только что скачан, `cache` — распакованная копия на диске,
- * `local` — клон репозитория знаний рядом, `seed` — только вшитые правила эксплуатации.
- */
 export type KnowledgeOrigin = 'github' | 'cache' | 'local' | 'seed';
-/** Собранный пакет знаний — то, с чем работает KnowledgeIndex. */
 export interface KnowledgePack {
-    /** Версия формата — чтобы рантайм не пытался читать несовместимый пакет. */
     version: 1;
-    /** Когда собран (ISO). Показывается в cms_whoami. */
     builtAt: string;
     source: KnowledgeOrigin;
-    /** Репозиторий знаний `owner/name`, если пакет пришёл оттуда. */
     repo?: string;
-    /** Ветка или тег, с которого читали. */
     ref?: string;
-    /** Коммит, которым адресуется содержимое. */
     sha?: string;
-    /**
-     * Почему пакет неполон. Пустое значение — норма; заполненное обязано попадать
-     * и в `cms_whoami`, и в `cms_guide`: деградировавший пакет знаний агент должен
-     * видеть, а не обнаруживать по отсутствию нужного документа.
-     */
     warning?: string;
     docs: KnowledgeDoc[];
     chunks: KnowledgeChunk[];
 }
-//# sourceMappingURL=types.d.ts.map

package/dist/knowledge/types.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=types.js.map

package/dist/server.d.ts

@@ -1,17 +1,5 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { Config } from './config/config.js';
 import { Session, type SharedDeps } from './session.js';
-/**
- * Собирает разделяемые зависимости: каталог операций, индекс знаний, журнал.
- * Вынесено отдельно, чтобы remote-режим строил их один раз на процесс,
- * а не на каждую сессию. Асинхронно, потому что знания приезжают из репозитория
- * GitHub, а каталог — со swagger подключённого стенда.
- */
 export declare const createSharedDeps: (config: Config) => Promise<SharedDeps>;
-/**
- * Создаёт MCP-сервер с полным набором инструментов.
- * Сессия передаётся геттером: в stdio-режиме она одна на процесс,
- * в HTTP-режиме — своя на каждое подключение, и код инструментов от этого не зависит.
- */
 export declare const createServer: (deps: SharedDeps, getSession: () => Session) => McpServer;
-//# sourceMappingURL=server.d.ts.map

package/dist/server.js

@@ -1,3 +1,4 @@
+import { createRequire } from 'node:module';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { AuditLog } from './api/audit.js';
 import { OperationCatalog } from './api/catalog.js';
@@ -8,14 +9,15 @@ import { registerApiDiscovery } from './tools/api-discovery.js';
 import { registerDocs } from './tools/docs.js';
 import { registerGuide } from './tools/guide.js';
 import { registerWhoami } from './tools/whoami.js';
-/** Версия пакета, сообщаемая клиенту при handshake. */
-const SERVER_VERSION = '0.1.0';
-/**
- * Собирает разделяемые зависимости: каталог операций, индекс знаний, журнал.
- * Вынесено отдельно, чтобы remote-режим строил их один раз на процесс,
- * а не на каждую сессию. Асинхронно, потому что знания приезжают из репозитория
- * GitHub, а каталог — со swagger подключённого стенда.
- */
+const SERVER_VERSION = (() => {
+    try {
+        const pkg = createRequire(import.meta.url)('../package.json');
+        return pkg.version ?? '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+})();
 export const createSharedDeps = async (config) => ({
     config,
     catalog: await OperationCatalog.resolve(config),
@@ -34,11 +36,6 @@ export const createSharedDeps = async (config) => ({
         mode: config.mode,
     }),
 });
-/**
- * Создаёт MCP-сервер с полным набором инструментов.
- * Сессия передаётся геттером: в stdio-режиме она одна на процесс,
- * в HTTP-режиме — своя на каждое подключение, и код инструментов от этого не зависит.
- */
 export const createServer = (deps, getSession) => {
     const server = new McpServer({ name: 'oneentry-mcp-platform', version: SERVER_VERSION }, {
         instructions: 'OneEntry CMS Admin API. Call cms_guide first, then cms_docs_read on "mcp/operating-rules" before any write. ' +
@@ -52,4 +49,3 @@ export const createServer = (deps, getSession) => {
     registerApiCall(server, getSession);
     return server;
 };
-//# sourceMappingURL=server.js.map

package/dist/session.d.ts

@@ -6,21 +6,12 @@ import { ConfirmStore } from './api/policy.js';
 import type { Config } from './config/config.js';
 import { KnowledgeIndex } from './knowledge/search.js';
 import type { Operation } from './api/types.js';
-/**
- * Разделяемые между сессиями зависимости.
- * Каталог и индекс знаний строятся один раз на процесс — они неизменяемы,
- * и в remote-режиме держать их копию на сессию было бы чистой растратой.
- */
 export interface SharedDeps {
     config: Config;
     catalog: OperationCatalog;
     knowledge: KnowledgeIndex;
     audit: AuditLog;
 }
-/**
- * Состояние одной MCP-сессии: свои учётные данные, свои токены,
- * свои токены подтверждения. Именно эта изоляция делает remote-режим безопасным.
- */
 export declare class Session {
     readonly shared: SharedDeps;
     readonly confirms: ConfirmStore;
@@ -29,21 +20,7 @@ export declare class Session {
     private identityCache;
     constructor(shared: SharedDeps, credentials?: Credentials);
     get isConfigured(): boolean;
-    /**
-     * Access-токен сессии. Нужен единственному потребителю вне клиента —
-     * дозагрузке каталога в remote-режиме, когда стенд отдаёт swagger
-     * только авторизованным.
-     */
     accessToken(): Promise<string>;
-    /**
-     * Кто мы. Кэшируется: набор прав нужен почти каждому изменяющему вызову,
-     * а меняется он редко.
-     */
     identity(): Promise<AdminIdentity | undefined>;
-    /**
-     * Пытается показать, что именно будет изменено: ищет GET по тому же пути
-     * и читает объект. Без этого «подтверждение удаления» — подпись под пустым листом.
-     */
     describeTarget(operation: Operation, args: CallArgs): Promise<unknown>;
 }
-//# sourceMappingURL=session.d.ts.map

package/dist/session.js

@@ -1,10 +1,6 @@
 import { adminIdFromToken, credentialsFromConfig, TokenStore } from './api/auth.js';
 import { AdminApiClient, buildUrl } from './api/client.js';
 import { ConfirmStore } from './api/policy.js';
-/**
- * Состояние одной MCP-сессии: свои учётные данные, свои токены,
- * свои токены подтверждения. Именно эта изоляция делает remote-режим безопасным.
- */
 export class Session {
     shared;
     confirms = new ConfirmStore();
@@ -27,18 +23,9 @@ export class Session {
     get isConfigured() {
         return this.tokens.isConfigured;
     }
-    /**
-     * Access-токен сессии. Нужен единственному потребителю вне клиента —
-     * дозагрузке каталога в remote-режиме, когда стенд отдаёт swagger
-     * только авторизованным.
-     */
     async accessToken() {
         return this.tokens.accessToken();
     }
-    /**
-     * Кто мы. Кэшируется: набор прав нужен почти каждому изменяющему вызову,
-     * а меняется он редко.
-     */
     async identity() {
         if (this.identityCache) {
             return this.identityCache;
@@ -57,10 +44,6 @@ export class Session {
             return undefined;
         }
     }
-    /**
-     * Пытается показать, что именно будет изменено: ищет GET по тому же пути
-     * и читает объект. Без этого «подтверждение удаления» — подпись под пустым листом.
-     */
     async describeTarget(operation, args) {
         const sibling = this.shared.catalog
             .operations()
@@ -80,4 +63,3 @@ export class Session {
         return result.ok ? result.body : undefined;
     }
 }
-//# sourceMappingURL=session.js.map

package/dist/tools/api-call.d.ts

@@ -1,5 +1,3 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { Session } from '../session.js';
-/** Регистрирует `cms_api_call`. */
 export declare const registerApiCall: (server: McpServer, getSession: () => Session) => void;
-//# sourceMappingURL=api-call.d.ts.map