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

package/dist/src/monitor.js

@@ -4,6 +4,7 @@ import { handleXYMessage } from "./bot.js";
 import { parseA2AMessage } from "./parser.js";
 import { hasActiveTask } from "./task-manager.js";
 import { handleTriggerEvent } from "./trigger-handler.js";
+import { cleanupStaleTempFiles } from "./reply-dispatcher.js";
 /**
  * Per-session serial queue that ensures messages from the same session are processed
  * in arrival order while allowing different sessions to run concurrently.
@@ -67,7 +68,7 @@ export async function monitorXYProvider(opts = {}) {
         // Event handlers (defined early so they can be referenced in cleanup)
         const messageHandler = (message, sessionId, serverId) => {
             const messageKey = `${sessionId}::${message.id}`;
-            log(`[MONITOR-HANDLER] ####### messageHandler triggered: serverId=${serverId}, sessionId=${sessionId}, messageId=${message.id} #######`);
+            log(`[MONITOR-HANDLER] ####### messageHandler triggered: sessionId=${sessionId}, messageId=${message.id} #######`);
             // ✅ Report health: received a message
             trackEvent?.();
             // Check for duplicate message handling
@@ -75,17 +76,15 @@ export async function monitorXYProvider(opts = {}) {
                 error(`[MONITOR-HANDLER] ⚠️ WARNING: Duplicate message detected! messageKey=${messageKey}, this may cause duplicate dispatchers!`);
             }
             activeMessages.add(messageKey);
-            log(`[MONITOR-HANDLER] 📝 Active messages count: ${activeMessages.size}, messageKey: ${messageKey}`);
             const task = async () => {
                 try {
-                    log(`[MONITOR-HANDLER] 🚀 Starting handleXYMessage for messageKey=${messageKey}`);
                     await handleXYMessage({
                         cfg,
                         runtime,
                         message,
                         accountId, // ✅ Pass accountId ("default")
+                        webSocketSessionId: sessionId, // ✅ 传递 WebSocket 层级的 sessionId
                     });
-                    log(`[MONITOR-HANDLER] ✅ Completed handleXYMessage for messageKey=${messageKey}`);
                 }
                 catch (err) {
                     // ✅ Only log error, don't re-throw to prevent gateway restart
@@ -94,7 +93,6 @@ export async function monitorXYProvider(opts = {}) {
                 finally {
                     // Remove from active messages when done
                     activeMessages.delete(messageKey);
-                    log(`[MONITOR-HANDLER] 🧹 Cleaned up messageKey=${messageKey}, remaining active: ${activeMessages.size}`);
                 }
             };
             // 🔑 核心改造：检测steer模式
@@ -107,7 +105,6 @@ export async function monitorXYProvider(opts = {}) {
                     // Steer模式且有活跃任务：不入队列，直接并发执行
                     log(`[MONITOR-HANDLER] 🔄 STEER MODE: Executing concurrently for messageKey=${messageKey}`);
                     log(`[MONITOR-HANDLER]   - sessionId: ${parsed.sessionId}`);
-                    log(`[MONITOR-HANDLER]   - Bypassing queue to allow message insertion`);
                     void task().catch((err) => {
                         error(`XY gateway: concurrent steer task failed for ${messageKey}: ${String(err)}`);
                         activeMessages.delete(messageKey);
@@ -115,7 +112,6 @@ export async function monitorXYProvider(opts = {}) {
                 }
                 else {
                     // 正常模式：入队列串行执行
-                    log(`[MONITOR-HANDLER] 📋 NORMAL MODE: Enqueuing for messageKey=${messageKey}`);
                     void enqueue(sessionId, task).catch((err) => {
                         error(`XY gateway: queue processing failed for session ${sessionId}: ${String(err)}`);
                         activeMessages.delete(messageKey);
@@ -207,8 +203,8 @@ export async function monitorXYProvider(opts = {}) {
         wsManager.on("disconnected", disconnectedHandler);
         wsManager.on("error", errorHandler);
         wsManager.on("trigger-event", triggerEventHandler);
-        // Start periodic health check (every 5 minutes)
-        console.log("🏥 Starting periodic health check (every 5 minutes)...");
+        // Start periodic health check (every 6 hours)
+        console.log("🏥 Starting periodic health check (every 6 hours)...");
         healthCheckInterval = setInterval(() => {
             console.log("🏥 [HEALTH CHECK] Periodic WebSocket diagnostics...");
             diagnoseAllManagers();
@@ -217,7 +213,9 @@ export async function monitorXYProvider(opts = {}) {
             if (cleaned > 0) {
                 console.log(`🧹 [HEALTH CHECK] Auto-cleaned ${cleaned} manager(s) with orphan connections`);
             }
-        }, 5 * 60 * 1000); // 5 minutes
+            // Cleanup stale temp files (older than 24 hours)
+            void cleanupStaleTempFiles();
+        }, 6 * 60 * 60 * 1000); // 6 hours
         // Connect to WebSocket servers
         wsManager.connect()
             .then(() => {

package/dist/src/onboarding.d.ts

@@ -1,6 +1,5 @@
-import type { ChannelOnboardingAdapter } from "openclaw/plugin-sdk";
 /**
- * XY Channel Onboarding Adapter
- * Implements the ChannelOnboardingAdapter interface for OpenClaw's onboarding system
+ * XY Channel Onboarding Adapter (DISABLED - not currently used)
+ * NOTE: This is kept for future reference. Xiaoyi uses simple single-account config.
  */
