@okxweb3/a2a-node 0.2.6-beta-5b74111b38-260814141953 → 0.2.6

package/dist/cli.js

@@ -2972,6 +2972,18 @@ function systemdUnitHasCurrentRestartPolicy(content2) {
 function launchdPlistHasCurrentRestartPolicy(content2) {
   return content2.includes("<key>SuccessfulExit</key>");
 }
+function decodeXmlText(value) {
+  return value.replace(/&apos;/g, "'").replace(/&quot;/g, '"').replace(/&gt;/g, ">").replace(/&lt;/g, "<").replace(/&amp;/g, "&");
+}
+function servicePathHasRequiredEntries(content2, platform, requiredEntries) {
+  const pathValue = platform === "linux" ? content2.match(/^Environment="PATH=(.*)"$/m)?.[1] : content2.match(/<key>PATH<\/key>\s*<string>([^<]*)<\/string>/)?.[1];
+  if (pathValue === void 0) {
+    return false;
+  }
+  const decodedPath = platform === "darwin" ? decodeXmlText(pathValue) : pathValue;
+  const entries = new Set(decodedPath.split(import_node_path9.delimiter).filter(Boolean));
+  return requiredEntries.every((entry) => entries.has(entry));
+}
 async function installedAutostartHasCurrentRestartPolicy() {
   try {
     if (process.platform === "linux") {
@@ -2992,11 +3004,11 @@ async function installedAutostartHasCurrentConfiguration() {
     const requiredPathEntries = requiredServicePathEntries();
     if (process.platform === "linux") {
       const content2 = await (0, import_promises3.readFile)(resolveSystemdAutostartPaths().servicePath, "utf8");
-      return systemdUnitHasCurrentRestartPolicy(content2) && requiredPathEntries.every((entry) => content2.includes(entry));
+      return systemdUnitHasCurrentRestartPolicy(content2) && servicePathHasRequiredEntries(content2, process.platform, requiredPathEntries);
     }
     if (process.platform === "darwin") {
       const content2 = await (0, import_promises3.readFile)(resolveLaunchdAutostartPaths().plistPath, "utf8");
-      return launchdPlistHasCurrentRestartPolicy(content2) && requiredPathEntries.every((entry) => content2.includes(entry));
+      return launchdPlistHasCurrentRestartPolicy(content2) && servicePathHasRequiredEntries(content2, process.platform, requiredPathEntries);
     }
   } catch {
     return true;
@@ -26636,7 +26648,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     client: {
       id: "gateway-client",
       displayName: "okx-a2a-node",
-      version: "0.2.6-beta-5b74111b38-260814141953",
+      version: "0.2.6",
       platform: "node",
       mode: "backend",
       instanceId
@@ -26647,7 +26659,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     commands: [],
     permissions: {},
     locale: Intl.DateTimeFormat().resolvedOptions().locale || "en-US",
-    userAgent: `okx-a2a-node/${"0.2.6-beta-5b74111b38-260814141953"}`,
+    userAgent: `okx-a2a-node/${"0.2.6"}`,
     auth: {
       ...config.token ? { token: config.token } : {},
       ...config.password ? { password: config.password } : {}
@@ -28556,7 +28568,7 @@ var init_sentry_config = __esm({
     environment = process.env.SENTRY_ENV === "dev" ? "dev" : "prod";
     SENTRY_CONFIG = {
       projectName: "okx/openclaw-okx-a2a-extension",
-      release: "0.2.6-beta-5b74111b38-260814141953",
+      release: "0.2.6",
       environment,
       runtimeContainer: normalizeRuntimeContainer(process.env.OKX_A2A_RUNTIME_CONTAINER)
     };
@@ -39726,7 +39738,7 @@ async function exportDiagnosticLogs(options) {
     node: process.version,
     platform: process.platform,
     arch: process.arch,
-    packageVersion: true ? "0.2.6-beta-5b74111b38-260814141953" : "unknown",
+    packageVersion: true ? "0.2.6" : "unknown",
     sensitiveContentIncluded: options.includeSensitiveContent,
     listenerAndLlmContentIncluded: true,
     credentialsAlwaysRedacted: true,
@@ -59808,6 +59820,30 @@ var init_a2a = __esm({
 function isNonEmptyPlainObject(v) {
   return !!v && typeof v === "object" && !Array.isArray(v) && Object.keys(v).length > 0;
 }
+function readStringRecord(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return {};
+  }
+  return Object.fromEntries(
+    Object.entries(value).filter((entry) => typeof entry[1] === "string")
+  );
+}
+function mergeA2AEnvelopeTips(payload, receiverTips) {
+  if (!payload || typeof payload !== "object" || Array.isArray(payload)) {
+    return payload;
+  }
+  const envelope = payload;
+  if (envelope.msgType !== A2A_MESSAGE_TYPE) {
+    return payload;
+  }
+  return {
+    ...envelope,
+    tips: {
+      ...readStringRecord(envelope.tips),
+      ...readStringRecord(receiverTips)
+    }
+  };
+}
 function buildA2AEnvelope(params) {
   const envelope = {
     msgType: A2A_MESSAGE_TYPE,
@@ -65611,11 +65647,11 @@ function extractXmtpSentAtMs2(msg) {
   }
   return Date.now();
 }
-function parsePayload(rawText) {
+function parseJson2(rawText) {
   try {
-    return { parsed: true, payload: JSON.parse(rawText) };
+    return { ok: true, data: JSON.parse(rawText) };
   } catch {
-    return { parsed: false, payload: null };
+    return { ok: false, data: null };
   }
 }
 function readString5(value) {
@@ -66524,10 +66560,21 @@ async function processFileMessage(ctx, deps, options = {}) {
     }
   }
   const parseStartedAt = Date.now();
-  const rawText = extractRawText(ctx.message.content);
-  const parsed = parsePayload(rawText);
+  const receivedRawText = extractRawText(ctx.message.content);
+  const parseResult = parseJson2(receivedRawText);
+  let rawText = receivedRawText;
+  if (parseResult.ok) {
+    const mergedPayload = mergeA2AEnvelopeTips(
+      parseResult.data,
+      XmtpService.getInstance().getSystemConfig().extConfig.tips
+    );
+    if (mergedPayload !== parseResult.data) {
+      parseResult.data = mergedPayload;
+      rawText = stringifySystemPayload(mergedPayload);
+    }
+  }
   timing.mark("payloadParse", parseStartedAt);
-  const directToUser = chatType === "dm" && parsed.parsed ? extractDirectToUserNotification(parsed.payload) : { kind: "none" };
+  const directToUser = chatType === "dm" && parseResult.ok ? extractDirectToUserNotification(parseResult.data) : { kind: "none" };
   if (directToUser.kind === "invalid") {
     const droppedMessageId = messageId || `direct-to-user-${(0, import_node_crypto14.randomUUID)()}`;
     logger.error(
@@ -66559,7 +66606,7 @@ async function processFileMessage(ctx, deps, options = {}) {
     });
     return true;
   }
-  const systemNotification = chatType === "dm" && parsed.parsed ? extractSystemNotification(parsed.payload) : null;
+  const systemNotification = chatType === "dm" && parseResult.ok ? extractSystemNotification(parseResult.data) : null;
   if (systemNotification) {
     const systemMessageId = messageId || `system-${(0, import_node_crypto14.randomUUID)()}`;
     logWithTimestamp(
@@ -66667,7 +66714,7 @@ async function processFileMessage(ctx, deps, options = {}) {
       maybeNotifyInboundAgentMessage({
         deps,
         chatType,
-        payload: parsed.payload,
+        payload: parseResult.data,
         jobId: systemNotification.jobId ?? BACKUP_JOB_ID,
         sessionKey: primaryTarget?.sessionKey ?? SYSTEM_NOTIFICATION_SESSION_KEY,
         messageId: systemMessageId
@@ -66712,13 +66759,13 @@ async function processFileMessage(ctx, deps, options = {}) {
         }));
       });
       logWithTimestamp(
-        `[okx-agent-task:${deps.myXmtpAddress}] session dispatch queued route=system/${target.route} session=${target.sessionKey} message=${shortenLogValue(systemMessageId)} ${summarizePayloadForLog(parsed.payload)}`
+        `[okx-agent-task:${deps.myXmtpAddress}] session dispatch queued route=system/${target.route} session=${target.sessionKey} message=${shortenLogValue(systemMessageId)} ${summarizePayloadForLog(parseResult.data)}`
       );
     }
     return true;
   }
   const routeStartedAt = Date.now();
-  const route = routeMessage(chatType, parsed.parsed, parsed.payload);
+  const route = routeMessage(chatType, parseResult.ok, parseResult.data);
   timing.mark("routeResolve", routeStartedAt);
   if (route.route === "job") {
     const providerBindStartedAt = Date.now();
@@ -66744,7 +66791,7 @@ async function processFileMessage(ctx, deps, options = {}) {
   }
   const sessionAgentId = route.route === "job" ? resolveSessionAgentId({
     chatType,
-    payload: parsed.parsed ? parsed.payload : null,
+    payload: parseResult.ok ? parseResult.data : null,
     myXmtpAddress: deps.myXmtpAddress
   }) : null;
   const xmtpSentAtMs = extractXmtpSentAtMs2(ctx.message);
@@ -66760,7 +66807,7 @@ async function processFileMessage(ctx, deps, options = {}) {
     );
   }
   if (route.route === "job" && chatType === "group") {
-    const payloadObject = isPlainObject3(parsed.parsed ? parsed.payload : null) ? parsed.payload : null;
+    const payloadObject = isPlainObject3(parseResult.ok ? parseResult.data : null) ? parseResult.data : null;
     const service = XmtpService.getInstance();
     const trustedSystemSender = service.isTrustedSystemAccountSender({
       senderAddress,
@@ -66791,7 +66838,7 @@ async function processFileMessage(ctx, deps, options = {}) {
     const myAgentId = localAgent?.agentId ?? readString5(payloadObject?.receiverAgentId) ?? sessionAgentId ?? null;
     const toAgentId = readString5(sender?.agentId);
     const accepted = await verifyInboundA2AGroupMessage({
-      payload: parsed.parsed ? parsed.payload : null,
+      payload: parseResult.ok ? parseResult.data : null,
       myXmtpAddress: deps.myXmtpAddress,
       senderAddress,
       senderInboxId: ctx.message.senderInboxId ?? "",
@@ -66858,7 +66905,7 @@ async function processFileMessage(ctx, deps, options = {}) {
       maybeNotifyInboundAgentMessage({
         deps,
         chatType,
-        payload: parsed.payload,
+        payload: parseResult.data,
         jobId: route.jobId,
         sessionKey,
         messageId: routedMessageId,
@@ -66867,7 +66914,7 @@ async function processFileMessage(ctx, deps, options = {}) {
     }
     void maybeAllowProviderGroup(deps, chatType, conversationId);
     logWithTimestamp(
-      `[okx-agent-task:${deps.myXmtpAddress}] session dispatch queued route=group session=${sessionKey} message=${shortenLogValue(routedMessageId)} ${summarizePayloadForLog(parsed.payload)}`
+      `[okx-agent-task:${deps.myXmtpAddress}] session dispatch queued route=group session=${sessionKey} message=${shortenLogValue(routedMessageId)} ${summarizePayloadForLog(parseResult.data)}`
     );
     return true;
   }
@@ -66884,12 +66931,12 @@ async function processFileMessage(ctx, deps, options = {}) {
     senderInboxId: ctx.message.senderInboxId ?? "",
     conversationId,
     rawText,
-    payload: parsed.parsed ? parsed.payload : null
+    payload: parseResult.ok ? parseResult.data : null
   };
   const storeAppendStartedAt = Date.now();
   await deps.store.append(route.jobId, stored, sessionAgentId);
   timing.mark("storeAppend", storeAppendStartedAt);
-  if ((route.route === "job" || parsed.parsed && !isA2AEnvelope(stored.payload)) && !options.skipNotify) {
+  if ((route.route === "job" || parseResult.ok && !isA2AEnvelope(stored.payload)) && !options.skipNotify) {
     const payloadObject = isPlainObject3(stored.payload) ? stored.payload : null;
     const sender = isPlainObject3(payloadObject?.sender) ? payloadObject.sender : null;
     const localAgent = XmtpService.getInstance().getAgentByAddress(deps.myXmtpAddress);
@@ -67079,6 +67126,7 @@ var init_message_handler = __esm({
     import_node_crypto14 = require("node:crypto");
     init_dist2();
     init_a2a();
+    init_envelope_shared();
     init_xmtp_sdk();
     init_onchainos();
     init_sentry_logger();
@@ -67532,12 +67580,12 @@ async function runListenerWithLock(options, paths) {
       });
     }
   });
-  service.setPluginVersion("0.2.6-beta-5b74111b38-260814141953");
+  service.setPluginVersion("0.2.6");
   await service.init();
   const pluginVersionStatus = service.pluginVersionStatus;
   if (pluginVersionStatus.unavailable) {
     throw new Error(
-      `@okxweb3/a2a-node v${"0.2.6-beta-5b74111b38-260814141953"} is below the required minimum v${pluginVersionStatus.minVersion}`
+      `@okxweb3/a2a-node v${"0.2.6"} is below the required minimum v${pluginVersionStatus.minVersion}`
     );
   }
   const systemConfig = service.getSystemConfig();
@@ -67555,7 +67603,7 @@ async function runListenerWithLock(options, paths) {
       onchainosAgentId: "*",
       reason: "system-config missing sentryDsn",
       pluginId: "@okxweb3/a2a-node",
-      pluginVersion: "0.2.6-beta-5b74111b38-260814141953"
+      pluginVersion: "0.2.6"
     });
   }
   logWithTimestamp(
@@ -115957,7 +116005,7 @@ async function getCurrentNodeCliVersion() {
   return await getGlobalNpmPackageVersion(UPDATE_PACKAGES.node) ?? getBundledNodeCliVersion();
 }
 function getBundledNodeCliVersion() {
-  return true ? "0.2.6-beta-5b74111b38-260814141953" : null;
+  return true ? "0.2.6" : null;
 }
 function readConfiguredAiProvider() {
   const explicit = process.env.OKX_A2A_AI_PROVIDER || process.env.OKX_AGENT_TASK_AI_CLI;
@@ -116167,7 +116215,7 @@ async function updateHermes(release, options) {
   }
 }
 async function installGatewayPluginForDoctor(target) {
-  const release = isPrereleaseVersion("0.2.6-beta-5b74111b38-260814141953") ? "beta" : "latest";
+  const release = isPrereleaseVersion("0.2.6") ? "beta" : "latest";
   const insideTargetGateway = detectGatewayInvocation() === target;
   const options = {
     restart: !insideTargetGateway,
@@ -117182,7 +117230,10 @@ function resolveDoctorTarget(env = process.env) {
 function skipped(id, title, severity, reason) {
   return { id, title, status: "skipped", severity, detail: reason };
 }
-function resolveProviderCliTarget(env, store) {
+function resolveProviderCliTarget(env, target, store) {
+  if (target === "hermes") {
+    return "hermes";
+  }
   const runtime = detectRuntime(env);
   if (runtime === "codex" || runtime === "claude") {
     return runtime;
@@ -117193,10 +117244,10 @@ function resolveProviderCliTarget(env, store) {
   const storedDefault = store.getDefaultAiProvider();
   return storedDefault === "codex" || storedDefault === "claude" ? storedDefault : null;
 }
-function readProviderCliTarget(env) {
+function readProviderCliTarget(env, target) {
   const store = new SessionStore();
   try {
-    const provider = resolveProviderCliTarget(env, store);
+    const provider = resolveProviderCliTarget(env, target, store);
     return {
       provider,
       storedCommand: provider ? store.getAiProviderCommand(provider) : null
@@ -117210,7 +117261,7 @@ async function runDoctor(options = {}) {
     platform: options.platform ?? process.platform,
     env: options.env ?? process.env,
     target: options.target ?? resolveDoctorTarget(options.env ?? process.env),
-    cliVersion: options.cliVersion ?? (true ? "0.2.6-beta-5b74111b38-260814141953" : "0.0.0"),
+    cliVersion: options.cliVersion ?? (true ? "0.2.6" : "0.0.0"),
     fixMode: options.fix === true,
     nonInteractive: options.nonInteractive === true,
     packageChanged: false,
@@ -117675,12 +117726,26 @@ var init_doctor_cli = __esm({
       id: "provider_cli",
       title: "AI provider CLI",
       run: async (ctx) => {
-        const { provider, storedCommand } = readProviderCliTarget(ctx.env);
+        const { provider, storedCommand } = readProviderCliTarget(ctx.env, ctx.target);
         if (!provider) {
           return null;
         }
         const resolved = provider === "codex" ? resolveCodexCommandPath(ctx.env, storedCommand, ctx.platform) : resolveCommandPath(resolveAiProviderCommand(provider, ctx.env, storedCommand, ctx.platform), ctx.env, ctx.platform);
         if (!resolved) {
+          if (provider === "hermes") {
+            return {
+              id: "provider_cli",
+              title: "AI provider CLI",
+              status: "fail",
+              severity: "required",
+              detail: "hermes CLI is not installed or not usable on this machine",
+              fix: {
+                kind: "manual",
+                description: "Install or repair the Hermes CLI, ensure the `hermes` executable is on PATH, then re-run okx-a2a doctor."
+              },
+              data: { provider }
+            };
+          }
           const spec = provider === "codex" ? CODEX_INSTALL_SPEC : CLAUDE_INSTALL_SPEC;
           return {
             id: "provider_cli",
@@ -117696,6 +117761,16 @@ var init_doctor_cli = __esm({
             data: { provider }
           };
         }
+        if (provider === "hermes") {
+          return {
+            id: "provider_cli",
+            title: "AI provider CLI",
+            status: "pass",
+            severity: "required",
+            detail: "hermes CLI is installed and usable",
+            data: { provider, command: resolved }
+          };
+        }
         const auth = provider === "codex" ? await checkCodexCliAuthStatus(resolved) : await checkClaudeCliAuthStatus(resolved);
         if (auth.ok) {
           if (provider === "codex" && ctx.env.OKX_A2A_AI_CODEX_COMMAND && storedCommand !== resolved) {
@@ -117749,8 +117824,8 @@ var init_doctor_cli = __esm({
         };
       },
       applyFix: async (ctx) => {
-        const { provider, storedCommand } = readProviderCliTarget(ctx.env);
-        if (!provider) {
+        const { provider, storedCommand } = readProviderCliTarget(ctx.env, ctx.target);
+        if (!provider || provider === "hermes") {
           throw new Error("no codex/claude runtime detected and no codex/claude provider bound");
         }
         const resolveCli = () => provider === "codex" ? resolveCodexCommandPath(ctx.env, storedCommand, ctx.platform) : resolveCommandPath(resolveAiProviderCommand(provider, ctx.env, storedCommand, ctx.platform), ctx.env, ctx.platform);
@@ -118208,7 +118283,7 @@ init_sentry_logger();
 init_sentry_config();
 var CURRENT_GATEWAY_SESSION_KEYS_ENV4 = "OKX_A2A_CURRENT_GATEWAY_SESSION_KEYS";
 function printUsage3() {
-  console.log(`okx-a2a ${"0.2.6-beta-5b74111b38-260814141953"}
+  console.log(`okx-a2a ${"0.2.6"}
 
 Usage:
   okx-a2a <command> [options]
@@ -118248,7 +118323,7 @@ Run \`okx-a2a <command> -h\` for command-specific help.
 `);
 }
 function printVersion() {
-  console.log("0.2.6-beta-5b74111b38-260814141953");
+  console.log("0.2.6");
 }
 function printDaemonUsage() {
   console.log(`Usage: okx-a2a daemon <start|restart|stop|status|autostart> [options]
@@ -119687,7 +119762,7 @@ async function main() {
   if (command === "xmtp-test") {
     const { handleXmtpTestCommand: handleXmtpTestCommand2 } = await Promise.resolve().then(() => (init_xmtp_test_cli(), xmtp_test_cli_exports));
     await handleXmtpTestCommand2(process.argv.slice(3), {
-      packageVersion: "0.2.6-beta-5b74111b38-260814141953",
+      packageVersion: "0.2.6",
       agentSdkVersion: "2.3.0",
       nodeSdkVersion: "6.1.0",
       nodeBindingsVersion: "1.11.0"

package/dist/index.js

@@ -2993,6 +2993,18 @@ function systemdUnitHasCurrentRestartPolicy(content) {
 function launchdPlistHasCurrentRestartPolicy(content) {
   return content.includes("<key>SuccessfulExit</key>");
 }
+function decodeXmlText(value) {
+  return value.replace(/&apos;/g, "'").replace(/&quot;/g, '"').replace(/&gt;/g, ">").replace(/&lt;/g, "<").replace(/&amp;/g, "&");
+}
+function servicePathHasRequiredEntries(content, platform, requiredEntries) {
+  const pathValue = platform === "linux" ? content.match(/^Environment="PATH=(.*)"$/m)?.[1] : content.match(/<key>PATH<\/key>\s*<string>([^<]*)<\/string>/)?.[1];
+  if (pathValue === void 0) {
+    return false;
+  }
+  const decodedPath = platform === "darwin" ? decodeXmlText(pathValue) : pathValue;
+  const entries = new Set(decodedPath.split(import_node_path9.delimiter).filter(Boolean));
+  return requiredEntries.every((entry) => entries.has(entry));
+}
 async function installedAutostartHasCurrentRestartPolicy() {
   try {
     if (process.platform === "linux") {
@@ -3013,11 +3025,11 @@ async function installedAutostartHasCurrentConfiguration() {
     const requiredPathEntries = requiredServicePathEntries();
     if (process.platform === "linux") {
       const content = await (0, import_promises3.readFile)(resolveSystemdAutostartPaths().servicePath, "utf8");
-      return systemdUnitHasCurrentRestartPolicy(content) && requiredPathEntries.every((entry) => content.includes(entry));
+      return systemdUnitHasCurrentRestartPolicy(content) && servicePathHasRequiredEntries(content, process.platform, requiredPathEntries);
     }
     if (process.platform === "darwin") {
       const content = await (0, import_promises3.readFile)(resolveLaunchdAutostartPaths().plistPath, "utf8");
-      return launchdPlistHasCurrentRestartPolicy(content) && requiredPathEntries.every((entry) => content.includes(entry));
+      return launchdPlistHasCurrentRestartPolicy(content) && servicePathHasRequiredEntries(content, process.platform, requiredPathEntries);
     }
   } catch {
     return true;
@@ -32136,7 +32148,7 @@ var init_sentry_config = __esm({
     environment = process.env.SENTRY_ENV === "dev" ? "dev" : "prod";
     SENTRY_CONFIG = {
       projectName: "okx/openclaw-okx-a2a-extension",
-      release: "0.2.6-beta-5b74111b38-260814141953",
+      release: "0.2.6",
       environment,
       runtimeContainer: normalizeRuntimeContainer(process.env.OKX_A2A_RUNTIME_CONTAINER)
     };
@@ -33077,7 +33089,7 @@ async function getCurrentNodeCliVersion() {
   return await getGlobalNpmPackageVersion(UPDATE_PACKAGES.node) ?? getBundledNodeCliVersion();
 }
 function getBundledNodeCliVersion() {
-  return true ? "0.2.6-beta-5b74111b38-260814141953" : null;
+  return true ? "0.2.6" : null;
 }
 function readConfiguredAiProvider() {
   const explicit = process.env.OKX_A2A_AI_PROVIDER || process.env.OKX_AGENT_TASK_AI_CLI;
@@ -33287,7 +33299,7 @@ async function updateHermes(release, options) {
   }
 }
 async function installGatewayPluginForDoctor(target) {
-  const release = isPrereleaseVersion("0.2.6-beta-5b74111b38-260814141953") ? "beta" : "latest";
+  const release = isPrereleaseVersion("0.2.6") ? "beta" : "latest";
   const insideTargetGateway = detectGatewayInvocation() === target;
   const options = {
     restart: !insideTargetGateway,
@@ -44140,6 +44152,7 @@ __export(index_exports, {
   logWinCompat: () => logWinCompat,
   logXmtpMessageSent: () => logXmtpMessageSent,
   maybeRecommendOnchainosUpgrade: () => maybeRecommendOnchainosUpgrade,
+  mergeA2AEnvelopeTips: () => mergeA2AEnvelopeTips,
   messageEligibleHelpAdvertisesOfflineReplay: () => messageEligibleHelpAdvertisesOfflineReplay,
   nodeVersionSatisfies: () => nodeVersionSatisfies,
   normalizeAiProvider: () => normalizeAiProvider,
@@ -58583,6 +58596,30 @@ var DEFAULT_A2A_TIPS = {
 function isNonEmptyPlainObject(v) {
   return !!v && typeof v === "object" && !Array.isArray(v) && Object.keys(v).length > 0;
 }
+function readStringRecord(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return {};
+  }
+  return Object.fromEntries(
+    Object.entries(value).filter((entry) => typeof entry[1] === "string")
+  );
+}
+function mergeA2AEnvelopeTips(payload, receiverTips) {
+  if (!payload || typeof payload !== "object" || Array.isArray(payload)) {
+    return payload;
+  }
+  const envelope = payload;
+  if (envelope.msgType !== A2A_MESSAGE_TYPE) {
+    return payload;
+  }
+  return {
+    ...envelope,
+    tips: {
+      ...readStringRecord(envelope.tips),
+      ...readStringRecord(receiverTips)
+    }
+  };
+}
 function buildA2AEnvelope(params) {
   const envelope = {
     msgType: A2A_MESSAGE_TYPE,
@@ -60429,7 +60466,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     client: {
       id: "gateway-client",
       displayName: "okx-a2a-node",
-      version: "0.2.6-beta-5b74111b38-260814141953",
+      version: "0.2.6",
       platform: "node",
       mode: "backend",
       instanceId
@@ -60440,7 +60477,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     commands: [],
     permissions: {},
     locale: Intl.DateTimeFormat().resolvedOptions().locale || "en-US",
-    userAgent: `okx-a2a-node/${"0.2.6-beta-5b74111b38-260814141953"}`,
+    userAgent: `okx-a2a-node/${"0.2.6"}`,
     auth: {
       ...config.token ? { token: config.token } : {},
       ...config.password ? { password: config.password } : {}
@@ -64438,11 +64475,11 @@ function extractXmtpSentAtMs2(msg) {
   }
   return Date.now();
 }
-function parsePayload(rawText) {
+function parseJson2(rawText) {
   try {
-    return { parsed: true, payload: JSON.parse(rawText) };
+    return { ok: true, data: JSON.parse(rawText) };
   } catch {
-    return { parsed: false, payload: null };
+    return { ok: false, data: null };
   }
 }
 function readString3(value) {
@@ -65360,10 +65397,21 @@ async function processFileMessage(ctx, deps, options = {}) {
     }
   }
   const parseStartedAt = Date.now();
-  const rawText = extractRawText(ctx.message.content);
-  const parsed = parsePayload(rawText);
+  const receivedRawText = extractRawText(ctx.message.content);
+  const parseResult = parseJson2(receivedRawText);
+  let rawText = receivedRawText;
+  if (parseResult.ok) {
+    const mergedPayload = mergeA2AEnvelopeTips(
+      parseResult.data,
+      XmtpService.getInstance().getSystemConfig().extConfig.tips
+    );
+    if (mergedPayload !== parseResult.data) {
+      parseResult.data = mergedPayload;
+      rawText = stringifySystemPayload(mergedPayload);
+    }
+  }
   timing.mark("payloadParse", parseStartedAt);
-  const directToUser = chatType === "dm" && parsed.parsed ? extractDirectToUserNotification(parsed.payload) : { kind: "none" };
+  const directToUser = chatType === "dm" && parseResult.ok ? extractDirectToUserNotification(parseResult.data) : { kind: "none" };
   if (directToUser.kind === "invalid") {
     const droppedMessageId = messageId || `direct-to-user-${(0, import_node_crypto12.randomUUID)()}`;
     logger.error(
@@ -65395,7 +65443,7 @@ async function processFileMessage(ctx, deps, options = {}) {
     });
     return true;
   }
-  const systemNotification = chatType === "dm" && parsed.parsed ? extractSystemNotification(parsed.payload) : null;
+  const systemNotification = chatType === "dm" && parseResult.ok ? extractSystemNotification(parseResult.data) : null;
   if (systemNotification) {
     const systemMessageId = messageId || `system-${(0, import_node_crypto12.randomUUID)()}`;
     logWithTimestamp(
@@ -65503,7 +65551,7 @@ async function processFileMessage(ctx, deps, options = {}) {
       maybeNotifyInboundAgentMessage({
         deps,
         chatType,
-        payload: parsed.payload,
+        payload: parseResult.data,
         jobId: systemNotification.jobId ?? BACKUP_JOB_ID,
         sessionKey: primaryTarget?.sessionKey ?? SYSTEM_NOTIFICATION_SESSION_KEY,
         messageId: systemMessageId
@@ -65548,13 +65596,13 @@ async function processFileMessage(ctx, deps, options = {}) {
         }));
       });
       logWithTimestamp(
-        `[okx-agent-task:${deps.myXmtpAddress}] session dispatch queued route=system/${target.route} session=${target.sessionKey} message=${shortenLogValue(systemMessageId)} ${summarizePayloadForLog(parsed.payload)}`
+        `[okx-agent-task:${deps.myXmtpAddress}] session dispatch queued route=system/${target.route} session=${target.sessionKey} message=${shortenLogValue(systemMessageId)} ${summarizePayloadForLog(parseResult.data)}`
       );
     }
     return true;
   }
   const routeStartedAt = Date.now();
-  const route = routeMessage(chatType, parsed.parsed, parsed.payload);
+  const route = routeMessage(chatType, parseResult.ok, parseResult.data);
   timing.mark("routeResolve", routeStartedAt);
   if (route.route === "job") {
     const providerBindStartedAt = Date.now();
@@ -65580,7 +65628,7 @@ async function processFileMessage(ctx, deps, options = {}) {
   }
   const sessionAgentId = route.route === "job" ? resolveSessionAgentId({
     chatType,
-    payload: parsed.parsed ? parsed.payload : null,
+    payload: parseResult.ok ? parseResult.data : null,
     myXmtpAddress: deps.myXmtpAddress
   }) : null;
   const xmtpSentAtMs = extractXmtpSentAtMs2(ctx.message);
@@ -65596,7 +65644,7 @@ async function processFileMessage(ctx, deps, options = {}) {
     );
   }
   if (route.route === "job" && chatType === "group") {
-    const payloadObject = isPlainObject3(parsed.parsed ? parsed.payload : null) ? parsed.payload : null;
+    const payloadObject = isPlainObject3(parseResult.ok ? parseResult.data : null) ? parseResult.data : null;
     const service = XmtpService.getInstance();
     const trustedSystemSender = service.isTrustedSystemAccountSender({
       senderAddress,
@@ -65627,7 +65675,7 @@ async function processFileMessage(ctx, deps, options = {}) {
     const myAgentId = localAgent?.agentId ?? readString3(payloadObject?.receiverAgentId) ?? sessionAgentId ?? null;
     const toAgentId = readString3(sender?.agentId);
     const accepted = await verifyInboundA2AGroupMessage({
-      payload: parsed.parsed ? parsed.payload : null,
+      payload: parseResult.ok ? parseResult.data : null,
       myXmtpAddress: deps.myXmtpAddress,
       senderAddress,
       senderInboxId: ctx.message.senderInboxId ?? "",
@@ -65694,7 +65742,7 @@ async function processFileMessage(ctx, deps, options = {}) {
       maybeNotifyInboundAgentMessage({
         deps,
         chatType,
-        payload: parsed.payload,
+        payload: parseResult.data,
         jobId: route.jobId,
         sessionKey,
         messageId: routedMessageId,
@@ -65703,7 +65751,7 @@ async function processFileMessage(ctx, deps, options = {}) {
     }
     void maybeAllowProviderGroup(deps, chatType, conversationId);
     logWithTimestamp(
-      `[okx-agent-task:${deps.myXmtpAddress}] session dispatch queued route=group session=${sessionKey} message=${shortenLogValue(routedMessageId)} ${summarizePayloadForLog(parsed.payload)}`
+      `[okx-agent-task:${deps.myXmtpAddress}] session dispatch queued route=group session=${sessionKey} message=${shortenLogValue(routedMessageId)} ${summarizePayloadForLog(parseResult.data)}`
     );
     return true;
   }
@@ -65720,12 +65768,12 @@ async function processFileMessage(ctx, deps, options = {}) {
     senderInboxId: ctx.message.senderInboxId ?? "",
     conversationId,
     rawText,
-    payload: parsed.parsed ? parsed.payload : null
+    payload: parseResult.ok ? parseResult.data : null
   };
   const storeAppendStartedAt = Date.now();
   await deps.store.append(route.jobId, stored, sessionAgentId);
   timing.mark("storeAppend", storeAppendStartedAt);
-  if ((route.route === "job" || parsed.parsed && !isA2AEnvelope(stored.payload)) && !options.skipNotify) {
+  if ((route.route === "job" || parseResult.ok && !isA2AEnvelope(stored.payload)) && !options.skipNotify) {
     const payloadObject = isPlainObject3(stored.payload) ? stored.payload : null;
     const sender = isPlainObject3(payloadObject?.sender) ? payloadObject.sender : null;
     const localAgent = XmtpService.getInstance().getAgentByAddress(deps.myXmtpAddress);
@@ -66616,12 +66664,12 @@ async function runListenerWithLock(options, paths) {
       });
     }
   });
-  service.setPluginVersion("0.2.6-beta-5b74111b38-260814141953");
+  service.setPluginVersion("0.2.6");
   await service.init();
   const pluginVersionStatus = service.pluginVersionStatus;
   if (pluginVersionStatus.unavailable) {
     throw new Error(
-      `@okxweb3/a2a-node v${"0.2.6-beta-5b74111b38-260814141953"} is below the required minimum v${pluginVersionStatus.minVersion}`
+      `@okxweb3/a2a-node v${"0.2.6"} is below the required minimum v${pluginVersionStatus.minVersion}`
     );
   }
   const systemConfig = service.getSystemConfig();
@@ -66639,7 +66687,7 @@ async function runListenerWithLock(options, paths) {
       onchainosAgentId: "*",
       reason: "system-config missing sentryDsn",
       pluginId: "@okxweb3/a2a-node",
-      pluginVersion: "0.2.6-beta-5b74111b38-260814141953"
+      pluginVersion: "0.2.6"
     });
   }
   logWithTimestamp(
@@ -69337,7 +69385,7 @@ async function exportDiagnosticLogs(options) {
     node: process.version,
     platform: process.platform,
     arch: process.arch,
-    packageVersion: true ? "0.2.6-beta-5b74111b38-260814141953" : "unknown",
+    packageVersion: true ? "0.2.6" : "unknown",
     sensitiveContentIncluded: options.includeSensitiveContent,
     listenerAndLlmContentIncluded: true,
     credentialsAlwaysRedacted: true,
@@ -70637,7 +70685,10 @@ var providerBindingChecker = {
     }
   }
 };
-function resolveProviderCliTarget(env, store) {
+function resolveProviderCliTarget(env, target, store) {
+  if (target === "hermes") {
+    return "hermes";
+  }
   const runtime = detectRuntime(env);
   if (runtime === "codex" || runtime === "claude") {
     return runtime;
@@ -70648,10 +70699,10 @@ function resolveProviderCliTarget(env, store) {
   const storedDefault = store.getDefaultAiProvider();
   return storedDefault === "codex" || storedDefault === "claude" ? storedDefault : null;
 }
-function readProviderCliTarget(env) {
+function readProviderCliTarget(env, target) {
   const store = new SessionStore();
   try {
-    const provider = resolveProviderCliTarget(env, store);
+    const provider = resolveProviderCliTarget(env, target, store);
     return {
       provider,
       storedCommand: provider ? store.getAiProviderCommand(provider) : null
@@ -70664,12 +70715,26 @@ var providerCliChecker = {
   id: "provider_cli",
   title: "AI provider CLI",
   run: async (ctx) => {
-    const { provider, storedCommand } = readProviderCliTarget(ctx.env);
+    const { provider, storedCommand } = readProviderCliTarget(ctx.env, ctx.target);
     if (!provider) {
       return null;
     }
     const resolved = provider === "codex" ? resolveCodexCommandPath(ctx.env, storedCommand, ctx.platform) : resolveCommandPath(resolveAiProviderCommand(provider, ctx.env, storedCommand, ctx.platform), ctx.env, ctx.platform);
     if (!resolved) {
+      if (provider === "hermes") {
+        return {
+          id: "provider_cli",
+          title: "AI provider CLI",
+          status: "fail",
+          severity: "required",
+          detail: "hermes CLI is not installed or not usable on this machine",
+          fix: {
+            kind: "manual",
+            description: "Install or repair the Hermes CLI, ensure the `hermes` executable is on PATH, then re-run okx-a2a doctor."
+          },
+          data: { provider }
+        };
+      }
       const spec = provider === "codex" ? CODEX_INSTALL_SPEC : CLAUDE_INSTALL_SPEC;
       return {
         id: "provider_cli",
@@ -70685,6 +70750,16 @@ var providerCliChecker = {
         data: { provider }
       };
     }
+    if (provider === "hermes") {
+      return {
+        id: "provider_cli",
+        title: "AI provider CLI",
+        status: "pass",
+        severity: "required",
+        detail: "hermes CLI is installed and usable",
+        data: { provider, command: resolved }
+      };
+    }
     const auth = provider === "codex" ? await checkCodexCliAuthStatus(resolved) : await checkClaudeCliAuthStatus(resolved);
     if (auth.ok) {
       if (provider === "codex" && ctx.env.OKX_A2A_AI_CODEX_COMMAND && storedCommand !== resolved) {
@@ -70738,8 +70813,8 @@ var providerCliChecker = {
     };
   },
   applyFix: async (ctx) => {
-    const { provider, storedCommand } = readProviderCliTarget(ctx.env);
-    if (!provider) {
+    const { provider, storedCommand } = readProviderCliTarget(ctx.env, ctx.target);
+    if (!provider || provider === "hermes") {
       throw new Error("no codex/claude runtime detected and no codex/claude provider bound");
     }
     const resolveCli = () => provider === "codex" ? resolveCodexCommandPath(ctx.env, storedCommand, ctx.platform) : resolveCommandPath(resolveAiProviderCommand(provider, ctx.env, storedCommand, ctx.platform), ctx.env, ctx.platform);
@@ -71173,7 +71248,7 @@ async function runDoctor(options = {}) {
     platform: options.platform ?? process.platform,
     env: options.env ?? process.env,
     target: options.target ?? resolveDoctorTarget(options.env ?? process.env),
-    cliVersion: options.cliVersion ?? (true ? "0.2.6-beta-5b74111b38-260814141953" : "0.0.0"),
+    cliVersion: options.cliVersion ?? (true ? "0.2.6" : "0.0.0"),
     fixMode: options.fix === true,
     nonInteractive: options.nonInteractive === true,
     packageChanged: false,
@@ -71558,6 +71633,7 @@ init_autostart_windows();
   logWinCompat,
   logXmtpMessageSent,
   maybeRecommendOnchainosUpgrade,
+  mergeA2AEnvelopeTips,
   messageEligibleHelpAdvertisesOfflineReplay,
   nodeVersionSatisfies,
   normalizeAiProvider,

package/package.json

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