@easyv/biz-components 1.0.28 → 1.0.30

package/dist/lib/easyv-biz-components/src/hooks/use-div-auto-scroll.d.ts

@@ -0,0 +1,17 @@
+import { default as React } from 'react';
+
+interface ScrollControllerProps {
+    scrollBuffer?: number;
+    scrollBehavior?: 'auto' | 'smooth';
+    containerRef: React.RefObject<HTMLDivElement | null>;
+}
+/**
+ * 自动滚动 hook，用法是你传入一个容器的 ref，当你调用返回函数时，那么容器内的内容变化时，会自动滚动到最底部。
+ * @param params 传入一个对象，包含以下属性：
+ * scrollBuffer：滚动缓冲距离，默认为 50px。
+ * scrollBehavior：滚动行为，默认为 'smooth'。
+ * containerRef：容器的 React ref 引用对象。
+ * @returns 一个触发自动滚动的函数
+ */
+export declare function useDivAutoScroll(params: ScrollControllerProps): () => void;
+export {};

package/dist/lib/easyv-biz-components/src/hooks/use-document-unmount/index.d.ts

@@ -0,0 +1 @@
+export * from './use-document-unmount';

package/dist/lib/easyv-biz-components/src/hooks/use-document-unmount/use-document-unmount.d.ts

@@ -0,0 +1 @@
+export declare function useDocumentUnmount(fn: () => void): void;

package/dist/lib/easyv-biz-components/src/hooks/use-initialized.d.ts

@@ -0,0 +1,7 @@
+type InitFunctionType = (() => Promise<void>) | (() => void);
+/** 传入的函数只会初始化运行一次
+ * @param fn 初始化函数， fn 返回的如果是一个函数，会在卸载时运行。
+ * @returns initialized 是否初始化，boolean 值是一个 react state，会触发重新渲染
+ */
+export declare function useInitialized(fn?: InitFunctionType): boolean;
+export {};

package/dist/lib/easyv-biz-components/src/hooks/use-socket-events/constant.d.ts

@@ -0,0 +1,52 @@
+export declare const ROOM_PREFIX = "easyvMpsRoom";
+export declare enum RoomType {
+    SPACE = "space",
+    TEAM = "team",
+    USER = "user",
+    PORTAL = "portal",
+    SCREEN = "screen",
+    MOBILE = "mobile",
+    AI_AGENT = "ai_agent",
+    AI_AGENT_COMPONENT = "ai_agent_component"
+}
+export declare enum SocketEventType {
+    CONNECT_TIMEOUT = "connect-timeout",
+    CONNECT = "connect",
+    CONNECT_ERROR = "connect-error",
+    RECONNECT = "reconnect",
+    /** 后端错误 */
+    EXCLUSIVE = "exception",
+    GET_ROOMS = "get-rooms",// 主动获取房间列表
+    GET_ROOM_USERS = "get-room-users",// 主动获取用户列表
+    ROOM_JOIN = "join-room",// 加入房间
+    ROOM_LEAVE = "leave-room",// 离开房间
+    EXCLUSIVE_MESSAGE_GET_ROOMS = "exclusive-message-get-rooms",// 监听房间信息
+    EXCLUSIVE_MESSAGE_GET_ROOM_USERS = "exclusive-message-get-room-users",// 获取房间成员
+    EXCLUSIVE_MESSAGE_JOIN_ROOM = "exclusive-message-join-room",
+    COLLAB_ADD = "broadcast-collab-add",// 协作消息-添加
+    COLLAB_DELETE = "broadcast-collab-delete",// 协作消息-删除
+    COLLAB_UPDATE = "broadcast-collab-update",// 协作消息-更新
+    MESSAGE_ROOM_JOIN = "broadcast-join-room",// 新成员加入房间
+    MESSAGE_ROOM_LEAVE = "broadcast-leave-room",// 成员离开房间
+    /** ai 智能体消息 */
+    AI_AGENT_MESSAGE = "broadcast-ai-agent-message"
+}
+export declare const MessageType: typeof SocketEventType;
+export declare const RoomTypeIdMap: {
+    space: (spaceId: number) => string;
+    team: (teamId: number) => string;
+    user: (userId: number) => string;
+    portal: (portalId: number) => string;
+    screen: (screenId: number) => string;
+    mobile: (mobileId: number) => string;
+};
+export declare const MAX_TIMEOUT = 5000;
+export declare const messageWindowByType: Record<string, string[]>;
+export declare const EXPLICIT_DISCONNECT_REASON: Set<number>;
+export declare const socketNormalMessageList: SocketEventType[];
+export declare const socketBroadcastMessageList: SocketEventType[];
+/** 消息推送的错误码 */
+export declare enum MpsErrorCode {
+    GUEST_TOKEN_ERROR = 1000,
+    UNAUTH = 1001
+}