-export declare const xyOnboardingAdapter: ChannelOnboardingAdapter;
+export declare const xyOnboardingAdapter: any;

package/dist/src/onboarding.js

@@ -152,8 +152,8 @@ async function configure({ cfg, prompter, }) {
     };
 }
 /**
- * XY Channel Onboarding Adapter
- * Implements the ChannelOnboardingAdapter interface for OpenClaw's onboarding system
+ * XY Channel Onboarding Adapter (DISABLED - not currently used)
+ * NOTE: This is kept for future reference. Xiaoyi uses simple single-account config.
  */
 export const xyOnboardingAdapter = {
     channel,

package/dist/src/outbound.d.ts

@@ -1,6 +1,7 @@
-import type { ChannelOutboundAdapter } from "openclaw/plugin-sdk";
+type ChannelOutboundAdapter = any;
 /**
  * Outbound adapter for sending messages from OpenClaw to XY.
  * Uses Push service for direct message delivery.
  */
 export declare const xyOutbound: ChannelOutboundAdapter;
+export {};

package/dist/src/outbound.js

@@ -90,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)
@@ -112,7 +105,7 @@ export const xyOutbound = {
         let pushDataId;
         try {
             pushDataId = await savePushData(text);
-            console.log(`[xyOutbound.sendText] ✅ Push data saved with ID: ${pushDataId}`);
+            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);
@@ -146,7 +139,6 @@ export const xyOutbound = {
         let failureCount = 0;
         for (const pushId of pushIdList) {
             try {
-                console.log(`[xyOutbound.sendText] Sending to pushId: ${pushId.substring(0, 20)}...`);
                 // 传入 pushId 和 pushDataId，使用 kind="data" 格式
                 await pushService.sendPush(pushText, title, undefined, actualTo, pushDataId, pushId);
                 successCount++;
@@ -158,8 +150,6 @@ export const xyOutbound = {
                 // 单个 pushId 发送失败不影响其他，继续处理下一个
             }
         }
-        console.log(`[xyOutbound.sendText] 📊 Broadcast summary: ${successCount} success, ${failureCount} failures`);
-        console.log(`[xyOutbound.sendText] Completed successfully`);
         // Return message info
         return {
             channel: "xiaoyi-channel",
@@ -168,14 +158,6 @@ export const xyOutbound = {
         };
     },
     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) {

package/dist/src/parser.d.ts

@@ -43,6 +43,12 @@ 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 deviceType from message parts.
+ * Looks for deviceType in data parts under variables.systemVariables.deviceType
+ * (same level as push_id).
+ */
+export declare function extractDeviceType(parts: A2AMessagePart[]): string | null;
 /**
  * Extract Trigger event data from message parts.
  * Looks for Trigger events with pushDataId in data parts.

package/dist/src/parser.js

@@ -72,6 +72,22 @@ export function extractPushId(parts) {
     }
     return null;
 }
+/**
+ * Extract deviceType from message parts.
+ * Looks for deviceType in data parts under variables.systemVariables.deviceType
+ * (same level as push_id).
+ */
+export function extractDeviceType(parts) {
+    for (const part of parts) {
+        if (part.kind === "data" && part.data) {
+            const deviceType = part.data.variables?.systemVariables?.device_type;
+            if (deviceType && typeof deviceType === "string") {
+                return deviceType;
+            }
+        }
+    }
+    return null;
+}
 /**
  * Extract Trigger event data from message parts.
  * Looks for Trigger events with pushDataId in data parts.

package/dist/src/provider.d.ts

@@ -0,0 +1,2 @@
+import type { ProviderPlugin } from "openclaw/plugin-sdk/provider-models";
+export declare const xiaoyiProvider: ProviderPlugin;

package/dist/src/provider.js

@@ -0,0 +1,124 @@
+// Xiaoyi Provider
+// Wraps any OpenAI-compatible endpoint and injects dynamic headers
+// (taskId, sessionId, conversationId) from the current XY channel session.
+// Falls back to uid-based values when no session context is available.
+//
+// Users configure the underlying model in config:
+//   models.providers.xiaoyiprovider.baseUrl = "https://..."
+//   models.providers.xiaoyiprovider.api = "openai-completions"
+//   models.providers.xiaoyiprovider.models = [...]
+import { createHash } from "crypto";
+import { getCurrentSessionContext } from "./tools/session-manager.js";
+/**
+ * Dynamic header keys injected via extraParams and forwarded to the HTTP request.
+ * Correspond to the three fields written to .xiaoyiruntime:
+ *   TASK_ID, SESSION_ID, CONVERSATION_ID
+ */
+const HEADER_TRACE_ID = "x-hag-trace-id";
+const HEADER_SESSION_ID = "x-session-id";
+const HEADER_INTERACTION_ID = "x-interaction-id";
+/**
+ * Encode uid via SHA-256 and take first 32 hex chars.
+ */
+function encodeUid(uid) {
+    return createHash("sha256").update(uid).digest("hex").slice(0, 32);
+}
+/**
+ * Get uid from plugin config (OpenClawConfig -> plugins -> xiaoyi-channel -> config).
+ */
+function getUidFromConfig(config) {
+    return config?.plugins?.entries?.["xiaoyi-channel"]?.config?.uid;
+}
+export const xiaoyiProvider = {
+    id: "xiaoyiprovider",
+    label: "Xiaoyi Provider",
+    docsPath: "/providers/models",
+    auth: [],
+    isCacheTtlEligible: () => true,
+    /**
+     * Inject dynamic session params into extraParams so they flow
+     * through to wrapStreamFn's ctx.extraParams.
+     *
+     * Priority:
+     *   1. Session context (from AsyncLocalStorage, set by bot.ts)
+     *   2. uid-based fallback: sha256(uid).hex[:32]_timestamp
+     *   3. No uid available → return undefined (no headers injected)
+     */
+    prepareExtraParams: (ctx) => {
+        const sessionCtx = getCurrentSessionContext();
+        if (sessionCtx) {
+            const taskId = sessionCtx.taskId;
+            const sessionId = taskId.split("&")[0];
+            const interactionId = taskId.split("&")[1] || "";
+            return {
+                ...ctx.extraParams,
+                [HEADER_TRACE_ID]: taskId,
+                [HEADER_SESSION_ID]: sessionId,
+                [HEADER_INTERACTION_ID]: interactionId,
+            };
+        }
+        // Fallback: uid-based values
+        const uid = getUidFromConfig(ctx.config);
+        if (!uid)
+            return undefined;
+        const prefix = encodeUid(uid);
+        const ts = Date.now();
+        const fallbackValue = `${prefix}_${ts}`;
+        return {
+            ...ctx.extraParams,
+            [HEADER_TRACE_ID]: fallbackValue,
+            [HEADER_SESSION_ID]: fallbackValue,
+            [HEADER_INTERACTION_ID]: fallbackValue,
+        };
+    },
+    /**
+     * Wrap the stream function to inject dynamic headers into every
+     * HTTP request to the model provider.
+     *
+     * Reads the values injected by prepareExtraParams and adds them
+     * as HTTP headers on the outgoing request.
+     */
+    wrapStreamFn: (ctx) => {
+        const underlying = ctx.streamFn;
+        if (!underlying)
+            return underlying;
+        return async (model, context, options) => {
+            // 每次请求时从 ctx.extraParams 动态读取 header
+            const dynamicHeaders = {};
+            if (ctx.extraParams) {
+                const traceId = ctx.extraParams[HEADER_TRACE_ID];
+                const sessionId = ctx.extraParams[HEADER_SESSION_ID];
+                const interactionId = ctx.extraParams[HEADER_INTERACTION_ID];
+                if (typeof traceId === "string")
+                    dynamicHeaders[HEADER_TRACE_ID] = traceId;
+                if (typeof sessionId === "string")
+                    dynamicHeaders[HEADER_SESSION_ID] = sessionId;
+                if (typeof interactionId === "string")
+                    dynamicHeaders[HEADER_INTERACTION_ID] = interactionId;
+            }
+            // 记录输入
+            console.log(`[xiaoyiprovider] input messages count: ${context.messages?.length ?? 0}`);
+            if (context.systemPrompt) {
+                console.log(`[xiaoyiprovider] system prompt length: ${context.systemPrompt.length}`);
+            }
+            // 在发送给模型前，删除 systemPrompt 中 ## Tooling 与 TOOLS.md 声明之间的内容
+            if (context.systemPrompt) {
+                const before = context.systemPrompt.length;
+                context.systemPrompt = context.systemPrompt.replace(/(## Tooling)[\s\S]*?(TOOLS\.md does not control tool availability; it is user guidance for how to use external tools\.)/, "$1\n\n$2");
+                console.log(`[xiaoyiprovider] system prompt trimmed: ${before} -> ${context.systemPrompt.length}`);
+            }
+            const stream = await underlying(model, context, {
+                ...options,
+                headers: {
+                    ...options?.headers,
+                    ...dynamicHeaders,
+                },
+            });
+            // 异步监听输出（不阻塞 stream 返回）
+            stream.result().then((result) => {
+                console.log(`[xiaoyiprovider] stream completed, usage: input=${result.usage?.input} output=${result.usage?.output}`);
+            }, (err) => console.log(`[xiaoyiprovider] stream error: ${JSON.stringify(err)}`));
+            return stream;
+        };
+    },
+};

package/dist/src/push.js

@@ -34,15 +34,7 @@ export class XYPushService {
         // 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}`);
         console.log(`[PUSH]   - Using pushId: ${actualPushId.substring(0, 20)}...`);
-        console.log(`[PUSH]   - Full pushId: ${actualPushId}`);
-        console.log(`[PUSH]   - API ID: ${this.config.apiId}`);
-        console.log(`[PUSH]   - UID: ${this.config.uid}`);
         try {
             const requestBody = {
                 jsonrpc: "2.0",
@@ -75,7 +67,6 @@ export class XYPushService {
                     ],
                 },
             };
-            console.log(`[PUSH] Full request body:`, JSON.stringify(requestBody, null, 2));
             const response = await fetch(pushUrl, {
                 method: "POST",
                 headers: {
@@ -91,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 = {};
@@ -120,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: ${actualPushId.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: ${actualPushId.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,33 +1,37 @@
-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 目录中的所有文件
+ * 清理 /tmp/xy_channel 目录中超过 24 小时的旧文件
  */
-async function cleanupTempDir(tempDir = "/tmp/xy_channel") {
+export async function cleanupStaleTempFiles(tempDir = "/tmp/xy_channel") {
     try {
         const stats = await fs.stat(tempDir).catch(() => null);
         if (!stats?.isDirectory()) {
-            return; // 目录不存在，直接返回
+            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 {
-                await fs.unlink(filePath);
-                cleanedCount++;
+                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} files from ${tempDir}`);
+            console.log(`[CLEANUP] 🧹 Cleaned ${cleanedCount} stale files (>${TEMP_FILE_TTL_MS / 1000 / 3600}h) from ${tempDir}`);
         }
     }
     catch (err) {
@@ -44,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;
@@ -63,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;
@@ -228,16 +235,17 @@ export function createXYReplyDispatcher(params) {
                         text: "任务执行异常，请重试~",
                         append: false,
                         final: true,
+                        errorCode: 99921111,
+                        errorMessage: "任务执行异常，请重试",
                     });
                     finalSent = true;
-                    log(`[ON_IDLE] ✅ Sent error response`);
+                    log(`[ON_IDLE] ✅ Sent error response with code: 99921111`);
                 }
                 catch (err) {
                     error(`[ON_IDLE] Failed to send error response:`, err);
                 }
             }
             stopStatusInterval();
-            void cleanupTempDir();
         },
         onCleanup: () => {
             const currentTaskId = getActiveTaskId();

package/dist/src/thread-bindings.d.ts

@@ -0,0 +1,54 @@
+import type { OpenClawConfig } from "openclaw/plugin-sdk/config-runtime";
+import { type BindingTargetKind } from "openclaw/plugin-sdk/conversation-runtime";
+type XYBindingTargetKind = "subagent" | "session";
+/**
+ * Xiaoyi thread binding record.
+ * Simplified from feishu - uses sessionId as conversationId, no parentConversationId.
+ */
+type XYThreadBindingRecord = {
+    accountId: string;
+    sessionId: string;
+    targetKind: XYBindingTargetKind;
+    targetSessionKey: string;
+    agentId?: string;
+    boundAt: number;
+    lastActivityAt: number;
+};
+/**
+ * Thread binding manager for Xiaoyi channel.
+ * Manages session bindings for single-account mode.
+ */
+type XYThreadBindingManager = {
+    accountId: string;
+    getBySessionId: (sessionId: string) => XYThreadBindingRecord | undefined;
+    listBySessionKey: (targetSessionKey: string) => XYThreadBindingRecord[];
+    bindSession: (params: {
+        sessionId: string;
+        targetKind: BindingTargetKind;
+        targetSessionKey: string;
+        metadata?: Record<string, unknown>;
+    }) => XYThreadBindingRecord | null;
+    touchSession: (sessionId: string, at?: number) => XYThreadBindingRecord | null;
+    unbindSession: (sessionId: string) => XYThreadBindingRecord | null;
+    unbindBySessionKey: (targetSessionKey: string) => XYThreadBindingRecord[];
+    stop: () => void;
+};
+/**
+ * Creates a thread binding manager for Xiaoyi channel.
+ * Based on feishu implementation but simplified for single-account mode.
+ */
+export declare function createXYThreadBindingManager(params: {
+    accountId?: string;
+    cfg: OpenClawConfig;
+}): XYThreadBindingManager;
+/**
+ * Gets the thread binding manager for a given account ID.
+ */
+export declare function getXYThreadBindingManager(accountId?: string): XYThreadBindingManager | null;
+/**
+ * Testing utilities for thread bindings.
+ */
+export declare const __testing: {
+    resetXYThreadBindingsForTests(): void;
+};
+export {};