@okxweb3/a2a-node 0.0.15 → 0.0.16-beta-d0ec14bc63-260623110312

package/dist/index.js

@@ -1913,7 +1913,7 @@ var require_path = __commonJS({
     function isAbsolute2(path) {
       return path.charAt(0) === "/";
     }
-    function join18(...args) {
+    function join19(...args) {
       return normalizePath(args.join("/"));
     }
     function dirname6(path) {
@@ -1938,7 +1938,7 @@ var require_path = __commonJS({
     exports2.basename = basename3;
     exports2.dirname = dirname6;
     exports2.isAbsolute = isAbsolute2;
-    exports2.join = join18;
+    exports2.join = join19;
     exports2.normalizePath = normalizePath;
     exports2.relative = relative;
     exports2.resolve = resolve4;
@@ -67932,6 +67932,7 @@ __export(index_exports, {
   GatewayOutboundBehavior: () => GatewayOutboundBehavior,
   InvalidXmtpMessageStore: () => InvalidXmtpMessageStore,
   OFFLINE_REPLAY_SYNC_INTERVAL: () => OFFLINE_REPLAY_SYNC_INTERVAL,
+  OPENCLAW_GATEWAY_ROUTE_GROUP_ID: () => OPENCLAW_GATEWAY_ROUTE_GROUP_ID,
   SYSTEM_NOTIFICATION_SESSION_KEY: () => SYSTEM_NOTIFICATION_SESSION_KEY,
   SessionStore: () => SessionStore,
   SqliteOutboundBehavior: () => SqliteOutboundBehavior,
@@ -67945,6 +67946,7 @@ __export(index_exports, {
   bindJobProviderToCurrentDefaultIfMissing: () => bindJobProviderToCurrentDefaultIfMissing,
   bindJobProviderToCurrentRuntimeIfMissing: () => bindJobProviderToCurrentRuntimeIfMissing,
   bindMessageJobProviderToCurrentDefault: () => bindMessageJobProviderToCurrentDefault,
+  bindOpenClawGatewayRouteFromEnv: () => bindOpenClawGatewayRouteFromEnv,
   buildAgentMessageNotice: () => buildAgentMessageNotice,
   buildAiAdapterCommand: () => buildAiAdapterCommand,
   buildAiProviderEnv: () => buildAiProviderEnv,
@@ -67965,6 +67967,7 @@ __export(index_exports, {
   createFileMessageHandler: () => createFileMessageHandler,
   createOutboundBehavior: () => createOutboundBehavior,
   createUserAttentionWatchParentMonitor: () => createUserAttentionWatchParentMonitor,
+  currentOpenClawGatewaySessionKey: () => currentOpenClawGatewaySessionKey,
   detectAiProviders: () => detectAiProviders,
   detectCurrentAiProvider: () => detectCurrentAiProvider,
   detectGatewayInvocation: () => detectGatewayInvocation,
@@ -67998,6 +68001,8 @@ __export(index_exports, {
   resolveConfiguredAiProviderForJob: () => resolveConfiguredAiProviderForJob,
   resolveDirectCommunicationSessionTarget: () => resolveDirectCommunicationSessionTarget,
   resolveOpenClawGatewayConfig: () => resolveOpenClawGatewayConfig,
+  resolveOpenClawGatewayRoute: () => resolveOpenClawGatewayRoute,
+  resolveOpenClawGatewayRoutes: () => resolveOpenClawGatewayRoutes,
   resolveSystemNotificationTargets: () => resolveSystemNotificationTargets,
   resolveTaskConfigPath: () => resolveTaskConfigPath,
   resolveTaskHome: () => resolveTaskHome,
@@ -74210,6 +74215,7 @@ var CommandStore = class {
       myAgentId: params.myAgentId,
       toAgentId: params.toAgentId,
       toXmtpAddress: params.toXmtpAddress,
+      gatewaySessionKeys: params.gatewaySessionKeys,
       createdAt: Date.now()
     };
   }
@@ -86093,7 +86099,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     client: {
       id: "gateway-client",
       displayName: "okx-a2a-node",
-      version: "0.0.15",
+      version: "0.0.16-beta-d0ec14bc63-260623110312",
       platform: "node",
       mode: "backend",
       instanceId
@@ -86104,7 +86110,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     commands: [],
     permissions: {},
     locale: Intl.DateTimeFormat().resolvedOptions().locale || "en-US",
-    userAgent: `okx-a2a-node/${"0.0.15"}`,
+    userAgent: `okx-a2a-node/${"0.0.16-beta-d0ec14bc63-260623110312"}`,
     auth: {
       ...config.token ? { token: config.token } : {},
       ...config.password ? { password: config.password } : {}
@@ -86229,6 +86235,319 @@ function safeDecode(value) {
   }
 }
 
+// src/openclaw-route.ts
+var import_node_fs13 = require("node:fs");
+var import_node_os5 = require("node:os");
+var import_node_path17 = require("node:path");
+var OPENCLAW_GATEWAY_ROUTE_GROUP_ID = "__openclaw_gateway_route__";
+var CURRENT_GATEWAY_SESSION_KEYS_ENV = "OKX_A2A_CURRENT_GATEWAY_SESSION_KEYS";
+var NON_DELIVERY_CHANNELS = /* @__PURE__ */ new Set(["heartbeat", "cron", "webhook", "voice"]);
+var ACTIVE_ORIGIN_TTL_MS = 30 * 6e4;
+function currentOpenClawGatewaySessionKey(env = process.env) {
+  for (const candidate of currentOpenClawGatewaySessionCandidates(env)) {
+    if (candidate.ok) {
+      return candidate.sessionKey;
+    }
+  }
+  return null;
+}
+function bindOpenClawGatewayRouteFromEnv(store, input, env = process.env) {
+  const jobId = normalizeText(input.jobId);
+  if (!jobId) {
+    return null;
+  }
+  const existingBinding = store.getJobProviderBinding(jobId);
+  if (existingBinding && existingBinding.provider !== "openclaw") {
+    return null;
+  }
+  let routes = readOpenClawRouteEntries(store, jobId);
+  let firstBound = null;
+  for (const candidate of currentOpenClawGatewaySessionCandidates(env, input.gatewaySessionKeys)) {
+    if (!candidate.ok) {
+      logOpenClawRouteSkip(candidate.reason, {
+        jobId,
+        sessionKey: candidate.sessionKey,
+        existingRoute: resolveOpenClawGatewayRoute(store, { jobId })
+      });
+      continue;
+    }
+    const channel = channelFromOpenClawGatewaySessionKey(candidate.sessionKey);
+    if (!channel) {
+      logOpenClawRouteSkip("invalid_gateway_session_key", {
+        jobId,
+        sessionKey: candidate.sessionKey,
+        existingRoute: resolveOpenClawGatewayRoute(store, { jobId })
+      });
+      continue;
+    }
+    const existingRoute = routes.find((route2) => route2.platform === channel) ?? null;
+    if (existingRoute) {
+      firstBound ??= existingRoute.gatewaySessionKey || existingRoute.sessionKey || null;
+      continue;
+    }
+    const route = buildOpenClawRouteEntry(candidate.sessionKey, channel);
+    routes = [...routes, route];
+    const binding = store.upsertJobGatewayRoute({ jobId, provider: "openclaw", route });
+    if (binding.provider !== "openclaw") {
+      return null;
+    }
+    firstBound ??= route.gatewaySessionKey || route.sessionKey || null;
+  }
+  if (firstBound) {
+    return firstBound;
+  }
+  return resolveOpenClawGatewayRoute(store, { jobId })?.sessionKey ?? null;
+}
+function currentOpenClawGatewaySessionCandidates(env = process.env, explicitSessionKeys) {
+  const platform = normalizeText(env.OKX_A2A_CURRENT_GATEWAY_PLATFORM);
+  const chatId = normalizeText(env.OKX_A2A_CURRENT_GATEWAY_CHAT_ID);
+  const threadId = normalizeText(env.OKX_A2A_CURRENT_GATEWAY_THREAD_ID);
+  const rawKeys = [
+    ...Array.isArray(explicitSessionKeys) ? explicitSessionKeys : [],
+    ...readGatewaySessionKeysEnv(env),
+    normalizeText(env.OKX_A2A_CURRENT_GATEWAY_SESSION_KEY),
+    platform && chatId ? deriveOpenClawGatewaySessionKey({ platform, chatId, threadId }) : null,
+    normalizeText(env.OKX_A2A_CURRENT_SESSION_KEY),
+    ...readSingleActiveOriginSessionKey(env)
+  ];
+  const seen = /* @__PURE__ */ new Set();
+  const candidates = [];
+  for (const key of rawKeys) {
+    const normalized = normalizeText(key);
+    if (!normalized || seen.has(normalized)) {
+      continue;
+    }
+    seen.add(normalized);
+    candidates.push(validateOpenClawGatewaySessionKey(normalized));
+  }
+  if (candidates.length > 0) {
+    return candidates;
+  }
+  return [{ ok: false, reason: "missing_gateway_session_key" }];
+}
+function resolveOpenClawGatewayRoute(store, input) {
+  return resolveOpenClawGatewayRoutes(store, input)[0] ?? null;
+}
+function resolveOpenClawGatewayRoutes(store, input) {
+  const jobId = normalizeText(input.jobId) ?? inferJobIdFromSessionKey2(normalizeText(input.sessionKey));
+  if (jobId) {
+    return readOpenClawRouteEntries(store, jobId).map((route) => toOpenClawGatewayRoute(route, jobId));
+  }
+  return [];
+}
+function isValidOpenClawGatewaySessionKey(sessionKey) {
+  return validateOpenClawGatewaySessionKey(sessionKey).ok;
+}
+function buildOpenClawRouteEntry(sessionKey, channel) {
+  const parsed = parseOpenClawGatewaySessionKey(sessionKey);
+  return {
+    platform: channel,
+    chatId: parsed.chatId ?? sessionKey,
+    chatType: parsed.threadId ? "thread" : "dm",
+    sessionKey,
+    gatewaySessionKey: sessionKey,
+    chatName: "",
+    ...parsed.threadId ? { threadId: parsed.threadId } : { threadId: "" },
+    userId: "",
+    userName: "",
+    updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
+function toOpenClawGatewayRoute(route, jobId) {
+  const sessionKey = route.gatewaySessionKey || route.sessionKey || "";
+  return {
+    sessionKey,
+    jobId,
+    routeSessionKey: route.sessionKey || sessionKey,
+    updatedAt: route.updatedAt ?? "",
+    channel: route.platform
+  };
+}
+function readOpenClawRouteEntries(store, jobId) {
+  const binding = store?.getJobProviderBinding(jobId);
+  if (binding?.provider !== "openclaw") {
+    return [];
+  }
+  const routes = binding.gatewayRoutes ?? [];
+  const seenChannels = /* @__PURE__ */ new Set();
+  const validRoutes = [];
+  for (const route of routes) {
+    const sessionKey = normalizeText(route.gatewaySessionKey) ?? normalizeText(route.sessionKey);
+    const channel = channelFromOpenClawGatewaySessionKey(sessionKey);
+    if (!sessionKey || !channel || seenChannels.has(channel)) {
+      continue;
+    }
+    seenChannels.add(channel);
+    validRoutes.push({
+      platform: channel,
+      chatId: route.chatId,
+      chatName: route.chatName ?? "",
+      chatType: route.chatType || (route.threadId ? "thread" : "dm"),
+      sessionKey: route.sessionKey,
+      gatewaySessionKey: sessionKey,
+      threadId: route.threadId ?? "",
+      userId: route.userId ?? "",
+      userName: route.userName ?? "",
+      ...route.updatedAt ? { updatedAt: route.updatedAt } : {}
+    });
+  }
+  return validRoutes;
+}
+function parseOpenClawGatewaySessionKey(sessionKey) {
+  const parts = sessionKey.split(":");
+  if (parts.length < 4 || parts[0] !== "agent") {
+    return {};
+  }
+  const platform = parts[2];
+  const targetKind = parts[3];
+  if (platform === "discord" && targetKind === "thread") {
+    return {
+      ...parts[4] ? { chatId: parts[4] } : {},
+      ...parts[5] ? { threadId: parts[5] } : {}
+    };
+  }
+  if (platform === "discord" && targetKind === "channel") {
+    return parts[4] ? { chatId: parts[4] } : {};
+  }
+  if (platform === "discord" && targetKind === "dm") {
+    return parts[4] ? { chatId: parts[4] } : {};
+  }
+  if (platform === "telegram" && targetKind === "direct") {
+    return parts[4] ? { chatId: parts[4] } : {};
+  }
+  if (platform === "telegram" && targetKind === "group") {
+    return {
+      ...parts[4] ? { chatId: parts[4] } : {},
+      ...parts[6] ? { threadId: parts[6] } : {}
+    };
+  }
+  return {};
+}
+function validateOpenClawGatewaySessionKey(sessionKey) {
+  const key = normalizeText(sessionKey);
+  if (!key) {
+    return { ok: false, reason: "missing_gateway_session_key" };
+  }
+  if (key.startsWith("backup:")) {
+    return { ok: false, reason: "internal_gateway_session_key", sessionKey: key };
+  }
+  if (key === "agent:main") {
+    return { ok: true, sessionKey: key };
+  }
+  const parts = key.split(":");
+  if (parts.length < 4 || parts[0] !== "agent" || !parts[1]) {
+    return { ok: false, reason: "invalid_gateway_session_key", sessionKey: key };
+  }
+  const platform = parts[2];
+  if (!platform || platform === "okx-a2a" || NON_DELIVERY_CHANNELS.has(platform)) {
+    return { ok: false, reason: "internal_gateway_session_key", sessionKey: key };
+  }
+  return { ok: true, sessionKey: key };
+}
+function channelFromOpenClawGatewaySessionKey(sessionKey) {
+  const key = normalizeText(sessionKey);
+  if (!key) {
+    return null;
+  }
+  if (key === "agent:main") {
+    return "main";
+  }
+  const validation = validateOpenClawGatewaySessionKey(key);
+  if (!validation.ok) {
+    return null;
+  }
+  return key.split(":")[2] ?? null;
+}
+function deriveOpenClawGatewaySessionKey(input) {
+  const chatId = encodeURIComponent(input.chatId);
+  const threadId = input.threadId ? encodeURIComponent(input.threadId) : "";
+  if (input.platform === "telegram") {
+    return threadId ? `agent:main:telegram:group:${chatId}:topic:${threadId}` : `agent:main:telegram:direct:${chatId}`;
+  }
+  return threadId ? `agent:main:${input.platform}:thread:${chatId}:${threadId}` : `agent:main:${input.platform}:dm:${chatId}`;
+}
+function readGatewaySessionKeysEnv(env) {
+  const raw = normalizeText(env[CURRENT_GATEWAY_SESSION_KEYS_ENV]);
+  if (!raw) {
+    return [];
+  }
+  try {
+    const parsed = JSON.parse(raw);
+    if (Array.isArray(parsed)) {
+      return parsed.filter((item) => typeof item === "string" && item.trim().length > 0);
+    }
+  } catch {
+  }
+  return raw.split(",").map((item) => item.trim()).filter(Boolean);
+}
+function readSingleActiveOriginSessionKey(env) {
+  const path = (0, import_node_path17.join)(resolveTaskHome2(env), "run", "gateway-route-origins.json");
+  if (!(0, import_node_fs13.existsSync)(path)) {
+    return [];
+  }
+  try {
+    const parsed = JSON.parse((0, import_node_fs13.readFileSync)(path, "utf8"));
+    if (!isRecord2(parsed) || !Array.isArray(parsed.origins)) {
+      return [];
+    }
+    const now = Date.now();
+    const valid = parsed.origins.filter((item) => isRecord2(item)).map((item) => ({
+      sessionKey: normalizeText(typeof item.sessionKey === "string" ? item.sessionKey : null),
+      count: typeof item.count === "number" && Number.isFinite(item.count) ? item.count : 0,
+      updatedAt: typeof item.updatedAt === "number" && Number.isFinite(item.updatedAt) ? item.updatedAt : 0
+    })).filter((item) => item.sessionKey && item.count > 0 && now - item.updatedAt <= ACTIVE_ORIGIN_TTL_MS && validateOpenClawGatewaySessionKey(item.sessionKey).ok);
+    const sessionKeys = [...new Set(valid.map((item) => item.sessionKey).filter(Boolean))];
+    return sessionKeys.length === 1 ? sessionKeys : [];
+  } catch (err2) {
+    console.error(
+      `[openclaw-route] failed to read active gateway route origin state: ${err2 instanceof Error ? err2.message : String(err2)}`
+    );
+    return [];
+  }
+}
+function resolveTaskHome2(env) {
+  return env.OKX_AGENT_TASK_HOME?.trim() || (0, import_node_path17.join)((0, import_node_os5.homedir)(), ".okx-agent-task");
+}
+function logOpenClawRouteSkip(reason, input) {
+  if (reason === "missing_gateway_session_key") {
+    return;
+  }
+  console.error(
+    `[openclaw-route] skipped gateway route bind reason=${reason} jobId=${input.jobId} sessionKey=${input.sessionKey ?? "(none)"} existingRoute=${input.existingRoute?.sessionKey ?? "(none)"}`
+  );
+}
+function inferJobIdFromSessionKey2(sessionKey) {
+  if (!sessionKey) {
+    return null;
+  }
+  const parts = sessionKey.split(":");
+  if (parts.length >= 2 && parts[0] === "job") {
+    return safeDecode2(parts[1]);
+  }
+  if (sessionKey.startsWith("backup:")) {
+    return safeDecode2(sessionKey.slice("backup:".length));
+  }
+  const gatewayJob = /(?:^|[?&:])job=([^:&]+)/.exec(sessionKey);
+  if (gatewayJob?.[1]) {
+    return safeDecode2(gatewayJob[1]);
+  }
+  return null;
+}
+function normalizeText(value) {
+  const text = value?.trim();
+  return text ? text : null;
+}
+function isRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function safeDecode2(value) {
+  try {
+    return decodeURIComponent(value);
+  } catch {
+    return value;
+  }
+}
+
 // src/outbound-behavior.ts
 var SqliteOutboundBehavior = class {
   provider;
@@ -86316,7 +86635,7 @@ function assertLatestUserFanoutDelivered(operation, payload) {
   const result = payload;
   const dispatched = Array.isArray(result.dispatched) ? result.dispatched.length : null;
   const failed = Array.isArray(result.failed) ? result.failed.length : null;
-  if (result.ok === false || dispatched === 0) {
+  if (dispatched === 0 || result.ok === false && dispatched === null) {
     throw Object.assign(
       new Error(
         `${operation} did not deliver to any OpenClaw user session (dispatched=${dispatched ?? "unknown"} failed=${failed ?? "unknown"})`
@@ -86382,6 +86701,7 @@ var GatewayOutboundBehavior = class {
   }
   async dispatchSessionMessage(input) {
     const gatewaySessionKey = this.resolveGatewaySessionKey(input);
+    this.bindUserRouteForJob(input.jobId);
     errorWithTimestamp(
       `${GATEWAY_OUTBOUND_LOG_PREFIX} dispatchSessionMessage sessionKey=${input.sessionKey} gatewaySessionKey=${gatewaySessionKey} jobId=${input.jobId ?? "(none)"} agentId=${input.agentId ?? "(none)"} messageId=${input.messageId ?? "(none)"}`
     );
@@ -86439,6 +86759,12 @@ var GatewayOutboundBehavior = class {
       }));
     }
   }
+  bindUserRouteForJob(jobId) {
+    if (!this.store || !jobId) {
+      return;
+    }
+    bindOpenClawGatewayRouteFromEnv(this.store, { jobId });
+  }
   resolveGatewaySessionKey(input) {
     const stored = this.sessionMetaStore?.getSession(input.sessionKey);
     return toOpenClawGatewaySessionKey({
@@ -86450,11 +86776,20 @@ var GatewayOutboundBehavior = class {
     });
   }
   async dispatchUser(input) {
+    const routed = this.resolveUserGatewaySessionKey(input);
+    if (routed) {
+      await this.dispatchUserToGatewaySession(input, routed);
+      return null;
+    }
     errorWithTimestamp(
       `${GATEWAY_OUTBOUND_LOG_PREFIX} dispatchUser latestUserSessions jobId=${input.jobId ?? "(none)"} idempotencyKey=${input.idempotencyKey ?? "(none)"}`
     );
     try {
-      const result = await this.gateway.callDispatchUserToLatestSessions({ content: input.userContent });
+      const result = await this.gateway.callDispatchUserToLatestSessions({
+        content: input.userContent,
+        ...input.jobId ? { jobId: input.jobId } : {},
+        ...input.sessionKey ? { currentSessionKey: input.sessionKey } : {}
+      });
       assertLatestUserFanoutDelivered("okx-a2a.dispatch_user", result);
       errorWithTimestamp(`${GATEWAY_OUTBOUND_LOG_PREFIX} dispatchUser latestUserSessions ok`);
       logger.info(LogEvent.USER_DISPATCHED, gatewayOutboundExtra("okx-a2a.dispatch_user", {
@@ -86492,14 +86827,90 @@ var GatewayOutboundBehavior = class {
     }
     return null;
   }
+  resolveUserGatewaySessionKey(input) {
+    const routes = resolveOpenClawGatewayRoutes(this.sessionMetaStore, input);
+    if (routes.length > 0) {
+      return { sessionKeys: routes.map((route) => route.sessionKey), source: "stored_openclaw_routes" };
+    }
+    if (input.sessionKey?.startsWith("agent:")) {
+      return isValidOpenClawGatewaySessionKey(input.sessionKey) ? { sessionKeys: [input.sessionKey], source: "explicit_gateway_session" } : null;
+    }
+    return null;
+  }
+  async dispatchUserToGatewaySession(input, routed) {
+    const gatewaySessionKey = routed.sessionKeys.join(",");
+    console.error(
+      `${GATEWAY_OUTBOUND_LOG_PREFIX} dispatchUser routed sessionKey=${input.sessionKey ?? "(none)"} gatewaySessionKey=${gatewaySessionKey} source=${routed.source} jobId=${input.jobId ?? "(none)"} idempotencyKey=${input.idempotencyKey ?? "(none)"}`
+    );
+    try {
+      const result = await this.gateway.callDispatchUserToLatestSessions({
+        content: input.userContent,
+        label: "okx-a2a",
+        ...routed.source === "stored_openclaw_routes" ? { sessionKeys: routed.sessionKeys } : { sessionKey: routed.sessionKeys[0] }
+      });
+      assertLatestUserFanoutDelivered("okx-a2a.dispatch_user", result);
+      console.error(`${GATEWAY_OUTBOUND_LOG_PREFIX} dispatchUser routed ok gatewaySessionKey=${gatewaySessionKey} source=${routed.source}`);
+      logger.info(LogEvent.USER_DISPATCHED, gatewayOutboundExtra("okx-a2a.dispatch_user", {
+        sessionKey: input.sessionKey ?? "",
+        gatewaySessionKey,
+        jobId: input.jobId ?? "",
+        source: routed.source,
+        status: "delivered"
+      }));
+    } catch (err2) {
+      if (!this.store || !isRetryableOpenClawGatewayError(err2)) {
+        logger.error(LogEvent.USER_DISPATCH_FAILED, err2 instanceof Error ? err2 : new Error(String(err2)), gatewayOutboundExtra("okx-a2a.dispatch_user", {
+          sessionKey: input.sessionKey ?? "",
+          gatewaySessionKey,
+          jobId: input.jobId ?? "",
+          source: routed.source,
+          status: "failed"
+        }));
+        throw err2;
+      }
+      this.store.enqueuePendingGatewayDelivery({
+        kind: "chat_inject",
+        provider: this.provider,
+        sessionKey: routed.sessionKeys[0] ?? "openclaw:routed-user-sessions",
+        content: input.userContent,
+        jobId: input.jobId ?? null,
+        messageId: input.idempotencyKey ?? null
+      });
+      console.error(
+        `${GATEWAY_OUTBOUND_LOG_PREFIX} dispatchUser routed buffered gatewaySessionKey=${gatewaySessionKey} source=${routed.source} idempotencyKey=${input.idempotencyKey ?? "(none)"}: ${err2 instanceof Error ? err2.message : String(err2)}`
+      );
+      logger.error(LogEvent.USER_DISPATCH_FAILED, err2 instanceof Error ? err2 : new Error(String(err2)), gatewayOutboundExtra("okx-a2a.dispatch_user", {
+        sessionKey: input.sessionKey ?? "",
+        gatewaySessionKey,
+        jobId: input.jobId ?? "",
+        source: routed.source,
+        status: "buffered"
+      }));
+      logger.info(LogEvent.GATEWAY_DELIVERY_BUFFERED, gatewayOutboundExtra("okx-a2a.dispatch_user", {
+        sessionKey: input.sessionKey ?? "",
+        gatewaySessionKey,
+        jobId: input.jobId ?? "",
+        messageId: input.idempotencyKey ?? "",
+        source: routed.source,
+        status: "buffered"
+      }));
+    }
+  }
   async promptUser(input) {
+    const routed = this.resolveUserGatewaySessionKey(input);
+    if (routed) {
+      await this.promptUserToGatewaySession(input, routed);
+      return null;
+    }
     errorWithTimestamp(
       `${GATEWAY_OUTBOUND_LOG_PREFIX} promptUser latestUserSessions jobId=${input.jobId ?? "(none)"} idempotencyKey=${input.idempotencyKey ?? "(none)"}`
     );
     try {
       const result = await this.gateway.callPromptUserToLatestSessions({
         userContent: input.userContent,
-        llmContent: input.llmContent
+        llmContent: input.llmContent,
+        ...input.jobId ? { jobId: input.jobId } : {},
+        ...input.sessionKey ? { currentSessionKey: input.sessionKey } : {}
       });
       assertLatestUserFanoutDelivered("okx-a2a.prompt_user", result);
       errorWithTimestamp(`${GATEWAY_OUTBOUND_LOG_PREFIX} promptUser latestUserSessions ok`);
@@ -86539,6 +86950,66 @@ var GatewayOutboundBehavior = class {
     }
     return null;
   }
+  async promptUserToGatewaySession(input, routed) {
+    const gatewaySessionKey = routed.sessionKeys.join(",");
+    console.error(
+      `${GATEWAY_OUTBOUND_LOG_PREFIX} promptUser routed sessionKey=${input.sessionKey ?? "(none)"} gatewaySessionKey=${gatewaySessionKey} source=${routed.source} jobId=${input.jobId ?? "(none)"} idempotencyKey=${input.idempotencyKey ?? "(none)"}`
+    );
+    try {
+      const result = await this.gateway.callPromptUserToLatestSessions({
+        userContent: input.userContent,
+        llmContent: input.llmContent,
+        ...routed.source === "stored_openclaw_routes" ? { sessionKeys: routed.sessionKeys } : { sessionKey: routed.sessionKeys[0] }
+      });
+      assertLatestUserFanoutDelivered("okx-a2a.prompt_user", result);
+      console.error(`${GATEWAY_OUTBOUND_LOG_PREFIX} promptUser routed ok gatewaySessionKey=${gatewaySessionKey} source=${routed.source}`);
+      logger.info(LogEvent.PROMPT_USER_CHECKPOINT, gatewayOutboundExtra("routed_prompt_user", {
+        sessionKey: input.sessionKey ?? "",
+        gatewaySessionKey,
+        jobId: input.jobId ?? "",
+        source: routed.source,
+        status: "delivered"
+      }));
+    } catch (err2) {
+      if (!this.store || !isRetryableOpenClawGatewayError(err2)) {
+        logger.error(LogEvent.PROMPT_USER_FAILED, err2 instanceof Error ? err2 : new Error(String(err2)), gatewayOutboundExtra("routed_prompt_user", {
+          sessionKey: input.sessionKey ?? "",
+          gatewaySessionKey,
+          jobId: input.jobId ?? "",
+          source: routed.source,
+          status: "failed"
+        }));
+        throw err2;
+      }
+      this.store.enqueuePendingGatewayDelivery({
+        kind: "chat_inject",
+        provider: this.provider,
+        sessionKey: routed.sessionKeys[0] ?? "openclaw:routed-user-sessions",
+        content: input.userContent,
+        llmContent: input.llmContent,
+        jobId: input.jobId ?? null,
+        messageId: input.idempotencyKey ?? null
+      });
+      console.error(
+        `${GATEWAY_OUTBOUND_LOG_PREFIX} promptUser routed buffered gatewaySessionKey=${gatewaySessionKey} source=${routed.source} idempotencyKey=${input.idempotencyKey ?? "(none)"}: ${err2 instanceof Error ? err2.message : String(err2)}`
+      );
+      logger.error(LogEvent.PROMPT_USER_FAILED, err2 instanceof Error ? err2 : new Error(String(err2)), gatewayOutboundExtra("routed_prompt_user", {
+        sessionKey: input.sessionKey ?? "",
+        gatewaySessionKey,
+        jobId: input.jobId ?? "",
+        source: routed.source,
+        status: "buffered"
+      }));
+      logger.info(LogEvent.GATEWAY_DELIVERY_BUFFERED, gatewayOutboundExtra("routed_prompt_user", {
+        sessionKey: input.sessionKey ?? "",
+        gatewaySessionKey,
+        jobId: input.jobId ?? "",
+        messageId: input.idempotencyKey ?? "",
+        source: routed.source,
+        status: "buffered"
+      }));
+    }
+  }
 };
 function createOutboundBehavior(provider, deps) {
   if (provider === "openclaw") {
@@ -86627,15 +87098,27 @@ function resolveOutboundProvider(store, input) {
   if (input.override) {
     return input.override;
   }
+  if (input.jobId && resolveOpenClawGatewayRoute(store, { jobId: input.jobId })) {
+    return "openclaw";
+  }
   try {
-    return resolveConfiguredAiProviderForJob({
+    const configured = resolveConfiguredAiProviderForJob({
       store,
       jobId: input.jobId,
       env: process.env
-    }) ?? "codex";
+    });
+    if (configured) {
+      return configured;
+    }
   } catch {
-    return "codex";
   }
+  if (readSyncedOpenClawGatewayConfig(store.homeDir)) {
+    if (input.jobId?.trim()) {
+      return store.bindJobProviderIfMissing({ jobId: input.jobId.trim(), provider: "openclaw" }).binding.provider;
+    }
+    return "openclaw";
+  }
+  return "codex";
 }
 async function notifyAgentMessageToUserAttention(input) {
   const ownedStore = input.store ? null : new SessionStore();
@@ -86767,6 +87250,9 @@ function bindOutboundJobProviderToCurrentDefault(sessionStore, jobId) {
     logWithTimestamp(`[okx-agent-task] job provider bind failed from outbound-xmtp: job=${jobId}`, err2);
   }
 }
+function bindOutboundOpenClawRouteIfCurrent(sessionStore, jobId, gatewaySessionKeys) {
+  bindOpenClawGatewayRouteFromEnv(sessionStore, { jobId, gatewaySessionKeys });
+}
 function buildTaskPayload(replyToMessageId) {
   return {
     taskMinVersion: TASK_MIN_VERSION,
@@ -87203,6 +87689,7 @@ async function handleSqliteGroupSendCommand(params) {
         myAgentXmtpAddress: myXmtpAddress,
         toAgentXmtpAddress: remote.toXmtpAddress
       });
+      bindOutboundOpenClawRouteIfCurrent(sessionStore, command.jobId, command.gatewaySessionKeys);
       return { conversation: conversation2, created: created2 };
     }
   );
@@ -87529,7 +88016,7 @@ async function handleXmtpSendCommand(params) {
     const sessionStore2 = params.sessionStore ?? ownedStore2;
     try {
       bindOutboundJobProviderToCurrentDefault(sessionStore2, command.jobId);
-      resolveConfiguredAiProviderForJob({ store: sessionStore2, jobId: command.jobId });
+      bindOutboundOpenClawRouteIfCurrent(sessionStore2, command.jobId, command.gatewaySessionKeys);
       return await handleSqliteGroupSendCommand({
         command,
         service,
@@ -87543,7 +88030,7 @@ async function handleXmtpSendCommand(params) {
   const sessionStore = params.sessionStore ?? ownedStore;
   try {
     bindOutboundJobProviderToCurrentDefault(sessionStore, command.jobId);
-    resolveConfiguredAiProviderForJob({ store: sessionStore, jobId: command.jobId });
+    bindOutboundOpenClawRouteIfCurrent(sessionStore, command.jobId, command.gatewaySessionKeys);
     const { file, sessionAgentId } = await readFileForSend({
       command,
       store,
@@ -89650,7 +90137,7 @@ function userWatchEventDeliveredSentryExtra(event) {
 var environment = process.env.SENTRY_ENV === "dev" ? "dev" : "prod";
 var SENTRY_CONFIG = {
   projectName: "okx/openclaw-okx-a2a-extension",
-  release: "0.0.15",
+  release: "0.0.16-beta-d0ec14bc63-260623110312",
   environment
 };
 
@@ -89771,12 +90258,12 @@ async function runListenerWithLock(options, paths) {
       }));
     }
   });
-  service.setPluginVersion("0.0.15");
+  service.setPluginVersion("0.0.16-beta-d0ec14bc63-260623110312");
   await service.init();
   const pluginVersionStatus = service.pluginVersionStatus;
   if (pluginVersionStatus.unavailable) {
     throw new Error(
-      `@okxweb3/a2a-node v${"0.0.15"} is below the required minimum v${pluginVersionStatus.minVersion}`
+      `@okxweb3/a2a-node v${"0.0.16-beta-d0ec14bc63-260623110312"} is below the required minimum v${pluginVersionStatus.minVersion}`
     );
   }
   const systemConfig = service.getSystemConfig();
@@ -89794,7 +90281,7 @@ async function runListenerWithLock(options, paths) {
       onchainosAgentId: "*",
       reason: "system-config missing sentryDsn",
       pluginId: "@okxweb3/a2a-node",
-      pluginVersion: "0.0.15"
+      pluginVersion: "0.0.16-beta-d0ec14bc63-260623110312"
     });
   }
   logWithTimestamp(
@@ -89963,8 +90450,8 @@ async function timeSettled(fn) {
 
 // src/update-cli.ts
 var import_promises6 = require("node:fs/promises");
-var import_node_os5 = require("node:os");
-var import_node_path17 = require("node:path");
+var import_node_os6 = require("node:os");
+var import_node_path18 = require("node:path");
 function isPrereleaseVersion(version2) {
   return /\d+\.\d+\.\d+-[0-9A-Za-z.-]+/.test(version2);
 }
@@ -90095,7 +90582,7 @@ function isEmptyInlineEnabledList(line) {
   return !!inline && inline.values.length === 0;
 }
 function resolveHermesConfigPath() {
-  return (0, import_node_path17.join)(process.env.HERMES_HOME ?? (0, import_node_path17.join)((0, import_node_os5.homedir)(), ".hermes"), "config.yaml");
+  return (0, import_node_path18.join)(process.env.HERMES_HOME ?? (0, import_node_path18.join)((0, import_node_os6.homedir)(), ".hermes"), "config.yaml");
 }
 function lineIndent(line) {
   const match = line.match(/^\s*/);
@@ -90167,6 +90654,7 @@ function parsePluginYamlVersion(content3) {
   GatewayOutboundBehavior,
   InvalidXmtpMessageStore,
   OFFLINE_REPLAY_SYNC_INTERVAL,
+  OPENCLAW_GATEWAY_ROUTE_GROUP_ID,
   SYSTEM_NOTIFICATION_SESSION_KEY,
   SessionStore,
   SqliteOutboundBehavior,
@@ -90180,6 +90668,7 @@ function parsePluginYamlVersion(content3) {
   bindJobProviderToCurrentDefaultIfMissing,
   bindJobProviderToCurrentRuntimeIfMissing,
   bindMessageJobProviderToCurrentDefault,
+  bindOpenClawGatewayRouteFromEnv,
   buildAgentMessageNotice,
   buildAiAdapterCommand,
   buildAiProviderEnv,
@@ -90200,6 +90689,7 @@ function parsePluginYamlVersion(content3) {
   createFileMessageHandler,
   createOutboundBehavior,
   createUserAttentionWatchParentMonitor,
+  currentOpenClawGatewaySessionKey,
   detectAiProviders,
   detectCurrentAiProvider,
   detectGatewayInvocation,
@@ -90233,6 +90723,8 @@ function parsePluginYamlVersion(content3) {
   resolveConfiguredAiProviderForJob,
   resolveDirectCommunicationSessionTarget,
   resolveOpenClawGatewayConfig,
+  resolveOpenClawGatewayRoute,
+  resolveOpenClawGatewayRoutes,
   resolveSystemNotificationTargets,
   resolveTaskConfigPath,
   resolveTaskHome,