@hubex/mcp 0.5.0 → 0.6.0

package/swagger/dev/PROXY.json

@@ -21,7 +21,7 @@
           "Bypass"
         ],
         "summary": "Прокидывает запрос на заданный в теле адрес, применяя к нему дополнительные заголовки по имени домена",
-        "description": "## Пример запроса:\r\n`POST /Bypass`\r\n            \r\n```json\r\n{\r\n  \"url\": \"https://api.example.com/v1/items\",\r\n  \"method\": \"POST\",\r\n  \"headers\": [\r\n    { \"key\": \"Content-Type\", \"value\": \"application/json\" },\r\n    { \"key\": \"Authorization\", \"value\": \"Bearer <token>\" }\r\n  ],\r\n  \"body\": \"eyJuYW1lIjoiZGVtbyJ9\"\r\n}\r\n```\r\n            \r\n## Пример успешного ответа (200):\r\n```json\r\n{\r\n  \"headers\": {\r\n    \"content-type\": [\"application/json; charset=utf-8\"]\r\n  },\r\n  \"content\": \"eyJpZCI6MTIzfQ==\",\r\n  \"statusCode\": 200\r\n}\r\n```\r\nПоле `content` содержит тело ответа, закодированное в Base64.\r\n            \r\n## Негативные сценарии:\r\n- 400 BadRequest: некорректные входные данные, неподдерживаемый метод, отсутствует Content-Type при передаче тела запроса или ошибка выполнения внешнего запроса.\r\n- 401 Unauthorized: отсутствует или некорректен Bearer-токен.",
+        "description": "## Пример запроса:\r\n`POST /Bypass`\r\n            \r\n```json\r\n{\r\n  \"url\": \"https://api.example.com/v1/items\",\r\n  \"method\": \"POST\",\r\n  \"headers\": [\r\n    { \"key\": \"Content-Type\", \"value\": \"application/json\" },\r\n    { \"key\": \"Authorization\", \"value\": \"Bearer <token>\" }\r\n  ],\r\n  \"body\": \"eyJuYW1lIjoiZGVtbyJ9\"\r\n}\r\n```\r\n            \r\n## Пример успешного ответа (200):\r\n```json\r\n{\r\n  \"headers\": {\r\n    \"content-type\": [\"application/json; charset=utf-8\"]\r\n  },\r\n  \"content\": \"eyJpZCI6MTIzfQ==\",\r\n  \"statusCode\": 200\r\n}\r\n```\r\nПоле `content` содержит тело ответа, закодированное в Base64.\r\n            \r\n## Негативные сценарии:\r\n- 400 BadRequest: некорректные входные данные, неподдерживаемый метод, отсутствует Content-Type при передаче тела запроса или ошибка выполнения внешнего запроса.\r\n- 401 Unauthorized: отсутствует или некорректен Bearer-токен.\r\n- 403 Forbidden: пользователь аутентифицирован, но не соответствует политике `TENANT_MEMBER`.",
         "parameters": [
           {
             "name": "X-Application-ID",
@@ -103,7 +103,7 @@
             "description": "Отсутствует или некорректен Bearer-токен."
           },
           "403": {
-            "description": "Forbidden"
+            "description": "Пользователь не соответствует политике TENANT_MEMBER."
           }
         },
         "security": [
@@ -119,7 +119,7 @@
           "NavigateTo"
         ],
         "summary": "Возвращает ссылку на указанное приложение или расширение с одноразовым токеном для авторизации",
