@hubex/mcp 0.6.20260910 → 0.7.0

package/dist/http.js

@@ -3,6 +3,7 @@
  * injects auth + `X-Application-ID`, and normalizes responses and errors.
  */
 import { maskPii } from "./pii/mask.js";
+import { SET_TOKEN_TOOL } from "./token-prompt.js";
 /**
  * Заголовки, которые клиент проставляет сам. Подмена `Authorization` или
  * `X-Application-ID` сменила бы того, от чьего имени идёт запрос, поэтому
@@ -20,15 +21,15 @@ export class HubexApiError extends Error {
     service;
     path;
     payload;
-    constructor(status, service, path, payload) {
-        super(HubexApiError.format(status, service, path, payload));
+    constructor(status, service, path, payload, env) {
+        super(HubexApiError.format(status, service, path, payload, env));
         this.status = status;
         this.service = service;
         this.path = path;
         this.payload = payload;
         this.name = "HubexApiError";
     }
-    static format(status, service, path, payload) {
+    static format(status, service, path, payload, env) {
         let detail = "";
         if (typeof payload === "string") {
             detail = payload;
@@ -41,7 +42,17 @@ export class HubexApiError extends Error {
         else if (payload && typeof payload === "object") {
             detail = JSON.stringify(payload).slice(0, 800);
         }
-        return `HubEx ${service} ${path} -> HTTP ${status}${detail ? `: ${detail}` : ""}`;
+        let message = `HubEx ${service} ${path} -> HTTP ${status}${detail ? `: ${detail}` : ""}`;
+        // 401 здесь чаще всего не «токен протух», а «токен не из этого окружения»:
+        // dev/stg/prod выдают JWT с разными ключами подписи, и токен из другого
+        // контура падает именно так, без более внятной причины от самого HubEx.
+        if (status === 401 && env) {
+            message +=
+                ` Сейчас выбрано окружение HUBEX_ENV=${env}. Если токен был получен в другом окружении ` +
+                    `(dev/stg/prod), авторизация не пройдёт — убедись, что токен именно из ${env}, и при ` +
+                    `необходимости передай новый через ${SET_TOKEN_TOOL}.`;
+        }
+        return message;
     }
 }
 function buildQueryString(query) {
@@ -111,7 +122,7 @@ export class HubexClient {
                 exposed[name] = value;
         }
         if (!res.ok) {
-            throw new HubexApiError(res.status, req.service, req.path, visible ?? text);
+            throw new HubexApiError(res.status, req.service, req.path, visible ?? text, this.config.env);
         }
         return { status: res.status, data: visible, headers: exposed };
     }

package/dist/token-prompt.js

@@ -30,7 +30,9 @@ export function createElicitPrompter(server) {
             },
         });
         if (result.action !== "accept") {
-            throw new Error("Ввод токена отменён — авторизоваться в HubEx не удалось.");
+            throw new Error("Ввод токена отменён — авторизоваться в HubEx не удалось. " +
+                "Если клиент заявляет поддержку elicitation, но не показывает форму ввода " +
+                `(так себя ведёт часть хостов), вызови инструмент ${SET_TOKEN_TOOL} и передай access-токен HubEx напрямую.`);
         }
         const token = result.content?.token;
         if (typeof token !== "string" || token.trim() === "") {

package/dist/tools/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hubex/mcp",
-  "version": "0.6.20260910",
+  "version": "0.7.0",
   "type": "module",
   "description": "MCP server for managing HubEx test data (tasks, assets, companies, users) via the HubEx REST API",
   "author": "HubEx Team",