package/dist/lib/easyv-biz-components/src/hooks/use-socket-events/index.d.ts

@@ -0,0 +1,3 @@
+export * from './use-socket-events';
+export * from './constant';
+export * from './types';

package/dist/lib/easyv-biz-components/src/hooks/use-socket-events/types.d.ts

@@ -0,0 +1,47 @@
+import { MpsErrorCode, SocketEventType } from './constant';
+
+export interface BroadcastData {
+    data: BroadcastingEventsDataType | ErrorDataType;
+    eventType: SocketEventType;
+}
+export interface SocketEventData {
+    data?: ExclusiveEventsDataType;
+    eventType: SocketEventType;
+}
+export interface SocketOnErrorData {
+    type: 'connectError';
+    errorMsg: string;
+}
+export interface BroadcastDataType {
+    id: string;
+    origin: string;
+    roomId: string;
+    payload: string;
+}
+export interface AynergyData {
+    type?: SocketEventType;
+    data?: unknown;
+}
+export interface ExclusiveEventsDataType {
+    success: boolean;
+    data: unknown;
+}
+export interface BroadcastingEventsDataType {
+    /** 消息 id， 断开重联后，可以通过这个id来获取miss的消息 */
+    id: string;
+    origin: 'server' | 'client';
+    /** JSON.parse 后得到结构化数据 */
+    payload: string;
+    /** 房间 id，从会话id 派生出来 */
+    roomId: string;
+}
+export interface ErrorDataType {
+    status: string;
+    message: string;
+    errorCode: MpsErrorCode;
+}
+export interface AuthConfig {
+    'custom-socket-id': string;
+    'space-id': string;
+    'room-offset-map': Record<string, string>;
+}

package/dist/lib/easyv-biz-components/src/hooks/use-socket-events/use-socket-events.d.ts

@@ -0,0 +1,21 @@
+import { Manager, Socket } from 'socket.io-client';
+import { BroadcastData, SocketEventData, SocketOnErrorData } from './types';
+
+interface UseSocketDataCommonProps {
+    basename: string;
+    SocketManager: typeof Manager;
+    host?: string;
+    onBroadcast?: (dataAndType: BroadcastData) => void;
+    onSocketEvent?: (dataAndType: SocketEventData) => void;
+    onError?: (data: SocketOnErrorData) => void;
+}
+interface UserIdProps {
+    spaceId: number;
+    userId?: number;
+}
+interface GuestSocketIdProps {
+    guestToken: string;
+}
+type UseSocketDataProps = UseSocketDataCommonProps & (UserIdProps | GuestSocketIdProps);
+export declare function useSocketEvents(props: UseSocketDataProps): Socket | null;
+export {};

package/dist/lib/easyv-biz-components/src/hooks/use-watch-value/playground.cy.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/easyv-biz-components/src/hooks/use-watch-value/use-watch-value.cy.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/easyv-biz-components/src/hooks/use-watch-value/use-watch-value.d.ts

