@okxweb3/a2a-node 0.1.2 → 0.1.3-beta-5afe085f69-260701174158

package/dist/cli.js

@@ -2285,6 +2285,7 @@ var init_command_store = __esm({
           toAgentId: params.toAgentId,
           toXmtpAddress: params.toXmtpAddress,
           gatewaySessionKeys: params.gatewaySessionKeys,
+          payload: params.payload,
           createdAt: Date.now()
         };
       }
@@ -7893,7 +7894,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     client: {
       id: "gateway-client",
       displayName: "okx-a2a-node",
-      version: "0.1.2",
+      version: "0.1.3-beta-5afe085f69-260701174158",
       platform: "node",
       mode: "backend",
       instanceId
@@ -7904,7 +7905,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     commands: [],
     permissions: {},
     locale: Intl.DateTimeFormat().resolvedOptions().locale || "en-US",
-    userAgent: `okx-a2a-node/${"0.1.2"}`,
+    userAgent: `okx-a2a-node/${"0.1.3-beta-5afe085f69-260701174158"}`,
     auth: {
       ...config.token ? { token: config.token } : {},
       ...config.password ? { password: config.password } : {}
@@ -23945,6 +23946,7 @@ var init_events = __esm({
       ONCHAINOS_SESSION_EXPIRED: "Onchainos session expired",
       ONCHAINOS_CLI_ERROR: "Onchainos CLI error",
       HEARTBEAT_FAILED: "Heartbeat failed",
+      HEARTBEAT_SKIPPED: "Heartbeat skipped",
       MESSAGE_PARSE_FAILED: "Message parse failed",
       MESSAGE_HANDLER_ERROR: "Message handler error",
       OFFLINE_REPLAY_FAILED: "Offline replay failed",
@@ -25123,7 +25125,7 @@ var init_sentry_config = __esm({
     environment = process.env.SENTRY_ENV === "dev" ? "dev" : "prod";
     SENTRY_CONFIG = {
       projectName: "okx/openclaw-okx-a2a-extension",
-      release: "0.1.2",
+      release: "0.1.3-beta-5afe085f69-260701174158",
       environment
     };
   }
@@ -87267,6 +87269,12 @@ function buildTaskPayload(replyToMessageId) {
     replyToMessageId: replyToMessageId ?? null
   };
 }
+function resolveEnvelopePayload(command, replyToMessageId) {
+  if (command.payload !== void 0) {
+    return command.payload;
+  }
+  return buildTaskPayload(replyToMessageId);
+}
 function parseJson(raw) {
   try {
     return JSON.parse(raw);
@@ -87374,7 +87382,7 @@ function buildGroupReplyRaw(command, target, myXmtpAddress, localAgent) {
     jobId: command.jobId,
     senderAgent: localAgent,
     receiverAgentId: readString(sender?.agentId),
-    payload: buildTaskPayload(command.replyToMessageId ?? target.id)
+    payload: resolveEnvelopePayload(command, command.replyToMessageId ?? target.id)
   });
 }
 async function assertOutboundEligible(params) {
@@ -87706,7 +87714,7 @@ async function handleSqliteGroupSendCommand(params) {
     jobId: command.jobId,
     senderAgent,
     receiverAgentId: remote.remoteAgent?.agentId ?? remote.toAgentId ?? null,
-    payload: buildTaskPayload(command.replyToMessageId)
+    payload: resolveEnvelopePayload(command, command.replyToMessageId)
   });
   logWithTimestamp(`[okx-agent-task] xmtp envelope ${rawText}`);
   await conversation.send(rawText);
@@ -87843,7 +87851,7 @@ async function handleGroupSendCommand(params) {
     jobId: command.jobId,
     senderAgent,
     receiverAgentId: remoteAgent?.agentId ?? session.toAgentId ?? null,
-    payload: buildTaskPayload(command.replyToMessageId)
+    payload: resolveEnvelopePayload(command, command.replyToMessageId)
   });
   logWithTimestamp(`[okx-agent-task] xmtp envelope ${rawText}`);
   await conversation.send(rawText);
@@ -93116,12 +93124,12 @@ async function runListenerWithLock(options, paths) {
       }));
     }
   });
