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

package/dist/cli.js

@@ -26648,7 +26648,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     client: {
       id: "gateway-client",
       displayName: "okx-a2a-node",
-      version: "0.2.6-beta-5b74111b38-260814145826",
+      version: "0.2.6",
       platform: "node",
       mode: "backend",
       instanceId
@@ -26659,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-260814145826"}`,
+    userAgent: `okx-a2a-node/${"0.2.6"}`,
     auth: {
       ...config.token ? { token: config.token } : {},
       ...config.password ? { password: config.password } : {}
@@ -28568,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-260814145826",
+      release: "0.2.6",
       environment,
       runtimeContainer: normalizeRuntimeContainer(process.env.OKX_A2A_RUNTIME_CONTAINER)
     };
@@ -39738,7 +39738,7 @@ async function exportDiagnosticLogs(options) {
     node: process.version,
     platform: process.platform,
     arch: process.arch,
-    packageVersion: true ? "0.2.6-beta-5b74111b38-260814145826" : "unknown",
+    packageVersion: true ? "0.2.6" : "unknown",
     sensitiveContentIncluded: options.includeSensitiveContent,
     listenerAndLlmContentIncluded: true,
     credentialsAlwaysRedacted: true,
@@ -59820,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,
@@ -65623,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) {
@@ -66536,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(
@@ -66571,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(
@@ -66679,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
@@ -66724,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();
@@ -66756,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);
@@ -66772,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,
@@ -66803,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 ?? "",
@@ -66870,7 +66905,7 @@ async function processFileMessage(ctx, deps, options = {}) {
       maybeNotifyInboundAgentMessage({
         deps,
         chatType,
-        payload: parsed.payload,
+        payload: parseResult.data,
         jobId: route.jobId,
         sessionKey,
         messageId: routedMessageId,
@@ -66879,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;
   }
@@ -66896,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);
@@ -67091,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();
@@ -67544,12 +67580,12 @@ async function runListenerWithLock(options, paths) {
       });
     }
   });
