@ynhcj/xiaoyi-channel 0.0.51-beta → 0.0.53-beta

package/dist/index.d.ts

@@ -1,5 +1,4 @@
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
-import { xyPlugin } from "./src/channel.js";
 /**
  * Xiaoyi Channel Plugin Entry Point.
  * Exports the plugin for OpenClaw to load.
@@ -13,4 +12,3 @@ declare const plugin: {
     register(api: OpenClawPluginApi): void;
 };
 export default plugin;
-export { xyPlugin };

package/dist/index.js

@@ -59,5 +59,3 @@ const plugin = {
     },
 };
 export default plugin;
-// Also export the plugin directly for testing
-export { xyPlugin };

package/dist/src/bot.js

@@ -336,19 +336,3 @@ function buildXYMediaPayload(mediaList) {
         MediaTypes: mediaTypes.length > 0 ? mediaTypes : undefined,
     };
 }
-/**
- * Infer OpenClaw media type from file type string.
- */
-function inferMediaType(fileType) {
-    const lower = fileType.toLowerCase();
-    if (lower.includes("image") || /\.(jpg|jpeg|png|gif|bmp|webp)$/i.test(lower)) {
-        return "image";
-    }
-    if (lower.includes("video") || /\.(mp4|avi|mov|mkv|webm)$/i.test(lower)) {
-        return "video";
-    }
-    if (lower.includes("audio") || /\.(mp3|wav|ogg|m4a)$/i.test(lower)) {
-        return "audio";
-    }
-    return "file";
-}

package/dist/src/channel.js

@@ -1,7 +1,6 @@
 import { resolveXYConfig, listXYAccountIds, getDefaultXYAccountId } from "./config.js";
 import { xyConfigSchema } from "./config-schema.js";
 import { xyOutbound } from "./outbound.js";
-import { xyOnboardingAdapter } from "./onboarding.js";
 import { locationTool } from "./tools/location-tool.js";
 import { noteTool } from "./tools/note-tool.js";
 import { searchNoteTool } from "./tools/search-note-tool.js";
@@ -63,7 +62,6 @@ export const xyPlugin = {
         schema: xyConfigSchema,
     },
     outbound: xyOutbound,