-  service.setPluginVersion("0.1.2");
+  service.setPluginVersion("0.1.3-beta-5afe085f69-260701174158");
   await service.init();
   const pluginVersionStatus = service.pluginVersionStatus;
   if (pluginVersionStatus.unavailable) {
     throw new Error(
-      `@okxweb3/a2a-node v${"0.1.2"} is below the required minimum v${pluginVersionStatus.minVersion}`
+      `@okxweb3/a2a-node v${"0.1.3-beta-5afe085f69-260701174158"} is below the required minimum v${pluginVersionStatus.minVersion}`
     );
   }
   const systemConfig = service.getSystemConfig();
@@ -93139,7 +93147,7 @@ async function runListenerWithLock(options, paths) {
       onchainosAgentId: "*",
       reason: "system-config missing sentryDsn",
       pluginId: "@okxweb3/a2a-node",
-      pluginVersion: "0.1.2"
+      pluginVersion: "0.1.3-beta-5afe085f69-260701174158"
     });
   }
   logWithTimestamp(
@@ -93188,10 +93196,33 @@ async function runListenerWithLock(options, paths) {
           logWithTimestamp(
             `[okx-agent-task] provider=${heartbeatProvider ?? "(not set)"} gateway unavailable, skipping heartbeat`
           );
+          logger.error(
+            LogEvent.HEARTBEAT_SKIPPED,
+            new Error(`heartbeat skipped: provider=${heartbeatProvider ?? "(not set)"} gateway unavailable`),
+            {
+              component: "node_listener",
+              stage: "sync_tick",
+              reason: "gateway_unavailable",
+              provider: heartbeatProvider ?? "(not set)",
+              chainIndex: ONCHAINOS_CHAIN_INDEX,
+              communicationClass: "gateway_or_plugin"
+            }
+          );
         }
       }
       if (!hasActiveAgents) {
         logWithTimestamp("[okx-agent-task] no active agents, skipping heartbeat");
+        logger.error(
+          LogEvent.HEARTBEAT_SKIPPED,
+          new Error("heartbeat skipped: no active agents"),
+          {
+            component: "node_listener",
+            stage: "sync_tick",
+            reason: "no_active_agents",
+            provider: heartbeatProvider ?? "(not set)",
+            chainIndex: ONCHAINOS_CHAIN_INDEX
+          }
+        );
       }
       const skippedTiming = { durationMs: 0 };
       const heartbeatResult = shouldHeartbeat ? await timeSettled(() => sendHeartbeat(ONCHAINOS_CHAIN_INDEX)) : skippedTiming;
