crewly 1.4.69 → 1.4.70

package/dist/backend/backend/src/services/messaging/adapters/wechat-messenger.adapter.js

@@ -0,0 +1,69 @@
+/**
+ * WeChat Messenger Adapter
+ *
+ * Implements the MessengerAdapter interface for the WeChat iLink Bot.
+ * Delegates to WeChatService for actual operations.
+ *
+ * @module services/messaging/adapters/wechat-messenger.adapter
+ */
+import { getWeChatService } from '../../wechat/wechat.service.js';
+import { WeChatBridge } from '../../wechat/wechat-bridge.service.js';
+/**
+ * Messenger adapter for WeChat using the iLink Bot API.
+ */
+export class WeChatMessengerAdapter {
+    platform = 'wechat';
+    /**
+     * Initialize the adapter by restoring persisted WeChat connection.
+     *
+     * @param config - Configuration (unused — token loaded from disk)
+     */
+    async initialize(config) {
+        const service = getWeChatService();
+        await service.tryRestore();
+    }
+    /**
+     * Send a text message via WeChat.
+     *
+     * Uses the WeChatBridge to find the context token for the channel
+     * (conversation ID) and send the reply.
+     *
+     * @param channel - Conversation ID (e.g., "wechat-user123")
+     * @param text - Message content
+     * @param _options - Send options (unused for WeChat)
+     */
+    async sendMessage(channel, text, _options) {
+        const bridge = WeChatBridge.getInstance();
+        const contextToken = bridge.getContextToken(channel);
+        if (!contextToken) {
+            throw new Error(`No WeChat context token for channel: ${channel}`);
+        }
+        const service = getWeChatService();
+        await service.sendMessage(text, contextToken);
+    }
+    /**
+     * Get the current connection status.
+     *
+     * @returns Status object with connection state
+     */
+    getStatus() {
+        const service = getWeChatService();
+        const status = service.getStatus();
+        return {
+            connected: service.isConnected(),
+            platform: this.platform,
+            details: {
+                state: status.state,
+                botName: status.botName,
+            },
+        };
+    }
+    /**
+     * Disconnect the WeChat service.
+     */
+    async disconnect() {
+        const service = getWeChatService();
+        service.disconnect();
+    }
+}
+//# sourceMappingURL=wechat-messenger.adapter.js.map

package/dist/backend/backend/src/services/messaging/adapters/wechat-messenger.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wechat-messenger.adapter.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/messaging/adapters/wechat-messenger.adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAGrE;;GAEG;AACH,MAAM,OAAO,sBAAsB;IACxB,QAAQ,GAAG,QAA6B,CAAC;IAElD;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,MAA+B;QAC9C,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC;QACnC,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;IAC7B,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,WAAW,CAAC,OAAe,EAAE,IAAY,EAAE,QAAsB;QACrE,MAAM,MAAM,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;QAC1C,MAAM,YAAY,GAAG,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QAErD,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,wCAAwC,OAAO,EAAE,CAAC,CAAC;QACrE,CAAC;QAED,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC;QACnC,MAAM,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAChD,CAAC;IAED;;;;OAIG;IACH,SAAS;QACP,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;QAEnC,OAAO;YACL,SAAS,EAAE,OAAO,CAAC,WAAW,EAAE;YAChC,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO,EAAE;gBACP,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,OAAO,EAAE,MAAM,CAAC,OAAO;aACxB;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC;QACnC,OAAO,CAAC,UAAU,EAAE,CAAC;IACvB,CAAC;CACF"}

package/dist/backend/backend/src/services/messaging/messenger-adapter.interface.d.ts

@@ -1,7 +1,7 @@
 /**
  * Supported messenger platforms.
  */
-export type MessengerPlatform = 'slack' | 'telegram' | 'discord' | 'google-chat';
+export type MessengerPlatform = 'slack' | 'telegram' | 'discord' | 'google-chat' | 'wechat';
 /**
  * A message received from any messenger platform.
  */

