@ynhcj/xiaoyi-channel 0.0.132-beta → 0.0.133-beta

package/dist/index.js

@@ -5,6 +5,7 @@ import { callCsplApi } from "./src/cspl/call-api.js";
 import { ALLOWED_TOOLS, MAX_TEXT_LENGTH, MAX_TOTAL_LENGTH, MIN_TEXT_LENGTH, STEER_ABORT_MESSAGE, } from "./src/cspl/constants.js";
 import { extractResultText, parseSecurityResult, processText, validateAndTruncateText, } from "./src/cspl/utils.js";
 import { setXYRuntime } from "./src/runtime.js";
+import { logger } from "./src/utils/logger.js";
 import { tryInjectSteer } from "./src/steer-injector.js";
 import { registerSelfEvolutionToolResultNudge } from "./src/self-evolution-tool-result-nudge.js";
 import { createBeforePromptBuildHandler } from "./src/skill-retriever/hooks.js";
@@ -26,7 +27,7 @@ function registerFullHooks(api) {
         if (!ALLOWED_TOOLS.includes(event.toolName)) {
             return;
         }
-        console.log(`[SENTINEL HOOK] after_tool_call triggered: toolName=${event.toolName}, sessionKey=${ctx.sessionKey ?? "none"}`);
+        logger.log(`[SENTINEL HOOK] after_tool_call triggered: toolName=${event.toolName}, sessionKey=${ctx.sessionKey ?? "none"}`);
         try {
             const resultText = extractResultText(event, event.toolName);
             const resultLength = resultText.length;
@@ -49,13 +50,13 @@ function registerFullHooks(api) {
             }
             const response = await callCsplApi(finalJson, api.config);
             const result = parseSecurityResult(response);
-            console.log(`[SENTINEL HOOK] Security result: status=${result.status}`);
+            logger.log(`[SENTINEL HOOK] Security result: status=${result.status}`);
             if (result.status === "REJECT") {
                 await tryInjectSteer(ctx.sessionKey, STEER_ABORT_MESSAGE);
             }
         }
         catch (err) {
-            api.logger.error(`[SENTINEL HOOK] after_tool_call error: ${err}`);
+            logger.error(`[SENTINEL HOOK] after_tool_call error: ${err}`);
         }
     });
 }

package/dist/src/bot.js

@@ -14,6 +14,7 @@ import { selfEvolutionManager } from "./utils/self-evolution-manager.js";
 import { saveRuntimeInfo } from "./utils/runtime-manager.js";
 import { toolCallNudgeManager } from "./utils/tool-call-nudge-manager.js";
 import { registerTaskId, decrementTaskIdRef, lockTaskId, unlockTaskId, hasActiveTask, } from "./task-manager.js";