-        "description": "## Пример запроса:\r\n`GET /NavigateTo/MainWeb?deepLink=/tasks/123`\r\n            \r\n## Пример успешного ответа (200):\r\n```json\r\n{\r\n  \"url\": \"https://app.hubex.ru/tenant-name/tasks/123?oneTimeLoginToken=abc123&tenantID=1&tenantUrlName=tenant-name\"\r\n}\r\n```\r\n            \r\n## Негативные сценарии:\r\n- 400 BadRequest: указан неизвестный `appCode` или некорректный `deepLink`.\r\n- 401 Unauthorized: отсутствует или некорректен Bearer-токен.",
+        "description": "## Пример запроса:\r\n`GET /NavigateTo/MainWeb?deepLink=/tasks/123`\r\n            \r\nПараметр запроса OpenAPI: только `deepLink` (query). Дополнительные query-параметры запроса,\r\nкроме `deepLink`, при наличии переносятся в итоговый URL в теле ответа.\r\n            \r\n## Пример успешного ответа (200):\r\n```json\r\n{\r\n  \"url\": \"https://app.hubex.ru/tenant-name/tasks/123?oneTimeLoginToken=abc123&tenantID=1&tenantUrlName=tenant-name\"\r\n}\r\n```\r\nПоля `oneTimeLoginToken`, `tenantID` и `tenantUrlName` не являются параметрами этого API:\r\nсервис добавляет их в строку `url` ответа, когда для целевого приложения включена одноразовая авторизация.\r\n            \r\n## Негативные сценарии:\r\n- 400 BadRequest: некорректный `deepLink` или для найденного `appCode` не удалось сформировать URL приложения.\r\n- 401 Unauthorized: отсутствует или некорректен Bearer-токен.\r\n- 403 Forbidden: пользователь аутентифицирован, но не соответствует политике `TENANT_MEMBER`.\r\n- 500 InternalServerError: неизвестный пакетный `appCode` (пакет не найден) — в текущей реализации возможен сбой до проверки URL.",
         "parameters": [
           {
             "name": "appCode",
@@ -187,13 +187,16 @@
             }
           },
           "400": {
-            "description": "Неизвестный код приложения или некорректная ссылка для перехода."
+            "description": "Некорректный deepLink или пустой URL для найденного приложения."
           },
           "401": {
             "description": "Отсутствует или некорректен Bearer-токен."
           },
           "403": {
-            "description": "Forbidden"
+            "description": "Пользователь не соответствует политике TENANT_MEMBER."
+          },
+          "500": {
+            "description": "Неизвестный пакетный appCode приводит к сбою в текущей реализации."
           }
         },
         "security": [
@@ -276,7 +279,7 @@
         "properties": {
           "url": {
             "type": "string",
-            "description": "Полная ссылка для перехода в целевое приложение с параметрами авторизации",
+            "description": "Полная ссылка для перехода в целевое приложение.\r\nПри включённой одноразовой авторизации в query строки URL могут присутствовать\r\n`oneTimeLoginToken`, `tenantID` и `tenantUrlName` — это часть значения `url`, а не отдельные поля ответа.",
             "nullable": true,
             "example": "https://app.hubex.ru/tenant-name/tasks/123?oneTimeLoginToken=abc123&tenantID=1&tenantUrlName=tenant-name"
           }

package/swagger/dev/REPORT.json

@@ -2,7 +2,7 @@
   "openapi": "3.0.1",
   "info": {
     "title": "API for REPORT in HubEx",
-    "description": "Service offers application programming interface for ....",
+    "description": "Service offers application programming interface for operational reports on tasks, assets, preventive maintenance, response times and Power BI analytics.",
     "contact": {
       "name": "SmartService Backend Team",
       "email": "fmbackend@melston.ru"
@@ -21,7 +21,7 @@
           "AssetMaintenance"
         ],
         "summary": "Получение запланированных заявок на обслуживание объектов",
-        "description": "## Пример запроса:\r\n`GET /AssetMaintenance/planned?validityFrom=2026-01-01&validityTill=2026-12-31`\r\n            \r\n## Пример успешного ответа (200):\r\n```json\r\n[\r\n  {\r\n    \"taskTemplateID\": 10,\r\n    \"appointment\": \"2026-03-15T09:00:00Z\",\r\n    \"normalWorkingHours\": 2,\r\n    \"normalWorkingMinutes\": 120,\r\n    \"workType\": { \"id\": 5, \"name\": \"ТО оборудования\" },\r\n    \"asset\": { \"id\": 100, \"name\": \"Насосная станция №1\" }\r\n  }\r\n]\r\n```\r\n## Негативные сценарии:\r\n- 204 NoContent: данные не найдены.\r\n- 401 Unauthorized: отсутствует или некорректен Bearer-токен.\r\n- 403 Forbidden: недостаточно прав `PreventiveAssetMaintenanceList`.",
+        "description": "## Пример запроса:\r\n`GET /AssetMaintenance/planned?validFrom=2026-01-01&validTill=2026-12-31`\r\n            \r\n## Пример успешного ответа (200):\r\n```json\r\n[\r\n  {\r\n    \"taskTemplateID\": 10,\r\n    \"appointment\": \"2026-03-15T09:00:00Z\",\r\n    \"normalWorkingHours\": 2,\r\n    \"normalWorkingMinutes\": 120,\r\n    \"workType\": { \"id\": 5, \"name\": \"ТО оборудования\" },\r\n    \"asset\": { \"id\": 100, \"name\": \"Насосная станция №1\" }\r\n  }\r\n]\r\n```\r\n## Негативные сценарии:\r\n- 204 NoContent: данные не найдены.\r\n- 401 Unauthorized: отсутствует или некорректен Bearer-токен.\r\n- 403 Forbidden: недостаточно прав `PreventiveAssetMaintenanceList`.",
         "parameters": [
           {
             "name": "validFrom",