package/dist/backend/backend/src/services/messaging/messenger-adapter.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messenger-adapter.interface.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/messaging/messenger-adapter.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,aAAa,CAAC;AAEjF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,+CAA+C;IAC/C,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,gDAAgD;IAChD,cAAc,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4FAA4F;IAC5F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,kEAAkE;IAClE,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,mDAAmD;IACnD,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjF,wCAAwC;IACxC,SAAS,IAAI;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,iBAAiB,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IACpG,wCAAwC;IACxC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B"}
+{"version":3,"file":"messenger-adapter.interface.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/messaging/messenger-adapter.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,QAAQ,CAAC;AAE5F;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,+CAA+C;IAC/C,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,gDAAgD;IAChD,cAAc,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4FAA4F;IAC5F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,kEAAkE;IAClE,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,mDAAmD;IACnD,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjF,wCAAwC;IACxC,SAAS,IAAI;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,iBAAiB,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IACpG,wCAAwC;IACxC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B"}

package/dist/backend/backend/src/services/wechat/wechat-bridge.service.d.ts

@@ -0,0 +1,69 @@
+/**
+ * WeChat Orchestrator Bridge
+ *
+ * Routes incoming WeChat messages to the orchestrator message queue
+ * and sends orchestrator replies back via WeChat.
+ *
+ * Similar to SlackOrchestratorBridge but for the WeChat iLink Bot channel.
+ *
+ * @module services/wechat/wechat-bridge.service
+ */
+/** Minimal interface for MessageQueueService to avoid circular imports. */
+interface IMessageQueueServiceLike {
+    enqueue(input: {
+        content: string;
+        conversationId: string;
+        source: 'wechat';
+        sourceMetadata?: Record<string, string>;
+    }): unknown;
+}
+/**
+ * Bridge between WeChat messages and the orchestrator.
+ *
+ * Listens for 'message' events from WeChatService and enqueues them
+ * into the orchestrator message queue. Stores context_token per
+ * conversation so replies can be routed back through WeChat.
+ */
+export declare class WeChatBridge {
+    private static instance;
+    private readonly logger;
+    private messageQueue;
+    private contextTokens;
+    private initialized;
+    private constructor();
+    /**
+     * Get the singleton instance.
+     *
+     * @returns WeChatBridge instance
+     */
+    static getInstance(): WeChatBridge;
+    /**
+     * Initialize the bridge with the message queue service.
+     *
+     * @param messageQueue - The orchestrator message queue for enqueuing messages
+     */
+    initialize(messageQueue: IMessageQueueServiceLike): void;
+    /**
+     * Send a reply back to WeChat using the stored context token.
+     *
+     * @param conversationId - The conversation ID to reply to
+     * @param text - Reply text
+     * @returns True if sent successfully
+     */
+    sendReply(conversationId: string, text: string): Promise<boolean>;
+    /**
+     * Get the stored context token for a conversation.
+     *
+     * @param conversationId - Conversation ID
+     * @returns Context token or undefined
+     */
+    getContextToken(conversationId: string): string | undefined;
+    /**
+     * Handle an incoming WeChat message by enqueuing it for the orchestrator.
+     *
+     * @param msg - Incoming WeChat message
+     */
+    private handleIncomingMessage;
+}
+export {};
+//# sourceMappingURL=wechat-bridge.service.d.ts.map

package/dist/backend/backend/src/services/wechat/wechat-bridge.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wechat-bridge.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/wechat/wechat-bridge.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,2EAA2E;AAC3E,UAAU,wBAAwB;IAChC,OAAO,CAAC,KAAK,EAAE;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,cAAc,EAAE,MAAM,CAAC;QACvB,MAAM,EAAE,QAAQ,CAAC;QACjB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACzC,GAAG,OAAO,CAAC;CACb;AAED;;;;;;GAMG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA6B;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,YAAY,CAAyC;IAC7D,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,WAAW,CAAS;IAE5B,OAAO;IAIP;;;;OAIG;IACH,MAAM,CAAC,WAAW,IAAI,YAAY;IAOlC;;;;OAIG;IACH,UAAU,CAAC,YAAY,EAAE,wBAAwB,GAAG,IAAI;IAgBxD;;;;;;OAMG;IACG,SAAS,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAoBvE;;;;;OAKG;IACH,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAQ3D;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;CAmC9B"}

