@okxweb3/a2a-node 0.2.3-beta-fa7df0d9e7-260810102542 → 0.2.3

package/dist/cli.js

@@ -20131,7 +20131,15 @@ function classifyError(error, code) {
   if (normalizedCode === "ABORT_ERR" || name === "aborterror") {
     return "cancelled";
   }
-  if (name === "syntaxerror" || /(?:json|response).*(?:parse|invalid)/.test(message)) {
+  if (name === "syntaxerror") {
+    return "invalid_response";
+  }
+  if (/connection\s+(?:reset|closed|interrupted)|broken\s+pipe|unexpected\s+eof/.test(
+    message
+  )) {
+    return "connection_interrupted";
+  }
+  if (/(?:json|response).*(?:parse|invalid)/.test(message)) {
     return "invalid_response";
   }
   if (/session\s+(?:is\s+)?expired|login\s+expired/.test(message)) {
@@ -20425,6 +20433,7 @@ var init_sentry_logger = __esm({
       "releaseBase",
       "releaseChannel",
       "releaseCode",
+      "replayOutcome",
       "role",
       "runId",
       "runtimeContainer",
@@ -26595,7 +26604,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     client: {
       id: "gateway-client",
       displayName: "okx-a2a-node",
-      version: "0.2.3-beta-fa7df0d9e7-260810102542",
+      version: "0.2.3",
       platform: "node",
       mode: "backend",
       instanceId
@@ -26606,7 +26615,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     commands: [],
     permissions: {},
     locale: Intl.DateTimeFormat().resolvedOptions().locale || "en-US",
-    userAgent: `okx-a2a-node/${"0.2.3-beta-fa7df0d9e7-260810102542"}`,
+    userAgent: `okx-a2a-node/${"0.2.3"}`,
     auth: {
       ...config.token ? { token: config.token } : {},
       ...config.password ? { password: config.password } : {}
@@ -28490,7 +28499,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.3-beta-fa7df0d9e7-260810102542",
+      release: "0.2.3",
       environment,
       runtimeContainer: normalizeRuntimeContainer(process.env.OKX_A2A_RUNTIME_CONTAINER)
     };
@@ -39660,7 +39669,7 @@ async function exportDiagnosticLogs(options) {
     node: process.version,
     platform: process.platform,
     arch: process.arch,
-    packageVersion: true ? "0.2.3-beta-fa7df0d9e7-260810102542" : "unknown",
+    packageVersion: true ? "0.2.3" : "unknown",
     sensitiveContentIncluded: options.includeSensitiveContent,
     listenerAndLlmContentIncluded: true,
     credentialsAlwaysRedacted: true,
@@ -56498,6 +56507,13 @@ function parseGroupPayload(content2) {
     return null;
   }
 }
+function replayScanBackoffMs(consecutiveFailures) {
+  const exponent = Math.max(0, Math.floor(consecutiveFailures) - 1);
+  return Math.min(
+    REPLAY_SCAN_INITIAL_BACKOFF_MS * 2 ** exponent,
+    REPLAY_SCAN_MAX_BACKOFF_MS
+  );
+}
 function isOfflineReplayForTrigger(trigger) {
   return trigger === "startup";
 }
@@ -56510,6 +56526,7 @@ function replaySingleFlightDiscriminator(trigger, clientGeneration, recoveryIden
 function createOfflineReplayAddressSummary(address) {
   return {
     address,
+    outcome: "skipped",
     replayed: 0,
     skipped: 0,
     conversations: 0,
@@ -56524,7 +56541,7 @@ function createOfflineReplayAddressSummary(address) {
     durationMs: 0
   };
 }
-var import_node_fs22, import_node_path26, DEFAULT_DATA_DIR, XMTP_INSTALLATION_WARNING_THRESHOLD, XMTP_INSTALLATION_NEAR_LIMIT_THRESHOLD, SENSITIVE_WORDS_LAZY_RETRY_COOLDOWN_MS, SESSION_EXPIRED_RE, InboundReplayGate, SYSTEM_CONFIG_DEFAULTS, STREAM_RECOVERY_ALERT_THRESHOLD_MS, REPLAY_GATE_DRAIN_MAX_ATTEMPTS, REPLAY_GATE_DRAIN_RETRY_DELAY_MS, SEMVER_RE, isRecord5, isPositiveNumber, SYSTEM_CONFIG_VALIDATORS, XmtpService;
+var import_node_fs22, import_node_path26, DEFAULT_DATA_DIR, XMTP_INSTALLATION_WARNING_THRESHOLD, XMTP_INSTALLATION_NEAR_LIMIT_THRESHOLD, REPLAY_SCAN_INITIAL_BACKOFF_MS, REPLAY_SCAN_MAX_BACKOFF_MS, SENSITIVE_WORDS_LAZY_RETRY_COOLDOWN_MS, SESSION_EXPIRED_RE, InboundReplayGate, SYSTEM_CONFIG_DEFAULTS, STREAM_RECOVERY_ALERT_THRESHOLD_MS, REPLAY_GATE_DRAIN_MAX_ATTEMPTS, REPLAY_GATE_DRAIN_RETRY_DELAY_MS, SEMVER_RE, isRecord5, isPositiveNumber, SYSTEM_CONFIG_VALIDATORS, XmtpService;
 var init_xmtp_sdk = __esm({
   "../core/src/xmtp-sdk/index.ts"() {
     "use strict";
@@ -56545,6 +56562,8 @@ var init_xmtp_sdk = __esm({
     DEFAULT_DATA_DIR = resolveA2aTaskPaths().xmtpDir;
     XMTP_INSTALLATION_WARNING_THRESHOLD = 2;
     XMTP_INSTALLATION_NEAR_LIMIT_THRESHOLD = 8;
+    REPLAY_SCAN_INITIAL_BACKOFF_MS = 3e4;
+    REPLAY_SCAN_MAX_BACKOFF_MS = 5 * 6e4;
     SENSITIVE_WORDS_LAZY_RETRY_COOLDOWN_MS = 10 * 60 * 1e3;
     SESSION_EXPIRED_RE = /session expired/i;
     InboundReplayGate = class {
@@ -56677,6 +56696,11 @@ var init_xmtp_sdk = __esm({
       dataDir = DEFAULT_DATA_DIR;
       syncByAddress = /* @__PURE__ */ new Map();
       offlineReplaySingleFlight = new KeyedSingleFlight();
+      replayScanFailuresByAddress = /* @__PURE__ */ new Map();
+      replayScanRetryByAddress = /* @__PURE__ */ new Map();
+      replayScanNowMs = () => Date.now();
+      replayScanSetTimeout = (callback, delayMs) => setTimeout(callback, delayMs);
+      replayScanClearTimeout = (timer) => clearTimeout(timer);
       inboundReplayGates = /* @__PURE__ */ new Map();
       streamRecoveryCleanupByAddress = /* @__PURE__ */ new Map();
       nextClientGeneration = 1;
@@ -57155,6 +57179,8 @@ var init_xmtp_sdk = __esm({
             }
             this.clients.delete(address);
             this.inboundReplayGates.delete(address.toLowerCase());
+            this.replayScanFailuresByAddress.delete(address.toLowerCase());
+            this.clearReplayScanRetry(address);
             logger.info(LogEvent.AGENT_CLIENT_REMOVED, {
               ...agentExtras({
                 walletAddress: address,
@@ -57369,6 +57395,8 @@ var init_xmtp_sdk = __esm({
             await Promise.resolve(oldClient.stop());
             this.clients.delete(address);
             this.inboundReplayGates.delete(addressKey);
+            this.replayScanFailuresByAddress.delete(addressKey);
+            this.clearReplayScanRetry(address);
             logWithTimestamp(
               `[xmtp-sdk] recycle: stopped client: ${address} (agentId=${agentInfo.agentId})`
             );
@@ -57918,6 +57946,60 @@ var init_xmtp_sdk = __esm({
         this.clientGenerationByClient.set(client, generation);
         return generation;
       }
+      clearReplayScanRetry(address) {
+        const addressKey = address.toLowerCase();
+        const scheduled = this.replayScanRetryByAddress.get(addressKey);
+        if (!scheduled) {
+          return;
+        }
+        this.replayScanRetryByAddress.delete(addressKey);
+        this.replayScanClearTimeout(scheduled.timer);
+      }
+      scheduleReplayScanRetry(address, expectedClient, clientGeneration, retryTrigger, delayMs) {
+        const addressKey = address.toLowerCase();
+        const scheduled = this.replayScanRetryByAddress.get(addressKey);
+        if (scheduled?.clientGeneration === clientGeneration) {
+          return;
+        }
+        if (scheduled) {
+          this.clearReplayScanRetry(address);
+        }
+        const timer = this.replayScanSetTimeout(() => {
+          const current = this.replayScanRetryByAddress.get(addressKey);
+          if (current?.timer !== timer) {
+            return;
+          }
+          this.replayScanRetryByAddress.delete(addressKey);
+          if (this.clients.get(address) !== expectedClient || this.stoppedAddresses.has(addressKey)) {
+            return;
+          }
+          void this.replayOfflineMessagesForAddressSingleFlight(
+            address,
+            retryTrigger,
+            void 0,
+            expectedClient
+          ).catch((err2) => {
+            logWithTimestamp(
+              `[xmtp-sdk:replay:${address}] scheduled replay scan retry failed:`,
+              err2
+            );
+            logger.error(
+              LogEvent.OFFLINE_REPLAY_FAILED,
+              err2 instanceof Error ? err2 : new Error(String(err2)),
+              {
+                walletAddress: address,
+                stage: "offlineReplay/scheduledRetry",
+                outcome: "failed"
+              }
+            );
+          });
+        }, Math.max(0, delayMs));
+        timer.unref?.();
+        this.replayScanRetryByAddress.set(addressKey, {
+          clientGeneration,
+          timer
+        });
+      }
       notifyAgentsWakeupAfterReplay() {
         const notifyAgentsWakeup2 = this.tools.notifyAgentsWakeup;
         const agentIds = this.allAgents.map((agent) => agent.agentId);
@@ -58156,7 +58238,7 @@ var init_xmtp_sdk = __esm({
                     String(recovery.recoverySequence),
                     agent
                   );
-                  if (!recoveryDisposed && this.clients.get(address) === agent) {
+                  if (summary.outcome === "completed" && !recoveryDisposed && this.clients.get(address) === agent) {
                     logger.info(LogEvent.AGENT_STREAM_RECOVERY_REPLAY_COMPLETED, {
                       ...agentExtras(identity),
                       clientGeneration: String(clientGeneration),
@@ -58164,7 +58246,9 @@ var init_xmtp_sdk = __esm({
                       replayed: String(summary.replayed),
                       skipped: String(summary.skipped),
                       conversationCount: String(summary.conversations),
-                      replayDurationMs: String(summary.durationMs)
+                      replayDurationMs: String(summary.durationMs),
+                      outcome: "success",
+                      replayOutcome: summary.outcome
                     });
                   }
                 } catch (err2) {
@@ -58230,10 +58314,6 @@ var init_xmtp_sdk = __esm({
           summary.durationMs = Date.now() - addressReplayStartedAt;
           return summary;
         }
-        const sentAfterNs = BigInt(lastSyncMs) * 1000000n;
-        logWithTimestamp(
-          `${tag} offline_replay_start agentId=${this.getAgentByAddress(address)?.agentId ?? ""} address=${address} since=${formatLogTimestamp2(lastSyncMs)} sinceMs=${lastSyncMs}`
-        );
         const myInboxId = agent.client.inboxId;
         const handlerDeps = {
           myXmtpAddress: address,
@@ -58248,7 +58328,87 @@ var init_xmtp_sdk = __esm({
           summary.durationMs = Date.now() - addressReplayStartedAt;
           return summary;
         }
+        const addressKey = address.toLowerCase();
+        const clientGeneration = this.getClientGeneration(agent);
+        const attemptNowMs = this.replayScanNowMs();
+        let priorFailure = this.replayScanFailuresByAddress.get(addressKey);
+        if (priorFailure && priorFailure.clientGeneration !== clientGeneration) {
+          this.replayScanFailuresByAddress.delete(addressKey);
+          this.clearReplayScanRetry(address);
+          priorFailure = void 0;
+        }
+        if (priorFailure && attemptNowMs < priorFailure.nextAttemptAtMs) {
+          priorFailure.suppressedAttempts++;
+          summary.outcome = "suppressed_backoff";
+          summary.failureStage = priorFailure.lastFailureStage;
+          summary.consecutiveFailures = priorFailure.consecutiveFailures;
+          summary.backoffMs = priorFailure.nextAttemptAtMs - attemptNowMs;
+          summary.suppressedAttempts = priorFailure.suppressedAttempts;
+          if (priorFailure.suppressedAttempts === 1) {
+            logWithTimestamp(
+              `${tag} replay scan suppressed stage=${priorFailure.lastFailureStage} consecutiveFailures=${priorFailure.consecutiveFailures} retryInMs=${summary.backoffMs}`
+            );
+          }
+          this.scheduleReplayScanRetry(
+            address,
+            agent,
+            clientGeneration,
+            priorFailure.retryTrigger,
+            summary.backoffMs
+          );
+          summary.durationMs = Date.now() - addressReplayStartedAt;
+          return summary;
+        }
+        const sentAfterNs = BigInt(lastSyncMs) * 1000000n;
+        logWithTimestamp(
+          `${tag} offline_replay_start agentId=${this.getAgentByAddress(address)?.agentId ?? ""} address=${address} since=${formatLogTimestamp2(lastSyncMs)} sinceMs=${lastSyncMs}`
+        );
         let conversations;
+        const recordScanFailure = (stage, err2) => {
+          const previous = this.replayScanFailuresByAddress.get(addressKey);
+          const consecutiveFailures = (previous?.consecutiveFailures ?? 0) + 1;
+          const backoffMs = replayScanBackoffMs(consecutiveFailures);
+          const suppressedAttempts = previous?.suppressedAttempts ?? 0;
+          const failureNowMs = this.replayScanNowMs();
+          const retryTrigger = isOfflineReplayForTrigger(trigger) ? "startup" : "periodic_repair";
+          this.replayScanFailuresByAddress.set(addressKey, {
+            clientGeneration,
+            consecutiveFailures,
+            nextAttemptAtMs: failureNowMs + backoffMs,
+            retryTrigger,
+            suppressedAttempts: 0,
+            lastFailureStage: stage
+          });
+          this.scheduleReplayScanRetry(
+            address,
+            agent,
+            clientGeneration,
+            retryTrigger,
+            backoffMs
+          );
+          summary.outcome = stage === "syncAll" ? "sync_failed" : "list_failed";
+          summary.failureStage = stage;
+          summary.consecutiveFailures = consecutiveFailures;
+          summary.backoffMs = backoffMs;
+          summary.suppressedAttempts = suppressedAttempts;
+          logWithTimestamp(`${tag} conversation ${stage} failed, backing off:`, err2);
+          logger.error(
+            LogEvent.OFFLINE_REPLAY_FAILED,
+            err2 instanceof Error ? err2 : void 0,
+            {
+              walletAddress: address,
+              stage: `offlineReplay/${stage}`,
+              trigger,
+              outcome: "failed",
+              replayOutcome: summary.outcome,
+              consecutiveFailures: String(consecutiveFailures),
+              backoffMs: String(backoffMs),
+              suppressedAttempts: String(suppressedAttempts)
+            }
+          );
+          summary.durationMs = Date.now() - addressReplayStartedAt;
+          return summary;
+        };
         try {
           const syncAllStartedAt = Date.now();
           await agent.client.conversations.syncAll([
@@ -58256,6 +58416,10 @@ var init_xmtp_sdk = __esm({
             import_node_bindings2.ConsentState.Unknown
           ]);
           summary.syncAllMs = Date.now() - syncAllStartedAt;
+        } catch (err2) {
+          return recordScanFailure("syncAll", err2);
+        }
+        try {
           const listStartedAt = Date.now();
           conversations = await agent.client.conversations.list({
             consentStates: [import_node_bindings2.ConsentState.Allowed, import_node_bindings2.ConsentState.Unknown]
@@ -58263,18 +58427,11 @@ var init_xmtp_sdk = __esm({
           summary.listMs = Date.now() - listStartedAt;
           summary.conversations = conversations.length;
         } catch (err2) {
-          logWithTimestamp(`${tag} conversation sync/list failed, skipping:`, err2);
-          logger.error(
-            LogEvent.OFFLINE_REPLAY_FAILED,
-            err2 instanceof Error ? err2 : void 0,
-            {
-              walletAddress: address,
-              stage: "syncAll/list"
-            }
-          );
-          summary.durationMs = Date.now() - addressReplayStartedAt;
-          return summary;
+          return recordScanFailure("list", err2);
         }
+        const recoveredFailure = this.replayScanFailuresByAddress.get(addressKey);
+        this.replayScanFailuresByAddress.delete(addressKey);
+        this.clearReplayScanRetry(address);
         for (const conv of conversations) {
           try {
             const messagesStartedAt = Date.now();
@@ -58416,8 +58573,15 @@ var init_xmtp_sdk = __esm({
           replayed: String(summary.replayed),
           skipped: String(summary.skipped),
           conversationCount: String(summary.conversations),
-          durationMs: String(Date.now() - addressReplayStartedAt)
+          durationMs: String(Date.now() - addressReplayStartedAt),
+          outcome: "success",
+          replayOutcome: "completed",
+          recoveredAfterFailures: String(recoveredFailure?.consecutiveFailures ?? 0),
+          suppressedAttempts: String(recoveredFailure?.suppressedAttempts ?? 0)
         });
+        summary.outcome = "completed";
+        summary.consecutiveFailures = recoveredFailure?.consecutiveFailures;
+        summary.suppressedAttempts = recoveredFailure?.suppressedAttempts;
         summary.durationMs = Date.now() - addressReplayStartedAt;
         const newestSyncMs = this.syncByAddress.get(address) ?? lastSyncMs;
         logWithTimestamp(
@@ -67106,12 +67270,12 @@ async function runListenerWithLock(options, paths) {
       });
     }
   });
-  service.setPluginVersion("0.2.3-beta-fa7df0d9e7-260810102542");
+  service.setPluginVersion("0.2.3");
   await service.init();
   const pluginVersionStatus = service.pluginVersionStatus;
   if (pluginVersionStatus.unavailable) {
     throw new Error(
-      `@okxweb3/a2a-node v${"0.2.3-beta-fa7df0d9e7-260810102542"} is below the required minimum v${pluginVersionStatus.minVersion}`
+      `@okxweb3/a2a-node v${"0.2.3"} is below the required minimum v${pluginVersionStatus.minVersion}`
     );
   }
   const systemConfig = service.getSystemConfig();
@@ -67129,7 +67293,7 @@ async function runListenerWithLock(options, paths) {
       onchainosAgentId: "*",
       reason: "system-config missing sentryDsn",
       pluginId: "@okxweb3/a2a-node",
-      pluginVersion: "0.2.3-beta-fa7df0d9e7-260810102542"
+      pluginVersion: "0.2.3"
     });
   }
   logWithTimestamp(
@@ -115316,7 +115480,7 @@ async function getCurrentNodeCliVersion() {
   return await getGlobalNpmPackageVersion(UPDATE_PACKAGES.node) ?? getBundledNodeCliVersion();
 }
 function getBundledNodeCliVersion() {
-  return true ? "0.2.3-beta-fa7df0d9e7-260810102542" : null;
+  return true ? "0.2.3" : null;
 }
 function readConfiguredAiProvider() {
   const explicit = process.env.OKX_A2A_AI_PROVIDER || process.env.OKX_AGENT_TASK_AI_CLI;
@@ -115526,7 +115690,7 @@ async function updateHermes(release, options) {
   }
 }
 async function installGatewayPluginForDoctor(target) {
-  const release = isPrereleaseVersion("0.2.3-beta-fa7df0d9e7-260810102542") ? "beta" : "latest";
+  const release = isPrereleaseVersion("0.2.3") ? "beta" : "latest";
   const insideTargetGateway = detectGatewayInvocation() === target;
   const options = {
     restart: !insideTargetGateway,
@@ -116569,7 +116733,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.3-beta-fa7df0d9e7-260810102542" : "0.0.0"),
+    cliVersion: options.cliVersion ?? (true ? "0.2.3" : "0.0.0"),
     fixMode: options.fix === true,
     nonInteractive: options.nonInteractive === true,
     packageChanged: false,
@@ -117566,7 +117730,7 @@ init_sentry_logger();
 init_sentry_config();
 var CURRENT_GATEWAY_SESSION_KEYS_ENV4 = "OKX_A2A_CURRENT_GATEWAY_SESSION_KEYS";
 function printUsage3() {
-  console.log(`okx-a2a ${"0.2.3-beta-fa7df0d9e7-260810102542"}
+  console.log(`okx-a2a ${"0.2.3"}
 
 Usage:
   okx-a2a <command> [options]
@@ -117606,7 +117770,7 @@ Run \`okx-a2a <command> -h\` for command-specific help.
 `);
 }
 function printVersion() {
-  console.log("0.2.3-beta-fa7df0d9e7-260810102542");
+  console.log("0.2.3");
 }
 function printDaemonUsage() {
   console.log(`Usage: okx-a2a daemon <start|restart|stop|status|autostart> [options]
@@ -119042,7 +119206,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.3-beta-fa7df0d9e7-260810102542",
+      packageVersion: "0.2.3",
       agentSdkVersion: "2.3.0",
       nodeSdkVersion: "6.1.0",
       nodeBindingsVersion: "1.11.0"

package/dist/index.js

@@ -19446,7 +19446,15 @@ function classifyError(error, code) {
   if (normalizedCode === "ABORT_ERR" || name === "aborterror") {
     return "cancelled";
   }
-  if (name === "syntaxerror" || /(?:json|response).*(?:parse|invalid)/.test(message)) {
+  if (name === "syntaxerror") {
+    return "invalid_response";
+  }
+  if (/connection\s+(?:reset|closed|interrupted)|broken\s+pipe|unexpected\s+eof/.test(
+    message
+  )) {
+    return "connection_interrupted";
+  }
+  if (/(?:json|response).*(?:parse|invalid)/.test(message)) {
     return "invalid_response";
   }
   if (/session\s+(?:is\s+)?expired|login\s+expired/.test(message)) {
@@ -19743,6 +19751,7 @@ var init_sentry_logger = __esm({
       "releaseBase",
       "releaseChannel",
       "releaseCode",
+      "replayOutcome",
       "role",
       "runId",
       "runtimeContainer",
@@ -32095,7 +32104,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.3-beta-fa7df0d9e7-260810102542",
+      release: "0.2.3",
       environment,
       runtimeContainer: normalizeRuntimeContainer(process.env.OKX_A2A_RUNTIME_CONTAINER)
     };
@@ -33036,7 +33045,7 @@ async function getCurrentNodeCliVersion() {
   return await getGlobalNpmPackageVersion(UPDATE_PACKAGES.node) ?? getBundledNodeCliVersion();
 }
 function getBundledNodeCliVersion() {
-  return true ? "0.2.3-beta-fa7df0d9e7-260810102542" : null;
+  return true ? "0.2.3" : null;
 }
 function readConfiguredAiProvider() {
   const explicit = process.env.OKX_A2A_AI_PROVIDER || process.env.OKX_AGENT_TASK_AI_CLI;
@@ -33246,7 +33255,7 @@ async function updateHermes(release, options) {
   }
 }
 async function installGatewayPluginForDoctor(target) {
-  const release = isPrereleaseVersion("0.2.3-beta-fa7df0d9e7-260810102542") ? "beta" : "latest";
+  const release = isPrereleaseVersion("0.2.3") ? "beta" : "latest";
   const insideTargetGateway = detectGatewayInvocation() === target;
   const options = {
     restart: !insideTargetGateway,
@@ -44118,6 +44127,7 @@ __export(index_exports, {
   registerUserAttentionWatcher: () => registerUserAttentionWatcher,
   releaseActiveDaemon: () => releaseActiveDaemon,
   removeUserAttentionWatcher: () => removeUserAttentionWatcher,
+  replayScanBackoffMs: () => replayScanBackoffMs,
   reportDoctorRunToSentry: () => reportDoctorRunToSentry,
   reportUserNotificationFailure: () => reportUserNotificationFailure,
   resetMessageEligibleOfflineReplayCapabilityForTests: () => resetMessageEligibleOfflineReplayCapabilityForTests,
@@ -55859,6 +55869,8 @@ function compareTimestamp(a, b) {
 var DEFAULT_DATA_DIR = resolveA2aTaskPaths().xmtpDir;
 var XMTP_INSTALLATION_WARNING_THRESHOLD = 2;
 var XMTP_INSTALLATION_NEAR_LIMIT_THRESHOLD = 8;
+var REPLAY_SCAN_INITIAL_BACKOFF_MS = 3e4;
+var REPLAY_SCAN_MAX_BACKOFF_MS = 5 * 6e4;
 function cachePath(dataDir, fileName) {
   return (0, import_node_path21.join)(dataDir, fileName);
 }
@@ -56343,6 +56355,13 @@ function parseGroupPayload(content) {
     return null;
   }
 }
+function replayScanBackoffMs(consecutiveFailures) {
+  const exponent = Math.max(0, Math.floor(consecutiveFailures) - 1);
+  return Math.min(
+    REPLAY_SCAN_INITIAL_BACKOFF_MS * 2 ** exponent,
+    REPLAY_SCAN_MAX_BACKOFF_MS
+  );
+}
 function isOfflineReplayForTrigger(trigger) {
   return trigger === "startup";
 }
@@ -56378,6 +56397,11 @@ var XmtpService = class _XmtpService {
   dataDir = DEFAULT_DATA_DIR;
   syncByAddress = /* @__PURE__ */ new Map();
   offlineReplaySingleFlight = new KeyedSingleFlight();
+  replayScanFailuresByAddress = /* @__PURE__ */ new Map();
+  replayScanRetryByAddress = /* @__PURE__ */ new Map();
+  replayScanNowMs = () => Date.now();
+  replayScanSetTimeout = (callback, delayMs) => setTimeout(callback, delayMs);
+  replayScanClearTimeout = (timer) => clearTimeout(timer);
   inboundReplayGates = /* @__PURE__ */ new Map();
   streamRecoveryCleanupByAddress = /* @__PURE__ */ new Map();
   nextClientGeneration = 1;
@@ -56856,6 +56880,8 @@ var XmtpService = class _XmtpService {
         }
         this.clients.delete(address);
         this.inboundReplayGates.delete(address.toLowerCase());
+        this.replayScanFailuresByAddress.delete(address.toLowerCase());
+        this.clearReplayScanRetry(address);
         logger.info(LogEvent.AGENT_CLIENT_REMOVED, {
           ...agentExtras({
             walletAddress: address,
@@ -57070,6 +57096,8 @@ var XmtpService = class _XmtpService {
         await Promise.resolve(oldClient.stop());
         this.clients.delete(address);
         this.inboundReplayGates.delete(addressKey);
+        this.replayScanFailuresByAddress.delete(addressKey);
+        this.clearReplayScanRetry(address);
         logWithTimestamp(
           `[xmtp-sdk] recycle: stopped client: ${address} (agentId=${agentInfo.agentId})`
         );
@@ -57619,6 +57647,60 @@ var XmtpService = class _XmtpService {
     this.clientGenerationByClient.set(client, generation);
     return generation;
   }
+  clearReplayScanRetry(address) {
+    const addressKey = address.toLowerCase();
+    const scheduled = this.replayScanRetryByAddress.get(addressKey);
+    if (!scheduled) {
+      return;
+    }
+    this.replayScanRetryByAddress.delete(addressKey);
+    this.replayScanClearTimeout(scheduled.timer);
+  }
+  scheduleReplayScanRetry(address, expectedClient, clientGeneration, retryTrigger, delayMs) {
+    const addressKey = address.toLowerCase();
+    const scheduled = this.replayScanRetryByAddress.get(addressKey);
+    if (scheduled?.clientGeneration === clientGeneration) {
+      return;
+    }
+    if (scheduled) {
+      this.clearReplayScanRetry(address);
+    }
+    const timer = this.replayScanSetTimeout(() => {
+      const current = this.replayScanRetryByAddress.get(addressKey);
+      if (current?.timer !== timer) {
+        return;
+      }
+      this.replayScanRetryByAddress.delete(addressKey);
+      if (this.clients.get(address) !== expectedClient || this.stoppedAddresses.has(addressKey)) {
+        return;
+      }
+      void this.replayOfflineMessagesForAddressSingleFlight(
+        address,
+        retryTrigger,
+        void 0,
+        expectedClient
+      ).catch((err) => {
+        logWithTimestamp(
+          `[xmtp-sdk:replay:${address}] scheduled replay scan retry failed:`,
+          err
+        );
+        logger.error(
+          LogEvent.OFFLINE_REPLAY_FAILED,
+          err instanceof Error ? err : new Error(String(err)),
+          {
+            walletAddress: address,
+            stage: "offlineReplay/scheduledRetry",
+            outcome: "failed"
+          }
+        );
+      });
+    }, Math.max(0, delayMs));
+    timer.unref?.();
+    this.replayScanRetryByAddress.set(addressKey, {
+      clientGeneration,
+      timer
+    });
+  }
   notifyAgentsWakeupAfterReplay() {
     const notifyAgentsWakeup2 = this.tools.notifyAgentsWakeup;
     const agentIds = this.allAgents.map((agent) => agent.agentId);
@@ -57857,7 +57939,7 @@ var XmtpService = class _XmtpService {
                 String(recovery.recoverySequence),
                 agent
               );
-              if (!recoveryDisposed && this.clients.get(address) === agent) {
+              if (summary.outcome === "completed" && !recoveryDisposed && this.clients.get(address) === agent) {
                 logger.info(LogEvent.AGENT_STREAM_RECOVERY_REPLAY_COMPLETED, {
                   ...agentExtras(identity),
                   clientGeneration: String(clientGeneration),
@@ -57865,7 +57947,9 @@ var XmtpService = class _XmtpService {
                   replayed: String(summary.replayed),
                   skipped: String(summary.skipped),
                   conversationCount: String(summary.conversations),
-                  replayDurationMs: String(summary.durationMs)
+                  replayDurationMs: String(summary.durationMs),
+                  outcome: "success",
+                  replayOutcome: summary.outcome
                 });
               }
             } catch (err) {
@@ -57931,10 +58015,6 @@ var XmtpService = class _XmtpService {
       summary.durationMs = Date.now() - addressReplayStartedAt;
       return summary;
     }
-    const sentAfterNs = BigInt(lastSyncMs) * 1000000n;
-    logWithTimestamp(
-      `${tag} offline_replay_start agentId=${this.getAgentByAddress(address)?.agentId ?? ""} address=${address} since=${formatLogTimestamp2(lastSyncMs)} sinceMs=${lastSyncMs}`
-    );
     const myInboxId = agent.client.inboxId;
     const handlerDeps = {
       myXmtpAddress: address,
@@ -57949,7 +58029,87 @@ var XmtpService = class _XmtpService {
       summary.durationMs = Date.now() - addressReplayStartedAt;
       return summary;
     }
+    const addressKey = address.toLowerCase();
+    const clientGeneration = this.getClientGeneration(agent);
+    const attemptNowMs = this.replayScanNowMs();
+    let priorFailure = this.replayScanFailuresByAddress.get(addressKey);
+    if (priorFailure && priorFailure.clientGeneration !== clientGeneration) {
+      this.replayScanFailuresByAddress.delete(addressKey);
+      this.clearReplayScanRetry(address);
+      priorFailure = void 0;
+    }
+    if (priorFailure && attemptNowMs < priorFailure.nextAttemptAtMs) {
+      priorFailure.suppressedAttempts++;
+      summary.outcome = "suppressed_backoff";
+      summary.failureStage = priorFailure.lastFailureStage;
+      summary.consecutiveFailures = priorFailure.consecutiveFailures;
+      summary.backoffMs = priorFailure.nextAttemptAtMs - attemptNowMs;
+      summary.suppressedAttempts = priorFailure.suppressedAttempts;
+      if (priorFailure.suppressedAttempts === 1) {
+        logWithTimestamp(
+          `${tag} replay scan suppressed stage=${priorFailure.lastFailureStage} consecutiveFailures=${priorFailure.consecutiveFailures} retryInMs=${summary.backoffMs}`
+        );
+      }
+      this.scheduleReplayScanRetry(
+        address,
+        agent,
+        clientGeneration,
+        priorFailure.retryTrigger,
+        summary.backoffMs
+      );
+      summary.durationMs = Date.now() - addressReplayStartedAt;
+      return summary;
+    }
+    const sentAfterNs = BigInt(lastSyncMs) * 1000000n;
+    logWithTimestamp(
+      `${tag} offline_replay_start agentId=${this.getAgentByAddress(address)?.agentId ?? ""} address=${address} since=${formatLogTimestamp2(lastSyncMs)} sinceMs=${lastSyncMs}`
+    );
     let conversations;
+    const recordScanFailure = (stage, err) => {
+      const previous = this.replayScanFailuresByAddress.get(addressKey);
+      const consecutiveFailures = (previous?.consecutiveFailures ?? 0) + 1;
+      const backoffMs = replayScanBackoffMs(consecutiveFailures);
+      const suppressedAttempts = previous?.suppressedAttempts ?? 0;
+      const failureNowMs = this.replayScanNowMs();
+      const retryTrigger = isOfflineReplayForTrigger(trigger) ? "startup" : "periodic_repair";
+      this.replayScanFailuresByAddress.set(addressKey, {
+        clientGeneration,
+        consecutiveFailures,
+        nextAttemptAtMs: failureNowMs + backoffMs,
+        retryTrigger,
+        suppressedAttempts: 0,
+        lastFailureStage: stage
+      });
+      this.scheduleReplayScanRetry(
+        address,
+        agent,
+        clientGeneration,
+        retryTrigger,
+        backoffMs
+      );
+      summary.outcome = stage === "syncAll" ? "sync_failed" : "list_failed";
+      summary.failureStage = stage;
+      summary.consecutiveFailures = consecutiveFailures;
+      summary.backoffMs = backoffMs;
+      summary.suppressedAttempts = suppressedAttempts;
+      logWithTimestamp(`${tag} conversation ${stage} failed, backing off:`, err);
+      logger.error(
+        LogEvent.OFFLINE_REPLAY_FAILED,
+        err instanceof Error ? err : void 0,
+        {
+          walletAddress: address,
+          stage: `offlineReplay/${stage}`,
+          trigger,
+          outcome: "failed",
+          replayOutcome: summary.outcome,
+          consecutiveFailures: String(consecutiveFailures),
+          backoffMs: String(backoffMs),
+          suppressedAttempts: String(suppressedAttempts)
+        }
+      );
+      summary.durationMs = Date.now() - addressReplayStartedAt;
+      return summary;
+    };
     try {
       const syncAllStartedAt = Date.now();
       await agent.client.conversations.syncAll([
@@ -57957,6 +58117,10 @@ var XmtpService = class _XmtpService {
         import_node_bindings2.ConsentState.Unknown
       ]);
       summary.syncAllMs = Date.now() - syncAllStartedAt;
+    } catch (err) {
+      return recordScanFailure("syncAll", err);
+    }
+    try {
       const listStartedAt = Date.now();
       conversations = await agent.client.conversations.list({
         consentStates: [import_node_bindings2.ConsentState.Allowed, import_node_bindings2.ConsentState.Unknown]
@@ -57964,18 +58128,11 @@ var XmtpService = class _XmtpService {
       summary.listMs = Date.now() - listStartedAt;
       summary.conversations = conversations.length;
     } catch (err) {
-      logWithTimestamp(`${tag} conversation sync/list failed, skipping:`, err);
-      logger.error(
-        LogEvent.OFFLINE_REPLAY_FAILED,
-        err instanceof Error ? err : void 0,
-        {
-          walletAddress: address,
-          stage: "syncAll/list"
-        }
-      );
-      summary.durationMs = Date.now() - addressReplayStartedAt;
-      return summary;
+      return recordScanFailure("list", err);
     }
+    const recoveredFailure = this.replayScanFailuresByAddress.get(addressKey);
+    this.replayScanFailuresByAddress.delete(addressKey);
+    this.clearReplayScanRetry(address);
     for (const conv of conversations) {
       try {
         const messagesStartedAt = Date.now();
@@ -58117,8 +58274,15 @@ var XmtpService = class _XmtpService {
       replayed: String(summary.replayed),
       skipped: String(summary.skipped),
       conversationCount: String(summary.conversations),
-      durationMs: String(Date.now() - addressReplayStartedAt)
+      durationMs: String(Date.now() - addressReplayStartedAt),
+      outcome: "success",
+      replayOutcome: "completed",
+      recoveredAfterFailures: String(recoveredFailure?.consecutiveFailures ?? 0),
+      suppressedAttempts: String(recoveredFailure?.suppressedAttempts ?? 0)
     });
+    summary.outcome = "completed";
+    summary.consecutiveFailures = recoveredFailure?.consecutiveFailures;
+    summary.suppressedAttempts = recoveredFailure?.suppressedAttempts;
     summary.durationMs = Date.now() - addressReplayStartedAt;
     const newestSyncMs = this.syncByAddress.get(address) ?? lastSyncMs;
     logWithTimestamp(
@@ -58185,6 +58349,7 @@ var XmtpService = class _XmtpService {
 function createOfflineReplayAddressSummary(address) {
   return {
     address,
+    outcome: "skipped",
     replayed: 0,
     skipped: 0,
     conversations: 0,
@@ -60016,7 +60181,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     client: {
       id: "gateway-client",
       displayName: "okx-a2a-node",
-      version: "0.2.3-beta-fa7df0d9e7-260810102542",
+      version: "0.2.3",
       platform: "node",
       mode: "backend",
       instanceId
@@ -60027,7 +60192,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     commands: [],
     permissions: {},
     locale: Intl.DateTimeFormat().resolvedOptions().locale || "en-US",
-    userAgent: `okx-a2a-node/${"0.2.3-beta-fa7df0d9e7-260810102542"}`,
+    userAgent: `okx-a2a-node/${"0.2.3"}`,
     auth: {
       ...config.token ? { token: config.token } : {},
       ...config.password ? { password: config.password } : {}
@@ -66066,12 +66231,12 @@ async function runListenerWithLock(options, paths) {
       });
     }
   });
-  service.setPluginVersion("0.2.3-beta-fa7df0d9e7-260810102542");
+  service.setPluginVersion("0.2.3");
   await service.init();
   const pluginVersionStatus = service.pluginVersionStatus;
   if (pluginVersionStatus.unavailable) {
     throw new Error(
-      `@okxweb3/a2a-node v${"0.2.3-beta-fa7df0d9e7-260810102542"} is below the required minimum v${pluginVersionStatus.minVersion}`
+      `@okxweb3/a2a-node v${"0.2.3"} is below the required minimum v${pluginVersionStatus.minVersion}`
     );
   }
   const systemConfig = service.getSystemConfig();
@@ -66089,7 +66254,7 @@ async function runListenerWithLock(options, paths) {
       onchainosAgentId: "*",
       reason: "system-config missing sentryDsn",
       pluginId: "@okxweb3/a2a-node",
-      pluginVersion: "0.2.3-beta-fa7df0d9e7-260810102542"
+      pluginVersion: "0.2.3"
     });
   }
   logWithTimestamp(
@@ -68735,7 +68900,7 @@ async function exportDiagnosticLogs(options) {
     node: process.version,
     platform: process.platform,
     arch: process.arch,
-    packageVersion: true ? "0.2.3-beta-fa7df0d9e7-260810102542" : "unknown",
+    packageVersion: true ? "0.2.3" : "unknown",
     sensitiveContentIncluded: options.includeSensitiveContent,
     listenerAndLlmContentIncluded: true,
     credentialsAlwaysRedacted: true,
@@ -70571,7 +70736,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.3-beta-fa7df0d9e7-260810102542" : "0.0.0"),
+    cliVersion: options.cliVersion ?? (true ? "0.2.3" : "0.0.0"),
     fixMode: options.fix === true,
     nonInteractive: options.nonInteractive === true,
     packageChanged: false,
@@ -70975,6 +71140,7 @@ init_autostart_windows();
   registerUserAttentionWatcher,
   releaseActiveDaemon,
   removeUserAttentionWatcher,
+  replayScanBackoffMs,
   reportDoctorRunToSentry,
   reportUserNotificationFailure,
   resetMessageEligibleOfflineReplayCapabilityForTests,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@okxweb3/a2a-node",
-  "version": "0.2.3-beta-fa7df0d9e7-260810102542",
+  "version": "0.2.3",
   "description": "Host-agnostic Node CLI for E2E encrypted agent-to-agent communication via XMTP",
   "main": "dist/index.js",
   "bin": {