@okxweb3/a2a-node 0.1.6 → 0.1.7

package/dist/cli.js

@@ -8300,7 +8300,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     client: {
       id: "gateway-client",
       displayName: "okx-a2a-node",
-      version: "0.1.6",
+      version: "0.1.7",
       platform: "node",
       mode: "backend",
       instanceId
@@ -8311,7 +8311,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     commands: [],
     permissions: {},
     locale: Intl.DateTimeFormat().resolvedOptions().locale || "en-US",
-    userAgent: `okx-a2a-node/${"0.1.6"}`,
+    userAgent: `okx-a2a-node/${"0.1.7"}`,
     auth: {
       ...config.token ? { token: config.token } : {},
       ...config.password ? { password: config.password } : {}
@@ -24344,6 +24344,7 @@ var init_events = __esm({
       SYSTEM_NOTIFICATION_RECEIVED: "System notification received",
       SYSTEM_NOTIFICATION_ROUTED: "System notification routed",
       HERMES_SESSION_ROUTE_BINDING: "Hermes session route binding",
+      DOCTOR_REPORT: "Doctor report",
       // ── error ─────────────────────────────────────────────────────
       XMTP_CONNECTION_FAILED: "XMTP connection failed",
       CONVERSATIONS_STREAM_FAILED: "conversations.stream failed",
@@ -24383,6 +24384,8 @@ var init_events = __esm({
       DAEMON_LIFECYCLE_FAILED: "Daemon lifecycle failed",
       DAEMON_TICK_FAILED: "Daemon tick failed",
       DIRECT_CLI_FAILED: "Direct CLI failed",
+      DOCTOR_NOT_READY: "Doctor not ready",
+      DOCTOR_CRASHED: "Doctor crashed",
       AI_RUN_FAILED: "AI run failed",
       AI_RUN_TIMEOUT: "AI run timeout",
       AI_RUN_TOOL_FAILED: "AI run tool failed",
@@ -24406,7 +24409,8 @@ function agentExtras(identity3) {
   return {
     walletAddress: identity3.walletAddress || UNKNOWN_FIELD,
     inboxId: identity3.inboxId || UNKNOWN_FIELD,
-    onchainosAgentId: identity3.onchainosAgentId || UNKNOWN_FIELD
+    onchainosAgentId: identity3.onchainosAgentId || UNKNOWN_FIELD,
+    role: identity3.role != null && identity3.role !== "" ? String(identity3.role) : UNKNOWN_FIELD
   };
 }
 var Sentry, import_node_crypto4, FLOW_ID, SENTRY_EXTRA_BLOCKLIST, SENTRY_EXTRA_BLOCKED_KEY_PARTS, SENTRY_FULL_STRING_EXTRA_KEYS, SENTRY_TAG_KEYS, SENTRY_FINGERPRINT_KEYS, SENTRY_INFO_ALLOWLIST, MAX_EXTRA_STRING_LENGTH, MAX_TAG_VALUE_LENGTH, SentryLogger, logger, initLogger, shutdown, UNKNOWN_FIELD;
@@ -25561,16 +25565,17 @@ var init_task_config = __esm({
 });
 
 // ../core/src/sentry-config.ts
-var environment, SENTRY_CONFIG;
+var environment, SENTRY_CONFIG, FALLBACK_SENTRY_DSN;
 var init_sentry_config = __esm({
   "../core/src/sentry-config.ts"() {
     "use strict";
     environment = process.env.SENTRY_ENV === "dev" ? "dev" : "prod";
     SENTRY_CONFIG = {
       projectName: "okx/openclaw-okx-a2a-extension",
-      release: "0.1.6",
+      release: "0.1.7",
       environment
     };
+    FALLBACK_SENTRY_DSN = "https://e20ff987c945887733de9ec6cca87aba@sentry.coinall.ltd/apmfe/70295";
   }
 });
 
@@ -86659,7 +86664,8 @@ var init_xmtp_sdk = __esm({
           const identity3 = {
             walletAddress: address,
             inboxId: agent.client?.inboxId,
-            onchainosAgentId: onchainosAgent?.agentId
+            onchainosAgentId: onchainosAgent?.agentId,
+            role: onchainosAgent?.role
           };
           try {
             await agent.client.conversations.syncAll([
@@ -86890,12 +86896,16 @@ var init_xmtp_sdk = __esm({
                     ...agentExtras({
                       walletAddress: address,
                       inboxId: agent.client?.inboxId,
-                      onchainosAgentId: this.getAgentByAddress(address)?.agentId
+                      onchainosAgentId: this.getAgentByAddress(address)?.agentId,
+                      role: this.getAgentByAddress(address)?.role
                     }),
                     ...jobIdExtras(msg.content),
                     messageId: msg.id,
                     conversationId: conv.id,
-                    stage: "offlineReplay/handleMessage"
+                    stage: "offlineReplay/handleMessage",
+                    xmtpSentAtMs: String(msgSentMs),
+                    replayLagMs: String(Math.max(0, Date.now() - msgSentMs)),
+                    handleMs: String(handleMs)
                   });
                 } else {
                   summary.skipped++;
@@ -88129,6 +88139,23 @@ var init_agent_message_notice = __esm({
 });
 
 // src/xmtp-send.ts
+function logXmtpMessageSent(params) {
+  logger.info(LogEvent.MESSAGE_SENT, {
+    component: params.component,
+    stage: "outbound/xmtp_send",
+    taskId: params.jobId,
+    messageId: typeof params.xmtpMessageId === "string" && params.xmtpMessageId.length > 0 ? params.xmtpMessageId : "unknown",
+    conversationId: params.conversationId,
+    chatType: params.chatType,
+    walletAddress: params.myXmtpAddress,
+    toXmtpAddress: params.toXmtpAddress ?? "unknown",
+    senderAgentId: params.senderAgentId ?? "unknown",
+    toAgentId: params.toAgentId ?? "unknown",
+    role: params.role != null && params.role !== "" ? String(params.role) : "unknown",
+    xmtpSentAtMs: String(Date.now()),
+    sendDurationMs: String(params.sendDurationMs)
+  });
+}
 function isPlainObject(value) {
   return !!value && typeof value === "object" && !Array.isArray(value);
 }
@@ -88626,7 +88653,21 @@ async function handleSqliteGroupSendCommand(params) {
     payload: resolveEnvelopePayload(command, command.replyToMessageId)
   });
   logWithTimestamp(`[okx-agent-task] xmtp envelope ${rawText}`);
-  await conversation.send(rawText);
+  const sendStartMs = Date.now();
+  const xmtpMessageId = await conversation.send(rawText);
+  logXmtpMessageSent({
+    xmtpMessageId,
+    conversationId: conversation.id,
+    jobId: command.jobId,
+    chatType: "group",
+    component: "node_xmtp_send",
+    myXmtpAddress,
+    toXmtpAddress: remote.toXmtpAddress,
+    senderAgentId: senderAgent?.agentId ?? command.myAgentId,
+    toAgentId: remote.remoteAgent?.agentId ?? remote.toAgentId ?? command.toAgentId,
+    role: senderAgent?.role,
+    sendDurationMs: Date.now() - sendStartMs
+  });
   const messageId = `outbound-${(0, import_node_crypto8.randomUUID)()}`;
   await notifyAgentMessageToUserAttention({
     direction: "outbound" /* OUTBOUND */,
@@ -88763,7 +88804,21 @@ async function handleGroupSendCommand(params) {
     payload: resolveEnvelopePayload(command, command.replyToMessageId)
   });
   logWithTimestamp(`[okx-agent-task] xmtp envelope ${rawText}`);
-  await conversation.send(rawText);
+  const sendStartMs = Date.now();
+  const xmtpMessageId = await conversation.send(rawText);
+  logXmtpMessageSent({
+    xmtpMessageId,
+    conversationId: session.xmtpGroupId,
+    jobId: command.jobId,
+    chatType: "group",
+    component: "node_xmtp_send",
+    myXmtpAddress: session.myXmtpAddress,
+    toXmtpAddress: session.toXmtpAddress,
+    senderAgentId: senderAgent?.agentId ?? session.myAgentId,
+    toAgentId: remoteAgent?.agentId ?? session.toAgentId,
+    role: senderAgent?.role,
+    sendDurationMs: Date.now() - sendStartMs
+  });
   const now = Date.now();
   const messageId = `outbound-${(0, import_node_crypto8.randomUUID)()}`;
   const stored = {
@@ -88972,7 +89027,20 @@ async function handleXmtpSendCommand(params) {
     }
     const localAgent = service.getAgentByAddress(target.myXmtpAddress);
     const rawText = target.chatType === "group" ? buildGroupReplyRaw(command, target, target.myXmtpAddress, localAgent) : buildDmReplyRaw(command, target, localAgent?.agentId ?? null);
-    await conversation.send(rawText);
+    const sendStartMs = Date.now();
+    const xmtpMessageId = await conversation.send(rawText);
+    logXmtpMessageSent({
+      xmtpMessageId,
+      conversationId: target.conversationId,
+      jobId: command.jobId,
+      chatType: target.chatType,
+      component: "node_xmtp_send",
+      myXmtpAddress: target.myXmtpAddress,
+      toXmtpAddress: target.senderAddress,
+      senderAgentId: localAgent?.agentId,
+      role: localAgent?.role,
+      sendDurationMs: Date.now() - sendStartMs
+    });
     const now = Date.now();
     const messageId = `outbound-${(0, import_node_crypto8.randomUUID)()}`;
     const stored = {
@@ -89025,6 +89093,7 @@ var init_xmtp_send = __esm({
   "src/xmtp-send.ts"() {
     "use strict";
     init_log();
+    init_sentry_logger();
     import_node_crypto8 = require("node:crypto");
     init_dist4();
     init_envelope();
@@ -92125,7 +92194,21 @@ async function sendRejectContentToTarget(content3, target, params) {
     }
   });
   logWithTimestamp(`[okx-agent-task] task reject xmtp envelope ${rawText}`);
-  await conversation.send(rawText);
+  const sendStartMs = Date.now();
+  const xmtpMessageId = await conversation.send(rawText);
+  logXmtpMessageSent({
+    xmtpMessageId,
+    conversationId: target.groupId,
+    jobId,
+    chatType: "group",
+    component: "node_command_processor",
+    myXmtpAddress: target.address,
+    toXmtpAddress,
+    senderAgentId: senderAgent?.agentId,
+    toAgentId: receiverAgent?.agentId ?? target.toAgentId,
+    role: senderAgent?.role,
+    sendDurationMs: Date.now() - sendStartMs
+  });
 }
 async function denyTargets(targets, params) {
   return await Promise.all(
@@ -93295,7 +93378,7 @@ async function processFileMessage(ctx, deps, options = {}) {
     if (!providerGate.allowed) {
       return true;
     }
-    logger.info(LogEvent.SYSTEM_NOTIFICATION_RECEIVED, {
+    logger.info(LogEvent.SYSTEM_NOTIFICATION_RECEIVED, timing.extras({
       ...agentExtras({ walletAddress: deps.myXmtpAddress, onchainosAgentId: systemNotification.agentId }),
       taskId: systemNotification.jobId ?? "",
       agentId: systemNotification.agentId ?? "",
@@ -93304,10 +93387,11 @@ async function processFileMessage(ctx, deps, options = {}) {
       messageId: systemMessageId,
       systemEvent: systemNotification.event ?? "",
       stage: "inbound/system_notification_received",
+      source: options.source ?? "live",
       isDirectCommunication: String(systemNotification.isDirectCommunication),
       providerBinding: providerGate.provider ?? "",
       providerBindingCreated: String(providerGate.created)
-    });
+    }));
     const routeResolveStartedAt = Date.now();
     const targets = directTarget ? [{
       sessionKey: directTarget.sessionKey,
@@ -93323,7 +93407,7 @@ async function processFileMessage(ctx, deps, options = {}) {
       );
     }
     const primaryTarget = targets[0];
-    logger.info(LogEvent.SYSTEM_NOTIFICATION_ROUTED, {
+    logger.info(LogEvent.SYSTEM_NOTIFICATION_ROUTED, timing.extras({
       ...agentExtras({ walletAddress: deps.myXmtpAddress, onchainosAgentId: systemNotification.agentId }),
       taskId: systemNotification.jobId ?? "",
       agentId: primaryTarget?.agentId ?? systemNotification.agentId ?? "",
@@ -93335,8 +93419,9 @@ async function processFileMessage(ctx, deps, options = {}) {
       targetCount: String(targets.length),
       systemEvent: systemNotification.event ?? "",
       stage: "inbound/system_notification_routed",
+      source: options.source ?? "live",
       isDirectCommunication: String(systemNotification.isDirectCommunication)
-    });
+    }));
     if (!options.skipNotify) {
       maybeNotifyInboundAgentMessage({
         deps,
@@ -93667,7 +93752,7 @@ function processOfflineFromCoreDeps(store, ctx, deps, options) {
     allowGroup: deps.allowGroup,
     onJobMessageStored: options.onJobMessageStored,
     onSessionMessage: options.onSessionMessage
-  }, options);
+  }, { ...options, source: "replay" });
 }
 function buildSystemStoredMessage(params) {
   const now = Date.now();
@@ -94086,12 +94171,12 @@ async function runListenerWithLock(options, paths) {
       }));
     }
   });
-  service.setPluginVersion("0.1.6");
+  service.setPluginVersion("0.1.7");
   await service.init();
   const pluginVersionStatus = service.pluginVersionStatus;
   if (pluginVersionStatus.unavailable) {
     throw new Error(
-      `@okxweb3/a2a-node v${"0.1.6"} is below the required minimum v${pluginVersionStatus.minVersion}`
+      `@okxweb3/a2a-node v${"0.1.7"} is below the required minimum v${pluginVersionStatus.minVersion}`
     );
   }
   const systemConfig = service.getSystemConfig();
@@ -94109,7 +94194,7 @@ async function runListenerWithLock(options, paths) {
       onchainosAgentId: "*",
       reason: "system-config missing sentryDsn",
       pluginId: "@okxweb3/a2a-node",
-      pluginVersion: "0.1.6"
+      pluginVersion: "0.1.7"
     });
   }
   logWithTimestamp(
@@ -98130,7 +98215,7 @@ async function getCurrentNodeCliVersion() {
   return await getGlobalNpmPackageVersion(UPDATE_PACKAGES.node) ?? getBundledNodeCliVersion();
 }
 function getBundledNodeCliVersion() {
-  return true ? "0.1.6" : null;
+  return true ? "0.1.7" : null;
 }
 function readConfiguredAiProvider() {
   const explicit = process.env.OKX_A2A_AI_PROVIDER || process.env.OKX_AGENT_TASK_AI_CLI;
@@ -98340,7 +98425,7 @@ async function updateHermes(release, options) {
   }
 }
 async function installGatewayPluginForDoctor(target) {
-  const release = isPrereleaseVersion("0.1.6") ? "beta" : "latest";
+  const release = isPrereleaseVersion("0.1.7") ? "beta" : "latest";
   const insideTargetGateway = detectGatewayInvocation() === target;
   const options = {
     restart: !insideTargetGateway,
@@ -99138,6 +99223,106 @@ var init_daemon_ops = __esm({
   }
 });
 
+// src/doctor-sentry.ts
+var doctor_sentry_exports = {};
+__export(doctor_sentry_exports, {
+  buildDoctorSentryExtra: () => buildDoctorSentryExtra,
+  reportDoctorCrashToSentry: () => reportDoctorCrashToSentry,
+  reportDoctorRunToSentry: () => reportDoctorRunToSentry
+});
+function initDoctorSentry() {
+  if (sentryReady) {
+    return true;
+  }
+  try {
+    const dsn = process.env.OKX_A2A_SENTRY_DSN?.trim() || process.env.SENTRY_DSN?.trim() || FALLBACK_SENTRY_DSN;
+    initLogger({
+      dsn,
+      ...SENTRY_CONFIG,
+      agentPlatform: "node"
+    });
+    sentryReady = true;
+    return true;
+  } catch {
+    return false;
+  }
+}
+function buildDoctorSentryExtra(report, meta) {
+  const failedDetails = report.checks.filter((check) => check.status === "fail").map((check) => `${check.id}: ${check.detail}`.slice(0, 160)).join(" | ").slice(0, 900);
+  return {
+    component: "node_direct_cli",
+    source: "direct_cli",
+    operation: "doctor",
+    communicationClass: "node_cli_or_daemon_issue",
+    fixMode: String(meta.fix),
+    nonInteractive: String(meta.nonInteractive),
+    durationMs: String(meta.durationMs),
+    ready: String(report.ready),
+    state: report.state,
+    target: report.target,
+    platform: report.platform,
+    cliVersion: report.cliVersion,
+    blockingFailures: String(report.blockingFailures),
+    checks: report.checks.map((check) => `${check.id}=${check.status}`).join(";"),
+    fixesApplied: report.fixesApplied.map((fixEntry) => `${fixEntry.checkId}=${fixEntry.applied}`).join(";"),
+    ...failedDetails ? { failedDetails } : {},
+    ...report.upgraded ? { upgradedFrom: report.upgraded.from, upgradedTo: report.upgraded.to } : {}
+  };
+}
+async function reportDoctorRunToSentry(report, meta) {
+  try {
+    if (!initDoctorSentry()) {
+      return;
+    }
+    const extra = buildDoctorSentryExtra(report, meta);
+    logger.info(LogEvent.DOCTOR_REPORT, extra);
+    if (!report.ready) {
+      const blocking = report.checks.filter((check) => check.status === "fail" && check.severity !== "recommended").map((check) => check.id).join(",");
+      logger.error(
+        LogEvent.DOCTOR_NOT_READY,
+        new Error(`doctor not ready: ${blocking || report.state}`),
+        extra
+      );
+    }
+    await flushBounded();
+  } catch {
+  }
+}
+async function reportDoctorCrashToSentry(error, meta) {
+  try {
+    if (!initDoctorSentry()) {
+      return;
+    }
+    logger.error(LogEvent.DOCTOR_CRASHED, error instanceof Error ? error : new Error(String(error)), {
+      component: "node_direct_cli",
+      source: "direct_cli",
+      operation: "doctor",
+      communicationClass: "node_cli_or_daemon_issue",
+      fixMode: String(meta.fix),
+      nonInteractive: String(meta.nonInteractive),
+      durationMs: String(meta.durationMs)
+    });
+    await flushBounded();
+  } catch {
+  }
+}
+async function flushBounded() {
+  const timeout = new Promise((resolvePromise) => {
+    const timer = setTimeout(() => resolvePromise(), 1500);
+    timer.unref?.();
+  });
+  await Promise.race([shutdown().then(() => void 0), timeout]);
+}
+var sentryReady;
+var init_doctor_sentry = __esm({
+  "src/doctor-sentry.ts"() {
+    "use strict";
+    init_sentry_config();
+    init_sentry_logger();
+    sentryReady = false;
+  }
+});
+
 // src/doctor-cli.ts
 var doctor_cli_exports = {};
 __export(doctor_cli_exports, {
@@ -99225,10 +99410,11 @@ 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.1.6" : "0.0.0"),
+    cliVersion: options.cliVersion ?? (true ? "0.1.7" : "0.0.0"),
     fixMode: options.fix === true,
     nonInteractive: options.nonInteractive === true,
-    packageChanged: false
+    packageChanged: false,
+    hermesGatewayRestartPending: false
   };
   const checkers = options.checkers ?? CHECKERS;
   const fixesApplied = [];
@@ -99390,6 +99576,7 @@ async function handleDoctorCommand(args) {
       setRedirectCommandStdoutToStderr(false);
     }
   };
+  const startedAtMs = Date.now();
   let report;
   try {
     report = await runDoctor({ fix, nonInteractive, ...rawTarget ? { target: rawTarget } : {} });
@@ -99401,10 +99588,14 @@ async function handleDoctorCommand(args) {
     if (!json) {
       console.error(`doctor crashed: ${message}`);
     }
+    const { reportDoctorCrashToSentry: reportDoctorCrashToSentry2 } = await Promise.resolve().then(() => (init_doctor_sentry(), doctor_sentry_exports));
+    await reportDoctorCrashToSentry2(error, { fix, nonInteractive, durationMs: Date.now() - startedAtMs });
     await writeStdoutAndExit(out2, 2);
     return;
   }
   restoreStdout();
+  const { reportDoctorRunToSentry: reportDoctorRunToSentry2 } = await Promise.resolve().then(() => (init_doctor_sentry(), doctor_sentry_exports));
+  await reportDoctorRunToSentry2(report, { fix, nonInteractive, durationMs: Date.now() - startedAtMs });
   const out = json ? `${JSON.stringify(report)}
 ` : `${formatDoctorReportForHumans(report)}
 `;
@@ -99802,6 +99993,20 @@ var init_doctor_cli = __esm({
         const installed = await isGatewayPluginInstalled(ctx.target);
         const hermesPathSuffix = ctx.target === "hermes" ? ` (checked ${resolveHermesPluginYamlPath()})` : "";
         if (installed) {
+          if (ctx.target === "hermes" && ctx.hermesGatewayRestartPending) {
+            return {
+              id: "gateway_plugin",
+              title: "Gateway plugin installed",
+              status: "fail",
+              severity: "required",
+              detail: "the Hermes okx-a2a plugin was just installed/updated in this run, but the running Hermes gateway has not loaded it yet",
+              fix: {
+                kind: "manual",
+                description: "The Hermes okx-a2a plugin was just installed and takes effect after the Hermes gateway restarts \u2014 run /restart inside Hermes (or restart the Hermes app), then re-run okx-a2a doctor to confirm.",
+                command: "/restart"
+              }
+            };
+          }
           return {
             id: "gateway_plugin",
             title: "Gateway plugin installed",
@@ -99833,6 +100038,9 @@ var init_doctor_cli = __esm({
         }
         const { installGatewayPluginForDoctor: installGatewayPluginForDoctor2 } = await Promise.resolve().then(() => (init_update_cli(), update_cli_exports));
         const { gatewayRestarted } = await installGatewayPluginForDoctor2(ctx.target);
+        if (ctx.target === "hermes" && !gatewayRestarted) {
+          ctx.hermesGatewayRestartPending = true;
+        }
         return gatewayRestarted ? `installed the ${ctx.target} okx-a2a plugin and restarted the gateway` : `installed the ${ctx.target} okx-a2a plugin; gateway restart was deferred because doctor is running inside the ${ctx.target} gateway (restarting now would kill this session). Restart the gateway to load the plugin.`;
       }
     };
@@ -100318,7 +100526,7 @@ init_sentry_logger();
 init_sentry_config();
 var CURRENT_GATEWAY_SESSION_KEYS_ENV4 = "OKX_A2A_CURRENT_GATEWAY_SESSION_KEYS";
 function printUsage2() {
-  console.log(`okx-a2a ${"0.1.6"}
+  console.log(`okx-a2a ${"0.1.7"}
 
 Usage:
   okx-a2a <command> [options]
@@ -100356,7 +100564,7 @@ Run \`okx-a2a <command> -h\` for command-specific help.
 `);
 }
 function printVersion() {
-  console.log("0.1.6");
+  console.log("0.1.7");
 }
 function printDaemonUsage() {
   console.log(`Usage: okx-a2a daemon <start|restart|stop|status|autostart> [options]