@@ -0,0 +1,43 @@
+type WatchableValue = string | number | boolean | object | Array<unknown> | null | undefined;
+interface UseWatchValueOptions<T> {
+    /** 自定义比较函数，默认使用 lodash isEqual */
+    equalFn?: (value1: T, value2: T) => boolean;
+    /** 是否立即执行回调，默认为 true */
+    immediate?: boolean;
+}
+interface UseWatchValueParams<T> {
+    /** 要监听的值 */
+    value: T;
+    /** 值变化时的回调函数 */
+    callback: (newValue: T, oldValue?: T) => void | Promise<void>;
+    /** 配置选项 */
+    options?: UseWatchValueOptions<T>;
+}
+/**
+ * 监听值变化的 React Hook
+ *
+ * @description 当监听的值发生变化时，会调用提供的回调函数, 监听的值不要太大，否则会有性能问题。
+ * @param params 配置参数
+ * @param params.value 要监听的值
+ * @param params.callback 值变化时的回调函数
+ * @param params.options 配置选项
+ * @param params.options.equalFn 自定义比较函数，默认使用 lodash isEqual
+ * @param params.options.immediate 是否立即执行回调，默认为 true
+ *
+ * @example
+ * ```tsx
+ * const [count, setCount] = useState(0);
+ *
+ * useWatchValue({
+ *   value: count,
+ *   callback: (newValue, oldValue) => {
+ *     console.log(`Count changed from ${oldValue} to ${newValue}`);
+ *   },
+ *   options: {
+ *     immediate: false // 不立即执行
+ *   }
+ * });
+ * ```
+ */
+export declare function useWatchValue<T extends WatchableValue>(params: UseWatchValueParams<T>): void;
+export {};

package/dist/lib/easyv-biz-components/src/index.d.ts

@@ -0,0 +1,4 @@
+export * from './components';
+export * from './hooks';
+export * from './utils';
+export * from './ant-components';

package/dist/lib/easyv-biz-components/src/utils/ai-agent-message-manager/ai-agent-message-manager.d.ts

@@ -0,0 +1,28 @@
+import { Socket } from 'socket.io-client';
+import { AgentSocketEmitEvent } from './constants';
+import { AgentSocketEmitEventPayloadMap, AiAgentMessageManagerConfig, JoinOrLeaveRoomParams, SendMsgToAiAgentComponentParams, SendMsgToAiAgentParams } from './types';
+
+export declare class AiAgentMessageManager {
+    /** 向 ai 问问题的 ws */
+    wsForAsk: Socket | null;
+    /** 和 ai 进行消息互动的 ws，主要两个功能：接收 ai 消息，前端广播消息 */
+    wsForMsg: Socket | null;
+    private config;
+    status: 'beforeInit' | 'initialized' | 'initializing';
+    currChatInfo: {
+        taskId?: string;
+        question?: string;
+    };
+    constructor(config: AiAgentMessageManagerConfig);
+    setConfig(config: Partial<AiAgentMessageManagerConfig>): void;
+    init(): Promise<void>;
+    sendMsgToAiAgent(params: SendMsgToAiAgentParams | SendMsgToAiAgentComponentParams): void;
+    sendToolResultToAiAgent(result: string): void;
+    private handleAskWsInfo;
+    private handleMsgWsInfo;
+    joinRoom(params: JoinOrLeaveRoomParams): Promise<void>;
+    leaveRoom(params: JoinOrLeaveRoomParams): void;
+    stopOneChat(): void;
+    broadcastMessage(params: AgentSocketEmitEventPayloadMap[AgentSocketEmitEvent.USER_BROADCAST]): void;
+    closeWs(): void;
+}

package/dist/lib/easyv-biz-components/src/utils/ai-agent-message-manager/constants.d.ts

