hyacinth-ai 0.9.6

package/dist/channels/plugins/clawbot/clawbot-message-queue.js

@@ -0,0 +1,114 @@
+// ============================================================
+// ClawbotMessageQueue — ClawBot 渠道 per-session 消息队列
+// ============================================================
+//
+// 解决的问题：
+//   1. 长轮询收到消息 → 入队即返回 → 不阻塞轮询循环
+//   2. 并发 loop.run() → conversation.jsonl 交叉写入
+//
+// 设计：
+//   - 长轮询循环收到消息后入队即返回，立即发起下一次长轮询
+//   - 队列按 sessionId 串行消费，保证同一 session 不会并发处理
+//   - 队列内去重，防止轮询重试导致重复消息
+//   - 背压控制：最大 100 条/queue，超出丢弃最旧消息
+//
+// ClawBot 是单会话，通常只有一个 session，队列逻辑比飞书简单。
+// ============================================================
+/** 从 ChannelEvent 中提取 messageId（仅 message 类型有） */
+function getMessageId(event) {
+    if (event.type === 'message') {
+        return event.metadata?.messageId;
+    }
+    return undefined;
+}
+export class ClawbotMessageQueue {
+    queues = new Map();
+    processing = new Map();
+    processFn = null;
+    logger;
+    static MAX_QUEUE_SIZE = 100;
+    constructor(logger) {
+        this.logger = logger ?? {
+            info: (msg) => process.stderr.write(`[clawbot-queue] ${msg}\n`),
+            error: (msg) => process.stderr.write(`[clawbot-queue] ${msg}\n`),
+            warn: (msg) => process.stderr.write(`[clawbot-queue] ${msg}\n`),
+        };
+    }
+    /** 设置消息处理函数 */
+    setProcessFn(fn) {
+        this.processFn = fn;
+    }
+    /** 入队消息（fire-and-forget，立即返回） */
+    enqueue(sessionId, event) {
+        // 1. 队列内去重：检查是否已有相同 messageId
+        const messageId = getMessageId(event);
+        if (messageId) {
+            const queue = this.queues.get(sessionId);
+            if (queue?.some(item => getMessageId(item.event) === messageId)) {
+                this.logger.info(`queue dedup: dropping duplicate message ${messageId.slice(0, 12)}...`);
+                return;
+            }
+        }
+        // 2. 获取或创建队列
+        let queue = this.queues.get(sessionId);
+        if (!queue) {
+            queue = [];
+            this.queues.set(sessionId, queue);
+        }
+        // 3. 背压控制：超出最大长度时丢弃最旧的消息
+        if (queue.length >= ClawbotMessageQueue.MAX_QUEUE_SIZE) {
+            const dropped = queue.shift();
+            const droppedId = getMessageId(dropped?.event ?? {});
+            (this.logger.warn ?? this.logger.error)(`queue overflow: dropping oldest message ${droppedId?.slice(0, 12) ?? 'unknown'}...`);
+        }
+        // 4. 入队
+        queue.push({ event });
+        this.logger.info(`enqueued message for session ${sessionId.slice(0, 16)}... (queue size: ${queue.length})`);
+        // 5. 触发处理（如果当前没有在处理）
+        this.processNext(sessionId);
+    }
+    /** 串行处理下一条消息 */
+    processNext(sessionId) {
+        if (this.processing.get(sessionId)) {
+            return; // 正在处理中，等当前处理完会自动调用 processNext
+        }
+        const queue = this.queues.get(sessionId);
+        if (!queue || queue.length === 0) {
+            return;
+        }
+        if (!this.processFn) {
+            this.logger.error('no processFn set, message will stay in queue');
+            return;
+        }
+        const item = queue.shift();
+        this.processing.set(sessionId, true);
+        // 异步处理，不阻塞入队
+        this.processFn(item.event)
+            .catch((err) => {
+            this.logger.error(`process error for session ${sessionId.slice(0, 16)}...: ${String(err instanceof Error ? err.message : err)}`);
+        })
+            .finally(() => {
+            this.processing.set(sessionId, false);
+            // 处理完后检查队列中是否还有消息
+            const remaining = this.queues.get(sessionId);
+            if (remaining && remaining.length > 0) {
+                this.processNext(sessionId);
+            }
+            else {
+                // 队列空了，清理
+                this.queues.delete(sessionId);
+                this.processing.delete(sessionId);
+            }
+        });
+    }
+    /** 获取指定 session 的队列长度 */
+    getQueueSize(sessionId) {
+        return this.queues.get(sessionId)?.length ?? 0;
+    }
+    /** 清理所有队列 */
+    clear() {
+        this.queues.clear();
+        this.processing.clear();
+    }
+}
+//# sourceMappingURL=clawbot-message-queue.js.map

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