@@ -96708,7 +96739,7 @@ async function getCurrentNodeCliVersion() {
   return await getGlobalNpmPackageVersion(UPDATE_PACKAGES.node) ?? getBundledNodeCliVersion();
 }
 function getBundledNodeCliVersion() {
-  return true ? "0.1.2" : null;
+  return true ? "0.1.3-beta-5afe085f69-260701174158" : null;
 }
 function readConfiguredAiProvider() {
   const explicit = process.env.OKX_A2A_AI_PROVIDER || process.env.OKX_AGENT_TASK_AI_CLI;
@@ -96793,13 +96824,15 @@ async function ensureOpenClawOkxA2aPluginConfig() {
     const conversationHookAccess = await getOpenClawConfigValue(
       OPENCLAW_OKX_A2A_CONVERSATION_HOOK_ACCESS_CONFIG_PATH
     );
-    const normalizedAllow = normalizeOpenClawPluginAllowValue(allow.found ? allow.value : void 0);
     const operations = [];
     if (dmScope.value !== OPENCLAW_SESSION_DM_SCOPE_CONFIG_VALUE) {
       operations.push({ path: OPENCLAW_SESSION_DM_SCOPE_CONFIG_PATH, value: OPENCLAW_SESSION_DM_SCOPE_CONFIG_VALUE });
     }
-    if (!allow.found || normalizedAllow.changed) {
-      operations.push({ path: OPENCLAW_PLUGIN_ALLOW_CONFIG_PATH, value: normalizedAllow.value });
+    if (allow.found) {
+      const normalizedAllow = normalizeOpenClawPluginAllowValue(allow.value);
+      if (normalizedAllow.changed) {
+        operations.push({ path: OPENCLAW_PLUGIN_ALLOW_CONFIG_PATH, value: normalizedAllow.value });
+      }
     }
     if (conversationHookAccess.value !== true) {
       operations.push({ path: OPENCLAW_OKX_A2A_CONVERSATION_HOOK_ACCESS_CONFIG_PATH, value: true });
@@ -96808,11 +96841,11 @@ async function ensureOpenClawOkxA2aPluginConfig() {
       return false;
     }
     await runCommand("openclaw", ["config", "set", "--batch-json", JSON.stringify(operations)]);
-    console.log("[update] normalized OpenClaw session.dmScope/plugins.allow/hooks okx-a2a config through openclaw config set");
+    console.log("[update] normalized OpenClaw okx-a2a gateway config through openclaw config set");
     return true;
   } catch (error) {
     const detail = error instanceof Error ? error.message : String(error);
-    console.warn(`[update] skipped OpenClaw session.dmScope/plugins.allow/hooks okx-a2a config normalization through openclaw CLI: ${detail}`);
+    console.warn(`[update] skipped OpenClaw okx-a2a gateway config normalization through openclaw CLI: ${detail}`);
     return false;
   }
 }
@@ -96830,7 +96863,7 @@ async function getOpenClawConfigValue(path) {
 }
 function normalizeOpenClawPluginAllowValue(allow) {
   if (!Array.isArray(allow)) {
-    return { value: [OKX_A2A_PLUGIN_ID], changed: true };
+    return { value: allow, changed: false };
   }
   const nextAllow = [];
   let allowChanged = false;
@@ -97614,7 +97647,7 @@ init_sentry_logger();
 init_sentry_config();
 var CURRENT_GATEWAY_SESSION_KEYS_ENV3 = "OKX_A2A_CURRENT_GATEWAY_SESSION_KEYS";
 function printUsage2() {
-  console.log(`okx-a2a ${"0.1.2"}
+  console.log(`okx-a2a ${"0.1.3-beta-5afe085f69-260701174158"}
 
 Usage:
   okx-a2a <command> [options]
@@ -97651,7 +97684,7 @@ Run \`okx-a2a <command> -h\` for command-specific help.
 `);
 }
 function printVersion() {
-  console.log("0.1.2");
+  console.log("0.1.3-beta-5afe085f69-260701174158");
 }
 function printDaemonUsage() {
   console.log(`Usage: okx-a2a daemon <start|restart|stop|status|autostart> [options]
@@ -97716,8 +97749,8 @@ function printAgentUsage() {
   console.log(`Usage: okx-a2a agent <refresh|bypass> [options]
 
 Commands:
-  refresh [--json]
-          Refresh the listener agent list.
+  refresh [--json] [--timeout-ms <ms>]
+          Refresh the listener agent list and wait for the daemon result.
   bypass <on|off> [--json]
           Configure AI subsession bypass permissions.
 `);
@@ -97730,6 +97763,7 @@ Options:
   --to-address <xmtpAddress>  Recipient XMTP address fallback
   --reply-to <messageId>      Reply-to message id
   --session-agent-id <id>     Session agent id for task file routing
+  --payload <json>            JSON string; when valid, fully replaces the envelope payload
   --json                      Print machine-readable output with ok boolean
 `);
 }
@@ -97980,7 +98014,8 @@ async function queueXmtpSend(args) {
       "--session-key",
       "--to-agent-id",
       "--to-address",
-      "--to-xmtp-address"
+      "--to-xmtp-address",
+      "--payload"
     ]),
     flags: /* @__PURE__ */ new Set(["--json"])
   });