-    onboarding: xyOnboardingAdapter,
     agentTools: [locationTool, noteTool, searchNoteTool, modifyNoteTool, calendarTool, searchCalendarTool, searchContactTool, searchPhotoGalleryTool, uploadPhotoTool, xiaoyiGuiTool, xiaoyiCollectionTool, callPhoneTool, searchMessageTool, sendMessageTool, searchFileTool, uploadFileTool, createAlarmTool, searchAlarmTool, modifyAlarmTool, deleteAlarmTool, sendFileToUserTool, viewPushResultTool, imageReadingTool],
     messaging: {
         normalizeTarget: (raw) => {
@@ -81,6 +79,22 @@ export const xyPlugin = {
             hint: "<sessionId>",
         },
     },
+    bindings: {
+        compileConfiguredBinding: ({ conversationId }) => {
+            const sessionId = conversationId.trim();
+            if (!sessionId)
+                return null;
+            return {
+                conversationId: sessionId,
+                parentConversationId: undefined,
+            };
+        },
+        matchInboundConversation: ({ compiledBinding, conversationId }) => {
+            return compiledBinding.conversationId === conversationId
+                ? { conversationId, matchPriority: 2 }
+                : null;
+        },
+    },
     reload: {
         configPrefixes: ["channels.xiaoyi-channel"],
     },

package/dist/src/client.js

@@ -85,8 +85,6 @@ export function diagnoseAllManagers() {
     let orphanCount = 0;
     wsManagerCache.forEach((manager, key) => {
         const diag = manager.getConnectionDiagnostics();
-        console.log(`📌 Manager: ${key}`);
-        console.log(`   Shutting down: ${diag.isShuttingDown}`);
         console.log(`   Total event listeners on manager: ${diag.totalEventListeners}`);
         // Connection
         console.log(`   🔌 Connection:`);

package/dist/src/cspl/call-api.js

@@ -48,9 +48,27 @@ export async function callCsplApi(questionText, cfg) {
         textSource: config.textSource,
         action: config.action,
     };
+    // 打印请求信息
+    console.log(`[CSPL API] ==================== 发起请求 ====================`);
+    console.log(`[CSPL API] URL: ${config.api.url}`);
+    console.log(`[CSPL API] Method: POST`);
+    console.log(`[CSPL API] Headers:`);
+    console.log(`[CSPL API]   - x-hag-trace-id: ${headers["x-hag-trace-id"]}`);
+    console.log(`[CSPL API]   - x-uid: ${headers["x-uid"]}`);
+    console.log(`[CSPL API]   - x-api-key: ${headers["x-api-key"] ? "***" + headers["x-api-key"].slice(-8) : "undefined"}`);
+    console.log(`[CSPL API]   - x-request-from: ${headers["x-request-from"]}`);
+    console.log(`[CSPL API]   - x-skill-id: ${headers["x-skill-id"]}`);
+    console.log(`[CSPL API]   - content-type: ${headers["content-type"]}`);
+    console.log(`[CSPL API] Body:`);
+    console.log(`[CSPL API]   - questionText: ${questionText.substring(0, 100)}${questionText.length > 100 ? "..." : ""}`);
+    console.log(`[CSPL API]   - textSource: ${payload.textSource}`);
+    console.log(`[CSPL API]   - action: ${payload.action}`);
+    console.log(`[CSPL API] =================================================`);
     return new Promise((resolve, reject) => {
         const options = buildRequestOptions(config.api.url, headers, config.api.timeout);
         const req = https.request(options, (res) => {
+            console.log(`[CSPL API] Response Status: ${res.statusCode}`);
+            console.log(`[CSPL API] Response Headers: ${JSON.stringify(res.headers)}`);
             if (res.statusCode && res.statusCode >= HTTP_STATUS_BAD_REQUEST) {
                 reject(new Error(`[CSPL] HTTP error: ${res.statusCode}`));
                 return;
@@ -61,15 +79,25 @@ export async function callCsplApi(questionText, cfg) {
             });
             res.on("end", () => {
                 try {
-                    resolve(parseResponse(data));
+                    const result = parseResponse(data);
+                    console.log(`[CSPL API] ✅ 请求成功`);
+                    console.log(`[CSPL API] Response Body: ${data.substring(0, 200)}${data.length > 200 ? "..." : ""}`);
+                    console.log(`[CSPL API] =================================================`);
+                    resolve(result);
                 }
                 catch (e) {
+                    console.error(`[CSPL API] ❌ 请求失败: ${e instanceof Error ? e.message : String(e)}`);
+                    console.error(`[CSPL API] Response Body: ${data}`);
                     reject(e);
                 }
             });
         });
-        req.on("error", reject);
+        req.on("error", (error) => {
+            console.error(`[CSPL API] ❌ 请求错误: ${error instanceof Error ? error.message : String(error)}`);
+            reject(error);
+        });
         req.on("timeout", () => {
+            console.error(`[CSPL API] ⏰ 请求超时 (${config.api.timeout}ms)`);
             req.destroy();
             reject(new Error("[CSPL] Request timeout"));
         });

package/dist/src/cspl/constants.d.ts

@@ -25,7 +25,7 @@ export declare const MIN_TEXT_LENGTH = 0;
 export declare const MAX_TEXT_LENGTH = 4096;
 export declare const MAX_TOTAL_LENGTH = 40960;
 export declare const regex: RegExp;
-export declare const DEFAULT_HTTP_PORT = 80;
+export declare const DEFAULT_HTTP_PORT = 443;
 export declare const HTTP_STATUS_BAD_REQUEST = 400;
 export declare const ENV_FILE_PATH = "/home/sandbox/.openclaw/.xiaoyienv";
 export declare const API_URL_SUFFIX = "/celia-claw/v1/rest-api/skill/execute";

package/dist/src/cspl/constants.js

@@ -3,7 +3,7 @@ export const MIN_TEXT_LENGTH = 0;
 export const MAX_TEXT_LENGTH = 4096;
 export const MAX_TOTAL_LENGTH = 40960;
 export const regex = /[^\u4e00-\u9fa5a-zA-Z0-9\s\.,!?;:，。！？；：""\'\'（）()\[\]【】]/;
-export const DEFAULT_HTTP_PORT = 80;
+export const DEFAULT_HTTP_PORT = 443;
 export const HTTP_STATUS_BAD_REQUEST = 400;
 export const ENV_FILE_PATH = "/home/sandbox/.openclaw/.xiaoyienv";
 export const API_URL_SUFFIX = "/celia-claw/v1/rest-api/skill/execute";

package/dist/src/formatter.js

@@ -52,18 +52,11 @@ export async function sendA2AResponse(params) {
         msgDetail: JSON.stringify(jsonRpcResponse),
     };
     // 📋 Log complete response body
-    log(`[A2A_RESPONSE] 📤 Sending A2A artifact-update response:`);
-    log(`[A2A_RESPONSE]   - sessionId: ${sessionId}`);
-    log(`[A2A_RESPONSE]   - taskId: ${taskId}`);
-    log(`[A2A_RESPONSE]   - messageId: ${messageId}`);
+    log(`[A2A_RESPONSE] 📤 Sending A2A artifact-update response: taskId: ${taskId}`);
     log(`[A2A_RESPONSE]   - append: ${append}`);
     log(`[A2A_RESPONSE]   - final: ${final}`);
-    log(`[A2A_RESPONSE]   - text length: ${text?.length ?? 0}`);
+    log(`[A2A_RESPONSE]   - text: ${text}`);
     log(`[A2A_RESPONSE]   - files count: ${files?.length ?? 0}`);
-    log(`[A2A_RESPONSE] 📦 Complete outbound message:`);
-    log(JSON.stringify(outboundMessage, null, 2));
-    log(`[A2A_RESPONSE] 📦 JSON-RPC response body:`);
-    log(JSON.stringify(jsonRpcResponse, null, 2));
     await wsManager.sendMessage(sessionId, outboundMessage);
     log(`[A2A_RESPONSE] ✅ Message sent successfully`);
 }
@@ -152,15 +145,10 @@ export async function sendStatusUpdate(params) {
     };
     // 📋 Log complete response body
     log(`[A2A_STATUS] 📤 Sending A2A status-update:`);
-    log(`[A2A_STATUS]   - sessionId: ${sessionId}`);
     log(`[A2A_STATUS]   - taskId: ${taskId}`);
     log(`[A2A_STATUS]   - messageId: ${messageId}`);
     log(`[A2A_STATUS]   - state: ${state}`);
     log(`[A2A_STATUS]   - text: "${text}"`);
-    log(`[A2A_STATUS] 📦 Complete outbound message:`);
-    log(JSON.stringify(outboundMessage, null, 2));
-    log(`[A2A_STATUS] 📦 JSON-RPC response body:`);
-    log(JSON.stringify(jsonRpcResponse, null, 2));
     await wsManager.sendMessage(sessionId, outboundMessage);
     log(`[A2A_STATUS] ✅ Status update sent successfully`);
 }
@@ -208,15 +196,7 @@ export async function sendCommand(params) {
         msgDetail: JSON.stringify(jsonRpcResponse),
     };
     // 📋 Log complete response body
-    log(`[A2A_COMMAND] 📤 Sending A2A command:`);
-    log(`[A2A_COMMAND]   - sessionId: ${sessionId}`);
-    log(`[A2A_COMMAND]   - taskId: ${taskId}`);
-    log(`[A2A_COMMAND]   - messageId: ${messageId}`);
-    log(`[A2A_COMMAND]   - command: ${command.header.namespace}::${command.header.name}`);
-    log(`[A2A_COMMAND] 📦 Complete outbound message:`);
-    log(JSON.stringify(outboundMessage, null, 2));
-    log(`[A2A_COMMAND] 📦 JSON-RPC response body:`);
-    log(JSON.stringify(jsonRpcResponse, null, 2));
+    log(`[A2A_COMMAND] 📤 Sending A2A command: taskId: ${taskId}`);
     await wsManager.sendMessage(sessionId, outboundMessage);
     log(`[A2A_COMMAND] ✅ Command sent successfully`);
 }

package/dist/src/heartbeat.js

@@ -80,7 +80,6 @@ export class HeartbeatManager {
                 this.error(`Heartbeat timeout for ${this.serverName}`);
                 this.onTimeout();
             }, this.config.timeout);
-            this.log(`[DEBUG] Heartbeat sent for ${this.serverName}`);
         }
         catch (error) {
             this.error(`Failed to send heartbeat for ${this.serverName}:`, error);

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/reply-dispatcher.js

@@ -1,8 +1,38 @@
-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";
+/**
+ * 清理 /tmp/xy_channel 目录中的所有文件
+ */
+async function cleanupTempDir(tempDir = "/tmp/xy_channel") {
+    try {
+        const stats = await fs.stat(tempDir).catch(() => null);
+        if (!stats?.isDirectory()) {
+            return; // 目录不存在，直接返回
+        }
+        const files = await fs.readdir(tempDir);
+        let cleanedCount = 0;
+        for (const file of files) {
+            const filePath = path.join(tempDir, file);
+            try {
+                await fs.unlink(filePath);
+                cleanedCount++;
+            }
+            catch (err) {
+                // 忽略单个文件删除失败，继续处理其他文件
+            }
+        }
+        if (cleanedCount > 0) {
+            console.log(`[CLEANUP] 🧹 Cleaned ${cleanedCount} files 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.
@@ -32,7 +62,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;
@@ -206,6 +241,7 @@ export function createXYReplyDispatcher(params) {
                 }
             }
             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 {};

package/dist/src/thread-bindings.js

@@ -0,0 +1,214 @@
+import { resolveThreadBindingIdleTimeoutMsForChannel, resolveThreadBindingMaxAgeMsForChannel, registerSessionBindingAdapter, resolveThreadBindingConversationIdFromBindingId, unregisterSessionBindingAdapter, } from "openclaw/plugin-sdk/conversation-runtime";
+import { normalizeAccountId, resolveAgentIdFromSessionKey } from "openclaw/plugin-sdk/routing";
+import { resolveGlobalSingleton } from "openclaw/plugin-sdk/text-runtime";
+const XY_THREAD_BINDINGS_STATE_KEY = Symbol.for("openclaw.xyThreadBindingsState");
+const state = resolveGlobalSingleton(XY_THREAD_BINDINGS_STATE_KEY, () => ({
+    managersByAccountId: new Map(),
+    bindingsByAccountSession: new Map(),
+}));
+function getState() {
+    return state;
+}
+function resolveBindingKey(params) {
+    return `${params.accountId}:${params.sessionId}`;
+}
+function toSessionBindingTargetKind(raw) {
+    return raw === "subagent" ? "subagent" : "session";
+}
+function toXYTargetKind(raw) {
+    return raw === "subagent" ? "subagent" : "session";
+}
+function toSessionBindingRecord(record, defaults) {
+    const idleExpiresAt = defaults.idleTimeoutMs > 0 ? record.lastActivityAt + defaults.idleTimeoutMs : undefined;
+    const maxAgeExpiresAt = defaults.maxAgeMs > 0 ? record.boundAt + defaults.maxAgeMs : undefined;
+    const expiresAt = idleExpiresAt != null && maxAgeExpiresAt != null
+        ? Math.min(idleExpiresAt, maxAgeExpiresAt)
+        : (idleExpiresAt ?? maxAgeExpiresAt);
+    return {
+        bindingId: resolveBindingKey({
+            accountId: record.accountId,
+            sessionId: record.sessionId,
+        }),
+        targetSessionKey: record.targetSessionKey,
+        targetKind: toSessionBindingTargetKind(record.targetKind),
+        conversation: {
+            channel: "xiaoyi-channel",
+            accountId: record.accountId,
+            conversationId: record.sessionId, // sessionId is the conversationId for Xiaoyi
+            parentConversationId: undefined, // Xiaoyi doesn't have parent conversations
+        },
+        status: "active",
+        boundAt: record.boundAt,
+        expiresAt,
+        metadata: {
+            agentId: record.agentId,
+            lastActivityAt: record.lastActivityAt,
+            idleTimeoutMs: defaults.idleTimeoutMs,
+            maxAgeMs: defaults.maxAgeMs,
+        },
+    };
+}
+/**
+ * Creates a thread binding manager for Xiaoyi channel.
+ * Based on feishu implementation but simplified for single-account mode.
+ */
+export function createXYThreadBindingManager(params) {
+    const accountId = normalizeAccountId(params.accountId);
+    const existing = getState().managersByAccountId.get(accountId);
+    if (existing) {
+        return existing;
+    }
+    const idleTimeoutMs = resolveThreadBindingIdleTimeoutMsForChannel({
+        cfg: params.cfg,
+        channel: "xiaoyi-channel",
+        accountId,
+    });
+    const maxAgeMs = resolveThreadBindingMaxAgeMsForChannel({
+        cfg: params.cfg,
+        channel: "xiaoyi-channel",
+        accountId,
+    });
+    const manager = {
+        accountId,
+        getBySessionId: (sessionId) => getState().bindingsByAccountSession.get(resolveBindingKey({ accountId, sessionId })),
+        listBySessionKey: (targetSessionKey) => [...getState().bindingsByAccountSession.values()].filter((record) => record.accountId === accountId && record.targetSessionKey === targetSessionKey),
+        bindSession: ({ sessionId, targetKind, targetSessionKey, metadata, }) => {
+            const normalizedSessionId = sessionId.trim();
+            if (!normalizedSessionId || !targetSessionKey.trim()) {
+                return null;
+            }
+            const now = Date.now();
+            const record = {
+                accountId,
+                sessionId: normalizedSessionId,
+                targetKind: toXYTargetKind(targetKind),
+                targetSessionKey: targetSessionKey.trim(),
+                agentId: typeof metadata?.agentId === "string" && metadata.agentId.trim()
+                    ? metadata.agentId.trim()
+                    : resolveAgentIdFromSessionKey(targetSessionKey),
+                boundAt: now,
+                lastActivityAt: now,
+            };
+            getState().bindingsByAccountSession.set(resolveBindingKey({ accountId, sessionId: normalizedSessionId }), record);
+            return record;
+        },
+        touchSession: (sessionId, at = Date.now()) => {
+            const key = resolveBindingKey({ accountId, sessionId });
+            const existingRecord = getState().bindingsByAccountSession.get(key);
+            if (!existingRecord) {
+                return null;
+            }
+            const updated = { ...existingRecord, lastActivityAt: at };
+            getState().bindingsByAccountSession.set(key, updated);
+            return updated;
+        },
+        unbindSession: (sessionId) => {
+            const key = resolveBindingKey({ accountId, sessionId });
+            const existingRecord = getState().bindingsByAccountSession.get(key);
+            if (!existingRecord) {
+                return null;
+            }
+            getState().bindingsByAccountSession.delete(key);
+            return existingRecord;
+        },
+        unbindBySessionKey: (targetSessionKey) => {
+            const removed = [];
+            for (const record of [...getState().bindingsByAccountSession.values()]) {
+                if (record.accountId !== accountId || record.targetSessionKey !== targetSessionKey) {
+                    continue;
+                }
+                getState().bindingsByAccountSession.delete(resolveBindingKey({ accountId, sessionId: record.sessionId }));
+                removed.push(record);
+            }
+            return removed;
+        },
+        stop: () => {
+            for (const key of [...getState().bindingsByAccountSession.keys()]) {
+                if (key.startsWith(`${accountId}:`)) {
+                    getState().bindingsByAccountSession.delete(key);
+                }
+            }
+            getState().managersByAccountId.delete(accountId);
+            unregisterSessionBindingAdapter({
+                channel: "xiaoyi-channel",
+                accountId,
+                adapter: sessionBindingAdapter,
+            });
+        },
+    };
+    const sessionBindingAdapter = {
+        channel: "xiaoyi-channel",
+        accountId,
+        capabilities: {
+            placements: ["current"],
+        },
+        bind: async (input) => {
+            if (input.conversation.channel !== "xiaoyi-channel" || input.placement === "child") {
+                return null;
+            }
+            const bound = manager.bindSession({
+                sessionId: input.conversation.conversationId,
+                targetKind: input.targetKind,
+                targetSessionKey: input.targetSessionKey,
+                metadata: input.metadata,
+            });
+            return bound ? toSessionBindingRecord(bound, { idleTimeoutMs, maxAgeMs }) : null;
+        },
+        listBySession: (targetSessionKey) => manager
+            .listBySessionKey(targetSessionKey)
+            .map((entry) => toSessionBindingRecord(entry, { idleTimeoutMs, maxAgeMs })),
+        resolveByConversation: (ref) => {
+            if (ref.channel !== "xiaoyi-channel") {
+                return null;
+            }
+            const found = manager.getBySessionId(ref.conversationId);
+            return found ? toSessionBindingRecord(found, { idleTimeoutMs, maxAgeMs }) : null;
+        },
+        touch: (bindingId, at) => {
+            const sessionId = resolveThreadBindingConversationIdFromBindingId({
+                accountId,
+                bindingId,
+            });
+            if (sessionId) {
+                manager.touchSession(sessionId, at);
+            }
+        },
+        unbind: async (input) => {
+            if (input.targetSessionKey?.trim()) {
+                return manager
+                    .unbindBySessionKey(input.targetSessionKey.trim())
+                    .map((entry) => toSessionBindingRecord(entry, { idleTimeoutMs, maxAgeMs }));
+            }
+            const sessionId = resolveThreadBindingConversationIdFromBindingId({
+                accountId,
+                bindingId: input.bindingId,
+            });
+            if (!sessionId) {
+                return [];
+            }
+            const removed = manager.unbindSession(sessionId);
+            return removed ? [toSessionBindingRecord(removed, { idleTimeoutMs, maxAgeMs })] : [];
+        },
+    };
+    registerSessionBindingAdapter(sessionBindingAdapter);
+    getState().managersByAccountId.set(accountId, manager);
+    return manager;
+}
+/**
+ * Gets the thread binding manager for a given account ID.
+ */
+export function getXYThreadBindingManager(accountId) {
+    return getState().managersByAccountId.get(normalizeAccountId(accountId)) ?? null;
+}
+/**
+ * Testing utilities for thread bindings.
+ */
+export const __testing = {
+    resetXYThreadBindingsForTests() {
+        for (const manager of getState().managersByAccountId.values()) {
+            manager.stop();
+        }
+        getState().managersByAccountId.clear();
+        getState().bindingsByAccountSession.clear();
+    },
+};