package/dist/backend/backend/src/services/wechat/wechat-bridge.service.js

@@ -0,0 +1,133 @@
+/**
+ * WeChat Orchestrator Bridge
+ *
+ * Routes incoming WeChat messages to the orchestrator message queue
+ * and sends orchestrator replies back via WeChat.
+ *
+ * Similar to SlackOrchestratorBridge but for the WeChat iLink Bot channel.
+ *
+ * @module services/wechat/wechat-bridge.service
+ */
+import { LoggerService } from '../core/logger.service.js';
+import { getWeChatService } from './wechat.service.js';
+/**
+ * Bridge between WeChat messages and the orchestrator.
+ *
+ * Listens for 'message' events from WeChatService and enqueues them
+ * into the orchestrator message queue. Stores context_token per
+ * conversation so replies can be routed back through WeChat.
+ */
+export class WeChatBridge {
+    static instance = null;
+    logger;
+    messageQueue = null;
+    contextTokens = new Map();
+    initialized = false;
+    constructor() {
+        this.logger = LoggerService.getInstance().createComponentLogger('WeChatBridge');
+    }
+    /**
+     * Get the singleton instance.
+     *
+     * @returns WeChatBridge instance
+     */
+    static getInstance() {
+        if (!WeChatBridge.instance) {
+            WeChatBridge.instance = new WeChatBridge();
+        }
+        return WeChatBridge.instance;
+    }
+    /**
+     * Initialize the bridge with the message queue service.
+     *
+     * @param messageQueue - The orchestrator message queue for enqueuing messages
+     */
+    initialize(messageQueue) {
+        if (this.initialized)
+            return;
+        this.messageQueue = messageQueue;
+        const wechat = getWeChatService();
+        wechat.on('message', (msg) => this.handleIncomingMessage(msg));
+        wechat.on('disconnected', () => {
+            this.logger.info('WeChat disconnected — bridge paused');
+            this.contextTokens.clear();
+        });
+        this.initialized = true;
+        this.logger.info('WeChat bridge initialized');
+    }
+    /**
+     * Send a reply back to WeChat using the stored context token.
+     *
+     * @param conversationId - The conversation ID to reply to
+     * @param text - Reply text
+     * @returns True if sent successfully
+     */
+    async sendReply(conversationId, text) {
+        const contextToken = this.contextTokens.get(conversationId);
+        if (!contextToken) {
+            this.logger.warn('No context token for WeChat reply', { conversationId });
+            return false;
+        }
+        try {
+            const wechat = getWeChatService();
+            await wechat.sendMessage(text, contextToken);
+            return true;
+        }
+        catch (err) {
+            this.logger.error('Failed to send WeChat reply', {
+                conversationId,
+                error: err instanceof Error ? err.message : String(err),
+            });
+            return false;
+        }
+    }
+    /**
+     * Get the stored context token for a conversation.
+     *
+     * @param conversationId - Conversation ID
+     * @returns Context token or undefined
+     */
+    getContextToken(conversationId) {
+        return this.contextTokens.get(conversationId);
+    }
+    // -------------------------------------------------------------------------
+    // Internal
+    // -------------------------------------------------------------------------
+    /**
+     * Handle an incoming WeChat message by enqueuing it for the orchestrator.
+     *
+     * @param msg - Incoming WeChat message
+     */
+    handleIncomingMessage(msg) {
+        if (!this.messageQueue) {
+            this.logger.warn('Message queue not available, dropping WeChat message');
+            return;
+        }
+        // Skip non-text messages
+        if (msg.msg_type !== 'text') {
+            this.logger.debug('Skipping non-text WeChat message', { msgType: msg.msg_type });
+            return;
+        }
+        // Store context token for reply routing
+        const conversationId = `wechat-${msg.from_user}`;
+        this.contextTokens.set(conversationId, msg.context_token);
+        // Enqueue for orchestrator processing
+        this.messageQueue.enqueue({
+            content: msg.content,
+            conversationId,
+            source: 'wechat',
+            sourceMetadata: {
+                fromUser: msg.from_user,
+                fromUserName: msg.from_user_name,
+                msgId: msg.msg_id,
+                contextToken: msg.context_token,
+            },
+        });
+        this.logger.info('WeChat message enqueued for orchestrator', {
+            from: msg.from_user_name,
+            conversationId,
+            contentLength: msg.content.length,
+        });
+    }
+}
+//# sourceMappingURL=wechat-bridge.service.js.map