@@ -0,0 +1,56 @@
+export declare enum AiAgentMessageType {
+    CONVERSION_START = "conversation_start",
+    CONVERSION_END = "conversation_end",
+    DASHBOARD = "dashboard",// 消息为组件渲染相关内容, content 为 DashboardContext
+    TEXT = "text",// 常规文字消息， content 为纯文本
+    QUESTION = "question",// 问题， content 为纯文本
+    TITLE = "title",// 标题， content 为纯文本
+    ERROR = "error",
+    /** 数字人信息 */
+    DIGITAL_MAN_STATUS = "digital_man_status",
+    /** 智能体执行步骤，包括工具执行、模型调用、数据处理等，纯文本 */
+    EXECUTION_STEP = "execution_step",
+    /** 任务id，用于关联智能体执行过程中的消息 */
+    TASK_ID = "task_id"
+}
+export declare enum AgentDataSource {
+    KNOWLEDGE = "knowledge",
+    WEB = "web",
+    DATASET = "dataset"
+}
+/** 智能体 ws 中发送的事件 */
+export declare enum AgentSocketEmitEvent {
+    AI_AGENT_CHAT = "ai-agent-chat",// 智能体发送对话
+    AI_AGENT_COMPONENT_CHAT = "ai-agent-component-chat",
+    AI_AGENT_REVOKE = "ai-agent-revoke",// 撤销某个对话，智能体和组件都用这个接口
+    AI_AGENT_TOOL_RESULT = "ai-agent-tool-result",// 前端调用某个工具后发送结果
+    ROOM_JOIN = "join-room",// 加入房间
+    ROOM_LEAVE = "leave-room",// 离开房间
+    /** 前端主动发送的广播消息 */
+    USER_BROADCAST = "user-broadcast"
+}
+/** 智能体 ws 中监听的事件, 实际上这个 ws 连接可以使用 SocketEventType 上的所有事件。
+ * - 应该继承于 SocketEventType ，但是枚举无法继承 */
+export declare enum AgentSocketListenEvent {
+    CONNECT_TIMEOUT = "connect-timeout",
+    CONNECT = "connect",
+    CONNECT_ERROR = "connect-error",
+    RECONNECT = "reconnect",
+    /** 后端错误 */
+    EXCEPTION = "exception",
+    EXCLUSIVE_MESSAGE_JOIN_ROOM = "exclusive-message-join-room",
+    EXCLUSIVE_MESSAGE_AI_AGENT_CHAT = "exclusive-message-ai-agent-chat",
+    EXCLUSIVE_MESSAGE_AI_AGENT_COMPONENT_CHAT = "exclusive-message-ai-agent-component-chat",
+    /** ai 智能体消息 */
+    AI_AGENT_MESSAGE = "broadcast-ai-agent-message",
+    /** 前端主动发送的广播消息 */
+    USER_BROADCAST = "broadcast-user-broadcast",
+    /** 后端通知前端调用某个工具的事件 */
+    AI_AGENT_TOOL_CALL = "ai-agent-tool-call"
+}
+export declare enum AiAgentRoomType {
+    AI_AGENT = "ai_agent",
+    AI_AGENT_COMPONENT = "ai_agent_component"
+}
+export declare const AskWsListenEventList: readonly [AgentSocketListenEvent.EXCLUSIVE_MESSAGE_AI_AGENT_CHAT, AgentSocketListenEvent.EXCLUSIVE_MESSAGE_AI_AGENT_COMPONENT_CHAT, AgentSocketListenEvent.AI_AGENT_TOOL_CALL, AgentSocketListenEvent.EXCEPTION];
+export declare const MsgWsListenEventList: AgentSocketListenEvent[];

package/dist/lib/easyv-biz-components/src/utils/ai-agent-message-manager/index.d.ts

@@ -0,0 +1,3 @@
+export * from './ai-agent-message-manager';
+export * from './types';
+export * from './constants';

package/dist/lib/easyv-biz-components/src/utils/ai-agent-message-manager/types.d.ts

