@okxweb3/a2a-node 0.1.10-beta-bf67773ad1-260723190921 → 0.1.10

package/dist/cli.js

@@ -4418,6 +4418,274 @@ var init_openclaw_gateway_config = __esm({
   }
 });
 
+// src/session-busy-tracker.ts
+function getSessionBusyTracker() {
+  if (!singleton) {
+    singleton = new SessionBusyTracker();
+  }
+  return singleton;
+}
+var RING_MAX, DEFAULT_STALE_RUN_MS, DEFAULT_STREAM_STALE_MS, DEFAULT_WATCHDOG_INTERVAL_MS, LOG_PREFIX, SessionBusyTracker, singleton;
+var init_session_busy_tracker = __esm({
+  "src/session-busy-tracker.ts"() {
+    "use strict";
+    init_log();
+    RING_MAX = 256;
+    DEFAULT_STALE_RUN_MS = 10 * 60 * 1e3;
+    DEFAULT_STREAM_STALE_MS = 60 * 1e3;
+    DEFAULT_WATCHDOG_INTERVAL_MS = 5 * 1e3;
+    LOG_PREFIX = "[okx-a2a:session-gate]";
+    SessionBusyTracker = class {
+      now;
+      staleRunMs;
+      streamStaleMs;
+      watchdogIntervalMs;
+      /** runIds that reached a terminal state; guards against late/out-of-order deltas. */
+      finalized = [];
+      runWaiters = /* @__PURE__ */ new Map();
+      /** sessionKey → (runId → lastSeenMs). */
+      activeRuns = /* @__PURE__ */ new Map();
+      idleWaiters = /* @__PURE__ */ new Map();
+      lastEventAtMs;
+      lastStreamStaleFireMs = 0;
+      streamStaleHandler = null;
+      pendingWaiters = 0;
+      watchdogTimer = null;
+      constructor(options = {}) {
+        this.now = options.now ?? Date.now;
+        this.staleRunMs = options.staleRunMs ?? DEFAULT_STALE_RUN_MS;
+        this.streamStaleMs = options.streamStaleMs ?? DEFAULT_STREAM_STALE_MS;
+        this.watchdogIntervalMs = options.watchdogIntervalMs ?? DEFAULT_WATCHDOG_INTERVAL_MS;
+        this.lastEventAtMs = this.now();
+      }
+      /** Any event frame arrived (chat/agent/tick/health/...): the stream is alive. */
+      noteEvent() {
+        this.lastEventAtMs = this.now();
+      }
+      /** Reconnect hook invoked when the event stream goes silent while a wait is pending. */
+      setStreamStaleHandler(handler) {
+        this.streamStaleHandler = handler;
+      }
+      notifyChat(payload) {
+        if (!payload || typeof payload !== "object") {
+          return;
+        }
+        const frame = payload;
+        const runId = typeof frame.runId === "string" ? frame.runId : "";
+        const sessionKey = typeof frame.sessionKey === "string" ? frame.sessionKey : "";
+        const state = typeof frame.state === "string" ? frame.state : "";
+        if (!runId) {
+          return;
+        }
+        if (state === "final" || state === "error" || state === "aborted") {
+          this.markDone(sessionKey, runId, state);
+        } else {
+          this.markActive(sessionKey, runId);
+        }
+      }
+      notifyAgent(payload) {
+        if (!payload || typeof payload !== "object") {
+          return;
+        }
+        const frame = payload;
+        const runId = typeof frame.runId === "string" ? frame.runId : "";
+        const sessionKey = typeof frame.sessionKey === "string" ? frame.sessionKey : "";
+        const phase = frame.data && typeof frame.data === "object" ? frame.data.phase : void 0;
+        if (!runId) {
+          return;
+        }
+        if (frame.stream === "lifecycle" && (phase === "end" || phase === "error")) {
+          this.markDone(sessionKey, runId, String(phase));
+        } else {
+          this.markActive(sessionKey, runId);
+        }
+      }
+      isSessionBusy(sessionKey) {
+        const runs = this.activeRuns.get(sessionKey);
+        if (!runs) {
+          return false;
+        }
+        const now = this.now();
+        for (const [runId, lastSeen] of runs) {
+          if (now - lastSeen > this.staleRunMs) {
+            runs.delete(runId);
+          }
+        }
+        if (runs.size === 0) {
+          this.activeRuns.delete(sessionKey);
+          return false;
+        }
+        return true;
+      }
+      waitForSessionIdle(sessionKey, timeoutMs) {
+        if (!this.isSessionBusy(sessionKey)) {
+          return Promise.resolve("idle");
+        }
+        return new Promise((resolve9) => {
+          let waiters = this.idleWaiters.get(sessionKey);
+          if (!waiters) {
+            waiters = /* @__PURE__ */ new Set();
+            this.idleWaiters.set(sessionKey, waiters);
+          }
+          this.beginWait();
+          const entry = (state) => {
+            clearTimeout(timer);
+            this.endWait();
+            resolve9(state);
+          };
+          const timer = setTimeout(() => {
+            const cur = this.idleWaiters.get(sessionKey);
+            if (cur) {
+              cur.delete(entry);
+              if (cur.size === 0) {
+                this.idleWaiters.delete(sessionKey);
+              }
+            }
+            this.endWait();
+            resolve9("timeout");
+          }, timeoutMs);
+          waiters.add(entry);
+        });
+      }
+      waitForRunFinal(runId, timeoutMs) {
+        if (this.finalized.includes(runId)) {
+          return Promise.resolve("already-final");
+        }
+        return new Promise((resolve9) => {
+          let waiters = this.runWaiters.get(runId);
+          if (!waiters) {
+            waiters = /* @__PURE__ */ new Set();
+            this.runWaiters.set(runId, waiters);
+          }
+          this.beginWait();
+          const entry = (state) => {
+            clearTimeout(timer);
+            this.endWait();
+            resolve9(state);
+          };
+          const timer = setTimeout(() => {
+            const cur = this.runWaiters.get(runId);
+            if (cur) {
+              cur.delete(entry);
+              if (cur.size === 0) {
+                this.runWaiters.delete(runId);
+              }
+            }
+            this.endWait();
+            resolve9("timeout");
+          }, timeoutMs);
+          waiters.add(entry);
+        });
+      }
+      _debugSnapshot() {
+        return {
+          active: Array.from(this.activeRuns, ([key, runs]) => {
+            return [key, Array.from(runs.keys())];
+          }),
+          finalizedTail: this.finalized.slice(-10)
+        };
+      }
+      rememberFinalized(runId) {
+        if (!this.finalized.includes(runId)) {
+          this.finalized.push(runId);
+          if (this.finalized.length > RING_MAX) {
+            this.finalized.shift();
+          }
+        }
+      }
+      markActive(sessionKey, runId) {
+        if (!sessionKey || !runId || this.finalized.includes(runId)) {
+          return;
+        }
+        let runs = this.activeRuns.get(sessionKey);
+        if (!runs) {
+          runs = /* @__PURE__ */ new Map();
+          this.activeRuns.set(sessionKey, runs);
+        }
+        runs.set(runId, this.now());
+      }
+      markDone(sessionKey, runId, state) {
+        if (runId) {
+          this.rememberFinalized(runId);
+          const waiters = this.runWaiters.get(runId);
+          if (waiters) {
+            this.runWaiters.delete(runId);
+            for (const fn of waiters) {
+              fn(state);
+            }
+          }
+          const runs = sessionKey ? this.activeRuns.get(sessionKey) : void 0;
+          if (runs) {
+            runs.delete(runId);
+            if (runs.size === 0) {
+              this.activeRuns.delete(sessionKey);
+            }
+          } else {
+            for (const [key, sessionRuns] of this.activeRuns) {
+              if (sessionRuns.delete(runId) && sessionRuns.size === 0) {
+                this.activeRuns.delete(key);
+              }
+            }
+          }
+        }
+        if (sessionKey) {
+          this.releaseIdleWaiters(sessionKey);
+        }
+      }
+      releaseIdleWaiters(sessionKey) {
+        if (!sessionKey || this.isSessionBusy(sessionKey)) {
+          return;
+        }
+        const waiters = this.idleWaiters.get(sessionKey);
+        if (waiters) {
+          this.idleWaiters.delete(sessionKey);
+          for (const fn of waiters) {
+            fn("idle");
+          }
+        }
+      }
+      beginWait() {
+        this.pendingWaiters += 1;
+        if (this.pendingWaiters === 1 && !this.watchdogTimer) {
+          const timer = setInterval(() => {
+            this.checkStreamLiveness();
+          }, this.watchdogIntervalMs);
+          timer.unref?.();
+          this.watchdogTimer = timer;
+        }
+      }
+      endWait() {
+        this.pendingWaiters = Math.max(0, this.pendingWaiters - 1);
+        if (this.pendingWaiters === 0 && this.watchdogTimer) {
+          clearInterval(this.watchdogTimer);
+          this.watchdogTimer = null;
+        }
+      }
+      checkStreamLiveness() {
+        const now = this.now();
+        if (now - this.lastEventAtMs <= this.streamStaleMs) {
+          return;
+        }
+        if (now - this.lastStreamStaleFireMs <= this.streamStaleMs) {
+          return;
+        }
+        this.lastStreamStaleFireMs = now;
+        errorWithTimestamp(
+          `${LOG_PREFIX} event stream stale (${now - this.lastEventAtMs}ms since last event, threshold=${this.streamStaleMs}ms), invoking recovery handler`
+        );
+        try {
+          this.streamStaleHandler?.();
+        } catch (err2) {
+          errorWithTimestamp(
+            `${LOG_PREFIX} stream recovery handler failed: ${err2 instanceof Error ? err2.message : String(err2)}`
+          );
+        }
+      }
+    };
+    singleton = null;
+  }
+});
+
 // ../../node_modules/ws/lib/constants.js
 var require_constants = __commonJS({
   "../../node_modules/ws/lib/constants.js"(exports2, module2) {
@@ -8107,6 +8375,17 @@ function createDefaultWebSocket(url) {
   }
   return new Ctor(url);
 }
+function ensureStreamStaleHandlerRegistered() {
+  if (streamStaleHandlerRegistered) {
+    return;
+  }
+  streamStaleHandlerRegistered = true;
+  getSessionBusyTracker().setStreamStaleHandler(() => {
+    errorWithTimestamp(`${LOG_PREFIX2} [session-gate] event stream stale, forcing gateway reconnect`);
+    clearClient();
+    void isOpenClawA2aPluginAvailable();
+  });
+}
 function resolveOpenClawGatewayConfig(env = process.env) {
   const synced = readSyncedGatewayConfig(env);
   const explicitUrl = env.OKX_A2A_OPENCLAW_GATEWAY_URL?.trim() || void 0;
@@ -8123,12 +8402,13 @@ function resolveOpenClawGatewayConfig(env = process.env) {
 }
 function clearClient() {
   if (sharedClient) {
-    errorWithTimestamp(`${LOG_PREFIX} clear client`);
+    errorWithTimestamp(`${LOG_PREFIX2} clear client`);
     sharedClient.close();
   }
   sharedClient = null;
 }
 async function ensureClient(timeoutMs) {
+  ensureStreamStaleHandlerRegistered();
   if (sharedClient?.isReady()) {
     return sharedClient;
   }
@@ -8152,7 +8432,7 @@ async function ensureClient(timeoutMs) {
     const remainingMs = Math.max(1, timeoutMs - elapsedMs);
     const fallbackProtocol = firstProtocol === PREFERRED_PROTOCOL_VERSION ? LEGACY_PROTOCOL_VERSION : PREFERRED_PROTOCOL_VERSION;
     errorWithTimestamp(
-      `${LOG_PREFIX} protocol fallback from=${firstProtocol} to=${fallbackProtocol} remainingMs=${remainingMs}: ${formatErrorMessage(err2)}`
+      `${LOG_PREFIX2} protocol fallback from=${firstProtocol} to=${fallbackProtocol} remainingMs=${remainingMs}: ${formatErrorMessage(err2)}`
     );
     const fallbackClient = new MinimalGatewayClient(config, fallbackProtocol);
     sharedClient = fallbackClient;
@@ -8163,7 +8443,7 @@ async function ensureClient(timeoutMs) {
 }
 function stopOpenClawGateway() {
   if (!sharedClient) {
-    errorWithTimestamp(`${LOG_PREFIX} stop requested with no active client`);
+    errorWithTimestamp(`${LOG_PREFIX2} stop requested with no active client`);
     return;
   }
   clearClient();
@@ -8171,12 +8451,12 @@ function stopOpenClawGateway() {
 async function callOpenClawGateway(opts) {
   const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
   const startedAt = Date.now();
-  errorWithTimestamp(`${LOG_PREFIX} rpc start method=${opts.method} timeoutMs=${timeoutMs}`);
+  errorWithTimestamp(`${LOG_PREFIX2} rpc start method=${opts.method} timeoutMs=${timeoutMs}`);
   for (let attempt = 0; ; attempt += 1) {
     try {
       const client = await ensureClient(timeoutMs);
       const result = await client.request(opts.method, opts.params, { timeoutMs });
-      errorWithTimestamp(`${LOG_PREFIX} rpc ok method=${opts.method} durationMs=${Date.now() - startedAt} attempts=${attempt + 1}`);
+      errorWithTimestamp(`${LOG_PREFIX2} rpc ok method=${opts.method} durationMs=${Date.now() - startedAt} attempts=${attempt + 1}`);
       return result;
     } catch (err2) {
       const message = err2 instanceof Error ? err2.message : String(err2);
@@ -8186,13 +8466,13 @@ async function callOpenClawGateway(opts) {
       }
       if (isGatewayStartingError(err2) && delayMs !== void 0 && Date.now() + delayMs - startedAt < timeoutMs) {
         errorWithTimestamp(
-          `${LOG_PREFIX} rpc retry method=${opts.method} attempt=${attempt + 1} delayMs=${delayMs}: ${message}`
+          `${LOG_PREFIX2} rpc retry method=${opts.method} attempt=${attempt + 1} delayMs=${delayMs}: ${message}`
         );
         await sleep2(delayMs);
         continue;
       }
       errorWithTimestamp(
-        `${LOG_PREFIX} rpc failed method=${opts.method} durationMs=${Date.now() - startedAt} attempts=${attempt + 1}: ${message}`
+        `${LOG_PREFIX2} rpc failed method=${opts.method} durationMs=${Date.now() - startedAt} attempts=${attempt + 1}: ${message}`
       );
       if (isGatewayStartingError(err2)) {
         throw Object.assign(
@@ -8291,7 +8571,7 @@ function readSyncedGatewayConfig(env) {
       token: synced.token
     };
   } catch (err2) {
-    errorWithTimestamp(`${LOG_PREFIX} failed to read synced gateway config: ${err2 instanceof Error ? err2.message : String(err2)}`);
+    errorWithTimestamp(`${LOG_PREFIX2} failed to read synced gateway config: ${err2 instanceof Error ? err2.message : String(err2)}`);
     return null;
   }
 }
@@ -8302,7 +8582,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     client: {
       id: "gateway-client",
       displayName: "okx-a2a-node",
-      version: "0.1.10-beta-bf67773ad1-260723190921",
+      version: "0.1.10",
       platform: "node",
       mode: "backend",
       instanceId
@@ -8313,7 +8593,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     commands: [],
     permissions: {},
     locale: Intl.DateTimeFormat().resolvedOptions().locale || "en-US",
-    userAgent: `okx-a2a-node/${"0.1.10-beta-bf67773ad1-260723190921"}`,
+    userAgent: `okx-a2a-node/${"0.1.10"}`,
     auth: {
       ...config.token ? { token: config.token } : {},
       ...config.password ? { password: config.password } : {}
@@ -8379,24 +8659,26 @@ function isSessionNotFound(err2) {
   const msg = String(e?.message ?? "");
   return (code2 === "INVALID_REQUEST" || code2 === "SESSION_NOT_FOUND") && msg.includes("session not found");
 }
-var import_node_crypto3, DEFAULT_GATEWAY_PORT, DEFAULT_TIMEOUT_MS, DEFAULT_HEALTH_TIMEOUT_MS, PREFERRED_PROTOCOL_VERSION, LEGACY_PROTOCOL_VERSION, DEFAULT_SCOPES, LOG_PREFIX, GATEWAY_STARTING_RETRY_DELAYS_MS, wsFactory, preferredGatewayProtocolVersion, sharedClient, isOpenClawGatewayAvailable, MinimalGatewayClient;
+var import_node_crypto3, DEFAULT_GATEWAY_PORT, DEFAULT_TIMEOUT_MS, DEFAULT_HEALTH_TIMEOUT_MS, PREFERRED_PROTOCOL_VERSION, LEGACY_PROTOCOL_VERSION, DEFAULT_SCOPES, LOG_PREFIX2, GATEWAY_STARTING_RETRY_DELAYS_MS, wsFactory, preferredGatewayProtocolVersion, sharedClient, streamStaleHandlerRegistered, isOpenClawGatewayAvailable, MinimalGatewayClient;
 var init_openclaw_gateway = __esm({
   "src/openclaw-gateway.ts"() {
     "use strict";
     init_log();
     import_node_crypto3 = require("node:crypto");
     init_openclaw_gateway_config();
+    init_session_busy_tracker();
     DEFAULT_GATEWAY_PORT = 18789;
     DEFAULT_TIMEOUT_MS = 2e4;
     DEFAULT_HEALTH_TIMEOUT_MS = 2e3;
     PREFERRED_PROTOCOL_VERSION = 4;
     LEGACY_PROTOCOL_VERSION = 3;
     DEFAULT_SCOPES = ["operator.admin"];
-    LOG_PREFIX = "[okx-a2a:gateway]";
+    LOG_PREFIX2 = "[okx-a2a:gateway]";
     GATEWAY_STARTING_RETRY_DELAYS_MS = [300, 700, 1200, 2e3, 3e3];
     wsFactory = createDefaultWebSocket;
     preferredGatewayProtocolVersion = PREFERRED_PROTOCOL_VERSION;
     sharedClient = null;
+    streamStaleHandlerRegistered = false;
     isOpenClawGatewayAvailable = isOpenClawA2aPluginAvailable;
     MinimalGatewayClient = class {
       config;
@@ -8416,7 +8698,7 @@ var init_openclaw_gateway = __esm({
       }
       async connect(timeoutMs) {
         errorWithTimestamp(
-          `${LOG_PREFIX} connect url=${this.config.url} source=${this.config.source} instanceId=${this.instanceId} protocol=${this.protocolVersion} passwordConfigured=${!!this.config.password} tokenConfigured=${!!this.config.token} scopes=${DEFAULT_SCOPES.join(",")}`
+          `${LOG_PREFIX2} connect url=${this.config.url} source=${this.config.source} instanceId=${this.instanceId} protocol=${this.protocolVersion} passwordConfigured=${!!this.config.password} tokenConfigured=${!!this.config.token} scopes=${DEFAULT_SCOPES.join(",")}`
         );
         const ws = wsFactory(this.config.url);
         this.ws = ws;
@@ -8472,7 +8754,7 @@ var init_openclaw_gateway = __esm({
             }
           });
         });
-        errorWithTimestamp(`${LOG_PREFIX} hello ok instanceId=${this.instanceId} protocol=${this.protocolVersion}`);
+        errorWithTimestamp(`${LOG_PREFIX2} hello ok instanceId=${this.instanceId} protocol=${this.protocolVersion}`);
       }
       request(method, params, options = {}) {
         if (method === "connect") {
@@ -8548,7 +8830,17 @@ var init_openclaw_gateway = __esm({
         try {
           frame = JSON.parse(String(raw));
         } catch (err2) {
-          errorWithTimestamp(`${LOG_PREFIX} invalid frame: ${err2 instanceof Error ? err2.message : String(err2)}`);
+          errorWithTimestamp(`${LOG_PREFIX2} invalid frame: ${err2 instanceof Error ? err2.message : String(err2)}`);
+          return;
+        }
+        if (frame.type === "event") {
+          const gate = getSessionBusyTracker();
+          gate.noteEvent();
+          if (frame.event === "chat") {
+            gate.notifyChat(frame.payload);
+          } else if (frame.event === "agent") {
+            gate.notifyAgent(frame.payload);
+          }
           return;
         }
         if (frame.type !== "res") {
@@ -8570,7 +8862,7 @@ var init_openclaw_gateway = __esm({
         pending.reject(toGatewayError(frame.error));
       }
       handleClose(code2, reason) {
-        errorWithTimestamp(`${LOG_PREFIX} closed instanceId=${this.instanceId} code=${code2 ?? 0} reason=${reason || "no reason"}`);
+        errorWithTimestamp(`${LOG_PREFIX2} closed instanceId=${this.instanceId} code=${code2 ?? 0} reason=${reason || "no reason"}`);
         this.ready = false;
         for (const [id, pending] of this.pending) {
           clearTimeout(pending.timer);
@@ -9328,8 +9620,8 @@ var require_worldwide = __commonJS({
     function getGlobalSingleton(name2, creator, obj) {
       const gbl = obj || GLOBAL_OBJ;
       const __SENTRY__ = gbl.__SENTRY__ = gbl.__SENTRY__ || {};
-      const singleton = __SENTRY__[name2] || (__SENTRY__[name2] = creator());
-      return singleton;
+      const singleton2 = __SENTRY__[name2] || (__SENTRY__[name2] = creator());
+      return singleton2;
     }
     exports2.GLOBAL_OBJ = GLOBAL_OBJ;
     exports2.getGlobalObject = getGlobalObject;
@@ -24824,6 +25116,13 @@ var init_sentry_logger = __esm({
 });
 
 // src/outbound-behavior.ts
+function resolveSessionGateFallbackMs(env = process.env) {
+  const raw = Number(env.OKX_A2A_SESSION_GATE_FALLBACK_MS ?? "");
+  if (Number.isFinite(raw) && raw > 0) {
+    return raw;
+  }
+  return DEFAULT_SESSION_GATE_FALLBACK_MS;
+}
 function resolveUserDeliveryId(input) {
   return input.idempotencyKey?.trim() || (0, import_node_crypto5.randomUUID)();
 }
@@ -24884,7 +25183,7 @@ function createOutboundBehavior(provider, deps) {
   }
   return new SqliteOutboundBehavior(provider, deps);
 }
-var import_node_crypto5, SqliteOutboundBehavior, DEFAULT_GATEWAY_PORT2, GATEWAY_OUTBOUND_LOG_PREFIX, GatewayOutboundBehavior;
+var import_node_crypto5, SqliteOutboundBehavior, DEFAULT_GATEWAY_PORT2, GATEWAY_OUTBOUND_LOG_PREFIX, DEFAULT_SESSION_GATE_FALLBACK_MS, GatewayOutboundBehavior;
 var init_outbound_behavior = __esm({
   "src/outbound-behavior.ts"() {
     "use strict";
@@ -24893,6 +25192,7 @@ var init_outbound_behavior = __esm({
     init_user_attention_ipc();
     init_openclaw_gateway();
     init_openclaw_session_key();
+    init_session_busy_tracker();
     init_openclaw_route();
     init_sentry_logger();
     SqliteOutboundBehavior = class {
@@ -24968,15 +25268,25 @@ var init_outbound_behavior = __esm({
       callPromptUserToLatestSessions
     };
     GATEWAY_OUTBOUND_LOG_PREFIX = "[okx-a2a:gateway-outbound]";
+    DEFAULT_SESSION_GATE_FALLBACK_MS = 3e5;
     GatewayOutboundBehavior = class {
       provider = "openclaw";
       gateway;
       store;
       sessionMetaStore;
+      /** `undefined` = default (resolve the shared tracker lazily on first dispatch); `null` = disabled. */
+      sessionGateOption;
       constructor(options = {}) {
         this.gateway = options.gateway ?? DEFAULT_GATEWAY_PORT2;
         this.store = options.store;
         this.sessionMetaStore = options.store;
+        this.sessionGateOption = options.sessionGate;
+      }
+      resolveSessionGate() {
+        if (this.sessionGateOption === void 0) {
+          return getSessionBusyTracker();
+        }
+        return this.sessionGateOption;
       }
       async createSession(input) {
         const gatewaySessionKey = this.resolveGatewaySessionKey(input);
@@ -25029,8 +25339,19 @@ var init_outbound_behavior = __esm({
         errorWithTimestamp(
           `${GATEWAY_OUTBOUND_LOG_PREFIX} dispatchSessionMessage sessionKey=${input.sessionKey} gatewaySessionKey=${gatewaySessionKey} jobId=${input.jobId ?? "(none)"} agentId=${input.agentId ?? "(none)"} messageId=${input.messageId ?? "(none)"}`
         );
+        const sessionGate = this.resolveSessionGate();
+        const gateFallbackMs = resolveSessionGateFallbackMs();
+        if (sessionGate?.isSessionBusy(gatewaySessionKey)) {
+          errorWithTimestamp(
+            `${GATEWAY_OUTBOUND_LOG_PREFIX} [session-gate] busy, waiting idle sessionKey=${input.sessionKey} gatewaySessionKey=${gatewaySessionKey} (fallbackMs=${gateFallbackMs})`
+          );
+          const idleState = await sessionGate.waitForSessionIdle(gatewaySessionKey, gateFallbackMs);
+          errorWithTimestamp(
+            `${GATEWAY_OUTBOUND_LOG_PREFIX} [session-gate] idle wait done sessionKey=${input.sessionKey} gatewaySessionKey=${gatewaySessionKey} result=${idleState}`
+          );
+        }
         try {
-          await this.gateway.callSessionsSend({
+          const sendResult = await this.gateway.callSessionsSend({
             key: gatewaySessionKey,
             message: input.content,
             ...input.messageId ? { idempotencyKey: input.messageId } : {}
@@ -25045,6 +25366,16 @@ var init_outbound_behavior = __esm({
             messageId: input.messageId ?? "",
             status: "delivered"
           }));
+          const gateRunId = sendResult && typeof sendResult === "object" && typeof sendResult.runId === "string" ? sendResult.runId : input.messageId;
+          if (sessionGate && typeof gateRunId === "string" && gateRunId) {
+            errorWithTimestamp(
+              `${GATEWAY_OUTBOUND_LOG_PREFIX} [session-gate] holding sessionKey=${input.sessionKey} gatewaySessionKey=${gatewaySessionKey} runId=${gateRunId} until run final/error (fallbackMs=${gateFallbackMs})`
+            );
+            const gateState = await sessionGate.waitForRunFinal(gateRunId, gateFallbackMs);
+            errorWithTimestamp(
+              `${GATEWAY_OUTBOUND_LOG_PREFIX} [session-gate] released sessionKey=${input.sessionKey} gatewaySessionKey=${gatewaySessionKey} runId=${gateRunId} state=${gateState}`
+            );
+          }
         } catch (err2) {
           if (!this.store || !isRetryableOpenClawGatewayError(err2)) {
             logger.error(LogEvent.GATEWAY_REQUEST_FAILED, err2 instanceof Error ? err2 : new Error(String(err2)), gatewayOutboundExtra("sessions.send", {
@@ -25584,7 +25915,7 @@ var init_sentry_config = __esm({
     environment = process.env.SENTRY_ENV === "dev" ? "dev" : "prod";
     SENTRY_CONFIG = {
       projectName: "okx/openclaw-okx-a2a-extension",
-      release: "0.1.10-beta-bf67773ad1-260723190921",
+      release: "0.1.10",
       environment,
       runtimeContainer: normalizeRuntimeContainer(process.env.OKX_A2A_RUNTIME_CONTAINER)
     };
@@ -94318,12 +94649,12 @@ async function runListenerWithLock(options, paths) {
       });
     }
   });
-  service.setPluginVersion("0.1.10-beta-bf67773ad1-260723190921");
+  service.setPluginVersion("0.1.10");
   await service.init();
   const pluginVersionStatus = service.pluginVersionStatus;
   if (pluginVersionStatus.unavailable) {
     throw new Error(
-      `@okxweb3/a2a-node v${"0.1.10-beta-bf67773ad1-260723190921"} is below the required minimum v${pluginVersionStatus.minVersion}`
+      `@okxweb3/a2a-node v${"0.1.10"} is below the required minimum v${pluginVersionStatus.minVersion}`
     );
   }
   const systemConfig = service.getSystemConfig();
@@ -94341,7 +94672,7 @@ async function runListenerWithLock(options, paths) {
       onchainosAgentId: "*",
       reason: "system-config missing sentryDsn",
       pluginId: "@okxweb3/a2a-node",
-      pluginVersion: "0.1.10-beta-bf67773ad1-260723190921"
+      pluginVersion: "0.1.10"
     });
   }
   logWithTimestamp(
@@ -98363,7 +98694,7 @@ async function getCurrentNodeCliVersion() {
   return await getGlobalNpmPackageVersion(UPDATE_PACKAGES.node) ?? getBundledNodeCliVersion();
 }
 function getBundledNodeCliVersion() {
-  return true ? "0.1.10-beta-bf67773ad1-260723190921" : null;
+  return true ? "0.1.10" : null;
 }
 function readConfiguredAiProvider() {
   const explicit = process.env.OKX_A2A_AI_PROVIDER || process.env.OKX_AGENT_TASK_AI_CLI;
@@ -98573,7 +98904,7 @@ async function updateHermes(release, options) {
   }
 }
 async function installGatewayPluginForDoctor(target) {
-  const release = isPrereleaseVersion("0.1.10-beta-bf67773ad1-260723190921") ? "beta" : "latest";
+  const release = isPrereleaseVersion("0.1.10") ? "beta" : "latest";
   const insideTargetGateway = detectGatewayInvocation() === target;
   const options = {
     restart: !insideTargetGateway,
@@ -99561,7 +99892,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.1.10-beta-bf67773ad1-260723190921" : "0.0.0"),
+    cliVersion: options.cliVersion ?? (true ? "0.1.10" : "0.0.0"),
     fixMode: options.fix === true,
     nonInteractive: options.nonInteractive === true,
     packageChanged: false,
@@ -100693,7 +101024,7 @@ init_sentry_logger();
 init_sentry_config();
 var CURRENT_GATEWAY_SESSION_KEYS_ENV4 = "OKX_A2A_CURRENT_GATEWAY_SESSION_KEYS";
 function printUsage2() {
-  console.log(`okx-a2a ${"0.1.10-beta-bf67773ad1-260723190921"}
+  console.log(`okx-a2a ${"0.1.10"}
 
 Usage:
   okx-a2a <command> [options]
@@ -100731,7 +101062,7 @@ Run \`okx-a2a <command> -h\` for command-specific help.
 `);
 }
 function printVersion() {
-  console.log("0.1.10-beta-bf67773ad1-260723190921");
+  console.log("0.1.10");
 }
 function printDaemonUsage() {
   console.log(`Usage: okx-a2a daemon <start|restart|stop|status|autostart> [options]
@@ -101977,9 +102308,9 @@ function assertSupportedNodeVersion() {
   const major = Number(majorRaw);
   const minor = Number(minorRaw);
   const patch = Number(patchRaw);
-  const supported = major > 22 || major === 22 && (minor > 13 || minor === 13 && patch >= 0);
+  const supported = major > 22 || major === 22 && (minor > 14 || minor === 14 && patch >= 0);
   if (!supported) {
-    throw new Error(`okx-a2a requires Node.js >= 22.13.0, current=${process.version}`);
+    throw new Error(`okx-a2a requires Node.js >= 22.14.0, current=${process.version}`);
   }
 }
 var cliSentryInitAttempted = false;

package/dist/index.js

@@ -3816,8 +3816,8 @@ var require_worldwide = __commonJS({
     function getGlobalSingleton(name2, creator, obj) {
       const gbl = obj || GLOBAL_OBJ;
       const __SENTRY__ = gbl.__SENTRY__ = gbl.__SENTRY__ || {};
-      const singleton = __SENTRY__[name2] || (__SENTRY__[name2] = creator());
-      return singleton;
+      const singleton2 = __SENTRY__[name2] || (__SENTRY__[name2] = creator());
+      return singleton2;
     }
     exports2.GLOBAL_OBJ = GLOBAL_OBJ;
     exports2.getGlobalObject = getGlobalObject;
@@ -71981,7 +71981,7 @@ var init_sentry_config = __esm({
     environment = process.env.SENTRY_ENV === "dev" ? "dev" : "prod";
     SENTRY_CONFIG = {
       projectName: "okx/openclaw-okx-a2a-extension",
-      release: "0.1.10-beta-bf67773ad1-260723190921",
+      release: "0.1.10",
       environment,
       runtimeContainer: normalizeRuntimeContainer(process.env.OKX_A2A_RUNTIME_CONTAINER)
     };
@@ -72911,7 +72911,7 @@ async function getCurrentNodeCliVersion() {
   return await getGlobalNpmPackageVersion(UPDATE_PACKAGES.node) ?? getBundledNodeCliVersion();
 }
 function getBundledNodeCliVersion() {
-  return true ? "0.1.10-beta-bf67773ad1-260723190921" : null;
+  return true ? "0.1.10" : null;
 }
 function readConfiguredAiProvider() {
   const explicit = process.env.OKX_A2A_AI_PROVIDER || process.env.OKX_AGENT_TASK_AI_CLI;
@@ -73121,7 +73121,7 @@ async function updateHermes(release, options) {
   }
 }
 async function installGatewayPluginForDoctor(target) {
-  const release = isPrereleaseVersion("0.1.10-beta-bf67773ad1-260723190921") ? "beta" : "latest";
+  const release = isPrereleaseVersion("0.1.10") ? "beta" : "latest";
   const insideTargetGateway = detectGatewayInvocation() === target;
   const options = {
     restart: !insideTargetGateway,
@@ -74005,6 +74005,7 @@ __export(index_exports, {
   NATIVE_LAUNCHER_EXE_NAME: () => NATIVE_LAUNCHER_EXE_NAME,
   OPENCLAW_GATEWAY_ROUTE_GROUP_ID: () => OPENCLAW_GATEWAY_ROUTE_GROUP_ID,
   SYSTEM_NOTIFICATION_SESSION_KEY: () => SYSTEM_NOTIFICATION_SESSION_KEY,
+  SessionBusyTracker: () => SessionBusyTracker,
   SessionStore: () => SessionStore,
   SqliteOutboundBehavior: () => SqliteOutboundBehavior,
   TASK_NAME: () => TASK_NAME,
@@ -74070,6 +74071,7 @@ __export(index_exports, {
   formatDoctorReportForHumans: () => formatDoctorReportForHumans,
   getDaemonStatus: () => getDaemonStatus,
   getHermesGatewayPluginStatus: () => getHermesGatewayPluginStatus,
+  getSessionBusyTracker: () => getSessionBusyTracker,
   handleDoctorCommand: () => handleDoctorCommand,
   handleXmtpSendCommand: () => handleXmtpSendCommand,
   hasAiRuntimeMarker: () => hasAiRuntimeMarker,
@@ -89244,6 +89246,268 @@ function readSyncedOpenClawGatewayConfig(homeDir = resolveA2aTaskHome()) {
   };
 }
 
+// src/session-busy-tracker.ts
+init_log();
+var RING_MAX = 256;
+var DEFAULT_STALE_RUN_MS = 10 * 60 * 1e3;
+var DEFAULT_STREAM_STALE_MS = 60 * 1e3;
+var DEFAULT_WATCHDOG_INTERVAL_MS = 5 * 1e3;
+var LOG_PREFIX = "[okx-a2a:session-gate]";
+var SessionBusyTracker = class {
+  now;
+  staleRunMs;
+  streamStaleMs;
+  watchdogIntervalMs;
+  /** runIds that reached a terminal state; guards against late/out-of-order deltas. */
+  finalized = [];
+  runWaiters = /* @__PURE__ */ new Map();
+  /** sessionKey → (runId → lastSeenMs). */
+  activeRuns = /* @__PURE__ */ new Map();
+  idleWaiters = /* @__PURE__ */ new Map();
+  lastEventAtMs;
+  lastStreamStaleFireMs = 0;
+  streamStaleHandler = null;
+  pendingWaiters = 0;
+  watchdogTimer = null;
+  constructor(options = {}) {
+    this.now = options.now ?? Date.now;
+    this.staleRunMs = options.staleRunMs ?? DEFAULT_STALE_RUN_MS;
+    this.streamStaleMs = options.streamStaleMs ?? DEFAULT_STREAM_STALE_MS;
+    this.watchdogIntervalMs = options.watchdogIntervalMs ?? DEFAULT_WATCHDOG_INTERVAL_MS;
+    this.lastEventAtMs = this.now();
+  }
+  /** Any event frame arrived (chat/agent/tick/health/...): the stream is alive. */
+  noteEvent() {
+    this.lastEventAtMs = this.now();
+  }
+  /** Reconnect hook invoked when the event stream goes silent while a wait is pending. */
+  setStreamStaleHandler(handler) {
+    this.streamStaleHandler = handler;
+  }
+  notifyChat(payload) {
+    if (!payload || typeof payload !== "object") {
+      return;
+    }
+    const frame = payload;
+    const runId = typeof frame.runId === "string" ? frame.runId : "";
+    const sessionKey = typeof frame.sessionKey === "string" ? frame.sessionKey : "";
+    const state = typeof frame.state === "string" ? frame.state : "";
+    if (!runId) {
+      return;
+    }
+    if (state === "final" || state === "error" || state === "aborted") {
+      this.markDone(sessionKey, runId, state);
+    } else {
+      this.markActive(sessionKey, runId);
+    }
+  }
+  notifyAgent(payload) {
+    if (!payload || typeof payload !== "object") {
+      return;
+    }
+    const frame = payload;
+    const runId = typeof frame.runId === "string" ? frame.runId : "";
+    const sessionKey = typeof frame.sessionKey === "string" ? frame.sessionKey : "";
+    const phase = frame.data && typeof frame.data === "object" ? frame.data.phase : void 0;
+    if (!runId) {
+      return;
+    }
+    if (frame.stream === "lifecycle" && (phase === "end" || phase === "error")) {
+      this.markDone(sessionKey, runId, String(phase));
+    } else {
+      this.markActive(sessionKey, runId);
+    }
+  }
+  isSessionBusy(sessionKey) {
+    const runs = this.activeRuns.get(sessionKey);
+    if (!runs) {
+      return false;
+    }
+    const now = this.now();
+    for (const [runId, lastSeen] of runs) {
+      if (now - lastSeen > this.staleRunMs) {
+        runs.delete(runId);
+      }
+    }
+    if (runs.size === 0) {
+      this.activeRuns.delete(sessionKey);
+      return false;
+    }
+    return true;
+  }
+  waitForSessionIdle(sessionKey, timeoutMs) {
+    if (!this.isSessionBusy(sessionKey)) {
+      return Promise.resolve("idle");
+    }
+    return new Promise((resolve6) => {
+      let waiters = this.idleWaiters.get(sessionKey);
+      if (!waiters) {
+        waiters = /* @__PURE__ */ new Set();
+        this.idleWaiters.set(sessionKey, waiters);
+      }
+      this.beginWait();
+      const entry = (state) => {
+        clearTimeout(timer);
+        this.endWait();
+        resolve6(state);
+      };
+      const timer = setTimeout(() => {
+        const cur = this.idleWaiters.get(sessionKey);
+        if (cur) {
+          cur.delete(entry);
+          if (cur.size === 0) {
+            this.idleWaiters.delete(sessionKey);
+          }
+        }
+        this.endWait();
+        resolve6("timeout");
+      }, timeoutMs);
+      waiters.add(entry);
+    });
+  }
+  waitForRunFinal(runId, timeoutMs) {
+    if (this.finalized.includes(runId)) {
+      return Promise.resolve("already-final");
+    }
+    return new Promise((resolve6) => {
+      let waiters = this.runWaiters.get(runId);
+      if (!waiters) {
+        waiters = /* @__PURE__ */ new Set();
+        this.runWaiters.set(runId, waiters);
+      }
+      this.beginWait();
+      const entry = (state) => {
+        clearTimeout(timer);
+        this.endWait();
+        resolve6(state);
+      };
+      const timer = setTimeout(() => {
+        const cur = this.runWaiters.get(runId);
+        if (cur) {
+          cur.delete(entry);
+          if (cur.size === 0) {
+            this.runWaiters.delete(runId);
+          }
+        }
+        this.endWait();
+        resolve6("timeout");
+      }, timeoutMs);
+      waiters.add(entry);
+    });
+  }
+  _debugSnapshot() {
+    return {
+      active: Array.from(this.activeRuns, ([key, runs]) => {
+        return [key, Array.from(runs.keys())];
+      }),
+      finalizedTail: this.finalized.slice(-10)
+    };
+  }
+  rememberFinalized(runId) {
+    if (!this.finalized.includes(runId)) {
+      this.finalized.push(runId);
+      if (this.finalized.length > RING_MAX) {
+        this.finalized.shift();
+      }
+    }
+  }
+  markActive(sessionKey, runId) {
+    if (!sessionKey || !runId || this.finalized.includes(runId)) {
+      return;
+    }
+    let runs = this.activeRuns.get(sessionKey);
+    if (!runs) {
+      runs = /* @__PURE__ */ new Map();
+      this.activeRuns.set(sessionKey, runs);
+    }
+    runs.set(runId, this.now());
+  }
+  markDone(sessionKey, runId, state) {
+    if (runId) {
+      this.rememberFinalized(runId);
+      const waiters = this.runWaiters.get(runId);
+      if (waiters) {
+        this.runWaiters.delete(runId);
+        for (const fn of waiters) {
+          fn(state);
+        }
+      }
+      const runs = sessionKey ? this.activeRuns.get(sessionKey) : void 0;
+      if (runs) {
+        runs.delete(runId);
+        if (runs.size === 0) {
+          this.activeRuns.delete(sessionKey);
+        }
+      } else {
+        for (const [key, sessionRuns] of this.activeRuns) {
+          if (sessionRuns.delete(runId) && sessionRuns.size === 0) {
+            this.activeRuns.delete(key);
+          }
+        }
+      }
+    }
+    if (sessionKey) {
+      this.releaseIdleWaiters(sessionKey);
+    }
+  }
+  releaseIdleWaiters(sessionKey) {
+    if (!sessionKey || this.isSessionBusy(sessionKey)) {
+      return;
+    }
+    const waiters = this.idleWaiters.get(sessionKey);
+    if (waiters) {
+      this.idleWaiters.delete(sessionKey);
+      for (const fn of waiters) {
+        fn("idle");
+      }
+    }
+  }
+  beginWait() {
+    this.pendingWaiters += 1;
+    if (this.pendingWaiters === 1 && !this.watchdogTimer) {
+      const timer = setInterval(() => {
+        this.checkStreamLiveness();
+      }, this.watchdogIntervalMs);
+      timer.unref?.();
+      this.watchdogTimer = timer;
+    }
+  }
+  endWait() {
+    this.pendingWaiters = Math.max(0, this.pendingWaiters - 1);
+    if (this.pendingWaiters === 0 && this.watchdogTimer) {
+      clearInterval(this.watchdogTimer);
+      this.watchdogTimer = null;
+    }
+  }
+  checkStreamLiveness() {
+    const now = this.now();
+    if (now - this.lastEventAtMs <= this.streamStaleMs) {
+      return;
+    }
+    if (now - this.lastStreamStaleFireMs <= this.streamStaleMs) {
+      return;
+    }
+    this.lastStreamStaleFireMs = now;
+    errorWithTimestamp(
+      `${LOG_PREFIX} event stream stale (${now - this.lastEventAtMs}ms since last event, threshold=${this.streamStaleMs}ms), invoking recovery handler`
+    );
+    try {
+      this.streamStaleHandler?.();
+    } catch (err2) {
+      errorWithTimestamp(
+        `${LOG_PREFIX} stream recovery handler failed: ${err2 instanceof Error ? err2.message : String(err2)}`
+      );
+    }
+  }
+};
+var singleton = null;
+function getSessionBusyTracker() {
+  if (!singleton) {
+    singleton = new SessionBusyTracker();
+  }
+  return singleton;
+}
+
 // src/openclaw-gateway.ts
 var DEFAULT_GATEWAY_PORT = 18789;
 var DEFAULT_TIMEOUT_MS = 2e4;
@@ -89251,7 +89515,7 @@ var DEFAULT_HEALTH_TIMEOUT_MS = 2e3;
 var PREFERRED_PROTOCOL_VERSION = 4;
 var LEGACY_PROTOCOL_VERSION = 3;
 var DEFAULT_SCOPES = ["operator.admin"];
-var LOG_PREFIX = "[okx-a2a:gateway]";
+var LOG_PREFIX2 = "[okx-a2a:gateway]";
 var GATEWAY_STARTING_RETRY_DELAYS_MS = [300, 700, 1200, 2e3, 3e3];
 var wsFactory = createDefaultWebSocket;
 var preferredGatewayProtocolVersion = PREFERRED_PROTOCOL_VERSION;
@@ -89303,6 +89567,18 @@ function createDefaultWebSocket(url) {
   return new Ctor(url);
 }
 var sharedClient = null;
+var streamStaleHandlerRegistered = false;
+function ensureStreamStaleHandlerRegistered() {
+  if (streamStaleHandlerRegistered) {
+    return;
+  }
+  streamStaleHandlerRegistered = true;
+  getSessionBusyTracker().setStreamStaleHandler(() => {
+    errorWithTimestamp(`${LOG_PREFIX2} [session-gate] event stream stale, forcing gateway reconnect`);
+    clearClient();
+    void isOpenClawA2aPluginAvailable();
+  });
+}
 function resolveOpenClawGatewayConfig(env = process.env) {
   const synced = readSyncedGatewayConfig(env);
   const explicitUrl = env.OKX_A2A_OPENCLAW_GATEWAY_URL?.trim() || void 0;
@@ -89324,12 +89600,13 @@ function setOpenClawWebSocketFactoryForTests(factory) {
 }
 function clearClient() {
   if (sharedClient) {
-    errorWithTimestamp(`${LOG_PREFIX} clear client`);
+    errorWithTimestamp(`${LOG_PREFIX2} clear client`);
     sharedClient.close();
   }
   sharedClient = null;
 }
 async function ensureClient(timeoutMs) {
+  ensureStreamStaleHandlerRegistered();
   if (sharedClient?.isReady()) {
     return sharedClient;
   }
@@ -89353,7 +89630,7 @@ async function ensureClient(timeoutMs) {
     const remainingMs = Math.max(1, timeoutMs - elapsedMs);
     const fallbackProtocol = firstProtocol === PREFERRED_PROTOCOL_VERSION ? LEGACY_PROTOCOL_VERSION : PREFERRED_PROTOCOL_VERSION;
     errorWithTimestamp(
-      `${LOG_PREFIX} protocol fallback from=${firstProtocol} to=${fallbackProtocol} remainingMs=${remainingMs}: ${formatErrorMessage(err2)}`
+      `${LOG_PREFIX2} protocol fallback from=${firstProtocol} to=${fallbackProtocol} remainingMs=${remainingMs}: ${formatErrorMessage(err2)}`
     );
     const fallbackClient = new MinimalGatewayClient(config, fallbackProtocol);
     sharedClient = fallbackClient;
@@ -89364,7 +89641,7 @@ async function ensureClient(timeoutMs) {
 }
 function stopOpenClawGateway() {
   if (!sharedClient) {
-    errorWithTimestamp(`${LOG_PREFIX} stop requested with no active client`);
+    errorWithTimestamp(`${LOG_PREFIX2} stop requested with no active client`);
     return;
   }
   clearClient();
@@ -89372,12 +89649,12 @@ function stopOpenClawGateway() {
 async function callOpenClawGateway(opts) {
   const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
   const startedAt = Date.now();
-  errorWithTimestamp(`${LOG_PREFIX} rpc start method=${opts.method} timeoutMs=${timeoutMs}`);
+  errorWithTimestamp(`${LOG_PREFIX2} rpc start method=${opts.method} timeoutMs=${timeoutMs}`);
   for (let attempt = 0; ; attempt += 1) {
     try {
       const client = await ensureClient(timeoutMs);
       const result = await client.request(opts.method, opts.params, { timeoutMs });
-      errorWithTimestamp(`${LOG_PREFIX} rpc ok method=${opts.method} durationMs=${Date.now() - startedAt} attempts=${attempt + 1}`);
+      errorWithTimestamp(`${LOG_PREFIX2} rpc ok method=${opts.method} durationMs=${Date.now() - startedAt} attempts=${attempt + 1}`);
       return result;
     } catch (err2) {
       const message = err2 instanceof Error ? err2.message : String(err2);
@@ -89387,13 +89664,13 @@ async function callOpenClawGateway(opts) {
       }
       if (isGatewayStartingError(err2) && delayMs !== void 0 && Date.now() + delayMs - startedAt < timeoutMs) {
         errorWithTimestamp(
-          `${LOG_PREFIX} rpc retry method=${opts.method} attempt=${attempt + 1} delayMs=${delayMs}: ${message}`
+          `${LOG_PREFIX2} rpc retry method=${opts.method} attempt=${attempt + 1} delayMs=${delayMs}: ${message}`
         );
         await sleep2(delayMs);
         continue;
       }
       errorWithTimestamp(
-        `${LOG_PREFIX} rpc failed method=${opts.method} durationMs=${Date.now() - startedAt} attempts=${attempt + 1}: ${message}`
+        `${LOG_PREFIX2} rpc failed method=${opts.method} durationMs=${Date.now() - startedAt} attempts=${attempt + 1}: ${message}`
       );
       if (isGatewayStartingError(err2)) {
         throw Object.assign(
@@ -89502,7 +89779,7 @@ var MinimalGatewayClient = class {
   }
   async connect(timeoutMs) {
     errorWithTimestamp(
-      `${LOG_PREFIX} connect url=${this.config.url} source=${this.config.source} instanceId=${this.instanceId} protocol=${this.protocolVersion} passwordConfigured=${!!this.config.password} tokenConfigured=${!!this.config.token} scopes=${DEFAULT_SCOPES.join(",")}`
+      `${LOG_PREFIX2} connect url=${this.config.url} source=${this.config.source} instanceId=${this.instanceId} protocol=${this.protocolVersion} passwordConfigured=${!!this.config.password} tokenConfigured=${!!this.config.token} scopes=${DEFAULT_SCOPES.join(",")}`
     );
     const ws = wsFactory(this.config.url);
     this.ws = ws;
@@ -89558,7 +89835,7 @@ var MinimalGatewayClient = class {
         }
       });
     });
-    errorWithTimestamp(`${LOG_PREFIX} hello ok instanceId=${this.instanceId} protocol=${this.protocolVersion}`);
+    errorWithTimestamp(`${LOG_PREFIX2} hello ok instanceId=${this.instanceId} protocol=${this.protocolVersion}`);
   }
   request(method, params, options = {}) {
     if (method === "connect") {
@@ -89634,7 +89911,17 @@ var MinimalGatewayClient = class {
     try {
       frame = JSON.parse(String(raw));
     } catch (err2) {
-      errorWithTimestamp(`${LOG_PREFIX} invalid frame: ${err2 instanceof Error ? err2.message : String(err2)}`);
+      errorWithTimestamp(`${LOG_PREFIX2} invalid frame: ${err2 instanceof Error ? err2.message : String(err2)}`);
+      return;
+    }
+    if (frame.type === "event") {
+      const gate = getSessionBusyTracker();
+      gate.noteEvent();
+      if (frame.event === "chat") {
+        gate.notifyChat(frame.payload);
+      } else if (frame.event === "agent") {
+        gate.notifyAgent(frame.payload);
+      }
       return;
     }
     if (frame.type !== "res") {
@@ -89656,7 +89943,7 @@ var MinimalGatewayClient = class {
     pending.reject(toGatewayError(frame.error));
   }
   handleClose(code2, reason) {
-    errorWithTimestamp(`${LOG_PREFIX} closed instanceId=${this.instanceId} code=${code2 ?? 0} reason=${reason || "no reason"}`);
+    errorWithTimestamp(`${LOG_PREFIX2} closed instanceId=${this.instanceId} code=${code2 ?? 0} reason=${reason || "no reason"}`);
     this.ready = false;
     for (const [id, pending] of this.pending) {
       clearTimeout(pending.timer);
@@ -89680,7 +89967,7 @@ function readSyncedGatewayConfig(env) {
       token: synced.token
     };
   } catch (err2) {
-    errorWithTimestamp(`${LOG_PREFIX} failed to read synced gateway config: ${err2 instanceof Error ? err2.message : String(err2)}`);
+    errorWithTimestamp(`${LOG_PREFIX2} failed to read synced gateway config: ${err2 instanceof Error ? err2.message : String(err2)}`);
     return null;
   }
 }
@@ -89691,7 +89978,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     client: {
       id: "gateway-client",
       displayName: "okx-a2a-node",
-      version: "0.1.10-beta-bf67773ad1-260723190921",
+      version: "0.1.10",
       platform: "node",
       mode: "backend",
       instanceId
@@ -89702,7 +89989,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     commands: [],
     permissions: {},
     locale: Intl.DateTimeFormat().resolvedOptions().locale || "en-US",
-    userAgent: `okx-a2a-node/${"0.1.10-beta-bf67773ad1-260723190921"}`,
+    userAgent: `okx-a2a-node/${"0.1.10"}`,
     auth: {
       ...config.token ? { token: config.token } : {},
       ...config.password ? { password: config.password } : {}
@@ -90295,6 +90582,14 @@ var DEFAULT_GATEWAY_PORT2 = {
   callPromptUserToLatestSessions
 };
 var GATEWAY_OUTBOUND_LOG_PREFIX = "[okx-a2a:gateway-outbound]";
+var DEFAULT_SESSION_GATE_FALLBACK_MS = 3e5;
+function resolveSessionGateFallbackMs(env = process.env) {
+  const raw = Number(env.OKX_A2A_SESSION_GATE_FALLBACK_MS ?? "");
+  if (Number.isFinite(raw) && raw > 0) {
+    return raw;
+  }
+  return DEFAULT_SESSION_GATE_FALLBACK_MS;
+}
 function resolveUserDeliveryId(input) {
   return input.idempotencyKey?.trim() || (0, import_node_crypto7.randomUUID)();
 }
@@ -90351,10 +90646,19 @@ var GatewayOutboundBehavior = class {
   gateway;
   store;
   sessionMetaStore;
+  /** `undefined` = default (resolve the shared tracker lazily on first dispatch); `null` = disabled. */
+  sessionGateOption;
   constructor(options = {}) {
     this.gateway = options.gateway ?? DEFAULT_GATEWAY_PORT2;
     this.store = options.store;
     this.sessionMetaStore = options.store;
+    this.sessionGateOption = options.sessionGate;
+  }
+  resolveSessionGate() {
+    if (this.sessionGateOption === void 0) {
+      return getSessionBusyTracker();
+    }
+    return this.sessionGateOption;
   }
   async createSession(input) {
     const gatewaySessionKey = this.resolveGatewaySessionKey(input);
@@ -90407,8 +90711,19 @@ var GatewayOutboundBehavior = class {
     errorWithTimestamp(
       `${GATEWAY_OUTBOUND_LOG_PREFIX} dispatchSessionMessage sessionKey=${input.sessionKey} gatewaySessionKey=${gatewaySessionKey} jobId=${input.jobId ?? "(none)"} agentId=${input.agentId ?? "(none)"} messageId=${input.messageId ?? "(none)"}`
     );
+    const sessionGate = this.resolveSessionGate();
+    const gateFallbackMs = resolveSessionGateFallbackMs();
+    if (sessionGate?.isSessionBusy(gatewaySessionKey)) {
+      errorWithTimestamp(
+        `${GATEWAY_OUTBOUND_LOG_PREFIX} [session-gate] busy, waiting idle sessionKey=${input.sessionKey} gatewaySessionKey=${gatewaySessionKey} (fallbackMs=${gateFallbackMs})`
+      );
+      const idleState = await sessionGate.waitForSessionIdle(gatewaySessionKey, gateFallbackMs);
+      errorWithTimestamp(
+        `${GATEWAY_OUTBOUND_LOG_PREFIX} [session-gate] idle wait done sessionKey=${input.sessionKey} gatewaySessionKey=${gatewaySessionKey} result=${idleState}`
+      );
+    }
     try {
-      await this.gateway.callSessionsSend({
+      const sendResult = await this.gateway.callSessionsSend({
         key: gatewaySessionKey,
         message: input.content,
         ...input.messageId ? { idempotencyKey: input.messageId } : {}
@@ -90423,6 +90738,16 @@ var GatewayOutboundBehavior = class {
         messageId: input.messageId ?? "",
         status: "delivered"
       }));
+      const gateRunId = sendResult && typeof sendResult === "object" && typeof sendResult.runId === "string" ? sendResult.runId : input.messageId;
+      if (sessionGate && typeof gateRunId === "string" && gateRunId) {
+        errorWithTimestamp(
+          `${GATEWAY_OUTBOUND_LOG_PREFIX} [session-gate] holding sessionKey=${input.sessionKey} gatewaySessionKey=${gatewaySessionKey} runId=${gateRunId} until run final/error (fallbackMs=${gateFallbackMs})`
+        );
+        const gateState = await sessionGate.waitForRunFinal(gateRunId, gateFallbackMs);
+        errorWithTimestamp(
+          `${GATEWAY_OUTBOUND_LOG_PREFIX} [session-gate] released sessionKey=${input.sessionKey} gatewaySessionKey=${gatewaySessionKey} runId=${gateRunId} state=${gateState}`
+        );
+      }
     } catch (err2) {
       if (!this.store || !isRetryableOpenClawGatewayError(err2)) {
         logger.error(LogEvent.GATEWAY_REQUEST_FAILED, err2 instanceof Error ? err2 : new Error(String(err2)), gatewayOutboundExtra("sessions.send", {
@@ -94498,12 +94823,12 @@ async function runListenerWithLock(options, paths) {
       });
     }
   });
-  service.setPluginVersion("0.1.10-beta-bf67773ad1-260723190921");
+  service.setPluginVersion("0.1.10");
   await service.init();
   const pluginVersionStatus = service.pluginVersionStatus;
   if (pluginVersionStatus.unavailable) {
     throw new Error(
-      `@okxweb3/a2a-node v${"0.1.10-beta-bf67773ad1-260723190921"} is below the required minimum v${pluginVersionStatus.minVersion}`
+      `@okxweb3/a2a-node v${"0.1.10"} is below the required minimum v${pluginVersionStatus.minVersion}`
     );
   }
   const systemConfig = service.getSystemConfig();
@@ -94521,7 +94846,7 @@ async function runListenerWithLock(options, paths) {
       onchainosAgentId: "*",
       reason: "system-config missing sentryDsn",
       pluginId: "@okxweb3/a2a-node",
-      pluginVersion: "0.1.10-beta-bf67773ad1-260723190921"
+      pluginVersion: "0.1.10"
     });
   }
   logWithTimestamp(
@@ -96290,7 +96615,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.1.10-beta-bf67773ad1-260723190921" : "0.0.0"),
+    cliVersion: options.cliVersion ?? (true ? "0.1.10" : "0.0.0"),
     fixMode: options.fix === true,
     nonInteractive: options.nonInteractive === true,
     packageChanged: false,
@@ -96526,6 +96851,7 @@ init_win_native_launcher();
   NATIVE_LAUNCHER_EXE_NAME,
   OPENCLAW_GATEWAY_ROUTE_GROUP_ID,
   SYSTEM_NOTIFICATION_SESSION_KEY,
+  SessionBusyTracker,
   SessionStore,
   SqliteOutboundBehavior,
   TASK_NAME,
@@ -96591,6 +96917,7 @@ init_win_native_launcher();
   formatDoctorReportForHumans,
   getDaemonStatus,
   getHermesGatewayPluginStatus,
+  getSessionBusyTracker,
   handleDoctorCommand,
   handleXmtpSendCommand,
   hasAiRuntimeMarker,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@okxweb3/a2a-node",
-  "version": "0.1.10-beta-bf67773ad1-260723190921",
+  "version": "0.1.10",
   "description": "Host-agnostic Node CLI for E2E encrypted agent-to-agent communication via XMTP",
   "main": "dist/index.js",
   "bin": {
@@ -10,7 +10,7 @@
     "dist"
   ],
   "engines": {
-    "node": ">=22.13.0"
+    "node": ">=22.14.0"
   },
   "scripts": {
     "preinstall": "node dist/check-node-version.js",