@@ -0,0 +1,10 @@
+import type { OutputHandler } from '../../../orchestrator/loop.js';
+export interface CollectHandler extends OutputHandler {
+    getResponse(): string;
+    reset(): void;
+}
+export interface SessionRunner {
+    run(input: string): Promise<void>;
+}
+export declare function createCollectHandler(): CollectHandler;
+//# sourceMappingURL=clawbot-session.d.ts.map

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

@@ -0,0 +1,26 @@
+// ============================================================
+// ClawbotSession — ClawBot 渠道 session 管理 + CollectHandler
+// ============================================================
+//
+// ClawBot 是单会话，比飞书简单很多：
+//   - 无需 SessionPool / LRU cache（只有一个会话）
+//   - 无需 sessionMode（不存在 per_chat / per_user 等策略）
+//   - CollectHandler 逻辑与飞书一致：过滤工具调用和状态，只保留文本输出
+// ============================================================
+// ── Factory ───────────────────────────────────────────────────
+export function createCollectHandler() {
+    const texts = [];
+    return {
+        onText(content) { texts.push(content); },
+        // ClawBot 端只展示最终文本回复，工具调用和状态消息不发送给用户
+        onToolUse(_name, _inputSummary) { },
+        onStatus(_message) { },
+        // 每个新 turn 清空之前累积的文本，只保留最后一轮的输出
+        onTurnStart() { texts.length = 0; },
+        onFlush() { },
+        onInterrupt() { },
+        getResponse() { return texts.join(''); },
+        reset() { texts.length = 0; },
+    };
+}
+//# sourceMappingURL=clawbot-session.js.map

package/dist/channels/plugins/clawbot/index.d.ts

@@ -0,0 +1,17 @@
+import type { ChannelPlugin } from '../../auto-detect.js';
+export { ClawbotChannel, createClawbotChannel } from './clawbot-channel.js';
+export { ClawbotClient, ClawbotAPIError } from './clawbot-client.js';
+export type { QRCodeResult, QRCodeStatus, QRCodeStatusResult, MessageItemType, MessageType, MessageState, TextItem, ImageItem, MessageItem, ClawbotIncomingMessage, ClawbotOutgoingMessage, GetUpdatesResponse, } from './clawbot-client.js';
+export { ClawbotAuthManager } from './clawbot-auth.js';
+export type { AuthCallbacks } from './clawbot-auth.js';
+export { resolveClawbotConfig, validateClawbotConfig, type ClawbotChannelConfig, } from './clawbot-config.js';
+export { ClawbotMessageQueue } from './clawbot-message-queue.js';
+export { createCollectHandler } from './clawbot-session.js';
+export type { CollectHandler, SessionRunner } from './clawbot-session.js';
+/**
+ * ClawBot 渠道自动注册插件
+ */
+export declare const clawbotChannelPlugin: ChannelPlugin;
+/** 插件自动发现约定的导出名 */
+export { clawbotChannelPlugin as channelPlugin };
+//# sourceMappingURL=index.d.ts.map

package/dist/channels/plugins/clawbot/index.js

