@okxweb3/a2a-node 0.2.4-beta-e7a52faf6f-260812104443 → 0.2.4

package/dist/cli.js

@@ -26604,7 +26604,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     client: {
       id: "gateway-client",
       displayName: "okx-a2a-node",
-      version: "0.2.4-beta-e7a52faf6f-260812104443",
+      version: "0.2.4",
       platform: "node",
       mode: "backend",
       instanceId
@@ -26615,7 +26615,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     commands: [],
     permissions: {},
     locale: Intl.DateTimeFormat().resolvedOptions().locale || "en-US",
-    userAgent: `okx-a2a-node/${"0.2.4-beta-e7a52faf6f-260812104443"}`,
+    userAgent: `okx-a2a-node/${"0.2.4"}`,
     auth: {
       ...config.token ? { token: config.token } : {},
       ...config.password ? { password: config.password } : {}
@@ -28181,6 +28181,31 @@ var init_runtime_switch = __esm({
   }
 });
 
+// src/job-provider.ts
+function setJobProvider(options) {
+  return options.store.setJobProviderBinding({
+    jobId: options.jobId,
+    provider: normalizeAiProvider(options.provider)
+  });
+}
+function setJobProviderToCurrentPlatform(options) {
+  const provider = detectCurrentAiProvider(options.env ?? process.env);
+  if (!provider) {
+    return null;
+  }
+  return setJobProvider({
+    store: options.store,
+    jobId: options.jobId,
+    provider
+  });
+}
+var init_job_provider = __esm({
+  "src/job-provider.ts"() {
+    "use strict";
+    init_ai_provider();
+  }
+});
+
 // src/task-config.ts
 function resolveAiPermissionPreset(options = {}) {
   const env = options.env ?? process.env;
@@ -28499,7 +28524,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.4-beta-e7a52faf6f-260812104443",
+      release: "0.2.4",
       environment,
       runtimeContainer: normalizeRuntimeContainer(process.env.OKX_A2A_RUNTIME_CONTAINER)
     };
@@ -39669,7 +39694,7 @@ async function exportDiagnosticLogs(options) {
     node: process.version,
     platform: process.platform,
     arch: process.arch,
-    packageVersion: true ? "0.2.4-beta-e7a52faf6f-260812104443" : "unknown",
+    packageVersion: true ? "0.2.4" : "unknown",
     sensitiveContentIncluded: options.includeSensitiveContent,
     listenerAndLlmContentIncluded: true,
     credentialsAlwaysRedacted: true,
@@ -40783,7 +40808,7 @@ function redactArgsForLog(args) {
 function commandForLog(bin, args) {
   return `${bin} ${redactArgsForLog(args).join(" ")}`;
 }
-async function exec(args) {
+async function exec(args, options = {}) {
   const bin = await resolve9();
   const cmd = commandForLog(bin, args);
   logWithTimestamp(`[onchainos] exec: ${cmd}`);
@@ -40797,7 +40822,8 @@ async function exec(args) {
   try {
     const result = await execFileAsync2(invocation.command, invocation.args, {
       windowsHide: true,
-      windowsVerbatimArguments: invocation.windowsVerbatimArguments
+      windowsVerbatimArguments: invocation.windowsVerbatimArguments,
+      timeout: options.timeoutMs
     });
     logWithTimestamp(
       `[onchainos] exec done: ${cmd} (${Date.now() - t0}ms, stdout=${result.stdout.length}B, stderr=${result.stderr.length}B)`
@@ -40830,7 +40856,8 @@ async function exec(args) {
         stdoutBytes: String(Buffer.byteLength(String(err2?.stdout ?? ""), "utf8")),
         cliErrorName: err2 instanceof Error ? err2.name : "",
         cliErrorMessageLength: String(String(err2?.message ?? "").length),
-        durationMs: String(Date.now() - t0)
+        durationMs: String(Date.now() - t0),
+        timeoutMs: String(options.timeoutMs ?? "")
       }
     );
     throw err2;
@@ -55595,14 +55622,24 @@ function extractStreamErrorTelemetry(error) {
   }
   return telemetry;
 }
-function createKeyedFlight(discriminator, operation) {
+function replayFlightDiscriminator(clientGeneration, isOfflineReplay) {
+  return isOfflineReplay ? `startup_offline:${clientGeneration}` : `online_repair:${clientGeneration}`;
+}
+function createKeyedFlight(discriminator, operation, shouldRunAfterActive) {
   let resolve14;
   let reject;
   const promise = new Promise((resolvePromise, rejectPromise) => {
     resolve14 = resolvePromise;
     reject = rejectPromise;
   });
-  return { discriminator, operation, promise, resolve: resolve14, reject };
+  return {
+    discriminator,
+    operation,
+    promise,
+    resolve: resolve14,
+    reject,
+    shouldRunAfterActive
+  };
 }
 var TRANSPORT_FAILURE_PATTERNS, KNOWN_CAUSE_CODES, KNOWN_CAUSE_KINDS, KNOWN_GRPC_METHODS, StreamRecoveryTelemetry, KeyedSingleFlight;
 var init_stream_recovery_telemetry = __esm({
@@ -55630,6 +55667,7 @@ var init_stream_recovery_telemetry = __esm({
       }
       markError(nowMs = Date.now()) {
         if (this.activeRecovery) {
+          this.activeRecovery.candidateStartedAtMs = void 0;
           return {
             recoverySequence: this.activeRecovery.sequence,
             alreadyRecovering: true
@@ -55643,9 +55681,26 @@ var init_stream_recovery_telemetry = __esm({
         if (!this.activeRecovery) {
           return void 0;
         }
+        this.activeRecovery.candidateStartedAtMs = nowMs;
+        return {
+          recoverySequence: this.activeRecovery.sequence,
+          candidateStartedAtMs: nowMs
+        };
+      }
+      markStable(nowMs = Date.now()) {
+        if (this.activeRecovery?.candidateStartedAtMs === void 0) {
+          return void 0;
+        }
         const completed = {
           recoverySequence: this.activeRecovery.sequence,
-          recoveryDurationMs: Math.max(0, nowMs - this.activeRecovery.startedAtMs)
+          recoveryDurationMs: Math.max(
+            0,
+            this.activeRecovery.candidateStartedAtMs - this.activeRecovery.startedAtMs
+          ),
+          recoveryConfirmationDurationMs: Math.max(
+            0,
+            nowMs - this.activeRecovery.startedAtMs
+          )
         };
         this.activeRecovery = void 0;
         return completed;
@@ -55656,7 +55711,7 @@ var init_stream_recovery_telemetry = __esm({
     };
     KeyedSingleFlight = class {
       inFlight = /* @__PURE__ */ new Map();
-      run(key, discriminator, operation) {
+      run(key, discriminator, operation, options = {}) {
         const normalizedKey = key.toLowerCase();
         const state = this.inFlight.get(normalizedKey);
         if (!state) {
@@ -55666,7 +55721,22 @@ var init_stream_recovery_telemetry = __esm({
           return active.promise;
         }
         if (state.active.discriminator === discriminator) {
-          return state.active.promise;
+          if (!options.queueBehindActive) {
+            return state.active.promise;
+          }
+          const queued2 = state.queued.find(
+            (flight3) => flight3.discriminator === discriminator
+          );
+          if (queued2) {
+            return queued2.promise;
+          }
+          const flight2 = createKeyedFlight(
+            discriminator,
+            operation,
+            options.shouldRunAfterActive
+          );
+          state.queued.push(flight2);
+          return flight2.promise;
         }
         const queued = state.queued.find(
           (flight2) => flight2.discriminator === discriminator
@@ -55682,15 +55752,15 @@ var init_stream_recovery_telemetry = __esm({
         void Promise.resolve().then(flight.operation).then(
           (value) => {
             flight.resolve(value);
-            this.advance(key, flight);
+            this.advanceAfterSuccess(key, flight, value);
           },
           (error) => {
             flight.reject(error);
-            this.advance(key, flight);
+            this.advanceAfterFailure(key, flight, error);
           }
         );
       }
-      advance(key, completed) {
+      advanceAfterSuccess(key, completed, value) {
         const state = this.inFlight.get(key);
         if (state?.active !== completed) {
           return;
@@ -55700,6 +55770,29 @@ var init_stream_recovery_telemetry = __esm({
           this.inFlight.delete(key);
           return;
         }
+        if (next.shouldRunAfterActive && !next.shouldRunAfterActive(value)) {
+          next.resolve(value);
+          this.advanceAfterSuccess(key, completed, value);
+          return;
+        }
+        state.active = next;
+        this.execute(key, next);
+      }
+      advanceAfterFailure(key, completed, error) {
+        const state = this.inFlight.get(key);
+        if (state?.active !== completed) {
+          return;
+        }
+        const next = state.queued.shift();
+        if (!next) {
+          this.inFlight.delete(key);
+          return;
+        }
+        if (next.shouldRunAfterActive) {
+          next.reject(error);
+          this.advanceAfterFailure(key, completed, error);
+          return;
+        }
         state.active = next;
         this.execute(key, next);
       }
@@ -56565,11 +56658,11 @@ function replayScanBackoffMs(consecutiveFailures) {
 function isOfflineReplayForTrigger(trigger) {
   return trigger === "startup";
 }
-function replaySingleFlightDiscriminator(trigger, clientGeneration, recoveryIdentity) {
-  if (trigger === "stream_recovery") {
-    return `stream_recovery:${clientGeneration}:${recoveryIdentity ?? "unknown"}`;
-  }
-  return isOfflineReplayForTrigger(trigger) ? `startup_offline:${clientGeneration}` : `online_repair:${clientGeneration}`;
+function replaySingleFlightDiscriminator(trigger, clientGeneration) {
+  return replayFlightDiscriminator(
+    clientGeneration,
+    isOfflineReplayForTrigger(trigger)
+  );
 }
 function createOfflineReplayAddressSummary(address) {
   return {
@@ -56589,7 +56682,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, REPLAY_SCAN_INITIAL_BACKOFF_MS, REPLAY_SCAN_MAX_BACKOFF_MS, SENSITIVE_WORDS_LAZY_RETRY_COOLDOWN_MS, 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, InboundReplayGate, SYSTEM_CONFIG_DEFAULTS, STREAM_RECOVERY_ALERT_THRESHOLD_MS, STREAM_RECOVERY_STABILITY_WINDOW_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";
@@ -56697,6 +56790,7 @@ var init_xmtp_sdk = __esm({
       }
     };
     STREAM_RECOVERY_ALERT_THRESHOLD_MS = 3e4;
+    STREAM_RECOVERY_STABILITY_WINDOW_MS = 1e4;
     REPLAY_GATE_DRAIN_MAX_ATTEMPTS = 3;
     REPLAY_GATE_DRAIN_RETRY_DELAY_MS = 100;
     SEMVER_RE = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+[0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*)?$/;
@@ -56751,6 +56845,9 @@ var init_xmtp_sdk = __esm({
       replayScanClearTimeout = (timer) => clearTimeout(timer);
       inboundReplayGates = /* @__PURE__ */ new Map();
       streamRecoveryCleanupByAddress = /* @__PURE__ */ new Map();
+      streamRecoverySetTimeout = (callback, delayMs) => setTimeout(callback, delayMs);
+      streamRecoveryClearTimeout = (timer) => clearTimeout(timer);
+      streamStartSetTimeout = (callback, delayMs) => setTimeout(callback, delayMs);
       nextClientGeneration = 1;
       clientGenerationByClient = /* @__PURE__ */ new WeakMap();
       resolveStartupReplayCompletion;
@@ -58203,10 +58300,14 @@ var init_xmtp_sdk = __esm({
             }
             const delay = BASE_DELAY_MS * 2 ** attempt;
             logWithTimestamp(`${tag} reconnecting in ${delay}ms (attempt=${attempt + 1})`);
-            setTimeout(() => void startWithRetry(attempt + 1), delay);
+            this.streamStartSetTimeout(
+              () => void startWithRetry(attempt + 1),
+              delay
+            );
           };
           const streamRecovery = new StreamRecoveryTelemetry();
           let recoveryTimeout;
+          let recoveryStabilityTimeout;
           let pendingRecoveryGate;
           let recoveryDisposed = false;
           this.cancelStreamRecoveryForAddress(address);
@@ -58214,9 +58315,13 @@ var init_xmtp_sdk = __esm({
             recoveryDisposed = true;
             streamRecovery.cancel();
             if (recoveryTimeout) {
-              clearTimeout(recoveryTimeout);
+              this.streamRecoveryClearTimeout(recoveryTimeout);
               recoveryTimeout = void 0;
             }
+            if (recoveryStabilityTimeout) {
+              this.streamRecoveryClearTimeout(recoveryStabilityTimeout);
+              recoveryStabilityTimeout = void 0;
+            }
           };
           this.streamRecoveryCleanupByAddress.set(
             addressKey,
@@ -58231,6 +58336,10 @@ var init_xmtp_sdk = __esm({
               logger.error(LogEvent.AGENT_UNHANDLED_ERROR, err2, agentExtras(identity));
               return;
             }
+            if (recoveryStabilityTimeout) {
+              this.streamRecoveryClearTimeout(recoveryStabilityTimeout);
+              recoveryStabilityTimeout = void 0;
+            }
             const recovery = streamRecovery.markError();
             const errorTelemetry = extractStreamErrorTelemetry(err2);
             if (!recovery.alreadyRecovering) {
@@ -58245,10 +58354,11 @@ var init_xmtp_sdk = __esm({
               recoveryAlreadyActive: String(recovery.alreadyRecovering)
             });
             if (!recovery.alreadyRecovering) {
-              recoveryTimeout = setTimeout(() => {
+              recoveryTimeout = this.streamRecoverySetTimeout(() => {
                 if (recoveryDisposed || this.clients.get(address) !== agent || this.stoppedAddresses.has(addressKey) || streamRecovery.activeSequence !== recovery.recoverySequence) {
                   return;
                 }
+                recoveryTimeout = void 0;
                 logger.error(LogEvent.AGENT_STREAM_RECOVERY_TIMEOUT, void 0, {
                   ...agentExtras(identity),
                   ...errorTelemetry,
@@ -58257,6 +58367,22 @@ var init_xmtp_sdk = __esm({
                   recoveryDurationMs: String(STREAM_RECOVERY_ALERT_THRESHOLD_MS),
                   thresholdMs: String(STREAM_RECOVERY_ALERT_THRESHOLD_MS)
                 });
+                const timedOutGate = pendingRecoveryGate;
+                pendingRecoveryGate = void 0;
+                void this.drainInboundReplayGate(address, timedOutGate).catch(
+                  (drainError) => {
+                    logger.error(
+                      LogEvent.OFFLINE_REPLAY_FAILED,
+                      drainError instanceof Error ? drainError : new Error(String(drainError)),
+                      {
+                        ...agentExtras(identity),
+                        clientGeneration: String(clientGeneration),
+                        recoverySequence: String(recovery.recoverySequence),
+                        stage: "streamRecovery/timeout-drain-gate"
+                      }
+                    );
+                  }
+                );
               }, STREAM_RECOVERY_ALERT_THRESHOLD_MS);
             }
           });
@@ -58264,60 +58390,61 @@ var init_xmtp_sdk = __esm({
             if (recoveryDisposed || this.clients.get(address) !== agent || this.stoppedAddresses.has(addressKey)) {
               return;
             }
-            const recovery = streamRecovery.markStarted();
-            if (recoveryTimeout) {
-              clearTimeout(recoveryTimeout);
-              recoveryTimeout = void 0;
-            }
+            const candidate = streamRecovery.markStarted();
             logWithTimestamp(
               `${tag} agent stream started agentId=${identity.onchainosAgentId ?? "(unknown)"} inboxId=${identity.inboxId ?? "(unknown)"} role=${identity.role ?? "(unknown)"} consentStates=Allowed,Unknown lastSync=${formatLogTimestamp2(this.syncByAddress.get(address))}`
             );
-            if (recovery) {
-              const recoveryGate = pendingRecoveryGate;
-              pendingRecoveryGate = void 0;
-              logger.info(LogEvent.AGENT_STREAM_RECOVERED, {
-                ...agentExtras(identity),
-                clientGeneration: String(clientGeneration),
-                recoverySequence: String(recovery.recoverySequence),
-                recoveryDurationMs: String(recovery.recoveryDurationMs)
-              });
-              void (async () => {
-                try {
-                  const summary = await this.replayOfflineMessagesForStreamRecovery(
-                    address,
-                    String(recovery.recoverySequence),
-                    agent
-                  );
-                  if (summary.outcome === "completed" && !recoveryDisposed && this.clients.get(address) === agent) {
-                    logger.info(LogEvent.AGENT_STREAM_RECOVERY_REPLAY_COMPLETED, {
-                      ...agentExtras(identity),
-                      clientGeneration: String(clientGeneration),
-                      recoverySequence: String(recovery.recoverySequence),
-                      replayed: String(summary.replayed),
-                      skipped: String(summary.skipped),
-                      conversationCount: String(summary.conversations),
-                      replayDurationMs: String(summary.durationMs),
-                      outcome: "success",
-                      replayOutcome: summary.outcome
-                    });
-                  }
-                } catch (err2) {
-                  logWithTimestamp(`${tag} recovery offline replay failed:`, err2);
-                  logger.error(
-                    LogEvent.OFFLINE_REPLAY_FAILED,
-                    err2 instanceof Error ? err2 : new Error(String(err2)),
-                    {
-                      ...agentExtras(identity),
-                      clientGeneration: String(clientGeneration),
-                      recoverySequence: String(recovery.recoverySequence),
-                      stage: "streamRecovery/replay"
-                    }
-                  );
-                } finally {
+            if (candidate) {
+              if (recoveryStabilityTimeout) {
+                this.streamRecoveryClearTimeout(recoveryStabilityTimeout);
+              }
+              recoveryStabilityTimeout = this.streamRecoverySetTimeout(() => {
+                recoveryStabilityTimeout = void 0;
+                if (recoveryDisposed || this.clients.get(address) !== agent || this.stoppedAddresses.has(addressKey) || streamRecovery.activeSequence !== candidate.recoverySequence) {
+                  return;
+                }
+                const recovery = streamRecovery.markStable();
+                if (!recovery) {
+                  return;
+                }
+                if (recoveryTimeout) {
+                  this.streamRecoveryClearTimeout(recoveryTimeout);
+                  recoveryTimeout = void 0;
+                }
+                const recoveryGate = pendingRecoveryGate;
+                pendingRecoveryGate = void 0;
+                logger.info(LogEvent.AGENT_STREAM_RECOVERED, {
+                  ...agentExtras(identity),
+                  clientGeneration: String(clientGeneration),
+                  recoverySequence: String(recovery.recoverySequence),
+                  recoveryDurationMs: String(recovery.recoveryDurationMs),
+                  recoveryConfirmationDurationMs: String(
+                    recovery.recoveryConfirmationDurationMs
+                  ),
+                  stabilityWindowMs: String(STREAM_RECOVERY_STABILITY_WINDOW_MS)
+                });
+                void (async () => {
                   try {
-                    await this.drainInboundReplayGate(address, recoveryGate);
+                    const summary = await this.replayOfflineMessagesForStreamRecovery(
+                      address,
+                      String(recovery.recoverySequence),
+                      agent
+                    );
+                    if (summary.outcome === "completed" && !recoveryDisposed && this.clients.get(address) === agent) {
+                      logger.info(LogEvent.AGENT_STREAM_RECOVERY_REPLAY_COMPLETED, {
+                        ...agentExtras(identity),
+                        clientGeneration: String(clientGeneration),
+                        recoverySequence: String(recovery.recoverySequence),
+                        replayed: String(summary.replayed),
+                        skipped: String(summary.skipped),
+                        conversationCount: String(summary.conversations),
+                        replayDurationMs: String(summary.durationMs),
+                        outcome: "success",
+                        replayOutcome: summary.outcome
+                      });
+                    }
                   } catch (err2) {
-                    logWithTimestamp(`${tag} recovery replay gate drain failed:`, err2);
+                    logWithTimestamp(`${tag} recovery offline replay failed:`, err2);
                     logger.error(
                       LogEvent.OFFLINE_REPLAY_FAILED,
                       err2 instanceof Error ? err2 : new Error(String(err2)),
@@ -58325,12 +58452,28 @@ var init_xmtp_sdk = __esm({
                         ...agentExtras(identity),
                         clientGeneration: String(clientGeneration),
                         recoverySequence: String(recovery.recoverySequence),
-                        stage: "streamRecovery/drain-gate"
+                        stage: "streamRecovery/replay"
                       }
                     );
+                  } finally {
+                    try {
+                      await this.drainInboundReplayGate(address, recoveryGate);
+                    } catch (err2) {
+                      logWithTimestamp(`${tag} recovery replay gate drain failed:`, err2);
+                      logger.error(
+                        LogEvent.OFFLINE_REPLAY_FAILED,
+                        err2 instanceof Error ? err2 : new Error(String(err2)),
+                        {
+                          ...agentExtras(identity),
+                          clientGeneration: String(clientGeneration),
+                          recoverySequence: String(recovery.recoverySequence),
+                          stage: "streamRecovery/drain-gate"
+                        }
+                      );
+                    }
                   }
-                }
-              })();
+                })();
+              }, STREAM_RECOVERY_STABILITY_WINDOW_MS);
             }
             if (process.env.XMTP_FORCE_DEBUG === "true") {
               void logDetails(agent).catch((err2) => {
@@ -58349,7 +58492,7 @@ var init_xmtp_sdk = __esm({
           logWithTimestamp(`${tag} message listener started`);
         });
       }
-      async replayOfflineMessagesForAddress(address, expectedClient, trigger = "periodic_repair") {
+      async replayOfflineMessagesForAddress(address, expectedClient, trigger = "periodic_repair", recoveryIdentity) {
         const addressReplayStartedAt = Date.now();
         const summary = createOfflineReplayAddressSummary(address);
         const isOfflineReplay = isOfflineReplayForTrigger(trigger);
@@ -58449,6 +58592,8 @@ var init_xmtp_sdk = __esm({
               walletAddress: address,
               stage: `offlineReplay/${stage}`,
               trigger,
+              clientGeneration: String(clientGeneration),
+              ...recoveryIdentity ? { recoverySequence: recoveryIdentity } : {},
               outcome: "failed",
               replayOutcome: summary.outcome,
               consecutiveFailures: String(consecutiveFailures),
@@ -58643,8 +58788,7 @@ var init_xmtp_sdk = __esm({
         const clientGeneration = expectedClient ? this.getClientGeneration(expectedClient) : "missing";
         const eligibilityClass = replaySingleFlightDiscriminator(
           trigger,
-          clientGeneration,
-          recoveryIdentity
+          clientGeneration
         );
         return this.offlineReplaySingleFlight.run(
           address,
@@ -58654,9 +58798,14 @@ var init_xmtp_sdk = __esm({
             return this.replayOfflineMessagesForAddress(
               address,
               expectedClient,
-              trigger
+              trigger,
+              recoveryIdentity
             );
-          }
+          },
+          trigger === "stream_recovery" ? {
+            queueBehindActive: true,
+            shouldRunAfterActive: (summary) => summary.outcome === "completed"
+          } : void 0
         );
       }
       async replayOfflineMessagesForStreamRecovery(address, recoveryIdentity, expectedClient) {
@@ -58947,13 +59096,17 @@ function parseWalletLoginStatus(stdout) {
   }
   return response.data.loggedIn;
 }
-async function queryWalletLoginStatus() {
+async function queryWalletLoginStatus(options = {}) {
   logWithTimestamp("[onchainos] checking wallet login status");
-  const { stdout } = await exec(["wallet", "status"]);
+  const { stdout } = await exec(
+    ["wallet", "status"],
+    { timeoutMs: options.timeoutMs ?? WALLET_STATUS_TIMEOUT_MS }
+  );
   const loggedIn = parseWalletLoginStatus(stdout);
   logWithTimestamp(`[onchainos] wallet login status: ${loggedIn ? "logged in" : "logged out"}`);
   return loggedIn;
 }
+var WALLET_STATUS_TIMEOUT_MS;
 var init_wallet_status = __esm({
   "../core/src/xmtp-sdk/onchainos/wallet-status.ts"() {
     "use strict";
@@ -58961,6 +59114,7 @@ var init_wallet_status = __esm({
     init_sentry_logger();
     init_bin();
     init_cli_response();
+    WALLET_STATUS_TIMEOUT_MS = 1e4;
   }
 });
 
@@ -59048,19 +59202,22 @@ function logAgentListResponse(input) {
     onchainosAgentListDiagnosticText: input.stderr
   });
 }
-async function fetchAgentPage(page) {
+async function fetchAgentPage(page, timeoutMs) {
   const startedAt = Date.now();
   let stdout;
   let stderr;
   try {
-    ({ stdout, stderr } = await exec([
-      "agent",
-      "get",
-      "--page",
-      String(page),
-      "--page-size",
-      String(PAGE_SIZE)
-    ]));
+    ({ stdout, stderr } = await exec(
+      [
+        "agent",
+        "get",
+        "--page",
+        String(page),
+        "--page-size",
+        String(PAGE_SIZE)
+      ],
+      { timeoutMs }
+    ));
   } catch (err2) {
     const errStdout = typeof err2?.stdout === "string" ? err2.stdout : "";
     const errStderr = typeof err2?.stderr === "string" ? err2.stderr : "";
@@ -59204,13 +59361,28 @@ async function fetchAgentByAddress(communicationAddress) {
   agentByIdCache.set(res.data.agentId, res.data);
   return res.data;
 }
-async function listAllAgentsWithMetadata(previousFingerprint) {
+async function listAllAgentsWithMetadata(previousFingerprint, options = {}) {
   const startedAt = Date.now();
+  const pageTimeoutMs = positiveTimeoutOrDefault(
+    options.pageTimeoutMs,
+    AGENT_GET_PAGE_TIMEOUT_MS
+  );
+  const totalTimeoutMs = positiveTimeoutOrDefault(
+    options.totalTimeoutMs,
+    AGENT_LIST_TIMEOUT_MS
+  );
   const agents = [];
   const stderrs = [];
   let page = 1;
   while (true) {
-    const { data, stderr } = await fetchAgentPage(page);
+    const remainingMs = totalTimeoutMs - (Date.now() - startedAt);
+    if (remainingMs <= 0) {
+      throw agentListTimeoutError(totalTimeoutMs);
+    }
+    const { data, stderr } = await fetchAgentPage(
+      page,
+      Math.min(pageTimeoutMs, remainingMs)
+    );
     if (stderr) {
       stderrs.push(`page=${page}: ${stderr}`);
     }
@@ -59237,6 +59409,14 @@ async function listAllAgentsWithMetadata(previousFingerprint) {
     durationMs: Date.now() - startedAt
   };
 }
+function positiveTimeoutOrDefault(value, fallback) {
+  return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : fallback;
+}
+function agentListTimeoutError(timeoutMs) {
+  const error = new Error(`onchainos agent list timed out after ${timeoutMs}ms`);
+  error.code = "ETIMEDOUT";
+  return error;
+}
 function fingerprintAgents(agents) {
   return agents.map((a) => [
     a.agentId,
@@ -59437,7 +59617,7 @@ async function fetchSensitiveWords() {
   );
   return result;
 }
-var MESSAGE_ELIGIBILITY_SERVICE_UNAVAILABLE_AI_HINT, lastExpiredNotifyAt, EXPIRED_NOTIFY_COOLDOWN_MS, PAGE_SIZE, agentByIdCache, ONCHAINOS_CHAIN_INDEX;
+var MESSAGE_ELIGIBILITY_SERVICE_UNAVAILABLE_AI_HINT, lastExpiredNotifyAt, EXPIRED_NOTIFY_COOLDOWN_MS, PAGE_SIZE, AGENT_GET_PAGE_TIMEOUT_MS, AGENT_LIST_TIMEOUT_MS, agentByIdCache, ONCHAINOS_CHAIN_INDEX;
 var init_onchainos = __esm({
   "../core/src/xmtp-sdk/onchainos/index.ts"() {
     "use strict";
@@ -59456,6 +59636,8 @@ var init_onchainos = __esm({
     lastExpiredNotifyAt = 0;
     EXPIRED_NOTIFY_COOLDOWN_MS = 5 * 60 * 1e3;
     PAGE_SIZE = 50;
+    AGENT_GET_PAGE_TIMEOUT_MS = 1e4;
+    AGENT_LIST_TIMEOUT_MS = 3e4;
     agentByIdCache = /* @__PURE__ */ new Map();
     ONCHAINOS_CHAIN_INDEX = "196";
   }
@@ -59574,14 +59756,9 @@ var init_signer = __esm({
 });
 
 // ../core/src/a2a/pending-conversation.ts
-function buildPendingConversationBackupNotice(jobId) {
-  return PENDING_CONVERSATION_BACKUP_NOTICE_TEMPLATE.replace("${jobId}", jobId);
-}
-var PENDING_CONVERSATION_BACKUP_NOTICE_TEMPLATE;
 var init_pending_conversation = __esm({
   "../core/src/a2a/pending-conversation.ts"() {
     "use strict";
-    PENDING_CONVERSATION_BACKUP_NOTICE_TEMPLATE = "[event:provider_conversation][jobId:${jobId}] There are new conversation requests pending.";
   }
 });
 
@@ -65683,17 +65860,22 @@ async function maybeAllowProviderGroup(deps, chatType, conversationId) {
     );
   }
 }
-function shouldKeepInboundGroupPendingForBuyer(input) {
-  return input.consentState === import_node_bindings2.ConsentState.Unknown && !input.hasExistingSession && (input.localAgentRole === 1 /* CLIENT */ || input.localAgentRole == null);
-}
-function buildPendingConversationBackupDispatch(input) {
-  return {
-    sessionKey: buildBackupJobSessionKey(input.jobId),
-    content: buildPendingConversationBackupNotice(input.jobId),
-    messageId: `pending-conversation:${input.messageId}`,
+function ensureInboundGroupSession(deps, input) {
+  const sessionKey = buildSessionKey({
     jobId: input.jobId,
-    agentId: null
-  };
+    myAgentId: input.myAgentId,
+    toAgentId: input.toAgentId
+  });
+  deps.sessionStore?.upsertSession({
+    sessionKey,
+    jobId: input.jobId,
+    myAgentId: input.myAgentId,
+    toAgentId: input.toAgentId,
+    groupId: input.groupId,
+    myAgentXmtpAddress: deps.myXmtpAddress,
+    toAgentXmtpAddress: input.toAgentXmtpAddress
+  });
+  return sessionKey;
 }
 function inboundStageExtras(stage, outcome) {
   return {
@@ -65750,30 +65932,6 @@ function buildInboundTerminalExtras(input) {
     })
   };
 }
-function notifyPendingConversationToBackup(params) {
-  const event = buildPendingConversationBackupDispatch({
-    jobId: params.jobId,
-    messageId: params.messageId
-  });
-  void Promise.resolve(params.deps.onSessionMessage?.(event)).catch((err2) => {
-    logWithTimestamp(`[okx-agent-task:${params.deps.myXmtpAddress}] pending conversation backup dispatch failed:`, err2);
-    logger.error(LogEvent.INBOUND_DISPATCH_FAILED, toLoggableError(err2), {
-      ...buildInboundTerminalExtras({
-        terminalState: "dispatch_failed",
-        myXmtpAddress: params.deps.myXmtpAddress,
-        messageId: event.messageId,
-        jobId: params.jobId,
-        sessionKey: event.sessionKey,
-        route: "backup",
-        reason: "pending_backup_dispatch_failed"
-      }),
-      // Each fire-and-forget dispatch overrides the generic checkpoint with the
-      // `_failed` twin of its own success checkpoint, so the four paths stay
-      // distinguishable in the funnel.
-      checkpoint: "inbound/pending_backup_dispatch_failed"
-    });
-  });
-}
 function maybeNotifyInboundAgentMessage(params) {
   if (params.chatType === "dm") {
     return;
@@ -66581,7 +66739,7 @@ async function processFileMessage(ctx, deps, options = {}) {
     }
     const sender = isPlainObject3(payloadObject?.sender) ? payloadObject.sender : null;
     const localAgent = service.getAgentByAddress(deps.myXmtpAddress);
-    const myAgentId = localAgent?.agentId ?? sessionAgentId ?? null;
+    const myAgentId = localAgent?.agentId ?? readString5(payloadObject?.receiverAgentId) ?? sessionAgentId ?? null;
     const toAgentId = readString5(sender?.agentId);
     const accepted = await verifyInboundA2AGroupMessage({
       payload: parsed.parsed ? parsed.payload : null,
@@ -66599,50 +66757,13 @@ async function processFileMessage(ctx, deps, options = {}) {
     if (!accepted) {
       return true;
     }
-    const sessionKey = buildSessionKey({
-      jobId: route.jobId,
-      myAgentId,
-      toAgentId
-    });
-    const existingSession = deps.sessionStore?.getSession(sessionKey) ?? null;
     const routedMessageId = messageId || `group-${(0, import_node_crypto14.randomUUID)()}`;
-    const consentState = ctx.conversation instanceof Group ? ctx.conversation.consentState() : void 0;
-    if (shouldKeepInboundGroupPendingForBuyer({
-      consentState,
-      localAgentRole: localAgent?.role ?? null,
-      hasExistingSession: !!existingSession
-    })) {
-      logWithTimestamp(
-        `[okx-agent-task:${deps.myXmtpAddress}] buyer inbound group kept pending: session=${sessionKey} job=${shortenLogValue(route.jobId)} group=${conversationId} consent=${String(consentState)} message=${shortenLogValue(routedMessageId)}`
-      );
-      logger.info(LogEvent.INBOUND_BUYER_PENDING, {
-        ...agentExtras({ walletAddress: deps.myXmtpAddress, onchainosAgentId: localAgent?.agentId }),
-        peerWalletAddress: senderAddress,
-        peerInboxId: ctx.message.senderInboxId ?? "",
-        peerAgentId: toAgentId ?? "",
-        taskId: route.jobId,
-        conversationId,
-        messageId: routedMessageId,
-        consentState: String(consentState),
-        ...inboundStageExtras("inbound/buyer_pending", "pending"),
-        reason: "unknown_group_without_session",
-        ...timing.extras()
-      });
-      notifyPendingConversationToBackup({
-        deps,
-        jobId: route.jobId,
-        messageId: routedMessageId
-      });
-      return true;
-    }
-    deps.sessionStore?.upsertSession({
-      sessionKey,
+    const sessionKey = ensureInboundGroupSession(deps, {
       jobId: route.jobId,
       myAgentId,
       toAgentId,
-      groupId: conversationId || null,
-      myAgentXmtpAddress: deps.myXmtpAddress,
-      toAgentXmtpAddress: senderAddress || null
+      groupId: conversationId,
+      toAgentXmtpAddress: senderAddress || readString5(payloadObject?.fromXmtpAddress)
     });
     const dispatchStartedAt = Date.now();
     void Promise.resolve(deps.onSessionMessage?.({
@@ -67068,6 +67189,7 @@ var init_user_attention_watchers = __esm({
 var listener_exports = {};
 __export(listener_exports, {
   AUTH_RECOVERY_PROBE_INTERVAL_MS: () => AUTH_RECOVERY_PROBE_INTERVAL_MS,
+  AUTH_RECOVERY_REFRESH_BACKOFF_MS: () => AUTH_RECOVERY_REFRESH_BACKOFF_MS,
   AgentRefreshAuthGate: () => AgentRefreshAuthGate,
   AgentRefreshCoordinator: () => AgentRefreshCoordinator,
   DEFAULT_OFFLINE_REPLAY_INTERVAL_SEC: () => DEFAULT_OFFLINE_REPLAY_INTERVAL_SEC,
@@ -67333,7 +67455,7 @@ async function runListenerWithLock(options, paths) {
       }
     }),
     notifySessionExpired: (command) => {
-      const rawText = `The onchainos login session has expired while running ${command}. Run \`onchainos wallet login\`; A2A will recover within 60 seconds, or run \`okx-a2a agent refresh\` to recover immediately.`;
+      const rawText = `The onchainos login session has expired while running ${command}. Run \`onchainos wallet login\`; A2A will retry recovery automatically within 60 seconds, or run \`okx-a2a agent refresh\` to retry immediately.`;
       void store.appendBackup(buildSystemStoredMessage({
         reason: "onchainos-session-expired",
         rawText,
@@ -67361,12 +67483,12 @@ async function runListenerWithLock(options, paths) {
       });
     }
   });
-  service.setPluginVersion("0.2.4-beta-e7a52faf6f-260812104443");
+  service.setPluginVersion("0.2.4");
   await service.init();
   const pluginVersionStatus = service.pluginVersionStatus;
   if (pluginVersionStatus.unavailable) {
     throw new Error(
-      `@okxweb3/a2a-node v${"0.2.4-beta-e7a52faf6f-260812104443"} is below the required minimum v${pluginVersionStatus.minVersion}`
+      `@okxweb3/a2a-node v${"0.2.4"} is below the required minimum v${pluginVersionStatus.minVersion}`
     );
   }
   const systemConfig = service.getSystemConfig();
@@ -67384,7 +67506,7 @@ async function runListenerWithLock(options, paths) {
       onchainosAgentId: "*",
       reason: "system-config missing sentryDsn",
       pluginId: "@okxweb3/a2a-node",
-      pluginVersion: "0.2.4-beta-e7a52faf6f-260812104443"
+      pluginVersion: "0.2.4"
     });
   }
   logWithTimestamp(
@@ -67812,7 +67934,7 @@ async function timeSettled(fn) {
     return { durationMs: Date.now() - startedAt, error };
   }
 }
-var import_node_fs25, import_promises13, import_node_os11, import_node_path30, DEFAULT_OFFLINE_REPLAY_INTERVAL_SEC, DEFAULT_XMTP_CLIENT_RECYCLE_INTERVAL_SEC, XMTP_CLIENT_RECYCLE_INTERVAL_ENV, HEARTBEAT_GATEWAY_CHECK_TIMEOUT_MS, AUTH_RECOVERY_PROBE_INTERVAL_MS, AgentRefreshAuthGate, AgentRefreshCoordinator, ListenerDeferredTaskScheduler, ListenerMaintenanceGate, UPGRADE_RECOMMENDATION_IDEMPOTENCY_KEY, SHUTDOWN_FORCE_RESOLVE_MS;
+var import_node_fs25, import_promises13, import_node_os11, import_node_path30, DEFAULT_OFFLINE_REPLAY_INTERVAL_SEC, DEFAULT_XMTP_CLIENT_RECYCLE_INTERVAL_SEC, XMTP_CLIENT_RECYCLE_INTERVAL_ENV, HEARTBEAT_GATEWAY_CHECK_TIMEOUT_MS, AUTH_RECOVERY_PROBE_INTERVAL_MS, AUTH_RECOVERY_REFRESH_BACKOFF_MS, AgentRefreshAuthGate, AgentRefreshCoordinator, ListenerDeferredTaskScheduler, ListenerMaintenanceGate, UPGRADE_RECOMMENDATION_IDEMPOTENCY_KEY, SHUTDOWN_FORCE_RESOLVE_MS;
 var init_listener = __esm({
   "src/listener.ts"() {
     "use strict";
@@ -67846,6 +67968,7 @@ var init_listener = __esm({
     XMTP_CLIENT_RECYCLE_INTERVAL_ENV = "OKX_A2A_XMTP_CLIENT_RECYCLE_INTERVAL_SEC";
     HEARTBEAT_GATEWAY_CHECK_TIMEOUT_MS = 2e3;
     AUTH_RECOVERY_PROBE_INTERVAL_MS = 6e4;
+    AUTH_RECOVERY_REFRESH_BACKOFF_MS = [6e4, 12e4, 3e5];
     AgentRefreshAuthGate = class {
       authBlocked = false;
       get blocked() {
@@ -67870,6 +67993,8 @@ var init_listener = __esm({
       authGate = new AgentRefreshAuthGate();
       refreshInFlight = null;
       recoveryProbeInFlight = null;
+      recoveryRefreshFailureCount = 0;
+      nextRecoveryRefreshAtMs = 0;
       get blocked() {
         return this.authGate.blocked;
       }
@@ -67878,6 +68003,8 @@ var init_listener = __esm({
         try {
           const result = await this.options.lookup(previousFingerprint);
           this.authGate.recordSuccess();
+          this.recoveryRefreshFailureCount = 0;
+          this.nextRecoveryRefreshAtMs = 0;
           if (wasBlocked) {
             this.options.onAuthRecovered?.();
           }
@@ -67899,7 +68026,7 @@ var init_listener = __esm({
         return this.runRefresh();
       }
       runRecoveryProbe() {
-        if (this.options.isStopping() || !this.authGate.blocked || !this.options.checkLoggedIn) {
+        if (this.options.isStopping() || !this.authGate.blocked || !this.options.checkLoggedIn || this.now() < this.nextRecoveryRefreshAtMs) {
           return Promise.resolve(null);
         }
         if (this.recoveryProbeInFlight) {
@@ -67911,8 +68038,15 @@ var init_listener = __esm({
             return null;
           }
           const refresh = await this.runRefresh();
-          return this.authGate.blocked ? null : refresh;
-        })().finally(() => {
+          if (this.authGate.blocked) {
+            this.recordRecoveryRefreshFailure();
+            return null;
+          }
+          return refresh;
+        })().catch((err2) => {
+          this.recordRecoveryRefreshFailure();
+          throw err2;
+        }).finally(() => {
           this.recoveryProbeInFlight = null;
         });
         return this.recoveryProbeInFlight;
@@ -67926,6 +68060,17 @@ var init_listener = __esm({
         });
         return this.refreshInFlight;
       }
+      now() {
+        return this.options.now?.() ?? Date.now();
+      }
+      recordRecoveryRefreshFailure() {
+        const backoffIndex = Math.min(
+          this.recoveryRefreshFailureCount,
+          AUTH_RECOVERY_REFRESH_BACKOFF_MS.length - 1
+        );
+        this.nextRecoveryRefreshAtMs = this.now() + AUTH_RECOVERY_REFRESH_BACKOFF_MS[backoffIndex];
+        this.recoveryRefreshFailureCount += 1;
+      }
     };
     ListenerDeferredTaskScheduler = class {
       timers = /* @__PURE__ */ new Set();
@@ -112545,6 +112690,13 @@ async function watchUserAttention(store, parsed, json) {
     throw new Error("--from-now has been removed; user watch always returns existing pending items first");
   }
   const jobId = normalizeWatchJobId(parsed.options.get("job-id"));
+  if (jobId) {
+    setJobProviderToCurrentPlatform({
+      store,
+      jobId,
+      env: process.env
+    });
+  }
   const provider = readProviderFilter(store, parsed, jobId);
   const preparation = await prepareRuntimeSelectionForWatchedJob(store, jobId, json);
   assertWatchedJobPrepared(jobId, preparation, json);
@@ -113392,6 +113544,7 @@ var init_user_attention_cli = __esm({
     init_session_store();
     init_user_attention_ipc();
     init_ai_provider();
+    init_job_provider();
     init_outbound_behavior();
     init_openclaw_gateway();
     init_openclaw_gateway_config();
@@ -115755,7 +115908,7 @@ async function getCurrentNodeCliVersion() {
   return await getGlobalNpmPackageVersion(UPDATE_PACKAGES.node) ?? getBundledNodeCliVersion();
 }
 function getBundledNodeCliVersion() {
-  return true ? "0.2.4-beta-e7a52faf6f-260812104443" : null;
+  return true ? "0.2.4" : null;
 }
 function readConfiguredAiProvider() {
   const explicit = process.env.OKX_A2A_AI_PROVIDER || process.env.OKX_AGENT_TASK_AI_CLI;
@@ -115965,7 +116118,7 @@ async function updateHermes(release, options) {
   }
 }
 async function installGatewayPluginForDoctor(target) {
-  const release = isPrereleaseVersion("0.2.4-beta-e7a52faf6f-260812104443") ? "beta" : "latest";
+  const release = isPrereleaseVersion("0.2.4") ? "beta" : "latest";
   const insideTargetGateway = detectGatewayInvocation() === target;
   const options = {
     restart: !insideTargetGateway,
@@ -117008,7 +117161,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.4-beta-e7a52faf6f-260812104443" : "0.0.0"),
+    cliVersion: options.cliVersion ?? (true ? "0.2.4" : "0.0.0"),
     fixMode: options.fix === true,
     nonInteractive: options.nonInteractive === true,
     packageChanged: false,
@@ -117996,6 +118149,7 @@ init_command_store();
 init_file_store();
 init_ai_provider();
 init_runtime_switch();
+init_job_provider();
 init_session_store();
 init_paths();
 init_task_config();
@@ -118005,7 +118159,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.4-beta-e7a52faf6f-260812104443"}
+  console.log(`okx-a2a ${"0.2.4"}
 
 Usage:
   okx-a2a <command> [options]
@@ -118045,7 +118199,7 @@ Run \`okx-a2a <command> -h\` for command-specific help.
 `);
 }
 function printVersion() {
-  console.log("0.2.4-beta-e7a52faf6f-260812104443");
+  console.log("0.2.4");
 }
 function printDaemonUsage() {
   console.log(`Usage: okx-a2a daemon <start|restart|stop|status|autostart> [options]
@@ -119184,8 +119338,11 @@ async function handleJobProvider(args) {
     }
     if (subcommand === "set") {
       const jobId = readRequiredOption4(rest, "--job-id");
-      const provider = normalizeAiProvider(readRequiredOption4(rest, "--provider"));
-      const binding = store.setJobProviderBinding({ jobId, provider });
+      const binding = setJobProvider({
+        store,
+        jobId,
+        provider: readRequiredOption4(rest, "--provider")
+      });
       if (json) {
         console.log(JSON.stringify({ ok: true, binding }));
       } else {
@@ -119481,7 +119638,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.4-beta-e7a52faf6f-260812104443",
+      packageVersion: "0.2.4",
       agentSdkVersion: "2.3.0",
       nodeSdkVersion: "6.1.0",
       nodeBindingsVersion: "1.11.0"