@okxweb3/a2a-node 0.1.11 → 0.1.12-beta-61603b42d4-260803155630

package/dist/cli.js

@@ -9366,7 +9366,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     client: {
       id: "gateway-client",
       displayName: "okx-a2a-node",
-      version: "0.1.11",
+      version: "0.1.12-beta-61603b42d4-260803155630",
       platform: "node",
       mode: "backend",
       instanceId
@@ -9377,7 +9377,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     commands: [],
     permissions: {},
     locale: Intl.DateTimeFormat().resolvedOptions().locale || "en-US",
-    userAgent: `okx-a2a-node/${"0.1.11"}`,
+    userAgent: `okx-a2a-node/${"0.1.12-beta-61603b42d4-260803155630"}`,
     auth: {
       ...config.token ? { token: config.token } : {},
       ...config.password ? { password: config.password } : {}
@@ -25401,6 +25401,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_CLIENT_REMOVED: "Agent client removed",
       ADDRESS_SYNC_COMPLETED: "Address sync completed",
@@ -25911,6 +25912,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,
@@ -27064,7 +27066,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.11",
+      release: "0.1.12-beta-61603b42d4-260803155630",
       environment,
       runtimeContainer: normalizeRuntimeContainer(process.env.OKX_A2A_RUNTIME_CONTAINER)
     };
@@ -38234,7 +38236,7 @@ async function exportDiagnosticLogs(options) {
     node: process.version,
     platform: process.platform,
     arch: process.arch,
-    packageVersion: true ? "0.1.11" : "unknown",
+    packageVersion: true ? "0.1.12-beta-61603b42d4-260803155630" : "unknown",
     sensitiveContentIncluded: options.includeSensitiveContent,
     listenerAndLlmContentIncluded: true,
     credentialsAlwaysRedacted: true,
@@ -39116,6 +39118,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 resolve8() {
   if (resolvedBin) {
@@ -98535,6 +98578,9 @@ function parseGroupPayload(content3) {
     return null;
   }
 }
+function isOfflineReplayForTrigger(trigger) {
+  return trigger === "startup";
+}
 function createOfflineReplayAddressSummary(address) {
   return {
     address,
@@ -99148,7 +99194,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,
@@ -99236,7 +99282,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);
             }
@@ -99689,7 +99735,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);
         }
@@ -99800,9 +99846,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;
@@ -99925,7 +99972,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;
@@ -100003,14 +100051,14 @@ var init_xmtp_sdk = __esm({
         summary.durationMs = Date.now() - addressReplayStartedAt;
         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;
@@ -100119,6 +100167,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) {
@@ -100510,35 +100663,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 : "",
@@ -100563,6 +100713,7 @@ async function checkMessageEligible(params) {
       providerSecurityRate: String(params.providerSecurityRate)
     });
   } catch (err2) {
+    emitEligibilityChecked("failed", "unknown");
     throw messageEligibleUnavailableError({
       reason: "message-eligible-json-parse-failed",
       stdout,
@@ -100592,6 +100743,7 @@ async function checkMessageEligible(params) {
         reason: "ok=false"
       })
     );
+    emitEligibilityChecked("failed", "unknown");
     throw messageEligibleUnavailableError({
       reason: "message-eligible-ok-false",
       stdout,
@@ -100601,6 +100753,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() {
@@ -100654,6 +100807,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();
@@ -101502,7 +101656,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)}`
@@ -106443,6 +106599,7 @@ async function verifyInboundA2AGroupMessage(params) {
     messageId,
     consentState,
     trustedSystemSender = false,
+    isOfflineReplay = false,
     timing
   } = params;
   if (!isA2AEnvelope(payload)) {
@@ -106546,7 +106703,8 @@ async function verifyInboundA2AGroupMessage(params) {
         jobId,
         groupId,
         direction: isSenderClient ? "client_to_provider" : "provider_to_client",
-        providerSecurityRate
+        providerSecurityRate,
+        isOfflineReplay
       });
       timing?.mark("eligibilityCheck", eligibilityStartedAt);
       logWithTimestamp(
@@ -106992,6 +107150,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) {
@@ -107716,14 +107875,28 @@ async function runListenerWithLock(options, paths) {
           reason: "append_backup_failed"
         });
       });
+    },
+    notifyUpgradeRecommendation: (input) => {
+      const content3 = "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: content3,
+        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.1.11");
+  service.setPluginVersion("0.1.12-beta-61603b42d4-260803155630");
   await service.init();
   const pluginVersionStatus = service.pluginVersionStatus;
   if (pluginVersionStatus.unavailable) {
     throw new Error(
-      `@okxweb3/a2a-node v${"0.1.11"} is below the required minimum v${pluginVersionStatus.minVersion}`
+      `@okxweb3/a2a-node v${"0.1.12-beta-61603b42d4-260803155630"} is below the required minimum v${pluginVersionStatus.minVersion}`
     );
   }
   const systemConfig = service.getSystemConfig();
@@ -107741,12 +107914,14 @@ async function runListenerWithLock(options, paths) {
       onchainosAgentId: "*",
       reason: "system-config missing sentryDsn",
       pluginId: "@okxweb3/a2a-node",
-      pluginVersion: "0.1.11"
+      pluginVersion: "0.1.12-beta-61603b42d4-260803155630"
     });
   }
   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`
@@ -107884,7 +108059,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)), {
@@ -108115,7 +108290,7 @@ async function timeSettled(fn) {
     return { durationMs: Date.now() - startedAt, error };
   }
 }
-var import_node_fs23, import_promises13, import_node_os11, import_node_path28, 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_fs23, import_promises13, import_node_os11, import_node_path28, 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";
@@ -108126,6 +108301,7 @@ var init_listener = __esm({
     import_node_path28 = require("node:path");
     init_onchainos();
     init_system_config();
+    init_offline_replay_capability();
     init_signer();
     init_xmtp_sdk();
     init_file_store();
@@ -108134,6 +108310,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();
@@ -108146,6 +108323,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;
   }
 });
