@okxweb3/a2a-node 0.2.0 → 0.2.1-beta-8ae7a0d300-260807161635

package/dist/cli.js

@@ -9433,7 +9433,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     client: {
       id: "gateway-client",
       displayName: "okx-a2a-node",
-      version: "0.2.0",
+      version: "0.2.1-beta-8ae7a0d300-260807161635",
       platform: "node",
       mode: "backend",
       instanceId
@@ -9444,7 +9444,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     commands: [],
     permissions: {},
     locale: Intl.DateTimeFormat().resolvedOptions().locale || "en-US",
-    userAgent: `okx-a2a-node/${"0.2.0"}`,
+    userAgent: `okx-a2a-node/${"0.2.1-beta-8ae7a0d300-260807161635"}`,
     auth: {
       ...config.token ? { token: config.token } : {},
       ...config.password ? { password: config.password } : {}
@@ -25471,6 +25471,7 @@ var init_events = __esm({
       INBOUND_DELIVERED: "Inbound delivered to session",
       DM_DELIVERED: "DM delivered to session",
       OUTBOUND_ELIGIBILITY_CHECKED: "Outbound eligibility checked",
+      MESSAGE_ELIGIBILITY_CHECKED: "Message eligibility checked",
       AGENT_CLIENT_CREATED: "Agent client created",
       AGENT_INSTALLATION_SUMMARY: "Agent installation summary",
       XMTP_HISTORY_SYNC_REQUESTED: "XMTP history sync requested",
@@ -26057,6 +26058,7 @@ var init_sentry_logger = __esm({
       LogEvent.HERMES_SESSION_ROUTE_BINDING,
       LogEvent.INBOUND_BLOCKED_ADDRESS_MISMATCH,
       LogEvent.INBOUND_BLOCKED_INELIGIBLE,
+      LogEvent.MESSAGE_ELIGIBILITY_CHECKED,
       LogEvent.INBOUND_BLOCKED_SENSITIVE,
       LogEvent.INBOUND_DROP_DM_INVALID_PAYLOAD,
       LogEvent.INBOUND_DROP_DM_NON_SYSTEM,
@@ -27414,7 +27416,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.0",
+      release: "0.2.1-beta-8ae7a0d300-260807161635",
       environment,
       runtimeContainer: normalizeRuntimeContainer(process.env.OKX_A2A_RUNTIME_CONTAINER)
     };
@@ -38584,7 +38586,7 @@ async function exportDiagnosticLogs(options) {
     node: process.version,
     platform: process.platform,
     arch: process.arch,
-    packageVersion: true ? "0.2.0" : "unknown",
+    packageVersion: true ? "0.2.1-beta-8ae7a0d300-260807161635" : "unknown",
     sensitiveContentIncluded: options.includeSensitiveContent,
     listenerAndLlmContentIncluded: true,
     credentialsAlwaysRedacted: true,
@@ -39466,6 +39468,47 @@ var init_logs_export = __esm({
   }
 });
 
+// src/capabilities-cli.ts
+var capabilities_cli_exports = {};
+__export(capabilities_cli_exports, {
+  getA2ACapabilities: () => getA2ACapabilities,
+  handleCapabilitiesCommand: () => handleCapabilitiesCommand
+});
+function getA2ACapabilities() {
+  return {
+    messageEligibleOfflineReplay: {
+      ok: true,
+      fixCommands: [],
+      message: ""
+    }
+  };
+}
+function handleCapabilitiesCommand(args) {
+  if (args.some((arg) => arg === "-h" || arg === "--help")) {
+    process.stdout.write(CAPABILITIES_USAGE);
+    return;
+  }
+  const unknown = args.filter((arg) => arg !== "--json");
+  if (unknown.length > 0) {
+    throw new Error(`Unknown capabilities option: ${unknown[0]}`);
+  }
+  const capabilities = getA2ACapabilities();
+  if (args.includes("--json")) {
+    process.stdout.write(`${JSON.stringify(capabilities)}
+`);
+    return;
+  }
+  process.stdout.write(`${JSON.stringify(capabilities, null, 2)}
+`);
+}
+var CAPABILITIES_USAGE;
+var init_capabilities_cli = __esm({
+  "src/capabilities-cli.ts"() {
+    "use strict";
+    CAPABILITIES_USAGE = "Usage: okx-a2a capabilities [--json]\n\nPrint this package's machine-readable A2A capability negotiation status.\nOnchainOS runs `okx-a2a capabilities --json` to detect supported capabilities.\n";
+  }
+});
+
 // ../core/src/xmtp-sdk/onchainos/bin.ts
 async function resolve9() {
   if (resolvedBin) {
@@ -55216,6 +55259,9 @@ function parseGroupPayload(content2) {
     return null;
   }
 }
+function isOfflineReplayForTrigger(trigger) {
+  return trigger === "startup";
+}
 function createOfflineReplayAddressSummary(address) {
   return {
     address,
@@ -55972,7 +56018,7 @@ var init_xmtp_sdk = __esm({
               logWithTimestamp(
                 `[xmtp-sdk] refresh: ${address} has a prior sync timestamp, triggering offline replay`
               );
-              void this.replayOfflineMessagesForAddress(address).catch((err2) => {
+              void this.replayOfflineMessagesForAddress(address, "agent_refresh").catch((err2) => {
                 logWithTimestamp(`[xmtp-sdk] refresh: ${address} offline replay failed:`, err2);
                 logger.error(
                   LogEvent.OFFLINE_REPLAY_FAILED,
@@ -56072,7 +56118,7 @@ var init_xmtp_sdk = __esm({
             await this.startListeningForAddresses([address]);
             let replaySummary;
             try {
-              replaySummary = await this.replayOfflineMessagesForAddress(address);
+              replaySummary = await this.replayOfflineMessagesForAddress(address, "client_recycle");
             } finally {
               await this.drainInboundReplayGate(address);
             }
@@ -56525,7 +56571,7 @@ var init_xmtp_sdk = __esm({
        * cannot overtake the stored backlog.
        */
       async completeStartupReplay() {
-        const summary = await this.replayOfflineMessages();
+        const summary = await this.replayOfflineMessages("startup");
         for (const address of this.clients.keys()) {
           await this.drainInboundReplayGate(address);
         }
@@ -56663,9 +56709,10 @@ var init_xmtp_sdk = __esm({
           logWithTimestamp(`${tag} message listener started`);
         });
       }
-      async replayOfflineMessagesForAddress(address) {
+      async replayOfflineMessagesForAddress(address, trigger = "periodic_repair") {
         const addressReplayStartedAt = Date.now();
         const summary = createOfflineReplayAddressSummary(address);
+        const isOfflineReplay = isOfflineReplayForTrigger(trigger);
         const agent = this.clients.get(address);
         if (!agent) {
           summary.durationMs = Date.now() - addressReplayStartedAt;
@@ -56789,7 +56836,8 @@ var init_xmtp_sdk = __esm({
                 };
                 const handleStartedAt = Date.now();
                 const handled = await processOffline(fakeCtx, handlerDeps, {
-                  skipNotify: true
+                  skipNotify: true,
+                  isOfflineReplay
                 });
                 const handleMs = Date.now() - handleStartedAt;
                 summary.handleMs += handleMs;
@@ -56871,14 +56919,14 @@ var init_xmtp_sdk = __esm({
         );
         return summary;
       }
-      async replayOfflineMessages() {
+      async replayOfflineMessages(trigger = "periodic_repair") {
         await this._backupReady;
         const replayStartedAt = Date.now();
         let totalReplayed = 0;
         let totalSkipped = 0;
         const addresses = [];
         for (const address of this.clients.keys()) {
-          const summary2 = await this.replayOfflineMessagesForAddress(address);
+          const summary2 = await this.replayOfflineMessagesForAddress(address, trigger);
           addresses.push(summary2);
           const { replayed, skipped: skipped2 } = summary2;
           totalReplayed += replayed;
@@ -56987,6 +57035,111 @@ var init_session_expired = __esm({
   }
 });
 
+// ../core/src/xmtp-sdk/onchainos/offline-replay-capability.ts
+function messageEligibleHelpAdvertisesOfflineReplay(helpText) {
+  if (typeof helpText !== "string" || helpText.length === 0) {
+    return false;
+  }
+  return helpText.toLowerCase().includes(MESSAGE_ELIGIBLE_OFFLINE_REPLAY_HELP_TOKEN);
+}
+function buildMessageEligibleArgs(params, opts) {
+  const args = [
+    "agent",
+    "message-eligible",
+    "--agent-id",
+    params.agentId,
+    "--client-agent-id",
+    params.clientAgentId,
+    "--provider-agent-id",
+    params.providerAgentId,
+    "--client-communication-address",
+    params.clientCommunicationAddress,
+    "--provider-communication-address",
+    params.providerCommunicationAddress,
+    "--job-id",
+    params.jobId,
+    "--group-id",
+    params.groupId,
+    "--direction",
+    params.direction,
+    "--provider-security-rate",
+    String(params.providerSecurityRate)
+  ];
+  if (opts.offlineReplaySupported) {
+    args.push(MESSAGE_ELIGIBLE_OFFLINE_REPLAY_FLAG, String(params.isOfflineReplay));
+  }
+  return args;
+}
+function resolveOfflineReplayCapabilityMarker(supported) {
+  return supported ? "supported" : "legacy_downgrade";
+}
+function maybeRecommendOnchainosUpgrade(supported) {
+  if (supported || recommendedPairs.has(UPGRADE_RECOMMENDATION_PAIR_KEY)) {
+    return;
+  }
+  const hook = XmtpService.getInstance().tools.notifyUpgradeRecommendation;
+  if (!hook) {
+    logWithTimestamp(
+      "[onchainos] tools.notifyUpgradeRecommendation not injected \u2014 deferring offline-replay upgrade notice"
+    );
+    return;
+  }
+  recommendedPairs.add(UPGRADE_RECOMMENDATION_PAIR_KEY);
+  try {
+    void Promise.resolve(
+      hook({
+        component: "onchainos",
+        capability: MESSAGE_ELIGIBLE_OFFLINE_REPLAY_HELP_TOKEN,
+        reason: UPGRADE_RECOMMENDATION_REASON
+      })
+    ).catch((err2) => {
+      logWithTimestamp("[onchainos] tools.notifyUpgradeRecommendation async delivery failed:", err2);
+    });
+  } catch (err2) {
+    logWithTimestamp("[onchainos] tools.notifyUpgradeRecommendation threw:", err2);
+  }
+}
+function detectMessageEligibleOfflineReplaySupport(execFn = exec) {
+  if (!capabilityProbe) {
+    capabilityProbe = (async () => {
+      try {
+        const { stdout, stderr } = await execFn(["agent", "message-eligible", "--help"]);
+        const supported = messageEligibleHelpAdvertisesOfflineReplay(`${stdout}
+${stderr}`);
+        logWithTimestamp(
+          `[onchainos] message-eligible offline-replay capability: ${supported ? "supported" : "legacy_downgrade"}`
+        );
+        return supported;
+      } catch (err2) {
+        logWithTimestamp(
+          "[onchainos] message-eligible --help probe failed; treating offline-replay as unsupported (legacy):",
+          err2
+        );
+        return false;
+      }
+    })().then((supported) => {
+      maybeRecommendOnchainosUpgrade(supported);
+      return supported;
+    });
+  }
+  return capabilityProbe;
+}
+var MESSAGE_ELIGIBLE_OFFLINE_REPLAY_FLAG, MESSAGE_ELIGIBLE_OFFLINE_REPLAY_HELP_TOKEN, UPGRADE_RECOMMENDATION_PAIR_KEY, UPGRADE_RECOMMENDATION_REASON, capabilityProbe, recommendedPairs;
+var init_offline_replay_capability = __esm({
+  "../core/src/xmtp-sdk/onchainos/offline-replay-capability.ts"() {
+    "use strict";
+    init_log();
+    init_bin();
+    init_xmtp_sdk();
+    MESSAGE_ELIGIBLE_OFFLINE_REPLAY_FLAG = "--is-offline-replay";
+    MESSAGE_ELIGIBLE_OFFLINE_REPLAY_HELP_TOKEN = "is-offline-replay";
+    UPGRADE_RECOMMENDATION_PAIR_KEY = "onchainos:message-eligible-offline-replay";
+    UPGRADE_RECOMMENDATION_REASON = "OnchainOS does not support the offline-replay eligibility argument; using the legacy message-eligible contract.";
+    capabilityProbe = null;
+    recommendedPairs = /* @__PURE__ */ new Set();
+  }
+});
+
 // ../core/src/xmtp-sdk/onchainos/system-config.ts
 function notifyExpired(command, options) {
   if (options?.notifySessionExpired) {
@@ -57385,35 +57538,32 @@ async function sendHeartbeat(chainIndex) {
 }
 async function checkMessageEligible(params) {
   logWithTimestamp(
-    `[onchainos] checking message-eligible: job=${params.jobId} direction=${params.direction} providerSecurityRate=${params.providerSecurityRate}`
+    `[onchainos] checking message-eligible: job=${params.jobId} direction=${params.direction} providerSecurityRate=${params.providerSecurityRate} isOfflineReplay=${params.isOfflineReplay}`
   );
+  const offlineReplaySupported = await detectMessageEligibleOfflineReplaySupport();
+  const offlineReplayCapability = resolveOfflineReplayCapabilityMarker(offlineReplaySupported);
+  const emitEligibilityChecked = (outcome, eligible) => {
+    logger.info(LogEvent.MESSAGE_ELIGIBILITY_CHECKED, {
+      component: "onchainos_cli",
+      source: "onchainos",
+      stage: "eligibility_check",
+      direction: params.direction,
+      jobId: params.jobId,
+      isOfflineReplay: String(params.isOfflineReplay),
+      offlineReplayCapability,
+      outcome,
+      eligible
+    });
+  };
   let stdout;
   let stderr;
   try {
-    ({ stdout, stderr } = await exec([
-      "agent",
-      "message-eligible",
-      "--agent-id",
-      params.agentId,
-      "--client-agent-id",
-      params.clientAgentId,
-      "--provider-agent-id",
-      params.providerAgentId,
-      "--client-communication-address",
-      params.clientCommunicationAddress,
-      "--provider-communication-address",
-      params.providerCommunicationAddress,
-      "--job-id",
-      params.jobId,
-      "--group-id",
-      params.groupId,
-      "--direction",
-      params.direction,
-      "--provider-security-rate",
-      String(params.providerSecurityRate)
-    ]));
+    ({ stdout, stderr } = await exec(
+      buildMessageEligibleArgs(params, { offlineReplaySupported })
+    ));
   } catch (err2) {
     guardCatchSessionExpired2(err2, "message-eligible");
+    emitEligibilityChecked("failed", "unknown");
     throw messageEligibleUnavailableError({
       reason: "message-eligible-cli-error",
       stdout: typeof err2?.stdout === "string" ? err2.stdout : "",
@@ -57438,6 +57588,7 @@ async function checkMessageEligible(params) {
       providerSecurityRate: String(params.providerSecurityRate)
     });
   } catch (err2) {
+    emitEligibilityChecked("failed", "unknown");
     throw messageEligibleUnavailableError({
       reason: "message-eligible-json-parse-failed",
       stdout,
@@ -57467,6 +57618,7 @@ async function checkMessageEligible(params) {
         reason: "ok=false"
       })
     );
+    emitEligibilityChecked("failed", "unknown");
     throw messageEligibleUnavailableError({
       reason: "message-eligible-ok-false",
       stdout,
@@ -57476,6 +57628,7 @@ async function checkMessageEligible(params) {
   logWithTimestamp(
     `[onchainos] message-eligible result: eligible=${res.data.eligible}`
   );
+  emitEligibilityChecked("success", String(res.data.eligible));
   return res.data;
 }
 async function fetchSensitiveWords() {
@@ -57529,6 +57682,7 @@ var init_onchainos = __esm({
     init_xmtp_sdk();
     init_cli_response();
     init_session_expired();
+    init_offline_replay_capability();
     init_cli_response();
     init_session_expired();
     init_system_config();
@@ -58394,7 +58548,9 @@ async function assertOutboundEligible(params) {
     jobId,
     groupId,
     direction: isSenderClient ? "client_to_provider" : "provider_to_client",
-    providerSecurityRate
+    providerSecurityRate,
+    // Outbound messages are never startup backlog recovery.
+    isOfflineReplay: false
   });
   logWithTimestamp(
     `[okx-agent-task] outbound message-eligible: senderAgentId=${senderAgent.agentId} receiverAgentId=${receiverAgent.agentId} job=${jobId} group=${groupId} result=${JSON.stringify(result)}`
@@ -63996,6 +64152,7 @@ async function verifyInboundA2AGroupMessage(params) {
     messageId,
     consentState,
     trustedSystemSender = false,
+    isOfflineReplay = false,
     timing
   } = params;
   if (!isA2AEnvelope(payload)) {
@@ -64099,7 +64256,8 @@ async function verifyInboundA2AGroupMessage(params) {
         jobId,
         groupId,
         direction: isSenderClient ? "client_to_provider" : "provider_to_client",
-        providerSecurityRate
+        providerSecurityRate,
+        isOfflineReplay
       });
       timing?.mark("eligibilityCheck", eligibilityStartedAt);
       logWithTimestamp(
@@ -64548,6 +64706,7 @@ async function processFileMessage(ctx, deps, options = {}) {
       messageId,
       consentState: ctx.conversation instanceof Group ? ctx.conversation.consentState() : void 0,
       trustedSystemSender,
+      isOfflineReplay: options.isOfflineReplay ?? false,
       timing
     });
     if (!accepted) {
@@ -65272,14 +65431,28 @@ async function runListenerWithLock(options, paths) {
           reason: "append_backup_failed"
         });
       });
+    },
+    notifyUpgradeRecommendation: (input) => {
+      const content2 = "The installed OnchainOS version does not support offline-replay preferences. Subscription messages will continue to replay normally. Upgrade OnchainOS to enable this capability.\n\nSuggested command: onchainos upgrade";
+      void notifySystemMessageToUser({
+        title: "OnchainOS upgrade recommended",
+        content: content2,
+        store: sessionStore,
+        idempotencyKey: UPGRADE_RECOMMENDATION_IDEMPOTENCY_KEY
+      }).catch((err2) => {
+        logWithTimestamp(
+          `[okx-agent-task] upgrade recommendation notify failed component=${input.component} capability=${input.capability}:`,
+          err2
+        );
+      });
     }
   });
-  service.setPluginVersion("0.2.0");
+  service.setPluginVersion("0.2.1-beta-8ae7a0d300-260807161635");
   await service.init();
   const pluginVersionStatus = service.pluginVersionStatus;
   if (pluginVersionStatus.unavailable) {
     throw new Error(
-      `@okxweb3/a2a-node v${"0.2.0"} is below the required minimum v${pluginVersionStatus.minVersion}`
+      `@okxweb3/a2a-node v${"0.2.1-beta-8ae7a0d300-260807161635"} is below the required minimum v${pluginVersionStatus.minVersion}`
     );
   }
   const systemConfig = service.getSystemConfig();
@@ -65297,12 +65470,14 @@ async function runListenerWithLock(options, paths) {
       onchainosAgentId: "*",
       reason: "system-config missing sentryDsn",
       pluginId: "@okxweb3/a2a-node",
-      pluginVersion: "0.2.0"
+      pluginVersion: "0.2.1-beta-8ae7a0d300-260807161635"
     });
   }
   logWithTimestamp(
     `[okx-agent-task] listener initialized, clients=${service.getClients().size}, home=${store.homeDir}`
   );
+  void detectMessageEligibleOfflineReplaySupport().catch(() => {
+  });
   const startupReplaySummary = await service.completeStartupReplay();
   logWithTimestamp(
     `[okx-agent-task] startup replay complete clients=${startupReplaySummary.clients} replayed=${startupReplaySummary.replayed} skipped=${startupReplaySummary.skipped} duration=${startupReplaySummary.durationMs}ms`
@@ -65440,7 +65615,7 @@ async function runListenerWithLock(options, paths) {
         );
         return;
       }
-      const replayResult = await timeSettled(() => service.replayOfflineMessages());
+      const replayResult = await timeSettled(() => service.replayOfflineMessages("periodic_repair"));
       const replayMs = replayResult.durationMs;
       if (replayResult.error) {
         logger.error(LogEvent.OFFLINE_REPLAY_FAILED, replayResult.error instanceof Error ? replayResult.error : new Error(String(replayResult.error)), {
@@ -65671,7 +65846,7 @@ async function timeSettled(fn) {
     return { durationMs: Date.now() - startedAt, error };
   }
 }
-var import_node_fs25, import_promises13, import_node_os11, import_node_path30, DEFAULT_OFFLINE_REPLAY_INTERVAL_SEC, DEFAULT_XMTP_CLIENT_RECYCLE_INTERVAL_SEC, XMTP_CLIENT_RECYCLE_INTERVAL_ENV, HEARTBEAT_GATEWAY_CHECK_TIMEOUT_MS, SHUTDOWN_FORCE_RESOLVE_MS;
+var import_node_fs25, import_promises13, import_node_os11, import_node_path30, DEFAULT_OFFLINE_REPLAY_INTERVAL_SEC, DEFAULT_XMTP_CLIENT_RECYCLE_INTERVAL_SEC, XMTP_CLIENT_RECYCLE_INTERVAL_ENV, HEARTBEAT_GATEWAY_CHECK_TIMEOUT_MS, UPGRADE_RECOMMENDATION_IDEMPOTENCY_KEY, SHUTDOWN_FORCE_RESOLVE_MS;
 var init_listener = __esm({
   "src/listener.ts"() {
     "use strict";
@@ -65682,6 +65857,7 @@ var init_listener = __esm({
     import_node_path30 = require("node:path");
     init_onchainos();
     init_system_config();
+    init_offline_replay_capability();
     init_signer();
     init_xmtp_sdk();
     init_file_store();
@@ -65690,6 +65866,7 @@ var init_listener = __esm({
     init_command_store();
     init_ai_dispatch_queue();
     init_message_handler();
+    init_agent_message_notice();
     init_paths();
     init_user_attention_ipc();
     init_user_attention_watchers();
@@ -65702,6 +65879,7 @@ var init_listener = __esm({
     DEFAULT_XMTP_CLIENT_RECYCLE_INTERVAL_SEC = 6 * 60 * 60;
     XMTP_CLIENT_RECYCLE_INTERVAL_ENV = "OKX_A2A_XMTP_CLIENT_RECYCLE_INTERVAL_SEC";
     HEARTBEAT_GATEWAY_CHECK_TIMEOUT_MS = 2e3;
+    UPGRADE_RECOMMENDATION_IDEMPOTENCY_KEY = "system:onchainos-offline-replay-upgrade";
     SHUTDOWN_FORCE_RESOLVE_MS = 5e3;
   }
 });
@@ -113372,7 +113550,7 @@ async function getCurrentNodeCliVersion() {
   return await getGlobalNpmPackageVersion(UPDATE_PACKAGES.node) ?? getBundledNodeCliVersion();
 }
 function getBundledNodeCliVersion() {
-  return true ? "0.2.0" : null;
+  return true ? "0.2.1-beta-8ae7a0d300-260807161635" : null;
 }
 function readConfiguredAiProvider() {
   const explicit = process.env.OKX_A2A_AI_PROVIDER || process.env.OKX_AGENT_TASK_AI_CLI;
@@ -113582,7 +113760,7 @@ async function updateHermes(release, options) {
   }
 }
 async function installGatewayPluginForDoctor(target) {
-  const release = isPrereleaseVersion("0.2.0") ? "beta" : "latest";
+  const release = isPrereleaseVersion("0.2.1-beta-8ae7a0d300-260807161635") ? "beta" : "latest";
   const insideTargetGateway = detectGatewayInvocation() === target;
   const options = {
     restart: !insideTargetGateway,
@@ -114570,7 +114748,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.0" : "0.0.0"),
+    cliVersion: options.cliVersion ?? (true ? "0.2.1-beta-8ae7a0d300-260807161635" : "0.0.0"),
     fixMode: options.fix === true,
     nonInteractive: options.nonInteractive === true,
     packageChanged: false,
@@ -115538,7 +115716,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.0"}
+  console.log(`okx-a2a ${"0.2.1-beta-8ae7a0d300-260807161635"}
 
 Usage:
   okx-a2a <command> [options]
@@ -115568,6 +115746,7 @@ Commands:
               Alias for runtime switch-current
   job-provider Manage job-to-provider bindings
   xmtp-send    Queue an XMTP message through the running daemon
+  capabilities Print machine-readable A2A capability negotiation status (used by OnchainOS)
 
 Global options:
   -h, --help     Show help
@@ -115577,7 +115756,7 @@ Run \`okx-a2a <command> -h\` for command-specific help.
 `);
 }
 function printVersion() {
-  console.log("0.2.0");
+  console.log("0.2.1-beta-8ae7a0d300-260807161635");
 }
 function printDaemonUsage() {
   console.log(`Usage: okx-a2a daemon <start|restart|stop|status|autostart> [options]
@@ -116924,6 +117103,11 @@ async function main() {
   if (hasHelpFlag5(args) && !shouldDeferHelpToNestedHandler(command, args) && printCommandUsage(command)) {
     return;
   }
+  if (command === "capabilities") {
+    const { handleCapabilitiesCommand: handleCapabilitiesCommand2 } = await Promise.resolve().then(() => (init_capabilities_cli(), capabilities_cli_exports));
+    handleCapabilitiesCommand2(process.argv.slice(3));
+    return;
+  }
   if (command === "daemon") {
     if (hasHelpFlag5(args)) {
       printDaemonUsage();
@@ -116983,7 +117167,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.0",
+      packageVersion: "0.2.1-beta-8ae7a0d300-260807161635",
       agentSdkVersion: "2.3.0",
       nodeSdkVersion: "6.1.0",
       nodeBindingsVersion: "1.11.0"

package/dist/index.js

@@ -19597,6 +19597,7 @@ var init_events = __esm({
       INBOUND_DELIVERED: "Inbound delivered to session",
       DM_DELIVERED: "DM delivered to session",
       OUTBOUND_ELIGIBILITY_CHECKED: "Outbound eligibility checked",
+      MESSAGE_ELIGIBILITY_CHECKED: "Message eligibility checked",
       AGENT_CLIENT_CREATED: "Agent client created",
       AGENT_INSTALLATION_SUMMARY: "Agent installation summary",
       XMTP_HISTORY_SYNC_REQUESTED: "XMTP history sync requested",
@@ -20183,6 +20184,7 @@ var init_sentry_logger = __esm({
       LogEvent.HERMES_SESSION_ROUTE_BINDING,
       LogEvent.INBOUND_BLOCKED_ADDRESS_MISMATCH,
       LogEvent.INBOUND_BLOCKED_INELIGIBLE,
+      LogEvent.MESSAGE_ELIGIBILITY_CHECKED,
       LogEvent.INBOUND_BLOCKED_SENSITIVE,
       LogEvent.INBOUND_DROP_DM_INVALID_PAYLOAD,
       LogEvent.INBOUND_DROP_DM_NON_SYSTEM,
@@ -30930,7 +30932,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.0",
+      release: "0.2.1-beta-8ae7a0d300-260807161635",
       environment,
       runtimeContainer: normalizeRuntimeContainer(process.env.OKX_A2A_RUNTIME_CONTAINER)
     };
@@ -31860,7 +31862,7 @@ async function getCurrentNodeCliVersion() {
   return await getGlobalNpmPackageVersion(UPDATE_PACKAGES.node) ?? getBundledNodeCliVersion();
 }
 function getBundledNodeCliVersion() {
-  return true ? "0.2.0" : null;
+  return true ? "0.2.1-beta-8ae7a0d300-260807161635" : null;
 }
 function readConfiguredAiProvider() {
   const explicit = process.env.OKX_A2A_AI_PROVIDER || process.env.OKX_AGENT_TASK_AI_CLI;
@@ -32070,7 +32072,7 @@ async function updateHermes(release, options) {
   }
 }
 async function installGatewayPluginForDoctor(target) {
-  const release = isPrereleaseVersion("0.2.0") ? "beta" : "latest";
+  const release = isPrereleaseVersion("0.2.1-beta-8ae7a0d300-260807161635") ? "beta" : "latest";
   const insideTargetGateway = detectGatewayInvocation() === target;
   const options = {
     restart: !insideTargetGateway,
@@ -42740,6 +42742,8 @@ __export(index_exports, {
   HEARTBEAT_GATEWAY_CHECK_TIMEOUT_MS: () => HEARTBEAT_GATEWAY_CHECK_TIMEOUT_MS,
   InboundReplayGate: () => InboundReplayGate,
   InvalidXmtpMessageStore: () => InvalidXmtpMessageStore,
+  MESSAGE_ELIGIBLE_OFFLINE_REPLAY_FLAG: () => MESSAGE_ELIGIBLE_OFFLINE_REPLAY_FLAG,
+  MESSAGE_ELIGIBLE_OFFLINE_REPLAY_HELP_TOKEN: () => MESSAGE_ELIGIBLE_OFFLINE_REPLAY_HELP_TOKEN,
   NATIVE_LAUNCHER_EXE_NAME: () => NATIVE_LAUNCHER_EXE_NAME,
   OPENCLAW_GATEWAY_ROUTE_GROUP_ID: () => OPENCLAW_GATEWAY_ROUTE_GROUP_ID,
   SYSTEM_NOTIFICATION_SESSION_KEY: () => SYSTEM_NOTIFICATION_SESSION_KEY,
@@ -42757,6 +42761,7 @@ __export(index_exports, {
   XMTP_CLIENT_RECYCLE_INTERVAL_ENV: () => XMTP_CLIENT_RECYCLE_INTERVAL_ENV,
   XmtpDm: () => Dm,
   XmtpGroup: () => Group,
+  XmtpService: () => XmtpService,
   acquireDaemonLock: () => acquireDaemonLock,
   activeDaemonPointerPath: () => activeDaemonPointerPath,
   aiRunSentryExtra: () => aiRunSentryExtra,
@@ -42777,6 +42782,7 @@ __export(index_exports, {
   buildInboundTerminalExtras: () => buildInboundTerminalExtras,
   buildLaunchdPlist: () => buildLaunchdPlist,
   buildLauncherEntryJs: () => buildLauncherEntryJs,
+  buildMessageEligibleArgs: () => buildMessageEligibleArgs,
   buildPendingConversationBackupDispatch: () => buildPendingConversationBackupDispatch,
   buildSchtasksCreateArgs: () => buildSchtasksCreateArgs,
   buildSchtasksDeleteArgs: () => buildSchtasksDeleteArgs,
@@ -42808,6 +42814,7 @@ __export(index_exports, {
   detectAiProviders: () => detectAiProviders,
   detectCurrentAiProvider: () => detectCurrentAiProvider,
   detectGatewayInvocation: () => detectGatewayInvocation,
+  detectMessageEligibleOfflineReplaySupport: () => detectMessageEligibleOfflineReplaySupport,
   detectRuntime: () => detectRuntime,
   ensureDaemonReady: () => ensureDaemonReady,
   ensureDefaultAiProvider: () => ensureDefaultAiProvider,
@@ -42821,9 +42828,11 @@ __export(index_exports, {
   findWindowsNativeOkxA2aExe: () => findWindowsNativeOkxA2aExe,
   followFile: () => followFile,
   formatDoctorReportForHumans: () => formatDoctorReportForHumans,
+  getA2ACapabilities: () => getA2ACapabilities,
   getDaemonStatus: () => getDaemonStatus,
   getHermesGatewayPluginStatus: () => getHermesGatewayPluginStatus,
   getSessionBusyTracker: () => getSessionBusyTracker,
+  handleCapabilitiesCommand: () => handleCapabilitiesCommand,
   handleDoctorCommand: () => handleDoctorCommand,
   handleXmtpDebugCommand: () => handleXmtpDebugCommand,
   handleXmtpSendCommand: () => handleXmtpSendCommand,
@@ -42837,6 +42846,7 @@ __export(index_exports, {
   isDefaultTaskHome: () => isDefaultTaskHome,
   isGatewayAvailableForHeartbeat: () => isGatewayAvailableForHeartbeat,
   isHermesGatewayPluginEnabled: () => isHermesGatewayPluginEnabled,
+  isOfflineReplayForTrigger: () => isOfflineReplayForTrigger,
   isOpenClawA2aPluginAvailable: () => isOpenClawA2aPluginAvailable,
   isOpenClawGatewayAvailable: () => isOpenClawGatewayAvailable,
   isOriginalParentProcessAlive: () => isOriginalParentProcessAlive,
@@ -42848,6 +42858,8 @@ __export(index_exports, {
   launchdPlistHasCurrentRestartPolicy: () => launchdPlistHasCurrentRestartPolicy,
   logWinCompat: () => logWinCompat,
   logXmtpMessageSent: () => logXmtpMessageSent,
+  maybeRecommendOnchainosUpgrade: () => maybeRecommendOnchainosUpgrade,
+  messageEligibleHelpAdvertisesOfflineReplay: () => messageEligibleHelpAdvertisesOfflineReplay,
   nodeVersionSatisfies: () => nodeVersionSatisfies,
   normalizeAiProvider: () => normalizeAiProvider,
   normalizeHermesOkxA2aPluginConfig: () => normalizeHermesOkxA2aPluginConfig,
@@ -42873,6 +42885,7 @@ __export(index_exports, {
   removeUserAttentionWatcher: () => removeUserAttentionWatcher,
   reportDoctorRunToSentry: () => reportDoctorRunToSentry,
   reportUserNotificationFailure: () => reportUserNotificationFailure,
+  resetMessageEligibleOfflineReplayCapabilityForTests: () => resetMessageEligibleOfflineReplayCapabilityForTests,
   resetResolvedOnchainosBinForTests: () => resetResolvedOnchainosBinForTests,
   resolveAiPermissionPreset: () => resolveAiPermissionPreset,
   resolveAiProviderCommand: () => resolveAiProviderCommand,
@@ -42884,6 +42897,7 @@ __export(index_exports, {
   resolveDoctorTarget: () => resolveDoctorTarget,
   resolveEnvelopePayload: () => resolveEnvelopePayload,
   resolveNpmCmdShimScript: () => resolveNpmCmdShimScript,
+  resolveOfflineReplayCapabilityMarker: () => resolveOfflineReplayCapabilityMarker,
   resolveOfflineReplayIntervalSec: () => resolveOfflineReplayIntervalSec,
   resolveOpenClawGatewayConfig: () => resolveOpenClawGatewayConfig,
   resolveOpenClawGatewayRoute: () => resolveOpenClawGatewayRoute,
@@ -54808,6 +54822,9 @@ function parseGroupPayload(content) {
     return null;
   }
 }
+function isOfflineReplayForTrigger(trigger) {
+  return trigger === "startup";
+}
 var XmtpService = class _XmtpService {
   static instance = null;
   env = process.env.XMTP_ENV ?? "production";
@@ -55461,7 +55478,7 @@ var XmtpService = class _XmtpService {
           logWithTimestamp(
             `[xmtp-sdk] refresh: ${address} has a prior sync timestamp, triggering offline replay`
           );
-          void this.replayOfflineMessagesForAddress(address).catch((err) => {
+          void this.replayOfflineMessagesForAddress(address, "agent_refresh").catch((err) => {
             logWithTimestamp(`[xmtp-sdk] refresh: ${address} offline replay failed:`, err);
             logger.error(
               LogEvent.OFFLINE_REPLAY_FAILED,
@@ -55561,7 +55578,7 @@ var XmtpService = class _XmtpService {
         await this.startListeningForAddresses([address]);
         let replaySummary;
         try {
-          replaySummary = await this.replayOfflineMessagesForAddress(address);
+          replaySummary = await this.replayOfflineMessagesForAddress(address, "client_recycle");
         } finally {
           await this.drainInboundReplayGate(address);
         }
@@ -56014,7 +56031,7 @@ var XmtpService = class _XmtpService {
    * cannot overtake the stored backlog.
    */
   async completeStartupReplay() {
-    const summary = await this.replayOfflineMessages();
+    const summary = await this.replayOfflineMessages("startup");
     for (const address of this.clients.keys()) {
       await this.drainInboundReplayGate(address);
     }
@@ -56152,9 +56169,10 @@ var XmtpService = class _XmtpService {
       logWithTimestamp(`${tag} message listener started`);
     });
   }
-  async replayOfflineMessagesForAddress(address) {
+  async replayOfflineMessagesForAddress(address, trigger = "periodic_repair") {
     const addressReplayStartedAt = Date.now();
     const summary = createOfflineReplayAddressSummary(address);
+    const isOfflineReplay = isOfflineReplayForTrigger(trigger);
     const agent = this.clients.get(address);
     if (!agent) {
       summary.durationMs = Date.now() - addressReplayStartedAt;
@@ -56278,7 +56296,8 @@ var XmtpService = class _XmtpService {
             };
             const handleStartedAt = Date.now();
             const handled = await processOffline(fakeCtx, handlerDeps, {
-              skipNotify: true
+              skipNotify: true,
+              isOfflineReplay
             });
             const handleMs = Date.now() - handleStartedAt;
             summary.handleMs += handleMs;
@@ -56360,14 +56379,14 @@ var XmtpService = class _XmtpService {
     );
     return summary;
   }
-  async replayOfflineMessages() {
+  async replayOfflineMessages(trigger = "periodic_repair") {
     await this._backupReady;
     const replayStartedAt = Date.now();
     let totalReplayed = 0;
     let totalSkipped = 0;
     const addresses = [];
     for (const address of this.clients.keys()) {
-      const summary2 = await this.replayOfflineMessagesForAddress(address);
+      const summary2 = await this.replayOfflineMessagesForAddress(address, trigger);
       addresses.push(summary2);
       const { replayed, skipped: skipped2 } = summary2;
       totalReplayed += replayed;
@@ -56808,6 +56827,107 @@ function reportSessionExpired(command) {
   );
 }
 
+// ../core/src/xmtp-sdk/onchainos/offline-replay-capability.ts
+init_log();
+var MESSAGE_ELIGIBLE_OFFLINE_REPLAY_FLAG = "--is-offline-replay";
+var MESSAGE_ELIGIBLE_OFFLINE_REPLAY_HELP_TOKEN = "is-offline-replay";
+var UPGRADE_RECOMMENDATION_PAIR_KEY = "onchainos:message-eligible-offline-replay";
+var UPGRADE_RECOMMENDATION_REASON = "OnchainOS does not support the offline-replay eligibility argument; using the legacy message-eligible contract.";
+function messageEligibleHelpAdvertisesOfflineReplay(helpText) {
+  if (typeof helpText !== "string" || helpText.length === 0) {
+    return false;
+  }
+  return helpText.toLowerCase().includes(MESSAGE_ELIGIBLE_OFFLINE_REPLAY_HELP_TOKEN);
+}
+function buildMessageEligibleArgs(params, opts) {
+  const args = [
+    "agent",
+    "message-eligible",
+    "--agent-id",
+    params.agentId,
+    "--client-agent-id",
+    params.clientAgentId,
+    "--provider-agent-id",
+    params.providerAgentId,
+    "--client-communication-address",
+    params.clientCommunicationAddress,
+    "--provider-communication-address",
+    params.providerCommunicationAddress,
+    "--job-id",
+    params.jobId,
+    "--group-id",
+    params.groupId,
+    "--direction",
+    params.direction,
+    "--provider-security-rate",
+    String(params.providerSecurityRate)
+  ];
+  if (opts.offlineReplaySupported) {
+    args.push(MESSAGE_ELIGIBLE_OFFLINE_REPLAY_FLAG, String(params.isOfflineReplay));
+  }
+  return args;
+}
+function resolveOfflineReplayCapabilityMarker(supported) {
+  return supported ? "supported" : "legacy_downgrade";
+}
+var capabilityProbe = null;
+var recommendedPairs = /* @__PURE__ */ new Set();
+function resetMessageEligibleOfflineReplayCapabilityForTests() {
+  capabilityProbe = null;
+  recommendedPairs.clear();
+}
+function maybeRecommendOnchainosUpgrade(supported) {
+  if (supported || recommendedPairs.has(UPGRADE_RECOMMENDATION_PAIR_KEY)) {
+    return;
+  }
+  const hook = XmtpService.getInstance().tools.notifyUpgradeRecommendation;
+  if (!hook) {
+    logWithTimestamp(
+      "[onchainos] tools.notifyUpgradeRecommendation not injected \u2014 deferring offline-replay upgrade notice"
+    );
+    return;
+  }
+  recommendedPairs.add(UPGRADE_RECOMMENDATION_PAIR_KEY);
+  try {
+    void Promise.resolve(
+      hook({
+        component: "onchainos",
+        capability: MESSAGE_ELIGIBLE_OFFLINE_REPLAY_HELP_TOKEN,
+        reason: UPGRADE_RECOMMENDATION_REASON
+      })
+    ).catch((err) => {
+      logWithTimestamp("[onchainos] tools.notifyUpgradeRecommendation async delivery failed:", err);
+    });
+  } catch (err) {
+    logWithTimestamp("[onchainos] tools.notifyUpgradeRecommendation threw:", err);
+  }
+}
+function detectMessageEligibleOfflineReplaySupport(execFn = exec) {
+  if (!capabilityProbe) {
+    capabilityProbe = (async () => {
+      try {
+        const { stdout, stderr } = await execFn(["agent", "message-eligible", "--help"]);
+        const supported = messageEligibleHelpAdvertisesOfflineReplay(`${stdout}
+${stderr}`);
+        logWithTimestamp(
+          `[onchainos] message-eligible offline-replay capability: ${supported ? "supported" : "legacy_downgrade"}`
+        );
+        return supported;
+      } catch (err) {
+        logWithTimestamp(
+          "[onchainos] message-eligible --help probe failed; treating offline-replay as unsupported (legacy):",
+          err
+        );
+        return false;
+      }
+    })().then((supported) => {
+      maybeRecommendOnchainosUpgrade(supported);
+      return supported;
+    });
+  }
+  return capabilityProbe;
+}
+
 // ../core/src/xmtp-sdk/onchainos/system-config.ts
 init_log();
 init_sentry_logger();
@@ -57204,35 +57324,32 @@ async function sendHeartbeat(chainIndex) {
 }
 async function checkMessageEligible(params) {
   logWithTimestamp(
-    `[onchainos] checking message-eligible: job=${params.jobId} direction=${params.direction} providerSecurityRate=${params.providerSecurityRate}`
+    `[onchainos] checking message-eligible: job=${params.jobId} direction=${params.direction} providerSecurityRate=${params.providerSecurityRate} isOfflineReplay=${params.isOfflineReplay}`
   );
+  const offlineReplaySupported = await detectMessageEligibleOfflineReplaySupport();
+  const offlineReplayCapability = resolveOfflineReplayCapabilityMarker(offlineReplaySupported);
+  const emitEligibilityChecked = (outcome, eligible) => {
+    logger.info(LogEvent.MESSAGE_ELIGIBILITY_CHECKED, {
+      component: "onchainos_cli",
+      source: "onchainos",
+      stage: "eligibility_check",
+      direction: params.direction,
+      jobId: params.jobId,
+      isOfflineReplay: String(params.isOfflineReplay),
+      offlineReplayCapability,
+      outcome,
+      eligible
+    });
+  };
   let stdout;
   let stderr;
   try {
-    ({ stdout, stderr } = await exec([
-      "agent",
-      "message-eligible",
-      "--agent-id",
-      params.agentId,
-      "--client-agent-id",
-      params.clientAgentId,
-      "--provider-agent-id",
-      params.providerAgentId,
-      "--client-communication-address",
-      params.clientCommunicationAddress,
-      "--provider-communication-address",
-      params.providerCommunicationAddress,
-      "--job-id",
-      params.jobId,
-      "--group-id",
-      params.groupId,
-      "--direction",
-      params.direction,
-      "--provider-security-rate",
-      String(params.providerSecurityRate)
-    ]));
+    ({ stdout, stderr } = await exec(
+      buildMessageEligibleArgs(params, { offlineReplaySupported })
+    ));
   } catch (err) {
     guardCatchSessionExpired2(err, "message-eligible");
+    emitEligibilityChecked("failed", "unknown");
     throw messageEligibleUnavailableError({
       reason: "message-eligible-cli-error",
       stdout: typeof err?.stdout === "string" ? err.stdout : "",
@@ -57257,6 +57374,7 @@ async function checkMessageEligible(params) {
       providerSecurityRate: String(params.providerSecurityRate)
     });
   } catch (err) {
+    emitEligibilityChecked("failed", "unknown");
     throw messageEligibleUnavailableError({
       reason: "message-eligible-json-parse-failed",
       stdout,
@@ -57286,6 +57404,7 @@ async function checkMessageEligible(params) {
         reason: "ok=false"
       })
     );
+    emitEligibilityChecked("failed", "unknown");
     throw messageEligibleUnavailableError({
       reason: "message-eligible-ok-false",
       stdout,
@@ -57295,6 +57414,7 @@ async function checkMessageEligible(params) {
   logWithTimestamp(
     `[onchainos] message-eligible result: eligible=${res.data.eligible}`
   );
+  emitEligibilityChecked("success", String(res.data.eligible));
   return res.data;
 }
 async function fetchSensitiveWords() {
@@ -58117,7 +58237,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     client: {
       id: "gateway-client",
       displayName: "okx-a2a-node",
-      version: "0.2.0",
+      version: "0.2.1-beta-8ae7a0d300-260807161635",
       platform: "node",
       mode: "backend",
       instanceId
@@ -58128,7 +58248,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     commands: [],
     permissions: {},
     locale: Intl.DateTimeFormat().resolvedOptions().locale || "en-US",
-    userAgent: `okx-a2a-node/${"0.2.0"}`,
+    userAgent: `okx-a2a-node/${"0.2.1-beta-8ae7a0d300-260807161635"}`,
     auth: {
       ...config.token ? { token: config.token } : {},
       ...config.password ? { password: config.password } : {}
@@ -59890,7 +60010,9 @@ async function assertOutboundEligible(params) {
     jobId,
     groupId,
     direction: isSenderClient ? "client_to_provider" : "provider_to_client",
-    providerSecurityRate
+    providerSecurityRate,
+    // Outbound messages are never startup backlog recovery.
+    isOfflineReplay: false
   });
   logWithTimestamp(
     `[okx-agent-task] outbound message-eligible: senderAgentId=${senderAgent.agentId} receiverAgentId=${receiverAgent.agentId} job=${jobId} group=${groupId} result=${JSON.stringify(result)}`
@@ -62729,6 +62851,7 @@ async function verifyInboundA2AGroupMessage(params) {
     messageId,
     consentState,
     trustedSystemSender = false,
+    isOfflineReplay = false,
     timing
   } = params;
   if (!isA2AEnvelope(payload)) {
@@ -62832,7 +62955,8 @@ async function verifyInboundA2AGroupMessage(params) {
         jobId,
         groupId,
         direction: isSenderClient ? "client_to_provider" : "provider_to_client",
-        providerSecurityRate
+        providerSecurityRate,
+        isOfflineReplay
       });
       timing?.mark("eligibilityCheck", eligibilityStartedAt);
       logWithTimestamp(
@@ -63281,6 +63405,7 @@ async function processFileMessage(ctx, deps, options = {}) {
       messageId,
       consentState: ctx.conversation instanceof Group ? ctx.conversation.consentState() : void 0,
       trustedSystemSender,
+      isOfflineReplay: options.isOfflineReplay ?? false,
       timing
     });
     if (!accepted) {
@@ -63864,6 +63989,7 @@ var DEFAULT_OFFLINE_REPLAY_INTERVAL_SEC = 300;
 var DEFAULT_XMTP_CLIENT_RECYCLE_INTERVAL_SEC = 6 * 60 * 60;
 var XMTP_CLIENT_RECYCLE_INTERVAL_ENV = "OKX_A2A_XMTP_CLIENT_RECYCLE_INTERVAL_SEC";
 var HEARTBEAT_GATEWAY_CHECK_TIMEOUT_MS = 2e3;
+var UPGRADE_RECOMMENDATION_IDEMPOTENCY_KEY = "system:onchainos-offline-replay-upgrade";
 function resolveOfflineReplayIntervalSec(systemConfig) {
   const interval = systemConfig.offlineReplayInterval;
   if (typeof interval !== "number" || !Number.isFinite(interval) || interval <= 0) {
@@ -64104,14 +64230,28 @@ async function runListenerWithLock(options, paths) {
           reason: "append_backup_failed"
         });
       });
+    },
+    notifyUpgradeRecommendation: (input) => {
+      const content = "The installed OnchainOS version does not support offline-replay preferences. Subscription messages will continue to replay normally. Upgrade OnchainOS to enable this capability.\n\nSuggested command: onchainos upgrade";
+      void notifySystemMessageToUser({
+        title: "OnchainOS upgrade recommended",
+        content,
+        store: sessionStore,
+        idempotencyKey: UPGRADE_RECOMMENDATION_IDEMPOTENCY_KEY
+      }).catch((err) => {
+        logWithTimestamp(
+          `[okx-agent-task] upgrade recommendation notify failed component=${input.component} capability=${input.capability}:`,
+          err
+        );
+      });
     }
   });
-  service.setPluginVersion("0.2.0");
+  service.setPluginVersion("0.2.1-beta-8ae7a0d300-260807161635");
   await service.init();
   const pluginVersionStatus = service.pluginVersionStatus;
   if (pluginVersionStatus.unavailable) {
     throw new Error(
-      `@okxweb3/a2a-node v${"0.2.0"} is below the required minimum v${pluginVersionStatus.minVersion}`
+      `@okxweb3/a2a-node v${"0.2.1-beta-8ae7a0d300-260807161635"} is below the required minimum v${pluginVersionStatus.minVersion}`
     );
   }
   const systemConfig = service.getSystemConfig();
@@ -64129,12 +64269,14 @@ async function runListenerWithLock(options, paths) {
       onchainosAgentId: "*",
       reason: "system-config missing sentryDsn",
       pluginId: "@okxweb3/a2a-node",
-      pluginVersion: "0.2.0"
+      pluginVersion: "0.2.1-beta-8ae7a0d300-260807161635"
     });
   }
   logWithTimestamp(
     `[okx-agent-task] listener initialized, clients=${service.getClients().size}, home=${store.homeDir}`
   );
+  void detectMessageEligibleOfflineReplaySupport().catch(() => {
+  });
   const startupReplaySummary = await service.completeStartupReplay();
   logWithTimestamp(
     `[okx-agent-task] startup replay complete clients=${startupReplaySummary.clients} replayed=${startupReplaySummary.replayed} skipped=${startupReplaySummary.skipped} duration=${startupReplaySummary.durationMs}ms`
@@ -64272,7 +64414,7 @@ async function runListenerWithLock(options, paths) {
         );
         return;
       }
-      const replayResult = await timeSettled(() => service.replayOfflineMessages());
+      const replayResult = await timeSettled(() => service.replayOfflineMessages("periodic_repair"));
       const replayMs = replayResult.durationMs;
       if (replayResult.error) {
         logger.error(LogEvent.OFFLINE_REPLAY_FAILED, replayResult.error instanceof Error ? replayResult.error : new Error(String(replayResult.error)), {
@@ -65378,6 +65520,36 @@ init_ai_command();
 init_update_cli();
 init_win_spawn();
 
+// src/capabilities-cli.ts
+function getA2ACapabilities() {
+  return {
+    messageEligibleOfflineReplay: {
+      ok: true,
+      fixCommands: [],
+      message: ""
+    }
+  };
+}
+var CAPABILITIES_USAGE = "Usage: okx-a2a capabilities [--json]\n\nPrint this package's machine-readable A2A capability negotiation status.\nOnchainOS runs `okx-a2a capabilities --json` to detect supported capabilities.\n";
+function handleCapabilitiesCommand(args) {
+  if (args.some((arg) => arg === "-h" || arg === "--help")) {
+    process.stdout.write(CAPABILITIES_USAGE);
+    return;
+  }
+  const unknown = args.filter((arg) => arg !== "--json");
+  if (unknown.length > 0) {
+    throw new Error(`Unknown capabilities option: ${unknown[0]}`);
+  }
+  const capabilities = getA2ACapabilities();
+  if (args.includes("--json")) {
+    process.stdout.write(`${JSON.stringify(capabilities)}
+`);
+    return;
+  }
+  process.stdout.write(`${JSON.stringify(capabilities, null, 2)}
+`);
+}
+
 // src/logs-export.ts
 var import_node_child_process10 = require("node:child_process");
 var import_node_fs27 = require("node:fs");
@@ -66698,7 +66870,7 @@ async function exportDiagnosticLogs(options) {
     node: process.version,
     platform: process.platform,
     arch: process.arch,
-    packageVersion: true ? "0.2.0" : "unknown",
+    packageVersion: true ? "0.2.1-beta-8ae7a0d300-260807161635" : "unknown",
     sensitiveContentIncluded: options.includeSensitiveContent,
     listenerAndLlmContentIncluded: true,
     credentialsAlwaysRedacted: true,
@@ -68423,7 +68595,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.0" : "0.0.0"),
+    cliVersion: options.cliVersion ?? (true ? "0.2.1-beta-8ae7a0d300-260807161635" : "0.0.0"),
     fixMode: options.fix === true,
     nonInteractive: options.nonInteractive === true,
     packageChanged: false,
@@ -68657,6 +68829,8 @@ init_autostart_windows();
   HEARTBEAT_GATEWAY_CHECK_TIMEOUT_MS,
   InboundReplayGate,
   InvalidXmtpMessageStore,
+  MESSAGE_ELIGIBLE_OFFLINE_REPLAY_FLAG,
+  MESSAGE_ELIGIBLE_OFFLINE_REPLAY_HELP_TOKEN,
   NATIVE_LAUNCHER_EXE_NAME,
   OPENCLAW_GATEWAY_ROUTE_GROUP_ID,
   SYSTEM_NOTIFICATION_SESSION_KEY,
@@ -68674,6 +68848,7 @@ init_autostart_windows();
   XMTP_CLIENT_RECYCLE_INTERVAL_ENV,
   XmtpDm,
   XmtpGroup,
+  XmtpService,
   acquireDaemonLock,
   activeDaemonPointerPath,
   aiRunSentryExtra,
@@ -68694,6 +68869,7 @@ init_autostart_windows();
   buildInboundTerminalExtras,
   buildLaunchdPlist,
   buildLauncherEntryJs,
+  buildMessageEligibleArgs,
   buildPendingConversationBackupDispatch,
   buildSchtasksCreateArgs,
   buildSchtasksDeleteArgs,
@@ -68725,6 +68901,7 @@ init_autostart_windows();
   detectAiProviders,
   detectCurrentAiProvider,
   detectGatewayInvocation,
+  detectMessageEligibleOfflineReplaySupport,
   detectRuntime,
   ensureDaemonReady,
   ensureDefaultAiProvider,
@@ -68738,9 +68915,11 @@ init_autostart_windows();
   findWindowsNativeOkxA2aExe,
   followFile,
   formatDoctorReportForHumans,
+  getA2ACapabilities,
   getDaemonStatus,
   getHermesGatewayPluginStatus,
   getSessionBusyTracker,
+  handleCapabilitiesCommand,
   handleDoctorCommand,
   handleXmtpDebugCommand,
   handleXmtpSendCommand,
@@ -68754,6 +68933,7 @@ init_autostart_windows();
   isDefaultTaskHome,
   isGatewayAvailableForHeartbeat,
   isHermesGatewayPluginEnabled,
+  isOfflineReplayForTrigger,
   isOpenClawA2aPluginAvailable,
   isOpenClawGatewayAvailable,
   isOriginalParentProcessAlive,
@@ -68765,6 +68945,8 @@ init_autostart_windows();
   launchdPlistHasCurrentRestartPolicy,
   logWinCompat,
   logXmtpMessageSent,
+  maybeRecommendOnchainosUpgrade,
+  messageEligibleHelpAdvertisesOfflineReplay,
   nodeVersionSatisfies,
   normalizeAiProvider,
   normalizeHermesOkxA2aPluginConfig,
@@ -68790,6 +68972,7 @@ init_autostart_windows();
   removeUserAttentionWatcher,
   reportDoctorRunToSentry,
   reportUserNotificationFailure,
+  resetMessageEligibleOfflineReplayCapabilityForTests,
   resetResolvedOnchainosBinForTests,
   resolveAiPermissionPreset,
   resolveAiProviderCommand,
@@ -68801,6 +68984,7 @@ init_autostart_windows();
   resolveDoctorTarget,
   resolveEnvelopePayload,
   resolveNpmCmdShimScript,
+  resolveOfflineReplayCapabilityMarker,
   resolveOfflineReplayIntervalSec,
   resolveOpenClawGatewayConfig,
   resolveOpenClawGatewayRoute,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@okxweb3/a2a-node",
-  "version": "0.2.0",
+  "version": "0.2.1-beta-8ae7a0d300-260807161635",
   "description": "Host-agnostic Node CLI for E2E encrypted agent-to-agent communication via XMTP",
   "main": "dist/index.js",
   "bin": {