hyacinth-ai 0.9.6

package/dist/channels/plugins/feishu/feishu-streaming.js

@@ -0,0 +1,185 @@
+// ============================================================
+// Feishu 流式输出控制器
+// ============================================================
+//
+// 参考 OpenClaw 的 streaming-card.ts，实现简化版：
+//   - 先发送占位卡片
+//   - 定期（或累积到一定量）更新卡片内容
+//   - 完成后发送最终卡片
+// ============================================================
+import { sendCard, patchCard, buildMarkdownCard } from './feishu-send.js';
+// ── 默认配置 ──
+const DEFAULT_UPDATE_INTERVAL_MS = 800;
+const MAX_CARD_TEXT_LENGTH = 4000;
+// ── 流式输出控制器 ──
+export class FeishuStreamingCard {
+    config;
+    state = 'idle';
+    messageId = null;
+    chatId = null;
+    replyToMessageId;
+    replyInThread;
+    buffer = '';
+    lastSentText = '';
+    updateTimer = null;
+    updateIntervalMs;
+    pendingUpdate = false;
+    onError;
+    constructor(config, options = {}) {
+        this.config = config;
+        this.replyToMessageId = options.replyToMessageId;
+        this.replyInThread = options.replyInThread ?? false;
+        this.updateIntervalMs = options.updateIntervalMs ?? DEFAULT_UPDATE_INTERVAL_MS;
+        this.onError = options.onError;
+    }
+    // ── 生命周期 ──
+    /**
+     * 启动流式输出：发送占位卡片
+     */
+    async start(to) {
+        if (this.state !== 'idle') {
+            throw new Error(`Cannot start streaming from state: ${this.state}`);
+        }
+        this.state = 'started';
+        try {
+            const placeholderCard = buildMarkdownCard('_思考中..._');
+            const result = await sendCard(this.config, {
+                to,
+                card: placeholderCard,
+                replyToMessageId: this.replyToMessageId,
+                replyInThread: this.replyInThread,
+            });
+            this.messageId = result.messageId;
+            this.chatId = result.chatId;
+            this.state = 'streaming';
+        }
+        catch (err) {
+            this.state = 'aborted';
+            throw err;
+        }
+    }
+    /**
+     * 追加文本内容
+     * 内部会按间隔触发卡片更新
+     */
+    append(text) {
+        if (this.state !== 'streaming') {
+            return;
+        }
+        this.buffer += text;
+        // 如果已有待更新，不重复触发
+        if (this.pendingUpdate) {
+            return;
+        }
+        this.pendingUpdate = true;
+        this.updateTimer = setTimeout(() => {
+            this.updateTimer = null;
+            this.flushUpdate();
+        }, this.updateIntervalMs);
+    }
+    /**
+     * 重置缓冲区（不清除已发送的卡片，仅清空内存中的累积文本）。
+     * 在 Agent 循环的每个新 turn 开始时调用，确保只保留最后一轮输出。
+     */
+    resetBuffer() {
+        // 取消待处理的定时更新
+        if (this.updateTimer) {
+            clearTimeout(this.updateTimer);
+            this.updateTimer = null;
+        }
+        this.pendingUpdate = false;
+        this.buffer = '';
+        this.lastSentText = '';
+    }
+    /**
+     * 完成流式输出：发送最终内容
+     */
+    async finish(finalText) {
+        if (this.state === 'finished' || this.state === 'aborted') {
+            return;
+        }
+        // 取消待处理的更新
+        if (this.updateTimer) {
+            clearTimeout(this.updateTimer);
+            this.updateTimer = null;
+        }
+        const text = finalText ?? this.buffer;
+        this.state = 'finished';
+        if (!this.messageId) {
+            return;
+        }
+        try {
+            const card = buildMarkdownCard(text || '_无内容_');
+            await patchCard(this.config, {
+                messageId: this.messageId,
+                card,
+            });
+        }
+        catch (err) {
+            this.onError?.(err instanceof Error ? err : new Error(String(err)));
+        }
+    }
+    /**
+     * 中止流式输出
+     */
+    async abort(reason) {
+        if (this.state === 'finished' || this.state === 'aborted') {
+            return;
+        }
+        if (this.updateTimer) {
+            clearTimeout(this.updateTimer);
+            this.updateTimer = null;
+        }
+        this.state = 'aborted';
+        if (!this.messageId) {
+            return;
+        }
+        try {
+            const card = buildMarkdownCard(this.buffer
+                ? `${this.buffer}\n\n---\n_已中止${reason ? `: ${reason}` : ''}_`
+                : `_已中止${reason ? `: ${reason}` : ''}_`);
+            await patchCard(this.config, {
+                messageId: this.messageId,
+                card,
+            });
+        }
+        catch (err) {
+            this.onError?.(err instanceof Error ? err : new Error(String(err)));
+        }
+    }
+    // ── 内部方法 ──
+    async flushUpdate() {
+        this.pendingUpdate = false;
+        if (this.state !== 'streaming' || !this.messageId) {
+            return;
+        }
+        // 如果内容没有变化，跳过
+        if (this.buffer === this.lastSentText) {
+            return;
+        }
+        // 截断过长内容
+        const displayText = this.buffer.length > MAX_CARD_TEXT_LENGTH
+            ? this.buffer.slice(0, MAX_CARD_TEXT_LENGTH) + '\n\n...'
+            : this.buffer;
+        this.lastSentText = this.buffer;
+        try {
+            const card = buildMarkdownCard(displayText || '_思考中..._');
+            await patchCard(this.config, {
+                messageId: this.messageId,
+                card,
+            });
+        }
+        catch (err) {
+            // 更新失败不中断流，记录错误即可
+            this.onError?.(err instanceof Error ? err : new Error(String(err)));
+        }
+    }
+    // ── Getter ──
+    getMessageId() {
+        return this.messageId;
+    }
+    getState() {
+        return this.state;
+    }
+}
+//# sourceMappingURL=feishu-streaming.js.map

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

