@hubex/mcp 0.5.0 → 0.6.0

package/dist/schema/build-index.js

@@ -53,7 +53,7 @@ function buildEntry(service, method, path, op, doc) {
         service,
         method,
         path,
-        summary: op.summary || op.description || `${method} ${path}`,
+        summary: op.summary || fallbackSummary(op.description) || `${method} ${path}`,
         tags: Array.isArray(op.tags) ? [...op.tags] : [],
         pathParams,
         queryParams,
@@ -61,6 +61,21 @@ function buildEntry(service, method, path, op, doc) {
         bodyRequired: Boolean(bodySchema) && op.requestBody?.required === true,
     };
 }
+/** Максимальная длина summary, собранного из description. */
+const MAX_FALLBACK_SUMMARY = 200;
+/**
+ * Запасной summary из description: описания в swagger — многострочный markdown
+ * с примерами запроса и ответа, а в индексе и выдаче поиска нужна одна строка.
+ * Полный текст остаётся в hubex_describe_endpoint.
+ */
+function fallbackSummary(description) {
+    if (typeof description !== "string")
+        return "";
+    const firstLine = description.split(/\r?\n/, 1)[0].trim();
+    return firstLine.length > MAX_FALLBACK_SUMMARY
+        ? firstLine.slice(0, MAX_FALLBACK_SUMMARY) + "…"
+        : firstLine;
+}
 /** Стабильная сериализация: два прогона дают побайтово одинаковый результат. */
 export function serializeIndex(index) {
     return JSON.stringify(index, null, 2) + "\n";

package/dist/schema/describe.js

@@ -43,6 +43,7 @@ export class SchemaProvider {
             method: entry.method,
             path: entry.path,
             summary: entry.summary,
+            description: typeof op.description === "string" ? op.description : undefined,
             pathParams,
             queryParams,
             body: bodySchema ? deref(bodySchema, doc) : undefined,

package/dist/tools/discovery.js

@@ -134,7 +134,8 @@ function describeEndpoint(deps) {
     return {
         definition: {
             name: "hubex_describe_endpoint",
-            description: "Полная схема параметров и тела для конкретных эндпоинтов. Идентификаторы берутся из hubex_search_*_endpoints " +
+            description: "Полная схема параметров и тела плюс описание операции из swagger (примеры запроса и ответа, негативные " +
+                "сценарии, требуемые права) для конкретных эндпоинтов. Идентификаторы берутся из hubex_search_*_endpoints " +
                 "или из гайда. Вызывай только для тех эндпоинтов, которые собираешься выполнить: схемы объёмные.",
             inputSchema: {
                 type: "object",