@@ -97992,6 +98027,7 @@ async function queueXmtpSend(args) {
   const explicitToAgentId = readOption3(args, "--to-agent-id");
   const sessionKey = readOption3(args, "--session-key");
   const toXmtpAddress = readOption3(args, "--to-address") ?? readOption3(args, "--to-xmtp-address");
+  const payloadOverride = parseXmtpSendPayloadOption(readOption3(args, "--payload"));
   const target = resolveXmtpSendTarget({
     sessionKey,
     jobId: explicitJobId,
@@ -98013,7 +98049,8 @@ async function queueXmtpSend(args) {
       myAgentId: target.myAgentId,
       toAgentId: target.toAgentId,
       toXmtpAddress: toXmtpAddress ?? target.toXmtpAddress,
-      gatewaySessionKeys: readGatewaySessionKeysFromEnv2()
+      gatewaySessionKeys: readGatewaySessionKeysFromEnv2(),
+      payload: payloadOverride
     });
     await commands.submit(command);
     const result = await commands.waitForResult(command.id, Number.POSITIVE_INFINITY);
@@ -98037,6 +98074,17 @@ async function queueXmtpSend(args) {
     commands.close();
   }
 }
+function parseXmtpSendPayloadOption(raw) {
+  const trimmed = raw?.trim();
+  if (!trimmed) {
+    return void 0;
+  }
+  try {
+    return JSON.parse(trimmed);
+  } catch {
+    return void 0;
+  }
+}
 function readGatewaySessionKeysFromEnv2(env = process.env) {
   const keys = /* @__PURE__ */ new Set();
   const list = env[CURRENT_GATEWAY_SESSION_KEYS_ENV3]?.trim();
@@ -98161,7 +98209,7 @@ function assertOnlyKnownOptions(args, input) {
 async function queueXmtpDaemonCommand(args, type) {
   const json = hasFlag2(args, "--json");
   const timeoutMsRaw = readOption3(args, "--timeout-ms");
-  const wait3 = type === "xmtp-get-pending-list" || type === "xmtp-deny-pending-conversation";
+  const wait3 = type === "xmtp-get-pending-list" || type === "xmtp-deny-pending-conversation" || type === "xmtp-refresh-agents";
   await assertDaemonRunningForQueuedCommand2(type);
   const commands = new CommandStore();
   const command = type === "xmtp-get-pending-list" ? commands.createXmtpGetPendingListCommand() : type === "xmtp-deny-pending-conversation" ? commands.createXmtpDenyPendingConversationCommand(readDenyPendingConversationOptions(args)) : commands.createXmtpRefreshAgentsCommand();

package/dist/index.js

@@ -68009,6 +68009,7 @@ __export(index_exports, {
   resolveConfiguredAiProvider: () => resolveConfiguredAiProvider,
   resolveConfiguredAiProviderForJob: () => resolveConfiguredAiProviderForJob,
   resolveDirectCommunicationSessionTarget: () => resolveDirectCommunicationSessionTarget,
+  resolveEnvelopePayload: () => resolveEnvelopePayload,
   resolveOfflineReplayIntervalSec: () => resolveOfflineReplayIntervalSec,
   resolveOpenClawGatewayConfig: () => resolveOpenClawGatewayConfig,
   resolveOpenClawGatewayRoute: () => resolveOpenClawGatewayRoute,
@@ -71555,6 +71556,7 @@ var LogEvent = {
   ONCHAINOS_SESSION_EXPIRED: "Onchainos session expired",
   ONCHAINOS_CLI_ERROR: "Onchainos CLI error",
   HEARTBEAT_FAILED: "Heartbeat failed",
+  HEARTBEAT_SKIPPED: "Heartbeat skipped",
   MESSAGE_PARSE_FAILED: "Message parse failed",
   MESSAGE_HANDLER_ERROR: "Message handler error",
   OFFLINE_REPLAY_FAILED: "Offline replay failed",
@@ -74744,6 +74746,7 @@ var CommandStore = class {
       toAgentId: params.toAgentId,
       toXmtpAddress: params.toXmtpAddress,
       gatewaySessionKeys: params.gatewaySessionKeys,
+      payload: params.payload,
       createdAt: Date.now()
     };
   }
@@ -86775,7 +86778,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     client: {
       id: "gateway-client",
       displayName: "okx-a2a-node",
-      version: "0.1.2",
+      version: "0.1.3-beta-5afe085f69-260701174158",
       platform: "node",
       mode: "backend",
       instanceId
@@ -86786,7 +86789,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     commands: [],
     permissions: {},
     locale: Intl.DateTimeFormat().resolvedOptions().locale || "en-US",
-    userAgent: `okx-a2a-node/${"0.1.2"}`,
+    userAgent: `okx-a2a-node/${"0.1.3-beta-5afe085f69-260701174158"}`,
     auth: {
       ...config.token ? { token: config.token } : {},
       ...config.password ? { password: config.password } : {}
@@ -88130,6 +88133,12 @@ function buildTaskPayload(replyToMessageId) {
     replyToMessageId: replyToMessageId ?? null
   };
 }
+function resolveEnvelopePayload(command, replyToMessageId) {
+  if (command.payload !== void 0) {
+    return command.payload;
+  }
+  return buildTaskPayload(replyToMessageId);
+}
 function parseJson(raw) {
   try {
     return JSON.parse(raw);
@@ -88237,7 +88246,7 @@ function buildGroupReplyRaw(command, target, myXmtpAddress, localAgent) {
     jobId: command.jobId,
     senderAgent: localAgent,
     receiverAgentId: readString(sender?.agentId),
-    payload: buildTaskPayload(command.replyToMessageId ?? target.id)
+    payload: resolveEnvelopePayload(command, command.replyToMessageId ?? target.id)
   });
 }
 async function assertOutboundEligible(params) {
@@ -88571,7 +88580,7 @@ async function handleSqliteGroupSendCommand(params) {
     jobId: command.jobId,
     senderAgent,
     receiverAgentId: remote.remoteAgent?.agentId ?? remote.toAgentId ?? null,
-    payload: buildTaskPayload(command.replyToMessageId)
+    payload: resolveEnvelopePayload(command, command.replyToMessageId)
   });
   logWithTimestamp(`[okx-agent-task] xmtp envelope ${rawText}`);
   await conversation.send(rawText);
@@ -88708,7 +88717,7 @@ async function handleGroupSendCommand(params) {
     jobId: command.jobId,
     senderAgent,
     receiverAgentId: remoteAgent?.agentId ?? session.toAgentId ?? null,
-    payload: buildTaskPayload(command.replyToMessageId)
+    payload: resolveEnvelopePayload(command, command.replyToMessageId)
   });
   logWithTimestamp(`[okx-agent-task] xmtp envelope ${rawText}`);
   await conversation.send(rawText);
@@ -91205,7 +91214,7 @@ function userWatchEventDeliveredSentryExtra(event) {
 var environment = process.env.SENTRY_ENV === "dev" ? "dev" : "prod";
 var SENTRY_CONFIG = {
   projectName: "okx/openclaw-okx-a2a-extension",
-  release: "0.1.2",
+  release: "0.1.3-beta-5afe085f69-260701174158",
   environment
 };
 
@@ -91432,12 +91441,12 @@ async function runListenerWithLock(options, paths) {
       }));
     }
   });
-  service.setPluginVersion("0.1.2");
+  service.setPluginVersion("0.1.3-beta-5afe085f69-260701174158");
   await service.init();
   const pluginVersionStatus = service.pluginVersionStatus;
   if (pluginVersionStatus.unavailable) {
     throw new Error(
-      `@okxweb3/a2a-node v${"0.1.2"} is below the required minimum v${pluginVersionStatus.minVersion}`
+      `@okxweb3/a2a-node v${"0.1.3-beta-5afe085f69-260701174158"} is below the required minimum v${pluginVersionStatus.minVersion}`
     );
   }
   const systemConfig = service.getSystemConfig();
@@ -91455,7 +91464,7 @@ async function runListenerWithLock(options, paths) {
       onchainosAgentId: "*",
       reason: "system-config missing sentryDsn",
       pluginId: "@okxweb3/a2a-node",
-      pluginVersion: "0.1.2"
+      pluginVersion: "0.1.3-beta-5afe085f69-260701174158"
     });
   }
   logWithTimestamp(
@@ -91504,10 +91513,33 @@ async function runListenerWithLock(options, paths) {
           logWithTimestamp(
             `[okx-agent-task] provider=${heartbeatProvider ?? "(not set)"} gateway unavailable, skipping heartbeat`
           );
+          logger.error(
+            LogEvent.HEARTBEAT_SKIPPED,
+            new Error(`heartbeat skipped: provider=${heartbeatProvider ?? "(not set)"} gateway unavailable`),
+            {
+              component: "node_listener",
+              stage: "sync_tick",
+              reason: "gateway_unavailable",
+              provider: heartbeatProvider ?? "(not set)",
+              chainIndex: ONCHAINOS_CHAIN_INDEX,
+              communicationClass: "gateway_or_plugin"
+            }
+          );
         }
       }
       if (!hasActiveAgents) {
         logWithTimestamp("[okx-agent-task] no active agents, skipping heartbeat");
+        logger.error(
+          LogEvent.HEARTBEAT_SKIPPED,
+          new Error("heartbeat skipped: no active agents"),
+          {
+            component: "node_listener",
+            stage: "sync_tick",
+            reason: "no_active_agents",
+            provider: heartbeatProvider ?? "(not set)",
+            chainIndex: ONCHAINOS_CHAIN_INDEX
+          }
+        );
       }
       const skippedTiming = { durationMs: 0 };
       const heartbeatResult = shouldHeartbeat ? await timeSettled(() => sendHeartbeat(ONCHAINOS_CHAIN_INDEX)) : skippedTiming;