@@ -0,0 +1,29 @@
+import type { FeishuChannelConfig } from './feishu-config.js';
+import type { FeishuMessageEvent } from './feishu-event.js';
+type Logger = {
+    info: (msg: string) => void;
+    error: (msg: string) => void;
+};
+export declare class FeishuTransport {
+    private config;
+    private logger;
+    private wsClient;
+    private eventDispatcher;
+    private messageHandler;
+    constructor(config: FeishuChannelConfig, log?: Logger);
+    /**
+     * 启动 WebSocket 连接。
+     * SDK 内置 autoReconnect（默认 true），断开后会自动重连，无需外层循环。
+     */
+    start(): Promise<void>;
+    /**
+     * 停止 WebSocket 连接
+     */
+    stop(): Promise<void>;
+    /**
+     * 注册消息处理回调
+     */
+    onMessage(handler: (event: FeishuMessageEvent) => Promise<void>): void;
+}
+export {};
+//# sourceMappingURL=feishu-transport.d.ts.map

package/dist/channels/plugins/feishu/feishu-transport.js

@@ -0,0 +1,99 @@
+// ============================================================
+// Feishu WebSocket 传输管理
+// ============================================================
+//
+// 管理 WebSocket 连接生命周期：
+//   - 连接建立（SDK 内置自动重连）
+//   - 事件注册与分发
+// ============================================================
+import { createFeishuWSClient, createEventDispatcher } from './feishu-client.js';
+function defaultLogger() {
+    return {
+        info: (msg) => process.stderr.write(`[feishu-ws] ${msg}\n`),
+        error: (msg) => process.stderr.write(`[feishu-ws] ${msg}\n`),
+    };
+}
+// ── 传输管理器 ──
+export class FeishuTransport {
+    config;
+    logger;
+    wsClient = null;
+    eventDispatcher = null;
+    messageHandler = null;
+    constructor(config, log) {
+        this.config = config;
+        this.logger = log ?? defaultLogger();
+    }
+    // ── 生命周期 ──
+    /**
+     * 启动 WebSocket 连接。
+     * SDK 内置 autoReconnect（默认 true），断开后会自动重连，无需外层循环。
+     */
+    async start() {
+        this.logger.info('starting WebSocket connection...');
+        // 创建事件分发器
+        this.eventDispatcher = await createEventDispatcher();
+        // 注册消息事件
+        this.eventDispatcher.register({
+            'im.message.receive_v1': async (data) => {
+                // SDK RequestHandle.parse() 将 header 字段展平到顶层
+                const flatData = data;
+                const event = flatData;
+                // 从顶层提取 event_id（SDK 展平后不再有嵌套 header）
+                const eventId = flatData.event_id;
+                if (event && typeof event === 'object' && eventId) {
+                    event._eventId = eventId;
+                }
+                if (this.messageHandler) {
+                    this.messageHandler(event).catch((err) => {
+                        this.logger.error(`message handler error: ${String(err)}`);
+                    });
+                }
+                else {
+                    this.logger.error('message received but no handler registered');
+                }
+            },
+        });
+        // 创建 WSClient（SDK 自动处理重连）
+        this.wsClient = await createFeishuWSClient(this.config, {
+            onError: (err) => {
+                this.logger.error(`WebSocket error: ${err.message}`);
+            },
+            onReady: () => {
+                this.logger.info('WebSocket connected');
+            },
+            onReconnecting: () => {
+                this.logger.info('WebSocket reconnecting...');
+            },
+            onReconnected: () => {
+                this.logger.info('WebSocket reconnected');
+            },
+        });
+        // 启动连接（SDK 后台保持，断开后自动重连）
+        await this.wsClient.start({ eventDispatcher: this.eventDispatcher });
+        this.logger.info('WebSocket client started');
+    }
+    /**
+     * 停止 WebSocket 连接
+     */
+    async stop() {
+        this.logger.info('stopping WebSocket...');
+        if (this.wsClient) {
+            try {
+                this.wsClient.close();
+            }
+            catch {
+                // 忽略关闭错误
+            }
+            this.wsClient = null;
+        }
+        this.messageHandler = null;
+    }
+    /**
+     * 注册消息处理回调
+     */
+    onMessage(handler) {
+        this.messageHandler = handler;
+    }
+}
+//# sourceMappingURL=feishu-transport.js.map

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

