lightclawbot 1.0.6 → 1.0.7

package/dist/src/streaming/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * LightClaw — 流式输出模块
+ *
+ * 统一导出流式输出相关的类型、工具和分发器。
+ *
+ * 使用方式：
+ *   import { createStreamReplyConfig } from "./streaming/index.js";
+ */
+export type { StreamFrameKind, DeltaTrackerState, StreamReplySinkOptions } from "./types.js";
+export { createDeltaTrackerState, toStreamDeltaText } from "./delta-tracker.js";
+export { createStreamReplyConfig } from "./stream-reply-sink.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/streaming/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/streaming/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAG7F,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGhF,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/src/streaming/index.js

@@ -0,0 +1,13 @@
+/**
+ * LightClaw — 流式输出模块
+ *
+ * 统一导出流式输出相关的类型、工具和分发器。
+ *
+ * 使用方式：
+ *   import { createStreamReplyConfig } from "./streaming/index.js";
+ */
+// 增量计算器
+export { createDeltaTrackerState, toStreamDeltaText } from "./delta-tracker.js";
+// 真流式回复配置（dispatcher + replyOptions，用于 dispatchReplyFromConfig）
+export { createStreamReplyConfig } from "./stream-reply-sink.js";
+//# sourceMappingURL=index.js.map

package/dist/src/streaming/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/streaming/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,QAAQ;AACR,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEhF,gEAAgE;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/src/streaming/stream-reply-sink.d.ts

@@ -0,0 +1,59 @@
+/**
+ * LightClaw — 真流式回复分发 (StreamReplySink)
+ *
+ * 参考 kimi-claw 的 `handleSessionPrompt` (ACP 通路) 中的流式分发架构。
+ *
+ * 核心改造：
+ *   从 `dispatchReplyWithBufferedBlockDispatcher` (Buffered Block 模式) 切换到
+ *   `dispatchReplyFromConfig` (直接回调模式)，实现逐 token 的真流式输出。
+ *
+ * 原理对比：
+ *   - 旧模式（Buffered Block）：框架内部缓冲 → 累积一个 block → deliver(payload, {kind})
+ *     用户体验：等一会儿突然蹦出一大段文字
+ *   - 新模式（dispatchReplyFromConfig）：AI 每个 token → onPartialReply 实时回调
+ *     用户体验：逐字/逐词流畅输出
+ *
+ * dispatchReplyFromConfig 需要两个参数：
+ *   1. dispatcher: ReplyDispatcher — 包含 sendToolResult / sendBlockReply / sendFinalReply 等
+ *   2. replyOptions: GetReplyOptions — 包含 onPartialReply / onReasoningStream / onToolStart 等
+ */
+import type { StreamReplySinkOptions } from "./types.js";
+import type { SignalContext } from "../types.js";
+/**
+ * 创建真流式回复的 dispatcher 和 replyOptions。
+ *
+ * 返回 `{ dispatcher, replyOptions }` 对象，直接用于
+ * `dispatchReplyFromConfig` 的参数。
+ *
+ * 对齐 kimi-claw `handleSessionPrompt` 中的实现：
+ *   - onPartialReply: 每个 token 增量 → 实时 emit stream_chunk
+ *   - onReasoningStream: 思考过程增量 → 实时 emit reasoning_chunk
+ *   - onToolStart: 工具调用开始通知
+ *   - sendFinalReply: 去重后发送最终增量
+ *   - sendBlockReply: 不处理（已通过 onPartialReply 实时推送）
+ */
+export declare function createStreamReplyConfig(opts: StreamReplySinkOptions, prefixOptions: Record<string, unknown>, signalCtx: SignalContext): {
+    dispatcher: {
+        sendToolResult: (payload: {
+            text?: string;
+            mediaUrls?: string[];
+            mediaUrl?: string;
+            isError?: boolean;
+        }) => boolean;
+        sendBlockReply: (payload: {
+            text?: string;
+            mediaUrls?: string[];
+            mediaUrl?: string;
+        }) => boolean;
+        sendFinalReply: (payload: {
+            text?: string;
+            mediaUrls?: string[];
+            mediaUrl?: string;
+        }) => boolean;
+        waitForIdle: () => Promise<void>;
+        getQueuedCounts: () => Record<string, number>;
+        markComplete: () => void;
+    };
+    replyOptions: Record<string, unknown>;
+};
+//# sourceMappingURL=stream-reply-sink.d.ts.map

