@oneentry/mcp-platform-server 0.1.0 → 0.1.3

package/dist/knowledge/tar.js

@@ -0,0 +1,87 @@
+import { gunzipSync } from 'node:zlib';
+const BLOCK = 512;
+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();
+};
+const readSize = (block) => {
+    const [offset, length] = FIELD.size;
+    const first = block[offset] ?? 0;
+    if ((first & 0x80) !== 0) {
+        throw new Error('tar: base-256 size fields are not supported');
+    }
+    const text = readString(block, FIELD.size).replace(/\0/g, '').trim();
+    const parsed = Number.parseInt(text === '' ? '0' : text, 8);
+    if (!Number.isFinite(parsed) || parsed < 0) {
+        throw new Error(`tar: unreadable size field "${text}" at offset ${String(offset + length)}`);
+    }
+    return parsed;
+};
+const readPaxPath = (data) => {
+    const text = data.toString('utf8');
+    const match = /(?:^|\n)\d+ path=([^\n]*)\n/.exec(text);
+    return match?.[1];
+};
+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) {
+            return false;
+        }
+    }
+    return true;
+};
+export const readTar = (buffer) => {
+    const entries = [];
+    let offset = 0;
+    let pendingName;
+    while (offset + BLOCK <= buffer.length) {
+        const header = buffer.subarray(offset, offset + BLOCK);
+        if (isZeroBlock(header)) {
+            break;
+        }
+        const size = readSize(header);
+        const typeflag = readString(header, FIELD.typeflag);
+        const dataStart = offset + BLOCK;
+        const dataEnd = dataStart + size;
+        if (dataEnd > buffer.length) {
+            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;
+            continue;
+        }
+        if (typeflag === 'L') {
+            pendingName = data.toString('utf8').replace(/\0+$/, '');
+            continue;
+        }
+        if (typeflag === 'g') {
+            continue;
+        }
+        const name = pendingName ?? fullName(header);
+        pendingName = undefined;
+        if (typeflag !== '' && typeflag !== '0') {
+            continue;
+        }
+        entries.push({ path: name, content: data.toString('utf8') });
+    }
+    return entries;
+};
+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 };
+});
+export const readTarGz = (buffer) => stripRoot(readTar(gunzipSync(buffer)));

package/dist/knowledge/types.d.ts

@@ -1,30 +1,16 @@
-/**
- * Один раздел документации — единица поиска и чтения.
- * Резать документы на разделы обязательно: отдельные файлы доходят до 56 КБ,
- * а модели нужен ровно тот раздел, который отвечает на её вопрос.
- */
 export interface KnowledgeChunk {
-    /** Стабильный идентификатор `<docId>#<anchor>`. */
     id: string;
-    /** Идентификатор документа, например `back/docs/menus-module`. */
     docId: string;
-    /** Репозиторий-источник. */
-    repo: 'back' | 'front' | 'mcp';
-    /** Путь файла относительно корня репозитория-источника. */
+    repo: string;
     path: string;
-    /** Слаг заголовка раздела; пустая строка — преамбула документа. */
     anchor: string;
-    /** Текст заголовка раздела. */
     title: string;
-    /** Заголовок документа (первый `#`), нужен для ранжирования и вывода. */
     docTitle: string;
-    /** Тело раздела без заголовка. */
     text: string;
 }
