@oneentry/mcp-platform-server 0.1.1 → 0.1.3

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.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/result.d.ts

@@ -1,4 +1,3 @@
-/** Форма результата вызова инструмента MCP. */
 export interface ToolResult {
     content: Array<{
         type: 'text';
@@ -7,13 +6,6 @@ export interface ToolResult {
     isError?: boolean;
     [key: string]: unknown;
 }
-/** Успешный результат-JSON. */
 export declare const jsonResult: (payload: unknown) => ToolResult;
-/** Успешный результат-текст (для человекочитаемых руководств). */
 export declare const textResult: (text: string) => ToolResult;
-/**
- * Ошибка инструмента. Возвращаем её как isError, а не бросаем исключение:
- * модель должна увидеть текст и исправиться, а не получить обрыв сессии.
- */
 export declare const errorResult: (message: string, extra?: Record<string, unknown>) => ToolResult;
-//# sourceMappingURL=result.d.ts.map

package/dist/tools/result.js

@@ -1,19 +1,12 @@
-/** Успешный результат-JSON. */
 export const jsonResult = (payload) => ({
     content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }],
 });
-/** Успешный результат-текст (для человекочитаемых руководств). */
 export const textResult = (text) => ({
     content: [{ type: 'text', text }],
 });
-/**
- * Ошибка инструмента. Возвращаем её как isError, а не бросаем исключение:
- * модель должна увидеть текст и исправиться, а не получить обрыв сессии.
- */
 export const errorResult = (message, extra) => ({
     content: [
         { type: 'text', text: JSON.stringify({ error: message, ...(extra ?? {}) }, null, 2) },
     ],
     isError: true,
 });
-//# sourceMappingURL=result.js.map

package/dist/tools/whoami.d.ts

@@ -1,5 +1,3 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { Session } from '../session.js';
-/** Регистрирует `cms_whoami` — состояние сервера и подключённого админа. */
 export declare const registerWhoami: (server: McpServer, getSession: () => Session) => void;
-//# sourceMappingURL=whoami.d.ts.map

package/dist/tools/whoami.js

@@ -1,5 +1,4 @@
 import { jsonResult } from './result.js';
-/** Регистрирует `cms_whoami` — состояние сервера и подключённого админа. */
 export const registerWhoami = (server, getSession) => {
     server.registerTool('cms_whoami', {
         title: 'Who am I',
@@ -19,7 +18,7 @@ export const registerWhoami = (server, getSession) => {
                 : {
                     admin: null,
                     hint: session.isConfigured
-                        ? 'Credentials are configured but authentication failed — check ONEENTRY_CMS_LOGIN / ONEENTRY_CMS_PASSWORD and that the stand is reachable.'
+                        ? 'Credentials are configured but authentication failed — check ONEENTRY_CMS_LOGIN / ONEENTRY_CMS_PASSWORD and that the instance is reachable.'
                         : 'No credentials configured. Set ONEENTRY_CMS_LOGIN + ONEENTRY_CMS_PASSWORD (or ONEENTRY_CMS_TOKEN).',
                 }),
             catalog: {
@@ -43,4 +42,3 @@ export const registerWhoami = (server, getSession) => {
         });
     });
 };
-//# sourceMappingURL=whoami.js.map

package/dist/transports/http.d.ts

@@ -1,10 +1,4 @@
 import type { Config } from '../config/config.js';
-/**
- * Запускает сервер поверх Streamable HTTP — remote-режим.
- * На каждое MCP-подключение создаётся своя `Session` со своими токенами
- * и своими подтверждениями; общий каталог и знания строятся один раз.
- */
 export declare const runHttp: (config: Config) => Promise<{
     close: () => Promise<void>;
 }>;
-//# sourceMappingURL=http.d.ts.map

package/dist/transports/http.js

@@ -5,7 +5,6 @@ import express from 'express';
 import { OperationCatalog } from '../api/catalog.js';
 import { createServer, createSharedDeps } from '../server.js';
 import { Session } from '../session.js';
-/** Заголовки, которыми клиент передаёт свои учётные данные CMS. */
 const HEADER_TOKEN = 'x-cms-token';
 const HEADER_LOGIN = 'x-cms-login';
 const HEADER_PASSWORD = 'x-cms-password';