@@ -0,0 +1,132 @@
+import { Manager } from 'socket.io-client';
+import { AiMessageContentItem, EasyvPlot, EchartsPlot } from '../../components/ai-message-render';
+import { RoomType } from '../../hooks';
+import { AgentDataSource, AgentSocketEmitEvent, AiAgentMessageType } from './constants';
+
+export interface AiChatHistory {
+    question: string;
+    response: (Pick<AiMessageContentItem, 'plotContext' | 'echartsContext'> & {
+        content?: string | undefined;
+    })[];
+}
+export interface ToolCallInfo {
+    /** 此次任务的 唯一 id */
+    id: string;
+    /** 此次需要调用的工具名称 */
+    toolName: string;
+    /** 工具调用相关信息，不同工具有差异 */
+    toolInfo: Record<string, unknown>;
+}
+export interface AiAgentExclusiveEventsDataType {
+    success: boolean;
+    data?: unknown;
+}
+export interface AiAgentSocketData {
+    /** 消息 id， 断开重联后，可以通过这个id来获取miss的消息 */
+    id: string;
+    origin: 'server' | 'client';
+    /** JSON.parse 后得到结构化数据 */
+    payload: string;
+    /** 房间 id，从会话id 派生出来 */
+    roomId: string;
+}
+export interface AiAgentSocketMessagePayload {
+    type: AiAgentMessageType;
+    content?: string;
+    /** easyv 图表数据 */
+    plotContext?: EasyvPlot;
+    /** eCharts 图表数据 */
+    echartsContext?: EchartsPlot;
+    /** task_id 的消息类型时才有 */
+    id?: string;
+    /** 图表占位符 */
+    dashboardPlaceholder?: number;
+}
+export type AiAgentAuthConfig = {
+    spaceId: number;
+    userId: number;
+} | {
+    guestToken: string;
+};
+export type SocketIoManager = typeof Manager;
+export interface AgentError {
+    type: 'connectError' | 'messageError' | 'joinRoomError' | 'configError' | 'socketError' | 'sendMsgError';
+    errorMsg: any;
+    errorCode?: number;
+}
+export type UserBroadcastData = {
+    id: string;
+    roomId: string;
+    origin: string;
+    payload: string;
+};
+/** 这个 config 里的函数因为只在初始化调用，所以函数内部拿到的 state 是初始化时的 state，需要用 ref 透传才能拿到最新的 */
+export interface AiAgentMessageManagerConfig {
+    SocketIoManager: SocketIoManager;
+    host?: string;
+    /** 传入用 useMemoizedFn 包裹的函数 */
+    getAuthInfo: () => Promise<AiAgentAuthConfig>;
+    /** 传入用 useMemoizedFn 包裹的函数 */
+    onAiAgentMessage?: (data: AiAgentSocketMessagePayload) => void;
+    /** 传入用 useMemoizedFn 包裹的函数。 前端主动发送的广播消息 */
+    onUserBroadcast?: (data: UserBroadcastData) => void;
+    /** 传入用 useMemoizedFn 包裹的函数。 后端通知前端调用某个工具的事件 */
+    onAiAgentToolCall?: (data: ToolCallInfo) => void;
+    /** 传入用 useMemoizedFn 包裹的函数 */
+    onError?: (error: AgentError) => void;
+    /** @param id 单次会话，后端返回的 id，stop 时立刻调用，真正的会话停止时 conversion_end 消息 */
+    /** 传入用 useMemoizedFn 包裹的函数 */
+    onStopChat?: (id?: string) => void;
+    /** 传入用 useMemoizedFn 包裹的函数 */
+    onSendMsgToAi?: (data: SendMsgToAiAgentParams | SendMsgToAiAgentComponentParams) => void;
+    /** 传入用 useMemoizedFn 包裹的函数 */
+    onJoinRoom?: (data: JoinOrLeaveRoomParams) => void;
+}
+export interface SendMsgToAiAgentParams {
+    type: RoomType.AI_AGENT;
+    agentId: number;
+    question: string;
+    agentDataSource: AgentDataSource[];
+    sessionId: string;
+}
+export interface SendMsgToAiAgentComponentParams {
+    type: RoomType.AI_AGENT_COMPONENT;
+    agentComponentId: number;
+    question: string;
+    history: AiChatHistory[];
+    /** 智能体组件的整个会话的 id，第一次聊天时前端生成
+     * - 独立模式需要，共享模式不需要
+     */
+    sessionId?: string;
+}
+export interface JoinOrLeaveRoomParams {
+    roomType: RoomType;
+    /** 智能体 id 或 智能体组件 id */
+    id: number;
+    /** 如果是独立对话，那么需要 subIds，共享会话不需要，共享会话会根据id去发 */
+    subIds?: string[];
+}
+export interface SocketErrorData {
+    status: string;
+    message: string;
+    errorCode: AiAgentMpsErrorCode;
+}
+/** 消息推送的错误码 */
+export declare enum AiAgentMpsErrorCode {
+    GUEST_TOKEN_ERROR = 1000,
+    UNAUTH = 1001
+}
+export interface AgentSocketEmitEventPayloadMap {
+    [AgentSocketEmitEvent.USER_BROADCAST]: JoinOrLeaveRoomParams & {
+        data: string;
+    };
+    [AgentSocketEmitEvent.AI_AGENT_REVOKE]: {
+        /** 开始对话返回的任务id */
+        id: string;
+    };
+    [AgentSocketEmitEvent.AI_AGENT_TOOL_RESULT]: {
+        /** 开始对话返回的任务id */
+        id: string;
+        result: string;
+    };
+}