-  service.setPluginVersion("0.2.6-beta-5b74111b38-260814145826");
+  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-260814145826"} 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();
@@ -67567,7 +67603,7 @@ async function runListenerWithLock(options, paths) {
       onchainosAgentId: "*",
       reason: "system-config missing sentryDsn",
       pluginId: "@okxweb3/a2a-node",
-      pluginVersion: "0.2.6-beta-5b74111b38-260814145826"
+      pluginVersion: "0.2.6"
     });
   }
   logWithTimestamp(
@@ -115969,7 +116005,7 @@ async function getCurrentNodeCliVersion() {
   return await getGlobalNpmPackageVersion(UPDATE_PACKAGES.node) ?? getBundledNodeCliVersion();
 }
 function getBundledNodeCliVersion() {
-  return true ? "0.2.6-beta-5b74111b38-260814145826" : null;
+  return true ? "0.2.6" : null;
 }
 function readConfiguredAiProvider() {
   const explicit = process.env.OKX_A2A_AI_PROVIDER || process.env.OKX_AGENT_TASK_AI_CLI;
@@ -116179,7 +116215,7 @@ async function updateHermes(release, options) {
   }
 }
 async function installGatewayPluginForDoctor(target) {
-  const release = isPrereleaseVersion("0.2.6-beta-5b74111b38-260814145826") ? "beta" : "latest";
+  const release = isPrereleaseVersion("0.2.6") ? "beta" : "latest";
   const insideTargetGateway = detectGatewayInvocation() === target;
   const options = {
     restart: !insideTargetGateway,
@@ -117194,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;
@@ -117205,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
@@ -117222,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-260814145826" : "0.0.0"),
+    cliVersion: options.cliVersion ?? (true ? "0.2.6" : "0.0.0"),
     fixMode: options.fix === true,
     nonInteractive: options.nonInteractive === true,
     packageChanged: false,
@@ -117687,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",
@@ -117708,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) {
@@ -117761,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);
@@ -118220,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-260814145826"}
+  console.log(`okx-a2a ${"0.2.6"}
 
 Usage:
   okx-a2a <command> [options]
@@ -118260,7 +118323,7 @@ Run \`okx-a2a <command> -h\` for command-specific help.
 `);
 }
 function printVersion() {
-  console.log("0.2.6-beta-5b74111b38-260814145826");
+  console.log("0.2.6");
 }
 function printDaemonUsage() {
   console.log(`Usage: okx-a2a daemon <start|restart|stop|status|autostart> [options]
@@ -119699,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-260814145826",
+      packageVersion: "0.2.6",
       agentSdkVersion: "2.3.0",
       nodeSdkVersion: "6.1.0",
       nodeBindingsVersion: "1.11.0"

package/dist/index.js

@@ -32148,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-260814145826",
+      release: "0.2.6",
       environment,
       runtimeContainer: normalizeRuntimeContainer(process.env.OKX_A2A_RUNTIME_CONTAINER)
     };
@@ -33089,7 +33089,7 @@ async function getCurrentNodeCliVersion() {
   return await getGlobalNpmPackageVersion(UPDATE_PACKAGES.node) ?? getBundledNodeCliVersion();
 }
 function getBundledNodeCliVersion() {
-  return true ? "0.2.6-beta-5b74111b38-260814145826" : null;
+  return true ? "0.2.6" : null;
 }
 function readConfiguredAiProvider() {
   const explicit = process.env.OKX_A2A_AI_PROVIDER || process.env.OKX_AGENT_TASK_AI_CLI;
@@ -33299,7 +33299,7 @@ async function updateHermes(release, options) {
   }
 }
 async function installGatewayPluginForDoctor(target) {
-  const release = isPrereleaseVersion("0.2.6-beta-5b74111b38-260814145826") ? "beta" : "latest";
+  const release = isPrereleaseVersion("0.2.6") ? "beta" : "latest";
   const insideTargetGateway = detectGatewayInvocation() === target;
   const options = {
     restart: !insideTargetGateway,
@@ -44152,6 +44152,7 @@ __export(index_exports, {
   logWinCompat: () => logWinCompat,
   logXmtpMessageSent: () => logXmtpMessageSent,
   maybeRecommendOnchainosUpgrade: () => maybeRecommendOnchainosUpgrade,
+  mergeA2AEnvelopeTips: () => mergeA2AEnvelopeTips,
   messageEligibleHelpAdvertisesOfflineReplay: () => messageEligibleHelpAdvertisesOfflineReplay,
   nodeVersionSatisfies: () => nodeVersionSatisfies,
   normalizeAiProvider: () => normalizeAiProvider,
@@ -58595,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,
@@ -60441,7 +60466,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     client: {
       id: "gateway-client",
       displayName: "okx-a2a-node",
-      version: "0.2.6-beta-5b74111b38-260814145826",
+      version: "0.2.6",
       platform: "node",
       mode: "backend",
       instanceId
@@ -60452,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-260814145826"}`,
+    userAgent: `okx-a2a-node/${"0.2.6"}`,
     auth: {
       ...config.token ? { token: config.token } : {},
       ...config.password ? { password: config.password } : {}
@@ -64450,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) {
@@ -65372,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(
@@ -65407,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(
@@ -65515,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
@@ -65560,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();
@@ -65592,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);
@@ -65608,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,
@@ -65639,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 ?? "",
@@ -65706,7 +65742,7 @@ async function processFileMessage(ctx, deps, options = {}) {
       maybeNotifyInboundAgentMessage({
         deps,
         chatType,
-        payload: parsed.payload,
+        payload: parseResult.data,
         jobId: route.jobId,
         sessionKey,
         messageId: routedMessageId,
@@ -65715,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;
   }
@@ -65732,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);
@@ -66628,12 +66664,12 @@ async function runListenerWithLock(options, paths) {
       });
     }
   });
-  service.setPluginVersion("0.2.6-beta-5b74111b38-260814145826");
+  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-260814145826"} 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();
@@ -66651,7 +66687,7 @@ async function runListenerWithLock(options, paths) {
       onchainosAgentId: "*",
       reason: "system-config missing sentryDsn",
       pluginId: "@okxweb3/a2a-node",
-      pluginVersion: "0.2.6-beta-5b74111b38-260814145826"
+      pluginVersion: "0.2.6"
     });
   }
   logWithTimestamp(
@@ -69349,7 +69385,7 @@ async function exportDiagnosticLogs(options) {
     node: process.version,
     platform: process.platform,
     arch: process.arch,
-    packageVersion: true ? "0.2.6-beta-5b74111b38-260814145826" : "unknown",
+    packageVersion: true ? "0.2.6" : "unknown",
     sensitiveContentIncluded: options.includeSensitiveContent,
     listenerAndLlmContentIncluded: true,
     credentialsAlwaysRedacted: true,
@@ -70649,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;
@@ -70660,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
@@ -70676,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",
@@ -70697,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) {
@@ -70750,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);
@@ -71185,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-260814145826" : "0.0.0"),
+    cliVersion: options.cliVersion ?? (true ? "0.2.6" : "0.0.0"),
     fixMode: options.fix === true,
     nonInteractive: options.nonInteractive === true,
     packageChanged: false,
@@ -71570,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-260814145826",
+  "version": "0.2.6",
   "description": "Host-agnostic Node CLI for E2E encrypted agent-to-agent communication via XMTP",
   "main": "dist/index.js",
   "bin": {