@@ -91807,13 +91839,15 @@ async function ensureOpenClawOkxA2aPluginConfig() {
     const conversationHookAccess = await getOpenClawConfigValue(
       OPENCLAW_OKX_A2A_CONVERSATION_HOOK_ACCESS_CONFIG_PATH
     );
-    const normalizedAllow = normalizeOpenClawPluginAllowValue(allow.found ? allow.value : void 0);
     const operations = [];
     if (dmScope.value !== OPENCLAW_SESSION_DM_SCOPE_CONFIG_VALUE) {
       operations.push({ path: OPENCLAW_SESSION_DM_SCOPE_CONFIG_PATH, value: OPENCLAW_SESSION_DM_SCOPE_CONFIG_VALUE });
     }
-    if (!allow.found || normalizedAllow.changed) {
-      operations.push({ path: OPENCLAW_PLUGIN_ALLOW_CONFIG_PATH, value: normalizedAllow.value });
+    if (allow.found) {
+      const normalizedAllow = normalizeOpenClawPluginAllowValue(allow.value);
+      if (normalizedAllow.changed) {
+        operations.push({ path: OPENCLAW_PLUGIN_ALLOW_CONFIG_PATH, value: normalizedAllow.value });
+      }
     }
     if (conversationHookAccess.value !== true) {
       operations.push({ path: OPENCLAW_OKX_A2A_CONVERSATION_HOOK_ACCESS_CONFIG_PATH, value: true });
@@ -91822,11 +91856,11 @@ async function ensureOpenClawOkxA2aPluginConfig() {
       return false;
     }
     await runCommand("openclaw", ["config", "set", "--batch-json", JSON.stringify(operations)]);
-    console.log("[update] normalized OpenClaw session.dmScope/plugins.allow/hooks okx-a2a config through openclaw config set");
+    console.log("[update] normalized OpenClaw okx-a2a gateway config through openclaw config set");
     return true;
   } catch (error) {
     const detail = error instanceof Error ? error.message : String(error);
-    console.warn(`[update] skipped OpenClaw session.dmScope/plugins.allow/hooks okx-a2a config normalization through openclaw CLI: ${detail}`);
+    console.warn(`[update] skipped OpenClaw okx-a2a gateway config normalization through openclaw CLI: ${detail}`);
     return false;
   }
 }
@@ -91844,7 +91878,7 @@ async function getOpenClawConfigValue(path) {
 }
 function normalizeOpenClawPluginAllowValue(allow) {
   if (!Array.isArray(allow)) {
-    return { value: [OKX_A2A_PLUGIN_ID], changed: true };
+    return { value: allow, changed: false };
   }
   const nextAllow = [];
   let allowChanged = false;
@@ -92257,6 +92291,7 @@ async function runCommandCaptureOptional(command, args) {
   resolveConfiguredAiProvider,
   resolveConfiguredAiProviderForJob,
   resolveDirectCommunicationSessionTarget,
+  resolveEnvelopePayload,
   resolveOfflineReplayIntervalSec,
   resolveOpenClawGatewayConfig,
   resolveOpenClawGatewayRoute,

package/package.json

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