@@ -14,11 +13,6 @@ const headerValue = (request, name) => {
     const value = Array.isArray(raw) ? raw[0] : raw;
     return typeof value === 'string' && value.trim() !== '' ? value.trim() : undefined;
 };
-/**
- * Читает учётные данные сессии из заголовков подключения.
- * Только отсюда и из конфигурации сервера — никогда из аргументов инструмента:
- * иначе внедрённая в текст инструкция могла бы подменить личность.
- */
 const credentialsFromRequest = (request) => {
     const token = headerValue(request, HEADER_TOKEN);
     if (token) {
@@ -31,10 +25,6 @@ const credentialsFromRequest = (request) => {
     }
     return undefined;
 };
-/**
- * Проверка Origin. Транспорт SDK умеет это сам, но помечает как deprecated
- * в пользу внешней middleware — делаем внешнюю.
- */
 const originGuard = (allowedOrigins) => (request, response, next) => {
     const origin = headerValue(request, 'origin');
     if (!origin) {
@@ -49,14 +39,6 @@ const originGuard = (allowedOrigins) => (request, response, next) => {
         error: `Origin "${origin}" is not allowed. Start the server with --allowed-origins to permit it.`,
     });
 };
-/**
- * Достраивает пустой каталог по учётным данным подключившейся сессии.
- * Процесс поднимается раньше, чем появляется первая сессия, и в remote-режиме
- * своих учётных данных у него может не быть вовсе. Если при этом стенд отдаёт
- * swagger только авторизованным, каталог при старте выходит пустым — и первая
- * же сессия с токеном является единственной возможностью его получить.
- * Делается один раз и молча: это оптимизация, а не часть контракта запроса.
- */
 const fillCatalog = async (deps, session) => {
     if (!deps.catalog.isEmpty || !session.isConfigured) {
         return;
@@ -69,14 +51,8 @@ const fillCatalog = async (deps, session) => {
         }
     }
     catch {
-        /** Каталог остаётся пустым, и его warnings уже объясняют почему. */
     }
 };
-/**
- * Запускает сервер поверх Streamable HTTP — remote-режим.
- * На каждое MCP-подключение создаётся своя `Session` со своими токенами
- * и своими подтверждениями; общий каталог и знания строятся один раз.
- */
 export const runHttp = async (config) => {
     const deps = await createSharedDeps(config);
     const sessions = new Map();
@@ -119,7 +95,6 @@ export const runHttp = async (config) => {
         await server.connect(transport);
         await transport.handleRequest(request, response, request.body);
     });
-    /** GET открывает SSE-поток, DELETE закрывает сессию — обе требуют существующей сессии. */
     const requireSession = async (request, response) => {
         const sessionId = headerValue(request, 'mcp-session-id');
         const managed = sessionId ? sessions.get(sessionId) : undefined;
@@ -148,4 +123,3 @@ export const runHttp = async (config) => {
         },
     };
 };
-//# sourceMappingURL=http.js.map

package/dist/transports/stdio.d.ts

@@ -1,8 +1,2 @@
 import type { Config } from '../config/config.js';
-/**
- * Запускает сервер поверх stdio — local-режим.
- * Сессия одна на процесс: клиент сам порождает процесс на подключение,
- * поэтому изоляция обеспечивается операционной системой, а не нашим кодом.
- */
 export declare const runStdio: (config: Config) => Promise<void>;
-//# sourceMappingURL=stdio.d.ts.map

package/dist/transports/stdio.js

@@ -1,15 +1,9 @@
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { createServer, createSharedDeps } from '../server.js';
 import { Session } from '../session.js';
-/**
- * Запускает сервер поверх stdio — local-режим.
- * Сессия одна на процесс: клиент сам порождает процесс на подключение,
- * поэтому изоляция обеспечивается операционной системой, а не нашим кодом.
- */
 export const runStdio = async (config) => {
     const deps = await createSharedDeps(config);
     const session = new Session(deps);
     const server = createServer(deps, () => session);
     await server.connect(new StdioServerTransport());
 };
-//# sourceMappingURL=stdio.js.map