@ynhcj/xiaoyi-channel 0.0.35-beta → 0.0.35-next

package/dist/src/outbound.js

@@ -1,6 +1,9 @@
 import { resolveXYConfig } from "./config.js";
+import { XYFileUploadService } from "./file-upload.js";
 import { XYPushService } from "./push.js";
 import { getCurrentSessionContext } from "./tools/session-manager.js";
+import { savePushData } from "./utils/pushdata-manager.js";
+import { getAllPushIds } from "./utils/pushid-manager.js";
 // Special marker for default push delivery when no target is specified
 const DEFAULT_PUSH_MARKER = "default";
 // File extension to MIME type mapping
@@ -87,13 +90,6 @@ export const xyOutbound = {
         };
     },
     sendText: async ({ cfg, to, text, accountId }) => {
-        // Log parameters
-        console.log(`[xyOutbound.sendText] Called with:`, {
-            to,
-            accountId,
-            textLength: text?.length || 0,
-            textPreview: text?.slice(0, 100),
-        });
         // Resolve configuration
         const config = resolveXYConfig(cfg);
         // Handle default push marker (for cron jobs without explicit target)
@@ -104,119 +100,139 @@ export const xyOutbound = {
             // The push service will handle it based on config
             actualTo = config.defaultSessionId || "";
         }
+        // 1. 持久化推送消息内容，获取 pushDataId
+        console.log(`[xyOutbound.sendText] Saving push data to local storage...`);
+        let pushDataId;
+        try {
+            pushDataId = await savePushData(text);
+            console.log(`[xyOutbound.sendText] ✅ Push data saved with ID: ${pushDataId.substring(0, 20)}`);
+        }
+        catch (error) {
+            console.error(`[xyOutbound.sendText] ❌ Failed to save push data:`, error);
+            // 如果持久化失败，仍然继续发送（不阻塞主流程）
+            pushDataId = "";
+        }
+        // 2. 读取所有 pushId
+        console.log(`[xyOutbound.sendText] Loading all pushIds...`);
+        let pushIdList = [];
+        try {
+            pushIdList = await getAllPushIds();
+            console.log(`[xyOutbound.sendText] ✅ Loaded ${pushIdList.length} pushIds`);
+        }
+        catch (error) {
+            console.error(`[xyOutbound.sendText] ❌ Failed to load pushIds:`, error);
+        }
+        // 3. 如果 pushIdList 为空，回退到原有逻辑（使用 config pushId）
+        if (pushIdList.length === 0) {
+            console.log(`[xyOutbound.sendText] ⚠️ No pushIds found, falling back to config pushId`);
+            pushIdList = [config.pushId];
+        }
         // Create push service
         const pushService = new XYPushService(config);
         // Extract title (first 57 chars or first line)
         const title = text.split("\n")[0].slice(0, 57);
         // Truncate push content to max length 1000
         const pushText = text.length > 1000 ? text.slice(0, 1000) : text;
-        // Send push message (content, title, data, sessionId)
-        await pushService.sendPush(pushText, title, undefined, actualTo);
-        console.log(`[xyOutbound.sendText] Completed successfully`);
+        // 4. 遍历所有 pushId，依次发送推送通知
+        console.log(`[xyOutbound.sendText] 📤 Broadcasting to ${pushIdList.length} pushId(s)...`);
+        let successCount = 0;
+        let failureCount = 0;
+        for (const pushId of pushIdList) {
+            try {
+                // 传入 pushId 和 pushDataId，使用 kind="data" 格式
+                await pushService.sendPush(pushText, title, undefined, actualTo, pushDataId, pushId);
+                successCount++;
+                console.log(`[xyOutbound.sendText] ✅ Sent successfully to pushId: ${pushId.substring(0, 20)}...`);
+            }
+            catch (error) {
+                failureCount++;
+                console.error(`[xyOutbound.sendText] ❌ Failed to send to pushId: ${pushId.substring(0, 20)}...`, error);
+                // 单个 pushId 发送失败不影响其他，继续处理下一个
+            }
+        }
         // Return message info
         return {
             channel: "xiaoyi-channel",
-            messageId: Date.now().toString(),
+            messageId: pushDataId || Date.now().toString(),
             chatId: actualTo,
         };
     },
     sendMedia: async ({ cfg, to, text, mediaUrl, accountId, mediaLocalRoots }) => {
-        // Log parameters
-        console.log(`[xyOutbound.sendMedia] Called with:`, {
-            to,
-            accountId,
-            text,
-            mediaUrl,
-            mediaLocalRoots,
+        // Parse to: "sessionId::taskId"
+        const parts = to.split("::");
+        if (parts.length !== 2) {
+            throw new Error(`Invalid to format: "${to}". Expected "sessionId::taskId"`);
+        }
+        const [sessionId, taskId] = parts;
+        // Resolve configuration
+        const config = resolveXYConfig(cfg);
+        // Create upload service
+        const uploadService = new XYFileUploadService(config.fileUploadUrl, config.apiKey, config.uid);
+        // Validate mediaUrl
+        if (!mediaUrl) {
+            throw new Error("mediaUrl is required for sendMedia");
+        }
+        // Upload file
+        const fileId = await uploadService.uploadFile(mediaUrl);
+        // Check if fileId is empty
+        if (!fileId) {
+            console.log(`[xyOutbound.sendMedia] ⚠️ File upload failed: fileId is empty, aborting sendMedia`);
+            return {
+                channel: "xiaoyi-channel",
+                messageId: "",
+                chatId: to,
+            };
+        }
+        console.log(`[xyOutbound.sendMedia] File uploaded:`, {
+            fileId,
+            sessionId,
+            taskId,
         });
-        // All sendMedia processing logic has been disabled
-        // Use send_file_to_user tool instead for file transfers to user device
-        console.log(`[xyOutbound.sendMedia] Processing disabled, use send_file_to_user tool`);
-        // Return empty message info
+        // Get filename and mime type from mediaUrl
+        // mediaUrl may be a local file path or URL
+        const fileName = mediaUrl.split("/").pop() || "unknown";
+        const mimeType = getMimeTypeFromFilename(fileName);
+        // Build agent_response message
+        const agentResponse = {
+            msgType: "agent_response",
+            agentId: config.agentId,
+            sessionId: sessionId,
+            taskId: taskId,
+            msgDetail: JSON.stringify({
+                jsonrpc: "2.0",
+                id: taskId,
+                result: {
+                    kind: "artifact-update",
+                    append: true,
+                    lastChunk: false,
+                    final: false,
+                    artifact: {
+                        artifactId: taskId,
+                        parts: [
+                            {
+                                kind: "file",
+                                file: {
+                                    name: fileName,
+                                    mimeType: mimeType,
+                                    fileId: fileId,
+                                },
+                            },
+                        ],
+                    },
+                },
+                error: { code: 0 },
+            }),
+        };
+        // Get WebSocket manager and send message
+        const { getXYWebSocketManager } = await import("./client.js");
+        const wsManager = getXYWebSocketManager(config);
+        await wsManager.sendMessage(sessionId, agentResponse);
+        console.log(`[xyOutbound.sendMedia] WebSocket message sent successfully`);
+        // Return message info
         return {
             channel: "xiaoyi-channel",
-            messageId: "",
+            messageId: fileId,
             chatId: to,
         };
-        // // Parse to: "sessionId::taskId"
-        // const parts = to.split("::");
-        // if (parts.length !== 2) {
-        //   throw new Error(`Invalid to format: "${to}". Expected "sessionId::taskId"`);
-        // }
-        // const [sessionId, taskId] = parts;
-        // // Resolve configuration
-        // const config = resolveXYConfig(cfg);
-        // // Create upload service
-        // const uploadService = new XYFileUploadService(
-        //   config.fileUploadUrl,
-        //   config.apiKey,
-        //   config.uid
-        // );
-        // // Validate mediaUrl
-        // if (!mediaUrl) {
-        //   throw new Error("mediaUrl is required for sendMedia");
-        // }
-        // // Upload file
-        // const fileId = await uploadService.uploadFile(mediaUrl);
-        // // Check if fileId is empty
-        // if (!fileId) {
-        //   console.log(`[xyOutbound.sendMedia] ⚠️ File upload failed: fileId is empty, aborting sendMedia`);
-        //   return {
-        //     channel: "xiaoyi-channel",
-        //     messageId: "",
-        //     chatId: to,
-        //   };
-        // }
-        // console.log(`[xyOutbound.sendMedia] File uploaded:`, {
-        //   fileId,
-        //   sessionId,
-        //   taskId,
-        // });
-        // // Get filename and mime type from mediaUrl
-        // // mediaUrl may be a local file path or URL
-        // const fileName = mediaUrl.split("/").pop() || "unknown";
-        // const mimeType = getMimeTypeFromFilename(fileName);
-        // // Build agent_response message
-        // const agentResponse: OutboundWebSocketMessage = {
-        //   msgType: "agent_response",
-        //   agentId: config.agentId,
-        //   sessionId: sessionId,
-        //   taskId: taskId,
-        //   msgDetail: JSON.stringify({
-        //     jsonrpc: "2.0",
-        //     id: taskId,
-        //     result: {
-        //       kind: "artifact-update",
-        //       append: true,
-        //       lastChunk: false,
-        //       final: false,
-        //       artifact: {
-        //         artifactId: taskId,
-        //         parts: [
-        //           {
-        //             kind: "file",
-        //             file: {
-        //               name: fileName,
-        //               mimeType: mimeType,
-        //               fileId: fileId,
-        //             },
-        //           },
-        //         ],
-        //       },
-        //     },
-        //     error: { code: 0 },
-        //   }),
-        // };
-        // // Get WebSocket manager and send message
-        // const { getXYWebSocketManager } = await import("./client.js");
-        // const wsManager = getXYWebSocketManager(config);
-        // await wsManager.sendMessage(sessionId, agentResponse);
-        // console.log(`[xyOutbound.sendMedia] WebSocket message sent successfully`);
-        // // Return message info
-        // return {
-        //   channel: "xiaoyi-channel",
-        //   messageId: fileId,
-        //   chatId: to,
-        // };
     },
 };

package/dist/src/parser.d.ts

@@ -43,6 +43,13 @@ export declare function isTasksCancelMessage(method: string): boolean;
  * Looks for push_id in data parts under variables.systemVariables.push_id
  */
 export declare function extractPushId(parts: A2AMessagePart[]): string | null;
+/**
+ * Extract Trigger event data from message parts.
+ * Looks for Trigger events with pushDataId in data parts.
+ */
+export declare function extractTriggerData(parts: A2AMessagePart[]): {
+    pushDataId: string;
+} | null;
 /**
  * Validate A2A request structure.
  */

package/dist/src/parser.js

@@ -72,6 +72,28 @@ export function extractPushId(parts) {
     }
     return null;
 }