+import { logger } from "./utils/logger.js";
 /**
  * Handle an incoming A2A message.
  * This is the main entry point for message processing.
@@ -21,8 +22,6 @@ import { registerTaskId, decrementTaskIdRef, lockTaskId, unlockTaskId, hasActive
  */
 export async function handleXYMessage(params) {
     const { cfg, runtime, message, accountId, webSocketSessionId } = params;
-    const log = runtime?.log ?? console.log;
-    const error = runtime?.error ?? console.error;
     // 每次收到消息时更新缓存，供 steer 注入使用
     setCachedContext(cfg, runtime, accountId);
     // Get runtime (already validated in monitor.ts, but get reference for use)
@@ -36,7 +35,7 @@ export async function handleXYMessage(params) {
             if (!sessionId) {
                 throw new Error("clearContext request missing sessionId in params");
             }
-            log(`Clear context request for session ${sessionId}`);
+            logger.log(`Clear context request for session ${sessionId}`);
             const config = resolveXYConfig(cfg);
             await sendClearContextResponse({
                 config,
@@ -52,7 +51,7 @@ export async function handleXYMessage(params) {
             if (!sessionId) {
                 throw new Error("tasks/cancel request missing sessionId in params");
             }
-            log(`Tasks cancel request for session ${sessionId}, task ${taskId}`);
+            logger.log(`Tasks cancel request for session ${sessionId}, task ${taskId}`);
             const config = resolveXYConfig(cfg);
             await sendTasksCancelResponse({
                 config,
@@ -68,18 +67,18 @@ export async function handleXYMessage(params) {
         // 如果消息中包含 Trigger 事件数据，直接返回 pushData 内容，不走正常流程
         const triggerData = extractTriggerData(parsed.parts);
         if (triggerData) {
-            log(`[BOT] 📌 Detected Trigger message with pushDataId: ${triggerData.pushDataId}`);
-            log(`[BOT]   - Session ID: ${parsed.sessionId}`);
-            log(`[BOT]   - Task ID: ${parsed.taskId}`);
+            logger.log(`[BOT] 📌 Detected Trigger message with pushDataId: ${triggerData.pushDataId}`);
+            logger.log(`[BOT]   - Session ID: ${parsed.sessionId}`);
+            logger.log(`[BOT]   - Task ID: ${parsed.taskId}`);
             try {
                 // 读取 pushData
                 const pushDataItem = await getPushDataById(triggerData.pushDataId);
                 if (!pushDataItem) {
-                    error(`[BOT] ❌ pushData not found for ID: ${triggerData.pushDataId}`);
+                    logger.error(`[BOT] ❌ pushData not found for ID: ${triggerData.pushDataId}`);
                     return;
                 }
-                log(`[BOT] ✅ Found pushData, sending direct response`);
-                log(`[BOT]   - pushDataId: ${pushDataItem.pushDataId}`);
+                logger.log(`[BOT] ✅ Found pushData, sending direct response`);
+                logger.log(`[BOT]   - pushDataId: ${pushDataItem.pushDataId}`);
                 const config = resolveXYConfig(cfg);
                 // 直接发送响应（final=true，不走 openclaw 流程）
                 await sendA2AResponse({
@@ -90,13 +89,12 @@ export async function handleXYMessage(params) {
                     text: pushDataItem.dataDetail,
                     append: false,
                     final: true,
-                    runtime,
                 });
-                log(`[BOT] ✅ Trigger response sent successfully, exiting early`);
+                logger.log(`[BOT] ✅ Trigger response sent successfully, exiting early`);
                 return; // 提前返回，不继续处理
             }
             catch (err) {
-                error(`[BOT] ❌ Failed to handle Trigger message:`, err);
+                logger.error(`[BOT] ❌ Failed to handle Trigger message:`, err);
                 return;
             }
         }
@@ -105,9 +103,9 @@ export async function handleXYMessage(params) {
         const isSteerMode = cfg.messages?.queue?.mode === "steer";
         const isSecondMessage = isSteerMode && hasActiveTask(parsed.sessionId);
         if (isSecondMessage) {
-            log(`[BOT] 🔄 STEER MODE - Second message detected (will be follower)`);
-            log(`[BOT]   - Session: ${parsed.sessionId}`);
-            log(`[BOT]   - New taskId: ${parsed.taskId} (will replace current)`);
+            logger.log(`[BOT] 🔄 STEER MODE - Second message detected (will be follower)`);
+            logger.log(`[BOT]   - Session: ${parsed.sessionId}`);
+            logger.log(`[BOT]   - New taskId: ${parsed.taskId} (will replace current)`);
         }
         // 🔑 注册taskId（第二条消息会覆盖第一条的taskId）
         const { isUpdate, refCount } = registerTaskId(parsed.sessionId, parsed.taskId, parsed.messageId, { incrementRef: true } // 增加引用计数
@@ -115,32 +113,32 @@ export async function handleXYMessage(params) {
         // 🔑 如果是第一条消息，锁定taskId防止被过早清理
         if (!isUpdate) {
             lockTaskId(parsed.sessionId);
-            log(`[BOT] 🔒 Locked taskId for first message`);
+            logger.log(`[BOT] 🔒 Locked taskId for first message`);
         }
         // Extract and update push_id if present
         const pushId = extractPushId(parsed.parts);
         if (pushId) {
-            log(`[BOT] 📌 Extracted push_id from user message`);
+            logger.log(`[BOT] 📌 Extracted push_id from user message`);
             configManager.updatePushId(parsed.sessionId, pushId);
             // 持久化 pushId 到本地文件（异步，不阻塞主流程）
             addPushId(pushId).catch((err) => {
-                error(`[BOT] Failed to persist pushId:`, err);
+                logger.error(`[BOT] Failed to persist pushId:`, err);
             });
         }
         else {
-            log(`[BOT] ℹ️  No push_id found in message, will use config default`);
+            logger.log(`[BOT] ℹ️  No push_id found in message, will use config default`);
         }
         // Extract deviceType if present (same level as push_id in systemVariables)
         const deviceType = extractDeviceType(parsed.parts);
         if (deviceType) {
-            log(`[BOT] 📱 Extracted deviceType from user message: ${deviceType}`);
+            logger.log(`[BOT] 📱 Extracted deviceType from user message: ${deviceType}`);
         }
         // 保存 runtime 信息到 .xiaoyiruntime 文件（异步，不阻塞主流程）
         saveRuntimeInfo(webSocketSessionId || parsed.sessionId, // SESSION_ID (WebSocket 层级，如果没有则 fallback)
         parsed.sessionId, // CONVERSATION_ID (param 里的 sessionId)
         parsed.taskId // TASK_ID (param.id)
         ).catch((err) => {
-            error(`[BOT] Failed to save runtime info:`, err);
+            logger.error(`[BOT] Failed to save runtime info:`, err);
         });
         // Resolve configuration (needed for status updates)
         const config = resolveXYConfig(cfg);
@@ -156,7 +154,7 @@ export async function handleXYMessage(params) {
                 id: parsed.sessionId, // ✅ Use sessionId to share context within the same conversation session
             },
         });
-        log(`xy: resolved route accountId=${route.accountId}, sessionKey=${route.sessionKey}`);
+        logger.log(`xy: resolved route accountId=${route.accountId}, sessionKey=${route.sessionKey}`);
         registerSession(route.sessionKey, {
             config,
             sessionId: parsed.sessionId,
@@ -166,7 +164,7 @@ export async function handleXYMessage(params) {
             deviceType,
         });
         // 🔑 发送初始状态更新（第二条消息也要发，用新taskId）
-        log(`[STATUS] Sending initial status update for session ${parsed.sessionId}`);
+        logger.log(`[STATUS] Sending initial status update for session ${parsed.sessionId}`);
         void sendStatusUpdate({
             config,
             sessionId: parsed.sessionId,
@@ -174,9 +172,8 @@ export async function handleXYMessage(params) {
             messageId: parsed.messageId,
             text: isSecondMessage ? "新消息已接收，正在处理..." : "任务正在处理中，请稍候~",
             state: "working",
-            runtime,
         }).catch((err) => {
-            error(`Failed to send initial status update:`, err);
+            logger.error(`Failed to send initial status update:`, err);
         });
         // Extract text and files from parts
         const text = extractTextFromParts(parsed.parts);
@@ -186,24 +183,24 @@ export async function handleXYMessage(params) {
                 const selfEvolutionEnabled = await selfEvolutionManager.isEnabled();
                 if (selfEvolutionEnabled && shouldNudgeForSelfEvolutionKeyword(textForAgent)) {
                     const shouldNudge = toolCallNudgeManager.tryMarkKeywordNudge(route.sessionKey);
-                    log(`[SELF_EVOLUTION] Keyword check hit during inbound build: sessionKey=${route.sessionKey}, shouldNudge=${shouldNudge}`);
+                    logger.log(`[SELF_EVOLUTION] Keyword check hit during inbound build: sessionKey=${route.sessionKey}, shouldNudge=${shouldNudge}`);
                     if (shouldNudge) {
                         const augmented = appendSelfEvolutionKeywordNudge(textForAgent);
                         textForAgent = augmented.text;
                         if (augmented.appended) {
-                            log(`[SELF_EVOLUTION] Keyword-triggered inline nudge appended: sessionKey=${route.sessionKey}`);
+                            logger.log(`[SELF_EVOLUTION] Keyword-triggered inline nudge appended: sessionKey=${route.sessionKey}`);
                         }
                     }
                 }
             }
             catch (selfEvolutionError) {
-                error(`[SELF_EVOLUTION] Failed to append inline keyword nudge: ${String(selfEvolutionError)}`);
+                logger.error(`[SELF_EVOLUTION] Failed to append inline keyword nudge: ${String(selfEvolutionError)}`);
             }
         }
         const fileParts = extractFileParts(parsed.parts);
         // Download files to local disk
         const downloadedFiles = await downloadFilesFromParts(fileParts);
-        log("Downloaded files:", JSON.stringify(downloadedFiles, null, 2));
+        logger.log("Downloaded files:", JSON.stringify(downloadedFiles, null, 2));
         const mediaPayload = buildXYMediaPayload(downloadedFiles);
         // Resolve envelope format options (following feishu pattern)
         const envelopeOptions = core.channel.reply.resolveEnvelopeFormatOptions(cfg);
@@ -246,8 +243,8 @@ export async function handleXYMessage(params) {
             ...mediaPayload,
         });
         // 🔑 创建dispatcher（dispatcher会自动使用动态taskId）
-        log(`[BOT-DISPATCHER] 🎯 Creating reply dispatcher`);
-        log(`[BOT-DISPATCHER]   - taskId: ${parsed.taskId}`);
+        logger.log(`[BOT-DISPATCHER] 🎯 Creating reply dispatcher`);
+        logger.log(`[BOT-DISPATCHER]   - taskId: ${parsed.taskId}`);
         const { dispatcher, replyOptions, markDispatchIdle, startStatusInterval } = createXYReplyDispatcher({
             cfg,
             runtime,
@@ -261,7 +258,7 @@ export async function handleXYMessage(params) {
         // 第二条消息会很快返回，不需要定时器
         if (!isSecondMessage) {
             startStatusInterval();
-            log(`[BOT-DISPATCHER] ✅ Status interval started for first message`);
+            logger.log(`[BOT-DISPATCHER] ✅ Status interval started for first message`);
         }
         // Build session context for AsyncLocalStorage
         const sessionContext = {
@@ -272,22 +269,22 @@ export async function handleXYMessage(params) {
             agentId: route.accountId,
             deviceType,
         };
-        log(`[BOT-DISPATCH] ⏳ withReplyDispatcher starting, sessionKey=${route.sessionKey}`);
+        logger.log(`[BOT-DISPATCH] ⏳ withReplyDispatcher starting, sessionKey=${route.sessionKey}`);
         await core.channel.reply.withReplyDispatcher({
             dispatcher,
             onSettled: () => {
-                log(`[BOT] 🏁 onSettled called for session: ${route.sessionKey}`);
-                log(`[BOT]   - isSecondMessage: ${isSecondMessage}`);
+                logger.log(`[BOT] 🏁 onSettled called for session: ${route.sessionKey}`);
+                logger.log(`[BOT]   - isSecondMessage: ${isSecondMessage}`);
                 // 🔑 减少引用计数
                 decrementTaskIdRef(parsed.sessionId);
                 // 🔑 如果是第一条消息完成，解锁
                 if (!isSecondMessage) {
                     unlockTaskId(parsed.sessionId);
-                    log(`[BOT] 🔓 Unlocked taskId (first message completed)`);
+                    logger.log(`[BOT] 🔓 Unlocked taskId (first message completed)`);
                 }
                 // 减少session引用计数
                 unregisterSession(route.sessionKey);
-                log(`[BOT] ✅ Cleanup completed`);
+                logger.log(`[BOT] ✅ Cleanup completed`);
             },
             run: () => {
                 // 🔐 Use AsyncLocalStorage to provide session context to tools.
@@ -296,12 +293,12 @@ export async function handleXYMessage(params) {
                 // signal init complete to release the global dispatch gate
                 // for the next session.
                 const dispatchPromise = runWithSessionContext(sessionContext, async () => {
-                    log(`[BOT-DISPATCH] ⏳ dispatchReplyFromConfig starting...`);
-                    log(`[BOT-DISPATCH]   - sessionKey: ${ctxPayload.SessionKey}`);
-                    log(`[BOT-DISPATCH]   - provider: ${ctxPayload.Provider}`);
-                    log(`[BOT-DISPATCH]   - surface: ${ctxPayload.Surface}`);
-                    log(`[BOT-DISPATCH]   - from: ${ctxPayload.From}`);
-                    log(`[BOT-DISPATCH]   - body length: ${ctxPayload.Body?.length ?? 0}`);
+                    logger.log(`[BOT-DISPATCH] ⏳ dispatchReplyFromConfig starting...`);
+                    logger.log(`[BOT-DISPATCH]   - sessionKey: ${ctxPayload.SessionKey}`);
+                    logger.log(`[BOT-DISPATCH]   - provider: ${ctxPayload.Provider}`);
+                    logger.log(`[BOT-DISPATCH]   - surface: ${ctxPayload.Surface}`);
+                    logger.log(`[BOT-DISPATCH]   - from: ${ctxPayload.From}`);
+                    logger.log(`[BOT-DISPATCH]   - body length: ${ctxPayload.Body?.length ?? 0}`);
                     try {
                         const result = await core.channel.reply.dispatchReplyFromConfig({
                             ctx: ctxPayload,
@@ -309,15 +306,15 @@ export async function handleXYMessage(params) {
                             dispatcher,
                             replyOptions,
                         });
-                        log(`[BOT-DISPATCH] ✅ dispatchReplyFromConfig returned`);
-                        log(`[BOT-DISPATCH]   - result: ${JSON.stringify(result)}`);
+                        logger.log(`[BOT-DISPATCH] ✅ dispatchReplyFromConfig returned`);
+                        logger.log(`[BOT-DISPATCH]   - result: ${JSON.stringify(result)}`);
                         return result;
                     }
                     catch (dispatchErr) {
-                        error(`[BOT-DISPATCH] ❌ dispatchReplyFromConfig threw`);
-                        error(`[BOT-DISPATCH]   - error name: ${dispatchErr instanceof Error ? dispatchErr.name : "unknown"}`);
-                        error(`[BOT-DISPATCH]   - error message: ${String(dispatchErr)}`);
-                        error(`[BOT-DISPATCH]   - error stack: ${dispatchErr instanceof Error ? dispatchErr.stack?.slice(0, 500) : "N/A"}`);
+                        logger.error(`[BOT-DISPATCH] ❌ dispatchReplyFromConfig threw`);
+                        logger.error(`[BOT-DISPATCH]   - error name: ${dispatchErr instanceof Error ? dispatchErr.name : "unknown"}`);
+                        logger.error(`[BOT-DISPATCH]   - error message: ${String(dispatchErr)}`);
+                        logger.error(`[BOT-DISPATCH]   - error stack: ${dispatchErr instanceof Error ? dispatchErr.stack?.slice(0, 500) : "N/A"}`);
                         throw dispatchErr;
                     }
                 });
@@ -326,20 +323,20 @@ export async function handleXYMessage(params) {
                 return dispatchPromise;
             },
         });
-        log(`[BOT] ✅ Dispatcher completed for session: ${parsed.sessionId}`);
-        log(`xy: dispatch complete (session=${parsed.sessionId})`);
+        logger.log(`[BOT] ✅ Dispatcher completed for session: ${parsed.sessionId}`);
+        logger.log(`xy: dispatch complete (session=${parsed.sessionId})`);
     }
     catch (err) {
         // ✅ Only log error, don't re-throw to prevent gateway restart
-        error("Failed to handle XY message:", err);
+        logger.error("Failed to handle XY message:", err);
         runtime.error?.(`xy: Failed to handle message: ${String(err)}`);
-        log(`[BOT] ❌ Error occurred, attempting cleanup...`);
+        logger.log(`[BOT] ❌ Error occurred, attempting cleanup...`);
         // 🔑 错误时也要清理taskId和session
         try {
             const params = message.params;
             const sessionId = params?.sessionId;
             if (sessionId) {
-                log(`[BOT] 🧹 Cleaning up after error: ${sessionId}`);
+                logger.log(`[BOT] 🧹 Cleaning up after error: ${sessionId}`);
                 // 清理 taskId
                 decrementTaskIdRef(sessionId);
                 unlockTaskId(sessionId);
@@ -355,11 +352,11 @@ export async function handleXYMessage(params) {
                     },
                 });
                 unregisterSession(route.sessionKey);
-                log(`[BOT] ✅ Cleanup completed after error`);
+                logger.log(`[BOT] ✅ Cleanup completed after error`);
             }
         }
         catch (cleanupErr) {
-            log(`[BOT] ⚠️  Cleanup failed:`, cleanupErr);
+            logger.log(`[BOT] ⚠️  Cleanup failed:`, cleanupErr);
             // Ignore cleanup errors
         }
         // ❌ Don't re-throw: message processing error should not affect gateway stability

package/dist/src/client.d.ts

@@ -1,15 +1,11 @@
 import { XYWebSocketManager } from "./websocket.js";
 import type { XYChannelConfig } from "./types.js";
 import type { RuntimeEnv } from "openclaw/plugin-sdk";
-/**
- * Set the runtime for logging in client module.
- */
-export declare function setClientRuntime(rt: RuntimeEnv | undefined): void;
 /**
  * Get or create a WebSocket manager for the given configuration.
  * Reuses existing managers if config matches.
  */
-export declare function getXYWebSocketManager(config: XYChannelConfig): XYWebSocketManager;
+export declare function getXYWebSocketManager(config: XYChannelConfig, runtime?: RuntimeEnv): XYWebSocketManager;
 /**
  * Remove a specific WebSocket manager from cache.
  * Disconnects the manager and removes it from the cache.

package/dist/src/client.js

@@ -1,14 +1,7 @@
 // WebSocket client cache management
 // Follows feishu/client.ts pattern for caching client instances
 import { XYWebSocketManager } from "./websocket.js";
-// Runtime reference for logging
-let runtime;
-/**
- * Set the runtime for logging in client module.
- */
-export function setClientRuntime(rt) {
-    runtime = rt;
-}
+import { logger } from "./utils/logger.js";
 /**
  * Global cache for WebSocket managers.
  * Key format: `${apiKey}-${agentId}`
@@ -24,19 +17,17 @@ const wsManagerCache = _g.__xyWsManagerCache;
  * Get or create a WebSocket manager for the given configuration.
  * Reuses existing managers if config matches.
  */
-export function getXYWebSocketManager(config) {
+export function getXYWebSocketManager(config, runtime) {
     const cacheKey = `${config.apiKey}-${config.agentId}`;
     let cached = wsManagerCache.get(cacheKey);
     if (cached && cached.isConfigMatch(config)) {
-        const log = runtime?.log ?? console.log;
         return cached;
     }
     // Create new manager
-    const log = runtime?.log ?? console.log;
-    log(`[WS-MANAGER-CACHE] 🆕 Creating new WebSocket manager: ${cacheKey}, total managers before: ${wsManagerCache.size}`);
+    logger.log(`[WS-MANAGER-CACHE] 🆕 Creating new WebSocket manager: ${cacheKey}, total managers before: ${wsManagerCache.size}`);
     cached = new XYWebSocketManager(config, runtime);
     wsManagerCache.set(cacheKey, cached);
-    log(`[WS-MANAGER-CACHE] 📊 Total managers after creation: ${wsManagerCache.size}`);
+    logger.log(`[WS-MANAGER-CACHE] 📊 Total managers after creation: ${wsManagerCache.size}`);
     return cached;
 }
 /**
@@ -44,25 +35,23 @@ export function getXYWebSocketManager(config) {
  * Disconnects the manager and removes it from the cache.
  */
 export function removeXYWebSocketManager(config) {
-    const log = runtime?.log ?? console.log;
     const cacheKey = `${config.apiKey}-${config.agentId}`;
     const manager = wsManagerCache.get(cacheKey);
     if (manager) {
-        log(`🗑️  [WS-MANAGER-CACHE] Removing manager from cache: ${cacheKey}`);
+        logger.log(`🗑️  [WS-MANAGER-CACHE] Removing manager from cache: ${cacheKey}`);
         manager.disconnect();
         wsManagerCache.delete(cacheKey);
-        log(`🗑️  [WS-MANAGER-CACHE] Manager removed, remaining managers: ${wsManagerCache.size}`);
+        logger.log(`🗑️  [WS-MANAGER-CACHE] Manager removed, remaining managers: ${wsManagerCache.size}`);
     }
     else {
-        log(`⚠️  [WS-MANAGER-CACHE] Manager not found in cache: ${cacheKey}`);
+        logger.log(`⚠️  [WS-MANAGER-CACHE] Manager not found in cache: ${cacheKey}`);
     }
 }
 /**
  * Clear all cached WebSocket managers.
  */
 export function clearXYWebSocketManagers() {
-    const log = runtime?.log ?? console.log;
-    log("Clearing all WebSocket manager caches");
+    logger.log("Clearing all WebSocket manager caches");
     for (const manager of wsManagerCache.values()) {
         manager.disconnect();
     }
@@ -79,37 +68,35 @@ export function getCachedManagerCount() {
  * Helps identify connection issues and orphan connections.
  */
 export function diagnoseAllManagers() {
-    const log = runtime?.log ?? console.log;
-    log(`Total cached managers: ${wsManagerCache.size}`);
+    logger.log(`Total cached managers: ${wsManagerCache.size}`);
     if (wsManagerCache.size === 0) {
-        log("ℹ️  No managers in cache");
+        logger.log("ℹ️  No managers in cache");
         return;
     }
     let orphanCount = 0;
     wsManagerCache.forEach((manager, key) => {
         const diag = manager.getConnectionDiagnostics();
-        log(`   Total event listeners on manager: ${diag.totalEventListeners}`);
+        logger.log(`   Total event listeners on manager: ${diag.totalEventListeners}`);
         // Connection
-        log(`   🔌 Connection:`);
-        log(`      - Exists: ${diag.connection.exists}`);
-        log(`      - ReadyState: ${diag.connection.readyState}`);
-        log(`      - State connected/ready: ${diag.connection.stateConnected}/${diag.connection.stateReady}`);
-        log(`      - Reconnect attempts: ${diag.connection.reconnectAttempts}`);
-        log(`      - Listeners on WebSocket: ${diag.connection.listenerCount}`);
-        log(`      - Heartbeat active: ${diag.connection.heartbeatActive}`);
-        log(`      - Has reconnect timer: ${diag.connection.hasReconnectTimer}`);
+        logger.log(`   🔌 Connection:`);
+        logger.log(`      - Exists: ${diag.connection.exists}`);
+        logger.log(`      - ReadyState: ${diag.connection.readyState}`);
+        logger.log(`      - State connected/ready: ${diag.connection.stateConnected}/${diag.connection.stateReady}`);
+        logger.log(`      - Reconnect attempts: ${diag.connection.reconnectAttempts}`);
+        logger.log(`      - Listeners on WebSocket: ${diag.connection.listenerCount}`);
+        logger.log(`      - Heartbeat active: ${diag.connection.heartbeatActive}`);
+        logger.log(`      - Has reconnect timer: ${diag.connection.hasReconnectTimer}`);
         if (diag.connection.isOrphan) {
-            log(`      ⚠️  ORPHAN CONNECTION DETECTED!`);
+            logger.log(`      ⚠️  ORPHAN CONNECTION DETECTED!`);
             orphanCount++;
         }
-        log("");
     });
     if (orphanCount > 0) {
-        log(`⚠️  Total orphan connections found: ${orphanCount}`);
-        log(`💡 Suggestion: These connections should be cleaned up`);
+        logger.log(`⚠️  Total orphan connections found: ${orphanCount}`);
+        logger.log(`💡 Suggestion: These connections should be cleaned up`);
     }
     else {
-        log(`✅ No orphan connections found`);
+        logger.log(`✅ No orphan connections found`);
     }
 }
 /**
@@ -117,18 +104,17 @@ export function diagnoseAllManagers() {
  * Returns the number of managers that had orphan connections.
  */
 export function cleanupOrphanConnections() {
-    const log = runtime?.log ?? console.log;
     let cleanedCount = 0;
     wsManagerCache.forEach((manager, key) => {
         const diag = manager.getConnectionDiagnostics();
         if (diag.connection.isOrphan) {
-            log(`🧹 Cleaning up orphan connections in manager: ${key}`);
+            logger.log(`🧹 Cleaning up orphan connections in manager: ${key}`);
             manager.disconnect();
             cleanedCount++;
         }
     });
     if (cleanedCount > 0) {
-        log(`🧹 Cleaned up ${cleanedCount} manager(s) with orphan connections`);
+        logger.log(`🧹 Cleaned up ${cleanedCount} manager(s) with orphan connections`);
     }
     return cleanedCount;
 }

package/dist/src/file-download.js

@@ -20,10 +20,10 @@ export async function downloadFile(url, destPath) {
     }
     catch (error) {
         if (error.name === 'AbortError') {
-            logger.log(`Download timeout (30s) for ${url}`);
+            logger.error(`Download timeout (30s) for ${url}`);
             throw new Error(`Download timeout after 30 seconds`);
         }
-        logger.log(`Failed to download file from ${url}:`);
+        logger.error(`Failed to download file from ${url}:`);
         throw error;
     }
     finally {
@@ -52,7 +52,7 @@ export async function downloadFilesFromParts(fileParts, tempDir = "/tmp/xy_chann
             });
         }
         catch (error) {
-            logger.log(`Failed to download file ${name}:`);
+            logger.error(`Failed to download file ${name}:`);
             // Continue with other files
         }
     }

package/dist/src/formatter.d.ts

@@ -17,7 +17,6 @@ export interface SendA2AResponseParams {
     }>;
     errorCode?: number | string;
     errorMessage?: string;
-    runtime?: any;
 }
 /**
  * Send an A2A artifact update response.
@@ -50,7 +49,6 @@ export interface SendStatusUpdateParams {
     messageId: string;
     text: string;
     state: "submitted" | "working" | "input-required" | "completed" | "canceled" | "failed" | "unknown";
-    runtime?: any;
 }
 /**
  * Send an A2A task status update.

package/dist/src/formatter.js

@@ -7,8 +7,7 @@ import { getCurrentTaskId, getCurrentMessageId } from "./task-manager.js";
  * Send an A2A artifact update response.
  */
 export async function sendA2AResponse(params) {
-    const { config, sessionId, taskId, messageId, text, append, final, files, errorCode, errorMessage, runtime } = params;
-    const log = runtime?.log ?? console.log;
+    const { config, sessionId, taskId, messageId, text, append, final, files, errorCode, errorMessage } = params;
     // Build artifact update event
     const artifact = {
         taskId,
@@ -47,7 +46,7 @@ export async function sendA2AResponse(params) {
             code: errorCode,
             message: errorMessage ?? "任务执行异常，请重试",
         };
-        log(`[A2A_RESPONSE] ⚠️ Including error code: ${errorCode}`);
+        logger.log(`[A2A_RESPONSE] ⚠️ Including error code: ${errorCode}`);
     }
     // Send via WebSocket
     const wsManager = getXYWebSocketManager(config);
@@ -59,13 +58,13 @@ export async function sendA2AResponse(params) {
         msgDetail: JSON.stringify(jsonRpcResponse),
     };
     // 📋 Log complete response body
-    log(`[A2A_RESPONSE] 📤 Sending A2A artifact-update response: taskId: ${taskId}`);
-    log(`[A2A_RESPONSE]   - append: ${append}`);
-    log(`[A2A_RESPONSE]   - final: ${final}`);
-    log(`[A2A_RESPONSE]   - text: ${text.length <= 10 ? text : text.slice(0, 5) + '***' + text.slice(-5)}`);
-    log(`[A2A_RESPONSE]   - files count: ${files?.length ?? 0}`);
+    logger.log(`[A2A_RESPONSE] 📤 Sending A2A artifact-update response: taskId: ${taskId}`);
+    logger.log(`[A2A_RESPONSE]   - append: ${append}`);
+    logger.log(`[A2A_RESPONSE]   - final: ${final}`);
+    logger.log(`[A2A_RESPONSE]   - text: ${text.length <= 10 ? text : text.slice(0, 5) + '***' + text.slice(-5)}`);
+    logger.log(`[A2A_RESPONSE]   - files count: ${files?.length ?? 0}`);
     await wsManager.sendMessage(sessionId, outboundMessage);
-    log(`[A2A_RESPONSE] ✅ Message sent successfully`);
+    logger.log(`[A2A_RESPONSE] ✅ Message sent successfully`);
 }
 /**
  * Send an A2A artifact-update with reasoningText part.
@@ -110,8 +109,7 @@ export async function sendReasoningTextUpdate(params) {
  * Follows A2A protocol standard format with nested status object.
  */
 export async function sendStatusUpdate(params) {
-    const { config, sessionId, taskId, messageId, text, state, runtime } = params;
-    const log = runtime?.log ?? console.log;
+    const { config, sessionId, taskId, messageId, text, state } = params;
     // Dynamic lookup: use latest taskId/messageId from task-manager (handles steer/interrupt),
     // fall back to closure-captured values
     const currentTaskId = getCurrentTaskId(sessionId) ?? taskId;
@@ -150,9 +148,9 @@ export async function sendStatusUpdate(params) {
         msgDetail: JSON.stringify(jsonRpcResponse),
     };
     // 📋 Log complete response body
-    log(`[A2A_STATUS] 📤 Sending A2A status-update:`);
-    log(`[A2A_STATUS]   - taskId: ${currentTaskId}`);
-    log(`[A2A_STATUS]   - text: "${text}"`);
+    logger.log(`[A2A_STATUS] 📤 Sending A2A status-update:`);
+    logger.log(`[A2A_STATUS]   - taskId: ${currentTaskId}`);
+    logger.log(`[A2A_STATUS]   - text: "${text}"`);
     await wsManager.sendMessage(sessionId, outboundMessage);
 }
 /**

package/dist/src/heartbeat.js

@@ -1,5 +1,6 @@
 // Heartbeat management for WebSocket connections
 import WebSocket from "ws";
+import { logger } from "./utils/logger.js";
 /**
  * Manages heartbeat for a WebSocket connection.
  * Supports both application-level (30s) and protocol-level (20s) heartbeats.
@@ -23,8 +24,8 @@ export class HeartbeatManager {
         this.onTimeout = onTimeout;
         this.serverName = serverName;
         this.onHeartbeatSuccess = onHeartbeatSuccess;
-        this.log = logFn ?? console.log;
-        this.error = errorFn ?? console.error;
+        this.log = logFn ?? ((msg, ...args) => logger.log(msg, ...args));
+        this.error = errorFn ?? ((msg, ...args) => logger.error(msg, ...args));
     }
     /**
      * Start heartbeat monitoring.