@blade-hq/agent-kit 0.0.0-placeholder.0 → 0.4.1

package/dist/internal/core/asr/VoiceWaveform.d.ts

@@ -0,0 +1,11 @@
+interface VoiceWaveformProps {
+    /** RMS 幅度 0..1 */
+    level: number;
+    /** 线条颜色；默认跟随 currentColor */
+    color?: string;
+    /** 按钮直径参考值，决定波形尺寸 */
+    size?: number;
+}
+export declare function VoiceWaveform({ level, color, size }: VoiceWaveformProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=VoiceWaveform.d.ts.map

package/dist/internal/core/asr/VoiceWaveform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VoiceWaveform.d.ts","sourceRoot":"","sources":["../../src/asr/VoiceWaveform.tsx"],"names":[],"mappings":"AAAA,UAAU,kBAAkB;IAC1B,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,qBAAqB;IACrB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAOD,wBAAgB,aAAa,CAAC,EAAE,KAAK,EAAE,KAAsB,EAAE,IAAS,EAAE,EAAE,kBAAkB,2CAkC7F"}

package/dist/internal/core/asr/VoiceWaveform.js

@@ -0,0 +1,28 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// 五根竖条，中间最高、两边递减。每根用不同的乘数制造错落感，但都由同一个 level 驱动：
+// 说话时整体跃起，静音时平直。CSS transform 让浏览器走 GPU 合成层，100ms 一次的
+// setState 足够顺。
+const BAR_MULTIPLIERS = [0.45, 0.75, 1, 0.75, 0.45];
+export function VoiceWaveform({ level, color = "currentColor", size = 16 }) {
+    const barWidth = Math.max(1.5, size / 10);
+    const gap = Math.max(1, size / 14);
+    const maxHeight = size * 0.85;
+    const minHeight = Math.max(2, size / 8);
+    return (_jsx("div", { "aria-hidden": "true", style: {
+            display: "flex",
+            alignItems: "center",
+            justifyContent: "center",
+            gap,
+            height: size,
+        }, children: BAR_MULTIPLIERS.map((mul, i) => {
+            const h = minHeight + (maxHeight - minHeight) * Math.min(1, level * mul);
+            return (_jsx("span", { style: {
+                    width: barWidth,
+                    height: h,
+                    borderRadius: barWidth,
+                    backgroundColor: color,
+                    transition: "height 80ms linear",
+                } }, i));
+        }) }));
+}
+//# sourceMappingURL=VoiceWaveform.js.map

package/dist/internal/core/asr/VoiceWaveform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VoiceWaveform.js","sourceRoot":"","sources":["../../src/asr/VoiceWaveform.tsx"],"names":[],"mappings":";AASA,gDAAgD;AAChD,sDAAsD;AACtD,gBAAgB;AAChB,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;AAEnD,MAAM,UAAU,aAAa,CAAC,EAAE,KAAK,EAAE,KAAK,GAAG,cAAc,EAAE,IAAI,GAAG,EAAE,EAAsB;IAC5F,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,EAAE,CAAC,CAAA;IACzC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,EAAE,CAAC,CAAA;IAClC,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,CAAA;IAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,CAAA;IAEvC,OAAO,CACL,6BACc,MAAM,EAClB,KAAK,EAAE;YACL,OAAO,EAAE,MAAM;YACf,UAAU,EAAE,QAAQ;YACpB,cAAc,EAAE,QAAQ;YACxB,GAAG;YACH,MAAM,EAAE,IAAI;SACb,YAEA,eAAe,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;YAC9B,MAAM,CAAC,GAAG,SAAS,GAAG,CAAC,SAAS,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,GAAG,CAAC,CAAA;YACxE,OAAO,CACL,eAEE,KAAK,EAAE;oBACL,KAAK,EAAE,QAAQ;oBACf,MAAM,EAAE,CAAC;oBACT,YAAY,EAAE,QAAQ;oBACtB,eAAe,EAAE,KAAK;oBACtB,UAAU,EAAE,oBAAoB;iBACjC,IAPI,CAAC,CAQN,CACH,CAAA;QACH,CAAC,CAAC,GACE,CACP,CAAA;AACH,CAAC"}

package/dist/internal/core/asr/use-tiptap-voice-input.d.ts

@@ -0,0 +1,30 @@
+import type { Editor as TiptapEditor } from "@tiptap/react";
+import { type VoiceInputStatus } from "./use-voice-input";
+import type { VoiceInputError } from "./voice-input-support";
+export interface UseTiptapVoiceInputOptions {
+    /** Tiptap editor ref；null 时 voice 回调会静默丢弃 */
+    editorRef: {
+        current: TiptapEditor | null;
+    };
+    /** AudioWorklet processor 文件 URL */
+    workletUrl: string;
+    /** 外部可选回调：识别错误时拿 message */
+    onError?: (error: VoiceInputError) => void;
+}
+export interface UseTiptapVoiceInputResult {
+    status: VoiceInputStatus;
+    isRecording: boolean;
+    error: string | null;
+    /** 当前音频 RMS 幅度，0..1，仅在 recording 期间有意义，用于驱动波形动画 */
+    level: number;
+    toggle: () => void;
+    stop: () => Promise<void>;
+}
+/**
+ * Tiptap 编辑器里的语音输入集成：
+ * - partial 段用 `insertContentAt({from,to}, text)` 替换一个可变 range
+ * - final 段落定后把 range 推进到末尾，下一段重新起
+ * - 录音期间调用 `editor.setEditable(false)` 锁定键盘输入
+ */
+export declare function useTiptapVoiceInput(options: UseTiptapVoiceInputOptions): UseTiptapVoiceInputResult;
+//# sourceMappingURL=use-tiptap-voice-input.d.ts.map

package/dist/internal/core/asr/use-tiptap-voice-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tiptap-voice-input.d.ts","sourceRoot":"","sources":["../../src/asr/use-tiptap-voice-input.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,YAAY,EAAE,MAAM,eAAe,CAAA;AAE3D,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAE5D,MAAM,WAAW,0BAA0B;IACzC,6CAA6C;IAC7C,SAAS,EAAE;QAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAAA;KAAE,CAAA;IAC3C,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAA;IAClB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAA;CAC3C;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,gBAAgB,CAAA;IACxB,WAAW,EAAE,OAAO,CAAA;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,0BAA0B,GAClC,yBAAyB,CA6F3B"}

package/dist/internal/core/asr/use-tiptap-voice-input.js

@@ -0,0 +1,100 @@
+import { useCallback, useEffect, useEffectEvent, useRef } from "react";
+import { useVoiceInput } from "./use-voice-input";
+/**
+ * Tiptap 编辑器里的语音输入集成：
+ * - partial 段用 `insertContentAt({from,to}, text)` 替换一个可变 range
+ * - final 段落定后把 range 推进到末尾，下一段重新起
+ * - 录音期间调用 `editor.setEditable(false)` 锁定键盘输入
+ */
+export function useTiptapVoiceInput(options) {
+    const { editorRef, workletUrl, onError } = options;
+    const partialRangeRef = useRef(null);
+    // 最近一次 partial 的字符数：豆包 result_type=single 模式下每段话 VAD 结束后
+    // 累积器会归零，下一段 partial 从空开始增长。只要新 partial 比上一次短，就
+    // 说明跨过了句子边界：把之前的内容冻结在原位，为新句子开新 range。
+    const lastPartialLenRef = useRef(0);
+    const handlePartial = useEffectEvent((text) => {
+        const ed = editorRef.current;
+        if (!ed)
+            return;
+        let range = partialRangeRef.current;
+        if (range && text.length < lastPartialLenRef.current) {
+            range = { from: range.to, to: range.to };
+            partialRangeRef.current = range;
+        }
+        if (!range) {
+            const pos = ed.state.selection.from;
+            range = { from: pos, to: pos };
+            partialRangeRef.current = range;
+        }
+        const { from, to } = range;
+        if (text) {
+            ed.chain().insertContentAt({ from, to }, text).run();
+            partialRangeRef.current = { from, to: from + text.length };
+            lastPartialLenRef.current = text.length;
+        }
+        else if (to > from) {
+            ed.chain().deleteRange({ from, to }).run();
+            partialRangeRef.current = { from, to: from };
+            lastPartialLenRef.current = 0;
+        }
+    });
+    const handleFinal = useEffectEvent((text) => {
+        const ed = editorRef.current;
+        if (!ed || !text)
+            return;
+        const range = partialRangeRef.current;
+        if (range) {
+            ed.chain().insertContentAt({ from: range.from, to: range.to }, text).run();
+            const newEnd = range.from + text.length;
+            partialRangeRef.current = { from: newEnd, to: newEnd };
+        }
+        else {
+            ed.chain().focus("end").insertContent(text).run();
+        }
+        lastPartialLenRef.current = 0;
+    });
+    const handleError = useEffectEvent((error) => {
+        partialRangeRef.current = null;
+        lastPartialLenRef.current = 0;
+        onError?.(error);
+    });
+    const voice = useVoiceInput({
+        workletUrl,
+        onPartial: handlePartial,
+        onFinal: handleFinal,
+        onError: handleError,
+    });
+    const isRecording = voice.status === "recording";
+    // 录音中锁定编辑器
+    useEffect(() => {
+        const ed = editorRef.current;
+        if (!ed)
+            return;
+        ed.setEditable(!isRecording);
+    }, [isRecording, editorRef]);
+    // 回到 idle/error 时清掉 range 游标
+    useEffect(() => {
+        if (voice.status === "idle" || voice.status === "error") {
+            partialRangeRef.current = null;
+            lastPartialLenRef.current = 0;
+        }
+    }, [voice.status]);
+    const toggle = useCallback(() => {
+        if (voice.status === "recording") {
+            void voice.stop();
+        }
+        else {
+            void voice.start();
+        }
+    }, [voice]);
+    return {
+        status: voice.status,
+        isRecording,
+        error: voice.error,
+        level: voice.level,
+        toggle,
+        stop: voice.stop,
+    };
+}
+//# sourceMappingURL=use-tiptap-voice-input.js.map

package/dist/internal/core/asr/use-tiptap-voice-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-tiptap-voice-input.js","sourceRoot":"","sources":["../../src/asr/use-tiptap-voice-input.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AACtE,OAAO,EAAE,aAAa,EAAyB,MAAM,mBAAmB,CAAA;AAsBxE;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAmC;IAEnC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,OAAO,CAAA;IAClD,MAAM,eAAe,GAAG,MAAM,CAAsC,IAAI,CAAC,CAAA;IACzE,yDAAyD;IACzD,gDAAgD;IAChD,sCAAsC;IACtC,MAAM,iBAAiB,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;IAEnC,MAAM,aAAa,GAAG,cAAc,CAAC,CAAC,IAAY,EAAE,EAAE;QACpD,MAAM,EAAE,GAAG,SAAS,CAAC,OAAO,CAAA;QAC5B,IAAI,CAAC,EAAE;YAAE,OAAM;QACf,IAAI,KAAK,GAAG,eAAe,CAAC,OAAO,CAAA;QACnC,IAAI,KAAK,IAAI,IAAI,CAAC,MAAM,GAAG,iBAAiB,CAAC,OAAO,EAAE,CAAC;YACrD,KAAK,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAA;YACxC,eAAe,CAAC,OAAO,GAAG,KAAK,CAAA;QACjC,CAAC;QACD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAA;YACnC,KAAK,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,CAAA;YAC9B,eAAe,CAAC,OAAO,GAAG,KAAK,CAAA;QACjC,CAAC;QACD,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,KAAK,CAAA;QAC1B,IAAI,IAAI,EAAE,CAAC;YACT,EAAE,CAAC,KAAK,EAAE,CAAC,eAAe,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,GAAG,EAAE,CAAA;YACpD,eAAe,CAAC,OAAO,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,CAAA;YAC1D,iBAAiB,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAA;QACzC,CAAC;aAAM,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC;YACrB,EAAE,CAAC,KAAK,EAAE,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAA;YAC1C,eAAe,CAAC,OAAO,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAA;YAC5C,iBAAiB,CAAC,OAAO,GAAG,CAAC,CAAA;QAC/B,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,MAAM,WAAW,GAAG,cAAc,CAAC,CAAC,IAAY,EAAE,EAAE;QAClD,MAAM,EAAE,GAAG,SAAS,CAAC,OAAO,CAAA;QAC5B,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI;YAAE,OAAM;QACxB,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAA;QACrC,IAAI,KAAK,EAAE,CAAC;YACV,EAAE,CAAC,KAAK,EAAE,CAAC,eAAe,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,GAAG,EAAE,CAAA;YAC1E,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,CAAA;YACvC,eAAe,CAAC,OAAO,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAA;QACxD,CAAC;aAAM,CAAC;YACN,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,CAAA;QACnD,CAAC;QACD,iBAAiB,CAAC,OAAO,GAAG,CAAC,CAAA;IAC/B,CAAC,CAAC,CAAA;IAEF,MAAM,WAAW,GAAG,cAAc,CAAC,CAAC,KAAsB,EAAE,EAAE;QAC5D,eAAe,CAAC,OAAO,GAAG,IAAI,CAAA;QAC9B,iBAAiB,CAAC,OAAO,GAAG,CAAC,CAAA;QAC7B,OAAO,EAAE,CAAC,KAAK,CAAC,CAAA;IAClB,CAAC,CAAC,CAAA;IAEF,MAAM,KAAK,GAAG,aAAa,CAAC;QAC1B,UAAU;QACV,SAAS,EAAE,aAAa;QACxB,OAAO,EAAE,WAAW;QACpB,OAAO,EAAE,WAAW;KACrB,CAAC,CAAA;IAEF,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,KAAK,WAAW,CAAA;IAEhD,WAAW;IACX,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,EAAE,GAAG,SAAS,CAAC,OAAO,CAAA;QAC5B,IAAI,CAAC,EAAE;YAAE,OAAM;QACf,EAAE,CAAC,WAAW,CAAC,CAAC,WAAW,CAAC,CAAA;IAC9B,CAAC,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAA;IAE5B,6BAA6B;IAC7B,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;YACxD,eAAe,CAAC,OAAO,GAAG,IAAI,CAAA;YAC9B,iBAAiB,CAAC,OAAO,GAAG,CAAC,CAAA;QAC/B,CAAC;IACH,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;IAElB,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE;QAC9B,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YACjC,KAAK,KAAK,CAAC,IAAI,EAAE,CAAA;QACnB,CAAC;aAAM,CAAC;YACN,KAAK,KAAK,CAAC,KAAK,EAAE,CAAA;QACpB,CAAC;IACH,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;IAEX,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,WAAW;QACX,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,MAAM;QACN,IAAI,EAAE,KAAK,CAAC,IAAI;KACjB,CAAA;AACH,CAAC"}

package/dist/internal/core/asr/use-voice-input.d.ts

@@ -0,0 +1,18 @@
+import { type VoiceInputError } from "./voice-input-support";
+export type VoiceInputStatus = "idle" | "starting" | "recording" | "stopping" | "error";
+export interface UseVoiceInputOptions {
+    workletUrl: string;
+    onPartial?: (text: string) => void;
+    onFinal?: (text: string) => void;
+    onError?: (error: VoiceInputError) => void;
+}
+export interface UseVoiceInputResult {
+    status: VoiceInputStatus;
+    error: string | null;
+    /** 当前音频 RMS 幅度，0..1，仅在 recording 期间有意义，用于驱动波形动画 */
+    level: number;
+    start: () => Promise<void>;
+    stop: () => Promise<void>;
+}
+export declare function useVoiceInput(options: UseVoiceInputOptions): UseVoiceInputResult;
+//# sourceMappingURL=use-voice-input.d.ts.map

package/dist/internal/core/asr/use-voice-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-voice-input.d.ts","sourceRoot":"","sources":["../../src/asr/use-voice-input.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAA;AAE9B,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,CAAA;AAEvF,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAChC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAA;CAC3C;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,gBAAgB,CAAA;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1B,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1B;AA6BD,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,mBAAmB,CAiShF"}

package/dist/internal/core/asr/use-voice-input.js

@@ -0,0 +1,312 @@
+import { useCallback, useEffect, useRef, useState } from "react";
+import { getSocket } from "../api/socket";
+import { buildVoiceInputUnavailableError, } from "./voice-input-support";
+const STARTUP_TIMEOUT_MS = 6000;
+// 批式 provider（如 Qwen）要等整段转写跑完才会发 asr:closed，可能 5–10s；
+// 流式 provider（火山）通常 <1s 就到 closed。给一个够宽的兜底，正常路径由
+// asr:closed 事件即时 resolve，不会真的等够这么久。
+const STOP_TIMEOUT_MS = 30000;
+const FLUSH_ACK_TIMEOUT_MS = 200;
+function matchesRequest(data, requestId) {
+    const rid = data?.request_id;
+    return !rid || rid === requestId;
+}
+export function useVoiceInput(options) {
+    const [status, setStatus] = useState("idle");
+    const [error, setError] = useState(null);
+    const [level, setLevel] = useState(0);
+    const sessionRef = useRef(null);
+    const startingRef = useRef(false);
+    const stoppingRef = useRef(false);
+    const unmountedRef = useRef(false);
+    const optionsRef = useRef(options);
+    optionsRef.current = options;
+    const reportError = useCallback((err) => {
+        const payload = typeof err === "string" ? { title: err } : err;
+        setError(payload.title);
+        setStatus("error");
+        setLevel(0);
+        optionsRef.current.onError?.(payload);
+    }, []);
+    const disposeSession = useCallback((s) => {
+        if (s.disposed)
+            return;
+        s.disposed = true;
+        const socket = getSocket();
+        socket.off("asr:partial", s.handlers.partial);
+        socket.off("asr:final", s.handlers.final);
+        socket.off("asr:error", s.handlers.error);
+        try {
+            s.workletNode.port.onmessage = null;
+            s.workletNode.disconnect();
+        }
+        catch { }
+        try {
+            s.source.disconnect();
+        }
+        catch { }
+        try {
+            for (const t of s.stream.getTracks())
+                t.stop();
+        }
+        catch { }
+        try {
+            void s.ctx.close();
+        }
+        catch { }
+    }, []);
+    const stop = useCallback(async () => {
+        const s = sessionRef.current;
+        if (!s || stoppingRef.current) {
+            setStatus((prev) => (prev === "error" ? "error" : "idle"));
+            return;
+        }
+        stoppingRef.current = true;
+        setStatus("stopping");
+        // 尾部 <100ms 的音频 flush，等 worklet 回 ack 再继续
+        await new Promise((resolve) => {
+            const timer = setTimeout(resolve, FLUSH_ACK_TIMEOUT_MS);
+            s.flushAck = () => {
+                clearTimeout(timer);
+                resolve();
+            };
+            try {
+                s.workletNode.port.postMessage("flush");
+            }
+            catch {
+                clearTimeout(timer);
+                resolve();
+            }
+        });
+        // 等 closed，期间保持 partial/final 监听活着以收尾部识别结果；超时兜底
+        const socket = getSocket();
+        await new Promise((resolve) => {
+            let settled = false;
+            const finish = () => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timer);
+                socket.off("asr:closed", onClosed);
+                resolve();
+            };
+            const onClosed = (data) => {
+                if (matchesRequest(data, s.requestId))
+                    finish();
+            };
+            const timer = setTimeout(finish, STOP_TIMEOUT_MS);
+            socket.on("asr:closed", onClosed);
+            socket.emit("asr:stop", { request_id: s.requestId });
+        });
+        // 等服务端 final/closed 到齐后再 off partial/final/error 并释放资源
+        disposeSession(s);
+        if (sessionRef.current === s) {
+            sessionRef.current = null;
+        }
+        stoppingRef.current = false;
+        setLevel(0);
+        setStatus((prev) => (prev === "error" ? "error" : "idle"));
+    }, [disposeSession]);
+    const start = useCallback(async () => {
+        if (sessionRef.current ||
+            startingRef.current ||
+            stoppingRef.current ||
+            unmountedRef.current) {
+            return;
+        }
+        startingRef.current = true;
+        setError(null);
+        setStatus("starting");
+        if (typeof window === "undefined" || !navigator.mediaDevices?.getUserMedia) {
+            startingRef.current = false;
+            reportError(buildVoiceInputUnavailableError());
+            return;
+        }
+        let stream = null;
+        let ctx = null;
+        let source = null;
+        let workletNode = null;
+        const socket = getSocket();
+        const requestId = typeof crypto !== "undefined" && crypto.randomUUID
+            ? crypto.randomUUID()
+            : `asr-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+        const cleanupPartial = () => {
+            if (workletNode) {
+                try {
+                    workletNode.port.onmessage = null;
+                    workletNode.disconnect();
+                }
+                catch { }
+            }
+            if (source) {
+                try {
+                    source.disconnect();
+                }
+                catch { }
+            }
+            if (stream) {
+                try {
+                    for (const t of stream.getTracks())
+                        t.stop();
+                }
+                catch { }
+            }
+            if (ctx) {
+                try {
+                    void ctx.close();
+                }
+                catch { }
+            }
+        };
+        const checkCancelled = () => {
+            if (unmountedRef.current) {
+                cleanupPartial();
+                // 若已经对后端发过 asr:start，补发 asr:stop 让服务端释放 bridge
+                try {
+                    getSocket().emit("asr:stop", { request_id: requestId });
+                }
+                catch { }
+                return true;
+            }
+            return false;
+        };
+        try {
+            stream = await navigator.mediaDevices.getUserMedia({
+                audio: {
+                    channelCount: 1,
+                    sampleRate: 16000,
+                    echoCancellation: true,
+                    noiseSuppression: true,
+                    autoGainControl: true,
+                },
+            });
+            if (checkCancelled())
+                return;
+            const AudioCtx = window.AudioContext ??
+                window.webkitAudioContext;
+            ctx = new AudioCtx({ sampleRate: 16000 });
+            await ctx.audioWorklet.addModule(optionsRef.current.workletUrl);
+            if (checkCancelled())
+                return;
+            source = ctx.createMediaStreamSource(stream);
+            workletNode = new AudioWorkletNode(ctx, "pcm-processor");
+            // 等后端 ready（带作用域）
+            await new Promise((resolve, reject) => {
+                let settled = false;
+                const finish = (ok, err) => {
+                    if (settled)
+                        return;
+                    settled = true;
+                    clearTimeout(timer);
+                    socket.off("asr:ready", onReady);
+                    socket.off("asr:error", onEarlyError);
+                    if (ok)
+                        resolve();
+                    else
+                        reject(new Error(err ?? "unknown"));
+                };
+                const onReady = (data) => {
+                    if (matchesRequest(data, requestId))
+                        finish(true);
+                };
+                const onEarlyError = (data) => {
+                    if (!matchesRequest(data, requestId))
+                        return;
+                    finish(false, data?.message ?? "后端语音识别启动失败");
+                };
+                const timer = setTimeout(() => finish(false, "语音识别连接超时"), STARTUP_TIMEOUT_MS);
+                socket.on("asr:ready", onReady);
+                socket.on("asr:error", onEarlyError);
+                socket.emit("asr:start", { request_id: requestId });
+            });
+            if (checkCancelled())
+                return;
+            // 订阅运行期事件（按 request_id 过滤）
+            const onPartial = (data) => {
+                if (!matchesRequest(data, requestId))
+                    return;
+                const text = data?.text;
+                if (text)
+                    optionsRef.current.onPartial?.(text);
+            };
+            const onFinal = (data) => {
+                if (!matchesRequest(data, requestId))
+                    return;
+                const text = data?.text;
+                if (text)
+                    optionsRef.current.onFinal?.(text);
+            };
+            const onError = (data) => {
+                if (!matchesRequest(data, requestId))
+                    return;
+                const msg = data?.message ?? "语音识别失败";
+                const cur = sessionRef.current;
+                if (cur && cur.requestId === requestId) {
+                    sessionRef.current = null;
+                    disposeSession(cur);
+                }
+                reportError(msg);
+            };
+            socket.on("asr:partial", onPartial);
+            socket.on("asr:final", onFinal);
+            socket.on("asr:error", onError);
+            const session = {
+                requestId,
+                stream,
+                ctx,
+                source,
+                workletNode,
+                handlers: { partial: onPartial, final: onFinal, error: onError },
+                disposed: false,
+                flushAck: null,
+            };
+            workletNode.port.onmessage = (ev) => {
+                const msg = ev.data;
+                if (!msg || typeof msg !== "object")
+                    return;
+                if (msg.type === "flushed") {
+                    session.flushAck?.();
+                    session.flushAck = null;
+                    return;
+                }
+                if (msg.type !== "audio")
+                    return;
+                if (!(msg.pcm instanceof ArrayBuffer) || msg.pcm.byteLength === 0)
+                    return;
+                // RMS ~ 0..0.3 for typical speech；放大到 0..1 区间给 UI 用
+                setLevel(Math.min(1, msg.level * 4));
+                socket.emit("asr:audio", { pcm: msg.pcm, request_id: requestId });
+            };
+            source.connect(workletNode);
+            sessionRef.current = session;
+            setStatus("recording");
+        }
+        catch (err) {
+            cleanupPartial();
+            const msg = err instanceof Error ? err.message : String(err);
+            reportError(msg);
+        }
+        finally {
+            startingRef.current = false;
+        }
+    }, [reportError, disposeSession]);
+    // 组件卸载时停止录音与正在进行的 start 流程，避免 MediaStream / AudioContext /
+    // socket listener / 后端 bridge 泄漏
+    useEffect(() => {
+        unmountedRef.current = false;
+        return () => {
+            unmountedRef.current = true;
+            const s = sessionRef.current;
+            if (s) {
+                sessionRef.current = null;
+                disposeSession(s);
+                try {
+                    getSocket().emit("asr:stop", { request_id: s.requestId });
+                }
+                catch { }
+            }
+        };
+    }, [disposeSession]);
+    return { status, error, level, start, stop };
+}
+//# sourceMappingURL=use-voice-input.js.map

package/dist/internal/core/asr/use-voice-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-voice-input.js","sourceRoot":"","sources":["../../src/asr/use-voice-input.ts"],"names":[],"mappings":"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"}

package/dist/internal/core/asr/voice-input-support.d.ts

@@ -0,0 +1,6 @@
+export interface VoiceInputError {
+    title: string;
+    description?: string;
+}
+export declare function buildVoiceInputUnavailableError(): VoiceInputError;
+//# sourceMappingURL=voice-input-support.d.ts.map

package/dist/internal/core/asr/voice-input-support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-input-support.d.ts","sourceRoot":"","sources":["../../src/asr/voice-input-support.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAYD,wBAAgB,+BAA+B,IAAI,eAAe,CA0BjE"}

package/dist/internal/core/asr/voice-input-support.js

@@ -0,0 +1,35 @@
+function isIpHost(hostname) {
+    if (!hostname) {
+        return false;
+    }
+    if (/^\d{1,3}(?:\.\d{1,3}){3}$/.test(hostname)) {
+        return true;
+    }
+    return hostname.includes(":");
+}
+export function buildVoiceInputUnavailableError() {
+    if (typeof window === "undefined") {
+        return { title: "当前浏览器不支持麦克风采集" };
+    }
+    const { location } = window;
+    if (!window.isSecureContext && location.protocol === "http:" && isIpHost(location.hostname)) {
+        return {
+            title: "当前浏览器未开放语音输入",
+            description: [
+                `你正在通过内网 IP 访问 ${location.origin}。`,
+                "Chrome / Edge 可按以下方式手工开启：",
+                "1. 打开 chrome://flags/#unsafely-treat-insecure-origin-as-secure",
+                "   Edge 请打开 edge://flags/#unsafely-treat-insecure-origin-as-secure",
+                "2. 启用该 flag，并填入完整 origin（必须带协议和端口）",
+                `   当前可直接填写：${location.origin}`,
+                "3. 重启浏览器",
+                "4. 重新打开页面，并在站点权限里允许麦克风",
+            ].join("\n"),
+        };
+    }
+    return {
+        title: "当前浏览器不支持麦克风采集",
+        description: "请使用最新版 Chrome / Edge，或改用 HTTPS、localhost 访问。",
+    };
+}
+//# sourceMappingURL=voice-input-support.js.map

package/dist/internal/core/asr/voice-input-support.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-input-support.js","sourceRoot":"","sources":["../../src/asr/voice-input-support.ts"],"names":[],"mappings":"AAKA,SAAS,QAAQ,CAAC,QAAgB;IAChC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,KAAK,CAAA;IACd,CAAC;IACD,IAAI,2BAA2B,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/C,OAAO,IAAI,CAAA;IACb,CAAC;IACD,OAAO,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;AAC/B,CAAC;AAED,MAAM,UAAU,+BAA+B;IAC7C,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,CAAA;IACnC,CAAC;IAED,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAA;IAC3B,IAAI,CAAC,MAAM,CAAC,eAAe,IAAI,QAAQ,CAAC,QAAQ,KAAK,OAAO,IAAI,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5F,OAAO;YACL,KAAK,EAAE,cAAc;YACrB,WAAW,EAAE;gBACX,iBAAiB,QAAQ,CAAC,MAAM,GAAG;gBACnC,2BAA2B;gBAC3B,gEAAgE;gBAChE,oEAAoE;gBACpE,oCAAoC;gBACpC,cAAc,QAAQ,CAAC,MAAM,EAAE;gBAC/B,UAAU;gBACV,wBAAwB;aACzB,CAAC,IAAI,CAAC,IAAI,CAAC;SACb,CAAA;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,8CAA8C;KAC5D,CAAA;AACH,CAAC"}

package/dist/internal/core/components/ai-elements/file-tree.d.ts

@@ -0,0 +1,27 @@
+import type { HTMLAttributes, ReactNode } from "react";
+export type FileTreeProps = Omit<HTMLAttributes<HTMLDivElement>, "onSelect"> & {
+    expanded?: Set<string>;
+    defaultExpanded?: Set<string>;
+    selectedPath?: string;
+    onSelect?: (path: string) => void;
+    onExpandedChange?: (expanded: Set<string>) => void;
+};
+export declare const FileTree: ({ expanded: controlledExpanded, defaultExpanded, selectedPath, onSelect, onExpandedChange, className, children, ...props }: FileTreeProps) => import("react/jsx-runtime").JSX.Element;
+export type FileTreeIconProps = HTMLAttributes<HTMLSpanElement>;
+export declare const FileTreeIcon: ({ className, children, ...props }: FileTreeIconProps) => import("react/jsx-runtime").JSX.Element;
+export type FileTreeNameProps = HTMLAttributes<HTMLSpanElement>;
+export declare const FileTreeName: ({ className, children, ...props }: FileTreeNameProps) => import("react/jsx-runtime").JSX.Element;
+export type FileTreeFolderProps = HTMLAttributes<HTMLDivElement> & {
+    path: string;
+    name: string;
+};
+export declare const FileTreeFolder: ({ path, name, className, children, ...props }: FileTreeFolderProps) => import("react/jsx-runtime").JSX.Element;
+export type FileTreeFileProps = HTMLAttributes<HTMLButtonElement> & {
+    path: string;
+    name: string;
+    icon?: ReactNode;
+};
+export declare const FileTreeFile: ({ path, name, icon, className, children, ...props }: FileTreeFileProps) => import("react/jsx-runtime").JSX.Element;
+export type FileTreeActionsProps = HTMLAttributes<HTMLDivElement>;
+export declare const FileTreeActions: ({ className, children, ...props }: FileTreeActionsProps) => import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=file-tree.d.ts.map

package/dist/internal/core/components/ai-elements/file-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-tree.d.ts","sourceRoot":"","sources":["../../../src/components/ai-elements/file-tree.tsx"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AA0BvD,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC,GAAG;IAC7E,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;CACpD,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,4HAStB,aAAa,4CAqCf,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC,eAAe,CAAC,CAAC;AAEhE,eAAO,MAAM,YAAY,GAAI,mCAI1B,iBAAiB,4CAInB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC,eAAe,CAAC,CAAC;AAEhE,eAAO,MAAM,YAAY,GAAI,mCAI1B,iBAAiB,4CAInB,CAAC;AAcF,MAAM,MAAM,mBAAmB,GAAG,cAAc,CAAC,cAAc,CAAC,GAAG;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,+CAM5B,mBAAmB,4CAoErB,CAAC;AAYF,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC,iBAAiB,CAAC,GAAG;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,qDAO1B,iBAAiB,4CA6CnB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;AAIlE,eAAO,MAAM,eAAe,GAAI,mCAI7B,oBAAoB,4CAStB,CAAC"}