@@ -0,0 +1,22 @@
+import { FeishuChannel } from './feishu-channel.js';
+import type { ChannelPlugin } from '../../auto-detect.js';
+export { FeishuChannel } from './feishu-channel.js';
+export { FeishuTransport } from './feishu-transport.js';
+export { resolveFeishuConfig, validateFeishuConfig, type FeishuChannelConfig, type FeishuConnectionMode, type FeishuDmPolicy, type FeishuGroupPolicy, } from './feishu-config.js';
+export { parseFeishuMessageEvent, parseMessageContent, checkBotMentioned, checkMessageDedupe, FeishuDedupeStore, checkDmAccess, checkGroupAccess, type FeishuMessageEvent, type FeishuMessageContext, } from './feishu-event.js';
+export { installSDKLogSuppressor } from './feishu-log-suppressor.js';
+export { createFeishuClient, createFeishuWSClient, createEventDispatcher, getCachedClient, clearClientCache, FeishuClientFactory, } from './feishu-client.js';
+export { sendText, sendCard, patchCard, buildMarkdownCard, getSenderInfo, type FeishuSendResult, } from './feishu-send.js';
+export { FeishuStreamingCard } from './feishu-streaming.js';
+export { ChannelSessionPool, createCollectHandler, type CollectHandler, type SessionRunner, type SessionEntry, type SessionMode, } from './feishu-session.js';
+/**
+ * 创建飞书渠道实例（便捷工厂函数）
+ */
+export declare function createFeishuChannel(): FeishuChannel;
+/**
+ * 飞书渠道自动注册插件
+ */
+export declare const feishuChannelPlugin: ChannelPlugin;
+/** 插件自动发现约定的导出名 */
+export { feishuChannelPlugin as channelPlugin };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,68 @@
+// ============================================================
+// Feishu 渠道插件 — 导出入口
+// ============================================================
+//
+// 使用方式：
+//   import { createFeishuChannel } from './channels/plugins/feishu/index.js';
+//   channelManager.register(createFeishuChannel(), feishuConfig);
+// ============================================================
+import { FeishuChannel } from './feishu-channel.js';
+import { createLogger } from '../../../logging/logger.js';
+import { installSDKLogSuppressor } from './feishu-log-suppressor.js';
+const logger = createLogger('feishu-plugin');
+export { FeishuChannel } from './feishu-channel.js';
+export { FeishuTransport } from './feishu-transport.js';
+export { resolveFeishuConfig, validateFeishuConfig, } from './feishu-config.js';
+export { parseFeishuMessageEvent, parseMessageContent, checkBotMentioned, checkMessageDedupe, FeishuDedupeStore, checkDmAccess, checkGroupAccess, } from './feishu-event.js';
+export { installSDKLogSuppressor } from './feishu-log-suppressor.js';
+export { createFeishuClient, createFeishuWSClient, createEventDispatcher, getCachedClient, clearClientCache, FeishuClientFactory, } from './feishu-client.js';
+export { sendText, sendCard, patchCard, buildMarkdownCard, getSenderInfo, } from './feishu-send.js';
+export { FeishuStreamingCard } from './feishu-streaming.js';
+export { ChannelSessionPool, createCollectHandler, } from './feishu-session.js';
+/**
+ * 创建飞书渠道实例（便捷工厂函数）
+ */
+export function createFeishuChannel() {
+    return new FeishuChannel();
+}
+/**
+ * 飞书渠道自动注册插件
+ */
+export const feishuChannelPlugin = {
+    configKey: 'feishu',
+    onGatewayInit() {
+        return installSDKLogSuppressor();
+    },
+    async autoRegister(channelManager, config, channelsInfo) {
+        const feishuConfig = config;
+        const shouldRun = feishuConfig?.enabled !== false && feishuConfig?.appId && feishuConfig?.appSecret;
+        if (!shouldRun || !feishuConfig) {
+            return;
+        }
+        logger.info('auto-detected feishu channel, registering...');
+        channelManager.register(createFeishuChannel(), {
+            appId: feishuConfig.appId,
+            appSecret: feishuConfig.appSecret,
+            domain: feishuConfig.domain,
+            dmPolicy: feishuConfig.dmPolicy,
+            allowFrom: feishuConfig.allowFrom,
+            groupPolicy: feishuConfig.groupPolicy,
+            groupAllowFrom: feishuConfig.groupAllowFrom,
+            requireMention: feishuConfig.requireMention,
+            resolveSenderNames: feishuConfig.resolveSenderNames,
+            tuiSync: feishuConfig.tuiSync,
+            sessionMode: feishuConfig.sessionMode,
+        });
+        channelsInfo.push({
+            name: 'feishu',
+            displayName: '飞书',
+            connectionMode: 'websocket',
+            dmPolicy: feishuConfig.dmPolicy ?? 'allowlist',
+            groupPolicy: feishuConfig.groupPolicy ?? 'allowlist',
+            requireMention: feishuConfig.requireMention ?? true,
+        });
+    },
+};
+/** 插件自动发现约定的导出名 */
+export { feishuChannelPlugin as channelPlugin };
+//# sourceMappingURL=index.js.map

package/dist/cli/doctor.d.ts

@@ -0,0 +1,20 @@
+/**
+ * hyacinth doctor — 系统诊断 + 自动修复
+ *
+ * 检查项：
+ *   1. 运行环境（Node 版本、OS、编码）
+ *   2. 依赖完整性（sharp、chokidar、better-sqlite3）
+ *   3. 原生模块（better-sqlite3 .node 二进制）
+ *   4. Persona 文件（是否仍是模板？显示原始提示词）
+ *   5. 配置文件（~/.agent/config.json）
+ *   6. 知识库状态（kb.sqlite、files/ 目录）
+ *   7. API Key 检测
+ *
+ * --fix 参数自动安装缺失依赖
+ */
+export interface DoctorOptions {
+    fix?: boolean;
+    showPrompts?: boolean;
+}
+export declare function runDoctor(opts?: DoctorOptions): Promise<void>;
+//# sourceMappingURL=doctor.d.ts.map