@oneentry/mcp-platform-server 0.1.1 → 0.1.4

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.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/knowledge/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,EAAE,EAAE,MAAM,CAAC;IACX,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,uFAAuF;IACvF,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,+EAA+E;AAC/E,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClE;AAED;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;AAEpE,kEAAkE;AAClE,MAAM,WAAW,aAAa;IAC5B,4EAA4E;IAC5E,OAAO,EAAE,CAAC,CAAC;IACX,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,eAAe,CAAC;IACxB,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/knowledge/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,EAAE,EAAE,MAAM,CAAC;IACX,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;IAC/B,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,+EAA+E;AAC/E,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClE;AAED,sFAAsF;AACtF,MAAM,WAAW,aAAa;IAC5B,8EAA8E;IAC9E,OAAO,EAAE,CAAC,CAAC;IACX,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC;IAC5B,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1B"}

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.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAGjD,OAAO,EAAE,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAUxD;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAU,QAAQ,MAAM,KAAG,OAAO,CAAC,UAAU,CAmBxE,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,UAAU,EAAE,YAAY,MAAM,OAAO,KAAG,SAkB1E,CAAC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAGjD,OAAO,EAAE,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAUxD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,QAAQ,MAAM,KAAG,UAahD,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,UAAU,EAAE,YAAY,MAAM,OAAO,KAAG,SAkB1E,CAAC"}

package/dist/server.js

@@ -1,5 +1,7 @@
+import { createRequire } from 'node:module';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { AuditLog } from './api/audit.js';
+import { credentialsFromConfig, TokenStore } from './api/auth.js';
 import { OperationCatalog } from './api/catalog.js';
 import { resolveKnowledge } from './knowledge/loader.js';
 import { KnowledgeIndex } from './knowledge/search.js';
