@oneentry/mcp-platform-server 0.1.0

package/dist/api/client.js

@@ -0,0 +1,196 @@
+/** Ошибка на стороне вызывающего — до отправки запроса. */
+export class RequestBuildError extends Error {
+}
+/**
+ * Возвращает тело в том виде, в каком его надо сериализовать в запрос.
+ * Часть MCP-клиентов передаёт объектный аргумент уже сериализованным в строку;
+ * без этой нормализации `JSON.stringify` завернул бы его второй раз, и на сервер
+ * ушла бы JSON-строка вместо объекта — любая запись падала бы с невнятным 400.
+ * Разворачивается только строка, которая целиком является объектом или массивом:
+ * скалярная строка — законное тело, и трогать её нельзя.
+ */
+export const normalizeBody = (body) => {
+    if (typeof body !== 'string') {
+        return body;
+    }
+    const trimmed = body.trim();
+    if (!trimmed.startsWith('{') && !trimmed.startsWith('[')) {
+        return body;
+    }
+    try {
+        const parsed = JSON.parse(trimmed);
+        return typeof parsed === 'object' && parsed !== null ? parsed : body;
+    }
+    catch {
+        return body;
+    }
+};
+/**
+ * Подставляет path-параметры и собирает query-строку.
+ * Отсутствующий обязательный path-параметр — ошибка здесь, а не 404 от сервера:
+ * иначе агент получает загадочный ответ вместо указания, чего не хватает.
+ */
+export const buildUrl = (baseUrl, operation, args) => {
+    let path = operation.path;
+    const provided = args.path ?? {};
+    for (const param of operation.params) {
+        if (param.location !== 'path') {
+            continue;
+        }
+        const value = provided[param.name];
+        if (value === undefined || value === '') {
+            throw new RequestBuildError(`Missing path parameter "${param.name}" for ${operation.opId} (${operation.path}). ` +
+                `Pass it as path.${param.name}.`);
+        }
+        path = path.replace(`{${param.name}}`, encodeURIComponent(String(value)));
+    }
+    const leftover = /\{([^}]+)\}/.exec(path);
+    if (leftover) {
+        throw new RequestBuildError(`Path parameter "${leftover[1] ?? ''}" of ${operation.path} was not provided and is not ` +
+            'declared in the catalog — the swagger snapshot may be stale.');
+    }
+    const search = new URLSearchParams();
+    for (const [key, value] of Object.entries(args.query ?? {})) {
+        if (value !== undefined && value !== null) {
+            search.set(key, String(value));
+        }
+    }
+    const suffix = search.size > 0 ? `?${search.toString()}` : '';
+    return `${baseUrl}${path}${suffix}`;
+};
+/** Подбирает подсказку по коду ответа и метаданным операции. */
+const hintFor = (status, operation) => {
+    if (status === 400 || status === 422) {
+        const loose = operation.body?.schema['x-loose'] === true;
+        return (`Validation rejected the payload. ${loose ? 'This body has loosely typed fields — copy the shape from the example in cms_api_describe. ' : ''}` +
+            `Read ${operation.docLinks.slice(0, 2).join(', ')} with cms_docs_read before retrying.`);
+    }
+    if (status === 403) {
+        return operation.permission
+            ? `The admin lacks "${operation.permission}". Ask for the grant; retrying will not help.`
+            : 'Forbidden. Check the admin\'s permissions and the module visibility rules (back/docs/user-permissions).';
+    }
+    if (status === 404) {
+        return 'Not found. The id may belong to another stand — prefer marker-based operations where they exist.';
+    }
+    if (status >= 500) {
+        return 'Server-side failure. Check the dnk-back logs; do not retry blindly.';
+    }
+    return undefined;
+};
+const readBody = async (response) => {
+    const text = await response.text();
+    if (text === '') {
+        return null;
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text.slice(0, 2000);
+    }
+};
+const extractMessage = (body, fallback) => {
+    if (typeof body === 'string') {
+        return body.slice(0, 500);
+    }
+    if (typeof body === 'object' && body !== null) {
+        const message = body['message'];
+        if (typeof message === 'string') {
+            return message;
+        }
+        if (Array.isArray(message)) {
+            return message.map((m) => String(m)).join('; ').slice(0, 500);
+        }
+    }
+    return fallback;
+};
+/**
+ * HTTP-клиент Admin API.
+ * Единственный ретрай — на 401 после обновления токена: любой другой повтор
+ * на изменяющей операции рискует создать дубль, поэтому его здесь нет.
+ */
+export class AdminApiClient {
+    baseUrl;
+    tokens;
+    timeoutMs;
+    constructor(params) {
+        this.baseUrl = params.baseUrl;
+        this.tokens = params.tokens;
+        this.timeoutMs = params.timeoutMs;
+    }
+    async call(operation, args) {
+        const url = buildUrl(this.baseUrl, operation, args);
+        const send = async (token) => {
+            const headers = { authorization: `Bearer ${token}` };
+            let payload;
+            if (args.body !== undefined && operation.method !== 'get') {
+                headers['content-type'] = 'application/json';
+                payload = JSON.stringify(args.body);
+            }
+            return fetch(url, {
+                method: operation.method.toUpperCase(),
+                headers,
+                ...(payload !== undefined ? { body: payload } : {}),
+                signal: AbortSignal.timeout(this.timeoutMs),
+            });
+        };
+        let response;
+        try {
+            response = await send(await this.tokens.accessToken());
+            if (response.status === 401) {
+                response = await send(await this.tokens.refresh());
+            }
+        }
+        catch (error) {
+            return {
+                ok: false,
+                error: {
+                    status: 0,
+                    message: `Request to ${url} failed: ${error instanceof Error ? error.message : String(error)}`,
+                    hint: 'Is the stand reachable? In local mode dnk-back must be running with API_TYPE=/api/admin.',
+                },
+            };
+        }
+        const body = await readBody(response);
+        if (!response.ok) {
+            const hint = hintFor(response.status, operation);
+            return {
+                ok: false,
+                error: {
+                    status: response.status,
+                    message: extractMessage(body, `${operation.method.toUpperCase()} ${url} → ${String(response.status)}`),
+                    ...(hint ? { hint } : {}),
+                },
+            };
+        }
+        return { ok: true, status: response.status, body };
+    }
+    /** Читает набор прав админа. Пустой массив означает «не удалось выяснить». */
+    async fetchPermissions(adminId) {
+        try {
+            const token = await this.tokens.accessToken();
+            const response = await fetch(`${this.baseUrl}/admins/${String(adminId)}`, {
+                headers: { authorization: `Bearer ${token}` },
+                signal: AbortSignal.timeout(this.timeoutMs),
+            });
+            if (!response.ok) {
+                return [];
+            }
+            const body = await readBody(response);
+            const permissions = typeof body === 'object' && body !== null
+                ? body['permissions']
+                : undefined;
+            if (typeof permissions !== 'object' || permissions === null) {
+                return [];
+            }
+            return Object.entries(permissions)
+                .filter(([, value]) => value === true)
+                .map(([key]) => key);
+        }
+        catch {
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/api/client.js.map

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

package/dist/api/policy.d.ts

@@ -0,0 +1,52 @@
+import type { AllowLevel } from '../config/config.js';
+import type { AdminIdentity } from './auth.js';
+import type { Operation } from './types.js';
+/** Результат проверки политики перед выполнением операции. */
+export type PolicyDecision = {
+    kind: 'allow';
+} | {
+    kind: 'deny';
+    reason: string;
+} | {
+    kind: 'needsConfirm';
+    reason: string;
+};
+/**
+ * Одноразовые токены подтверждения для необратимых операций.
+ * Токен привязан к хэшу (opId + аргументы), поэтому подтверждение одного удаления
+ * нельзя переиспользовать для другого — иначе двухшаговость была бы декоративной.
+ */
+export declare class ConfirmStore {
+    private readonly issued;
+    private static hash;
+    issue(opId: string, args: unknown, now?: number): string;
+    /**
+     * Проверяет токен, не гася его.
+     * Нужна, чтобы отказ по другой причине (нет права, не тот уровень allow)
+     * не сжигал подтверждение, которое человек уже дал.
+     */
+    verify(token: string, opId: string, args: unknown, now?: number): boolean;
+    /** Проверяет и немедленно гасит токен. Повторное использование невозможно. */
+    consume(token: string, opId: string, args: unknown, now?: number): boolean;
+    private sweep;
+}
+/**
+ * Проверяет только уровень `--allow`.
+ * Вынесено отдельно, чтобы вызывающий мог отказать до аутентификации:
+ * обещание «no request was sent» не должно нарушаться самим логином.
+ */
+export declare const checkLevel: (operation: Operation, allow: AllowLevel) => Extract<PolicyDecision, {
+    kind: "deny";
+}> | undefined;
+/**
+ * Решает, можно ли выполнить операцию.
+ * Порядок проверок значим: уровень доступа — до прав, права — до подтверждения,
+ * чтобы read-only сервер вообще не выдавал токенов подтверждения.
+ */
+export declare const decide: (params: {
+    operation: Operation;
+    allow: AllowLevel;
+    identity?: AdminIdentity;
+    confirmValid: boolean;
+}) => PolicyDecision;
+//# sourceMappingURL=policy.d.ts.map

package/dist/api/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/api/policy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAI5C,8DAA8D;AAC9D,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAO7C;;;;GAIG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0D;IAEjF,OAAO,CAAC,MAAM,CAAC,IAAI;IAMnB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,SAAa,GAAG,MAAM;IAU5D;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,SAAa,GAAG,OAAO;IAS7E,8EAA8E;IAC9E,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,SAAa,GAAG,OAAO;IAU9E,OAAO,CAAC,KAAK;CAOd;AAED;;;;GAIG;AACH,eAAO,MAAM,UAAU,GACrB,WAAW,SAAS,EACpB,OAAO,UAAU,KAChB,OAAO,CAAC,cAAc,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,SAY9C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,MAAM,GAAI,QAAQ;IAC7B,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;CACvB,KAAG,cAoCH,CAAC"}

package/dist/api/policy.js.map

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

package/dist/api/shape.d.ts

@@ -0,0 +1,19 @@
+/** Результат подготовки ответа к отдаче модели. */
+export interface ShapedResponse {
+    body: unknown;
+    truncated: boolean;
+}
+/**
+ * Приводит ответ Admin API к размеру, пригодному для контекста модели.
+ * Массивы урезаются по элементам (а не обрывом JSON), поэтому результат
+ * остаётся валидным и самоописанным: агент видит `_truncated` и сужает запрос.
+ */
+export declare const shapeResponse: (raw: unknown, maxBytes: number) => ShapedResponse;
+/**
+ * Сжимает текущее состояние цели до размера, который не топит ответ dry-run.
+ * Целиком отдаётся только небольшая цель: для создания в коллекции «цель» — это весь
+ * список существующих объектов, а он бывает в сотни килобайт и вытесняет собой
+ * единственно нужные части плана — политику и собранный запрос.
+ */
+export declare const summarizeTarget: (target: unknown) => unknown;
+//# sourceMappingURL=shape.d.ts.map

package/dist/api/shape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape.d.ts","sourceRoot":"","sources":["../../src/api/shape.ts"],"names":[],"mappings":"AA+BA,mDAAmD;AACnD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,OAAO,EAAE,UAAU,MAAM,KAAG,cA0D9D,CAAC;AAiBF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,OAAO,KAAG,OAmCjD,CAAC"}

package/dist/api/shape.js

@@ -0,0 +1,151 @@
+/** Поля, значения которых бесполезны модели и раздувают ответ. */
+const BLOB_KEYS = new Set(['base64', 'buffer', 'content', 'fileContent', 'data64', 'blob']);
+const BLOB_VALUE_LIMIT = 512;
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+/** Похоже ли строковое значение на base64-блоб, который незачем показывать. */
+const looksLikeBlob = (key, value) => typeof value === 'string' &&
+    value.length > BLOB_VALUE_LIMIT &&
+    (BLOB_KEYS.has(key) || /^data:|^[A-Za-z0-9+/=]{512,}$/.test(value));
+/** Рекурсивно заменяет блобы заглушкой с указанием исходного размера. */
+const stripBlobs = (value, key = '') => {
+    if (looksLikeBlob(key, value)) {
+        return `[stripped ${String(value.length)} chars]`;
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => stripBlobs(item));
+    }
+    if (isRecord(value)) {
+        const out = {};
+        for (const [k, v] of Object.entries(value)) {
+            out[k] = stripBlobs(v, k);
+        }
+        return out;
+    }
+    return value;
+};
+/**
+ * Приводит ответ Admin API к размеру, пригодному для контекста модели.
+ * Массивы урезаются по элементам (а не обрывом JSON), поэтому результат
+ * остаётся валидным и самоописанным: агент видит `_truncated` и сужает запрос.
+ */
+export const shapeResponse = (raw, maxBytes) => {
+    const cleaned = stripBlobs(raw);
+    const size = (value) => Buffer.byteLength(JSON.stringify(value) ?? '', 'utf8');
+    if (size(cleaned) <= maxBytes) {
+        return { body: cleaned, truncated: false };
+    }
+    /** Массив верхнего уровня: оставляем префикс элементов. */
+    if (Array.isArray(cleaned)) {
+        const kept = takePrefix(cleaned, maxBytes);
+        return {
+            body: {
+                items: kept,
+                _truncated: {
+                    shown: kept.length,
+                    total: cleaned.length,
+                    hint: 'Narrow the result with the operation\'s own limit/offset/filter parameters.',
+                },
+            },
+            truncated: true,
+        };
+    }
+    /** Пагинированный объект: урезаем самый большой массив внутри него. */
+    if (isRecord(cleaned)) {
+        const arrayKey = Object.entries(cleaned)
+            .filter(([, value]) => Array.isArray(value))
+            .sort((a, b) => size(b[1]) - size(a[1]))[0]?.[0];
+        if (arrayKey) {
+            const items = cleaned[arrayKey];
+            const overhead = size({ ...cleaned, [arrayKey]: [] });
+            const kept = takePrefix(items, Math.max(maxBytes - overhead, 256));
+            return {
+                body: {
+                    ...cleaned,
+                    [arrayKey]: kept,
+                    _truncated: {
+                        key: arrayKey,
+                        shown: kept.length,
+                        total: items.length,
+                        hint: 'Narrow the result with the operation\'s own limit/offset/filter parameters.',
+                    },
+                },
+                truncated: true,
+            };
+        }
+    }
+    return {
+        body: {
+            _truncated: {
+                hint: `Response exceeded ${String(maxBytes)} bytes and is not a list; request a narrower projection.`,
+                preview: JSON.stringify(cleaned).slice(0, maxBytes),
+            },
+        },
+        truncated: true,
+    };
+};
+/** Бюджет на показ текущего состояния цели в плане dry-run и в запросе подтверждения. */
+const TARGET_LIMIT = 4_000;
+/** Сколько идентификаторов списка показывать в сводке. */
+const TARGET_ID_SAMPLE = 20;
+/** Собирает опознавательные значения элементов списка: id, если он есть, иначе сам элемент. */
+const identify = (items) => items.slice(0, TARGET_ID_SAMPLE).map((item) => {
+    if (!isRecord(item)) {
+        return item;
+    }
+    const id = item['id'] ?? item['identifier'] ?? item['marker'];
+    return id ?? Object.keys(item).slice(0, 3);
+});
+/**
+ * Сжимает текущее состояние цели до размера, который не топит ответ dry-run.
+ * Целиком отдаётся только небольшая цель: для создания в коллекции «цель» — это весь
+ * список существующих объектов, а он бывает в сотни килобайт и вытесняет собой
+ * единственно нужные части плана — политику и собранный запрос.
+ */
+export const summarizeTarget = (target) => {
+    if (target === undefined || target === null) {
+        return null;
+    }
+    const size = (value) => Buffer.byteLength(JSON.stringify(value) ?? '', 'utf8');
+    if (size(target) <= TARGET_LIMIT) {
+        return target;
+    }
+    const hint = 'Summarised: read the target in full with a separate GET if you need it.';
+    if (Array.isArray(target)) {
+        return { _summary: { kind: 'list', count: target.length, ids: identify(target), hint } };
+    }
+    if (isRecord(target)) {
+        const compacted = {};
+        for (const [key, value] of Object.entries(target)) {
+            compacted[key] = Array.isArray(value)
+                ? { _summary: { kind: 'list', count: value.length, ids: identify(value) } }
+                : value;
+        }
+        if (size(compacted) <= TARGET_LIMIT) {
+            return { ...compacted, _summary: { hint } };
+        }
+        return {
+            _summary: {
+                kind: 'object',
+                keys: Object.keys(target),
+                ...(target['id'] !== undefined ? { id: target['id'] } : {}),
+                hint,
+            },
+        };
+    }
+    return { _summary: { kind: 'value', preview: String(target).slice(0, 200), hint } };
+};
+/** Берёт максимальный префикс массива, укладывающийся в бюджет байтов. */
+const takePrefix = (items, maxBytes) => {
+    const kept = [];
+    let used = 2;
+    for (const item of items) {
+        const chunk = Buffer.byteLength(JSON.stringify(item) ?? 'null', 'utf8') + 1;
+        if (used + chunk > maxBytes) {
+            break;
+        }
+        kept.push(item);
+        used += chunk;
+    }
+    return kept;
+};
+//# sourceMappingURL=shape.js.map

package/dist/api/shape.js.map

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

package/dist/api/types.d.ts

@@ -0,0 +1,85 @@
+/** HTTP-методы, встречающиеся в Admin API. */
+export type HttpMethod = 'get' | 'post' | 'put' | 'patch' | 'delete';
+/**
+ * Класс риска операции. Определяется на сборке каталога, а не в рантайме,
+ * чтобы политику доступа нельзя было обойти хитрым аргументом.
+ */
+export type RiskLevel = 'read' | 'write' | 'destructive';
+/** Параметр операции (path / query / header). */
+export interface OperationParam {
+    name: string;
+    location: 'path' | 'query' | 'header';
+    required: boolean;
+    description?: string;
+    /** Нормализованная JSON-схема параметра. */
+    schema: JsonSchema;
+    example?: unknown;
+}
+/**
+ * Нормализованная JSON-схема. Swagger проекта содержит 311 TypeScript-подобных
+ * значений `type` (`Record<string, any>`, `CommonLocalizeInfos`, `image`…),
+ * поэтому «схема» здесь — результат приведения, а не исходник.
+ */
+export interface JsonSchema {
+    type?: string;
+    format?: string;
+    description?: string;
+    example?: unknown;
+    enum?: unknown[];
+    items?: JsonSchema;
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    /** Тип не удалось привести к JSON Schema: доверять следует `example`. */
+    'x-loose'?: boolean;
+    /** Исходный TypeScript-подобный тип из swagger — сохранён как подсказка. */
+    'x-source-type'?: string;
+    /** Схема была урезана по размеру. */
+    'x-truncated'?: boolean;
+}
+/** Одна операция Admin API в каталоге. */
+export interface Operation {
+    /** `operationId` из swagger, например `AdminPagesController_findAllRoot`. */
+    opId: string;
+    method: HttpMethod;
+    /** Путь без префикса API, например `/pages/{id}`. */
+    path: string;
+    /** Полный путь как в swagger, например `/api/admin/pages/{id}`. */
+    fullPath: string;
+    tag: string;
+    summary: string;
+    /** Требуемое право из `AdminPermissionsEnum`, если объявлено в контроллере. */
+    permission?: string;
+    risk: RiskLevel;
+    /** Операция навсегда остаётся за подтверждением, независимо от уровня allow. */
+    alwaysConfirm: boolean;
+    params: OperationParam[];
+    body?: {
+        contentType: string;
+        schema: JsonSchema;
+        required: boolean;
+    };
+    responseSummary?: string;
+    /** Идентификаторы разделов документации (`<docId>#<anchor>`), объясняющих операцию. */
+    docLinks: string[];
+    /** Склеенный текст для поиска по каталогу. */
+    searchText: string;
+}
+/** Собранный каталог: то, что build-catalog.ts пишет в data/catalog.json. */
+export interface Catalog {
+    version: 1;
+    builtAt: string;
+    /** Префикс путей из swagger (`/api/admin`) — проверяется при сборке. */
+    apiPrefix: string;
+    /** Хэш исходного swagger.json — виден в cms_whoami, ловит рассинхрон. */
+    swaggerHash: string;
+    /** Полный список значений `AdminPermissionsEnum`. */
+    permissions: string[];
+    /**
+     * Замечания сборки — прежде всего признаки устаревшего swagger.json.
+     * Показываются в `cms_whoami`: рассинхрон каталога и реального API должен быть
+     * виден агенту, а не выясняться по 404.
+     */
+    warnings: string[];
+    operations: Operation[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/api/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErE;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,aAAa,CAAC;AAEzD,iDAAiD;AACjD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IACtC,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,yEAAyE;IACzE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,4EAA4E;IAC5E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qCAAqC;IACrC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,0CAA0C;AAC1C,MAAM,WAAW,SAAS;IACxB,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,gFAAgF;IAChF,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,IAAI,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,UAAU,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;IACtE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uFAAuF;IACvF,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,6EAA6E;AAC7E,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB"}

package/dist/api/types.js

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

package/dist/api/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":""}

package/dist/bin/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/bin/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/bin/cli.ts"],"names":[],"mappings":""}

package/dist/bin/cli.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+import { loadConfig } from '../config/config.js';
+import { runHttp } from '../transports/http.js';
+import { runStdio } from '../transports/stdio.js';
+const USAGE = `oneentry-mcp-platform — MCP server for the OneEntry CMS Admin API
+
+  oneentry-mcp-platform                        local mode (stdio), reads http://localhost:3003/api/admin
+  oneentry-mcp-platform --http --audit a.jsonl remote mode (streamable HTTP)
+
+Options
+  --base-url <url>        Admin API base URL (must contain /api/admin)
+  --allow <level>         read (default) | write | destructive
+  --login <login>         admin login; the password comes from ONEENTRY_CMS_PASSWORD
+  --back <path>           backend-app checkout: read knowledge live instead of the bundled snapshot
+  --front <path>          frontend-app checkout
+  --audit <path>          JSONL audit log (required in remote mode)
+  --http                  serve Streamable HTTP instead of stdio
+  --port <n>              HTTP port, default 8931
+  --host <addr>           HTTP bind address, default 127.0.0.1
+  --allowed-origins a,b   comma-separated Origin allowlist for remote mode
+  --request-timeout <ms>  per-request timeout, default 30000
+  --max-response-bytes <n> response cap handed to the model, default 24576
+
+Environment
+  ONEENTRY_CMS_LOGIN, ONEENTRY_CMS_PASSWORD, ONEENTRY_CMS_TOKEN, ONEENTRY_CMS_BASE_URL, ONEENTRY_MCP_ALLOW,
+  ONEENTRY_MCP_BACK_PATH, ONEENTRY_MCP_FRONT_PATH, ONEENTRY_MCP_AUDIT_PATH, ONEENTRY_MCP_PORT, ONEENTRY_MCP_HOST
+`;
+const main = async () => {
+    const argv = process.argv.slice(2);
+    if (argv.includes('--help') || argv.includes('-h')) {
+        process.stdout.write(USAGE);
+        return;
+    }
+    const config = loadConfig(argv);
+    if (config.mode === 'remote') {
+        await runHttp(config);
+        return;
+    }
+    await runStdio(config);
+};
+main().catch((error) => {
+    /**
+     * В stdio-режиме stdout занят протоколом, поэтому любая диагностика идёт в stderr.
+     */
+    process.stderr.write(`oneentry-mcp-platform: ${error instanceof Error ? error.message : String(error)}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/bin/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/bin/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;;;;;;;CAsBb,CAAC;AAEF,MAAM,IAAI,GAAG,KAAK,IAAmB,EAAE;IACrC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5B,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;QACtB,OAAO;IACT,CAAC;IACD,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC;AACzB,CAAC,CAAC;AAEF,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3G,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}