package/dist/backend/backend/src/services/wechat/wechat-bridge.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wechat-bridge.service.js","sourceRoot":"","sources":["../../../../../../backend/src/services/wechat/wechat-bridge.service.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/services/wechat/wechat.controller.d.ts

@@ -0,0 +1,51 @@
+/**
+ * WeChat REST Controller
+ *
+ * HTTP endpoints for managing the WeChat iLink Bot integration.
+ *
+ * Routes:
+ * - POST /api/wechat/qrcode     — Generate login QR code
+ * - GET  /api/wechat/status      — Get connection status
+ * - POST /api/wechat/disconnect  — Disconnect WeChat
+ *
+ * @module services/wechat/wechat.controller
+ */
+import type { Request, Response, NextFunction } from 'express';
+import { Router } from 'express';
+/**
+ * POST /api/wechat/qrcode
+ *
+ * Generate a WeChat login QR code. The frontend displays this QR code
+ * for the user to scan with their WeChat app.
+ *
+ * @param _req - Express request (no body required)
+ * @param res - Response with { success, data: { qrcodeUrl, ticket } }
+ * @param next - Next function
+ */
+export declare function getQRCode(_req: Request, res: Response, next: NextFunction): Promise<void>;
+/**
+ * GET /api/wechat/status
+ *
+ * Get the current WeChat connection status.
+ *
+ * @param _req - Express request
+ * @param res - Response with { success, data: { state, botName, connectedAt } }
+ */
+export declare function getStatus(_req: Request, res: Response): void;
+/**
+ * POST /api/wechat/disconnect
+ *
+ * Disconnect the WeChat bot and clear credentials.
+ *
+ * @param _req - Express request
+ * @param res - Response with { success }
+ * @param next - Next function
+ */
+export declare function disconnectWeChat(_req: Request, res: Response, next: NextFunction): Promise<void>;
+/**
+ * Create the WeChat router with all endpoints.
+ *
+ * @returns Express router for /api/wechat/*
+ */
+export declare function createWeChatRouter(): Router;
+//# sourceMappingURL=wechat.controller.d.ts.map

package/dist/backend/backend/src/services/wechat/wechat.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wechat.controller.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/wechat/wechat.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAMjC;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAyB/F;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,CAQ5D;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CActG;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAQ3C"}

package/dist/backend/backend/src/services/wechat/wechat.controller.js