@@ -8,17 +10,35 @@ 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';
+    }
+})();
+const startupAuth = async (config) => {
+    const credentials = credentialsFromConfig(config);
+    const tokens = new TokenStore({
+        baseUrl: config.baseUrl,
+        timeoutMs: config.requestTimeoutMs,
+        credentials,
+    });
+    if (!tokens.isConfigured) {
+        return {};
+    }
+    try {
+        return { bearer: await tokens.accessToken() };
+    }
+    catch (error) {
+        return { error: error instanceof Error ? error.message : String(error) };
+    }
+};
 export const createSharedDeps = async (config) => ({
     config,
-    catalog: await OperationCatalog.resolve(config),
+    catalog: await OperationCatalog.resolve(config, await startupAuth(config)),
     knowledge: new KnowledgeIndex(await resolveKnowledge({
         repo: config.knowledge.repo,
         ref: config.knowledge.ref,
@@ -34,11 +54,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 +67,3 @@ export const createServer = (deps, getSession) => {
     registerApiCall(server, getSession);
     return server;
 };
-//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,uDAAuD;AACvD,MAAM,cAAc,GAAG,OAAO,CAAC;AAE/B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EAAE,MAAc,EAAuB,EAAE,CAAC,CAAC;IAC9E,MAAM;IACN,OAAO,EAAE,MAAM,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC;IAC/C,SAAS,EAAE,IAAI,cAAc,CAC3B,MAAM,gBAAgB,CAAC;QACrB,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,IAAI;QAC3B,GAAG,EAAE,MAAM,CAAC,SAAS,CAAC,GAAG;QACzB,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,YAAY,EAAE,MAAM,CAAC,SAAS,CAAC,YAAY;QAC3C,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,OAAO;QACjC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,SAAS,EAAE,MAAM,CAAC,gBAAgB;KACnC,CAAC,CACH;IACD,KAAK,EAAE,IAAI,QAAQ,CAAC;QAClB,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,IAAI,EAAE,MAAM,CAAC,IAAI;KAClB,CAAC;CACH,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAgB,EAAE,UAAyB,EAAa,EAAE;IACrF,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,uBAAuB,EAAE,OAAO,EAAE,cAAc,EAAE,EAC1D;QACE,YAAY,EACV,8GAA8G;YAC9G,+GAA+G;YAC/G,iDAAiD;KACpD,CACF,CAAC;IAEF,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5B,cAAc,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC3B,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACnC,eAAe,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAEpC,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,uDAAuD;AACvD,MAAM,cAAc,GAAG,OAAO,CAAC;AAE/B;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAc,EAAc,EAAE,CAAC,CAAC;IAC/D,MAAM;IACN,OAAO,EAAE,gBAAgB,CAAC,IAAI,EAAE;IAChC,SAAS,EAAE,IAAI,cAAc,CAC3B,gBAAgB,CAAC;QACf,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7D,CAAC,CACH;IACD,KAAK,EAAE,IAAI,QAAQ,CAAC;QAClB,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,IAAI,EAAE,MAAM,CAAC,IAAI;KAClB,CAAC;CACH,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAgB,EAAE,UAAyB,EAAa,EAAE;IACrF,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,uBAAuB,EAAE,OAAO,EAAE,cAAc,EAAE,EAC1D;QACE,YAAY,EACV,8GAA8G;YAC9G,+GAA+G;YAC/G,iDAAiD;KACpD,CACF,CAAC;IAEF,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5B,cAAc,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC3B,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACnC,eAAe,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAEpC,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

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.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAA2C,KAAK,aAAa,EAAE,KAAK,WAAW,EAAc,MAAM,eAAe,CAAC;AAC1H,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAY,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,gBAAgB,CAAC;IAC1B,SAAS,EAAE,cAAc,CAAC;IAC1B,KAAK,EAAE,QAAQ,CAAC;CACjB;AAED;;;GAGG;AACH,qBAAa,OAAO;IAClB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,QAAQ,eAAsB;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,OAAO,CAAC,aAAa,CAA4B;gBAErC,MAAM,EAAE,UAAU,EAAE,WAAW,CAAC,EAAE,WAAW;IAczD,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IAIpC;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;IAkBpD;;;OAGG;IACG,cAAc,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;CAiB7E"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAA2C,KAAK,aAAa,EAAE,KAAK,WAAW,EAAc,MAAM,eAAe,CAAC;AAC1H,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAY,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,gBAAgB,CAAC;IAC1B,SAAS,EAAE,cAAc,CAAC;IAC1B,KAAK,EAAE,QAAQ,CAAC;CACjB;AAED;;;GAGG;AACH,qBAAa,OAAO;IAClB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,QAAQ,eAAsB;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,OAAO,CAAC,aAAa,CAA4B;gBAErC,MAAM,EAAE,UAAU,EAAE,WAAW,CAAC,EAAE,WAAW;IAczD,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;IAkBpD;;;OAGG;IACG,cAAc,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;CAiB7E"}

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/session.js.map

@@ -1 +1 @@
-{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"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"}

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

package/dist/tools/api-call.js

@@ -4,9 +4,7 @@ import { buildUrl, normalizeBody, RequestBuildError } from '../api/client.js';
 import { checkLevel, decide } from '../api/policy.js';
 import { shapeResponse, summarizeTarget } from '../api/shape.js';
 import { errorResult, jsonResult } from './result.js';
-/** Ограничение на показ тела в плане dry-run. */
 const PLAN_BODY_LIMIT = 2_000;
-/** Регистрирует `cms_api_call`. */
 export const registerApiCall = (server, getSession) => {
     server.registerTool('cms_api_call', {
         title: 'Call an Admin API operation',
@@ -42,11 +40,6 @@ export const registerApiCall = (server, getSession) => {
                 hint: 'Operation ids come from cms_api_search — do not construct them by hand.',
             });
         }
-        /**
-         * Тело нормализуется до всего остального: и хэш аудита, и токен подтверждения
-         * привязываются именно к отправляемым аргументам, иначе подтверждение,
-         * выданное на dry-run, не совпало бы с реальным вызовом.
-         */
         const normalizedBody = normalizeBody(body);
         const args = {
             ...(path ? { path } : {}),
@@ -60,24 +53,15 @@ export const registerApiCall = (server, getSession) => {
             path: operation.path,
             argsHash,
         };
-        /**
-         * Уровень доступа проверяется до аутентификации: иначе отказ read-only режима
-         * всё равно сходил бы в сеть за токеном, и обещание «no request was sent» было бы ложью.
-         */
         const levelDenial = checkLevel(operation, config.allow);
         if (levelDenial) {
             audit.record({ ...auditBase, outcome: 'denied' });
             return errorResult(levelDenial.reason, { opId, policy: config.allow, risk: operation.risk });
         }
-        /** Личность нужна только там, где операция объявляет требуемое право. */
         const identity = operation.permission ? await session.identity() : undefined;
         if (identity) {
             Object.assign(auditBase, { adminId: identity.id });
         }
-        /**
-         * Негодный токен — отдельная ошибка, а не «просто нет подтверждения»:
-         * иначе агент получал бы в ответ новый токен и не понимал, что предыдущий не подошёл.
-         */
         const confirmValid = confirm !== undefined && session.confirms.verify(confirm, opId, args);
         if (confirm !== undefined && !confirmValid) {
             return errorResult('Confirm token is expired, already used, or does not match these arguments. Re-run with dryRun: true to get a fresh one.', { opId });
@@ -94,7 +78,6 @@ export const registerApiCall = (server, getSession) => {
             }
             return errorResult(decision.reason, { opId, policy: config.allow, risk: operation.risk });
         }
-        /** Разрешение по уровню и правам получено — можно строить сам запрос. */
         let url;
         try {
             url = buildUrl(config.baseUrl, operation, args);
@@ -134,10 +117,6 @@ export const registerApiCall = (server, getSession) => {
                 target: summarizeTarget(target),
             });
         }
-        /**
-         * Токен гасится только здесь, перед самой отправкой: если бы он расходовался
-         * при проверке политики, отказ по другой причине заставлял бы подтверждать заново.
-         */
         if (confirm !== undefined && !session.confirms.consume(confirm, opId, args)) {
             return errorResult('Confirm token was consumed concurrently. Re-run with dryRun: true to get a fresh one.', { opId });
         }
@@ -154,7 +133,6 @@ export const registerApiCall = (server, getSession) => {
                 opId,
                 status: result.error.status,
                 ...(result.error.hint ? { hint: result.error.hint } : {}),
-                docs: operation.docLinks,
             });
         }
         const shaped = shapeResponse(result.body, config.maxResponseBytes);
@@ -166,4 +144,3 @@ export const registerApiCall = (server, getSession) => {
         });
     });
 };