@@ -111763,7 +111941,7 @@ async function getCurrentNodeCliVersion() {
   return await getGlobalNpmPackageVersion(UPDATE_PACKAGES.node) ?? getBundledNodeCliVersion();
 }
 function getBundledNodeCliVersion() {
-  return true ? "0.1.11" : null;
+  return true ? "0.1.12-beta-61603b42d4-260803155630" : null;
 }
 function readConfiguredAiProvider() {
   const explicit = process.env.OKX_A2A_AI_PROVIDER || process.env.OKX_AGENT_TASK_AI_CLI;
@@ -111973,7 +112151,7 @@ async function updateHermes(release, options) {
   }
 }
 async function installGatewayPluginForDoctor(target) {
-  const release = isPrereleaseVersion("0.1.11") ? "beta" : "latest";
+  const release = isPrereleaseVersion("0.1.12-beta-61603b42d4-260803155630") ? "beta" : "latest";
   const insideTargetGateway = detectGatewayInvocation() === target;
   const options = {
     restart: !insideTargetGateway,
@@ -112961,7 +113139,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.1.11" : "0.0.0"),
+    cliVersion: options.cliVersion ?? (true ? "0.1.12-beta-61603b42d4-260803155630" : "0.0.0"),
     fixMode: options.fix === true,
     nonInteractive: options.nonInteractive === true,
     packageChanged: false,
@@ -114116,7 +114294,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.11"}
+  console.log(`okx-a2a ${"0.1.12-beta-61603b42d4-260803155630"}
 
 Usage:
   okx-a2a <command> [options]
@@ -114145,6 +114323,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
@@ -114154,7 +114333,7 @@ Run \`okx-a2a <command> -h\` for command-specific help.
 `);
 }
 function printVersion() {
-  console.log("0.1.11");
+  console.log("0.1.12-beta-61603b42d4-260803155630");
 }
 function printDaemonUsage() {
   console.log(`Usage: okx-a2a daemon <start|restart|stop|status|autostart> [options]
@@ -115495,6 +115674,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();

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_CLIENT_REMOVED: "Agent client removed",
       ADDRESS_SYNC_COMPLETED: "Address sync completed",
@@ -20107,6 +20108,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,
@@ -73047,7 +73049,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.11",
+      release: "0.1.12-beta-61603b42d4-260803155630",
       environment,
       runtimeContainer: normalizeRuntimeContainer(process.env.OKX_A2A_RUNTIME_CONTAINER)
     };
@@ -73977,7 +73979,7 @@ async function getCurrentNodeCliVersion() {
   return await getGlobalNpmPackageVersion(UPDATE_PACKAGES.node) ?? getBundledNodeCliVersion();
 }
 function getBundledNodeCliVersion() {
-  return true ? "0.1.11" : null;
+  return true ? "0.1.12-beta-61603b42d4-260803155630" : null;
 }
 function readConfiguredAiProvider() {
   const explicit = process.env.OKX_A2A_AI_PROVIDER || process.env.OKX_AGENT_TASK_AI_CLI;
@@ -74187,7 +74189,7 @@ async function updateHermes(release, options) {
   }
 }
 async function installGatewayPluginForDoctor(target) {
-  const release = isPrereleaseVersion("0.1.11") ? "beta" : "latest";
+  const release = isPrereleaseVersion("0.1.12-beta-61603b42d4-260803155630") ? "beta" : "latest";
   const insideTargetGateway = detectGatewayInvocation() === target;
   const options = {
     restart: !insideTargetGateway,
@@ -84857,6 +84859,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,
@@ -84874,6 +84878,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,
@@ -84894,6 +84899,7 @@ __export(index_exports, {
   buildInboundTerminalExtras: () => buildInboundTerminalExtras,
   buildLaunchdPlist: () => buildLaunchdPlist,
   buildLauncherEntryJs: () => buildLauncherEntryJs,
+  buildMessageEligibleArgs: () => buildMessageEligibleArgs,
   buildPendingConversationBackupDispatch: () => buildPendingConversationBackupDispatch,
   buildSchtasksCreateArgs: () => buildSchtasksCreateArgs,
   buildSchtasksDeleteArgs: () => buildSchtasksDeleteArgs,
@@ -84925,6 +84931,7 @@ __export(index_exports, {
   detectAiProviders: () => detectAiProviders,
   detectCurrentAiProvider: () => detectCurrentAiProvider,
   detectGatewayInvocation: () => detectGatewayInvocation,
+  detectMessageEligibleOfflineReplaySupport: () => detectMessageEligibleOfflineReplaySupport,
   detectRuntime: () => detectRuntime,
   ensureDaemonReady: () => ensureDaemonReady,
   ensureDefaultAiProvider: () => ensureDefaultAiProvider,
@@ -84938,9 +84945,11 @@ __export(index_exports, {
   findWindowsNativeOkxA2aExe: () => findWindowsNativeOkxA2aExe,
   followFile: () => followFile,
   formatDoctorReportForHumans: () => formatDoctorReportForHumans,
+  getA2ACapabilities: () => getA2ACapabilities,
   getDaemonStatus: () => getDaemonStatus,
   getHermesGatewayPluginStatus: () => getHermesGatewayPluginStatus,
   getSessionBusyTracker: () => getSessionBusyTracker,
+  handleCapabilitiesCommand: () => handleCapabilitiesCommand,
   handleDoctorCommand: () => handleDoctorCommand,
   handleXmtpSendCommand: () => handleXmtpSendCommand,
   hasAiRuntimeMarker: () => hasAiRuntimeMarker,
@@ -84952,6 +84961,7 @@ __export(index_exports, {
   isDefaultTaskHome: () => isDefaultTaskHome,
   isGatewayAvailableForHeartbeat: () => isGatewayAvailableForHeartbeat,
   isHermesGatewayPluginEnabled: () => isHermesGatewayPluginEnabled,
+  isOfflineReplayForTrigger: () => isOfflineReplayForTrigger,
   isOpenClawA2aPluginAvailable: () => isOpenClawA2aPluginAvailable,
   isOpenClawGatewayAvailable: () => isOpenClawGatewayAvailable,
   isOriginalParentProcessAlive: () => isOriginalParentProcessAlive,
@@ -84962,6 +84972,8 @@ __export(index_exports, {
   killProcessTree: () => killProcessTree,
   launchdPlistHasCurrentRestartPolicy: () => launchdPlistHasCurrentRestartPolicy,
   logWinCompat: () => logWinCompat,
+  maybeRecommendOnchainosUpgrade: () => maybeRecommendOnchainosUpgrade,
+  messageEligibleHelpAdvertisesOfflineReplay: () => messageEligibleHelpAdvertisesOfflineReplay,
   nodeVersionSatisfies: () => nodeVersionSatisfies,
   normalizeAiProvider: () => normalizeAiProvider,
   normalizeHermesOkxA2aPluginConfig: () => normalizeHermesOkxA2aPluginConfig,
@@ -84986,6 +84998,7 @@ __export(index_exports, {
   removeUserAttentionWatcher: () => removeUserAttentionWatcher,
   reportDoctorRunToSentry: () => reportDoctorRunToSentry,
   reportUserNotificationFailure: () => reportUserNotificationFailure,
+  resetMessageEligibleOfflineReplayCapabilityForTests: () => resetMessageEligibleOfflineReplayCapabilityForTests,
   resetResolvedOnchainosBinForTests: () => resetResolvedOnchainosBinForTests,
   resolveAiPermissionPreset: () => resolveAiPermissionPreset,
   resolveAiProviderCommand: () => resolveAiProviderCommand,
@@ -84997,6 +85010,7 @@ __export(index_exports, {
   resolveDoctorTarget: () => resolveDoctorTarget,
   resolveEnvelopePayload: () => resolveEnvelopePayload,
   resolveNpmCmdShimScript: () => resolveNpmCmdShimScript,
+  resolveOfflineReplayCapabilityMarker: () => resolveOfflineReplayCapabilityMarker,
   resolveOfflineReplayIntervalSec: () => resolveOfflineReplayIntervalSec,
   resolveOpenClawGatewayConfig: () => resolveOpenClawGatewayConfig,
   resolveOpenClawGatewayRoute: () => resolveOpenClawGatewayRoute,
@@ -97878,6 +97892,9 @@ function parseGroupPayload(content3) {
     return null;
   }
 }
+function isOfflineReplayForTrigger(trigger) {
+  return trigger === "startup";
+}
 var XmtpService = class _XmtpService {
   static instance = null;
   env = process.env.XMTP_ENV ?? "production";
@@ -98391,7 +98408,7 @@ var XmtpService = class _XmtpService {
           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,
@@ -98479,7 +98496,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);
         }
@@ -98932,7 +98949,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);
     }
@@ -99043,9 +99060,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;
@@ -99168,7 +99186,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;
@@ -99246,14 +99265,14 @@ var XmtpService = class _XmtpService {
     summary.durationMs = Date.now() - addressReplayStartedAt;
     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;
@@ -99694,6 +99713,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((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;
+}
+
 // ../core/src/xmtp-sdk/onchainos/system-config.ts
 init_log();
 init_sentry_logger();
@@ -100083,35 +100203,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 : "",
@@ -100136,6 +100253,7 @@ async function checkMessageEligible(params) {
       providerSecurityRate: String(params.providerSecurityRate)
     });
   } catch (err2) {
+    emitEligibilityChecked("failed", "unknown");
     throw messageEligibleUnavailableError({
       reason: "message-eligible-json-parse-failed",
       stdout,
@@ -100165,6 +100283,7 @@ async function checkMessageEligible(params) {
         reason: "ok=false"
       })
     );
+    emitEligibilityChecked("failed", "unknown");
     throw messageEligibleUnavailableError({
       reason: "message-eligible-ok-false",
       stdout,
@@ -100174,6 +100293,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() {
@@ -100996,7 +101116,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     client: {
       id: "gateway-client",
       displayName: "okx-a2a-node",
-      version: "0.1.11",
+      version: "0.1.12-beta-61603b42d4-260803155630",
       platform: "node",
       mode: "backend",
       instanceId
@@ -101007,7 +101127,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     commands: [],
     permissions: {},
     locale: Intl.DateTimeFormat().resolvedOptions().locale || "en-US",
-    userAgent: `okx-a2a-node/${"0.1.11"}`,
+    userAgent: `okx-a2a-node/${"0.1.12-beta-61603b42d4-260803155630"}`,
     auth: {
       ...config.token ? { token: config.token } : {},
       ...config.password ? { password: config.password } : {}
@@ -102749,7 +102869,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)}`
@@ -104933,6 +105055,7 @@ async function verifyInboundA2AGroupMessage(params) {
     messageId,
     consentState,
     trustedSystemSender = false,
+    isOfflineReplay = false,
     timing
   } = params;
   if (!isA2AEnvelope(payload)) {
@@ -105036,7 +105159,8 @@ async function verifyInboundA2AGroupMessage(params) {
         jobId,
         groupId,
         direction: isSenderClient ? "client_to_provider" : "provider_to_client",
-        providerSecurityRate
+        providerSecurityRate,
+        isOfflineReplay
       });
       timing?.mark("eligibilityCheck", eligibilityStartedAt);
       logWithTimestamp(
@@ -105482,6 +105606,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) {
@@ -106065,6 +106190,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) {
@@ -106305,14 +106431,28 @@ async function runListenerWithLock(options, paths) {
           reason: "append_backup_failed"
         });
       });
+    },
+    notifyUpgradeRecommendation: (input) => {
+      const content3 = "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: content3,
+        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.1.11");
+  service.setPluginVersion("0.1.12-beta-61603b42d4-260803155630");
   await service.init();
   const pluginVersionStatus = service.pluginVersionStatus;
   if (pluginVersionStatus.unavailable) {
     throw new Error(
-      `@okxweb3/a2a-node v${"0.1.11"} is below the required minimum v${pluginVersionStatus.minVersion}`
+      `@okxweb3/a2a-node v${"0.1.12-beta-61603b42d4-260803155630"} is below the required minimum v${pluginVersionStatus.minVersion}`
     );
   }
   const systemConfig = service.getSystemConfig();
@@ -106330,12 +106470,14 @@ async function runListenerWithLock(options, paths) {
       onchainosAgentId: "*",
       reason: "system-config missing sentryDsn",
       pluginId: "@okxweb3/a2a-node",
-      pluginVersion: "0.1.11"
+      pluginVersion: "0.1.12-beta-61603b42d4-260803155630"
     });
   }
   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`
@@ -106473,7 +106615,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)), {
@@ -106713,6 +106855,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/log-tail.ts
 var import_node_fs20 = require("node:fs");
 var import_promises10 = require("node:fs/promises");
@@ -108219,7 +108391,7 @@ async function exportDiagnosticLogs(options) {
     node: process.version,
     platform: process.platform,
     arch: process.arch,
-    packageVersion: true ? "0.1.11" : "unknown",
+    packageVersion: true ? "0.1.12-beta-61603b42d4-260803155630" : "unknown",
     sensitiveContentIncluded: options.includeSensitiveContent,
     listenerAndLlmContentIncluded: true,
     credentialsAlwaysRedacted: true,
@@ -109944,7 +110116,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.1.11" : "0.0.0"),
+    cliVersion: options.cliVersion ?? (true ? "0.1.12-beta-61603b42d4-260803155630" : "0.0.0"),
     fixMode: options.fix === true,
     nonInteractive: options.nonInteractive === true,
     packageChanged: false,
@@ -110178,6 +110350,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,
@@ -110195,6 +110369,7 @@ init_autostart_windows();
   XMTP_CLIENT_RECYCLE_INTERVAL_ENV,
   XmtpDm,
   XmtpGroup,
+  XmtpService,
   acquireDaemonLock,
   activeDaemonPointerPath,
   aiRunSentryExtra,
@@ -110215,6 +110390,7 @@ init_autostart_windows();
   buildInboundTerminalExtras,
   buildLaunchdPlist,
   buildLauncherEntryJs,
+  buildMessageEligibleArgs,
   buildPendingConversationBackupDispatch,
   buildSchtasksCreateArgs,
   buildSchtasksDeleteArgs,
@@ -110246,6 +110422,7 @@ init_autostart_windows();
   detectAiProviders,
   detectCurrentAiProvider,
   detectGatewayInvocation,
+  detectMessageEligibleOfflineReplaySupport,
   detectRuntime,
   ensureDaemonReady,
   ensureDefaultAiProvider,
@@ -110259,9 +110436,11 @@ init_autostart_windows();
   findWindowsNativeOkxA2aExe,
   followFile,
   formatDoctorReportForHumans,
+  getA2ACapabilities,
   getDaemonStatus,
   getHermesGatewayPluginStatus,
   getSessionBusyTracker,
+  handleCapabilitiesCommand,
   handleDoctorCommand,
   handleXmtpSendCommand,
   hasAiRuntimeMarker,
@@ -110273,6 +110452,7 @@ init_autostart_windows();
   isDefaultTaskHome,
   isGatewayAvailableForHeartbeat,
   isHermesGatewayPluginEnabled,
+  isOfflineReplayForTrigger,
   isOpenClawA2aPluginAvailable,
   isOpenClawGatewayAvailable,
   isOriginalParentProcessAlive,
@@ -110283,6 +110463,8 @@ init_autostart_windows();
   killProcessTree,
   launchdPlistHasCurrentRestartPolicy,
   logWinCompat,
+  maybeRecommendOnchainosUpgrade,
+  messageEligibleHelpAdvertisesOfflineReplay,
   nodeVersionSatisfies,
   normalizeAiProvider,
   normalizeHermesOkxA2aPluginConfig,
@@ -110307,6 +110489,7 @@ init_autostart_windows();
   removeUserAttentionWatcher,
   reportDoctorRunToSentry,
   reportUserNotificationFailure,
+  resetMessageEligibleOfflineReplayCapabilityForTests,
   resetResolvedOnchainosBinForTests,
   resolveAiPermissionPreset,
   resolveAiProviderCommand,
@@ -110318,6 +110501,7 @@ init_autostart_windows();
   resolveDoctorTarget,
   resolveEnvelopePayload,
   resolveNpmCmdShimScript,
+  resolveOfflineReplayCapabilityMarker,
   resolveOfflineReplayIntervalSec,
   resolveOpenClawGatewayConfig,
   resolveOpenClawGatewayRoute,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@okxweb3/a2a-node",
-  "version": "0.1.11",
+  "version": "0.1.12-beta-61603b42d4-260803155630",
   "description": "Host-agnostic Node CLI for E2E encrypted agent-to-agent communication via XMTP",
   "main": "dist/index.js",
   "bin": {