@hirey/hi-mcp-server 0.1.19 → 0.1.25

package/node_modules/@hirey/hi-agent-sdk/dist/client.js

@@ -1,3 +1,40 @@
+// 跨大洋 / GFW 干扰 / NLB TLS handshake 偶发 reset 等 transient 网络层故障在国内
+// agent host 上很常见（实测从大陆访问 us-east-2 prod ELB 单次 SSL handshake 成功率
+// 约 30%）。下面这个 retry 配置目标是把 5 次独立 transient 故障的累计失败率降到
+// 单次 30% → ~0.2%（几何级别），覆盖单次 install 流程内多次 fetch（register、
+// activate、token、updateInstallation、subscriptions 等）整体跑得通。
+//
+// 重试条件：
+// - fetch throw（globalThis.fetch 在跨域 SSL fail / DNS / ECONNRESET / ETIMEDOUT 等
+//   上层都把 error 包成 'fetch failed'，这类视为 transient）
+// - HTTP 5xx
+// - HTTP 429（服务端显式让重试）
+// 不重试：
+// - 其它 4xx（业务错误，重试无意义且会触发 ON CONFLICT 等副作用）
+const DEFAULT_FETCH_RETRY_ATTEMPTS = 5;
+const DEFAULT_FETCH_RETRY_BASE_MS = 400;
+const DEFAULT_FETCH_RETRY_MAX_MS = 8000;
+function isTransientFetchError(err) {
+    if (!err)
+        return false;
+    const message = String(err.message || err);
+    if (/fetch failed|network|ECONN|ETIMEDOUT|EAI_AGAIN|UND_ERR|socket hang up|TLS|SSL/i.test(message)) {
+        return true;
+    }
+    // Node undici fetch 的 error chain 在 cause 里
+    const cause = err.cause;
+    if (cause && cause !== err)
+        return isTransientFetchError(cause);
+    return false;
+}
+function computeBackoffMs(attempt) {
+    const expo = Math.min(DEFAULT_FETCH_RETRY_MAX_MS, DEFAULT_FETCH_RETRY_BASE_MS * 2 ** attempt);
+    // full jitter：[0, expo)，避免多个 client 同步震荡 retry 把 backend 打垮
+    return Math.floor(Math.random() * expo);
+}
+async function sleep(ms) {
+    await new Promise((r) => setTimeout(r, ms));
+}
 class BaseHiClient {
     baseUrl;
     token;
@@ -9,7 +46,8 @@ class BaseHiClient {
     }
     async request(path, options = {}) {
         const hasBody = options.body != null;
-        const response = await this.fetchImpl(`${this.baseUrl}${path}`, {
+        const url = `${this.baseUrl}${path}`;
+        const init = {
             method: options.method || 'GET',
             headers: {
                 ...(this.token ? { authorization: `Bearer ${this.token}` } : {}),
@@ -17,7 +55,32 @@ class BaseHiClient {
                 ...(options.headers || {}),
             },
             body: hasBody ? JSON.stringify(options.body) : undefined,
-        });
+        };
+        let lastErr;
+        let response = null;
+        for (let attempt = 0; attempt < DEFAULT_FETCH_RETRY_ATTEMPTS; attempt += 1) {
+            try {
+                response = await this.fetchImpl(url, init);
+                // 5xx / 429 触发重试；4xx 其余 fall through 给业务错误处理。
+                if (response.status >= 500 || response.status === 429) {
+                    if (attempt < DEFAULT_FETCH_RETRY_ATTEMPTS - 1) {
+                        await sleep(computeBackoffMs(attempt));
+                        continue;
+                    }
+                }
+                break;
+            }
+            catch (err) {
+                lastErr = err;
+                if (!isTransientFetchError(err) || attempt >= DEFAULT_FETCH_RETRY_ATTEMPTS - 1) {
+                    throw err;
+                }
+                await sleep(computeBackoffMs(attempt));
+            }
+        }
+        if (!response) {
+            throw lastErr || new Error('fetch failed');
+        }
         if (options.responseType === 'text') {
             const text = await response.text();
             if (!response.ok) {
@@ -150,17 +213,41 @@ export class HiAgentGatewayClient extends BaseHiClient {
 }
 export async function exchangeHiAgentClientCredentialsToken(options) {
     const fetchImpl = options.fetchImpl || fetch;
-    const response = await fetchImpl(options.tokenUrl, {
+    // 跟 BaseHiClient.request 同样的 retry 策略：transient network / 5xx / 429 重试，
+    // 4xx 其它原样 throw。token exchange 第一次 SSL handshake 经常被跨大洋路径打掉。
+    const init = {
         method: 'POST',
-        headers: {
-            'content-type': 'application/json',
-        },
+        headers: { 'content-type': 'application/json' },
         body: JSON.stringify({
             grant_type: 'client_credentials',
             client_id: options.clientId,
             client_secret: options.clientSecret,
         }),
-    });
+    };
+    let response = null;
+    let lastErr;
+    for (let attempt = 0; attempt < DEFAULT_FETCH_RETRY_ATTEMPTS; attempt += 1) {
+        try {
+            response = await fetchImpl(options.tokenUrl, init);
+            if (response.status >= 500 || response.status === 429) {
+                if (attempt < DEFAULT_FETCH_RETRY_ATTEMPTS - 1) {
+                    await sleep(computeBackoffMs(attempt));
+                    continue;
+                }
+            }
+            break;
+        }
+        catch (err) {
+            lastErr = err;
+            if (!isTransientFetchError(err) || attempt >= DEFAULT_FETCH_RETRY_ATTEMPTS - 1) {
+                throw err;
+            }
+            await sleep(computeBackoffMs(attempt));
+        }
+    }
+    if (!response) {
+        throw lastErr || new Error('fetch failed');
+    }
     const body = await response.json().catch(() => ({}));
     if (!response.ok) {
         const error = new Error(String(body?.error || response.statusText || 'request_failed'));

package/node_modules/@hirey/hi-agent-sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hirey/hi-agent-sdk",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "private": false,
   "type": "module",
   "main": "dist/index.js",
@@ -25,7 +25,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@hirey/hi-agent-contracts": "^0.1.14"
+    "@hirey/hi-agent-contracts": "^0.1.15"
   },
   "devDependencies": {
     "@types/node": "^20.11.30",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hirey/hi-mcp-server",
-  "version": "0.1.19",
+  "version": "0.1.25",
   "private": false,
   "type": "module",
   "main": "dist/server.js",
@@ -34,8 +34,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@hirey/hi-agent-contracts": "^0.1.14",
-    "@hirey/hi-agent-sdk": "^0.1.10",
+    "@hirey/hi-agent-contracts": "^0.1.16",
+    "@hirey/hi-agent-sdk": "^0.1.12",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "express": "^5.2.1",
     "zod": "^4.3.6"