hyacinth-ai 0.9.6

package/dist/channels/manager.js

@@ -0,0 +1,156 @@
+// ============================================================
+// ChannelManager — 渠道生命周期管理器
+// ============================================================
+//
+// 职责：
+//   - 注册渠道（内置渠道 + 插件渠道）
+//   - 启动/停止渠道
+//   - 将渠道事件路由到消息处理器
+//   - 将 Agent 回复发送回对应渠道
+// ============================================================
+import { createLogger } from '../logging/logger.js';
+const logger = createLogger('channels');
+export class ChannelManager {
+    channels = new Map();
+    started = false;
+    // ── 注册 ──────────────────────────────────────────────────
+    /** 注册一个渠道处理器 */
+    register(handler, config = {}) {
+        if (this.channels.has(handler.id)) {
+            logger.warn('channel already registered, replacing', { id: handler.id });
+        }
+        this.channels.set(handler.id, {
+            handler,
+            status: 'registered',
+            config,
+        });
+        logger.info('channel registered', { id: handler.id, name: handler.name });
+    }
+    /** 批量注册 */
+    registerAll(entries) {
+        for (const { handler, config } of entries) {
+            this.register(handler, config);
+        }
+    }
+    /** 获取所有已注册渠道 */
+    getAll() {
+        return [...this.channels.values()];
+    }
+    /** 获取指定渠道 */
+    get(id) {
+        return this.channels.get(id);
+    }
+    /** 获取活跃渠道 */
+    getActive() {
+        return this.getAll().filter((c) => c.status === 'active');
+    }
+    // ── 生命周期 ──────────────────────────────────────────────
+    /**
+     * 启动所有启用的渠道
+     * 每个渠道自行处理消息（通过 handler.handleMessage）
+     */
+    async startAll(agentFactory, enabledIds) {
+        const toStart = this.getAll().filter((c) => {
+            if (enabledIds && !enabledIds.includes(c.handler.id))
+                return false;
+            return c.config.enabled !== false;
+        });
+        logger.info('starting channels', { count: toStart.length });
+        for (const state of toStart) {
+            await this.startChannel(state, agentFactory);
+        }
+        this.started = true;
+    }
+    /** 启动单个渠道 */
+    async startChannel(state, agentFactory) {
+        const { handler, config } = state;
+        try {
+            state.status = 'starting';
+            // 将 agentFactory 注入到渠道配置中（WebUI 等渠道需要它来创建 AgentLoop）
+            config.agentFactory = agentFactory;
+            // 设置事件处理：渠道收到消息 → 调用 handler.handleMessage
+            handler.onEvent(async (event) => {
+                if (event.type === 'message') {
+                    const msgEvent = event;
+                    const replyFn = async (reply) => {
+                        await handler.reply(msgEvent.sessionId, reply);
+                    };
+                    try {
+                        await handler.handleMessage(msgEvent, replyFn, agentFactory);
+                    }
+                    catch (err) {
+                        logger.error('handleMessage error', err instanceof Error ? err : new Error(String(err)), {
+                            channel: handler.id,
+                        });
+                    }
+                }
+            });
+            await handler.start(config);
+            state.status = 'active';
+            logger.info('channel started', { id: handler.id });
+        }
+        catch (error) {
+            state.status = 'error';
+            state.error = error instanceof Error ? error.message : String(error);
+            logger.error('channel start failed', error instanceof Error ? error : new Error(state.error), {
+                id: handler.id,
+            });
+        }
+    }
+    /** 停止所有渠道 */
+    async stopAll() {
+        for (const state of this.getActive()) {
+            await this.stopChannel(state);
+        }
+        this.started = false;
+    }
+    /** 停止单个渠道 */
+    async stopChannel(state) {
+        try {
+            await state.handler.stop();
+            state.status = 'stopped';
+            logger.info('channel stopped', { id: state.handler.id });
+        }
+        catch (error) {
+            state.status = 'error';
+            state.error = error instanceof Error ? error.message : String(error);
+            logger.error('channel stop failed', error instanceof Error ? error : new Error(state.error), {
+                id: state.handler.id,
+            });
+        }
+    }
+    /** 重启指定渠道 */
+    async restart(id, agentFactory) {
+        const state = this.channels.get(id);
+        if (!state)
+            throw new Error(`Channel "${id}" not found`);
+        if (state.status === 'active') {
+            await this.stopChannel(state);
+        }
+        await this.startChannel(state, agentFactory);
+    }
+    // ── 主动发送 ──────────────────────────────────────────────
+    /**
+     * 通过指定渠道主动发送消息
+     */
+    async send(channelId, sessionId, reply) {
+        const state = this.channels.get(channelId);
+        if (!state || state.status !== 'active') {
+            throw new Error(`Channel "${channelId}" is not active`);
+        }
+        await state.handler.reply(sessionId, reply);
+    }
+    // ── 状态查询 ──────────────────────────────────────────────
+    getStatusSummary() {
+        return this.getAll().map((c) => ({
+            id: c.handler.id,
+            name: c.handler.name,
+            status: c.status,
+        }));
+    }
+    /** 是否已启动 */
+    isStarted() {
+        return this.started;
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/channels/message-queue.d.ts

@@ -0,0 +1,36 @@
+export declare enum QueueMessageMode {
+    Queue = "queue",
+    Insert = "insert"
+}
+export interface QueueItem {
+    text: string;
+    mode: QueueMessageMode;
+    timestamp: number;
+}
+export declare class MessageQueue {
+    private items;
+    static readonly MAX_QUEUE_SIZE = 100;
+    /** Detect if a message uses insert-mode syntax: "!...text...!" */
+    static detectMode(text: string): QueueMessageMode;
+    /** Strip "!" markers from insert-mode messages. No-op for queue-mode. */
+    static stripMarkers(text: string): string;
+    /**
+     * Enqueue a message. Insert-mode goes to the front (unshift),
+     * queue-mode goes to the back (push).
+     */
+    enqueue(text: string, mode: QueueMessageMode): QueueItem;
+    /** Remove and return the first item. */
+    dequeue(): QueueItem | undefined;
+    /** Remove and return the last item (for Backspace-on-empty cancellation). */
+    pop(): QueueItem | undefined;
+    /** Peek at the first item without removing. */
+    peek(): QueueItem | undefined;
+    get size(): number;
+    isEmpty(): boolean;
+    clear(): void;
+    /** Read-only view of all items (for display/debugging). */
+    getItems(): readonly QueueItem[];
+    /** Remove item at the specified index. */
+    removeAt(index: number): void;
+}
+//# sourceMappingURL=message-queue.d.ts.map

package/dist/channels/message-queue.js

@@ -0,0 +1,91 @@
+// ============================================================
+// MessageQueue — channel-agnostic message queue data structure
+// ============================================================
+//
+// Design:
+//   - Pure data structure — no processing/consumption logic.
+//   - Each channel (TUI, Feishu, WebUI, etc.) owns its own consumer loop.
+//   - Static helpers for insert-mode detection (!message! syntax).
+//   - Insert-mode items go to the FRONT (unshift), queue-mode to the BACK (push).
+//   - Max 100 items; overflow drops oldest.
+//
+// Reusability:
+//   - `detectMode()` / `stripMarkers()` are static — any channel can use them.
+//   - `enqueue()` / `dequeue()` / `pop()` — standard queue API.
+// ============================================================
+export var QueueMessageMode;
+(function (QueueMessageMode) {
+    QueueMessageMode["Queue"] = "queue";
+    QueueMessageMode["Insert"] = "insert";
+})(QueueMessageMode || (QueueMessageMode = {}));
+export class MessageQueue {
+    items = [];
+    static MAX_QUEUE_SIZE = 100;
+    // ── Static helpers ──────────────────────────────────────
+    /** Detect if a message uses insert-mode syntax: "!...text...!" */
+    static detectMode(text) {
+        const trimmed = text.trim();
+        if (trimmed.length > 2 && trimmed.startsWith('!') && trimmed.endsWith('!')) {
+            return QueueMessageMode.Insert;
+        }
+        return QueueMessageMode.Queue;
+    }
+    /** Strip "!" markers from insert-mode messages. No-op for queue-mode. */
+    static stripMarkers(text) {
+        const trimmed = text.trim();
+        if (MessageQueue.detectMode(trimmed) === QueueMessageMode.Insert) {
+            return trimmed.slice(1, -1).trim();
+        }
+        return trimmed;
+    }
+    // ── Instance API ────────────────────────────────────────
+    /**
+     * Enqueue a message. Insert-mode goes to the front (unshift),
+     * queue-mode goes to the back (push).
+     */
+    enqueue(text, mode) {
+        if (this.items.length >= MessageQueue.MAX_QUEUE_SIZE) {
+            this.items.shift(); // drop oldest
+        }
+        const item = { text, mode, timestamp: Date.now() };
+        if (mode === QueueMessageMode.Insert) {
+            this.items.unshift(item);
+        }
+        else {
+            this.items.push(item);
+        }
+        return item;
+    }
+    /** Remove and return the first item. */
+    dequeue() {
+        return this.items.shift();
+    }
+    /** Remove and return the last item (for Backspace-on-empty cancellation). */
+    pop() {
+        return this.items.pop();
+    }
+    /** Peek at the first item without removing. */
+    peek() {
+        return this.items[0];
+    }
+    get size() {
+        return this.items.length;
+    }
+    isEmpty() {
+        return this.items.length === 0;
+    }
+    clear() {
+        this.items.length = 0;
+    }
+    /** Read-only view of all items (for display/debugging). */
+    getItems() {
+        return this.items;
+    }
+    /** Remove item at the specified index. */
+    removeAt(index) {
+        if (index >= 0 && index < this.items.length) {
+            this.items.splice(index, 1);
+        }
+    }
+}
+//# sourceMappingURL=message-queue.js.map

package/dist/channels/plugins/clawbot/clawbot-auth.d.ts

@@ -0,0 +1,50 @@
+export interface AuthCallbacks {
+    /** 二维码需要展示给用户时调用 */
+    onQRCode: (qrUrl: string, qrcode: string) => void;
+    /** 状态变更时调用 */
+    onStatusChange: (status: string) => void;
+}
+export declare class ClawbotAuthManager {
+    private botToken;
+    private botId;
+    private userId;
+    private baseUrl;
+    private obtainedAt;
+    private httpTimeoutMs;
+    private callbacks;
+    /** 本轮授权流程的 AbortController，stopPolling 时中止 */
+    private abortController;
+    constructor(baseUrl: string, httpTimeoutMs: number, callbacks: AuthCallbacks);
+    get token(): string;
+    get botIdentifier(): string;
+    get userIdentifier(): string;
+    get hasValidToken(): boolean;
+    /** 剩余有效天数 */
+    get remainingDays(): number;
+    /** 是否需要告警（剩余 < 2 天） */
+    get needsWarning(): boolean;
+    /** 尝试从持久化文件恢复 token */
+    restoreFromCache(): Promise<boolean>;
+    /** 直接用已有 token（来自配置 config.channels.clawbot.botToken） */
+    setTokenDirect(token: string, botId?: string, userId?: string): void;
+    /**
+     * 启动完整扫码授权流程。
+     * 返回 Promise<boolean>，true=授权成功，false=用户取消/超时。
+     */
+    startAuthorization(baseUrl?: string): Promise<boolean>;
+    /** 中止正在进行的授权轮询 */
+    stopPolling(): void;
+    /**
+     * 尝试刷新 token（实际上 ClawBot 不支持静默刷新，只能重新扫码）。
+     * 这是给 channel 层调用的 —— 检测到 errcode:-14 时触发重新授权。
+     */
+    refreshToken(): Promise<boolean>;
+    /**
+     * 每日例行检查：剩余 < 2 天时通过回调告警。
+     * 调用方（channel）应在定时任务或启动时调用。
+     */
+    checkAndWarn(): void;
+    private saveToCache;
+    private sleep;
+}
+//# sourceMappingURL=clawbot-auth.d.ts.map

package/dist/channels/plugins/clawbot/clawbot-auth.js

@@ -0,0 +1,235 @@
+// ============================================================
+// ClawbotAuthManager — 二维码授权 + bot_token 生命周期管理
+// ============================================================
+//
+// 完整授权流程：
+//   1. 启动时检查是否有已缓存的 bot_token
+//   2. 没有 → 调用 get_bot_qrcode 获取二维码
+//   3. 输出二维码 URL（终端 ASCII / TUI / 文件）
+//   4. 轮询 get_qrcode_status，直到 confirmed / expired
+//   5. 缓存 bot_token + 过期时间（7 天）
+//   6. 每日检查剩余有效期，< 2 天时告警
+//
+// 状态机：
+//   wait → scaned → confirmed（成功）
+//   wait → expired（过期，重新获取）
+//   scaned_but_redirect → 切换轮询节点
+//   need_verifycode → 需要配对码
+//   binded_redirect → 已有绑定跳转
+// ============================================================
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { ClawbotClient } from './clawbot-client.js';
+// ── 常量 ──────────────────────────────────────────────────────
+/** bot_token 有效期（毫秒），7 天 */
+const TOKEN_VALIDITY_MS = 7 * 24 * 60 * 60 * 1000;
+/** 提前告警阈值（毫秒），2 天 */
+const TOKEN_WARN_THRESHOLD_MS = 2 * 24 * 60 * 60 * 1000;
+/** 二维码轮询间隔（毫秒） */
+const QR_POLL_INTERVAL_MS = 2000;
+/** 单次二维码最大轮询时间（毫秒），3 分钟 */
+const QR_MAX_POLL_MS = 3 * 60 * 1000;
+// ── 持久化文件 ────────────────────────────────────────────────
+function getTokenFilePath() {
+    return path.join(process.cwd(), '.agent', 'clawbot_token.json');
+}
+// ── ClawbotAuthManager ────────────────────────────────────────
+export class ClawbotAuthManager {
+    botToken = '';
+    botId = '';
+    userId = '';
+    baseUrl;
+    obtainedAt = 0;
+    httpTimeoutMs;
+    callbacks;
+    /** 本轮授权流程的 AbortController，stopPolling 时中止 */
+    abortController = null;
+    constructor(baseUrl, httpTimeoutMs, callbacks) {
+        this.baseUrl = baseUrl;
+        this.httpTimeoutMs = httpTimeoutMs;
+        this.callbacks = callbacks;
+    }
+    // ── 属性 ────────────────────────────────────────────────────
+    get token() { return this.botToken; }
+    get botIdentifier() { return this.botId; }
+    get userIdentifier() { return this.userId; }
+    get hasValidToken() {
+        if (!this.botToken)
+            return false;
+        const remaining = this.obtainedAt + TOKEN_VALIDITY_MS - Date.now();
+        return remaining > 0;
+    }
+    /** 剩余有效天数 */
+    get remainingDays() {
+        if (!this.botToken)
+            return 0;
+        const remaining = this.obtainedAt + TOKEN_VALIDITY_MS - Date.now();
+        return Math.max(0, remaining / (24 * 60 * 60 * 1000));
+    }
+    /** 是否需要告警（剩余 < 2 天） */
+    get needsWarning() {
+        if (!this.botToken)
+            return false;
+        const remaining = this.obtainedAt + TOKEN_VALIDITY_MS - Date.now();
+        return remaining > 0 && remaining < TOKEN_WARN_THRESHOLD_MS;
+    }
+    // ── 初始化 ───────────────────────────────────────────────────
+    /** 尝试从持久化文件恢复 token */
+    async restoreFromCache() {
+        try {
+            const raw = await fs.readFile(getTokenFilePath(), 'utf-8');
+            const cache = JSON.parse(raw);
+            if (!cache.botToken)
+                return false;
+            // 检查是否过期
+            if (Date.now() - cache.obtainedAt > TOKEN_VALIDITY_MS) {
+                this.callbacks.onStatusChange('Cached token expired, need re-auth');
+                return false;
+            }
+            this.botToken = cache.botToken;
+            this.botId = cache.botId ?? '';
+            this.userId = cache.userId ?? '';
+            this.baseUrl = cache.baseUrl ?? this.baseUrl;
+            this.obtainedAt = cache.obtainedAt ?? 0;
+            this.callbacks.onStatusChange(`Token restored from cache, ${this.remainingDays.toFixed(1)} days remaining`);
+            return true;
+        }
+        catch {
+            // 首次启动，无缓存文件
+            return false;
+        }
+    }
+    /** 直接用已有 token（来自配置 config.channels.clawbot.botToken） */
+    setTokenDirect(token, botId, userId) {
+        this.botToken = token;
+        this.botId = botId ?? '';
+        this.userId = userId ?? '';
+        this.obtainedAt = Date.now();
+        this.saveToCache();
+    }
+    // ── 授权流程 ────────────────────────────────────────────────
+    /**
+     * 启动完整扫码授权流程。
+     * 返回 Promise<boolean>，true=授权成功，false=用户取消/超时。
+     */
+    async startAuthorization(baseUrl) {
+        if (baseUrl)
+            this.baseUrl = baseUrl;
+        this.callbacks.onStatusChange('Starting QR code authorization...');
+        // 1. 获取二维码
+        let qrResult;
+        try {
+            // 获取二维码阶段不需要 bot_token，创建一个临时 client
+            const tempClient = new ClawbotClient(this.baseUrl, '', this.httpTimeoutMs);
+            qrResult = await tempClient.getQRCode([]);
+        }
+        catch (err) {
+            this.callbacks.onStatusChange(`Failed to get QR code: ${err instanceof Error ? err.message : String(err)}`);
+            return false;
+        }
+        this.callbacks.onQRCode(qrResult.qrcode_img_content, qrResult.qrcode);
+        // 2. 轮询扫码状态
+        this.abortController = new AbortController();
+        const startTime = Date.now();
+        const client = new ClawbotClient(this.baseUrl, '', this.httpTimeoutMs);
+        while (Date.now() - startTime < QR_MAX_POLL_MS) {
+            // 检查是否被中止
+            if (this.abortController.signal.aborted) {
+                this.callbacks.onStatusChange('Authorization polling cancelled');
+                return false;
+            }
+            let statusResult;
+            try {
+                statusResult = await client.getQRCodeStatus(qrResult.qrcode);
+            }
+            catch (err) {
+                this.callbacks.onStatusChange(`QR poll error: ${err instanceof Error ? err.message : String(err)}`);
+                await this.sleep(QR_POLL_INTERVAL_MS);
+                continue;
+            }
+            this.callbacks.onStatusChange(`QR status: ${statusResult.status}`);
+            switch (statusResult.status) {
+                case 'confirmed':
+                    // 成功！
+                    this.botToken = statusResult.bot_token ?? '';
+                    this.botId = statusResult.ilink_bot_id ?? '';
+                    this.userId = statusResult.ilink_user_id ?? '';
+                    if (statusResult.baseurl)
+                        this.baseUrl = statusResult.baseurl;
+                    this.obtainedAt = Date.now();
+                    this.saveToCache();
+                    this.callbacks.onStatusChange(`Authorization successful! Bot: ${this.botId}, Token valid for 7 days`);
+                    return true;
+                case 'expired':
+                    this.callbacks.onStatusChange('QR code expired, retrying...');
+                    // 递归重试：重新获取二维码
+                    return this.startAuthorization();
+                case 'scaned_but_redirect':
+                    this.callbacks.onStatusChange('QR scan redirecting...');
+                    await this.sleep(QR_POLL_INTERVAL_MS);
+                    continue;
+                case 'need_verifycode':
+                    this.callbacks.onStatusChange('Verification code required on phone');
+                    await this.sleep(QR_POLL_INTERVAL_MS);
+                    continue;
+                case 'binded_redirect':
+                    this.callbacks.onStatusChange('Bound session redirect...');
+                    await this.sleep(QR_POLL_INTERVAL_MS);
+                    continue;
+                case 'scaned':
+                case 'wait':
+                default:
+                    await this.sleep(QR_POLL_INTERVAL_MS);
+                    continue;
+            }
+        }
+        this.callbacks.onStatusChange('Authorization timed out (3 minutes)');
+        return false;
+    }
+    /** 中止正在进行的授权轮询 */
+    stopPolling() {
+        this.abortController?.abort();
+        this.abortController = null;
+    }
+    // ── Token 刷新 ──────────────────────────────────────────────
+    /**
+     * 尝试刷新 token（实际上 ClawBot 不支持静默刷新，只能重新扫码）。
+     * 这是给 channel 层调用的 —— 检测到 errcode:-14 时触发重新授权。
+     */
+    async refreshToken() {
+        this.callbacks.onStatusChange('bot_token expired (errcode:-14), starting re-authorization...');
+        this.botToken = '';
+        return this.startAuthorization();
+    }
+    /**
+     * 每日例行检查：剩余 < 2 天时通过回调告警。
+     * 调用方（channel）应在定时任务或启动时调用。
+     */
+    checkAndWarn() {
+        if (this.needsWarning) {
+            this.callbacks.onStatusChange(`⚠️ ClawBot token expires in ${this.remainingDays.toFixed(1)} days. Please re-scan QR code soon.`);
+        }
+    }
+    // ── 持久化 ───────────────────────────────────────────────────
+    async saveToCache() {
+        try {
+            const cache = {
+                botToken: this.botToken,
+                botId: this.botId,
+                userId: this.userId,
+                baseUrl: this.baseUrl,
+                obtainedAt: this.obtainedAt,
+            };
+            await fs.mkdir(path.dirname(getTokenFilePath()), { recursive: true });
+            await fs.writeFile(getTokenFilePath(), JSON.stringify(cache, null, 2), 'utf-8');
+        }
+        catch {
+            // 写入失败不影响运行
+        }
+    }
+    // ── 工具 ────────────────────────────────────────────────────
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=clawbot-auth.js.map

package/dist/channels/plugins/clawbot/clawbot-channel.d.ts

@@ -0,0 +1,76 @@
+import type { ChannelHandler, ChannelEvent, ChannelReply, ChannelConfig, ChannelStatus, ChannelMessageEvent, AgentFactory, ReplyFn } from '../../interface.js';
+export declare class ClawbotChannel implements ChannelHandler {
+    readonly id = "clawbot";
+    readonly name = "\u5FAE\u4FE1 ClawBot";
+    readonly description = "\u5FAE\u4FE1\u5B98\u65B9 AI \u52A9\u624B\u8FDE\u63A5\u63D2\u4EF6\uFF0C\u652F\u6301 HTTP \u957F\u8F6E\u8BE2\u6536\u53D1\u6D88\u606F";
+    readonly pluginId: undefined;
+    private status;
+    private config;
+    private logger;
+    private client;
+    private auth;
+    private messageQueue;
+    private agentFactory;
+    private polling;
+    private pollAbortController;
+    /** getUpdates 的 opaque blob，首次空字符串，后续回传上次返回值 */
+    private getUpdatesBuf;
+    /** 单会话信息（ClawBot 只有一个会话） */
+    private sessionInfo;
+    /** sessionId → SessionInfo 映射（兼容多 session 接口） */
+    private sessionMap;
+    private loop;
+    private collectHandler;
+    private sessionId;
+    private typingTicket;
+    private typingConfigFetched;
+    private onUserMessage;
+    private onAgentReply;
+    private persistSessionFile;
+    /** 每日 token 过期检查定时器 */
+    private dailyCheckTimer;
+    start(config: ChannelConfig): Promise<void>;
+    /** 初始化/更新 HTTP 客户端并启动长轮询 */
+    private activateClient;
+    /** 手动触发扫码授权流程（供 /clawbot login 命令调用） */
+    triggerAuth(): Promise<boolean>;
+    /** 返回当前授权状态（供 /clawbot status 命令调用） */
+    getAuthStatus(): {
+        authorized: boolean;
+        polling: boolean;
+        remainingDays: number;
+        botId: string;
+        userId: string;
+    };
+    private persistSession;
+    private restoreSession;
+    /** ChannelHandler: 处理 TUI 子命令（/clawbot/login, /clawbot/status） */
+    handleTuiCommand(cmdPath: string, _args: string): Promise<string | null>;
+    stop(): Promise<void>;
+    onEvent(handler: (event: ChannelEvent) => Promise<void>): void;
+    reply(sessionId: string, reply: ChannelReply): Promise<void>;
+    getStatus(): ChannelStatus;
+    handleMessage(event: ChannelMessageEvent, replyFn: ReplyFn, agentFactory: AgentFactory): Promise<void>;
+    /** 启动长轮询循环（while loop，非递归） */
+    private startPollingLoop;
+    private runPollLoop;
+    /** 处理长轮询收到的入站消息 */
+    private handleIncomingMessage;
+    private handleTokenExpiry;
+    /**
+     * 主动推送消息（非回复模式）。
+     * ClawBot 是单会话，直接向最近活跃的用户发送。
+     */
+    sendProactiveMessage(sessionId: string, text: string): Promise<void>;
+    /**
+     * 处理定时任务通知。
+     * 运行 Agent 并将结果主动推送到 ClawBot 会话。
+     */
+    handleTaskNotification(taskName: string, sessionId?: string): Promise<void>;
+    /** 获取 typing_ticket（预取一次，缓存使用） */
+    private fetchTypingConfig;
+    private hasQueuedMessage;
+    private sleep;
+}
+export declare function createClawbotChannel(): ClawbotChannel;
+//# sourceMappingURL=clawbot-channel.d.ts.map