@@ -0,0 +1,104 @@
+/**
+ * WeChat REST Controller
+ *
+ * HTTP endpoints for managing the WeChat iLink Bot integration.
+ *
+ * Routes:
+ * - POST /api/wechat/qrcode     — Generate login QR code
+ * - GET  /api/wechat/status      — Get connection status
+ * - POST /api/wechat/disconnect  — Disconnect WeChat
+ *
+ * @module services/wechat/wechat.controller
+ */
+import { Router } from 'express';
+import { getWeChatService } from './wechat.service.js';
+import { LoggerService } from '../core/logger.service.js';
+const logger = LoggerService.getInstance().createComponentLogger('WeChatController');
+/**
+ * POST /api/wechat/qrcode
+ *
+ * Generate a WeChat login QR code. The frontend displays this QR code
+ * for the user to scan with their WeChat app.
+ *
+ * @param _req - Express request (no body required)
+ * @param res - Response with { success, data: { qrcodeUrl, ticket } }
+ * @param next - Next function
+ */
+export async function getQRCode(_req, res, next) {
+    try {
+        const service = getWeChatService();
+        const qrData = await service.getQRCode();
+        res.json({
+            success: true,
+            data: {
+                qrcodeUrl: qrData.qrcode_url,
+                ticket: qrData.qrcode_ticket,
+            },
+        });
+        // Start polling for QR code status in the background
+        service.pollQRCodeStatus(qrData.qrcode_ticket).catch((err) => {
+            logger.warn('QR code status polling ended', {
+                error: err instanceof Error ? err.message : String(err),
+            });
+        });
+    }
+    catch (error) {
+        logger.error('Failed to generate WeChat QR code', {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        next(error);
+    }
+}
+/**
+ * GET /api/wechat/status
+ *
+ * Get the current WeChat connection status.
+ *
+ * @param _req - Express request
+ * @param res - Response with { success, data: { state, botName, connectedAt } }
+ */
+export function getStatus(_req, res) {
+    const service = getWeChatService();
+    const status = service.getStatus();
+    res.json({
+        success: true,
+        data: status,
+    });
+}
+/**
+ * POST /api/wechat/disconnect
+ *
+ * Disconnect the WeChat bot and clear credentials.
+ *
+ * @param _req - Express request
+ * @param res - Response with { success }
+ * @param next - Next function
+ */
+export async function disconnectWeChat(_req, res, next) {
+    try {
+        const service = getWeChatService();
+        service.disconnect();
+        await service.removeConfig();
+        logger.info('WeChat disconnected');
+        res.json({ success: true });
+    }
+    catch (error) {
+        logger.error('Failed to disconnect WeChat', {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        next(error);
+    }
+}
+/**
+ * Create the WeChat router with all endpoints.
+ *
+ * @returns Express router for /api/wechat/*
+ */
+export function createWeChatRouter() {
+    const router = Router();
+    router.post('/qrcode', getQRCode);
+    router.get('/status', getStatus);
+    router.post('/disconnect', disconnectWeChat);
+    return router;
+}
+//# sourceMappingURL=wechat.controller.js.map

package/dist/backend/backend/src/services/wechat/wechat.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wechat.controller.js","sourceRoot":"","sources":["../../../../../../backend/src/services/wechat/wechat.controller.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/services/wechat/wechat.service.d.ts

@@ -0,0 +1,171 @@
+/**
+ * WeChat iLink Bot Service
+ *
+ * Integrates with the Tencent iLink Bot API for WeChat messaging.
+ * Supports QR code login, message polling, and sending replies.
+ *
+ * API Base: https://ilinkai.weixin.qq.com
+ * Auth: Bearer token with AuthorizationType: ilink_bot_token header
+ *
+ * @module services/wechat/wechat.service
+ */
+import { EventEmitter } from 'events';
+/** Persisted WeChat config. */
+export interface WeChatConfig {
+    botToken: string;
+    connectedAt: string;
+    botName?: string;
+}
+/** QR code response from iLink API. */
+export interface QRCodeResponse {
+    qrcode_url: string;
+    qrcode_ticket: string;
+}
+/** QR code status from iLink API. */
+export interface QRCodeStatus {
+    status: 'waiting' | 'scanned' | 'confirmed' | 'expired';
+    bot_token?: string;
+    bot_name?: string;
+}
+/** Incoming WeChat message from getupdates. */
+export interface WeChatMessage {
+    msg_id: string;
+    from_user: string;
+    from_user_name: string;
+    content: string;
+    msg_type: string;
+    context_token: string;
+    timestamp: number;
+}
+/** Service connection state. */
+export type WeChatConnectionState = 'disconnected' | 'connecting' | 'connected' | 'error';
+/**
+ * WeChat iLink Bot Service.
+ *
+ * Singleton service that manages the WeChat bot connection lifecycle:
+ * - QR code generation for login
+ * - Long-polling for incoming messages
+ * - Sending replies
+ * - Persisting credentials to disk
+ *
+ * Events:
+ * - `message` — Fired for each incoming WeChat message
+ * - `connected` — Fired when QR code scan is confirmed
+ * - `disconnected` — Fired when service disconnects
+ * - `error` — Fired on unrecoverable errors
+ */
+export declare class WeChatService extends EventEmitter {
+    private static instance;
+    private readonly logger;
+    private state;
+    private botToken;
+    private botName;
+    private pollCursor;
+    private pollTimer;
+    private isPolling;
+    private constructor();
+    /**
+     * Get the singleton instance.
+     *
+     * @returns WeChatService instance
+     */
+    static getInstance(): WeChatService;
+    /**
+     * Reset the singleton (for testing).
+     */
+    static resetInstance(): void;
+    /**
+     * Get a QR code for WeChat login.
+     *
+     * Calls the iLink API to generate a QR code that the user scans
+     * with their WeChat app to authorize the bot.
+     *
+     * @returns QR code URL and ticket for status polling
+     * @throws Error if API call fails
+     */
+    getQRCode(): Promise<QRCodeResponse>;
+    /**
+     * Poll the QR code status until the user scans and confirms.
+     *
+     * @param ticket - QR code ticket from getQRCode()
+     * @returns Resolved when confirmed, rejected on timeout/error
+     */
+    pollQRCodeStatus(ticket: string): Promise<{
+        botToken: string;
+        botName?: string;
+    }>;
+    /**
+     * Send a message via WeChat.
+     *
+     * @param content - Message text
+     * @param contextToken - Context token from the received message (maintains thread)
+     * @throws Error if not connected or API call fails
+     */
+    sendMessage(content: string, contextToken: string): Promise<void>;
+    /**
+     * Get the current connection state.
+     *
+     * @returns Connection status object
+     */
+    getStatus(): {
+        state: WeChatConnectionState;
+        botName: string | null;
+        connectedAt: string | null;
+    };
+    /**
+     * Check if the service is connected.
+     *
+     * @returns True if connected with a valid bot token
+     */
+    isConnected(): boolean;
+    /**
+     * Disconnect and stop message polling.
+     */
+    disconnect(): void;
+    /**
+     * Try to restore connection from persisted config.
+     *
+     * @returns True if config was loaded and connection restored
+     */
+    tryRestore(): Promise<boolean>;
+    /**
+     * Start long-polling for incoming messages.
+     */
+    private startMessagePolling;
+    /**
+     * Stop message polling.
+     */
+    private stopMessagePolling;
+    /**
+     * Long-poll for new messages from the iLink API.
+     * Automatically reschedules on completion or error.
+     */
+    private pollMessages;
+    /**
+     * Persist bot token to disk.
+     */
+    private persistConfig;
+    /**
+     * Load persisted config from disk.
+     *
+     * @returns Config or null if not found
+     */
+    private loadConfig;
+    /**
+     * Remove persisted config from disk.
+     */
+    removeConfig(): Promise<void>;
+    /**
+     * Build authorization headers for iLink API.
+     *
+     * @returns Headers with Bearer token and AuthorizationType
+     */
+    private authHeaders;
+}
+/**
+ * Get the WeChat service singleton.
+ *
+ * @returns WeChatService instance
+ */
+export declare function getWeChatService(): WeChatService;
+//# sourceMappingURL=wechat.service.d.ts.map

package/dist/backend/backend/src/services/wechat/wechat.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wechat.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/wechat/wechat.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAqCtC,+BAA+B;AAC/B,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,qCAAqC;AACrC,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,+CAA+C;AAC/C,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,gCAAgC;AAChC,MAAM,MAAM,qBAAqB,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,OAAO,CAAC;AAM1F;;;;;;;;;;;;;;GAcG;AACH,qBAAa,aAAc,SAAQ,YAAY;IAC7C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA8B;IACrD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IAEzC,OAAO,CAAC,KAAK,CAAyC;IACtD,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,SAAS,CAA8C;IAC/D,OAAO,CAAC,SAAS,CAAS;IAE1B,OAAO;IAKP;;;;OAIG;IACH,MAAM,CAAC,WAAW,IAAI,aAAa;IAOnC;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAW5B;;;;;;;;OAQG;IACG,SAAS,IAAI,OAAO,CAAC,cAAc,CAAC;IA0B1C;;;;;OAKG;IACG,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IA4DvF;;;;;;OAMG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBvE;;;;OAIG;IACH,SAAS,IAAI;QAAE,KAAK,EAAE,qBAAqB,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;IAQjG;;;;OAIG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,UAAU,IAAI,IAAI;IAUlB;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAqBpC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAM3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAQ1B;;;OAGG;YACW,YAAY;IAqE1B;;OAEG;YACW,aAAa;IAiB3B;;;;OAIG;YACW,UAAU;IASxB;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAanC;;;;OAIG;IACH,OAAO,CAAC,WAAW;CAOpB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAEhD"}