package/dist/src/streaming/stream-reply-sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-reply-sink.d.ts","sourceRoot":"","sources":["../../../src/streaming/stream-reply-sink.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjD;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,sBAAsB,EAC5B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtC,SAAS,EAAE,aAAa,GACvB;IACD,UAAU,EAAE;QACV,cAAc,EAAE,CAAC,OAAO,EAAE;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,OAAO,CAAA;SAAE,KAAK,OAAO,CAAC;QACpH,cAAc,EAAE,CAAC,OAAO,EAAE;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,KAAK,OAAO,CAAC;QACjG,cAAc,EAAE,CAAC,OAAO,EAAE;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,KAAK,OAAO,CAAC;QACjG,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QACjC,eAAe,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC9C,YAAY,EAAE,MAAM,IAAI,CAAC;KAC1B,CAAC;IACF,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC,CAiSA"}

package/dist/src/streaming/stream-reply-sink.js

@@ -0,0 +1,293 @@
+/**
+ * LightClaw — 真流式回复分发 (StreamReplySink)
+ *
+ * 参考 kimi-claw 的 `handleSessionPrompt` (ACP 通路) 中的流式分发架构。
+ *
+ * 核心改造：
+ *   从 `dispatchReplyWithBufferedBlockDispatcher` (Buffered Block 模式) 切换到
+ *   `dispatchReplyFromConfig` (直接回调模式)，实现逐 token 的真流式输出。
+ *
+ * 原理对比：
+ *   - 旧模式（Buffered Block）：框架内部缓冲 → 累积一个 block → deliver(payload, {kind})
+ *     用户体验：等一会儿突然蹦出一大段文字
+ *   - 新模式（dispatchReplyFromConfig）：AI 每个 token → onPartialReply 实时回调
+ *     用户体验：逐字/逐词流畅输出
+ *
+ * dispatchReplyFromConfig 需要两个参数：
+ *   1. dispatcher: ReplyDispatcher — 包含 sendToolResult / sendBlockReply / sendFinalReply 等
+ *   2. replyOptions: GetReplyOptions — 包含 onPartialReply / onReasoningStream / onToolStart 等
+ */
+import { CHANNEL_KEY } from "../config.js";
+import { uploadFileToCos } from "../file-storage.js";
+import { mediaUrlsToFiles } from "../media.js";
+import { createDeltaTrackerState, toStreamDeltaText } from "./delta-tracker.js";
+import { emitSignal } from "../types.js";
+/**
+ * 创建真流式回复的 dispatcher 和 replyOptions。
+ *
+ * 返回 `{ dispatcher, replyOptions }` 对象，直接用于
+ * `dispatchReplyFromConfig` 的参数。
+ *
+ * 对齐 kimi-claw `handleSessionPrompt` 中的实现：
+ *   - onPartialReply: 每个 token 增量 → 实时 emit stream_chunk
+ *   - onReasoningStream: 思考过程增量 → 实时 emit reasoning_chunk
+ *   - onToolStart: 工具调用开始通知
+ *   - sendFinalReply: 去重后发送最终增量
+ *   - sendBlockReply: 不处理（已通过 onPartialReply 实时推送）
+ */
+export function createStreamReplyConfig(opts, prefixOptions, signalCtx) {
+    const { emitter, targetId, originalMsgId, log, effectiveApiKey } = opts;
+    // ── 增量追踪器：追踪 AI 输出的累计文本快照 ──
+    // 参考 kimi-claw 中 const I = { latest: "" } 和 _ = { latest: "" }
+    const partialReplyState = createDeltaTrackerState();
+    const reasoningState = createDeltaTrackerState();
+    // ── 已通过流式推送的累计文本（用于 sendFinalReply 时去重） ──
+    // 参考 kimi-claw 中 let y = ""
+    let streamedText = "";
+    // ── 分发计数器（对齐 kimi-claw 中的 w = { tool: 0, block: 0, final: 0 }） ──
+    const counts = { tool: 0, block: 0, final: 0 };
+    // ── typing 状态管理 ──
+    let typingStartSent = false;
+    let idleSent = false;
+    /**
+     * 确保 typing_start 只发一次。
+     * 在 onPartialReply / onReasoningStream 首次触发时自动发送。
+     */
+    const ensureTypingStart = () => {
+        if (!typingStartSent) {
+            typingStartSent = true;
+            emitSignal(signalCtx, "typing_start");
+        }
+    };
+    /**
+     * 发送 typing_stop（幂等）
+     */
+    const sendTypingStop = () => {
+        if (idleSent)
+            return;
+        idleSent = true;
+        emitSignal(signalCtx, "typing_stop");
+    };
+    /**
+     * 处理最终回复中的媒体文件（COS 上传 + 发送）
+     */
+    const handleMediaFinal = async (replyText, mediaList) => {
+        if (mediaList.length === 0)
+            return false;
+        const files = await mediaUrlsToFiles(mediaList, log);
+        const publicUrls = [];
+        const storageConfig = {
+            apiKey: effectiveApiKey,
+        };
+        for (const mediaUrl of mediaList) {
+            try {
+                const localPath = mediaUrl.startsWith("file://")
+                    ? mediaUrl.slice(7)
+                    : mediaUrl;
+                if (localPath.startsWith("/") || localPath.match(/^[A-Za-z]:\\/)) {
+                    const { existsSync } = await import("node:fs");
+                    if (existsSync(localPath)) {
+                        const result = await uploadFileToCos(localPath, storageConfig);
+                        publicUrls.push(result.url || "");
+                        log?.info(`[${CHANNEL_KEY}] [stream] Uploaded to COS: ${localPath} → ${result.url}`);
+                    }
+                }
+            }
+            catch (uploadErr) {
+                log?.warn(`[${CHANNEL_KEY}] [stream] COS upload failed for ${mediaUrl}: ${uploadErr}`);
+            }
+        }
+        let enrichedText = replyText;
+        if (publicUrls.length > 0) {
+            const urlSection = publicUrls
+                .map((url, i) => {
+                const match = url.match(/filePath=([^&]+)/);
+                const filePath = match ? decodeURIComponent(match[1]) : "";
+                const fileName = filePath.split("/").pop() || `file${publicUrls.length > 1 ? ` (${i + 1})` : ""}`;
+                return `📎 [${fileName}](${url})`;
+            })
+                .join("\n");
+            enrichedText = enrichedText
+                ? `${enrichedText}\n\n${urlSection}`
+                : urlSection;
+        }
+        if (files.length > 0) {
+            emitter.sendFiles(targetId, enrichedText, files, originalMsgId);
+            return true;
+        }
+        if (enrichedText.trim()) {
+            emitter.sendReply(targetId, enrichedText, originalMsgId);
+            return true;
+        }
+        return false;
+    };
+    // ════════════════════════════════════════════════════════════
+    // dispatcher — 对齐 kimi-claw 中的 R.dispatcher
+    // ════════════════════════════════════════════════════════════
+    const dispatcher = {
+        /**
+         * sendToolResult — 工具调用结果
+         *
+         * 参考 kimi-claw: 发送 tool_call_update session update
+         * lightclaw 场景下，工具结果通常由框架内部消费，不需要额外推送给用户
+         */
+        sendToolResult: (payload) => {
+            counts.tool++;
+            log?.info(`[${CHANNEL_KEY}] [stream] sendToolResult: textLen=${payload.text?.length ?? 0} isError=${payload.isError ?? false}`);
+            return true;
+        },
+        /**
+         * sendBlockReply — 块回复
+         *
+         * 参考 kimi-claw: sendBlockReply 不处理，因为已通过 onPartialReply 实时推送
+         * 这是关键差异：旧模式中 deliver(block) 是主要输出渠道，
+         * 新模式中 onPartialReply 才是主输出渠道，sendBlockReply 可以忽略。
+         */
+        sendBlockReply: (_payload) => {
+            counts.block++;
+            log?.debug?.(`[${CHANNEL_KEY}] [stream] sendBlockReply: ignored (already streamed via onPartialReply)`);
+            return true;
+        },
+        /**
+         * sendFinalReply — 最终回复
+         *
+         * 参考 kimi-claw sendFinalReply 的去重逻辑：
+         *   1. 如果最终文本与已流式推送的文本完全一致 → 不再发送
+         *   2. 如果最终文本以已推送文本为前缀 → 只发送增量部分
+         *   3. 如果完全不同 → 发送完整文本
+         */
+        sendFinalReply: (payload) => {
+            counts.final++;
+            const replyText = payload.text ?? "";
+            const mediaList = payload.mediaUrls?.length
+                ? payload.mediaUrls
+                : payload.mediaUrl ? [payload.mediaUrl] : [];
+            log?.info(`[${CHANNEL_KEY}] [stream] sendFinalReply: textLen=${replyText.length} mediaCount=${mediaList.length} streamedLen=${streamedText.length}`);
+            // 处理媒体文件（异步，但 dispatcher 是同步返回的）
+            if (mediaList.length > 0) {
+                handleMediaFinal(replyText, mediaList).catch((err) => {
+                    log?.error(`[${CHANNEL_KEY}] [stream] sendFinalReply media handling error: ${err}`);
+                });
+            }
+            // 文本去重逻辑 — 参考 kimi-claw sendFinalReply
+            if (replyText.length > 0) {
+                if (streamedText) {
+                    if (replyText === streamedText) {
+                        // 完全一致，无需再发
+                        log?.debug?.(`[${CHANNEL_KEY}] [stream] Final text identical to streamed, skipping`);
+                    }
+                    else if (replyText.startsWith(streamedText)) {
+                        // 最终文本以已推送文本为前缀，只发送剩余增量
+                        const remaining = replyText.slice(streamedText.length);
+                        if (remaining.length > 0) {
+                            streamedText += remaining;
+                            partialReplyState.latest = replyText;
+                            emitSignal(signalCtx, "stream_chunk", remaining);
+                            log?.debug?.(`[${CHANNEL_KEY}] [stream] Final delta: ${remaining.length} chars`);
+                        }
+                    }
+                    else {
+                        // 最终文本与流式文本不匹配，发送完整回复
+                        log?.warn(`[${CHANNEL_KEY}] [stream] Final text mismatch with streamed text, sending full reply`);
+                        emitter.sendReply(targetId, replyText, originalMsgId);
+                    }
+                }
+                else {
+                    // 没有流式推送过（可能 onPartialReply 未触发），直接发送完整回复
+                    emitter.sendReply(targetId, replyText, originalMsgId);
+                }
+            }
+            return true;
+        },
+        /**
+         * waitForIdle — 等待空闲
+         * 参考 kimi-claw: async () => {}
+         */
+        waitForIdle: async () => { },
+        /**
+         * getQueuedCounts — 获取排队计数
+         * 参考 kimi-claw: () => ({ ...w })
+         */
+        getQueuedCounts: () => ({ ...counts }),
+        /**
+         * markComplete — 标记完成
+         * 参考 kimi-claw: () => {}
+         */
+        markComplete: () => {
+            sendTypingStop();
+        },
+    };
+    // ════════════════════════════════════════════════════════════
+    // replyOptions — 对齐 kimi-claw 中的 E (replyOptions)
+    // ════════════════════════════════════════════════════════════
+    const replyOptions = {
+        // ── 来自 prefixOptions 的配置（responsePrefix、onModelSelected 等） ──
+        ...prefixOptions,
+        /**
+         * onPartialReply — 核心！每个 token 增量回调
+         *
+         * 参考 kimi-claw:
+         *   onPartialReply: (e) => {
+         *     const o = toStreamDeltaText(I, e.text);
+         *     o && (y += o, t.sendSessionUpdate(r, { sessionUpdate: "agent_message_chunk", content: { type: "text", text: o } }, n));
+         *   }
+         *
+         * 这是实现真流式的关键：AI 引擎每产出一个 token 就触发此回调。
+         */
+        onPartialReply: (payload) => {
+            if (!payload.text)
+                return;
+            ensureTypingStart();
+            const delta = toStreamDeltaText(partialReplyState, payload.text);
+            if (delta && delta.length > 0) {
+                streamedText += delta;
+                emitSignal(signalCtx, "stream_chunk", delta);
+                log?.debug?.(`[${CHANNEL_KEY}] [stream] onPartialReply delta: ${delta.length} chars`);
+            }
+        },
+        /**
+         * onReasoningStream — 思考过程增量回调
+         *
+         * 参考 kimi-claw:
+         *   onReasoningStream: (e) => {
+         *     const o = toStreamDeltaText(_, e.text);
+         *     o && t.sendSessionUpdate(r, { sessionUpdate: "agent_thought_chunk", content: { type: "text", text: o } }, n);
+         *   }
+         */
+        onReasoningStream: (payload) => {
+            if (!payload.text)
+                return;
+            ensureTypingStart();
+            const delta = toStreamDeltaText(reasoningState, payload.text);
+            if (delta && delta.length > 0) {
+                // 推送思考过程增量（使用 stream_chunk + 特殊前缀，或直接忽略）
+                // lightclaw 客户端目前不支持独立的 reasoning 通道，暂不推送
+                log?.debug?.(`[${CHANNEL_KEY}] [stream] onReasoningStream delta: ${delta.length} chars`);
+            }
+        },
+        /**
+         * onToolStart — 工具调用开始
+         *
+         * 参考 kimi-claw: 发送 tool_call session update
+         */
+        onToolStart: (payload) => {
+            log?.info(`[${CHANNEL_KEY}] [stream] onToolStart: name=${payload.name ?? "unknown"} phase=${payload.phase ?? ""}`);
+        },
+        /**
+         * onReplyStart — AI 开始生成回复
+         */
+        onReplyStart: () => {
+            ensureTypingStart();
+        },
+        /**
+         * onAgentRunStart — Agent 运行开始
+         */
+        onAgentRunStart: (runId) => {
+            log?.info(`[${CHANNEL_KEY}] [stream] Agent run started: runId=${runId}`);
+        },
+        // 禁用 block streaming（我们通过 onPartialReply 直接处理）
+        disableBlockStreaming: false,
+    };
+    return { dispatcher, replyOptions };
+}
+//# sourceMappingURL=stream-reply-sink.js.map