package/dist/lib/easyv-biz-components/src/utils/ai-agent-message-manager/utils.d.ts

@@ -0,0 +1 @@
+export declare const getCookieString: () => string;

package/dist/lib/easyv-biz-components/src/utils/common/common.d.ts

@@ -0,0 +1,2 @@
+export declare const generateRandomId: () => string;
+export declare const isDevLocal: () => boolean;

package/dist/lib/easyv-biz-components/src/utils/common/index.d.ts

@@ -0,0 +1,2 @@
+export * from './common';
+export * from './url';

package/dist/lib/easyv-biz-components/src/utils/common/url.d.ts

@@ -0,0 +1,2 @@
+export declare function setUrlQueryString(key: string, value: string | boolean | number): void;
+export declare function getUrlQueryString(key: string): string | null;

package/dist/lib/easyv-biz-components/src/utils/fetchKnowledge/fetchKnowledge.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 用于智能体中前端请求知识库
+ * @author taosu
+ */
+export declare function fetchKnowledge(input: string, knowledge: {
+    baseURL: string;
+    requestHeader?: string | null;
+    requestBody?: string | null;
+    requestHandler: string;
+}): Promise<string>;

package/dist/lib/easyv-biz-components/src/utils/fetchKnowledge/index.d.ts

@@ -0,0 +1 @@
+export * from './fetchKnowledge';

package/dist/lib/easyv-biz-components/src/utils/fun-ASR/fun-ASR-manager.d.ts

