@okxweb3/a2a-node 0.1.6 → 0.1.7-beta-482acfaf84-260707171501

package/dist/cli.js

@@ -593,7 +593,7 @@ function readTextArray(value) {
   });
   return normalizeGatewayRouteAliases(values);
 }
-var import_node_crypto, import_node_fs2, import_node_path3, DatabaseSync, SYSTEM_NOTIFICATION_SESSION_KEY, AI_PROVIDER_COMMAND_SETTING_PREFIX, SessionStore;
+var import_node_crypto, import_node_fs2, import_node_path3, DatabaseSync, SYSTEM_NOTIFICATION_SESSION_KEY, NOTIFICATION_ATTENTION_KINDS, PROMPT_ATTENTION_KINDS, AI_PROVIDER_COMMAND_SETTING_PREFIX, SessionStore;
 var init_session_store = __esm({
   "src/session-store.ts"() {
     "use strict";
@@ -603,6 +603,8 @@ var init_session_store = __esm({
     init_paths();
     ({ DatabaseSync } = loadSqlite());
     SYSTEM_NOTIFICATION_SESSION_KEY = "system-notification";
+    NOTIFICATION_ATTENTION_KINDS = ["notification", "system_notification"];
+    PROMPT_ATTENTION_KINDS = ["decision_request", "system_prompt"];
     AI_PROVIDER_COMMAND_SETTING_PREFIX = "ai_provider_command_";
     SessionStore = class {
       homeDir;
@@ -664,34 +666,11 @@ var init_session_store = __esm({
       CREATE INDEX IF NOT EXISTS idx_session_metadata_job_agents
       ON session_metadata(job_id, my_agent_id, to_agent_id)
     `);
-        this.db.exec(`
-      CREATE TABLE IF NOT EXISTS user_attention (
-        id TEXT PRIMARY KEY,
-        kind TEXT NOT NULL CHECK (kind IN ('notification', 'decision_request')),
-        provider TEXT CHECK (provider IN ('codex', 'claude', 'hermes', 'openclaw') OR provider IS NULL),
-        status TEXT NOT NULL CHECK (status IN ('pending', 'handled')),
-        job_id TEXT,
-        session_key TEXT,
-        llm_content TEXT,
-        choices_json TEXT,
-        user_content TEXT NOT NULL,
-        idempotency_key TEXT UNIQUE,
-        expire_time INTEGER,
-        created_at TEXT NOT NULL,
-        handled_at TEXT,
-        deleted_at TEXT,
-        seen INTEGER NOT NULL DEFAULT 0 CHECK (seen IN (0, 1))
-      )
-    `);
+        this.ensureUserAttentionSchema();
         this.db.exec(`
       CREATE INDEX IF NOT EXISTS idx_user_attention_status_created
       ON user_attention(status, created_at)
     `);
-        this.ensureColumn("user_attention", "choices_json", "TEXT");
-        this.ensureColumn("user_attention", "deleted_at", "TEXT");
-        this.ensureColumn("user_attention", "seen", "INTEGER NOT NULL DEFAULT 0");
-        this.ensureColumn("user_attention", "provider", "TEXT CHECK (provider IN ('codex', 'claude', 'hermes', 'openclaw') OR provider IS NULL)");
-        this.ensureColumn("user_attention", "expire_time", "INTEGER");
         this.db.exec(`
       CREATE INDEX IF NOT EXISTS idx_user_attention_provider_status_created
       ON user_attention(provider, status, created_at)
@@ -757,6 +736,58 @@ var init_session_store = __esm({
       CREATE INDEX IF NOT EXISTS idx_pending_gateway_deliveries_provider_created
       ON pending_gateway_deliveries(provider, created_at)
     `);
+      }
+      ensureUserAttentionSchema() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS user_attention (
+        ${this.userAttentionTableColumnsSql()}
+      )
+    `);
+        this.ensureColumn("user_attention", "choices_json", "TEXT");
+        this.ensureColumn("user_attention", "deleted_at", "TEXT");
+        this.ensureColumn("user_attention", "seen", "INTEGER NOT NULL DEFAULT 0");
+        this.ensureColumn("user_attention", "provider", "TEXT CHECK (provider IN ('codex', 'claude', 'hermes', 'openclaw') OR provider IS NULL)");
+        this.ensureColumn("user_attention", "expire_time", "INTEGER");
+        const row = this.db.prepare("SELECT sql FROM sqlite_master WHERE type='table' AND name='user_attention'").get();
+        if (row?.sql?.includes("system_notification") && row.sql.includes("system_prompt")) {
+          return;
+        }
+        this.db.exec("ALTER TABLE user_attention RENAME TO user_attention_old");
+        this.db.exec(`
+      CREATE TABLE user_attention (
+        ${this.userAttentionTableColumnsSql()}
+      )
+    `);
+        this.db.exec(`
+      INSERT INTO user_attention (
+        id, kind, provider, status, job_id, session_key, llm_content, choices_json,
+        user_content, idempotency_key, expire_time, created_at, handled_at, deleted_at, seen
+      )
+      SELECT
+        id, kind, provider, status, job_id, session_key, llm_content, choices_json,
+        user_content, idempotency_key, expire_time, created_at, handled_at, deleted_at, seen
+      FROM user_attention_old
+    `);
+        this.db.exec("DROP TABLE user_attention_old");
+      }
+      userAttentionTableColumnsSql() {
+        return `
+        id TEXT PRIMARY KEY,
+        kind TEXT NOT NULL CHECK (kind IN ('notification', 'decision_request', 'system_notification', 'system_prompt')),
+        provider TEXT CHECK (provider IN ('codex', 'claude', 'hermes', 'openclaw') OR provider IS NULL),
+        status TEXT NOT NULL CHECK (status IN ('pending', 'handled')),
+        job_id TEXT,
+        session_key TEXT,
+        llm_content TEXT,
+        choices_json TEXT,
+        user_content TEXT NOT NULL,
+        idempotency_key TEXT UNIQUE,
+        expire_time INTEGER,
+        created_at TEXT NOT NULL,
+        handled_at TEXT,
+        deleted_at TEXT,
+        seen INTEGER NOT NULL DEFAULT 0 CHECK (seen IN (0, 1))
+    `;
       }
       ensurePendingGatewayDeliveriesSchema() {
         const expectedKindCheck = this.pendingGatewayDeliveryKindCheck();
@@ -1101,11 +1132,11 @@ var init_session_store = __esm({
         return rows.map(mapJobProviderBindingRow);
       }
       createUserAttention(input) {
-        if (input.kind !== "notification" && input.kind !== "decision_request") {
+        if (!NOTIFICATION_ATTENTION_KINDS.includes(input.kind) && !PROMPT_ATTENTION_KINDS.includes(input.kind)) {
           throw new Error(`Unsupported user_attention kind: ${String(input.kind)}`);
         }
         assertNonEmpty(input.userContent, "userContent");
-        if (input.kind === "decision_request") {
+        if (PROMPT_ATTENTION_KINDS.includes(input.kind)) {
           assertNonEmpty(input.llmContent ?? "", "llmContent");
         }
         const provider = normalizeOptionalProvider(input.provider);
@@ -1120,8 +1151,8 @@ var init_session_store = __esm({
           }
           const id = this.idFactory();
           const createdAt = this.timestamp();
-          if (input.kind === "decision_request" && input.jobId) {
-            this.softDeleteDecisionRequestsForJob(input.jobId, createdAt);
+          if (PROMPT_ATTENTION_KINDS.includes(input.kind) && input.jobId) {
+            this.softDeletePromptAttentionForJob(input.jobId, createdAt);
           }
           const statement = input.idempotencyKey ? this.db.prepare(`
             INSERT OR IGNORE INTO user_attention (
@@ -1221,7 +1252,7 @@ var init_session_store = __esm({
         const watchFilter = buildWatchAttentionFilter(options);
         const decision = this.db.prepare(`
       SELECT * FROM user_attention
-      WHERE kind = 'decision_request'
+      WHERE kind IN ('decision_request', 'system_prompt')
         AND status = 'pending'
         AND seen = 0
         AND deleted_at IS NULL
@@ -1232,7 +1263,7 @@ var init_session_store = __esm({
     `).get(this.currentUnixSeconds(), ...watchFilter.values);
         const notifications = this.db.prepare(`
       SELECT * FROM user_attention
-      WHERE kind = 'notification'
+      WHERE kind IN ('notification', 'system_notification')
         AND status = 'pending'
         AND seen = 0
         AND deleted_at IS NULL
@@ -1463,7 +1494,7 @@ var init_session_store = __esm({
         const providerFilter = conditions.length > 0 ? `AND ${conditions.join(" AND ")}` : "";
         const rows = this.db.prepare(`
       SELECT * FROM user_attention
-      WHERE kind = 'decision_request'
+      WHERE kind IN ('decision_request', 'system_prompt')
         AND status = 'pending'
         AND seen = 1
         AND deleted_at IS NULL
@@ -1641,11 +1672,14 @@ var init_session_store = __esm({
         const row = this.db.prepare("SELECT * FROM user_attention WHERE id = ?").get(id);
         return row ? mapAttentionRow(row) : null;
       }
-      softDeleteDecisionRequestsForJob(jobId, deletedAt) {
+      // The task state machine allows at most one live action per job, so a new
+      // prompt-kind item (decision_request / system_prompt) supersedes every
+      // pending prompt for that job regardless of which side produced it.
+      softDeletePromptAttentionForJob(jobId, deletedAt) {
         this.db.prepare(`
       UPDATE user_attention
       SET deleted_at = ?, idempotency_key = NULL
-      WHERE kind = 'decision_request'
+      WHERE kind IN ('decision_request', 'system_prompt')
         AND job_id = ?
         AND deleted_at IS NULL
     `).run(deletedAt, jobId);
@@ -8300,7 +8334,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     client: {
       id: "gateway-client",
       displayName: "okx-a2a-node",
-      version: "0.1.6",
+      version: "0.1.7-beta-482acfaf84-260707171501",
       platform: "node",
       mode: "backend",
       instanceId
@@ -8311,7 +8345,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     commands: [],
     permissions: {},
     locale: Intl.DateTimeFormat().resolvedOptions().locale || "en-US",
-    userAgent: `okx-a2a-node/${"0.1.6"}`,
+    userAgent: `okx-a2a-node/${"0.1.7-beta-482acfaf84-260707171501"}`,
     auth: {
       ...config.token ? { token: config.token } : {},
       ...config.password ? { password: config.password } : {}
@@ -24920,7 +24954,7 @@ var init_outbound_behavior = __esm({
       }
       async dispatchUser(input) {
         const item = this.store.createUserAttention({
-          kind: "notification",
+          kind: input.kind ?? "notification",
           provider: this.provider,
           userContent: input.userContent,
           jobId: input.jobId ?? null,
@@ -24933,7 +24967,7 @@ var init_outbound_behavior = __esm({
       }
       async promptUser(input) {
         const item = this.store.createUserAttention({
-          kind: "decision_request",
+          kind: input.kind ?? "decision_request",
           provider: this.provider,
           userContent: input.userContent,
           llmContent: input.llmContent,
@@ -25568,7 +25602,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.6",
+      release: "0.1.7-beta-482acfaf84-260707171501",
       environment
     };
   }
@@ -88078,6 +88112,45 @@ async function notifySystemMessageToUser(input) {
     ownedStore?.close();
   }
 }
+async function notifyDirectSystemMessageToUser(input) {
+  const ownedStore = input.store ? null : new SessionStore();
+  const store = input.store ?? ownedStore;
+  const idempotencyKey = input.idempotencyKey ?? buildDirectSystemMessageIdempotencyKey(input);
+  const llmContent = input.llmContent?.trim() || null;
+  try {
+    const provider = resolveOutboundProvider(store, {
+      jobId: input.jobId,
+      override: input.provider
+    });
+    const behavior = createOutboundBehavior(provider, { store });
+    const item = llmContent ? await behavior.promptUser({
+      kind: "system_prompt",
+      userContent: input.userContent,
+      llmContent,
+      jobId: input.jobId ?? null,
+      idempotencyKey
+    }) : await behavior.dispatchUser({
+      kind: "system_notification",
+      userContent: input.userContent,
+      jobId: input.jobId ?? null,
+      idempotencyKey
+    });
+    logWithTimestamp(
+      `[notifyDirectSystemMessageToUser] provider=${provider} kind=${llmContent ? "system_prompt" : "system_notification"} job=${input.jobId ?? "(none)"} item=${item?.id ?? "(gateway)"}`
+    );
+    return item;
+  } finally {
+    ownedStore?.close();
+  }
+}
+function buildDirectSystemMessageIdempotencyKey(input) {
+  const identity3 = input.messageId || stableHash([
+    input.jobId ?? "",
+    input.userContent,
+    input.llmContent ?? ""
+  ].join("\n"));
+  return `system-direct:${identity3}`;
+}
 function buildAgentMessageIdempotencyKey(input) {
   const identity3 = input.messageId || stableHash([
     input.direction,
@@ -92603,7 +92676,8 @@ function extractSystemNotification(payload) {
   }
   const message = isPlainObject3(payload.message) ? payload.message : null;
   const isDirectCommunication = message?.isDirectCommunication === true;
-  if (message?.source !== "system" && !isDirectCommunication) {
+  const isDirectToUser = message?.isDirectToUser === true;
+  if (message?.source !== "system" && !isDirectCommunication && !isDirectToUser) {
     return null;
   }
   return {
@@ -92612,7 +92686,10 @@ function extractSystemNotification(payload) {
     providerAgentId: readString3(message.providerAgentId),
     clientAgentId: readString3(message.clientAgentId),
     event: readString3(message.event),
-    isDirectCommunication
+    isDirectCommunication,
+    isDirectToUser,
+    userContent: readString3(message.userContent),
+    llmContent: readString3(message.llmContent)
   };
 }
 function resolveDirectCommunicationSessionTarget(notification) {
@@ -93219,6 +93296,85 @@ ${failureMessage}`,
   }
   return true;
 }
+function processDirectToUserSystemNotification(params) {
+  const { deps, notification, messageId, timing } = params;
+  const notificationAgentId = notification.agentId ?? void 0;
+  const attentionKind = notification.llmContent ? "system_prompt" : "system_notification";
+  if (!notification.userContent) {
+    logger.info(LogEvent.DM_FALLBACK_TO_BACKUP, {
+      ...agentExtras({ walletAddress: deps.myXmtpAddress, onchainosAgentId: notificationAgentId }),
+      taskId: notification.jobId ?? "",
+      messageId,
+      systemEvent: notification.event ?? "",
+      stage: "inbound/payload_parse",
+      reason: "direct_to_user_missing_user_content"
+    });
+    logWithTimestamp(
+      `[okx-agent-task:${deps.myXmtpAddress}] direct-to-user system DM missing userContent, falling back to AI session routing message=${shortenLogValue(messageId)}`
+    );
+    return false;
+  }
+  const userContent = notification.userContent;
+  const providerBindStartedAt = Date.now();
+  const providerGate = bindMessageJobProviderToCurrentDefault(deps, notification.jobId, "system-direct-user");
+  timing.mark("providerBind", providerBindStartedAt);
+  if (!providerGate.allowed) {
+    return true;
+  }
+  logger.info(LogEvent.SYSTEM_NOTIFICATION_RECEIVED, {
+    ...agentExtras({ walletAddress: deps.myXmtpAddress, onchainosAgentId: notificationAgentId }),
+    taskId: notification.jobId ?? "",
+    agentId: notification.agentId ?? "",
+    providerAgentId: notification.providerAgentId ?? "",
+    clientAgentId: notification.clientAgentId ?? "",
+    messageId,
+    systemEvent: notification.event ?? "",
+    stage: "inbound/system_notification_received",
+    isDirectToUser: "true",
+    attentionKind,
+    providerBinding: providerGate.provider ?? "",
+    providerBindingCreated: String(providerGate.created)
+  });
+  const dispatchStartedAt = Date.now();
+  void notifyDirectSystemMessageToUser({
+    userContent,
+    llmContent: notification.llmContent ?? null,
+    jobId: notification.jobId ?? null,
+    messageId,
+    store: deps.sessionStore
+  }).then(() => {
+    timing.mark("userDispatch", dispatchStartedAt);
+    logger.info(LogEvent.SYSTEM_NOTIFICATION_ROUTED, timing.extras({
+      ...agentExtras({ walletAddress: deps.myXmtpAddress, onchainosAgentId: notificationAgentId }),
+      taskId: notification.jobId ?? "",
+      agentId: notification.agentId ?? "",
+      messageId,
+      route: "system/direct-user",
+      systemEvent: notification.event ?? "",
+      stage: "inbound/system_direct_user_delivered",
+      isDirectToUser: "true",
+      attentionKind
+    }));
+  }).catch((err2) => {
+    logger.error(LogEvent.USER_DISPATCH_FAILED, err2 instanceof Error ? err2 : new Error(String(err2)), {
+      ...agentExtras({ walletAddress: deps.myXmtpAddress, onchainosAgentId: notificationAgentId }),
+      taskId: notification.jobId ?? "",
+      messageId,
+      systemEvent: notification.event ?? "",
+      stage: "inbound/system_direct_user_delivery",
+      isDirectToUser: "true",
+      attentionKind
+    });
+    logWithTimestamp(
+      `[okx-agent-task:${deps.myXmtpAddress}] direct-to-user delivery failed message=${shortenLogValue(messageId)}:`,
+      err2
+    );
+  });
+  logWithTimestamp(
+    `[okx-agent-task:${deps.myXmtpAddress}] direct-to-user delivery queued kind=${attentionKind} job=${shortenLogValue(notification.jobId ?? "(none)")} message=${shortenLogValue(messageId)}`
+  );
+  return true;
+}
 async function processFileMessage(ctx, deps, options = {}) {
   const messageId = ctx.message.id ?? "";
   const timing = createInboundTimingTracker(extractXmtpSentAtMs2(ctx.message));
@@ -93271,6 +93427,14 @@ async function processFileMessage(ctx, deps, options = {}) {
       );
       return true;
     }
+    if (systemNotification.isDirectToUser && processDirectToUserSystemNotification({
+      deps,
+      notification: systemNotification,
+      messageId: systemMessageId,
+      timing
+    })) {
+      return true;
+    }
     const directTarget = resolveDirectCommunicationSessionTarget(systemNotification);
     if (systemNotification.isDirectCommunication && !directTarget) {
       logger.error(
@@ -94086,12 +94250,12 @@ async function runListenerWithLock(options, paths) {
       }));
     }
   });
-  service.setPluginVersion("0.1.6");
+  service.setPluginVersion("0.1.7-beta-482acfaf84-260707171501");
   await service.init();
   const pluginVersionStatus = service.pluginVersionStatus;
   if (pluginVersionStatus.unavailable) {
     throw new Error(
-      `@okxweb3/a2a-node v${"0.1.6"} is below the required minimum v${pluginVersionStatus.minVersion}`
+      `@okxweb3/a2a-node v${"0.1.7-beta-482acfaf84-260707171501"} is below the required minimum v${pluginVersionStatus.minVersion}`
     );
   }
   const systemConfig = service.getSystemConfig();
@@ -94109,7 +94273,7 @@ async function runListenerWithLock(options, paths) {
       onchainosAgentId: "*",
       reason: "system-config missing sentryDsn",
       pluginId: "@okxweb3/a2a-node",
-      pluginVersion: "0.1.6"
+      pluginVersion: "0.1.7-beta-482acfaf84-260707171501"
     });
   }
   logWithTimestamp(
@@ -98130,7 +98294,7 @@ async function getCurrentNodeCliVersion() {
   return await getGlobalNpmPackageVersion(UPDATE_PACKAGES.node) ?? getBundledNodeCliVersion();
 }
 function getBundledNodeCliVersion() {
-  return true ? "0.1.6" : null;
+  return true ? "0.1.7-beta-482acfaf84-260707171501" : null;
 }
 function readConfiguredAiProvider() {
   const explicit = process.env.OKX_A2A_AI_PROVIDER || process.env.OKX_AGENT_TASK_AI_CLI;
@@ -98340,7 +98504,7 @@ async function updateHermes(release, options) {
   }
 }
 async function installGatewayPluginForDoctor(target) {
-  const release = isPrereleaseVersion("0.1.6") ? "beta" : "latest";
+  const release = isPrereleaseVersion("0.1.7-beta-482acfaf84-260707171501") ? "beta" : "latest";
   const insideTargetGateway = detectGatewayInvocation() === target;
   const options = {
     restart: !insideTargetGateway,
@@ -99225,7 +99389,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.6" : "0.0.0"),
+    cliVersion: options.cliVersion ?? (true ? "0.1.7-beta-482acfaf84-260707171501" : "0.0.0"),
     fixMode: options.fix === true,
     nonInteractive: options.nonInteractive === true,
     packageChanged: false
@@ -100318,7 +100482,7 @@ init_sentry_logger();
 init_sentry_config();
 var CURRENT_GATEWAY_SESSION_KEYS_ENV4 = "OKX_A2A_CURRENT_GATEWAY_SESSION_KEYS";
 function printUsage2() {
-  console.log(`okx-a2a ${"0.1.6"}
+  console.log(`okx-a2a ${"0.1.7-beta-482acfaf84-260707171501"}
 
 Usage:
   okx-a2a <command> [options]
@@ -100356,7 +100520,7 @@ Run \`okx-a2a <command> -h\` for command-specific help.
 `);
 }
 function printVersion() {
-  console.log("0.1.6");
+  console.log("0.1.7-beta-482acfaf84-260707171501");
 }
 function printDaemonUsage() {
   console.log(`Usage: okx-a2a daemon <start|restart|stop|status|autostart> [options]

package/dist/index.js

@@ -593,7 +593,7 @@ function readTextArray(value) {
   });
   return normalizeGatewayRouteAliases(values);
 }
-var import_node_crypto, import_node_fs2, import_node_path3, DatabaseSync, SYSTEM_NOTIFICATION_SESSION_KEY, AI_PROVIDER_COMMAND_SETTING_PREFIX, SessionStore;
+var import_node_crypto, import_node_fs2, import_node_path3, DatabaseSync, SYSTEM_NOTIFICATION_SESSION_KEY, NOTIFICATION_ATTENTION_KINDS, PROMPT_ATTENTION_KINDS, AI_PROVIDER_COMMAND_SETTING_PREFIX, SessionStore;
 var init_session_store = __esm({
   "src/session-store.ts"() {
     "use strict";
@@ -603,6 +603,8 @@ var init_session_store = __esm({
     init_paths();
     ({ DatabaseSync } = loadSqlite());
     SYSTEM_NOTIFICATION_SESSION_KEY = "system-notification";
+    NOTIFICATION_ATTENTION_KINDS = ["notification", "system_notification"];
+    PROMPT_ATTENTION_KINDS = ["decision_request", "system_prompt"];
     AI_PROVIDER_COMMAND_SETTING_PREFIX = "ai_provider_command_";
     SessionStore = class {
       homeDir;
@@ -664,34 +666,11 @@ var init_session_store = __esm({
       CREATE INDEX IF NOT EXISTS idx_session_metadata_job_agents
       ON session_metadata(job_id, my_agent_id, to_agent_id)
     `);
-        this.db.exec(`
-      CREATE TABLE IF NOT EXISTS user_attention (
-        id TEXT PRIMARY KEY,
-        kind TEXT NOT NULL CHECK (kind IN ('notification', 'decision_request')),
-        provider TEXT CHECK (provider IN ('codex', 'claude', 'hermes', 'openclaw') OR provider IS NULL),
-        status TEXT NOT NULL CHECK (status IN ('pending', 'handled')),
-        job_id TEXT,
-        session_key TEXT,
-        llm_content TEXT,
-        choices_json TEXT,
-        user_content TEXT NOT NULL,
-        idempotency_key TEXT UNIQUE,
-        expire_time INTEGER,
-        created_at TEXT NOT NULL,
-        handled_at TEXT,
-        deleted_at TEXT,
-        seen INTEGER NOT NULL DEFAULT 0 CHECK (seen IN (0, 1))
-      )
-    `);
+        this.ensureUserAttentionSchema();
         this.db.exec(`
       CREATE INDEX IF NOT EXISTS idx_user_attention_status_created
       ON user_attention(status, created_at)
     `);
-        this.ensureColumn("user_attention", "choices_json", "TEXT");
-        this.ensureColumn("user_attention", "deleted_at", "TEXT");
-        this.ensureColumn("user_attention", "seen", "INTEGER NOT NULL DEFAULT 0");
-        this.ensureColumn("user_attention", "provider", "TEXT CHECK (provider IN ('codex', 'claude', 'hermes', 'openclaw') OR provider IS NULL)");
-        this.ensureColumn("user_attention", "expire_time", "INTEGER");
         this.db.exec(`
       CREATE INDEX IF NOT EXISTS idx_user_attention_provider_status_created
       ON user_attention(provider, status, created_at)
@@ -757,6 +736,58 @@ var init_session_store = __esm({
       CREATE INDEX IF NOT EXISTS idx_pending_gateway_deliveries_provider_created
       ON pending_gateway_deliveries(provider, created_at)
     `);
+      }
+      ensureUserAttentionSchema() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS user_attention (
+        ${this.userAttentionTableColumnsSql()}
+      )
+    `);
+        this.ensureColumn("user_attention", "choices_json", "TEXT");
+        this.ensureColumn("user_attention", "deleted_at", "TEXT");
+        this.ensureColumn("user_attention", "seen", "INTEGER NOT NULL DEFAULT 0");
+        this.ensureColumn("user_attention", "provider", "TEXT CHECK (provider IN ('codex', 'claude', 'hermes', 'openclaw') OR provider IS NULL)");
+        this.ensureColumn("user_attention", "expire_time", "INTEGER");
+        const row = this.db.prepare("SELECT sql FROM sqlite_master WHERE type='table' AND name='user_attention'").get();
+        if (row?.sql?.includes("system_notification") && row.sql.includes("system_prompt")) {
+          return;
+        }
+        this.db.exec("ALTER TABLE user_attention RENAME TO user_attention_old");
+        this.db.exec(`
+      CREATE TABLE user_attention (
+        ${this.userAttentionTableColumnsSql()}
+      )
+    `);
+        this.db.exec(`
+      INSERT INTO user_attention (
+        id, kind, provider, status, job_id, session_key, llm_content, choices_json,
+        user_content, idempotency_key, expire_time, created_at, handled_at, deleted_at, seen
+      )
+      SELECT
+        id, kind, provider, status, job_id, session_key, llm_content, choices_json,
+        user_content, idempotency_key, expire_time, created_at, handled_at, deleted_at, seen
+      FROM user_attention_old
+    `);
+        this.db.exec("DROP TABLE user_attention_old");
+      }
+      userAttentionTableColumnsSql() {
+        return `
+        id TEXT PRIMARY KEY,
+        kind TEXT NOT NULL CHECK (kind IN ('notification', 'decision_request', 'system_notification', 'system_prompt')),
+        provider TEXT CHECK (provider IN ('codex', 'claude', 'hermes', 'openclaw') OR provider IS NULL),
+        status TEXT NOT NULL CHECK (status IN ('pending', 'handled')),
+        job_id TEXT,
+        session_key TEXT,
+        llm_content TEXT,
+        choices_json TEXT,
+        user_content TEXT NOT NULL,
+        idempotency_key TEXT UNIQUE,
+        expire_time INTEGER,
+        created_at TEXT NOT NULL,
+        handled_at TEXT,
+        deleted_at TEXT,
+        seen INTEGER NOT NULL DEFAULT 0 CHECK (seen IN (0, 1))
+    `;
       }
       ensurePendingGatewayDeliveriesSchema() {
         const expectedKindCheck = this.pendingGatewayDeliveryKindCheck();
@@ -1101,11 +1132,11 @@ var init_session_store = __esm({
         return rows.map(mapJobProviderBindingRow);
       }
       createUserAttention(input) {
-        if (input.kind !== "notification" && input.kind !== "decision_request") {
+        if (!NOTIFICATION_ATTENTION_KINDS.includes(input.kind) && !PROMPT_ATTENTION_KINDS.includes(input.kind)) {
           throw new Error(`Unsupported user_attention kind: ${String(input.kind)}`);
         }
         assertNonEmpty(input.userContent, "userContent");
-        if (input.kind === "decision_request") {
+        if (PROMPT_ATTENTION_KINDS.includes(input.kind)) {
           assertNonEmpty(input.llmContent ?? "", "llmContent");
         }
         const provider = normalizeOptionalProvider(input.provider);
@@ -1120,8 +1151,8 @@ var init_session_store = __esm({
           }
           const id = this.idFactory();
           const createdAt = this.timestamp();
-          if (input.kind === "decision_request" && input.jobId) {
-            this.softDeleteDecisionRequestsForJob(input.jobId, createdAt);
+          if (PROMPT_ATTENTION_KINDS.includes(input.kind) && input.jobId) {
+            this.softDeletePromptAttentionForJob(input.jobId, createdAt);
           }
           const statement = input.idempotencyKey ? this.db.prepare(`
             INSERT OR IGNORE INTO user_attention (
@@ -1221,7 +1252,7 @@ var init_session_store = __esm({
         const watchFilter = buildWatchAttentionFilter(options);
         const decision = this.db.prepare(`
       SELECT * FROM user_attention
-      WHERE kind = 'decision_request'
+      WHERE kind IN ('decision_request', 'system_prompt')
         AND status = 'pending'
         AND seen = 0
         AND deleted_at IS NULL
@@ -1232,7 +1263,7 @@ var init_session_store = __esm({
     `).get(this.currentUnixSeconds(), ...watchFilter.values);
         const notifications = this.db.prepare(`
       SELECT * FROM user_attention
-      WHERE kind = 'notification'
+      WHERE kind IN ('notification', 'system_notification')
         AND status = 'pending'
         AND seen = 0
         AND deleted_at IS NULL
@@ -1463,7 +1494,7 @@ var init_session_store = __esm({
         const providerFilter = conditions.length > 0 ? `AND ${conditions.join(" AND ")}` : "";
         const rows = this.db.prepare(`
       SELECT * FROM user_attention
-      WHERE kind = 'decision_request'
+      WHERE kind IN ('decision_request', 'system_prompt')
         AND status = 'pending'
         AND seen = 1
         AND deleted_at IS NULL
@@ -1641,11 +1672,14 @@ var init_session_store = __esm({
         const row = this.db.prepare("SELECT * FROM user_attention WHERE id = ?").get(id);
         return row ? mapAttentionRow(row) : null;
       }
-      softDeleteDecisionRequestsForJob(jobId, deletedAt) {
+      // The task state machine allows at most one live action per job, so a new
+      // prompt-kind item (decision_request / system_prompt) supersedes every
+      // pending prompt for that job regardless of which side produced it.
+      softDeletePromptAttentionForJob(jobId, deletedAt) {
         this.db.prepare(`
       UPDATE user_attention
       SET deleted_at = ?, idempotency_key = NULL
-      WHERE kind = 'decision_request'
+      WHERE kind IN ('decision_request', 'system_prompt')
         AND job_id = ?
         AND deleted_at IS NULL
     `).run(deletedAt, jobId);
@@ -72344,7 +72378,7 @@ async function getCurrentNodeCliVersion() {
   return await getGlobalNpmPackageVersion(UPDATE_PACKAGES.node) ?? getBundledNodeCliVersion();
 }
 function getBundledNodeCliVersion() {
-  return true ? "0.1.6" : null;
+  return true ? "0.1.7-beta-482acfaf84-260707171501" : null;
 }
 function readConfiguredAiProvider() {
   const explicit = process.env.OKX_A2A_AI_PROVIDER || process.env.OKX_AGENT_TASK_AI_CLI;
@@ -72554,7 +72588,7 @@ async function updateHermes(release, options) {
   }
 }
 async function installGatewayPluginForDoctor(target) {
-  const release = isPrereleaseVersion("0.1.6") ? "beta" : "latest";
+  const release = isPrereleaseVersion("0.1.7-beta-482acfaf84-260707171501") ? "beta" : "latest";
   const insideTargetGateway = detectGatewayInvocation() === target;
   const options = {
     restart: !insideTargetGateway,
@@ -73422,12 +73456,14 @@ __export(index_exports, {
   normalizeAiProvider: () => normalizeAiProvider,
   normalizeHermesOkxA2aPluginConfig: () => normalizeHermesOkxA2aPluginConfig,
   notifyAgentMessageToUserAttention: () => notifyAgentMessageToUserAttention,
+  notifyDirectSystemMessageToUser: () => notifyDirectSystemMessageToUser,
   notifySystemMessageToUser: () => notifySystemMessageToUser,
   notifyUserAttentionChanged: () => notifyUserAttentionChanged,
   parsePluginYamlVersion: () => parsePluginYamlVersion,
   parseWindowsParentProcessJson: () => parseWindowsParentProcessJson,
   performRuntimeSwitch: () => performRuntimeSwitch,
   pickOnchainosWin32Candidate: () => pickOnchainosWin32Candidate,
+  processDirectToUserSystemNotification: () => processDirectToUserSystemNotification,
   processFileMessage: () => processFileMessage,
   readAiProviderTimeoutMs: () => readAiProviderTimeoutMs,
   readLastLines: () => readLastLines,
@@ -89404,7 +89440,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     client: {
       id: "gateway-client",
       displayName: "okx-a2a-node",
-      version: "0.1.6",
+      version: "0.1.7-beta-482acfaf84-260707171501",
       platform: "node",
       mode: "backend",
       instanceId
@@ -89415,7 +89451,7 @@ function buildConnectParams(config, instanceId, protocolVersion) {
     commands: [],
     permissions: {},
     locale: Intl.DateTimeFormat().resolvedOptions().locale || "en-US",
-    userAgent: `okx-a2a-node/${"0.1.6"}`,
+    userAgent: `okx-a2a-node/${"0.1.7-beta-482acfaf84-260707171501"}`,
     auth: {
       ...config.token ? { token: config.token } : {},
       ...config.password ? { password: config.password } : {}
@@ -89971,7 +90007,7 @@ var SqliteOutboundBehavior = class {
   }
   async dispatchUser(input) {
     const item = this.store.createUserAttention({
-      kind: "notification",
+      kind: input.kind ?? "notification",
       provider: this.provider,
       userContent: input.userContent,
       jobId: input.jobId ?? null,
@@ -89984,7 +90020,7 @@ var SqliteOutboundBehavior = class {
   }
   async promptUser(input) {
     const item = this.store.createUserAttention({
-      kind: "decision_request",
+      kind: input.kind ?? "decision_request",
       provider: this.provider,
       userContent: input.userContent,
       llmContent: input.llmContent,
@@ -90681,6 +90717,45 @@ async function notifySystemMessageToUser(input) {
     ownedStore?.close();
   }
 }
+async function notifyDirectSystemMessageToUser(input) {
+  const ownedStore = input.store ? null : new SessionStore();
+  const store = input.store ?? ownedStore;
+  const idempotencyKey = input.idempotencyKey ?? buildDirectSystemMessageIdempotencyKey(input);
+  const llmContent = input.llmContent?.trim() || null;
+  try {
+    const provider = resolveOutboundProvider(store, {
+      jobId: input.jobId,
+      override: input.provider
+    });
+    const behavior = createOutboundBehavior(provider, { store });
+    const item = llmContent ? await behavior.promptUser({
+      kind: "system_prompt",
+      userContent: input.userContent,
+      llmContent,
+      jobId: input.jobId ?? null,
+      idempotencyKey
+    }) : await behavior.dispatchUser({
+      kind: "system_notification",
+      userContent: input.userContent,
+      jobId: input.jobId ?? null,
+      idempotencyKey
+    });
+    logWithTimestamp(
+      `[notifyDirectSystemMessageToUser] provider=${provider} kind=${llmContent ? "system_prompt" : "system_notification"} job=${input.jobId ?? "(none)"} item=${item?.id ?? "(gateway)"}`
+    );
+    return item;
+  } finally {
+    ownedStore?.close();
+  }
+}
+function buildDirectSystemMessageIdempotencyKey(input) {
+  const identity3 = input.messageId || stableHash2([
+    input.jobId ?? "",
+    input.userContent,
+    input.llmContent ?? ""
+  ].join("\n"));
+  return `system-direct:${identity3}`;
+}
 function buildAgentMessageIdempotencyKey(input) {
   const identity3 = input.messageId || stableHash2([
     input.direction,
@@ -92526,7 +92601,8 @@ function extractSystemNotification(payload) {
   }
   const message = isPlainObject3(payload.message) ? payload.message : null;
   const isDirectCommunication = message?.isDirectCommunication === true;
-  if (message?.source !== "system" && !isDirectCommunication) {
+  const isDirectToUser = message?.isDirectToUser === true;
+  if (message?.source !== "system" && !isDirectCommunication && !isDirectToUser) {
     return null;
   }
   return {
@@ -92535,7 +92611,10 @@ function extractSystemNotification(payload) {
     providerAgentId: readString3(message.providerAgentId),
     clientAgentId: readString3(message.clientAgentId),
     event: readString3(message.event),
-    isDirectCommunication
+    isDirectCommunication,
+    isDirectToUser,
+    userContent: readString3(message.userContent),
+    llmContent: readString3(message.llmContent)
   };
 }
 function resolveDirectCommunicationSessionTarget(notification) {
@@ -93142,6 +93221,85 @@ ${failureMessage}`,
   }
   return true;
 }
+function processDirectToUserSystemNotification(params) {
+  const { deps, notification, messageId, timing } = params;
+  const notificationAgentId = notification.agentId ?? void 0;
+  const attentionKind = notification.llmContent ? "system_prompt" : "system_notification";
+  if (!notification.userContent) {
+    logger.info(LogEvent.DM_FALLBACK_TO_BACKUP, {
+      ...agentExtras({ walletAddress: deps.myXmtpAddress, onchainosAgentId: notificationAgentId }),
+      taskId: notification.jobId ?? "",
+      messageId,
+      systemEvent: notification.event ?? "",
+      stage: "inbound/payload_parse",
+      reason: "direct_to_user_missing_user_content"
+    });
+    logWithTimestamp(
+      `[okx-agent-task:${deps.myXmtpAddress}] direct-to-user system DM missing userContent, falling back to AI session routing message=${shortenLogValue(messageId)}`
+    );
+    return false;
+  }
+  const userContent = notification.userContent;
+  const providerBindStartedAt = Date.now();
+  const providerGate = bindMessageJobProviderToCurrentDefault(deps, notification.jobId, "system-direct-user");
+  timing.mark("providerBind", providerBindStartedAt);
+  if (!providerGate.allowed) {
+    return true;
+  }
+  logger.info(LogEvent.SYSTEM_NOTIFICATION_RECEIVED, {
+    ...agentExtras({ walletAddress: deps.myXmtpAddress, onchainosAgentId: notificationAgentId }),
+    taskId: notification.jobId ?? "",
+    agentId: notification.agentId ?? "",
+    providerAgentId: notification.providerAgentId ?? "",
+    clientAgentId: notification.clientAgentId ?? "",
+    messageId,
+    systemEvent: notification.event ?? "",
+    stage: "inbound/system_notification_received",
+    isDirectToUser: "true",
+    attentionKind,
+    providerBinding: providerGate.provider ?? "",
+    providerBindingCreated: String(providerGate.created)
+  });
+  const dispatchStartedAt = Date.now();
+  void notifyDirectSystemMessageToUser({
+    userContent,
+    llmContent: notification.llmContent ?? null,
+    jobId: notification.jobId ?? null,
+    messageId,
+    store: deps.sessionStore
+  }).then(() => {
+    timing.mark("userDispatch", dispatchStartedAt);
+    logger.info(LogEvent.SYSTEM_NOTIFICATION_ROUTED, timing.extras({
+      ...agentExtras({ walletAddress: deps.myXmtpAddress, onchainosAgentId: notificationAgentId }),
+      taskId: notification.jobId ?? "",
+      agentId: notification.agentId ?? "",
+      messageId,
+      route: "system/direct-user",
+      systemEvent: notification.event ?? "",
+      stage: "inbound/system_direct_user_delivered",
+      isDirectToUser: "true",
+      attentionKind
+    }));
+  }).catch((err2) => {
+    logger.error(LogEvent.USER_DISPATCH_FAILED, err2 instanceof Error ? err2 : new Error(String(err2)), {
+      ...agentExtras({ walletAddress: deps.myXmtpAddress, onchainosAgentId: notificationAgentId }),
+      taskId: notification.jobId ?? "",
+      messageId,
+      systemEvent: notification.event ?? "",
+      stage: "inbound/system_direct_user_delivery",
+      isDirectToUser: "true",
+      attentionKind
+    });
+    logWithTimestamp(
+      `[okx-agent-task:${deps.myXmtpAddress}] direct-to-user delivery failed message=${shortenLogValue(messageId)}:`,
+      err2
+    );
+  });
+  logWithTimestamp(
+    `[okx-agent-task:${deps.myXmtpAddress}] direct-to-user delivery queued kind=${attentionKind} job=${shortenLogValue(notification.jobId ?? "(none)")} message=${shortenLogValue(messageId)}`
+  );
+  return true;
+}
 async function processFileMessage(ctx, deps, options = {}) {
   const messageId = ctx.message.id ?? "";
   const timing = createInboundTimingTracker(extractXmtpSentAtMs2(ctx.message));
@@ -93194,6 +93352,14 @@ async function processFileMessage(ctx, deps, options = {}) {
       );
       return true;
     }
+    if (systemNotification.isDirectToUser && processDirectToUserSystemNotification({
+      deps,
+      notification: systemNotification,
+      messageId: systemMessageId,
+      timing
+    })) {
+      return true;
+    }
     const directTarget = resolveDirectCommunicationSessionTarget(systemNotification);
     if (systemNotification.isDirectCommunication && !directTarget) {
       logger.error(
@@ -93886,7 +94052,7 @@ init_ai_provider();
 var environment = process.env.SENTRY_ENV === "dev" ? "dev" : "prod";
 var SENTRY_CONFIG = {
   projectName: "okx/openclaw-okx-a2a-extension",
-  release: "0.1.6",
+  release: "0.1.7-beta-482acfaf84-260707171501",
   environment
 };
 
@@ -94124,12 +94290,12 @@ async function runListenerWithLock(options, paths) {
       }));
     }
   });
-  service.setPluginVersion("0.1.6");
+  service.setPluginVersion("0.1.7-beta-482acfaf84-260707171501");
   await service.init();
   const pluginVersionStatus = service.pluginVersionStatus;
   if (pluginVersionStatus.unavailable) {
     throw new Error(
-      `@okxweb3/a2a-node v${"0.1.6"} is below the required minimum v${pluginVersionStatus.minVersion}`
+      `@okxweb3/a2a-node v${"0.1.7-beta-482acfaf84-260707171501"} is below the required minimum v${pluginVersionStatus.minVersion}`
     );
   }
   const systemConfig = service.getSystemConfig();
@@ -94147,7 +94313,7 @@ async function runListenerWithLock(options, paths) {
       onchainosAgentId: "*",
       reason: "system-config missing sentryDsn",
       pluginId: "@okxweb3/a2a-node",
-      pluginVersion: "0.1.6"
+      pluginVersion: "0.1.7-beta-482acfaf84-260707171501"
     });
   }
   logWithTimestamp(
@@ -95884,7 +96050,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.6" : "0.0.0"),
+    cliVersion: options.cliVersion ?? (true ? "0.1.7-beta-482acfaf84-260707171501" : "0.0.0"),
     fixMode: options.fix === true,
     nonInteractive: options.nonInteractive === true,
     packageChanged: false
@@ -96192,12 +96358,14 @@ init_win_native_launcher();
   normalizeAiProvider,
   normalizeHermesOkxA2aPluginConfig,
   notifyAgentMessageToUserAttention,
+  notifyDirectSystemMessageToUser,
   notifySystemMessageToUser,
   notifyUserAttentionChanged,
   parsePluginYamlVersion,
   parseWindowsParentProcessJson,
   performRuntimeSwitch,
   pickOnchainosWin32Candidate,
+  processDirectToUserSystemNotification,
   processFileMessage,
   readAiProviderTimeoutMs,
   readLastLines,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@okxweb3/a2a-node",
-  "version": "0.1.6",
+  "version": "0.1.7-beta-482acfaf84-260707171501",
   "description": "Host-agnostic Node CLI for E2E encrypted agent-to-agent communication via XMTP",
   "main": "dist/index.js",
   "bin": {