package/dist/src/streaming/stream-reply-sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-reply-sink.js","sourceRoot":"","sources":["../../../src/streaming/stream-reply-sink.ts"],"names":[],"mappings":"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"}

package/dist/src/streaming/types.d.ts

@@ -0,0 +1,45 @@
+/**
+ * LightClaw — 流式输出类型定义
+ *
+ * 参考 kimi-claw 的 ImSendMessageStream 和 ACP handlers 中的流式回复模式。
+ */
+import type { SocketEmitter } from "../types.js";
+/** 流式输出的消息子类型 */
+export type StreamFrameKind = "typing_start" | "stream_chunk" | "reasoning_chunk" | "tool_start" | "tool_result" | "stream_end" | "typing_stop";
+/**
+ * 增量追踪器内部状态。
+ *
+ * 参考 kimi-claw `toStreamDeltaText` 中的 `{ latest, mode, lastEmitted, localSnapshot }` 结构。
+ * 用于将 AI 引擎输出的文本（可能是快照/增量混合模式）转换为纯增量。
+ */
+export interface DeltaTrackerState {
+    /** 目前已知的最新完整文本（快照） */
+    latest: string;
+    /** 当前检测到的模式：snapshot = AI 输出全量快照；delta = AI 输出增量 */
+    mode: "snapshot" | "delta" | "unknown";
+    /** 上一次实际发出的增量文本 */
+    lastEmitted: string;
+    /** 用于 delta 模式下追踪本地快照 */
+    localSnapshot: string | undefined;
+}
+/** 创建 StreamReplySink 所需的参数 */
+export interface StreamReplySinkOptions {
+    /** Socket 事件发射器（复用 inbound 中的 emitter） */
+    emitter: SocketEmitter;
+    /** 发送目标用户 ID */
+    targetId: string;
+    /** 回复消息 ID（整个流共用同一个） */
+    replyMsgId: string;
+    /** 原始用户消息 ID（用于 replyToMsgId） */
+    originalMsgId: string;
+    /** 日志器 */
+    log?: {
+        info: (msg: string) => void;
+        warn: (msg: string) => void;
+        error: (msg: string) => void;
+        debug?: (msg: string) => void;
+    };
+    /** 当前有效的 API Key（用于 COS 上传） */
+    effectiveApiKey: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/streaming/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/streaming/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAMjD,iBAAiB;AACjB,MAAM,MAAM,eAAe,GACvB,cAAc,GACd,cAAc,GACd,iBAAiB,GACjB,YAAY,GACZ,aAAa,GACb,YAAY,GACZ,aAAa,CAAC;AAMlB;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;IACvC,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAMD,+BAA+B;AAC/B,MAAM,WAAW,sBAAsB;IACrC,0CAA0C;IAC1C,OAAO,EAAE,aAAa,CAAC;IACvB,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU;IACV,GAAG,CAAC,EAAE;QACJ,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;QAC5B,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;QAC5B,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;QAC7B,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;KAC/B,CAAC;IACF,+BAA+B;IAC/B,eAAe,EAAE,MAAM,CAAC;CACzB"}

package/dist/src/streaming/types.js

@@ -0,0 +1,7 @@
+/**
+ * LightClaw — 流式输出类型定义
+ *
+ * 参考 kimi-claw 的 ImSendMessageStream 和 ACP handlers 中的流式回复模式。
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/streaming/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/streaming/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lightclawbot",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "description": "LightClawBot channel plugin with message support, cron jobs, and proactive messaging",
   "type": "module",
   "main": "./dist/index.js",

package/dist/public/data/scripts/preflight.78097a58.sh

@@ -1,94 +0,0 @@
-#!/bin/bash
-
-# ========== lightclawbot 插件前置检查脚本 ==========
-# 用途：快速判断 lightclawbot 插件是否可用
-# 输出：最后一行固定为 RESULT:{...} JSON，供前端解析
-#   - 可用：           RESULT:{"status":"ok","version":"x.y.z"}
-#   - 缺 openclaw：    RESULT:{"status":"need_openclaw","reason":"..."}
-#   - 缺 lightclawbot：RESULT:{"status":"need_install","reason":"..."}
-#   - 缺 apiKey：      RESULT:{"status":"need_apikey","reason":"apikeys_empty"}
-#
-# 使用方式：
-#   本地执行：  bash scripts/preflight.sh
-#   CDN 执行：  bash <(curl -fsSL https://your-cdn.com/preflight.sh)
-
-id="lightclawbot"
-cfg="$HOME/.openclaw/openclaw.json"
-plugin_dir="$HOME/.openclaw/extensions/${id}"
-
-# ---------- 1. 检查 openclaw 是否可用 ----------
-
-# 加载 nvm 环境（openclaw 可能依赖 nvm 管理的 node）
-export NVM_DIR="$HOME/.nvm"
-[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
-
-if ! command -v openclaw &>/dev/null; then
-  echo "RESULT:{\"status\":\"need_openclaw\",\"reason\":\"openclaw_not_found\"}"
-  exit 1
-fi
-
-# 验证 openclaw 可执行
-# 已知输出格式：
-#   - OpenClaw 2026.3.8 (3caab92)   （新版本，带前缀 + commit hash）
-#   - OpenClaw 2026.3.2             （带前缀，无 commit hash）
-#   - 2026.3.2                      （旧版本，直接输出版本号，无前缀）
-openclaw_output=$(openclaw -v 2>/dev/null || true)
-if ! echo "$openclaw_output" | grep -qiE '(^OpenClaw[/ ])?[0-9]+\.[0-9]+'; then
-  echo "RESULT:{\"status\":\"need_openclaw\",\"reason\":\"openclaw_not_working\"}"
-  exit 1
-fi
-
-# ---------- 2. 检查配置文件是否存在 ----------
-
-if [ ! -f "$cfg" ]; then
-  echo "RESULT:{\"status\":\"need_install\",\"reason\":\"config_not_found\"}"
-  exit 1
-fi
-
-# ---------- 3. 检查插件是否已安装（目录 + package.json） ----------
-
-if [ ! -d "$plugin_dir" ] || [ ! -f "$plugin_dir/package.json" ]; then
-  echo "RESULT:{\"status\":\"need_install\",\"reason\":\"plugin_not_installed\"}"
-  exit 1
-fi
-
-# ---------- 4. 检查配置文件中插件注册是否完整 ----------
-
-# 需要 jq 来解析 JSON
-if ! command -v jq &>/dev/null; then
-  echo "RESULT:{\"status\":\"need_install\",\"reason\":\"jq_not_found\"}"
-  exit 1
-fi
-
-# 4a. plugins.entries 中是否存在且 enabled
-plugin_enabled=$(jq -r ".plugins.entries.\"${id}\".enabled // false" "$cfg" 2>/dev/null)
-if [ "$plugin_enabled" != "true" ]; then
-  echo "RESULT:{\"status\":\"need_install\",\"reason\":\"plugin_not_enabled\"}"
-  exit 1
-fi
-
-# 4b. plugins.installs 中是否有安装记录
-if ! jq -e ".plugins.installs.\"${id}\"" "$cfg" > /dev/null 2>&1; then
-  echo "RESULT:{\"status\":\"need_install\",\"reason\":\"plugin_install_record_missing\"}"
-  exit 1
-fi
-
-# 4c. channels 中是否配置且 enabled
-channel_enabled=$(jq -r ".channels.\"${id}\".enabled // false" "$cfg" 2>/dev/null)
-if [ "$channel_enabled" != "true" ]; then
-  echo "RESULT:{\"status\":\"need_install\",\"reason\":\"channel_not_enabled\"}"
-  exit 1
-fi
-
-# 4d. channels 中 apiKeys 是否配置且非空
-apikeys_count=$(jq -r ".channels.\"${id}\".apiKeys // [] | length" "$cfg" 2>/dev/null)
-if [ "$apikeys_count" = "0" ] || [ -z "$apikeys_count" ]; then
-  echo "RESULT:{\"status\":\"need_install\",\"reason\":\"apikeys_empty\"}"
-  exit 1
-fi
-
-# ---------- 5. 全部通过，插件可用 ----------
-
-version=$(jq -r '.version // "unknown"' "$plugin_dir/package.json")
-echo "RESULT:{\"status\":\"ok\",\"version\":\"${version}\"}"
-exit 0