@@ -0,0 +1,116 @@
+export interface WebSocketConnectMethodInstance {
+    wsSend: (msg: string | Int16Array<ArrayBuffer>) => void;
+    wsStop: () => void;
+    /** 1 is ok, 0 is error */
+    wsStart: () => 0 | 1;
+    getSocket: () => WebSocket | undefined;
+}
+export interface JsonMsg {
+    data: string;
+}
+export interface WebSocketConnectMethodConfig {
+    msgHandle: (jsonMsg: JsonMsg) => void;
+    /**
+     * 0: 成功
+     * 1: 关闭
+     * 2: 连接失败
+     */
+    stateHandle: (state: number) => void;
+    uri: string;
+    /**
+     * 逆文本标准化， 默认 true
+     * 标准化文本恢复成符合自然语言表达习惯的形式。
+     * 如：  “一百二十三元五角” 这样的表述，经过 ITN 处理后，会变成 “123.5 元”
+     */
+    itn?: boolean;
+    /**
+     * 默认 2pass
+     * 2pass 模式：该模式也叫两步解码模式，通常包含两个步骤。第一步进行快速的初步解码，利用较为简单的语言模型和声学模型快速生成一个大致的识别结果；第二步基于第一步的结果，使用更复杂、更精确的语言模型进行重新解码和优化，从而得到最终更准确的识别结果。
+     * online 模式：采用流式处理方式，在语音数据输入的过程中，系统会逐块对语音进行实时识别。只要有新的语音数据块到达，就立即对其进行处理并输出部分识别结果，而无需等待整个语音输入结束。
+     * offline 模式：需要等待完整的语音数据全部输入后，才开始进行识别处理。在处理过程中，系统会对整个语音数据进行全面的分析和处理，以得出最终的识别结果。
+     */
+    mode?: '2pass' | 'online' | 'offline';
+    /** 是否是文件上传模式，当前模式暂不支持 */
+    isFileMode?: boolean;
+    /** 热词设置，key 是热词，value 是权重 */
+    hotWords?: Record<string, number>;
+}
+export interface RecorderConfig {
+    /**
+     * 输出类型：mp3,wav，wav输出文件尺寸超大不推荐使用，但mp3编码支持会导致js文件超大，如果不需支持mp3可以使js文件大幅减小
+     * pcm 文件无法直接播放，转成wav文件来播放，已提供转换函数 Recorder.pcm2wav
+     */
+    type?: 'mp3' | 'wav' | 'pcm';
+    /**
+     * 比特率 wav:16或8位，MP3：8kbps 1k/s，8kbps 2k/s 录音文件很小
+     */
+    bitRate?: number;
+    /**
+     * 采样率，wav格式大小=sampleRate*时间；mp3此项对低比特率有影响，高比特率几乎无影响。
+     * wav任意值，mp3取值范围：48000, 44100, 32000, 24000, 22050, 16000, 12000, 11025, 8000
+     * 采样率参考https://www.cnblogs.com/devin87/p/mp3-recorder.html
+     */
+    sampleRate?: number;
+    /**
+     * 有默认值，可以不传 \n
+     * fn(buffers,powerLevel,bufferDuration,bufferSampleRate,newBufferIdx,asyncEnd)
+     * buffers=[[Int16,...],...]：缓冲的PCM数据，为从开始录音到现在的所有pcm片段；
+     * powerLevel：当前缓冲的音量级别0-100，
+     * bufferDuration：已缓冲时长，
+     * bufferSampleRate：缓冲使用的采样率（当type支持边录边转码(Worker)时，此采样率和设置的采样率相同，否则不一定相同）；
+     * newBufferIdx:本次回调新增的buffer起始索引；
+     * asyncEnd:fn() 如果onProcess是异步的(返回值为true时)，处理完成时需要调用此回调，如果不是异步的请忽略此参数，此方法回调时必须是真异步（不能真异步时需用setTimeout包裹）。
+     * onProcess返回值：如果返回true代表开启异步模式，在某些大量运算的场合异步是必须的，必须在异步处理完成时调用asyncEnd(不能真异步时需用setTimeout包裹)，
+     * 在onProcess执行后新增的buffer会全部替换成空数组，因此本回调开头应立即将newBufferIdx到本次回调结尾位置的buffer全部保存到另外一个数组内，
+     * 处理完成后写回buffers中本次回调的结尾位置。
+     */
+    onProcess?: (...arg: any[]) => void;
+}
+export interface ErrorInfo {
+    type: 'webSocketError' | 'startRecord';
+    msg: string;
+    isUserNotAllowed?: boolean;
+}
+export interface RecorderResult {
+    open: (fn: () => void, errFn?: (errMsg: string, isUserNotAllowed?: boolean) => void) => void;
+    close: (fn?: () => void) => void;
+    stop: (fn?: (blob: Blob, duration?: number) => void, errFn?: (errMsg: string) => void) => void;
+    start: () => void;
+    pcm2wav: (...params: any) => void;
+    /** 0未录音 1录音中 2暂停 3等待ctx激活 */
+    state: 0 | 1 | 2;
+    SampleData: (array: Array<any>, sampleRate: number, targetSampleRate: number) => {
+        data: Int16Array<ArrayBuffer>;
+    };
+}
+export declare const getWebSocketConnectForFunASR: (config: WebSocketConnectMethodConfig & {
+    onError: (errMsg: string) => void;
+}) => WebSocketConnectMethodInstance;
+interface RecorderFn {
+    (config: RecorderConfig): RecorderResult;
+    Destroy: () => void;
+}
+export declare class FunASRManager {
+    wsInstance: WebSocketConnectMethodInstance | null;
+    recorderInstance: RecorderResult | null;
+    sampleBuf: Int16Array<ArrayBuffer>;
+    isRec: boolean;
+    Recorder: RecorderFn;
+    status: 'live' | 'stop';
+    timer: number;
+    propsOnError: undefined | ((errorInfo: ErrorInfo) => void);
+    socketConfig: WebSocketConnectMethodConfig;
+    recorderConfig: RecorderConfig;
+    constructor(params: {
+        socketConfig: WebSocketConnectMethodConfig;
+        recorderConfig?: RecorderConfig;
+        onError?: (errorInfo: ErrorInfo) => void;
+    });
+    init(): void;
+    destroy(): void;
+    onError(errorObj: ErrorInfo): void;
+    startRecord(): void;
+    stopRecord(): void;
+    private recordProcess;
+}
+export {};

