@okxweb3/a2a-node 0.2.16 → 0.2.17-beta-a72a480b58-261013200517

package/dist/cli.js

@@ -4935,8 +4935,8 @@ var require_worldwide = __commonJS({
     function getGlobalSingleton(name, creator, obj) {
       const gbl = obj || GLOBAL_OBJ;
       const __SENTRY__ = gbl.__SENTRY__ = gbl.__SENTRY__ || {};
-      const singleton2 = __SENTRY__[name] || (__SENTRY__[name] = creator());
-      return singleton2;
+      const singleton3 = __SENTRY__[name] || (__SENTRY__[name] = creator());
+      return singleton3;
     }
     exports2.GLOBAL_OBJ = GLOBAL_OBJ;
     exports2.getGlobalObject = getGlobalObject;
@@ -19981,6 +19981,14 @@ var init_events = __esm({
       SYSTEM_NOTIFICATION_ROUTED: "System notification routed",
       HERMES_SESSION_ROUTE_BINDING: "Hermes session route binding",
       DOCTOR_REPORT: "Doctor report",
+      // XMTP creation rate-limit cooldown (DEXMARKET-9116). All four are logger.info,
+      // so each one must also be listed in SENTRY_INFO_ALLOWLIST (index.ts) or info()
+      // drops it silently. Extras are bounded tokens/ints/bools only — never raw SDK
+      // error text (no-content-leak invariant).
+      XMTP_RATE_LIMIT_COOLDOWN_STARTED: "XMTP rate limit cooldown started",
+      XMTP_RATE_LIMIT_CREATE_SUPPRESSED: "XMTP rate limit create suppressed",
+      XMTP_RATE_LIMIT_PROBE: "XMTP rate limit probe",
+      XMTP_RATE_LIMIT_RECOVERED: "XMTP rate limit recovered",
       // ── error ─────────────────────────────────────────────────────
       XMTP_CONNECTION_FAILED: "XMTP connection failed",
       CONVERSATIONS_STREAM_FAILED: "conversations.stream failed",
@@ -20046,7 +20054,10 @@ var init_events = __esm({
       AGENT_DB_DIR_CREATE_FAILED: "Agent DB dir create failed",
       AGENT_INSTALLATION_LIMIT_NEAR: "Agent installation limit near",
       XMTP_HISTORY_SYNC_REQUEST_FAILED: "XMTP history sync request failed",
-      XMTP_DEBUG_SYNC_FAILED: "XMTP debug sync failed"
+      XMTP_DEBUG_SYNC_FAILED: "XMTP debug sync failed",
+      // Underlying XMTP SDK client close failed during recycle/removal/shutdown
+      // (DEXMARKET-9116). Error-level → NOT added to SENTRY_INFO_ALLOWLIST.
+      XMTP_CLIENT_CLOSE_FAILED: "XMTP client close failed"
     };
   }
 });
@@ -20885,7 +20896,13 @@ var init_sentry_logger = __esm({
       LogEvent.PENDING_LIST_QUERIED,
       LogEvent.SESSION_KEY_DERIVED,
       LogEvent.SESSIONS_QUERIED,
-      LogEvent.SYNC_TICK_COMPLETED
+      LogEvent.SYNC_TICK_COMPLETED,
+      // XMTP creation rate-limit cooldown checkpoints (DEXMARKET-9116). info() drops
+      // any event not listed here, so these must stay registered.
+      LogEvent.XMTP_RATE_LIMIT_COOLDOWN_STARTED,
+      LogEvent.XMTP_RATE_LIMIT_CREATE_SUPPRESSED,
+      LogEvent.XMTP_RATE_LIMIT_PROBE,
+      LogEvent.XMTP_RATE_LIMIT_RECOVERED
     ]);
     MAX_EXTRA_STRING_LENGTH = 256;
     MAX_TAG_VALUE_LENGTH = 128;
@@ -27001,7 +27018,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     client: {
       id: "gateway-client",
       displayName: "okx-a2a-node",
-      version: "0.2.16",
+      version: "0.2.17-beta-a72a480b58-261013200517",
       platform: "node",
       mode: "backend",
       instanceId
@@ -27012,7 +27029,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     commands: [],
     permissions: {},
     locale: Intl.DateTimeFormat().resolvedOptions().locale || "en-US",
-    userAgent: `okx-a2a-node/${"0.2.16"}`,
+    userAgent: `okx-a2a-node/${"0.2.17-beta-a72a480b58-261013200517"}`,
     auth: {
       ...config.token ? { token: config.token } : {},
       ...config.password ? { password: config.password } : {}
@@ -29072,7 +29089,7 @@ var init_sentry_config = __esm({
     environment = process.env.SENTRY_ENV === "dev" ? "dev" : "prod";
     SENTRY_CONFIG = {
       projectName: "okx/openclaw-okx-a2a-extension",
-      release: "0.2.16",
+      release: "0.2.17-beta-a72a480b58-261013200517",
       environment,
       runtimeContainer: normalizeRuntimeContainer(process.env.OKX_A2A_RUNTIME_CONTAINER)
     };
@@ -40242,7 +40259,7 @@ async function exportDiagnosticLogs(options) {
     node: process.version,
     platform: process.platform,
     arch: process.arch,
-    packageVersion: true ? "0.2.16" : "unknown",
+    packageVersion: true ? "0.2.17-beta-a72a480b58-261013200517" : "unknown",
     sensitiveContentIncluded: options.includeSensitiveContent,
     listenerAndLlmContentIncluded: true,
     credentialsAlwaysRedacted: true,
@@ -42221,6 +42238,32 @@ var init_trade_records_cli = __esm({
   }
 });
 
+// ../core/src/xmtp-sdk/client-lifecycle.ts
+async function stopAndCloseXmtpClient(agent, ctx) {
+  let stopped = true;
+  try {
+    await Promise.resolve(agent.stop());
+  } catch {
+    stopped = false;
+  }
+  const close2 = agent.client?.close;
+  if (typeof close2 !== "function") {
+    return { stopped, closed: false, closeFailed: false };
+  }
+  try {
+    await Promise.resolve(close2.call(agent.client));
+    return { stopped, closed: true, closeFailed: false };
+  } catch (err2) {
+    ctx.onCloseError?.(err2);
+    return { stopped, closed: false, closeFailed: true };
+  }
+}
+var init_client_lifecycle = __esm({
+  "../core/src/xmtp-sdk/client-lifecycle.ts"() {
+    "use strict";
+  }
+});
+
 // ../core/src/xmtp-sdk/onchainos/bin.ts
 async function refreshOnchainosVersionMetadata(options = {}) {
   const now = options.now ?? Date.now;
@@ -58261,6 +58304,169 @@ var init_session_expired = __esm({
   }
 });
 
+// ../core/src/xmtp-sdk/rate-limit-cooldown.ts
+function asErrorLike2(value) {
+  return value instanceof Error ? value : void 0;
+}
+function causeChain2(err2) {
+  const chain = [];
+  const seen = /* @__PURE__ */ new Set();
+  let current = err2;
+  while (chain.length < MAX_CAUSE_DEPTH2) {
+    chain.push(current);
+    const errorLike = asErrorLike2(current);
+    if (!errorLike || seen.has(errorLike)) {
+      break;
+    }
+    seen.add(errorLike);
+    current = errorLike.cause;
+    if (current === void 0) {
+      break;
+    }
+  }
+  return chain;
+}
+function messageOf(node) {
+  return (node instanceof Error ? node.message : String(node)).toLowerCase();
+}
+function isXmtpRateLimitError(err2) {
+  if (err2 === void 0 || err2 === null) {
+    return false;
+  }
+  const chain = causeChain2(err2);
+  return chain.some(
+    (node) => RATE_LIMIT_PATTERNS.some((pattern) => pattern.test(messageOf(node)))
+  );
+}
+function extractRateLimitEndpoint(err2) {
+  if (err2 === void 0 || err2 === null) {
+    return void 0;
+  }
+  const chain = causeChain2(err2);
+  for (const node of chain) {
+    const message = messageOf(node);
+    for (const pattern of KNOWN_RATE_LIMIT_ENDPOINTS) {
+      const match = pattern.exec(message);
+      if (match) {
+        return /GetInboxIds/i.test(match[0]) ? "GetInboxIds" : "GetIdentityUpdates";
+      }
+    }
+  }
+  return void 0;
+}
+function getXmtpCreationCooldown() {
+  if (!singleton2) {
+    singleton2 = new XmtpCreationCooldown();
+  }
+  return singleton2;
+}
+var MAX_CAUSE_DEPTH2, XMTP_CREATION_COOLDOWN_MS, RATE_LIMIT_PATTERNS, KNOWN_RATE_LIMIT_ENDPOINTS, XmtpCreationCooldownSkipError, XmtpCreationCooldown, singleton2;
+var init_rate_limit_cooldown = __esm({
+  "../core/src/xmtp-sdk/rate-limit-cooldown.ts"() {
+    "use strict";
+    MAX_CAUSE_DEPTH2 = 4;
+    XMTP_CREATION_COOLDOWN_MS = 33e4;
+    RATE_LIMIT_PATTERNS = [
+      /some resource has been exhausted/i,
+      /exceeds rate limit/i,
+      /resource_exhausted/i
+    ];
+    KNOWN_RATE_LIMIT_ENDPOINTS = [
+      /\bGetInboxIds\b/i,
+      /\bGetIdentityUpdates\b/i
+    ];
+    XmtpCreationCooldownSkipError = class extends Error {
+      remainingMs;
+      address;
+      agentId;
+      constructor(remainingMs, address, agentId) {
+        super("xmtp creation suppressed during rate-limit cooldown");
+        this.name = "XmtpCreationCooldownSkipError";
+        this.remainingMs = remainingMs;
+        this.address = address;
+        this.agentId = agentId;
+      }
+    };
+    XmtpCreationCooldown = class {
+      cooldownUntilMs = null;
+      probeInFlight = false;
+      suppressedCreateCount = 0;
+      rateLimitHitCount = 0;
+      probeCount = 0;
+      inFlightCreateCount = 0;
+      beginCreateAttempt(nowMs = Date.now()) {
+        if (this.cooldownUntilMs === null) {
+          this.inFlightCreateCount++;
+          return { allowed: true, mode: "normal" };
+        }
+        if (nowMs < this.cooldownUntilMs) {
+          this.suppressedCreateCount++;
+          return {
+            allowed: false,
+            mode: "blocked",
+            remainingMs: Math.max(0, this.cooldownUntilMs - nowMs)
+          };
+        }
+        if (this.probeInFlight) {
+          this.suppressedCreateCount++;
+          return { allowed: false, mode: "blocked", remainingMs: 0 };
+        }
+        this.probeInFlight = true;
+        this.inFlightCreateCount++;
+        this.probeCount++;
+        return { allowed: true, mode: "probe" };
+      }
+      recordCreateSuccess(decision, _nowMs = Date.now()) {
+        this.inFlightCreateCount = Math.max(0, this.inFlightCreateCount - 1);
+        if (decision.mode === "probe") {
+          this.cooldownUntilMs = null;
+          this.probeInFlight = false;
+        }
+      }
+      recordRateLimit(decision, nowMs = Date.now()) {
+        this.inFlightCreateCount = Math.max(0, this.inFlightCreateCount - 1);
+        this.cooldownUntilMs = nowMs + XMTP_CREATION_COOLDOWN_MS;
+        this.rateLimitHitCount++;
+        this.probeInFlight = false;
+        void decision;
+      }
+      recordCreateFailure(decision, nowMs = Date.now()) {
+        this.inFlightCreateCount = Math.max(0, this.inFlightCreateCount - 1);
+        if (decision.mode === "probe") {
+          this.cooldownUntilMs = nowMs + XMTP_CREATION_COOLDOWN_MS;
+          this.probeInFlight = false;
+        }
+      }
+      isCoolingDown(nowMs = Date.now()) {
+        return this.cooldownUntilMs !== null && nowMs < this.cooldownUntilMs;
+      }
+      remainingMs(nowMs = Date.now()) {
+        return this.cooldownUntilMs === null ? 0 : Math.max(0, this.cooldownUntilMs - nowMs);
+      }
+      snapshot(nowMs = Date.now()) {
+        return {
+          coolingDown: this.isCoolingDown(nowMs),
+          cooldownUntilMs: this.cooldownUntilMs,
+          remainingMs: this.remainingMs(nowMs),
+          probeInFlight: this.probeInFlight,
+          suppressedCreateCount: this.suppressedCreateCount,
+          rateLimitHitCount: this.rateLimitHitCount,
+          probeCount: this.probeCount,
+          inFlightCreateCount: this.inFlightCreateCount
+        };
+      }
+      resetForTests() {
+        this.cooldownUntilMs = null;
+        this.probeInFlight = false;
+        this.suppressedCreateCount = 0;
+        this.rateLimitHitCount = 0;
+        this.probeCount = 0;
+        this.inFlightCreateCount = 0;
+      }
+    };
+  }
+});
+
 // ../core/src/xmtp-sdk/index.ts
 function cachePath(dataDir, fileName) {
   return (0, import_node_path28.join)(dataDir, fileName);
@@ -58690,6 +58896,8 @@ var init_xmtp_sdk = __esm({
     init_a2a_paths();
     init_installation_prune();
     init_session_expired();
+    init_rate_limit_cooldown();
+    init_client_lifecycle();
     DEFAULT_DATA_DIR = resolveA2aTaskPaths().xmtpDir;
     XMTP_INSTALLATION_WARNING_THRESHOLD = 2;
     XMTP_INSTALLATION_NEAR_LIMIT_THRESHOLD = 8;
@@ -58987,21 +59195,78 @@ var init_xmtp_sdk = __esm({
       }
       async createClientForAgent(agentInfo, options = {}) {
         const address = agentInfo.communicationAddress;
-        const signer = this.tools.createSigner(agentInfo);
-        const dbPath = (inboxId2) => `${this.dataDir}/${inboxId2}-${this.env}.db3`;
-        const agent = await createAgentWithInstallationPrune(signer, {
-          dbPath,
-          env: this.env
-        }, {
-          address,
-          agentId: agentInfo.agentId,
-          logPrefix: options.logPrefix
-        });
-        const inboxId = agent.client?.inboxId ?? "";
-        logWithTimestamp(
-          `[xmtp-sdk] xmtp_client_ready agentId=${agentInfo.agentId} address=${address} inboxId=${inboxId} dbPath=${inboxId ? dbPath(inboxId) : "(unknown)"} lastSync=${formatLogTimestamp2(this.syncByAddress.get(address))}`
-        );
-        return { address, agent, agentInfo };
+        const phase = options.logPrefix ?? "[xmtp-sdk]";
+        const cooldown = getXmtpCreationCooldown();
+        const decision = cooldown.beginCreateAttempt();
+        if (!decision.allowed) {
+          logger.info(LogEvent.XMTP_RATE_LIMIT_CREATE_SUPPRESSED, {
+            onchainosAgentId: agentInfo.agentId,
+            walletAddress: address,
+            cooldownRemainingMs: String(decision.remainingMs ?? 0),
+            phase
+          });
+          throw new XmtpCreationCooldownSkipError(
+            decision.remainingMs ?? 0,
+            address,
+            agentInfo.agentId
+          );
+        }
+        if (decision.mode === "probe") {
+          logger.info(LogEvent.XMTP_RATE_LIMIT_PROBE, {
+            onchainosAgentId: agentInfo.agentId,
+            walletAddress: address,
+            phase: "probe-start",
+            probeCount: String(cooldown.snapshot().probeCount)
+          });
+        }
+        try {
+          const signer = this.tools.createSigner(agentInfo);
+          const dbPath = (inboxId2) => `${this.dataDir}/${inboxId2}-${this.env}.db3`;
+          const agent = await createAgentWithInstallationPrune(signer, {
+            dbPath,
+            env: this.env
+          }, {
+            address,
+            agentId: agentInfo.agentId,
+            logPrefix: options.logPrefix
+          });
+          cooldown.recordCreateSuccess(decision);
+          if (decision.mode === "probe") {
+            logger.info(LogEvent.XMTP_RATE_LIMIT_RECOVERED, {
+              onchainosAgentId: agentInfo.agentId,
+              walletAddress: address,
+              phase: "probe-success"
+            });
+          }
+          const inboxId = agent.client?.inboxId ?? "";
+          logWithTimestamp(
+            `[xmtp-sdk] xmtp_client_ready agentId=${agentInfo.agentId} address=${address} inboxId=${inboxId} dbPath=${inboxId ? dbPath(inboxId) : "(unknown)"} lastSync=${formatLogTimestamp2(this.syncByAddress.get(address))}`
+          );
+          return { address, agent, agentInfo };
+        } catch (err2) {
+          if (isXmtpRateLimitError(err2)) {
+            cooldown.recordRateLimit(decision);
+            logger.info(LogEvent.XMTP_RATE_LIMIT_COOLDOWN_STARTED, {
+              ...agentExtras({ walletAddress: address, onchainosAgentId: agentInfo.agentId }),
+              rateLimitIdentified: "true",
+              endpoint: extractRateLimitEndpoint(err2) ?? "unknown",
+              cooldownMs: String(XMTP_CREATION_COOLDOWN_MS),
+              cooldownExpiresAtMs: String(cooldown.snapshot().cooldownUntilMs ?? ""),
+              inFlightCreateCount: String(cooldown.snapshot().inFlightCreateCount),
+              probe: String(decision.mode === "probe")
+            });
+          } else {
+            cooldown.recordCreateFailure(decision);
+            if (decision.mode === "probe") {
+              logger.info(LogEvent.XMTP_RATE_LIMIT_PROBE, {
+                onchainosAgentId: agentInfo.agentId,
+                walletAddress: address,
+                phase: "probe-failed-nonratelimit"
+              });
+            }
+          }
+          throw err2;
+        }
       }
       async recordInstallationHealth(params) {
         const { address, agent, agentInfo, phase, attempt } = params;
@@ -59152,22 +59417,28 @@ var init_xmtp_sdk = __esm({
             });
           } else {
             failedAgents.push(agents[i]);
-            logWithTimestamp(
-              `[xmtp-sdk] identity init failed: ${agents[i].communicationAddress} (agentId=${agents[i].agentId})`,
-              r.reason
-            );
-            logger.error(
-              LogEvent.XMTP_CONNECTION_FAILED,
-              r.reason instanceof Error ? r.reason : new Error(String(r.reason)),
-              {
-                walletAddress: agents[i].communicationAddress,
-                onchainosAgentId: agents[i].agentId,
-                attempt: "1"
-              }
-            );
+            if (r.reason instanceof XmtpCreationCooldownSkipError) {
+              logWithTimestamp(
+                `[xmtp-sdk] identity init suppressed (rate-limit cooldown): ${agents[i].communicationAddress} (agentId=${agents[i].agentId})`
+              );
+            } else {
+              logWithTimestamp(
+                `[xmtp-sdk] identity init failed: ${agents[i].communicationAddress} (agentId=${agents[i].agentId})`,
+                r.reason
+              );
+              logger.error(
+                LogEvent.XMTP_CONNECTION_FAILED,
+                r.reason instanceof Error ? r.reason : new Error(String(r.reason)),
+                {
+                  walletAddress: agents[i].communicationAddress,
+                  onchainosAgentId: agents[i].agentId,
+                  attempt: "1"
+                }
+              );
+            }
           }
         }
-        if (failedAgents.length > 0) {
+        if (failedAgents.length > 0 && !getXmtpCreationCooldown().isCoolingDown()) {
           logWithTimestamp(
             `[xmtp-sdk] ${failedAgents.length} client(s) failed to initialize, retrying in 1s...`
           );
@@ -59207,6 +59478,11 @@ var init_xmtp_sdk = __esm({
                 phase: "init",
                 attempt: "2"
               });
+            } else if (r.reason instanceof XmtpCreationCooldownSkipError) {
+              const info = failedAgents[i];
+              logWithTimestamp(
+                `[xmtp-sdk] retry suppressed (rate-limit cooldown): ${info.communicationAddress} (agentId=${info.agentId})`
+              );
             } else {
               const info = failedAgents[i];
               logWithTimestamp(
@@ -59302,7 +59578,16 @@ var init_xmtp_sdk = __esm({
             try {
               this.cancelStreamRecoveryForAddress(address);
               this.stoppedAddresses.add(address.toLowerCase());
-              client.stop();
+              await stopAndCloseXmtpClient(client, {
+                address,
+                agentId: agentInfo.agentId,
+                phase: "refresh/remove",
+                onCloseError: (err2) => logger.error(
+                  LogEvent.XMTP_CLIENT_CLOSE_FAILED,
+                  err2 instanceof Error ? err2 : new Error(String(err2)),
+                  { walletAddress: address, onchainosAgentId: agentInfo.agentId, phase: "refresh/remove" }
+                )
+              });
               logWithTimestamp(
                 `[xmtp-sdk] refresh: stopped client: ${address} (agentId=${agentInfo.agentId})`
               );
@@ -59389,23 +59674,29 @@ var init_xmtp_sdk = __esm({
               });
             } else {
               failedAgents.push(added[i]);
-              logWithTimestamp(
-                `[xmtp-sdk] refresh: identity init failed: ${added[i].communicationAddress} (agentId=${added[i].agentId})`,
-                r.reason
-              );
-              logger.error(
-                LogEvent.XMTP_CONNECTION_FAILED,
-                r.reason instanceof Error ? r.reason : new Error(String(r.reason)),
-                {
-                  walletAddress: added[i].communicationAddress,
-                  onchainosAgentId: added[i].agentId,
-                  phase: "refresh",
-                  attempt: "1"
-                }
-              );
+              if (r.reason instanceof XmtpCreationCooldownSkipError) {
+                logWithTimestamp(
+                  `[xmtp-sdk] refresh: identity init suppressed (rate-limit cooldown): ${added[i].communicationAddress} (agentId=${added[i].agentId})`
+                );
+              } else {
+                logWithTimestamp(
+                  `[xmtp-sdk] refresh: identity init failed: ${added[i].communicationAddress} (agentId=${added[i].agentId})`,
+                  r.reason
+                );
+                logger.error(
+                  LogEvent.XMTP_CONNECTION_FAILED,
+                  r.reason instanceof Error ? r.reason : new Error(String(r.reason)),
+                  {
+                    walletAddress: added[i].communicationAddress,
+                    onchainosAgentId: added[i].agentId,
+                    phase: "refresh",
+                    attempt: "1"
+                  }
+                );
+              }
             }
           }
-          if (failedAgents.length > 0) {
+          if (failedAgents.length > 0 && !getXmtpCreationCooldown().isCoolingDown()) {
             logWithTimestamp(
               `[xmtp-sdk] refresh: ${failedAgents.length} client(s) failed to initialize, retrying in 1s...`
             );
@@ -59448,6 +59739,11 @@ var init_xmtp_sdk = __esm({
                   phase: "refresh",
                   attempt: "2"
                 });
+              } else if (r.reason instanceof XmtpCreationCooldownSkipError) {
+                const info = failedAgents[i];
+                logWithTimestamp(
+                  `[xmtp-sdk] refresh: retry suppressed (rate-limit cooldown): ${info.communicationAddress} (agentId=${info.agentId})`
+                );
               } else {
                 const info = failedAgents[i];
                 logWithTimestamp(
@@ -59511,6 +59807,18 @@ var init_xmtp_sdk = __esm({
       async recycleXmtpClients() {
         await this._backupReady;
         const startedAt = Date.now();
+        if (getXmtpCreationCooldown().isCoolingDown()) {
+          logWithTimestamp("[xmtp-sdk] recycle skipped \u2014 rate-limit cooldown active");
+          return {
+            clients: this.clients.size,
+            recycled: 0,
+            failed: 0,
+            replayed: 0,
+            skipped: 0,
+            durationMs: Date.now() - startedAt,
+            addresses: []
+          };
+        }
         const addresses = [];
         let recycled = 0;
         let failed = 0;
@@ -59529,7 +59837,16 @@ var init_xmtp_sdk = __esm({
           try {
             this.cancelStreamRecoveryForAddress(address);
             this.stoppedAddresses.add(addressKey);
-            await Promise.resolve(oldClient.stop());
+            await stopAndCloseXmtpClient(oldClient, {
+              address,
+              agentId: agentInfo.agentId,
+              phase: "recycle",
+              onCloseError: (err2) => logger.error(
+                LogEvent.XMTP_CLIENT_CLOSE_FAILED,
+                err2 instanceof Error ? err2 : new Error(String(err2)),
+                { walletAddress: address, onchainosAgentId: agentInfo.agentId, phase: "recycle" }
+              )
+            });
             this.clients.delete(address);
             this.inboundReplayGates.delete(addressKey);
             this.replayScanFailuresByAddress.delete(addressKey);
@@ -59616,6 +59933,12 @@ var init_xmtp_sdk = __esm({
                 phase: "recycle/create-client"
               }
             );
+            if (isXmtpRateLimitError(err2)) {
+              logWithTimestamp(
+                "[xmtp-sdk] recycle: rate-limit on recreate \u2014 stopping remaining recycles"
+              );
+              break;
+            }
           }
         }
         return {
@@ -69603,12 +69926,12 @@ function parseYamlInlineEnabledList(line) {
 }
 function stopClients(service) {
   for (const [address, client] of service.getClients()) {
-    try {
-      client.stop();
-      logWithTimestamp(`[okx-agent-task] stopped XMTP client ${address}`);
-    } catch (err2) {
-      logWithTimestamp(`[okx-agent-task] failed to stop XMTP client ${address}:`, err2);
-    }
+    void stopAndCloseXmtpClient(client, {
+      address,
+      agentId: "",
+      phase: "shutdown",
+      onCloseError: (err2) => logWithTimestamp(`[okx-agent-task] failed to close XMTP client ${address}:`, err2)
+    }).then(() => logWithTimestamp(`[okx-agent-task] stopped XMTP client ${address}`)).catch((err2) => logWithTimestamp(`[okx-agent-task] failed to stop XMTP client ${address}:`, err2));
   }
 }
 async function runListener(options = {}) {
@@ -69748,12 +70071,12 @@ async function runListenerWithLock(options, paths) {
       });
     }
   });
-  service.setPluginVersion("0.2.16");
+  service.setPluginVersion("0.2.17-beta-a72a480b58-261013200517");
   await service.init();
   const pluginVersionStatus = service.pluginVersionStatus;
   if (pluginVersionStatus.unavailable) {
     throw new Error(
-      `@okxweb3/a2a-node v${"0.2.16"} is below the required minimum v${pluginVersionStatus.minVersion}`
+      `@okxweb3/a2a-node v${"0.2.17-beta-a72a480b58-261013200517"} is below the required minimum v${pluginVersionStatus.minVersion}`
     );
   }
   const systemConfig = service.getSystemConfig();
@@ -69781,7 +70104,7 @@ async function runListenerWithLock(options, paths) {
       onchainosAgentId: "*",
       reason: "system-config missing sentryDsn",
       pluginId: "@okxweb3/a2a-node",
-      pluginVersion: "0.2.16"
+      pluginVersion: "0.2.17-beta-a72a480b58-261013200517"
     });
   }
   logWithTimestamp(
@@ -70136,6 +70459,7 @@ var init_listener = __esm({
   "src/listener.ts"() {
     "use strict";
     init_log();
+    init_client_lifecycle();
     import_node_fs27 = require("node:fs");
     import_promises13 = require("node:fs/promises");
     import_node_os10 = require("node:os");
@@ -118123,7 +118447,7 @@ async function getCurrentNodeCliVersion() {
   return await getGlobalNpmPackageVersion(UPDATE_PACKAGES.node) ?? getBundledNodeCliVersion();
 }
 function getBundledNodeCliVersion() {
-  return true ? "0.2.16" : null;
+  return true ? "0.2.17-beta-a72a480b58-261013200517" : null;
 }
 function readConfiguredAiProvider() {
   const explicit = process.env.OKX_A2A_AI_PROVIDER || process.env.OKX_AGENT_TASK_AI_CLI;
@@ -118333,7 +118657,7 @@ async function updateHermes(release, options) {
   }
 }
 async function installGatewayPluginForDoctor(target) {
-  const release = isPrereleaseVersion("0.2.16") ? "beta" : "latest";
+  const release = isPrereleaseVersion("0.2.17-beta-a72a480b58-261013200517") ? "beta" : "latest";
   const insideTargetGateway = detectGatewayInvocation() === target;
   const options = {
     restart: !insideTargetGateway,
@@ -119386,7 +119710,7 @@ async function runDoctor(options = {}) {
     platform: options.platform ?? process.platform,
     env: options.env ?? process.env,
     target: options.target ?? resolveDoctorTarget(options.env ?? process.env),
-    cliVersion: options.cliVersion ?? (true ? "0.2.16" : "0.0.0"),
+    cliVersion: options.cliVersion ?? (true ? "0.2.17-beta-a72a480b58-261013200517" : "0.0.0"),
     fixMode: options.fix === true,
     nonInteractive: options.nonInteractive === true,
     packageChanged: false,
@@ -120493,7 +120817,7 @@ init_sentry_config();
 init_runtime_metadata();
 var CURRENT_GATEWAY_SESSION_KEYS_ENV4 = "OKX_A2A_CURRENT_GATEWAY_SESSION_KEYS";
 function printUsage3() {
-  console.log(`okx-a2a ${"0.2.16"}
+  console.log(`okx-a2a ${"0.2.17-beta-a72a480b58-261013200517"}
 
 Usage:
   okx-a2a <command> [options]
@@ -120535,7 +120859,7 @@ Run \`okx-a2a <command> -h\` for command-specific help.
 `);
 }
 function printVersion() {
-  console.log("0.2.16");
+  console.log("0.2.17-beta-a72a480b58-261013200517");
 }
 function printDaemonUsage() {
   console.log(`Usage: okx-a2a daemon <start|restart|stop|status|autostart> [options]
@@ -122030,7 +122354,7 @@ async function main() {
   if (command === "xmtp-test") {
     const { handleXmtpTestCommand: handleXmtpTestCommand2 } = await Promise.resolve().then(() => (init_xmtp_test_cli(), xmtp_test_cli_exports));
     await handleXmtpTestCommand2(process.argv.slice(3), {
-      packageVersion: "0.2.16",
+      packageVersion: "0.2.17-beta-a72a480b58-261013200517",
       agentSdkVersion: "2.3.0",
       nodeSdkVersion: "6.1.0",
       nodeBindingsVersion: "1.11.0"