-/** Документ целиком: список его разделов, чтобы агент мог листать соседние. */
 export interface KnowledgeDoc {
     docId: string;
-    repo: 'back' | 'front' | 'mcp';
+    repo: string;
     path: string;
     title: string;
     anchors: Array<{
@@ -33,15 +19,15 @@ export interface KnowledgeDoc {
         bytes: number;
     }>;
 }
-/** Собранный пакет знаний: то, что build-knowledge.ts пишет в data/knowledge.json. */
+export type KnowledgeOrigin = 'github' | 'cache' | 'local' | 'seed';
 export interface KnowledgePack {
-    /** Версия формата — чтобы рантайм не пытался читать несовместимый снапшот. */
     version: 1;
-    /** Когда собран (ISO). Показывается в cms_whoami. */
     builtAt: string;
-    /** Из какого источника собран: снапшот или живой чекаут. */
-    source: 'snapshot' | 'live';
+    source: KnowledgeOrigin;
+    repo?: string;
+    ref?: string;
+    sha?: string;
+    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,16 +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-режим строил их один раз на процесс,
- * а не на каждую сессию.
- */
-export declare const createSharedDeps: (config: Config) => SharedDeps;
-/**
- * Создаёт MCP-сервер с полным набором инструментов.
- * Сессия передаётся геттером: в stdio-режиме она одна на процесс,
- * в HTTP-режиме — своя на каждое подключение, и код инструментов от этого не зависит.
- */
+export declare const createSharedDeps: (config: Config) => Promise<SharedDeps>;
 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,30 +9,33 @@ 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-режим строил их один раз на процесс,
- * а не на каждую сессию.
- */
-export const createSharedDeps = (config) => ({
+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: OperationCatalog.load(),
-    knowledge: new KnowledgeIndex(resolveKnowledge({
-        ...(config.backPath ? { backPath: config.backPath } : {}),
-        ...(config.frontPath ? { frontPath: config.frontPath } : {}),
+    catalog: await OperationCatalog.resolve(config),
+    knowledge: new KnowledgeIndex(await resolveKnowledge({
+        repo: config.knowledge.repo,
+        ref: config.knowledge.ref,
+        ...(config.knowledge.path ? { path: config.knowledge.path } : {}),
+        cacheDir: config.cacheDir,
+        refreshTtlMs: config.knowledge.refreshTtlMs,
+        offline: config.knowledge.offline,
+        ...(config.knowledge.token ? { token: config.knowledge.token } : {}),
+        timeoutMs: config.requestTimeoutMs,
     })),
     audit: new AuditLog({
         ...(config.auditPath ? { path: config.auditPath } : {}),
         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. ' +
@@ -45,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,15 +20,7 @@ export declare class Session {
     private identityCache;
     constructor(shared: SharedDeps, credentials?: Credentials);
     get isConfigured(): boolean;
-    /**
-     * Кто мы. Кэшируется: набор прав нужен почти каждому изменяющему вызову,
-     * а меняется он редко.
-     */
+    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,10 +23,9 @@ export class Session {
     get isConfigured() {
         return this.tokens.isConfigured;
     }
-    /**
-     * Кто мы. Кэшируется: набор прав нужен почти каждому изменяющему вызову,
-     * а меняется он редко.
-     */
+    async accessToken() {
+        return this.tokens.accessToken();
+    }
     async identity() {
         if (this.identityCache) {
             return this.identityCache;
@@ -49,10 +44,6 @@ export class Session {
             return undefined;
         }
     }
-    /**
-     * Пытается показать, что именно будет изменено: ищет GET по тому же пути
-     * и читает объект. Без этого «подтверждение удаления» — подпись под пустым листом.
-     */
     async describeTarget(operation, args) {
         const sibling = this.shared.catalog
             .operations()
@@ -72,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

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();
@@ -22,12 +16,19 @@ export const renderGuide = (deps) => {
         : config.allow === 'write'
             ? 'writes allowed; DELETE and the permanently gated paths still need a confirm token'
             : 'writes and deletes allowed; deletes and the permanently gated paths still need a confirm token';
+    const pack = knowledge.pack;
+    const knowledgeOrigin = pack.source === 'seed'
+        ? 'bundled operating rules only'
+        : pack.source === 'local'
+            ? `local clone ${pack.repo ?? ''}`.trim()
+            : `${pack.repo ?? ''}@${pack.ref ?? ''} (${pack.sha?.slice(0, 12) ?? '?'}, ${pack.source})`;
     return [
         '# OneEntry CMS Admin API — agent guide',
         '',
         `Mode: **${config.mode}** · Base URL: \`${config.baseUrl}\` · Policy: ${allowLine}.`,
-        `Catalog: ${String(catalog.operations().length)} operations (swagger ${catalog.catalog.swaggerHash}).`,
-        `Knowledge: ${String(knowledge.docs().length)} docs / ${String(knowledge.pack.chunks.length)} sections, source ${knowledge.pack.source}.`,
+        `Catalog: ${String(catalog.operations().length)} operations (swagger ${catalog.catalog.swaggerHash || 'unavailable'}).`,
+        `Knowledge: ${String(knowledge.docs().length)} docs / ${String(pack.chunks.length)} sections, from ${knowledgeOrigin}.`,
+        ...(pack.warning ? ['', `> **Knowledge is degraded.** ${pack.warning}`] : []),
         '',
         '## How to work here',
         '',
@@ -35,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.',
         '',
@@ -56,7 +58,6 @@ export const renderGuide = (deps) => {
             : []),
     ].join('\n');
 };
-/** Регистрирует `cms_guide`. */
 export const registerGuide = (server, deps) => {
     server.registerTool('cms_guide', {
         title: 'CMS guide',
@@ -64,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: {
@@ -31,12 +30,15 @@ export const registerWhoami = (server, getSession) => {
             },
             knowledge: {
                 source: knowledge.pack.source,
+                ...(knowledge.pack.repo ? { repo: knowledge.pack.repo } : {}),
+                ...(knowledge.pack.ref ? { ref: knowledge.pack.ref } : {}),
+                ...(knowledge.pack.sha ? { commit: knowledge.pack.sha.slice(0, 12) } : {}),
                 builtAt: knowledge.pack.builtAt,
                 docs: knowledge.docs().length,
                 sections: knowledge.pack.chunks.length,
+                ...(knowledge.pack.warning ? { warning: knowledge.pack.warning } : {}),
             },
             audit: config.auditPath ?? null,
         });
     });
 };
-//# 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