-//# sourceMappingURL=api-call.js.map

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

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

package/dist/tools/api-discovery.js

@@ -1,6 +1,5 @@
 import { z } from 'zod';
 import { errorResult, jsonResult } from './result.js';
-/** Регистрирует `cms_api_search` и `cms_api_describe`. */
 export const registerApiDiscovery = (server, deps) => {
     const { catalog } = deps;
     server.registerTool('cms_api_search', {
@@ -36,7 +35,7 @@ export const registerApiDiscovery = (server, deps) => {
     });
     server.registerTool('cms_api_describe', {
         title: 'Describe an Admin API operation',
-        description: 'Full detail for one operation: path and query parameters, request-body schema, required permission, risk level, and the knowledge sections that explain the payload. Fields marked "x-loose": true have a TypeScript-shaped type in the source swagger — trust their example, not their type.',
+        description: 'Full detail for one operation: path and query parameters, request-body schema, required permission, risk level, and whether it is permanently confirm-gated. Fields marked "x-loose": true could not be converted to a JSON Schema type — trust their example, not their type.',
         inputSchema: {
             opId: z.string().min(1).describe('Operation id from cms_api_search, e.g. "AdminPagesController_findAllRoot".'),
         },
@@ -70,11 +69,9 @@ export const registerApiDiscovery = (server, deps) => {
             body: operation.body ?? null,
             looseFields: loose,
             responseSummary: operation.responseSummary ?? null,
-            docs: operation.docLinks,
             next: operation.risk === 'read'
                 ? 'Call it with cms_api_call { opId, path, query }.'
-                : 'Read the linked docs, then call cms_api_call with dryRun: true first.',
+                : 'Search the knowledge base with cms_docs_search for this entity, then call cms_api_call with dryRun: true first.',
         });
     });
 };
-//# sourceMappingURL=api-discovery.js.map

package/dist/tools/docs.d.ts

@@ -1,5 +1,3 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { SharedDeps } from '../session.js';
-/** Регистрирует `cms_docs_search` и `cms_docs_read`. */
 export declare const registerDocs: (server: McpServer, deps: SharedDeps) => void;
-//# sourceMappingURL=docs.d.ts.map

package/dist/tools/docs.js

@@ -1,8 +1,6 @@
 import { z } from 'zod';
 import { errorResult, jsonResult } from './result.js';
-/** Предел размера одного раздела, отдаваемого модели. */
 const MAX_SECTION_BYTES = 12_288;
