@oneentry/mcp-platform-server 0.1.1 → 0.1.4

package/dist/api/catalog.d.ts

@@ -1,7 +1,6 @@
 import type { Config } from '../config/config.js';
 import { type PermissionMap } from './build-catalog.js';
 import type { Catalog, Operation } from './types.js';
-/** Найденная операция с оценкой релевантности. */
 export interface OperationHit {
     opId: string;
     method: string;
@@ -12,40 +11,20 @@ export interface OperationHit {
     risk: Operation['risk'];
     score: number;
 }
-/**
- * Индекс каталога операций.
- * Поиск здесь примитивный — подсчёт совпадений термов по склеенной строке.
- * Это осознанно: путей 478, они короткие и хорошо самоописаны,
- * полнотекстовый движок дал бы ту же выдачу при большем весе.
- */
+export interface StartupAuth {
+    bearer?: string;
+    error?: string;
+}
 export declare class OperationCatalog {
     private byOpId;
     catalog: Catalog;
     constructor(catalog: Catalog);
-    /** Карта прав — единственное, что осталось предсобранным: её нет в swagger. */
     static permissionMap(): PermissionMap;
-    /**
-     * Строит каталог из swagger подключённого стенда.
-     * Недоступный стенд не мешает серверу подняться: каталог получается пустым,
-     * а причина уходит в `warnings` и оттуда в `cms_guide` и `cms_whoami`.
-     * Пустой каталог безопасен — вызвать по нему нечего, — но молчать о нём нельзя.
-     */
-    static resolve(config: Config, bearer?: string): Promise<OperationCatalog>;
-    /** Каталог не удалось собрать при старте — стенд был недоступен или закрыт авторизацией. */
+    static resolve(config: Config, auth?: StartupAuth): Promise<OperationCatalog>;
     get isEmpty(): boolean;
-    /**
-     * Заменяет содержимое каталога, собранного вхолостую.
-     * Нужно remote-режиму: процесс поднимается без учётных данных, и если стенд
-     * отдаёт swagger только авторизованным, единственный шанс получить каталог —
-     * первая сессия с токеном. Каталог общий на процесс, поэтому и подмена одна.
-     */
     adopt(other: OperationCatalog): void;
     get(opId: string): Operation | undefined;
     operations(): readonly Operation[];
-    /**
-     * Подсказывает похожие `opId` — нужна для внятной ошибки, когда модель
-     * угадала имя операции вместо того, чтобы взять его из поиска.
-     */
     suggest(opId: string, limit?: number): string[];
     search(params: {
         query: string;
@@ -55,4 +34,3 @@ export declare class OperationCatalog {
         limit?: number;
     }): OperationHit[];
 }
-//# sourceMappingURL=catalog.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/api/catalog.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEtE,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAErD,kDAAkD;AAClD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,EAAE,OAAO,CAAC;gBAEL,OAAO,EAAE,OAAO;IAS5B,+EAA+E;IAC/E,MAAM,CAAC,aAAa,IAAI,aAAa;IAMrC;;;;;OAKG;WACU,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA2ChF,4FAA4F;IAC5F,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;;;;OAKG;IACH,KAAK,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAKpC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAIxC,UAAU,IAAI,SAAS,SAAS,EAAE;IAIlC;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,EAAE;IAU1C,MAAM,CAAC,MAAM,EAAE;QACb,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,YAAY,EAAE;CA+CnB"}
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/api/catalog.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAErD,kDAAkD;AAClD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;gBAEd,OAAO,EAAE,OAAO;IAS5B,MAAM,CAAC,IAAI,IAAI,gBAAgB;IAK/B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAIxC,UAAU,IAAI,SAAS,SAAS,EAAE;IAIlC;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,EAAE;IAU1C,MAAM,CAAC,MAAM,EAAE;QACb,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,YAAY,EAAE;CA+CnB"}

package/dist/api/catalog.js

@@ -2,13 +2,25 @@ import { readFileSync } from 'node:fs';
 import { resolve } from 'node:path';
 import { dataDir } from '../knowledge/loader.js';
 import { buildCatalog } from './build-catalog.js';
-import { fetchSwagger } from './swagger-source.js';
-/**
- * Индекс каталога операций.
- * Поиск здесь примитивный — подсчёт совпадений термов по склеенной строке.
- * Это осознанно: путей 478, они короткие и хорошо самоописаны,
- * полнотекстовый движок дал бы ту же выдачу при большем весе.
- */
+import { fetchSwagger, nestSwaggerUrl, nodeSwaggerUrl, } from './swagger-source.js';
+const loginWarning = (error) => `The startup login failed, so the API document was requested without a token: ${error}`;
+const sourceWarnings = (swagger, auth) => {
+    const warnings = [];
+    const why = swagger.failures.length > 0 ? ` (${swagger.failures.join('; ')})` : '';
+    if (swagger.origin === 'cache') {
+        warnings.push(`Neither API document could be read${why}; this catalog came from the on-disk cache ` +
+            'and may not match the API that is actually running.');
+    }
+    if (swagger.origin === 'instance-node') {
+        warnings.push(`${swagger.url} serves only the operations whitelisted for the workflow "admin-api" ` +
+            'node, not the whole Admin API, so this catalog is a small subset of the endpoints ' +
+            `that exist. The complete document was not available${why}.`);
+    }
+    if (auth.error !== undefined) {
+        warnings.push(loginWarning(auth.error));
+    }
+    return warnings;
+};
 export class OperationCatalog {
     byOpId;
     catalog;
@@ -16,46 +28,33 @@ export class OperationCatalog {
         if (catalog.version !== 1) {
             throw new Error(`Unsupported catalog version ${String(catalog.version)}`);
         }
-        /** Каталог собирается из документа, полученного по сети: поля нормализуем на входе. */
         this.catalog = { ...catalog, warnings: catalog.warnings ?? [] };
         this.byOpId = new Map(catalog.operations.map((o) => [o.opId, o]));
     }
-    /** Карта прав — единственное, что осталось предсобранным: её нет в swagger. */
     static permissionMap() {
         const file = resolve(dataDir(), 'permissions.json');
         const parsed = JSON.parse(readFileSync(file, 'utf8'));
         return { byOpId: parsed.byOpId, permissions: parsed.permissions };
     }
-    /**
-     * Строит каталог из swagger подключённого стенда.
-     * Недоступный стенд не мешает серверу подняться: каталог получается пустым,
-     * а причина уходит в `warnings` и оттуда в `cms_guide` и `cms_whoami`.
-     * Пустой каталог безопасен — вызвать по нему нечего, — но молчать о нём нельзя.
-     */
-    static async resolve(config, bearer) {
+    static async resolve(config, auth = {}) {
         const builtAt = new Date().toISOString();
         try {
             const swagger = await fetchSwagger({
                 baseUrl: config.baseUrl,
                 cacheDir: config.cacheDir,
                 timeoutMs: config.requestTimeoutMs,
-                ...(bearer ? { bearer } : {}),
+                ...(auth.bearer ? { bearer: auth.bearer } : {}),
             });
             const catalog = buildCatalog({
                 rawSwagger: swagger.raw,
                 permissions: OperationCatalog.permissionMap(),
                 builtAt,
+                sourceUrl: swagger.url,
+            });
+            return new OperationCatalog({
+                ...catalog,
+                warnings: [...catalog.warnings, ...sourceWarnings(swagger, auth)],
             });
-            return new OperationCatalog(swagger.origin === 'cache'
-                ? {
-                    ...catalog,
-                    warnings: [
-                        ...catalog.warnings,
-                        `The stand at ${config.baseUrl} was unreachable; this catalog came from the ` +
-                            'on-disk cache and may not match the API that is actually running.',
-                    ],
-                }
-                : catalog);
         }
         catch (error) {
             return new OperationCatalog({
@@ -65,24 +64,19 @@ export class OperationCatalog {
                 swaggerHash: '',
                 permissions: [],
                 warnings: [
-                    `The operation catalog is EMPTY: ${config.baseUrl} did not serve its swagger ` +
-                        `(${error instanceof Error ? error.message : String(error)}). ` +
-                        'No API operation can be searched or called until the stand is reachable.',
+                    `The operation catalog is EMPTY: ${error instanceof Error ? error.message : String(error)}. ` +
+                        'No API operation can be searched or called until either ' +
+                        `${nestSwaggerUrl(config.baseUrl)} or ${nodeSwaggerUrl(config.baseUrl)} ` +
+                        'answers 200 with an OpenAPI document.',
+                    ...(auth.error === undefined ? [] : [loginWarning(auth.error)]),
                 ],
                 operations: [],
             });
         }
     }
-    /** Каталог не удалось собрать при старте — стенд был недоступен или закрыт авторизацией. */
     get isEmpty() {
         return this.catalog.operations.length === 0;
     }
-    /**
-     * Заменяет содержимое каталога, собранного вхолостую.
-     * Нужно remote-режиму: процесс поднимается без учётных данных, и если стенд
-     * отдаёт swagger только авторизованным, единственный шанс получить каталог —
-     * первая сессия с токеном. Каталог общий на процесс, поэтому и подмена одна.
-     */
     adopt(other) {
         this.catalog = other.catalog;
         this.byOpId = new Map(other.catalog.operations.map((o) => [o.opId, o]));
@@ -93,10 +87,6 @@ export class OperationCatalog {
     operations() {
         return this.catalog.operations;
     }
-    /**
-     * Подсказывает похожие `opId` — нужна для внятной ошибки, когда модель
-     * угадала имя операции вместо того, чтобы взять его из поиска.
-     */
     suggest(opId, limit = 5) {
         const needle = opId.toLowerCase();
         return this.catalog.operations
@@ -151,7 +141,6 @@ export class OperationCatalog {
         return hits.slice(0, params.limit ?? 15);
     }
 }
-/** Доля общих триграмм — грубая, но достаточная мера похожести имён операций. */
 const overlap = (a, b) => {
     const grams = (value) => {
         const out = new Set();
@@ -170,4 +159,3 @@ const overlap = (a, b) => {
     }
     return right.size === 0 ? 0 : shared / right.size;
 };
-//# sourceMappingURL=catalog.js.map

package/dist/api/catalog.js.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/api/catalog.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/api/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAejD;;;;;GAKG;AACH,MAAM,OAAO,gBAAgB;IACV,MAAM,CAAyB;IACvC,OAAO,CAAU;IAE1B,YAAY,OAAgB;QAC1B,IAAI,OAAO,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,+BAA+B,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC5E,CAAC;QACD,mFAAmF;QACnF,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QAChE,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,CAAC,IAAI;QACT,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,cAAc,CAAC,CAAC;QAChD,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAY,CAAC,CAAC;IACjF,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;IACjC,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,IAAY,EAAE,KAAK,GAAG,CAAC;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU;aAC3B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;aAC5E,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;aAClC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;aACjC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;aACf,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,MAAM,CAAC,MAMN;QACC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK;aACvB,WAAW,EAAE;aACb,KAAK,CAAC,SAAS,CAAC;aAChB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAmB,EAAE,CAAC;QAEhC,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;YAChD,IAAI,MAAM,CAAC,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC;gBAC3E,SAAS;YACX,CAAC;YACD,IAAI,MAAM,CAAC,MAAM,IAAI,SAAS,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;gBACtE,SAAS;YACX,CAAC;YACD,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,SAAS,CAAC,IAAI,KAAK,MAAM,CAAC,EAAE,CAAC;gBACrF,SAAS;YACX,CAAC;YAED,IAAI,KAAK,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACvC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;oBAChD,KAAK,IAAI,CAAC,CAAC;gBACb,CAAC;gBACD,IAAI,SAAS,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC/C,KAAK,IAAI,CAAC,CAAC;gBACb,CAAC;gBACD,IAAI,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;oBACxC,KAAK,IAAI,CAAC,CAAC;gBACb,CAAC;YACH,CAAC;YACD,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBACd,IAAI,CAAC,IAAI,CAAC;oBACR,IAAI,EAAE,SAAS,CAAC,IAAI;oBACpB,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,WAAW,EAAE;oBACtC,IAAI,EAAE,SAAS,CAAC,IAAI;oBACpB,GAAG,EAAE,SAAS,CAAC,GAAG;oBAClB,OAAO,EAAE,SAAS,CAAC,OAAO;oBAC1B,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACrE,IAAI,EAAE,SAAS,CAAC,IAAI;oBACpB,KAAK;iBACN,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;CACF;AAED,iFAAiF;AACjF,MAAM,OAAO,GAAG,CAAC,CAAS,EAAE,CAAS,EAAU,EAAE;IAC/C,MAAM,KAAK,GAAG,CAAC,KAAa,EAAe,EAAE;QAC3C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;QAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3C,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;IACF,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACtB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACnB,MAAM,IAAI,CAAC,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC;AACpD,CAAC,CAAC"}

package/dist/api/client.d.ts

@@ -1,18 +1,15 @@
 import type { TokenStore } from './auth.js';
 import type { Operation } from './types.js';
-/** Аргументы вызова операции, как их присылает модель. */
 export interface CallArgs {
     path?: Record<string, string | number>;
     query?: Record<string, string | number | boolean>;
     body?: unknown;
 }
-/** Нормализованный неуспех вызова. */
 export interface NormalizedError {
     status: number;
     message: string;
     hint?: string;
 }
-/** Результат вызова: либо тело ответа, либо нормализованная ошибка. */
 export type CallResult = {
     ok: true;
     status: number;
@@ -21,29 +18,10 @@ export type CallResult = {
     ok: false;
     error: NormalizedError;
 };
-/** Ошибка на стороне вызывающего — до отправки запроса. */
 export declare class RequestBuildError extends Error {
 }
-/**
- * Возвращает тело в том виде, в каком его надо сериализовать в запрос.
- * Часть MCP-клиентов передаёт объектный аргумент уже сериализованным в строку;
- * без этой нормализации `JSON.stringify` завернул бы его второй раз, и на сервер
- * ушла бы JSON-строка вместо объекта — любая запись падала бы с невнятным 400.
- * Разворачивается только строка, которая целиком является объектом или массивом:
- * скалярная строка — законное тело, и трогать её нельзя.
- */
 export declare const normalizeBody: (body: unknown) => unknown;
-/**
- * Подставляет path-параметры и собирает query-строку.
- * Отсутствующий обязательный path-параметр — ошибка здесь, а не 404 от сервера:
- * иначе агент получает загадочный ответ вместо указания, чего не хватает.
- */
 export declare const buildUrl: (baseUrl: string, operation: Operation, args: CallArgs) => string;
-/**
- * HTTP-клиент Admin API.
- * Единственный ретрай — на 401 после обновления токена: любой другой повтор
- * на изменяющей операции рискует создать дубль, поэтому его здесь нет.
- */
 export declare class AdminApiClient {
     private readonly baseUrl;
     private readonly tokens;
@@ -54,7 +32,5 @@ export declare class AdminApiClient {
         timeoutMs: number;
     });
     call(operation: Operation, args: CallArgs): Promise<CallResult>;
-    /** Читает набор прав админа. Пустой массив означает «не удалось выяснить». */
     fetchPermissions(adminId: number): Promise<string[]>;
 }
-//# sourceMappingURL=client.d.ts.map

package/dist/api/client.js

@@ -1,14 +1,5 @@
-/** Ошибка на стороне вызывающего — до отправки запроса. */
 export class RequestBuildError extends Error {
 }
-/**
- * Возвращает тело в том виде, в каком его надо сериализовать в запрос.
- * Часть MCP-клиентов передаёт объектный аргумент уже сериализованным в строку;
- * без этой нормализации `JSON.stringify` завернул бы его второй раз, и на сервер
- * ушла бы JSON-строка вместо объекта — любая запись падала бы с невнятным 400.
- * Разворачивается только строка, которая целиком является объектом или массивом:
- * скалярная строка — законное тело, и трогать её нельзя.
- */
 export const normalizeBody = (body) => {
     if (typeof body !== 'string') {
         return body;
@@ -25,11 +16,6 @@ export const normalizeBody = (body) => {
         return body;
     }
 };
-/**
- * Подставляет path-параметры и собирает query-строку.
- * Отсутствующий обязательный path-параметр — ошибка здесь, а не 404 от сервера:
- * иначе агент получает загадочный ответ вместо указания, чего не хватает.
- */
 export const buildUrl = (baseUrl, operation, args) => {
     let path = operation.path;
     const provided = args.path ?? {};
@@ -47,7 +33,7 @@ export const buildUrl = (baseUrl, operation, args) => {
     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.');
+            'declared in the catalog — the cached API document may be stale.');
     }
     const search = new URLSearchParams();
     for (const [key, value] of Object.entries(args.query ?? {})) {
@@ -58,23 +44,22 @@ export const buildUrl = (baseUrl, operation, args) => {
     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.`);
+            'Search the knowledge base with cms_docs_search 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).';
+            : 'Forbidden. Check the admin\'s permissions and the module visibility rules.';
     }
     if (status === 404) {
-        return 'Not found. The id may belong to another stand — prefer marker-based operations where they exist.';
+        return 'Not found. The id may belong to another instance — prefer marker-based operations where they exist.';
     }
     if (status >= 500) {
-        return 'Server-side failure. Check the dnk-back logs; do not retry blindly.';
+        return 'Server-side failure on the instance. Report it to your operator; do not retry blindly.';
     }
     return undefined;
 };
@@ -105,11 +90,6 @@ const extractMessage = (body, fallback) => {
     }
     return fallback;
 };
-/**
- * HTTP-клиент Admin API.
- * Единственный ретрай — на 401 после обновления токена: любой другой повтор
- * на изменяющей операции рискует создать дубль, поэтому его здесь нет.
- */
 export class AdminApiClient {
     baseUrl;
     tokens;
@@ -148,7 +128,7 @@ export class AdminApiClient {
                 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.',
+                    hint: 'Is the instance reachable at the configured base URL? It must expose the Admin API under /api/admin.',
                 },
             };
         }
@@ -166,7 +146,6 @@ export class AdminApiClient {
         }
         return { ok: true, status: response.status, body };
     }
-    /** Читает набор прав админа. Пустой массив означает «не удалось выяснить». */
     async fetchPermissions(adminId) {
         try {
             const token = await this.tokens.accessToken();
@@ -193,4 +172,3 @@ export class AdminApiClient {
         }
     }
 }
-//# sourceMappingURL=client.js.map

package/dist/api/normalize-schema.d.ts

@@ -1,14 +1,3 @@
 import type { JsonSchema } from './types.js';
-/**
- * Разворачивает `$ref` и нормализует типы за один проход.
- * Циклы (а они есть: сущности ссылаются друг на друга) обрываются заглушкой,
- * иначе разворачивание не завершится; глубина ограничена, чтобы схема осталась читаемой.
- */
 export declare const normalizeSchema: (node: unknown, components: Record<string, unknown>, depth?: number, refStack?: readonly string[]) => JsonSchema;
-/**
- * Урезает слишком большую схему до верхнего уровня свойств.
- * Схема тела запроса уходит прямо в контекст модели, и развёрнутый DTO
- * на 40 КБ вытеснит из него саму задачу.
- */
 export declare const capSchema: (schema: JsonSchema) => JsonSchema;
-//# sourceMappingURL=normalize-schema.d.ts.map

package/dist/api/normalize-schema.js

@@ -1,10 +1,4 @@
-/** Валидные типы JSON Schema. Всё остальное в этом swagger — TypeScript-выражения. */
 const VALID_TYPES = new Set(['object', 'array', 'string', 'number', 'integer', 'boolean', 'null']);
-/**
- * Приведение TypeScript-подобных типов из swagger к JSON Schema.
- * Проект генерирует схемы из декораторов NestJS, и `type` часто содержит
- * TS-выражение; таблица покрывает частые случаи, остальное помечается x-loose.
- */
 const TYPE_MAP = {
     date: { type: 'string', format: 'date-time' },
     Date: { type: 'string', format: 'date-time' },
@@ -30,11 +24,6 @@ const trimDescription = (value) => {
     return flat.length > MAX_DESCRIPTION ? `${flat.slice(0, MAX_DESCRIPTION)}…` : flat;
 };
 const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
-/**
- * Разворачивает `$ref` и нормализует типы за один проход.
- * Циклы (а они есть: сущности ссылаются друг на друга) обрываются заглушкой,
- * иначе разворачивание не завершится; глубина ограничена, чтобы схема осталась читаемой.
- */
 export const normalizeSchema = (node, components, depth = 0, refStack = []) => {
     if (!isRecord(node)) {
         return {};
@@ -51,7 +40,6 @@ export const normalizeSchema = (node, components, depth = 0, refStack = []) => {
         }
         return normalizeSchema(target, components, depth, [...refStack, name]);
     }
-    /** allOf/oneOf/anyOf в этом swagger встречаются только как обёртки — берём первый член. */
     for (const key of ['allOf', 'oneOf', 'anyOf']) {
         const variants = node[key];
         if (Array.isArray(variants) && variants.length > 0) {
@@ -123,11 +111,6 @@ export const normalizeSchema = (node, components, depth = 0, refStack = []) => {
     return out;
 };
 const MAX_SCHEMA_BYTES = 6_144;
-/**
- * Урезает слишком большую схему до верхнего уровня свойств.
- * Схема тела запроса уходит прямо в контекст модели, и развёрнутый DTO
- * на 40 КБ вытеснит из него саму задачу.
- */
 export const capSchema = (schema) => {
     if (Buffer.byteLength(JSON.stringify(schema), 'utf8') <= MAX_SCHEMA_BYTES) {
         return schema;
@@ -148,4 +131,3 @@ export const capSchema = (schema) => {
     }
     return { ...schema, properties: shallow, 'x-truncated': true };
 };
-//# sourceMappingURL=normalize-schema.js.map

package/dist/api/policy.d.ts

@@ -1,7 +1,6 @@
 import type { AllowLevel } from '../config/config.js';
 import type { AdminIdentity } from './auth.js';
 import type { Operation } from './types.js';
-/** Результат проверки политики перед выполнением операции. */
 export type PolicyDecision = {
     kind: 'allow';
 } | {
@@ -11,42 +10,20 @@ export type PolicyDecision = {
     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/shape.d.ts

@@ -1,19 +1,6 @@
-/** Результат подготовки ответа к отдаче модели. */
 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.js

@@ -1,12 +1,9 @@
-/** Поля, значения которых бесполезны модели и раздувают ответ. */
 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]`;
@@ -23,18 +20,12 @@ const stripBlobs = (value, key = '') => {
     }
     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 {
@@ -49,7 +40,6 @@ export const shapeResponse = (raw, maxBytes) => {
             truncated: true,
         };
     }
-    /** Пагинированный объект: урезаем самый большой массив внутри него. */
     if (isRecord(cleaned)) {
         const arrayKey = Object.entries(cleaned)
             .filter(([, value]) => Array.isArray(value))
@@ -83,11 +73,8 @@ export const shapeResponse = (raw, 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;
@@ -95,12 +82,6 @@ const identify = (items) => items.slice(0, TARGET_ID_SAMPLE).map((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;
@@ -134,7 +115,6 @@ export const summarizeTarget = (target) => {
     }
     return { _summary: { kind: 'value', preview: String(target).slice(0, 200), hint } };
 };
-/** Берёт максимальный префикс массива, укладывающийся в бюджет байтов. */
 const takePrefix = (items, maxBytes) => {
     const kept = [];
     let used = 2;
@@ -148,4 +128,3 @@ const takePrefix = (items, maxBytes) => {
     }
     return kept;
 };
-//# sourceMappingURL=shape.js.map

package/dist/api/swagger-source.d.ts

@@ -1,22 +1,23 @@
-/** Откуда и как забирать swagger. */
+export type SwaggerVariant = 'full' | 'node';
+export interface SwaggerAttempt {
+    variant: SwaggerVariant;
+    url: string;
+    authenticated: boolean;
+}
+export declare const nestSwaggerUrl: (baseUrl: string) => string;
+export declare const nodeSwaggerUrl: (baseUrl: string) => string;
+export declare const swaggerAttempts: (baseUrl: string) => SwaggerAttempt[];
 export interface SwaggerSource {
-    /** Базовый URL Admin API, уже нормализованный (с `/api/admin`, без слэша на конце). */
     baseUrl: string;
     cacheDir: string;
     timeoutMs: number;
-    /** Bearer-токен: нужен, если стенд закрывает этот эндпоинт авторизацией. */
     bearer?: string;
 }
-/** Полученный документ и то, откуда он взялся. */
 export interface FetchedSwagger {
     raw: string;
-    origin: 'stand' | 'cache';
+    origin: 'instance-full' | 'instance-node' | 'cache';
+    url: string;
+    variant: SwaggerVariant;
+    failures: string[];
 }
-/**
- * Забирает swagger со стенда, с откатом на кэш.
- * Эндпоинт публичный на большинстве стендов, поэтому первый запрос идёт без
- * авторизации: в remote-режиме на момент старта процесса учётных данных может
- * не быть вовсе. Токен добавляется только если стенд ответил 401/403.
- */
 export declare const fetchSwagger: (source: SwaggerSource) => Promise<FetchedSwagger>;
-//# sourceMappingURL=swagger-source.d.ts.map