@okxweb3/a2a-node 0.0.14 → 0.0.15-beta-1d2e01866f-260623014705

package/dist/index.js

@@ -1589,7 +1589,7 @@ var require_misc = __commonJS({
       }
     }
     var SEMVER_REGEXP = /^(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-]+)*))?$/;
-    function parseSemver3(input) {
+    function parseSemver2(input) {
       const match = input.match(SEMVER_REGEXP) || [];
       const major = parseInt(match[1], 10);
       const minor = parseInt(match[2], 10);
@@ -1631,7 +1631,7 @@ var require_misc = __commonJS({
     exports2.arrayify = arrayify;
     exports2.checkOrSetAlreadyCaught = checkOrSetAlreadyCaught;
     exports2.getEventDescription = getEventDescription;
-    exports2.parseSemver = parseSemver3;
+    exports2.parseSemver = parseSemver2;
     exports2.uuid4 = uuid4;
   }
 });
@@ -67969,7 +67969,6 @@ __export(index_exports, {
   detectCurrentAiProvider: () => detectCurrentAiProvider,
   detectGatewayInvocation: () => detectGatewayInvocation,
   detectRuntime: () => detectRuntime,
-  ensureCommunicationMinVersions: () => ensureCommunicationMinVersions,
   ensureDefaultAiProvider: () => ensureDefaultAiProvider,
   extractAiSessionId: () => extractAiSessionId,
   extractXmtpSentAtMs: () => extractXmtpSentAtMs2,
@@ -67977,7 +67976,6 @@ __export(index_exports, {
   handleXmtpSendCommand: () => handleXmtpSendCommand,
   hasAiRuntimeMarker: () => hasAiRuntimeMarker,
   heartbeatUserAttentionWatcher: () => heartbeatUserAttentionWatcher,
-  isBelowRequiredVersion: () => isBelowRequiredVersion,
   isOriginalParentProcessAlive: () => isOriginalParentProcessAlive,
   isPrereleaseVersion: () => isPrereleaseVersion,
   isRetryableOpenClawGatewayError: () => isRetryableOpenClawGatewayError,
@@ -70321,7 +70319,7 @@ function detectGatewayInvocation(env = process.env) {
   if (!isTruthyRuntimeMarker(env.OKX_A2A_IN_GATEWAY)) {
     return null;
   }
-  const provider = env.OKX_A2A_GATEWAY_PROVIDER;
+  const provider = env.OKX_A2A_GATEWAY_PROVIDER ?? env.OKX_A2A_AI_PROVIDER ?? env.OKX_AGENT_TASK_AI_CLI;
   if (!provider) {
     return null;
   }
@@ -71012,8 +71010,6 @@ var LogEvent = {
   AGENTS_WAKEUP_NOTIFIED: "Agents wakeup notified",
   CONFIG_SENSITIVE_WORDS_REFRESHED: "Sensitive words config refreshed",
   CONFIG_SYSTEM_REFRESHED: "System config refreshed",
-  FORCED_UPDATE_STARTED: "Forced update started",
-  FORCED_UPDATE_SUCCEEDED: "Forced update succeeded",
   GATEWAY_DISCONNECTED: "Gateway disconnected",
   GATEWAY_REQUEST: "Gateway request",
   GATEWAY_DELIVERY_BUFFERED: "Gateway delivery buffered",
@@ -71076,7 +71072,6 @@ var LogEvent = {
   CACHE_LOAD_FAILED: "Cache load failed",
   CACHE_WRITE_FAILED: "Cache write failed",
   CONFIG_LOAD_FAILED: "Config load failed",
-  FORCED_UPDATE_FAILED: "Forced update failed",
   SENTRY_INIT_SKIPPED: "Sentry init skipped",
   AGENT_DB_DIR_CREATE_FAILED: "Agent DB dir create failed"
 };
@@ -71253,8 +71248,6 @@ var SENTRY_INFO_ALLOWLIST = /* @__PURE__ */ new Set([
   LogEvent.BOOTSTRAP_APPLIED,
   LogEvent.CONFIG_SENSITIVE_WORDS_REFRESHED,
   LogEvent.CONFIG_SYSTEM_REFRESHED,
-  LogEvent.FORCED_UPDATE_STARTED,
-  LogEvent.FORCED_UPDATE_SUCCEEDED,
   LogEvent.CONVERSATION_HISTORY_QUERIED,
   LogEvent.FILE_DOWNLOADED,
   LogEvent.FILE_UPLOADED,
@@ -83541,18 +83534,6 @@ function parseTips(raw) {
 function parseStringArray(raw) {
   return Array.isArray(raw) ? raw.filter((value) => typeof value === "string" && value.length > 0) : [];
 }
-function readOptionalString(record, key) {
-  const value = record[key];
-  return typeof value === "string" ? value : "";
-}
-function readMinVersion(raw) {
-  const container = raw.minVersion && typeof raw.minVersion === "object" && !Array.isArray(raw.minVersion) ? raw.minVersion : raw.minVersions && typeof raw.minVersions === "object" && !Array.isArray(raw.minVersions) ? raw.minVersions : {};
-  return {
-    cli: readOptionalString(container, "cli") || readOptionalString(raw, "cliMinVersion"),
-    openclaw: readOptionalString(container, "openclaw") || readOptionalString(raw, "openclawMinVersion"),
-    hermes: readOptionalString(container, "hermes") || readOptionalString(raw, "hermesMinVersion")
-  };
-}
 function parseExtConfig(raw) {
   const obj = raw && typeof raw === "object" && !Array.isArray(raw) ? raw : {};
   return {
@@ -83574,14 +83555,13 @@ function parseSystemConfig(raw) {
     acc.push({ address, inboxId, type });
     return acc;
   }, []) : [];
-  const minVersion = readMinVersion(raw);
   return {
     heartbeatInterval: typeof raw.heartbeatInterval === "number" ? raw.heartbeatInterval : SYSTEM_CONFIG_DEFAULTS.heartbeatInterval,
     maxFileSizeBytes: typeof raw.maxFileSizeBytes === "number" && Number.isFinite(raw.maxFileSizeBytes) && raw.maxFileSizeBytes > 0 ? raw.maxFileSizeBytes : SYSTEM_CONFIG_DEFAULTS.maxFileSizeBytes,
     sensitiveUploadReg: parseStringArray(raw.SENSITIVE_UPLOAD_REG),
     accounts,
     sentryDsn: typeof raw.sentryDsn === "string" ? raw.sentryDsn : "",
-    minVersion,
+    minAvailablePluginVersion: typeof raw.minAvailablePluginVersion === "string" ? raw.minAvailablePluginVersion : "",
     extConfig: parseExtConfig(raw.extConfig)
   };
 }
@@ -83630,7 +83610,11 @@ var XmtpService = class _XmtpService {
   _initFailures = [];
   _backupReady = Promise.resolve();
   _onAfterInitError = null;
-  _cliVersion = "";
+  _pluginVersion = "";
+  _pluginVersionStatus = {
+    unavailable: false,
+    minVersion: ""
+  };
   dataDir = DEFAULT_DATA_DIR;
   syncByAddress = /* @__PURE__ */ new Map();
   agentListFingerprint;
@@ -83678,11 +83662,11 @@ var XmtpService = class _XmtpService {
     ]);
     if (systemConfigResult.status === "fulfilled" && systemConfigResult.value) {
       this.systemConfig = parseSystemConfig(systemConfigResult.value);
-      const cliMinVersion = this.systemConfig.minVersion.cli;
-      if (this.isCliBelowMinVersion(cliMinVersion)) {
+      this.evaluatePluginVersion();
+      if (this._pluginVersionStatus.unavailable) {
         this._initialized = false;
         logWithTimestamp(
-          `[xmtp-sdk] init paused: cli v${this._cliVersion} is below the required minimum v${cliMinVersion}; daemon updater will attempt a forced update.`
+          `[xmtp-sdk] init aborted: plugin v${this._pluginVersion} is below the required minimum v${this._pluginVersionStatus.minVersion}. Run \`openclaw plugins update okx-a2a\` to upgrade.`
         );
         return;
       }
@@ -83726,6 +83710,9 @@ var XmtpService = class _XmtpService {
       logWithTimestamp("[xmtp-sdk] init: initXmtpInstall failed:", err2.message);
     }
     this._initialized = this._initFailures.length === 0;
+    if (this._initialized) {
+      this.evaluatePluginVersion();
+    }
     const clientCount = clientsResult.status === "fulfilled" ? clientsResult.value.size : 0;
     logWithTimestamp(
       `[xmtp-sdk] init done: initialized=${this._initialized}, clients=${clientCount}, failures=${this._initFailures.length}`
@@ -83767,6 +83754,7 @@ var XmtpService = class _XmtpService {
     this._initFailures = remaining;
     if (remaining.length === 0) {
       this._initialized = true;
+      this.evaluatePluginVersion();
     }
     return { ok: remaining.length === 0, failures: remaining };
   }
@@ -84259,14 +84247,27 @@ var XmtpService = class _XmtpService {
   getSystemConfig() {
     return this.systemConfig;
   }
-  // The daemon reports its own build version before init(); startup can pause
-  // before XMTP clients are created while the node listener performs the actual
-  // forced update.
-  setCliVersion(version2) {
-    this._cliVersion = version2 ?? "";
-  }
-  isCliBelowMinVersion(minVersion) {
-    return Boolean(minVersion) && isValidSemver(minVersion) && isValidSemver(this._cliVersion) && semverLt(this._cliVersion, minVersion);
+  // The plugin reports its own build version (injected via esbuild
+  // define) before calling init(); we compare it once against
+  // systemConfig.minAvailablePluginVersion when init completes, then
+  // freeze the result. Tool guards read the cached status, so per-call
+  // semver work is avoided entirely.
+  setPluginVersion(version2) {
+    this._pluginVersion = version2 ?? "";
+  }
+  get pluginVersionStatus() {
+    return this._pluginVersionStatus;
+  }
+  evaluatePluginVersion() {
+    const min = this.systemConfig.minAvailablePluginVersion;
+    if (!min || !isValidSemver(min) || !isValidSemver(this._pluginVersion)) {
+      this._pluginVersionStatus = { unavailable: false, minVersion: min ?? "" };
+      return;
+    }
+    this._pluginVersionStatus = {
+      unavailable: semverLt(this._pluginVersion, min),
+      minVersion: min
+    };
   }
   // Force-refresh systemConfig from onchainos API (falls back to disk
   // cache). Single in-flight promise is shared by concurrent callers so
@@ -84281,6 +84282,7 @@ var XmtpService = class _XmtpService {
         const raw = await loadSystemConfigWith(this.dataDir, this.tools.fetchSystemConfig);
         if (raw) {
           this.systemConfig = parseSystemConfig(raw);
+          this.evaluatePluginVersion();
         }
       } finally {
         this.systemConfigRefreshInflight = null;
@@ -85719,12 +85721,6 @@ var sharedClient = null;
 function resolveOpenClawGatewayConfig(env = process.env) {
   const synced = readSyncedGatewayConfig(env);
   const explicitUrl = env.OKX_A2A_OPENCLAW_GATEWAY_URL?.trim() || void 0;
-  if (!explicitUrl && !synced && requiresSyncedOpenClawGatewayConfig(env)) {
-    const expectedPath = resolveOpenClawGatewayConfigPath(env.OKX_AGENT_TASK_HOME);
-    throw new Error(
-      `OpenClaw gateway URL was not synced. Expected ${expectedPath}. Restart the OpenClaw gateway so okx-a2a can read the gateway URL from openclaw-gateway.json.`
-    );
-  }
   const defaultUrl = `ws://127.0.0.1:${DEFAULT_GATEWAY_PORT}`;
   const url = explicitUrl ?? synced?.url ?? defaultUrl;
   const password = env.OKX_A2A_OPENCLAW_GATEWAY_PASSWORD?.trim() || synced?.password || void 0;
@@ -86090,9 +86086,6 @@ function readSyncedGatewayConfig(env) {
     return null;
   }
 }
-function requiresSyncedOpenClawGatewayConfig(env) {
-  return env.OKX_A2A_GATEWAY_PROVIDER === "openclaw" || env.OKX_A2A_RUNTIME_CONTEXT === "openclaw-gateway" || env.OKX_A2A_IN_GATEWAY === "1";
-}
 function buildConnectParams(config, instanceId, protocolVersion) {
   return {
     minProtocol: protocolVersion,
@@ -86100,7 +86093,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     client: {
       id: "gateway-client",
       displayName: "okx-a2a-node",
-      version: "0.0.14",
+      version: "0.0.15-beta-1d2e01866f-260623014705",
       platform: "node",
       mode: "backend",
       instanceId
@@ -86111,7 +86104,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     commands: [],
     permissions: {},
     locale: Intl.DateTimeFormat().resolvedOptions().locale || "en-US",
-    userAgent: `okx-a2a-node/${"0.0.14"}`,
+    userAgent: `okx-a2a-node/${"0.0.15-beta-1d2e01866f-260623014705"}`,
     auth: {
       ...config.token ? { token: config.token } : {},
       ...config.password ? { password: config.password } : {}
@@ -89657,545 +89650,10 @@ function userWatchEventDeliveredSentryExtra(event) {
 var environment = process.env.SENTRY_ENV === "dev" ? "dev" : "prod";
 var SENTRY_CONFIG = {
   projectName: "okx/openclaw-okx-a2a-extension",
-  release: "0.0.14",
+  release: "0.0.15-beta-1d2e01866f-260623014705",
   environment
 };
 
-// src/forced-update.ts
-var import_node_child_process7 = require("node:child_process");
-
-// src/update-cli.ts
-var import_node_child_process6 = require("node:child_process");
-var import_promises6 = require("node:fs/promises");
-var import_node_os5 = require("node:os");
-var import_node_path17 = require("node:path");
-var UPDATE_PACKAGES = {
-  node: "@okxweb3/a2a-node",
-  openclaw: "@okxweb3/a2a-openclaw",
-  hermes: "@okxweb3/a2a-hermes"
-};
-function isPrereleaseVersion(version2) {
-  return /\d+\.\d+\.\d+-[0-9A-Za-z.-]+/.test(version2);
-}
-async function normalizeHermesOkxA2aPluginConfig(configFile = resolveHermesConfigPath()) {
-  let content3;
-  try {
-    content3 = await (0, import_promises6.readFile)(configFile, "utf8");
-  } catch (error) {
-    if (isNodeError(error) && error.code === "ENOENT") {
-      return false;
-    }
-    throw error;
-  }
-  const normalized = normalizeHermesPluginConfigContent(content3);
-  if (!normalized.changed) {
-    return false;
-  }
-  await (0, import_promises6.writeFile)(configFile, normalized.content);
-  console.log(`[update] normalized Hermes plugins.enabled okx-a2a entry in ${configFile}`);
-  return true;
-}
-function normalizeHermesPluginConfigContent(content3) {
-  const trailingNewline = content3.endsWith("\n");
-  const duplicateRepair = removeDuplicateInlineEnabledHeaders(content3.replace(/\n$/, "").split(/\n/));
-  const lines = duplicateRepair.lines;
-  let changed = duplicateRepair.changed;
-  let hasOkxA2a = false;
-  let inPlugins = false;
-  let pluginsIndent = -1;
-  let inEnabled = false;
-  let enabledIndent = -1;
-  let emittedOkxA2a = false;
-  const output = [];
-  for (const line of lines) {
-    const currentIndent = lineIndent(line);
-    const significant = line.trim() !== "" && !line.trimStart().startsWith("#");
-    const parsedListValue = parseYamlListValue(line);
-    if (inEnabled && significant && (currentIndent < enabledIndent || currentIndent === enabledIndent && !parsedListValue)) {
-      inEnabled = false;
-      emittedOkxA2a = false;
-    }
-    if (inPlugins && significant && currentIndent <= pluginsIndent && !isPluginsHeader(line)) {
-      inPlugins = false;
-      inEnabled = false;
-      emittedOkxA2a = false;
-    }
-    if (isPluginsHeader(line)) {
-      inPlugins = true;
-      pluginsIndent = currentIndent;
-      output.push(line);
-      continue;
-    }
-    if (inPlugins && isEnabledHeader(line) && currentIndent > pluginsIndent) {
-      inEnabled = true;
-      enabledIndent = currentIndent;
-      emittedOkxA2a = false;
-      output.push(line);
-      continue;
-    }
-    const inlineEnabled = inPlugins ? parseInlineEnabledList(line) : null;
-    if (inlineEnabled && currentIndent > pluginsIndent) {
-      const normalized = normalizeInlineEnabledList(inlineEnabled);
-      output.push(...normalized.lines);
-      changed ||= normalized.changed;
-      hasOkxA2a ||= normalized.hasOkxA2a;
-      continue;
-    }
-    if (inEnabled) {
-      const parsed = parsedListValue;
-      if (parsed && (parsed.value === "okx-a2a" || parsed.value === "platforms/okx-a2a")) {
-        hasOkxA2a = true;
-        if (!emittedOkxA2a) {
-          const normalized = `${parsed.indent}- okx-a2a`;
-          output.push(normalized);
-          changed ||= normalized !== line;
-          emittedOkxA2a = true;
-        } else {
-          changed = true;
-        }
-        continue;
-      }
-    }
-    output.push(line);
-  }
-  return { content: `${output.join("\n")}${trailingNewline ? "\n" : ""}`, changed, hasOkxA2a };
-}
-function removeDuplicateInlineEnabledHeaders(lines) {
-  let changed = false;
-  let inPlugins = false;
-  let pluginsIndent = -1;
-  const output = [];
-  for (let i = 0; i < lines.length; i++) {
-    const line = lines[i];
-    const currentIndent = lineIndent(line);
-    const significant = line.trim() !== "" && !line.trimStart().startsWith("#");
-    if (inPlugins && significant && currentIndent <= pluginsIndent && !isPluginsHeader(line)) {
-      inPlugins = false;
-    }
-    if (isPluginsHeader(line)) {
-      inPlugins = true;
-      pluginsIndent = currentIndent;
-      output.push(line);
-      continue;
-    }
-    if (inPlugins && isEmptyInlineEnabledList(line) && hasLaterEnabledHeaderInPlugins(lines, i + 1, pluginsIndent)) {
-      changed = true;
-      continue;
-    }
-    output.push(line);
-  }
-  return { lines: output, changed };
-}
-function hasLaterEnabledHeaderInPlugins(lines, startIndex, pluginsIndent) {
-  for (let i = startIndex; i < lines.length; i++) {
-    const line = lines[i];
-    const significant = line.trim() !== "" && !line.trimStart().startsWith("#");
-    if (significant && lineIndent(line) <= pluginsIndent) {
-      return false;
-    }
-    if (isEnabledHeader(line) || parseInlineEnabledList(line)) {
-      return true;
-    }
-  }
-  return false;
-}
-function isEmptyInlineEnabledList(line) {
-  const inline = parseInlineEnabledList(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");
-}
-function lineIndent(line) {
-  const match = line.match(/^\s*/);
-  return match?.[0].length ?? 0;
-}
-function isPluginsHeader(line) {
-  return /^[\s]*plugins:[\s]*(?:#.*)?$/.test(line);
-}
-function isEnabledHeader(line) {
-  return /^[\s]*enabled:[\s]*(?:#.*)?$/.test(line);
-}
-function parseInlineEnabledList(line) {
-  const match = line.match(/^(\s*)enabled:\s*\[(.*)\]\s*(?:#.*)?$/);
-  if (!match) {
-    return null;
-  }
-  const values = (match[2] ?? "").split(",").map((value) => value.trim().replace(/^["']|["']$/g, "")).filter(Boolean);
-  return { indent: match[1] ?? "", values };
-}
-function normalizeInlineEnabledList(input) {
-  let hasOkxA2a = false;
-  const values = [];
-  for (const value of input.values) {
-    if (value === "okx-a2a" || value === "platforms/okx-a2a") {
-      hasOkxA2a = true;
-      if (!values.includes("okx-a2a")) {
-        values.push("okx-a2a");
-      }
-      continue;
-    }
-    values.push(value);
-  }
-  return {
-    lines: values.length > 0 ? [`${input.indent}enabled:`, ...values.map((value) => `${input.indent}  - ${value}`)] : [`${input.indent}enabled: []`],
-    changed: hasOkxA2a,
-    hasOkxA2a
-  };
-}
-function parseYamlListValue(line) {
-  const match = line.match(/^(\s*)-\s*(?:"([^"]*)"|'([^']*)'|([^#\s]+))(?:\s*(?:#.*)?)?$/);
-  if (!match) {
-    return null;
-  }
-  return {
-    indent: match[1] ?? "",
-    value: match[2] ?? match[3] ?? match[4] ?? ""
-  };
-}
-function isNodeError(error) {
-  return error instanceof Error && "code" in error;
-}
-async function getInstalledGatewayPluginVersion(target) {
-  if (target === "hermes") {
-    return await getInstalledHermesPluginVersion() ?? await getGlobalNpmPackageVersion(UPDATE_PACKAGES.hermes);
-  }
-  return (await getInstalledOpenClawPluginInfo()).version;
-}
-async function getInstalledOpenClawPluginInfo() {
-  let result = await runCommandCaptureOptional("openclaw", ["plugins", "list", "--json"]);
-  if (!result.ok) {
-    result = await runCommandCaptureOptional("openclaw", ["plugins", "list"]);
-  }
-  if (!result.ok) {
-    return { installed: false, version: null };
-  }
-  return parseOpenClawPluginList(result.stdout);
-}
-function parseOpenClawPluginList(output) {
-  if (!output.trim()) {
-    return { installed: false, version: null };
-  }
-  try {
-    return findOpenClawPluginInJson(JSON.parse(output));
-  } catch {
-    return {
-      installed: output.includes(UPDATE_PACKAGES.openclaw) || /(^|[\s@/])okx-a2a($|[\s@])/.test(output),
-      version: parsePackageVersionFromText(output)
-    };
-  }
-}
-function findOpenClawPluginInJson(value) {
-  if (Array.isArray(value)) {
-    for (const item of value) {
-      const found = findOpenClawPluginInJson(item);
-      if (found.installed) {
-        return found;
-      }
-    }
-    return { installed: false, version: null };
-  }
-  if (!value || typeof value !== "object") {
-    return { installed: false, version: null };
-  }
-  const record = value;
-  if (isOpenClawPluginRecord(record)) {
-    return { installed: true, version: readVersionField(record) };
-  }
-  const dependencies = record.dependencies;
-  if (dependencies && typeof dependencies === "object") {
-    const dependency = dependencies[UPDATE_PACKAGES.openclaw] ?? dependencies["okx-a2a"];
-    if (dependency && typeof dependency === "object") {
-      return { installed: true, version: readVersionField(dependency) };
-    }
-  }
-  for (const key of ["plugins", "items", "data", "installed"]) {
-    const child = record[key];
-    if (child !== void 0) {
-      const found = findOpenClawPluginInJson(child);
-      if (found.installed) {
-        return found;
-      }
-    }
-  }
-  return { installed: false, version: null };
-}
-function isOpenClawPluginRecord(record) {
-  return Object.values(record).some((value) => {
-    if (typeof value !== "string") {
-      return false;
-    }
-    return value === "okx-a2a" || value === UPDATE_PACKAGES.openclaw || value.endsWith("/okx-a2a");
-  });
-}
-function readVersionField(record) {
-  for (const key of ["version", "installedVersion", "packageVersion"]) {
-    const value = record[key];
-    if (typeof value === "string" && value.trim()) {
-      return value.trim();
-    }
-  }
-  return null;
-}
-function parsePackageVersionFromText(output) {
-  return output.match(/@okxweb3\/a2a-openclaw@([0-9A-Za-z.+-]+)/)?.[1] ?? null;
-}
-async function getInstalledHermesPluginVersion() {
-  const pluginYaml = (0, import_node_path17.join)(process.env.HERMES_HOME ?? (0, import_node_path17.join)((0, import_node_os5.homedir)(), ".hermes"), "plugins", "platforms", "okx-a2a", "plugin.yaml");
-  try {
-    const content3 = await (0, import_promises6.readFile)(pluginYaml, "utf8");
-    return parsePluginYamlVersion(content3);
-  } catch (error) {
-    if (isNodeError(error) && error.code === "ENOENT") {
-      return null;
-    }
-    throw error;
-  }
-}
-function parsePluginYamlVersion(content3) {
-  for (const line of content3.split(/\r?\n/)) {
-    const match = line.match(/^\s*version:\s*(?:"([^"]+)"|'([^']+)'|([^#\s]+))/);
-    if (match) {
-      return match[1] ?? match[2] ?? match[3] ?? null;
-    }
-  }
-  return null;
-}
-async function getGlobalNpmPackageVersion(packageName) {
-  const result = await runCommandCaptureOptional("npm", ["list", "-g", packageName, "--depth=0", "--json"]);
-  if (!result.ok) {
-    return null;
-  }
-  try {
-    const parsed = JSON.parse(result.stdout);
-    return parsed.dependencies?.[packageName]?.version ?? null;
-  } catch {
-    return null;
-  }
-}
-async function runCommandCaptureOptional(command, args) {
-  return await new Promise((resolvePromise) => {
-    const child = (0, import_node_child_process6.spawn)(command, args, { stdio: ["ignore", "pipe", "ignore"] });
-    let stdout = "";
-    child.stdout.setEncoding("utf8");
-    child.stdout.on("data", (chunk) => {
-      stdout += chunk;
-    });
-    child.on("error", () => {
-      resolvePromise({ ok: false, stdout });
-    });
-    child.on("close", (code2) => {
-      resolvePromise({ ok: code2 === 0, stdout });
-    });
-  });
-}
-
-// src/forced-update.ts
-var SEMVER_RE2 = /^(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-]+)*)?$/;
-function normalizeSemverInput2(value) {
-  return value.trim().replace(/^v/, "");
-}
-function parseSemver2(value) {
-  const match = SEMVER_RE2.exec(normalizeSemverInput2(value));
-  if (!match) {
-    return null;
-  }
-  return {
-    major: Number(match[1]),
-    minor: Number(match[2]),
-    patch: Number(match[3]),
-    prerelease: match[4] ? match[4].split(".") : []
-  };
-}
-function comparePrereleaseId2(a, b) {
-  const aIsNumber = /^\d+$/.test(a);
-  const bIsNumber = /^\d+$/.test(b);
-  if (aIsNumber && bIsNumber) {
-    const an = Number(a);
-    const bn = Number(b);
-    return an < bn ? -1 : an > bn ? 1 : 0;
-  }
-  if (aIsNumber) {
-    return -1;
-  }
-  if (bIsNumber) {
-    return 1;
-  }
-  return a < b ? -1 : a > b ? 1 : 0;
-}
-function compareSemver2(a, b) {
-  if (a.major !== b.major) {
-    return a.major < b.major ? -1 : 1;
-  }
-  if (a.minor !== b.minor) {
-    return a.minor < b.minor ? -1 : 1;
-  }
-  if (a.patch !== b.patch) {
-    return a.patch < b.patch ? -1 : 1;
-  }
-  if (a.prerelease.length === 0 && b.prerelease.length === 0) {
-    return 0;
-  }
-  if (a.prerelease.length === 0) {
-    return 1;
-  }
-  if (b.prerelease.length === 0) {
-    return -1;
-  }
-  const len = Math.min(a.prerelease.length, b.prerelease.length);
-  for (let i = 0; i < len; i++) {
-    const diff = comparePrereleaseId2(a.prerelease[i], b.prerelease[i]);
-    if (diff !== 0) {
-      return diff;
-    }
-  }
-  if (a.prerelease.length !== b.prerelease.length) {
-    return a.prerelease.length < b.prerelease.length ? -1 : 1;
-  }
-  return 0;
-}
-function isBelowRequiredVersion(currentVersion, minVersion) {
-  const min = minVersion?.trim();
-  if (!min) {
-    return false;
-  }
-  const parsedMin = parseSemver2(min);
-  if (!parsedMin) {
-    logWithTimestamp(`[okx-agent-task] ignoring invalid forced minVersion=${min}`);
-    return false;
-  }
-  const current = currentVersion?.trim();
-  if (!current) {
-    return true;
-  }
-  const parsedCurrent = parseSemver2(current);
-  if (!parsedCurrent) {
-    logWithTimestamp(`[okx-agent-task] current version is invalid, forcing update current=${current} min=${min}`);
-    return true;
-  }
-  return compareSemver2(parsedCurrent, parsedMin) < 0;
-}
-async function ensureCommunicationMinVersions(input) {
-  const runUpdate = input.runUpdate ?? runOkxA2aForcedUpdate;
-  const cliMinVersion = input.systemConfig.minVersion.cli;
-  const currentCliVersion = input.currentCliVersion ?? "0.0.14";
-  if (isBelowRequiredVersion(currentCliVersion, cliMinVersion)) {
-    await forceUpdate({
-      target: "cli",
-      currentVersion: currentCliVersion,
-      minVersion: cliMinVersion,
-      stage: input.stage,
-      runUpdate
-    });
-    return { updated: true, target: "cli", currentVersion: currentCliVersion, minVersion: cliMinVersion };
-  }
-  const provider = resolveConfiguredAiProvider({ store: input.sessionStore, env: input.env });
-  const gatewayTarget = providerToGatewayTarget(provider);
-  if (!gatewayTarget) {
-    logWithTimestamp(`[okx-agent-task] forced minVersion gateway check skipped provider=${provider ?? "(not set)"}`);
-    return { updated: false };
-  }
-  const minVersion = input.systemConfig.minVersion[gatewayTarget];
-  if (!minVersion) {
-    return { updated: false, target: gatewayTarget };
-  }
-  const getGatewayVersion = input.getGatewayVersion ?? getInstalledGatewayPluginVersion;
-  const currentVersion = await getGatewayVersion(gatewayTarget);
-  if (!isBelowRequiredVersion(currentVersion, minVersion)) {
-    return { updated: false, target: gatewayTarget, currentVersion, minVersion };
-  }
-  await forceUpdate({
-    target: gatewayTarget,
-    currentVersion,
-    minVersion,
-    stage: input.stage,
-    runUpdate
-  });
-  return { updated: true, target: gatewayTarget, currentVersion, minVersion };
-}
-function providerToGatewayTarget(provider) {
-  return provider === "openclaw" || provider === "hermes" ? provider : null;
-}
-async function forceUpdate(input) {
-  const startedAt = Date.now();
-  logWithTimestamp(
-    `[okx-agent-task] forced update required target=${input.target} current=${input.currentVersion ?? "(unknown)"} min=${input.minVersion} stage=${input.stage}`
-  );
-  logger.info(LogEvent.FORCED_UPDATE_STARTED, forcedUpdateSentryExtra(input, startedAt, {
-    status: "started",
-    reason: "forced_update_required"
-  }));
-  try {
-    await input.runUpdate(input.target);
-    logger.info(LogEvent.FORCED_UPDATE_SUCCEEDED, forcedUpdateSentryExtra(input, startedAt, {
-      status: "succeeded",
-      reason: "update_completed"
-    }));
-  } catch (err2) {
-    const error = err2 instanceof Error ? err2 : new Error(String(err2));
-    logger.error(LogEvent.FORCED_UPDATE_FAILED, error, forcedUpdateSentryExtra(input, startedAt, {
-      status: "failed",
-      reason: "update_failed",
-      errorName: error.name,
-      errorMessage: error.message,
-      errorStack: error.stack ?? "",
-      ...forcedUpdateErrorDetails(err2)
-    }));
-    throw err2;
-  }
-}
-function forcedUpdateSentryExtra(input, startedAt, extra) {
-  return {
-    component: "node_listener",
-    stage: input.stage,
-    updateTarget: input.target,
-    currentVersion: input.currentVersion ?? "",
-    minVersion: input.minVersion,
-    durationMs: String(Date.now() - startedAt),
-    ...extra
-  };
-}
-function forcedUpdateErrorDetails(err2) {
-  if (!err2 || typeof err2 !== "object") {
-    return {};
-  }
-  const record = err2;
-  return {
-    exitCode: record.exitCode ?? record.code ?? "",
-    signal: record.signal ?? ""
-  };
-}
-function runOkxA2aForcedUpdate(target) {
-  const args = [
-    "update",
-    ...target === "cli" ? [] : [target],
-    "--release",
-    "latest",
-    "--restart",
-    "--yes"
-  ];
-  return new Promise((resolvePromise, reject) => {
-    const child = (0, import_node_child_process7.spawn)("okx-a2a", args, {
-      stdio: "inherit",
-      env: {
-        ...process.env,
-        OKX_A2A_FORCED_UPDATE_TARGET: target
-      }
-    });
-    child.on("error", reject);
-    child.on("close", (code2, signal) => {
-      if (code2 === 0) {
-        resolvePromise();
-        return;
-      }
-      reject(Object.assign(
-        new Error(`okx-a2a ${args.join(" ")} failed with ${signal ? `signal=${signal}` : `code=${code2}`}`),
-        { exitCode: code2, signal }
-      ));
-    });
-  });
-}
-
 // src/listener.ts
 var OFFLINE_REPLAY_SYNC_INTERVAL = 5;
 function shouldRunOfflineReplay(syncCount, interval = OFFLINE_REPLAY_SYNC_INTERVAL) {
@@ -90313,23 +89771,13 @@ async function runListenerWithLock(options, paths) {
       }));
     }
   });
-  service.setCliVersion("0.0.14");
+  service.setPluginVersion("0.0.15-beta-1d2e01866f-260623014705");
   await service.init();
-  const startupVersionCheck = await ensureCommunicationMinVersions({
-    systemConfig: service.getSystemConfig(),
-    sessionStore,
-    stage: "startup"
-  });
-  if (startupVersionCheck.updated) {
-    logWithTimestamp(
-      `[okx-agent-task] forced update executed during startup target=${startupVersionCheck.target}; exiting current listener so restarted daemon can take over`
+  const pluginVersionStatus = service.pluginVersionStatus;
+  if (pluginVersionStatus.unavailable) {
+    throw new Error(
+      `@okxweb3/a2a-node v${"0.0.15-beta-1d2e01866f-260623014705"} is below the required minimum v${pluginVersionStatus.minVersion}`
     );
-    await watcherCoordinator.stop();
-    await userAttentionEvents?.close();
-    stopClients(service);
-    sessionStore.close();
-    commands.close();
-    return;
   }
   const systemConfig = service.getSystemConfig();
   if (systemConfig.sentryDsn) {
@@ -90346,7 +89794,7 @@ async function runListenerWithLock(options, paths) {
       onchainosAgentId: "*",
       reason: "system-config missing sentryDsn",
       pluginId: "@okxweb3/a2a-node",
-      pluginVersion: "0.0.14"
+      pluginVersion: "0.0.15-beta-1d2e01866f-260623014705"
     });
   }
   logWithTimestamp(
@@ -90438,18 +89886,6 @@ async function runListenerWithLock(options, paths) {
       if (stopping) {
         return;
       }
-      const versionCheck = await ensureCommunicationMinVersions({
-        systemConfig: service.getSystemConfig(),
-        sessionStore,
-        stage: "system_config_refresh"
-      });
-      if (versionCheck.updated) {
-        logWithTimestamp(
-          `[okx-agent-task] forced update executed after system-config refresh target=${versionCheck.target}; stopping current listener`
-        );
-        process.kill(process.pid, "SIGTERM");
-        return;
-      }
       const nextIntervalSec = Math.max(10, service.getSystemConfig().heartbeatInterval);
       if (nextIntervalSec !== previousIntervalSec) {
         logWithTimestamp(
@@ -90524,6 +89960,202 @@ async function timeSettled(fn) {
     return { durationMs: Date.now() - startedAt, error };
   }
 }
+
+// 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");
+function isPrereleaseVersion(version2) {
+  return /\d+\.\d+\.\d+-[0-9A-Za-z.-]+/.test(version2);
+}
+async function normalizeHermesOkxA2aPluginConfig(configFile = resolveHermesConfigPath()) {
+  let content3;
+  try {
+    content3 = await (0, import_promises6.readFile)(configFile, "utf8");
+  } catch (error) {
+    if (isNodeError(error) && error.code === "ENOENT") {
+      return false;
+    }
+    throw error;
+  }
+  const normalized = normalizeHermesPluginConfigContent(content3);
+  if (!normalized.changed) {
+    return false;
+  }
+  await (0, import_promises6.writeFile)(configFile, normalized.content);
+  console.log(`[update] normalized Hermes plugins.enabled okx-a2a entry in ${configFile}`);
+  return true;
+}
+function normalizeHermesPluginConfigContent(content3) {
+  const trailingNewline = content3.endsWith("\n");
+  const duplicateRepair = removeDuplicateInlineEnabledHeaders(content3.replace(/\n$/, "").split(/\n/));
+  const lines = duplicateRepair.lines;
+  let changed = duplicateRepair.changed;
+  let hasOkxA2a = false;
+  let inPlugins = false;
+  let pluginsIndent = -1;
+  let inEnabled = false;
+  let enabledIndent = -1;
+  let emittedOkxA2a = false;
+  const output = [];
+  for (const line of lines) {
+    const currentIndent = lineIndent(line);
+    const significant = line.trim() !== "" && !line.trimStart().startsWith("#");
+    const parsedListValue = parseYamlListValue(line);
+    if (inEnabled && significant && (currentIndent < enabledIndent || currentIndent === enabledIndent && !parsedListValue)) {
+      inEnabled = false;
+      emittedOkxA2a = false;
+    }
+    if (inPlugins && significant && currentIndent <= pluginsIndent && !isPluginsHeader(line)) {
+      inPlugins = false;
+      inEnabled = false;
+      emittedOkxA2a = false;
+    }
+    if (isPluginsHeader(line)) {
+      inPlugins = true;
+      pluginsIndent = currentIndent;
+      output.push(line);
+      continue;
+    }
+    if (inPlugins && isEnabledHeader(line) && currentIndent > pluginsIndent) {
+      inEnabled = true;
+      enabledIndent = currentIndent;
+      emittedOkxA2a = false;
+      output.push(line);
+      continue;
+    }
+    const inlineEnabled = inPlugins ? parseInlineEnabledList(line) : null;
+    if (inlineEnabled && currentIndent > pluginsIndent) {
+      const normalized = normalizeInlineEnabledList(inlineEnabled);
+      output.push(...normalized.lines);
+      changed ||= normalized.changed;
+      hasOkxA2a ||= normalized.hasOkxA2a;
+      continue;
+    }
+    if (inEnabled) {
+      const parsed = parsedListValue;
+      if (parsed && (parsed.value === "okx-a2a" || parsed.value === "platforms/okx-a2a")) {
+        hasOkxA2a = true;
+        if (!emittedOkxA2a) {
+          const normalized = `${parsed.indent}- okx-a2a`;
+          output.push(normalized);
+          changed ||= normalized !== line;
+          emittedOkxA2a = true;
+        } else {
+          changed = true;
+        }
+        continue;
+      }
+    }
+    output.push(line);
+  }
+  return { content: `${output.join("\n")}${trailingNewline ? "\n" : ""}`, changed, hasOkxA2a };
+}
+function removeDuplicateInlineEnabledHeaders(lines) {
+  let changed = false;
+  let inPlugins = false;
+  let pluginsIndent = -1;
+  const output = [];
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    const currentIndent = lineIndent(line);
+    const significant = line.trim() !== "" && !line.trimStart().startsWith("#");
+    if (inPlugins && significant && currentIndent <= pluginsIndent && !isPluginsHeader(line)) {
+      inPlugins = false;
+    }
+    if (isPluginsHeader(line)) {
+      inPlugins = true;
+      pluginsIndent = currentIndent;
+      output.push(line);
+      continue;
+    }
+    if (inPlugins && isEmptyInlineEnabledList(line) && hasLaterEnabledHeaderInPlugins(lines, i + 1, pluginsIndent)) {
+      changed = true;
+      continue;
+    }
+    output.push(line);
+  }
+  return { lines: output, changed };
+}
+function hasLaterEnabledHeaderInPlugins(lines, startIndex, pluginsIndent) {
+  for (let i = startIndex; i < lines.length; i++) {
+    const line = lines[i];
+    const significant = line.trim() !== "" && !line.trimStart().startsWith("#");
+    if (significant && lineIndent(line) <= pluginsIndent) {
+      return false;
+    }
+    if (isEnabledHeader(line) || parseInlineEnabledList(line)) {
+      return true;
+    }
+  }
+  return false;
+}
+function isEmptyInlineEnabledList(line) {
+  const inline = parseInlineEnabledList(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");
+}
+function lineIndent(line) {
+  const match = line.match(/^\s*/);
+  return match?.[0].length ?? 0;
+}
+function isPluginsHeader(line) {
+  return /^[\s]*plugins:[\s]*(?:#.*)?$/.test(line);
+}
+function isEnabledHeader(line) {
+  return /^[\s]*enabled:[\s]*(?:#.*)?$/.test(line);
+}
+function parseInlineEnabledList(line) {
+  const match = line.match(/^(\s*)enabled:\s*\[(.*)\]\s*(?:#.*)?$/);
+  if (!match) {
+    return null;
+  }
+  const values = (match[2] ?? "").split(",").map((value) => value.trim().replace(/^["']|["']$/g, "")).filter(Boolean);
+  return { indent: match[1] ?? "", values };
+}
+function normalizeInlineEnabledList(input) {
+  let hasOkxA2a = false;
+  const values = [];
+  for (const value of input.values) {
+    if (value === "okx-a2a" || value === "platforms/okx-a2a") {
+      hasOkxA2a = true;
+      if (!values.includes("okx-a2a")) {
+        values.push("okx-a2a");
+      }
+      continue;
+    }
+    values.push(value);
+  }
+  return {
+    lines: values.length > 0 ? [`${input.indent}enabled:`, ...values.map((value) => `${input.indent}  - ${value}`)] : [`${input.indent}enabled: []`],
+    changed: hasOkxA2a,
+    hasOkxA2a
+  };
+}
+function parseYamlListValue(line) {
+  const match = line.match(/^(\s*)-\s*(?:"([^"]*)"|'([^']*)'|([^#\s]+))(?:\s*(?:#.*)?)?$/);
+  if (!match) {
+    return null;
+  }
+  return {
+    indent: match[1] ?? "",
+    value: match[2] ?? match[3] ?? match[4] ?? ""
+  };
+}
+function isNodeError(error) {
+  return error instanceof Error && "code" in error;
+}
+function parsePluginYamlVersion(content3) {
+  for (const line of content3.split(/\r?\n/)) {
+    const match = line.match(/^\s*version:\s*(?:"([^"]+)"|'([^']+)'|([^#\s]+))/);
+    if (match) {
+      return match[1] ?? match[2] ?? match[3] ?? null;
+    }
+  }
+  return null;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AI_PROVIDERS,
@@ -90572,7 +90204,6 @@ async function timeSettled(fn) {
   detectCurrentAiProvider,
   detectGatewayInvocation,
   detectRuntime,
-  ensureCommunicationMinVersions,
   ensureDefaultAiProvider,
   extractAiSessionId,
   extractXmtpSentAtMs,
@@ -90580,7 +90211,6 @@ async function timeSettled(fn) {
   handleXmtpSendCommand,
   hasAiRuntimeMarker,
   heartbeatUserAttentionWatcher,
-  isBelowRequiredVersion,
   isOriginalParentProcessAlive,
   isPrereleaseVersion,
   isRetryableOpenClawGatewayError,