-/** Регистрирует `cms_docs_search` и `cms_docs_read`. */
 export const registerDocs = (server, deps) => {
     const { knowledge } = deps;
     server.registerTool('cms_docs_search', {
@@ -37,7 +35,7 @@ export const registerDocs = (server, deps) => {
         title: 'Read a CMS knowledge section',
         description: 'Read one section of a knowledge document. Omit the anchor to get the document preamble plus its section list, then page through the sections you need.',
         inputSchema: {
-            docId: z.string().min(1).describe('Document id, e.g. "back/docs/menus-module" or "mcp/operating-rules".'),
+            docId: z.string().min(1).describe('Document id, e.g. "mcp/docs/api/orders" or "mcp/operating-rules".'),
             anchor: z.string().optional().describe('Section anchor from cms_docs_search; omit for the preamble.'),
         },
         annotations: { readOnlyHint: true, openWorldHint: false },
@@ -73,7 +71,6 @@ export const registerDocs = (server, deps) => {
             sections: doc.anchors.map((a) => ({ anchor: a.anchor, title: a.title, bytes: a.bytes })),
         });
     });
-    /** Ресурсы дублируют два самых нужных документа, чтобы клиент мог их закрепить. */
     server.registerResource('operating-rules', 'oneentry://knowledge/mcp/operating-rules', {
         title: 'OneEntry CMS operating rules',
         description: 'The payload and safety rules an agent must follow before writing to this CMS.',
@@ -110,4 +107,3 @@ export const registerDocs = (server, deps) => {
         ],
     }));
 };
-//# sourceMappingURL=docs.js.map

package/dist/tools/guide.d.ts

@@ -1,11 +1,4 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { SharedDeps } from '../session.js';
-/**
- * Собирает краткое руководство: режим, политика, карта тегов и порядок работы.
- * Генерируется, а не хранится текстом, потому что половина содержимого —
- * фактическое состояние сервера, и расхождение здесь дороже дублирования.
- */
 export declare const renderGuide: (deps: SharedDeps) => string;
-/** Регистрирует `cms_guide`. */
 export declare const registerGuide: (server: McpServer, deps: SharedDeps) => void;
-//# sourceMappingURL=guide.d.ts.map

package/dist/tools/guide.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guide.d.ts","sourceRoot":"","sources":["../../src/tools/guide.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAMhD;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,UAAU,KAAG,MA6D9C,CAAC;AAEF,gCAAgC;AAChC,eAAO,MAAM,aAAa,GAAI,QAAQ,SAAS,EAAE,MAAM,UAAU,KAAG,IAWnE,CAAC"}
+{"version":3,"file":"guide.d.ts","sourceRoot":"","sources":["../../src/tools/guide.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAMhD;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,UAAU,KAAG,MAoD9C,CAAC;AAEF,gCAAgC;AAChC,eAAO,MAAM,aAAa,GAAI,QAAQ,SAAS,EAAE,MAAM,UAAU,KAAG,IAWnE,CAAC"}

package/dist/tools/guide.js

@@ -1,11 +1,5 @@
 import { textResult } from './result.js';
-/** Сколько тегов показывать в карте API. */
 const TAG_LIMIT = 24;
-/**
- * Собирает краткое руководство: режим, политика, карта тегов и порядок работы.
- * Генерируется, а не хранится текстом, потому что половина содержимого —
- * фактическое состояние сервера, и расхождение здесь дороже дублирования.
- */
 export const renderGuide = (deps) => {
     const { config, catalog, knowledge } = deps;
     const counts = new Map();
@@ -42,7 +36,8 @@ export const renderGuide = (deps) => {
         '   payload rules (locale-keyed `localizeInfos`, attribute-set-driven `attributesSets`,',
         '   lexorank vs numeric `position`, eventual consistency) that make the difference between',
         '   a 400 and a correct call.',
-        '2. `cms_docs_search` — find the reference doc for the entity you are touching.',
+        '2. `cms_docs_search` — find the reference doc for the entity you are touching;',
+        '   `mcp/docs/server/doc-map` lists every document with a one-line "read this when".',
         '3. `cms_api_search` → `cms_api_describe` — get the real operation and its payload shape.',
         '4. `cms_api_call` — `dryRun: true` first for anything that mutates.',
         '',
@@ -63,7 +58,6 @@ export const renderGuide = (deps) => {
             : []),
     ].join('\n');
 };
-/** Регистрирует `cms_guide`. */
 export const registerGuide = (server, deps) => {
     server.registerTool('cms_guide', {
         title: 'CMS guide',
@@ -71,4 +65,3 @@ export const registerGuide = (server, deps) => {
         annotations: { readOnlyHint: true, openWorldHint: false },
     }, () => textResult(renderGuide(deps)));
 };
-//# sourceMappingURL=guide.js.map

package/dist/tools/guide.js.map

@@ -1 +1 @@
-{"version":3,"file":"guide.js","sourceRoot":"","sources":["../../src/tools/guide.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"guide.js","sourceRoot":"","sources":["../../src/tools/guide.ts"],"names":[],"mappings":"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"}