@@ -0,0 +1,58 @@
+// ============================================================
+// ClawBot 渠道插件 — 导出入口
+// ============================================================
+//
+// 使用方式：
+//   import { createClawbotChannel } from './channels/plugins/clawbot/index.js';
+//   channelManager.register(createClawbotChannel(), clawbotConfig);
+//
+// 自动发现：
+//   框架会在启动时扫描 channels/plugins/ 下的子目录，
+//   自动加载导出 channelPlugin 的模块。
+// ============================================================
+import { createClawbotChannel } from './clawbot-channel.js';
+import { createLogger } from '../../../logging/logger.js';
+const logger = createLogger('clawbot-plugin');
+export { ClawbotChannel, createClawbotChannel } from './clawbot-channel.js';
+export { ClawbotClient, ClawbotAPIError } from './clawbot-client.js';
+export { ClawbotAuthManager } from './clawbot-auth.js';
+export { resolveClawbotConfig, validateClawbotConfig, } from './clawbot-config.js';
+export { ClawbotMessageQueue } from './clawbot-message-queue.js';
+export { createCollectHandler } from './clawbot-session.js';
+/**
+ * ClawBot 渠道自动注册插件
+ */
+export const clawbotChannelPlugin = {
+    configKey: 'clawbot',
+    async autoRegister(channelManager, config, channelsInfo) {
+        const clawbotConfig = config;
+        const shouldRun = clawbotConfig?.enabled !== false;
+        if (!shouldRun) {
+            return;
+        }
+        logger.info('auto-detected clawbot channel, registering...');
+        channelManager.register(createClawbotChannel(), {
+            botToken: clawbotConfig?.botToken ?? '',
+            botId: clawbotConfig?.botId ?? '',
+            userId: clawbotConfig?.userId ?? '',
+            baseUrl: clawbotConfig?.baseUrl ?? 'https://ilinkai.weixin.qq.com',
+            tuiSync: clawbotConfig?.tuiSync ?? false,
+            textChunkLimit: clawbotConfig?.textChunkLimit ?? 2000,
+            autoRefreshToken: clawbotConfig?.autoRefreshToken ?? true,
+            httpTimeoutMs: clawbotConfig?.httpTimeoutMs ?? 30_000,
+            pollTimeoutSec: clawbotConfig?.pollTimeoutSec ?? 28,
+            pollRetryIntervalMs: clawbotConfig?.pollRetryIntervalMs ?? 3000,
+        });
+        channelsInfo.push({
+            name: 'clawbot',
+            displayName: '微信 ClawBot',
+            connectionMode: 'http-polling',
+            dmPolicy: 'open',
+            groupPolicy: 'disabled',
+            requireMention: false,
+        });
+    },
+};
+/** 插件自动发现约定的导出名 */
+export { clawbotChannelPlugin as channelPlugin };
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,57 @@
+import type { ChannelHandler, ChannelEvent, ChannelReply, ChannelConfig, ChannelStatus, ChannelMessageEvent, AgentFactory, ReplyFn } from '../../interface.js';
+export declare class FeishuChannel implements ChannelHandler {
+    readonly id = "feishu";
+    readonly name = "Feishu (\u98DE\u4E66)";
+    readonly description = "\u98DE\u4E66\u4F01\u4E1A\u5373\u65F6\u901A\u8BAF\u6E20\u9053\uFF0C\u652F\u6301 WebSocket \u957F\u8FDE\u63A5\u6536\u53D1\u6D88\u606F";
+    readonly pluginId: undefined;
+    private status;
+    private config;
+    private transport;
+    private eventHandler;
+    private logger;
+    private dedupeStore;
+    private messageQueue;
+    private sessionMap;
+    private conversationToSession;
+    private sessionPool;
+    private agentFactory;
+    private lastUsedLoop;
+    private lastUsedSessionId;
+    private persistChatIdFile;
+    private onUserMessage;
+    private onAgentReply;
+    private useStreamingCard;
+    private loopCache;
+    private loopAccessOrder;
+    private static MAX_LOOP_CACHE;
+    private sessionLoopMap;
+    private cachedToken;
+    private tokenExpiresAt;
+    start(config: ChannelConfig): Promise<void>;
+    stop(): Promise<void>;
+    onEvent(handler: (event: ChannelEvent) => Promise<void>): void;
+    reply(sessionId: string, reply: ChannelReply): Promise<void>;
+    getStatus(): ChannelStatus;
+    /** 获取 tenant access token（缓存，提前 60s 刷新，token 有效期 2h） */
+    private getTenantAccessToken;
+    /**
+     * 主动推送消息到飞书（非回复模式）。
+     * 用于定时任务等场景，此时没有 incoming message，需要根据 sessionId 查找 chatId 再发送。
+     */
+    sendProactiveMessage(sessionId: string, text: string): Promise<void>;
+    private persistFeishuState;
+    private restoreFeishuState;
+    /**
+     * 处理定时任务通知：运行 Agent 并将结果主动推送到飞书。
+     * @param taskName 定时任务名称
+     * @param sessionId 创建任务时的 session，用于确定回复目标
+     */
+    handleTaskNotification(taskName: string, sessionId?: string): Promise<void>;
+    handleMessage(event: ChannelMessageEvent, replyFn: ReplyFn, agentFactory: AgentFactory): Promise<void>;
+    updateConfig(newConfig: Record<string, unknown>): Promise<void>;
+    private handleWithCollectHandler;
+    private handleWithStreamingCard;
+    private getOrCreateLoop;
+    private handleRawMessage;
+}
+//# sourceMappingURL=feishu-channel.d.ts.map