+/**
+ * Extract Trigger event data from message parts.
+ * Looks for Trigger events with pushDataId in data parts.
+ */
+export function extractTriggerData(parts) {
+    for (const part of parts) {
+        if (part.kind === "data" && part.data) {
+            const events = part.data.events;
+            if (Array.isArray(events)) {
+                for (const event of events) {
+                    if (event.header?.namespace === "Common" && event.header?.name === "Trigger") {
+                        const pushDataId = event.payload?.dataMap?.pushDataId;
+                        if (pushDataId && typeof pushDataId === "string") {
+                            return { pushDataId };
+                        }
+                    }
+                }
+            }
+        }
+    }
+    return null;
+}
 /**
  * Validate A2A request structure.
  */

package/dist/src/push.d.ts

@@ -14,8 +14,15 @@ export declare class XYPushService {
     private generateTraceId;
     /**
      * Send a push message to a user session.
+     *
+     * @param content - Push message content
+     * @param title - Push message title
+     * @param data - Optional additional data
+     * @param sessionId - Optional session ID
+     * @param pushDataId - Optional pushDataId for kind="data" format
+     * @param pushId - Push ID to use (required)
      */
-    sendPush(content: string, title: string, data?: Record<string, any>, sessionId?: string): Promise<void>;
+    sendPush(content: string, title: string, data?: Record<string, any>, sessionId?: string, pushDataId?: string, pushId?: string): Promise<void>;
     /**
      * Send a push message with file attachments.
      */

package/dist/src/push.js

@@ -1,7 +1,6 @@
 // Push message service for scheduled tasks
 import fetch from "node-fetch";
 import { randomUUID } from "crypto";
-import { configManager } from "./utils/config-manager.js";
 /**
  * Service for sending push messages to users.
  * Used for outbound messages and scheduled tasks.
@@ -21,29 +20,21 @@ export class XYPushService {
     }
     /**
      * Send a push message to a user session.
+     *
+     * @param content - Push message content
+     * @param title - Push message title
+     * @param data - Optional additional data
+     * @param sessionId - Optional session ID
+     * @param pushDataId - Optional pushDataId for kind="data" format
+     * @param pushId - Push ID to use (required)
      */
-    async sendPush(content, title, data, sessionId) {
+    async sendPush(content, title, data, sessionId, pushDataId, pushId) {
         const pushUrl = this.config.pushUrl || this.DEFAULT_PUSH_URL;
         const traceId = this.generateTraceId();
-        // Get dynamic pushId for the session (falls back to config pushId)
-        const dynamicPushId = configManager.getPushId(sessionId);
-        const pushId = dynamicPushId || this.config.pushId;
+        // Use provided pushId or fall back to config pushId
+        const actualPushId = pushId || this.config.pushId;
         console.log(`[PUSH] 📤 Preparing to send push message`);
-        console.log(`[PUSH]   - Title: "${title}"`);
-        console.log(`[PUSH]   - Content length: ${content.length} chars`);
-        console.log(`[PUSH]   - Session ID: ${sessionId || 'none'}`);
-        console.log(`[PUSH]   - Trace ID: ${traceId}`);
-        console.log(`[PUSH]   - Push URL: ${pushUrl}`);
-        if (dynamicPushId) {
-            console.log(`[PUSH]   - Using dynamic pushId (from session): ${pushId.substring(0, 20)}...`);
-            console.log(`[PUSH]   - Full dynamic pushId: ${pushId}`);
-        }
-        else {
-            console.log(`[PUSH]   - Using config pushId (fallback): ${pushId.substring(0, 20)}...`);
-            console.log(`[PUSH]   - Full config pushId: ${pushId}`);
-        }
-        console.log(`[PUSH]   - API ID: ${this.config.apiId}`);
-        console.log(`[PUSH]   - UID: ${this.config.uid}`);
+        console.log(`[PUSH]   - Using pushId: ${actualPushId.substring(0, 20)}...`);
         try {
             const requestBody = {
                 jsonrpc: "2.0",
@@ -51,23 +42,31 @@ export class XYPushService {
                 result: {
                     id: randomUUID(),
                     apiId: this.config.apiId,
-                    pushId: pushId, // Use dynamic pushId
+                    pushId: actualPushId,
                     pushText: title,
                     kind: "task",
                     artifacts: [
                         {
                             artifactId: randomUUID(),
-                            parts: [
-                                {
-                                    kind: "text",
-                                    text: content,
-                                },
-                            ],
+                            parts: pushDataId
+                                ? [
+                                    {
+                                        kind: "data",
+                                        data: {
+                                            pushDataId: pushDataId,
+                                        },
+                                    },
+                                ]
+                                : [
+                                    {
+                                        kind: "text",
+                                        text: content,
+                                    },
+                                ],
                         },
                     ],
                 },
             };
-            console.log(`[PUSH] Full request body:`, JSON.stringify(requestBody, null, 2));
             const response = await fetch(pushUrl, {
                 method: "POST",
                 headers: {
@@ -83,21 +82,16 @@ export class XYPushService {
             // Log response status and headers
             console.log(`[PUSH] 📥 Response received`);
             console.log(`[PUSH]   - HTTP Status: ${response.status} ${response.statusText}`);
-            console.log(`[PUSH]   - Content-Type: ${response.headers.get('content-type')}`);
-            console.log(`[PUSH]   - Content-Length: ${response.headers.get('content-length')}`);
             if (!response.ok) {
                 const errorText = await response.text();
                 console.log(`[PUSH] ❌ Push request failed`);
                 console.log(`[PUSH]   - HTTP Status: ${response.status}`);
-                console.log(`[PUSH]   - Response body: ${errorText}`);
                 throw new Error(`Push failed: HTTP ${response.status} - ${errorText}`);
             }
             // Try to parse JSON response with detailed error handling
             let result;
             try {
                 const responseText = await response.text();
-                console.log(`[PUSH] 📄 Response body length: ${responseText.length} chars`);
-                console.log(`[PUSH] 📄 Response body preview: ${responseText.substring(0, 200)}`);
                 if (!responseText || responseText.trim() === '') {
                     console.log(`[PUSH] ⚠️ Received empty response body`);
                     result = {};
@@ -112,20 +106,13 @@ export class XYPushService {
                 throw new Error(`Invalid JSON response from push service: ${parseError instanceof Error ? parseError.message : String(parseError)}`);
             }
             console.log(`[PUSH] ✅ Push message sent successfully`);
-            console.log(`[PUSH]   - Title: "${title}"`);
             console.log(`[PUSH]   - Trace ID: ${traceId}`);
-            console.log(`[PUSH]   - Used pushId: ${pushId.substring(0, 20)}...`);
-            console.log(`[PUSH]   - Response:`, result);
         }
         catch (error) {
             console.log(`[PUSH] ❌ Failed to send push message`);
-            console.log(`[PUSH]   - Trace ID: ${traceId}`);
-            console.log(`[PUSH]   - Target URL: ${pushUrl}`);
-            console.log(`[PUSH]   - Push ID: ${pushId.substring(0, 20)}...`);
             if (error instanceof Error) {
                 console.log(`[PUSH]   - Error name: ${error.name}`);
                 console.log(`[PUSH]   - Error message: ${error.message}`);
-                console.log(`[PUSH]   - Error stack:`, error.stack);
             }
             else {
                 console.log(`[PUSH]   - Error:`, error);

package/dist/src/reply-dispatcher.d.ts

@@ -8,6 +8,10 @@ export interface CreateXYReplyDispatcherParams {
     accountId: string;
     isSteerFollower?: boolean;
 }
+/**
+ * 清理 /tmp/xy_channel 目录中超过 24 小时的旧文件
+ */
+export declare function cleanupStaleTempFiles(tempDir?: string): Promise<void>;
 /**
  * Create a reply dispatcher for XY channel messages.
  * Follows feishu pattern with status updates and streaming support.

package/dist/src/reply-dispatcher.js

@@ -1,8 +1,43 @@
-import { createReplyPrefixContext } from "openclaw/plugin-sdk";
 import { getXYRuntime } from "./runtime.js";
 import { sendA2AResponse, sendStatusUpdate, sendReasoningTextUpdate } from "./formatter.js";
 import { resolveXYConfig } from "./config.js";
 import { getCurrentTaskId, getCurrentMessageId } from "./task-manager.js";
+import fs from "fs/promises";
+import path from "path";
+const TEMP_FILE_TTL_MS = 24 * 60 * 60 * 1000; // 24 hours
+/**
+ * 清理 /tmp/xy_channel 目录中超过 24 小时的旧文件
+ */
+export async function cleanupStaleTempFiles(tempDir = "/tmp/xy_channel") {
+    try {
+        const stats = await fs.stat(tempDir).catch(() => null);
+        if (!stats?.isDirectory()) {
+            return;
+        }
+        const files = await fs.readdir(tempDir);
+        const now = Date.now();
+        let cleanedCount = 0;
+        for (const file of files) {
+            const filePath = path.join(tempDir, file);
+            try {
+                const fileStat = await fs.stat(filePath);
+                if (now - fileStat.mtimeMs > TEMP_FILE_TTL_MS) {
+                    await fs.unlink(filePath);
+                    cleanedCount++;
+                }
+            }
+            catch (err) {
+                // 忽略单个文件处理失败
+            }
+        }
+        if (cleanedCount > 0) {
+            console.log(`[CLEANUP] 🧹 Cleaned ${cleanedCount} stale files (>${TEMP_FILE_TTL_MS / 1000 / 3600}h) from ${tempDir}`);
+        }
+    }
+    catch (err) {
+        console.error(`[CLEANUP] ❌ Failed to cleanup temp dir:`, err);
+    }
+}
 /**
  * Create a reply dispatcher for XY channel messages.
  * Follows feishu pattern with status updates and streaming support.
@@ -13,9 +48,7 @@ export function createXYReplyDispatcher(params) {
     const log = runtime?.log ?? console.log;
     const error = runtime?.error ?? console.error;
     log(`[DISPATCHER-CREATE] ******* Creating dispatcher *******`);
-    log(`[DISPATCHER-CREATE]   - sessionId: ${sessionId}`);
     log(`[DISPATCHER-CREATE]   - taskId: ${taskId}`);
-    log(`[DISPATCHER-CREATE]   - messageId: ${messageId}`);
     log(`[DISPATCHER-CREATE]   - isSteerFollower: ${isSteerFollower ?? false}`);
     // 初始taskId和messageId（作为fallback）
     const initialTaskId = taskId;
@@ -32,7 +65,12 @@ export function createXYReplyDispatcher(params) {
     };
     const core = getXYRuntime();
     const config = resolveXYConfig(cfg);
-    const prefixContext = createReplyPrefixContext({ cfg, agentId: accountId });
+    // Simplified prefix context for single-account Xiaoyi channel
+    const prefixContext = {
+        responsePrefix: undefined,
+        responsePrefixContextProvider: undefined,
+        onModelSelected: undefined,
+    };
     let statusUpdateInterval = null;
     let hasSentResponse = false;
     let finalSent = false;
@@ -54,7 +92,7 @@ export function createXYReplyDispatcher(params) {
                 sessionId,
                 taskId: currentTaskId, // 🔑 动态taskId
                 messageId: currentMessageId, // 🔑 动态messageId
-                text: "任务正在处理中，请稍后~",
+                text: "任务正在处理中，请稍候~",
                 state: "working",
             }).catch((err) => {
                 error(`Failed to send status update:`, err);
@@ -289,7 +327,6 @@ export function createXYReplyDispatcher(params) {
                 const currentTaskId = getActiveTaskId();
                 const currentMessageId = getActiveMessageId();
                 const text = payload.text ?? "";
-                log(`[PARTIAL REPLY] Partial reply chunk received, taskId: ${currentTaskId}`);
                 try {
                     if (text.length > 0) {
                         await sendReasoningTextUpdate({
@@ -300,7 +337,6 @@ export function createXYReplyDispatcher(params) {
                             text,
                             append: false,
                         });
-                        log(`[PARTIAL REPLY] ✅ Sent partial reply as reasoningText update`);
                     }
                 }
                 catch (err) {

package/dist/src/steer-injector.d.ts

@@ -0,0 +1,16 @@
+import type { ClawdbotConfig, RuntimeEnv } from "openclaw/plugin-sdk";
+/**
+ * 在 handleXYMessage 入口处调用，缓存 cfg/runtime 供 steer 注入使用。
+ */
+export declare function setCachedContext(cfg: ClawdbotConfig, runtime: RuntimeEnv, accountId: string): void;
+/**
+ * 尝试向当前活跃会话注入 steer 消息。
+ * 两层保险：
+ *   1. getSessionContext(sessionKey) 确认是当前 XY 活跃 session
+ *   2. hasActiveTask(sessionId) 确认任务仍在运行
+ *
+ * @param sessionKey  来自 after_tool_call ctx.sessionKey（per-peer 下精确对应一个 XY session）
+ * @param message     要注入的用户消息文本
+ * @returns           true=已注入，false=跳过
+ */
+export declare function tryInjectSteer(sessionKey: string | undefined, message: string): Promise<boolean>;

package/dist/src/steer-injector.js

@@ -0,0 +1,74 @@
+// Steer message injector for CSPL hook integration
+import { getSessionContext } from "./tools/session-manager.js";
+import { hasActiveTask, getCurrentTaskId } from "./task-manager.js";
+import { handleXYMessage } from "./bot.js";
+import { logger } from "./utils/logger.js";
+import { randomUUID } from "node:crypto";
+let cachedCfg = null;
+let cachedRuntime = null;
+let cachedAccountId = "default";
+/**
+ * 在 handleXYMessage 入口处调用，缓存 cfg/runtime 供 steer 注入使用。
+ */
+export function setCachedContext(cfg, runtime, accountId) {
+    cachedCfg = cfg;
+    cachedRuntime = runtime;
+    cachedAccountId = accountId;
+}
+/**
+ * 尝试向当前活跃会话注入 steer 消息。
+ * 两层保险：
+ *   1. getSessionContext(sessionKey) 确认是当前 XY 活跃 session
+ *   2. hasActiveTask(sessionId) 确认任务仍在运行
+ *
+ * @param sessionKey  来自 after_tool_call ctx.sessionKey（per-peer 下精确对应一个 XY session）
+ * @param message     要注入的用户消息文本
+ * @returns           true=已注入，false=跳过
+ */
+export async function tryInjectSteer(sessionKey, message) {
+    if (!sessionKey) {
+        return false;
+    }
+    const sessionCtx = getSessionContext(sessionKey);
+    if (!sessionCtx) {
+        return false;
+    }
+    const { sessionId } = sessionCtx;
+    const activeTaskId = getCurrentTaskId(sessionId);
+    if (!hasActiveTask(sessionId)) {
+        return false;
+    }
+    if (!cachedCfg || !cachedRuntime) {
+        logger.error("[STEER] No cached cfg/runtime available, cannot inject");
+        return false;
+    }
+    // 3. 构造合成 A2A 消息（伪装成用户在当前会话中发送的新消息）
+    const syntheticMessage = {
+        jsonrpc: "2.0",
+        method: "tasks/send",
+        id: `steer-msg-${randomUUID()}`,
+        params: {
+            sessionId,
+            id: activeTaskId ?? `steer-task-${randomUUID()}`,
+            agentLoginSessionId: "",
+            message: {
+                role: "user",
+                parts: [{ kind: "text", text: message }],
+            },
+        },
+    };
+    console.log(`[STEER] Injecting steer for sessionId=${sessionId}, taskId=${syntheticMessage.params.id}`);
+    try {
+        await handleXYMessage({
+            cfg: cachedCfg,
+            runtime: cachedRuntime,
+            message: syntheticMessage,
+            accountId: cachedAccountId,
+        });
+        return true;
+    }
+    catch (err) {
+        logger.error(`[STEER] ❌ Failed to inject steer: ${err}`);
+        return false;
+    }
+}