package/dist/lib/easyv-biz-components/src/utils/fun-ASR/index.d.ts

@@ -0,0 +1 @@
+export * from './fun-ASR-manager';

package/dist/lib/easyv-biz-components/src/utils/index.d.ts

@@ -0,0 +1,7 @@
+export * from './fun-ASR';
+export * from './xun-fei-voice';
+export * from './vosk-browser-manager';
+export * from './wait-something';
+export * from './ai-agent-message-manager';
+export * from './common';
+export * from './fetchKnowledge';

package/dist/lib/easyv-biz-components/src/utils/vosk-browser-manager/audio-manager/audio-manager.d.ts

@@ -0,0 +1,31 @@
+import { SampleRate } from './types';
+
+export declare const defaultSampleRate = 48000;
+export interface AudiManagerConfig {
+    /** 一个转换成 string  js 文件。其内容要符合 AudioWorkletProcessor 的要求。
+     * - 需使用 registerProcessor 注册，第一个参数为 “audio-worklet-processor”，如： registerProcessor('audio-worklet-processor', audioToFloat32Processor);
+     * - 参考：https://developer.mozilla.org/en-US/docs/Web/API/AudioWorkletProcessor
+     */
+    workletProcessor?: string;
+    /** 采样率（每秒采样数）的浮点数，常用值：16000, 32000, 44100, 48000 */
+    sampleRate?: SampleRate;
+    onFrameRecorded?: (data: Float32Array) => void;
+    onStart?: () => void;
+    onStop?: () => void;
+    frameSize?: number;
+}
+/** 对实时音频录制进行管理。 */
+export declare class AudioManager {
+    workletUrl?: string;
+    sampleRate?: SampleRate;
+    audioContext?: AudioContext;
+    mediaSource?: MediaStreamAudioSourceNode;
+    mediaStream?: MediaStream;
+    config: AudiManagerConfig;
+    constructor(config: AudiManagerConfig);
+    init(): Promise<void>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    close(): Promise<void> | undefined;
+    destroy(): Promise<void>;
+}

package/dist/lib/easyv-biz-components/src/utils/vosk-browser-manager/audio-manager/test/audio-manager.cy.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/easyv-biz-components/src/utils/vosk-browser-manager/audio-manager/types.d.ts

@@ -0,0 +1,2 @@
+/** 采样率（每秒采样数）的浮点数，常用值：16000, 32000, 44100, 48000 */
+export type SampleRate = 16000 | 32000 | 44100 | 48000;

package/dist/lib/easyv-biz-components/src/utils/vosk-browser-manager/index.d.ts

@@ -0,0 +1,2 @@
+export * from './audio-manager/audio-manager';
+export * from './vosk-browser-manager';

package/dist/lib/easyv-biz-components/src/utils/vosk-browser-manager/test/voskBrowserManager.cy.d.ts

@@ -0,0 +1 @@
+export {};