@fv-ui/ai-chat 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,1912 @@
+import * as vue from 'vue';
+import { Component, Ref, ComputedRef } from 'vue';
+import { ElAvatar, ElPopover } from 'element-plus';
+
+/**
+ * markdown-it 插件形态(与 markdown-it 的 PluginWithParams 对齐)。
+ * 首参使用宽松类型:避免产物 d.ts 对 'markdown-it' 裸类型 import,
+ * 否则未安装 @types/markdown-it 的消费方会得到 TS7016 隐式 any 报错。
+ */
+type MdPlugin = (md: any, ...params: unknown[]) => void;
+interface CreateMarkdownOptions {
+    /** 代码高亮函数,未提供时 markdown-it 使用默认转义输出 */
+    highlight?: (str: string, lang: string) => string;
+    /** 额外的 markdown-it 插件 */
+    mdPlugins?: MdPlugin[];
+}
+
+type __VLS_Props$h = {
+    content: string;
+    mdPlugins?: CreateMarkdownOptions['mdPlugins'];
+    highlight?: (str: string, lang: string) => string;
+    /** 打字机模式下由父组件控制渲染策略,本组件保留透传占位 */
+    isTyping?: boolean;
+};
+declare const __VLS_export$h: vue.DefineComponent<__VLS_Props$h, {
+    getHtml: () => string;
+}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {}, string, vue.PublicProps, Readonly<__VLS_Props$h> & Readonly<{}>, {}, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
+declare const _default$h: typeof __VLS_export$h;
+
+type __VLS_Props$g = {
+    content: string;
+    isMarkdown?: boolean;
+    isFog?: boolean | {
+        bgColor?: string;
+        width?: string;
+    };
+    typing?: boolean | {
+        step?: number;
+        interval?: number;
+        suffix?: string;
+    };
+};
+declare function interrupt$1(): void;
+declare function continueTy$1(): void;
+declare function restart$1(): void;
+declare function destroy$1(): void;
+declare const __VLS_export$g: vue.DefineComponent<__VLS_Props$g, {
+    interrupt: typeof interrupt$1;
+    continue: typeof continueTy$1;
+    restart: typeof restart$1;
+    destroy: typeof destroy$1;
+    renderedContent: vue.Ref<string, string>;
+    isTyping: vue.Ref<boolean, boolean>;
+    progress: vue.Ref<number, number>;
+}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
+    start: () => any;
+    finish: () => any;
+    writing: () => any;
+}, string, vue.PublicProps, Readonly<__VLS_Props$g> & Readonly<{
+    onStart?: (() => any) | undefined;
+    onFinish?: (() => any) | undefined;
+    onWriting?: (() => any) | undefined;
+}>, {
+    isMarkdown: boolean;
+    isFog: boolean | {
+        bgColor?: string;
+        width?: string;
+    };
+    typing: boolean | {
+        step?: number;
+        interval?: number;
+        suffix?: string;
+    };
+}, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
+declare const _default$g: typeof __VLS_export$g;
+
+/** Typewriter 对外实例形态(defineExpose 经 proxyRefs 已自动解包,宽松兼容 Ref | 值) */
+interface TypewriterExposed {
+    interrupt: () => void;
+    continue: () => void;
+    restart: () => void;
+    destroy: () => void;
+    renderedContent: Ref<string> | string;
+    isTyping: Ref<boolean> | boolean;
+    progress: Ref<number> | number;
+}
+type TypingConfig = {
+    step?: number;
+    interval?: number;
+    suffix?: string;
+};
+type __VLS_Props$f = {
+    /** 气泡内容 */
+    content?: string;
+    /** 对齐:start 靠左 / end 靠右(end 时头像随 row-reverse 翻转到右侧) */
+    placement?: 'start' | 'end';
+    /** 加载态:展示 #loading 插槽或内置三点动画 */
+    loading?: boolean;
+    /** 打字机模式:透传 Typewriter(falsy 时直接渲染内容) */
+    typing?: boolean | TypingConfig;
+    /** 内容按 markdown 渲染 */
+    isMarkdown?: boolean;
+    /** 雾化:透传 Typewriter(自定义气泡背景时传 bgColor) */
+    isFog?: boolean | {
+        bgColor?: string;
+        width?: string;
+    };
+    variant?: 'filled' | 'borderless' | 'outlined' | 'shadow';
+    shape?: 'round' | 'corner';
+    /** 头像图片地址(el-avatar src) */
+    avatar?: string;
+    /** 头像尺寸(el-avatar size,枚举或数值) */
+    avatarSize?: InstanceType<typeof ElAvatar>['size'] | number;
+    avatarGap?: string;
+    avatarShape?: 'circle' | 'square';
+    /** 头像图标组件(与 avatar 冲突时 icon 优先) */
+    avatarIcon?: Component;
+    avatarSrcSet?: string;
+    avatarAlt?: string;
+    /** 头像填充方式(el-avatar fit) */
+    avatarFit?: InstanceType<typeof ElAvatar>['fit'];
+    /** 内容区去内边距 */
+    noPadding?: boolean;
+    /** 去气泡样式(透明/无框/无阴影) */
+    noStyle?: boolean;
+};
+declare function interrupt(): void;
+declare function continueTy(): void;
+declare function restart(): void;
+declare function destroy(): void;
+declare var __VLS_1$9: {};
+declare var __VLS_10$1: {};
+declare var __VLS_12$1: {};
+declare var __VLS_14$1: {};
+declare var __VLS_32: {};
+type __VLS_Slots$e = {} & {
+    avatar?: (props: typeof __VLS_1$9) => any;
+} & {
+    header?: (props: typeof __VLS_10$1) => any;
+} & {
+    loading?: (props: typeof __VLS_12$1) => any;
+} & {
+    content?: (props: typeof __VLS_14$1) => any;
+} & {
+    footer?: (props: typeof __VLS_32) => any;
+};
+declare const __VLS_base$e: vue.DefineComponent<__VLS_Props$f, {
+    interrupt: typeof interrupt;
+    continue: typeof continueTy;
+    restart: typeof restart;
+    destroy: typeof destroy;
+    renderedContent: vue.ComputedRef<string>;
+    isTyping: vue.ComputedRef<boolean>;
+    progress: vue.ComputedRef<number>;
+    twInstance: Ref<{
+        interrupt: () => void;
+        continue: () => void;
+        restart: () => void;
+        destroy: () => void;
+        renderedContent: string;
+        isTyping: boolean;
+        progress: number;
+    } | null, TypewriterExposed | {
+        interrupt: () => void;
+        continue: () => void;
+        restart: () => void;
+        destroy: () => void;
+        renderedContent: string;
+        isTyping: boolean;
+        progress: number;
+    } | null>;
+}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
+    start: () => any;
+    finish: () => any;
+    writing: () => any;
+    "avatar-error": (event: Event) => any;
+}, string, vue.PublicProps, Readonly<__VLS_Props$f> & Readonly<{
+    onStart?: (() => any) | undefined;
+    onFinish?: (() => any) | undefined;
+    onWriting?: (() => any) | undefined;
+    "onAvatar-error"?: ((event: Event) => any) | undefined;
+}>, {
+    content: string;
+    isMarkdown: boolean;
+    isFog: boolean | {
+        bgColor?: string;
+        width?: string;
+    };
+    typing: boolean | TypingConfig;
+    shape: "round" | "corner";
+    placement: "start" | "end";
+    loading: boolean;
+    variant: "filled" | "borderless" | "outlined" | "shadow";
+    avatar: string;
+    avatarSize: number | "" | "default" | "small" | "large";
+    avatarGap: string;
+    avatarShape: "circle" | "square";
+    avatarSrcSet: string;
+    avatarAlt: string;
+    avatarFit: InstanceType<typeof ElAvatar>["fit"];
+    noPadding: boolean;
+    noStyle: boolean;
+}, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export$f: __VLS_WithSlots$e<typeof __VLS_base$e, __VLS_Slots$e>;
+declare const _default$f: typeof __VLS_export$f;
+
+type __VLS_WithSlots$e<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+
+/** 列表项 = Bubble props + key(key 仅供 v-for,不透传给 Bubble) */
+interface BubbleListItemProps {
+    key: string | number;
+    [prop: string]: unknown;
+}
+type __VLS_Props$e = {
+    /** 气泡列表 */
+    list: BubbleListItemProps[];
+    /** 滚动容器最大高度(如 '350px'/'60vh') */
+    maxHeight?: string;
+    /** 始终显示滚动条(否则仅在滚动时显示,依赖浏览器 hover/scroll 实现) */
+    alwaysShowScrollbar?: boolean;
+    /** 是否显示回底按钮 */
+    showBackButton?: boolean;
+    /** 距底超过该像素显示回底按钮 */
+    backButtonThreshold?: number;
+    /** 回底按钮加载态 */
+    btnLoading?: boolean;
+    /** 回底按钮颜色(el-button color) */
+    btnColor?: string;
+    /** 回底按钮位置偏移 */
+    backButtonPosition?: {
+        bottom?: string;
+        left?: string;
+    };
+    /** 回底按钮图标尺寸 */
+    btnIconSize?: number;
+    /**
+     * @complete 触发索引:
+     * - 'only-last'(默认):仅最后一个 typing=true 的气泡完成时上抛
+     * - 'all':所有气泡完成都上抛
+     * - number[]:仅指定索引上抛(无效索引过滤并 console.warn)
+     */
+    triggerIndices?: 'only-last' | 'all' | number[];
+};
+declare function scrollToTop$1(): void;
+declare function scrollToBottom$1(): void;
+/** 定位第 index 个气泡到可视区 */
+declare function scrollToBubble(index: number): void;
+declare var __VLS_10: {
+    item: BubbleListItemProps;
+    index: number;
+};
+declare var __VLS_13: {
+    item: BubbleListItemProps;
+    index: number;
+};
+declare var __VLS_16$1: {
+    item: BubbleListItemProps;
+    index: number;
+};
+declare var __VLS_19$1: {
+    item: BubbleListItemProps;
+    index: number;
+};
+declare var __VLS_22: {
+    item: BubbleListItemProps;
+    index: number;
+};
+type __VLS_Slots$d = {} & {
+    avatar?: (props: typeof __VLS_10) => any;
+} & {
+    header?: (props: typeof __VLS_13) => any;
+} & {
+    content?: (props: typeof __VLS_16$1) => any;
+} & {
+    loading?: (props: typeof __VLS_19$1) => any;
+} & {
+    footer?: (props: typeof __VLS_22) => any;
+};
+declare const __VLS_base$d: vue.DefineComponent<__VLS_Props$e, {
+    scrollToTop: typeof scrollToTop$1;
+    scrollToBottom: typeof scrollToBottom$1;
+    scrollToBubble: typeof scrollToBubble;
+}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
+    complete: (instance: unknown, index: number) => any;
+}, string, vue.PublicProps, Readonly<__VLS_Props$e> & Readonly<{
+    onComplete?: ((instance: unknown, index: number) => any) | undefined;
+}>, {
+    list: BubbleListItemProps[];
+    maxHeight: string;
+    alwaysShowScrollbar: boolean;
+    showBackButton: boolean;
+    backButtonThreshold: number;
+    btnLoading: boolean;
+    btnColor: string;
+    backButtonPosition: {
+        bottom?: string;
+        left?: string;
+    };
+    btnIconSize: number;
+    triggerIndices: "only-last" | "all" | number[];
+}, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export$e: __VLS_WithSlots$d<typeof __VLS_base$d, __VLS_Slots$d>;
+declare const _default$e: typeof __VLS_export$e;
+
+type __VLS_WithSlots$d<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+
+type __VLS_Props$d = {
+    /** 输入值(v-model) */
+    modelValue?: string;
+    placeholder?: string;
+    /** 自增高:minRows/maxRows(行高 22px) */
+    autosize?: {
+        minRows?: number;
+        maxRows?: number;
+    };
+    /** 输入字数上限:超限截断(det-oms 约定 ≤8000);缺省不限制 */
+    maxlength?: number;
+    /** 提交按键模式 */
+    submitType?: 'enter' | 'shiftEnter' | 'cmdOrCtrlEnter' | 'altEnter';
+    /** 加载态:显示停止按钮,输入区禁用 */
+    loading?: boolean;
+    disabled?: boolean;
+    readOnly?: boolean;
+    /** 显示清空按钮(有内容时) */
+    clearable?: boolean;
+    /** 输入区宽度(如 '60%',variant=default 时有效) */
+    inputWidth?: string;
+    /** default:输入+按钮同排;updown:上输入区下操作栏 */
+    variant?: 'default' | 'updown';
+    /** 发送按钮禁用(空内容禁用逻辑之外附加) */
+    submitBtnDisabled?: boolean;
+    /** 指令触发字符串(光标前命中时弹指令框) */
+    triggerStrings?: string[];
+    /** 指令弹框显隐(v-model:triggerPopoverVisible) */
+    triggerPopoverVisible?: boolean;
+    /** 指令弹框宽度 */
+    triggerPopoverWidth?: string;
+    /** 指令弹框 left 偏移(命中字符处) */
+    triggerPopoverLeft?: string;
+    /** 指令弹框距触发字符偏移量 */
+    triggerPopoverOffset?: number;
+    /** 指令弹框位置(el-popover placement) */
+    triggerPopoverPlacement?: InstanceType<typeof ElPopover>['placement'];
+    /** 显示语音按钮(useRecord 于 Task 15 接线,当前为 TODO 桩) */
+    allowSpeech?: boolean;
+    /** 允许空内容提交(附件场景:只发文件不输文字时提交按钮保持可点) */
+    allowEmptySubmit?: boolean;
+};
+declare function submit$1(): void;
+declare function cancel$1(): void;
+declare function clear$2(): void;
+/** focus(pos):'all' 全选 | 'start' 光标到头 | 'end' 光标到尾(缺省 end) */
+declare function focus$1(pos?: 'all' | 'start' | 'end'): void;
+declare function blur$2(): void;
+declare function openHeader$2(): void;
+declare function closeHeader$2(): void;
+declare var __VLS_1$8: {};
+declare var __VLS_3$2: {};
+declare var __VLS_5: {};
+declare var __VLS_14: {
+    keyword: string;
+};
+declare var __VLS_16: {};
+declare var __VLS_18: {};
+declare var __VLS_96: {};
+type __VLS_Slots$c = {} & {
+    header?: (props: typeof __VLS_1$8) => any;
+} & {
+    'body-top'?: (props: typeof __VLS_3$2) => any;
+} & {
+    prefix?: (props: typeof __VLS_5) => any;
+} & {
+    trigger?: (props: typeof __VLS_14) => any;
+} & {
+    'action-list'?: (props: typeof __VLS_16) => any;
+} & {
+    'action-left'?: (props: typeof __VLS_18) => any;
+} & {
+    footer?: (props: typeof __VLS_96) => any;
+};
+declare const __VLS_base$c: vue.DefineComponent<__VLS_Props$d, {
+    submit: typeof submit$1;
+    cancel: typeof cancel$1;
+    clear: typeof clear$2;
+    focus: typeof focus$1;
+    blur: typeof blur$2;
+    openHeader: typeof openHeader$2;
+    closeHeader: typeof closeHeader$2;
+}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
+    submit: (value: string) => any;
+    trigger: (keyword: string, visible: boolean) => any;
+    "update:modelValue": (value: string) => any;
+    cancel: () => any;
+    change: (value: string) => any;
+    "recording-change": (recording: boolean) => any;
+    "paste-file": (file: File) => any;
+    "update:triggerPopoverVisible": (value: boolean) => any;
+}, string, vue.PublicProps, Readonly<__VLS_Props$d> & Readonly<{
+    onSubmit?: ((value: string) => any) | undefined;
+    onTrigger?: ((keyword: string, visible: boolean) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: string) => any) | undefined;
+    onCancel?: (() => any) | undefined;
+    onChange?: ((value: string) => any) | undefined;
+    "onRecording-change"?: ((recording: boolean) => any) | undefined;
+    "onPaste-file"?: ((file: File) => any) | undefined;
+    "onUpdate:triggerPopoverVisible"?: ((value: boolean) => any) | undefined;
+}>, {
+    loading: boolean;
+    variant: "default" | "updown";
+    disabled: boolean;
+    modelValue: string;
+    placeholder: string;
+    autosize: {
+        minRows?: number;
+        maxRows?: number;
+    };
+    maxlength: number;
+    submitType: "enter" | "shiftEnter" | "cmdOrCtrlEnter" | "altEnter";
+    readOnly: boolean;
+    clearable: boolean;
+    inputWidth: string;
+    submitBtnDisabled: boolean;
+    triggerStrings: string[];
+    triggerPopoverVisible: boolean;
+    triggerPopoverWidth: string;
+    triggerPopoverLeft: string;
+    triggerPopoverOffset: number;
+    triggerPopoverPlacement: InstanceType<typeof ElPopover>["placement"];
+    allowSpeech: boolean;
+    allowEmptySubmit: boolean;
+}, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export$d: __VLS_WithSlots$c<typeof __VLS_base$c, __VLS_Slots$c>;
+declare const _default$d: typeof __VLS_export$d;
+
+type __VLS_WithSlots$c<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+
+/** 用户项(userList 元素 / asyncMatchFun 返回项) */
+interface MentionUserInfo {
+    id: string;
+    name: string;
+    avatar?: string;
+    pinyin?: string;
+}
+/** 自定义触发组:prefix 命中时弹 tagList,dialogTitle 为弹层标题 */
+interface MentionCustomTrigger {
+    dialogTitle: string;
+    prefix: string;
+    tagList: Array<{
+        id: string;
+        name: string;
+        pinyin?: string;
+    }>;
+}
+type __VLS_Props$c = {
+    /** 输入值(v-model) */
+    modelValue?: string;
+    /** @ 触发的候选用户列表 */
+    userList?: MentionUserInfo[];
+    /** 自定义触发组(prefix 命中弹对应 tagList) */
+    customTrigger?: MentionCustomTrigger[];
+    /** 异步候选:存在时防抖 300ms 拉取(后端负责过滤) */
+    asyncMatchFun?: (search: string) => Promise<MentionUserInfo[]>;
+};
+declare function submit(): void;
+declare function cancel(): void;
+declare function clear$1(): void;
+/** focus(pos):'all' 全选 | 'start' 头 | 'end' 尾(缺省 end) */
+declare function focus(pos?: 'all' | 'start' | 'end'): void;
+declare function blur$1(): void;
+declare function openHeader$1(): void;
+declare function closeHeader$1(): void;
+/** 程序化插入 @用户 标签(光标处) */
+declare function setUserTag$1(userId: string): void;
+/** 程序化插入自定义触发标签(光标处) */
+declare function setCustomTag$1(prefix: string, id: string): void;
+declare var __VLS_20: string;
+declare var __VLS_21$2: any;
+type __VLS_Slots$b = {} & {
+    [K in NonNullable<typeof __VLS_20>]?: (props: typeof __VLS_21$2) => any;
+};
+declare const __VLS_base$b: vue.DefineComponent<__VLS_Props$c, {
+    submit: typeof submit;
+    cancel: typeof cancel;
+    clear: typeof clear$1;
+    focus: typeof focus;
+    blur: typeof blur$1;
+    openHeader: typeof openHeader$1;
+    closeHeader: typeof closeHeader$1;
+    setUserTag: typeof setUserTag$1;
+    setCustomTag: typeof setCustomTag$1;
+}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
+    submit: (value: string) => any;
+    trigger: (keyword: string, visible: boolean) => any;
+    "update:modelValue": (value: string) => any;
+    cancel: () => any;
+    change: (value: string) => any;
+    "recording-change": (recording: boolean) => any;
+    "paste-file": (file: File) => any;
+    "update:triggerPopoverVisible": (value: boolean) => any;
+    "show-at-dialog": (visible: boolean) => any;
+}, string, vue.PublicProps, Readonly<__VLS_Props$c> & Readonly<{
+    onSubmit?: ((value: string) => any) | undefined;
+    onTrigger?: ((keyword: string, visible: boolean) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: string) => any) | undefined;
+    onCancel?: (() => any) | undefined;
+    onChange?: ((value: string) => any) | undefined;
+    "onRecording-change"?: ((recording: boolean) => any) | undefined;
+    "onPaste-file"?: ((file: File) => any) | undefined;
+    "onUpdate:triggerPopoverVisible"?: ((value: boolean) => any) | undefined;
+    "onShow-at-dialog"?: ((visible: boolean) => any) | undefined;
+}>, {
+    modelValue: string;
+    userList: MentionUserInfo[];
+    customTrigger: MentionCustomTrigger[];
+    asyncMatchFun: (search: string) => Promise<MentionUserInfo[]>;
+}, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export$c: __VLS_WithSlots$b<typeof __VLS_base$b, __VLS_Slots$b>;
+declare const _default$c: typeof __VLS_export$c;
+
+type __VLS_WithSlots$b<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+
+/** 用户项(userList 元素 / asyncMatchFun 返回项) */
+interface EditorUser {
+    id: string;
+    name: string;
+    avatar?: string;
+    pinyin?: string;
+}
+/** 自定义触发组:prefix 命中时弹 tagList,dialogTitle 为弹层标题 */
+interface EditorCustomTrigger {
+    dialogTitle: string;
+    prefix: string;
+    tagList: Array<{
+        id: string;
+        name: string;
+        pinyin?: string;
+    }>;
+}
+/** 选择标签选项(selectList[].options 元素,preview 为预览图地址) */
+interface EditorSelectOption {
+    id: string;
+    name: string;
+    preview?: string;
+}
+/** 选择标签分组 */
+interface EditorSelectGroup {
+    dialogTitle: string;
+    key: string;
+    options: EditorSelectOption[];
+}
+/** 选择标签值(setSelectTag / tags.selectTags 元素) */
+interface EditorSelectTag {
+    value: string;
+    name?: string;
+    key?: string;
+}
+/** 文档节点类型:纯文本与五类标签 */
+type TagNodeType = 'text' | 'userTag' | 'selectTag' | 'inputTag' | 'customTag' | 'htmlTag';
+/** 文档节点:标签引擎的最小单元,value 依类型不同(text→string,其余→对象) */
+interface TagNode {
+    id: string;
+    type: TagNodeType;
+    value: any;
+    meta?: Record<string, any>;
+}
+/** 提交结果:text 为标签文本化后的纯文本,html 为编辑区内部 HTML,tags 为各类型标签集合 */
+interface SubmitResult {
+    text: string;
+    html: string;
+    tags: {
+        userTags: EditorUser[];
+        selectTags: EditorSelectTag[];
+        inputTags: Array<{
+            id: string;
+            name: string;
+        }>;
+        customTags: Array<{
+            id: string;
+            name: string;
+            prefix?: string;
+        }>;
+    };
+}
+/** chat 方法(open-webui 对齐) */
+type ChatMethod = 'insert' | 'update' | 'delete' | 'append';
+/** 选择标签更新方法 */
+type UpdateMethod = 'insertTag' | 'updateTagValue' | 'deleteTag' | 'updateTagStyle';
+/** setMixTags 混合标签行元素:按 type 分发到对应 set* */
+type MixTag = {
+    type: 'userTag';
+    id: string;
+} | {
+    type: 'selectTag';
+    value: string;
+    name?: string;
+    key?: string;
+} | {
+    type: 'inputTag';
+    id: string;
+    name: string;
+} | {
+    type: 'customTag';
+    prefix: string;
+    id: string;
+} | {
+    type: 'text';
+    value: string;
+};
+type __VLS_Props$b = {
+    placeholder?: string;
+    /** 设备形态:仅影响样式(pc 默认 / h5 紧凑) */
+    device?: 'pc' | 'h5';
+    autoFocus?: boolean;
+    /** default:输入+按钮同排;updown:上输入区下操作栏 */
+    variant?: 'default' | 'updown';
+    /** @ 触发的候选用户列表 */
+    userList?: EditorUser[];
+    /** 自定义触发组(prefix 命中弹对应 tagList) */
+    customTrigger?: EditorCustomTrigger[];
+    /** 选择标签分组(openSelectDialog 弹窗数据) */
+    selectList?: EditorSelectGroup[];
+    /** 纯文本最大长度(性能开销大,仅显式开启) */
+    maxLength?: number;
+    /** 提交按键模式 */
+    submitType?: 'enter' | 'shiftEnter';
+    /** 根节点自定义样式 */
+    customStyle?: Record<string, any>;
+    loading?: boolean;
+    disabled?: boolean;
+    /** 显示清空按钮(有内容时) */
+    clearable?: boolean;
+    /** 头部过渡时长(毫秒) */
+    headerAnimationTimer?: number;
+    /** 异步候选:存在时防抖 300ms 拉取(后端负责过滤) */
+    asyncMatchFun?: (search: string) => Promise<EditorUser[]>;
+    /** 自定义弹窗:true 时不弹内置选择弹窗,仅上抛 show-select-dialog 由外部接管 */
+    customDialog?: boolean;
+};
+/**
+ * 编辑器 API:state 为数据源,insert/update/delete/append 为对外操作面。
+ * 声明即带操作面签名再赋值实现,避免逐行 chat.insert = ... 展开时被类型推断收窄。
+ */
+interface EditorChatApi {
+    state: {
+        nodes: TagNode[];
+    };
+    insert(options?: Record<string, any>): void;
+    update(options?: Record<string, any>): void;
+    delete(options?: Record<string, any>): void;
+    append(options?: Record<string, any>): void;
+}
+declare function getCurrentValue(): SubmitResult;
+declare function placeCursorEnd(): void;
+declare function focusToStart(): void;
+declare function selectAll(): void;
+declare function blur(): void;
+declare function openSelectDialog(): void;
+/** 打开 tip(nodeId 缺省取第一个 inputTag) */
+declare function openTipTag(nodeId?: string): void;
+declare function closeTipTag(): void;
+/** 在光标处插入纯文本(不删除已有内容) */
+declare function setText(text: string): void;
+/** 插入用户标签(userList 按 id 查找,找不到以 id 兜底) */
+declare function setUserTag(userId: string): void;
+/** 插入自定义触发标签(customTrigger 按 prefix+id 查找) */
+declare function setCustomTag(prefix: string, id: string): void;
+/** 插入输入标签(可编辑 chip) */
+declare function setInputTag(id: string, name: string): void;
+/** 追加选择标签组 */
+declare function setSelectTag(list: EditorSelectTag[]): void;
+/** 外部直接传入用户对象插入(不经 userList) */
+declare function customSetUser(user: EditorUser): void;
+/** 外部直接传入标签对象插入(不经 customTrigger) */
+declare function customSetTag(tag: {
+    id: string;
+    name: string;
+    prefix?: string;
+}): void;
+/** 整体写入 html:解析为 text/htmlTag 节点(替换现有内容) */
+declare function setHtml(html: string): void;
+/** 混合标签整体写入:清空后按 type 分发到对应 set*(覆盖写入) */
+declare function setMixTags(rows: MixTag[][]): void;
+declare function clear(): void;
+declare function updateSelectTag(method: UpdateMethod, options?: Record<string, any>): void;
+/** chat 方法分发:insert / update / delete / append */
+declare function opNode(method: ChatMethod, options?: Record<string, any>): void;
+/** 暴露文档状态(外部遍历 nodes) */
+declare function chatState(): {
+    nodes: TagNode[];
+};
+declare function openHeader(): void;
+declare function closeHeader(): void;
+declare var __VLS_1$7: {};
+declare var __VLS_3$1: {};
+declare var __VLS_19: {
+    nodeId: string;
+};
+declare var __VLS_21$1: {};
+declare var __VLS_80: {};
+type __VLS_Slots$a = {} & {
+    header?: (props: typeof __VLS_1$7) => any;
+} & {
+    prefix?: (props: typeof __VLS_3$1) => any;
+} & {
+    'tag-tip'?: (props: typeof __VLS_19) => any;
+} & {
+    'action-list'?: (props: typeof __VLS_21$1) => any;
+} & {
+    footer?: (props: typeof __VLS_80) => any;
+};
+declare const __VLS_base$a: vue.DefineComponent<__VLS_Props$b, {
+    getCurrentValue: typeof getCurrentValue;
+    focusToStart: typeof focusToStart;
+    focusToEnd: typeof placeCursorEnd;
+    blur: typeof blur;
+    selectAll: typeof selectAll;
+    clear: typeof clear;
+    setSelectTag: typeof setSelectTag;
+    setInputTag: typeof setInputTag;
+    setUserTag: typeof setUserTag;
+    setCustomTag: typeof setCustomTag;
+    setMixTags: typeof setMixTags;
+    setHtml: typeof setHtml;
+    setText: typeof setText;
+    openSelectDialog: typeof openSelectDialog;
+    customSetUser: typeof customSetUser;
+    customSetTag: typeof customSetTag;
+    updateSelectTag: typeof updateSelectTag;
+    openTipTag: typeof openTipTag;
+    closeTipTag: typeof closeTipTag;
+    openHeader: typeof openHeader;
+    closeHeader: typeof closeHeader;
+    chat: EditorChatApi;
+    opNode: typeof opNode;
+    chatState: typeof chatState;
+}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
+    submit: (payload: SubmitResult) => any;
+    cancel: () => any;
+    change: (payload: SubmitResult) => any;
+    "show-at-dialog": (visible: boolean) => any;
+    "show-select-dialog": (visible: boolean) => any;
+    "show-tag-dialog": (visible: boolean) => any;
+}, string, vue.PublicProps, Readonly<__VLS_Props$b> & Readonly<{
+    onSubmit?: ((payload: SubmitResult) => any) | undefined;
+    onCancel?: (() => any) | undefined;
+    onChange?: ((payload: SubmitResult) => any) | undefined;
+    "onShow-at-dialog"?: ((visible: boolean) => any) | undefined;
+    "onShow-select-dialog"?: ((visible: boolean) => any) | undefined;
+    "onShow-tag-dialog"?: ((visible: boolean) => any) | undefined;
+}>, {
+    loading: boolean;
+    variant: "default" | "updown";
+    disabled: boolean;
+    placeholder: string;
+    submitType: "enter" | "shiftEnter";
+    clearable: boolean;
+    userList: EditorUser[];
+    customTrigger: EditorCustomTrigger[];
+    asyncMatchFun: (search: string) => Promise<EditorUser[]>;
+    device: "pc" | "h5";
+    autoFocus: boolean;
+    selectList: EditorSelectGroup[];
+    maxLength: number;
+    customStyle: Record<string, any>;
+    headerAnimationTimer: number;
+    customDialog: boolean;
+}, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export$b: __VLS_WithSlots$a<typeof __VLS_base$a, __VLS_Slots$a>;
+declare const _default$b: typeof __VLS_export$b;
+
+type __VLS_WithSlots$a<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+
+type ThinkingStatus = 'start' | 'thinking' | 'end' | 'error';
+type __VLS_Props$a = {
+    /** 展开/收起(v-model) */
+    modelValue?: boolean;
+    /** 思考内容(#content 插槽常嵌 XMarkdown/Typewriter 渲染思考流) */
+    content?: string;
+    /** 思考状态:start 起始 / thinking 思考中 / end 完成 / error 出错 */
+    status?: ThinkingStatus;
+    /** 禁用切换 */
+    disabled?: boolean;
+    /** status 变为 end 时自动收起 */
+    autoCollapse?: boolean;
+    /** 切换按钮区宽度(如 '150px') */
+    buttonWidth?: string;
+    /** 内容区最大宽度 */
+    maxWidth?: string;
+    /** 前景色(文字/图标,css color) */
+    color?: string;
+    /** 背景色 */
+    backgroundColor?: string;
+};
+/** 切换门控:start 起始态不可切换;thinking 中可展开查看思考流,end/error 后可自由收起展开 */
+declare function toggle(): void;
+declare var __VLS_1$6: {};
+declare var __VLS_36: {};
+declare var __VLS_38: {};
+declare var __VLS_51: {};
+declare var __VLS_53: {};
+type __VLS_Slots$9 = {} & {
+    'status-icon'?: (props: typeof __VLS_1$6) => any;
+} & {
+    label?: (props: typeof __VLS_36) => any;
+} & {
+    arrow?: (props: typeof __VLS_38) => any;
+} & {
+    error?: (props: typeof __VLS_51) => any;
+} & {
+    content?: (props: typeof __VLS_53) => any;
+};
+declare const __VLS_base$9: vue.DefineComponent<__VLS_Props$a, {
+    modelValue: vue.Ref<boolean, boolean>;
+    toggle: typeof toggle;
+}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
+    "update:modelValue": (value: boolean) => any;
+}, string, vue.PublicProps, Readonly<__VLS_Props$a> & Readonly<{
+    "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
+}>, {
+    content: string;
+    disabled: boolean;
+    color: string;
+    modelValue: boolean;
+    status: ThinkingStatus;
+    autoCollapse: boolean;
+    buttonWidth: string;
+    maxWidth: string;
+    backgroundColor: string;
+}, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export$a: __VLS_WithSlots$9<typeof __VLS_base$9, __VLS_Slots$9>;
+declare const _default$a: typeof __VLS_export$a;
+
+type __VLS_WithSlots$9<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+
+type ChainItemStatus = 'pending' | 'success' | 'loading' | 'error';
+interface ThoughtChainItem {
+    key: string | number;
+    title?: string;
+    status?: ChainItemStatus;
+    icon?: Component;
+    description?: string;
+}
+type __VLS_Props$9 = {
+    /** 步骤列表 */
+    items: ThoughtChainItem[];
+    /** 排列方向:vertical 纵向(带连接线)/ horizontal 横向 */
+    direction?: 'vertical' | 'horizontal';
+};
+declare var __VLS_45: {
+    item: ThoughtChainItem;
+    index: number;
+};
+type __VLS_Slots$8 = {} & {
+    content?: (props: typeof __VLS_45) => any;
+};
+declare const __VLS_base$8: vue.DefineComponent<__VLS_Props$9, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {}, string, vue.PublicProps, Readonly<__VLS_Props$9> & Readonly<{}>, {
+    items: ThoughtChainItem[];
+    direction: "vertical" | "horizontal";
+}, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export$9: __VLS_WithSlots$8<typeof __VLS_base$8, __VLS_Slots$8>;
+declare const _default$9: typeof __VLS_export$9;
+
+type __VLS_WithSlots$8<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+
+type __VLS_Props$8 = {
+    /** 图标:字符串为图片地址;也可传组件;缺省渲染内置对话图标 */
+    icon?: string | Component;
+    /** 名称 */
+    name?: string;
+    /** 描述(纯文本) */
+    description?: string;
+};
+declare var __VLS_1$5: {};
+declare var __VLS_24$1: {};
+declare var __VLS_26$1: {};
+type __VLS_Slots$7 = {} & {
+    icon?: (props: typeof __VLS_1$5) => any;
+} & {
+    name?: (props: typeof __VLS_24$1) => any;
+} & {
+    description?: (props: typeof __VLS_26$1) => any;
+};
+declare const __VLS_base$7: vue.DefineComponent<__VLS_Props$8, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {}, string, vue.PublicProps, Readonly<__VLS_Props$8> & Readonly<{}>, {
+    name: string;
+    icon: string | Component;
+    description: string;
+}, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export$8: __VLS_WithSlots$7<typeof __VLS_base$7, __VLS_Slots$7>;
+declare const _default$8: typeof __VLS_export$8;
+
+type __VLS_WithSlots$7<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+
+interface PromptItem {
+    key: string | number;
+    label?: string;
+    description?: string;
+    icon?: string | Component;
+    disabled?: boolean;
+}
+type __VLS_Props$7 = {
+    /** 建议 prompt 列表 */
+    prompts?: PromptItem[];
+    /** 网格标题 */
+    title?: string;
+};
+declare var __VLS_1$4: {
+    item: PromptItem;
+    index: number;
+};
+type __VLS_Slots$6 = {} & {
+    default?: (props: typeof __VLS_1$4) => any;
+};
+declare const __VLS_base$6: vue.DefineComponent<__VLS_Props$7, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
+    select: (item: PromptItem) => any;
+}, string, vue.PublicProps, Readonly<__VLS_Props$7> & Readonly<{
+    onSelect?: ((item: PromptItem) => any) | undefined;
+}>, {
+    title: string;
+    prompts: PromptItem[];
+}, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export$7: __VLS_WithSlots$6<typeof __VLS_base$6, __VLS_Slots$6>;
+declare const _default$7: typeof __VLS_export$7;
+
+type __VLS_WithSlots$6<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+
+type __VLS_Props$6 = {
+    /** 文件名 */
+    name: string;
+    /** 文件形态:image 渲染缩略图,file 渲染文档图标卡 */
+    fileType?: 'image' | 'file';
+    /** 文件大小(字节;也接受 '2KB' 这类已格式化字符串,原样展示) */
+    size?: number | string;
+    /** 图片地址:image 模式下渲染缩略图 */
+    url?: string;
+    /** 状态:loading 上传中 spinner / success 无标记 / error 红边 */
+    status?: 'loading' | 'success' | 'error';
+    /** 图片缩略图尺寸(image 模式) */
+    imageSize?: string;
+    /** 删除回调:右上删除按钮点击时调用 */
+    onDelete?: () => void;
+};
+declare var __VLS_1$3: {};
+type __VLS_Slots$5 = {} & {
+    image?: (props: typeof __VLS_1$3) => any;
+};
+declare const __VLS_base$5: vue.DefineComponent<__VLS_Props$6, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {}, string, vue.PublicProps, Readonly<__VLS_Props$6> & Readonly<{}>, {
+    url: string;
+    name: string;
+    size: number | string;
+    status: "loading" | "success" | "error";
+    fileType: "image" | "file";
+    imageSize: string;
+    onDelete: () => void;
+}, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export$6: __VLS_WithSlots$5<typeof __VLS_base$5, __VLS_Slots$5>;
+declare const _default$6: typeof __VLS_export$6;
+
+type __VLS_WithSlots$5<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+
+/** 列表项:原始 File + 派生展示字段(name/size/url/status 透传 FilesCard) */
+interface AttachmentItem {
+    uid: string | number;
+    name: string;
+    size?: number;
+    url?: string;
+    fileType?: 'image' | 'file';
+    status?: 'loading' | 'success' | 'error';
+    raw?: File;
+    [key: string]: unknown;
+}
+type __VLS_Props$5 = {
+    /** 附件列表(v-model) */
+    modelValue?: object[];
+    /** input[type=file] accept 属性,如 'image/*' */
+    accept?: string;
+    /** 内联提示文案(数量/格式说明) */
+    tip?: string;
+    /** 最大附件数,超出走 @exceed */
+    count?: number;
+    /** 上传前校验,返回 false(或 resolve false)拦截 */
+    beforeUpload?: (file: File) => boolean | Promise<boolean>;
+    /** 布局:inline(默认)按钮+列表+提示一行;triggerOnly 只渲染回形针按钮;listOnly 只渲染文件列表 */
+    layout?: 'inline' | 'triggerOnly' | 'listOnly';
+};
+/** 重传:error 项重新置为 loading(具体上传由外部接线,这里只驱动状态流转) */
+declare function retry(item: AttachmentItem): void;
+declare function openSelect(): void;
+declare var __VLS_12: {
+    item: object;
+    index: number;
+};
+declare var __VLS_21: {
+    item: object;
+    index: number;
+};
+type __VLS_Slots$4 = {} & {
+    'list-item'?: (props: typeof __VLS_12) => any;
+} & {
+    'list-thumb'?: (props: typeof __VLS_21) => any;
+};
+declare const __VLS_base$4: vue.DefineComponent<__VLS_Props$5, {
+    openSelect: typeof openSelect;
+    retry: typeof retry;
+}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
+    delete: (item: object) => any;
+    "update:modelValue": (list: object[]) => any;
+    change: (list: object[]) => any;
+    exceed: (file: File) => any;
+}, string, vue.PublicProps, Readonly<__VLS_Props$5> & Readonly<{
+    onDelete?: ((item: object) => any) | undefined;
+    "onUpdate:modelValue"?: ((list: object[]) => any) | undefined;
+    onChange?: ((list: object[]) => any) | undefined;
+    onExceed?: ((file: File) => any) | undefined;
+}>, {
+    modelValue: object[];
+    accept: string;
+    tip: string;
+    count: number;
+    beforeUpload: (file: File) => boolean | Promise<boolean>;
+    layout: "inline" | "triggerOnly" | "listOnly";
+}, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export$5: __VLS_WithSlots$4<typeof __VLS_base$4, __VLS_Slots$4>;
+declare const _default$5: typeof __VLS_export$5;
+
+type __VLS_WithSlots$4<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+
+/** 会话项 */
+interface ConversationItem {
+    key: string | number;
+    label: string;
+    group?: string;
+    disabled?: boolean;
+}
+/** 分组结构:groupable 比较器作用于该对象 */
+interface ConversationGroup {
+    group?: string;
+    items: ConversationItem[];
+}
+/** 内置菜单指令 */
+type MenuCommand = 'rename' | 'delete';
+type __VLS_Props$4 = {
+    /** 会话列表(按 group 字段分组,保持插入顺序) */
+    items: ConversationItem[];
+    /** 当前激活会话 key(v-model:active) */
+    active?: string | number;
+    /** 内置菜单按钮显隐方式:hover 悬停显示(默认)/ always 常显 */
+    showBuiltInMenuType?: 'hover' | 'always';
+    /** 分组排序比较器(定制分组顺序;缺省保持插入顺序) */
+    groupable?: (a: ConversationGroup, b: ConversationGroup) => number;
+    /** 下一页加载中(分页场景;loading 时滚动到底不再触发 load-more) */
+    loading?: boolean;
+    /** 是否还有更早分页(缺省 false 表示一次性全量,不触发 load-more) */
+    hasMore?: boolean;
+};
+declare function handleMenuCommand(cmd: {
+    item: ConversationItem;
+    command: MenuCommand;
+}): void;
+/** renamePrompt(key):弹输入框,确认后 emit menu-command {command:'rename', value:新名称} */
+declare function renamePrompt(key: string | number): Promise<void>;
+/** deleteConfirm(key):弹确认框,确认后 emit menu-command {command:'delete'} */
+declare function deleteConfirm(key: string | number): Promise<void>;
+declare var __VLS_1$2: {
+    group: string;
+};
+declare var __VLS_3: {
+    item: ConversationItem;
+    active: boolean;
+};
+declare var __VLS_31: {
+    item: ConversationItem;
+};
+type __VLS_Slots$3 = {} & {
+    'group-title'?: (props: typeof __VLS_1$2) => any;
+} & {
+    item?: (props: typeof __VLS_3) => any;
+} & {
+    menu?: (props: typeof __VLS_31) => any;
+};
+declare const __VLS_base$3: vue.DefineComponent<__VLS_Props$4, {
+    handleMenuCommand: typeof handleMenuCommand;
+    renamePrompt: typeof renamePrompt;
+    deleteConfirm: typeof deleteConfirm;
+}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
+    change: (item: ConversationItem) => any;
+    "update:active": (key: string | number) => any;
+    "menu-command": (cmd: {
+        item: ConversationItem;
+        command: MenuCommand;
+        value?: string;
+    }) => any;
+    "load-more": () => any;
+}, string, vue.PublicProps, Readonly<__VLS_Props$4> & Readonly<{
+    onChange?: ((item: ConversationItem) => any) | undefined;
+    "onUpdate:active"?: ((key: string | number) => any) | undefined;
+    "onMenu-command"?: ((cmd: {
+        item: ConversationItem;
+        command: MenuCommand;
+        value?: string;
+    }) => any) | undefined;
+    "onLoad-more"?: (() => any) | undefined;
+}>, {
+    loading: boolean;
+    items: ConversationItem[];
+    active: string | number;
+    showBuiltInMenuType: "hover" | "always";
+    groupable: (a: ConversationGroup, b: ConversationGroup) => number;
+    hasMore: boolean;
+}, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export$4: __VLS_WithSlots$3<typeof __VLS_base$3, __VLS_Slots$3>;
+declare const _default$4: typeof __VLS_export$4;
+
+type __VLS_WithSlots$3<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+
+/** adapter 层透传的 OpenAI 风格消息 */
+interface AdapterChatMessage {
+    role: 'user' | 'assistant' | 'system' | string;
+    content: string;
+}
+/** 发送请求体 */
+interface ChatAdapterRequest {
+    /** 对话消息(时间正序) */
+    messages: Array<{
+        role: string;
+        content: string;
+    }>;
+    /** 覆盖配置中的模型 */
+    model?: string;
+    /** 是否流式,默认 true */
+    stream?: boolean;
+    /** 外部中止信号(与 adapter 内部 abort 合并生效) */
+    signal?: AbortSignal;
+}
+/** 服务端原始 usage(snake_case,按 OpenAI 规范原样回调) */
+interface RawUsage {
+    prompt_tokens?: number;
+    completion_tokens?: number;
+    total_tokens?: number;
+}
+/** 流式/响应过程回调集合 */
+interface ChatAdapterHandlers {
+    /** 正文增量 */
+    onDelta(text: string): void;
+    /** 思考链增量(reasoning_content) */
+    onReasoning(text: string): void;
+    /** token 用量(部分服务端在最后一帧携带) */
+    onUsage(u: RawUsage): void;
+    /**
+     * 后端消息行 id 锚定(可选):流式 message_end 时携带的最终文本行 id,
+     * 与 message_start 的首轮 GENERATING 行 id 可能不同(多轮工具循环),UI 落库/对账以它为准
+     */
+    onBackendMessageId?(id: string): void;
+    /** 工具调用轨迹事件(可选):det-oms 风格 tool{status:start|done} */
+    onTool?(ev: {
+        toolName: string;
+        status: 'start' | 'done';
+    }): void;
+    /** 正常结束(含非流式) */
+    onDone(): void;
+    /** 出错(HTTP 非 2xx / 网络 / 中断) */
+    onError(e: Error): void;
+}
+/**
+ * 聊天后端适配器:一次 send 对应一次完整生成(流式到 onDone 或出错进 onError)。
+ * Task 17 useChat 消费该接口,可替换为自研后端/Ollama 等实现。
+ */
+interface ChatAdapter {
+    send(req: ChatAdapterRequest, handlers: ChatAdapterHandlers): Promise<void>;
+    /** 中止全部进行中的请求(并发 send 各自独立可中止;已完成的请求不受影响) */
+    abort(): void;
+}
+/** OpenAI 兼容服务配置 */
+interface OpenAIAdapterConfig {
+    /** 服务根地址,如 https://api.openai.com/v1,内部拼接 /chat/completions */
+    baseURL: string;
+    /** Bearer Token 密钥 */
+    apiKey?: string;
+    /** 默认模型,可被 req.model 覆盖 */
+    model?: string;
+}
+/**
+ * OpenAI 兼容 ChatAdapter(/v1/chat/completions)。
+ * 流式走 Task 2 的 createSSEParser 解析 SSE,兼容 deepseek 风格 reasoning_content。
+ */
+declare function OpenAIAdapter(config: OpenAIAdapterConfig): ChatAdapter;
+
+/**
+ * det-oms(`/api/ai-chat/*`)风格聊天适配器:五事件 SSE 协议
+ * (message_start / tool / delta / message_end / error),POST `/message/send`。
+ * 协议细节见 det-oms 前端接入文档 §4;本适配器负责协议解析与事件分发,
+ * 会话管理(列表/归档/删除等)由消费方直接调后端,不经此适配器。
+ */
+/** send 请求体(sessionId 由工厂按当前会话惰性注入) */
+interface DetOmsSendBody {
+    sessionId: string;
+    content: string;
+}
+/** 工具事件载荷(det-oms SSE `tool` 事件 data) */
+interface DetOmsToolEvent {
+    toolName: string;
+    status: 'start' | 'done';
+}
+/** 会话列表项(`/session/list` records 行;total 等 IPage 字段为字符串需 parseInt) */
+interface DetOmsSessionItem {
+    id: string;
+    title: string;
+    titleSource?: 'AUTO' | 'MANUAL';
+    status?: 'ACTIVE' | 'ARCHIVED';
+    archivedTime?: string | null;
+    messageCount?: number;
+    lastMessageExcerpt?: string | null;
+    lastMessageTime?: string | null;
+    createdTime?: string;
+    updatedTime?: string;
+}
+/** 历史/详情消息行(assistant 行 toolCalls 为 JSON 字符串,消费方自行 JSON.parse) */
+interface DetOmsMessage {
+    id: string;
+    seq: number;
+    role: 'user' | 'assistant' | 'tool';
+    content: string | null;
+    toolCalls?: string | null;
+    toolCallId?: string | null;
+    toolName?: string | null;
+    status?: 'GENERATING' | 'SUCCESS' | 'FAILED' | 'INTERRUPTED' | null;
+    failReason?: string | null;
+    promptTokens?: number | null;
+    completionTokens?: number | null;
+    /** Long 全局转字符串 */
+    elapsedMs?: string | null;
+    createdTime?: string;
+}
+/** 会话详情出参(`/session/detail`) */
+interface DetOmsSessionDetail {
+    session: DetOmsSessionItem;
+    messages: DetOmsMessage[];
+}
+/** 消息 history 分页出参(`/message/history`) */
+interface DetOmsMessagePage {
+    messages: DetOmsMessage[];
+    hasMore: boolean;
+}
+interface DetOmsChatAdapterConfig {
+    /** 服务根地址,如 https://host 或 /api(内部拼接 /ai-chat/message/send) */
+    baseURL: string;
+    /** 请求头(如 { Authorization: 'Bearer ' + token }),每次 send 惰性取用 */
+    headers?: Record<string, string> | (() => Record<string, string>);
+    /** 当前会话 id(工厂惰性取用:切换会话后下一次 send 即生效) */
+    sessionId: string | (() => string);
+    /** 业务错误码 → 提示文案映射(如 { 90602: '已有进行中的对话' });命中时 onError 的 message 用映射文案 */
+    errorMessages?: Record<number, string>;
+}
+/** 带业务码的错误:同步段 JSON 错误(90601/90602/90603/90105)与 SSE error 事件统一走此形态 */
+declare class DetOmsError extends Error {
+    code?: number | string;
+    constructor(message: string, code?: number | string);
+}
+/**
+ * det-oms 聊天适配器:消费五事件 SSE。
+ * 同步段失败(会话不存在/单飞行闸/未启用/参数校验)发生在 SSE 建立前,
+ * 响应是普通 JSON 错误——此处按 Content-Type 分流,命中 errorMessages 时用映射文案。
+ * 消息三角色里的 tool 行(toolCallId 配对)是会话管理端的落库形态,
+ * 流式期间只有 tool{status} 事件(无 tool 行),由 onTool 上抛给消费方展示工具状态。
+ */
+declare function DetOmsChatAdapter(config: DetOmsChatAdapterConfig): ChatAdapter;
+
+/**
+ * 会话/消息持久化适配器。
+ * Task 17 useChat 用它保存会话列表与 messageTree 序列化结果,
+ * 接口为 async 以便未来替换为 IndexedDB/后端存储而不改调用方。
+ */
+interface StorageAdapter {
+    get<T>(key: string): Promise<T | undefined>;
+    set<T>(key: string, val: T): Promise<void>;
+    remove(key: string): Promise<void>;
+}
+/**
+ * localStorage 存储适配器。
+ * mock/SSR 环境探测失败时自动降级为内存实现(数据不持久化,但不崩)。
+ */
+declare function createLocalStorageAdapter(): StorageAdapter;
+/** 纯内存存储适配器(测试/降级用,页面刷新即失) */
+declare function createMemoryAdapter(): StorageAdapter;
+
+interface SSEEvent {
+    event?: string;
+    data: string;
+}
+interface SSEParser {
+    push(chunk: string): void;
+    end(): void;
+}
+declare function createSSEParser(onEvent: (ev: SSEEvent) => void, options?: {
+    streamSeparator?: string;
+    partSeparator?: string;
+    kvSeparator?: string;
+}): SSEParser;
+
+/**
+ * @fv-ui/ai-chat 公共类型汇聚出口。
+ * 标量/树形消息等基础类型在本文件直接定义(单一事实来源,消除 messageTree ↔ types 循环引用);
+ * core 其余模块(adapter/storage/sse)的类型在此汇聚再导出,
+ * 消费方 `import type { MessageNode, ChatAdapter, ... } from '@fv-ui/ai-chat'`。
+ */
+/** 消息角色 */
+type MessageRole = 'user' | 'assistant';
+/** 消息生命周期状态 */
+type MessageStatus = 'pending' | 'streaming' | 'done' | 'error';
+/**
+ * 工具调用轨迹项(det-oms 风格):assistant 行 toolCalls 展开后的单个工具调用。
+ * 兼容 OpenAI function calling 形状(type/function.name/function.arguments)。
+ */
+interface ToolCallItem {
+    id: string;
+    type?: string;
+    function?: {
+        name?: string;
+        arguments?: string;
+    };
+    [k: string]: unknown;
+}
+/** token 用量(camelCase;adapter 层 snake_case 的 RawUsage 到此的映射责任在包装层) */
+interface MessageUsage {
+    promptTokens?: number;
+    completionTokens?: number;
+    totalTokens?: number;
+}
+/** 消息附件文件描述(序列化安全:只含可 JSON 化字段,不含 File 原始对象) */
+interface ChatFile {
+    /** 附件唯一标识 */
+    id: string;
+    /** 文件名 */
+    name: string;
+    /** 体积(字节) */
+    size?: number;
+    /** 预览/下载地址(data URL 或远程地址) */
+    url?: string;
+    /** 附件类别,缺省按 'file' 处理 */
+    type?: 'image' | 'file';
+}
+/** 树形消息节点(同构 open-webui 会话消息:parentId/childrenIds 构成分支树) */
+interface MessageNode {
+    id: string;
+    role: MessageRole;
+    content: string;
+    /** 思考链全文(流式期间由包装层追加) */
+    reasoning?: string;
+    /** 附件列表 */
+    files?: ChatFile[];
+    /** 多模型对话中的模型序号(open-webui 语义) */
+    modelIdx?: number;
+    /** 生成模型名 */
+    model?: string;
+    /** 后端消息行 id(det-oms 等带会话管理后端):流式 message_end 时回填,UI 落库/对账锚定用 */
+    backendId?: string;
+    /** 中间轮工具调用列表(JSON 字符串或已展开数组;det-oms assistant 行 toolCalls 非空即中间轮) */
+    toolCalls?: string | ToolCallItem[];
+    /** 父节点 id,根消息为 null */
+    parentId: string | null;
+    /** 子节点 id 列表(多个子节点即多个分支回答) */
+    childrenIds: string[];
+    status?: MessageStatus;
+    /** status 为 'error' 时的错误描述 */
+    error?: string;
+    /** 创建时间戳(ms) */
+    createdAt: number;
+    usage?: MessageUsage;
+}
+/** addMessage 入参:id/childrenIds 由树生成;parentId 缺省挂到当前焦点 */
+type MessageNodeInput = Omit<MessageNode, 'id' | 'parentId' | 'childrenIds' | 'createdAt'> & {
+    /** 挂载父节点;undefined 挂到当前焦点,null 强制为根消息 */
+    parentId?: string | null;
+    /** 创建时间戳;缺省 Date.now() */
+    createdAt?: number;
+};
+/** 分支导航方向 */
+type BranchDirection = 'prev' | 'next';
+/** 树形消息数据结构(纯函数对象,非响应式;useMessages 包装 reactive 驱动视图) */
+interface MessageTree {
+    messages: Record<string, MessageNode>;
+    currentId: string | null;
+    addMessage(node: MessageNodeInput): string;
+    deleteMessage(id: string): void;
+    editMessage(id: string, patch: Partial<MessageNode>): void;
+    appendContent(id: string, text: string): void;
+    navigateBranch(id: string, dir: BranchDirection): string | null;
+    setCurrent(id: string): void;
+    getCurrentChain(): MessageNode[];
+    getSiblings(id: string): MessageNode[];
+    toJSON(): string;
+    fromJSON(s: string): void;
+}
+
+/** 建议项(Prompts PromptItem 同构:key 必填) */
+interface AiMessagesSuggestion {
+    key: string | number;
+    label?: string;
+    description?: string;
+    icon?: string | Component;
+    disabled?: boolean;
+}
+type __VLS_Props$3 = {
+    /** 当前链消息(根 → 焦点,时间正序) */
+    messages: MessageNode[];
+    /** 全量节点表(分支计算需查父节点 childrenIds) */
+    nodes?: Record<string, MessageNode>;
+    /** 空态欢迎页图标 */
+    icon?: string | Component;
+    /** 空态欢迎页名称 */
+    name?: string;
+    /** 空态欢迎页描述 */
+    description?: string;
+    /** 空态建议列表(Prompts) */
+    suggestions?: AiMessagesSuggestion[];
+    /** 空态建议区标题 */
+    suggestionsTitle?: string;
+    /** 用户上滚免打扰阈值(px):距底不超过该值才自动吸底 */
+    scrollThreshold?: number;
+    /** 显示消息操作按钮 */
+    showActions?: boolean;
+    /** 显示分支切换器 */
+    showBranchSwitch?: boolean;
+};
+declare function scrollToBottom(smooth?: boolean): void;
+/** 回到顶部:与 scrollToBottom 同款 try/catch 回落(happy-dom 旧版 scrollTo(options) 可能缺实现) */
+declare function scrollToTop(): void;
+declare var __VLS_1$1: {};
+declare var __VLS_26: {
+    message: MessageNode;
+};
+declare var __VLS_29: {
+    message: MessageNode;
+};
+type __VLS_Slots$2 = {} & {
+    empty?: (props: typeof __VLS_1$1) => any;
+} & {
+    'message-avatar'?: (props: typeof __VLS_26) => any;
+} & {
+    'message-actions'?: (props: typeof __VLS_29) => any;
+};
+declare const __VLS_base$2: vue.DefineComponent<__VLS_Props$3, {
+    scrollToBottom: typeof scrollToBottom;
+    scrollToTop: typeof scrollToTop;
+}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
+    select: (item: AiMessagesSuggestion) => any;
+    copy: (message: MessageNode) => any;
+    regenerate: (message: MessageNode) => any;
+    "branch-change": (dir: BranchDirection, message: MessageNode) => any;
+}, string, vue.PublicProps, Readonly<__VLS_Props$3> & Readonly<{
+    onSelect?: ((item: AiMessagesSuggestion) => any) | undefined;
+    onCopy?: ((message: MessageNode) => any) | undefined;
+    onRegenerate?: ((message: MessageNode) => any) | undefined;
+    "onBranch-change"?: ((dir: BranchDirection, message: MessageNode) => any) | undefined;
+}>, {
+    name: string;
+    icon: string | Component;
+    nodes: Record<string, MessageNode>;
+    description: string;
+    showActions: boolean;
+    showBranchSwitch: boolean;
+    suggestions: AiMessagesSuggestion[];
+    suggestionsTitle: string;
+    scrollThreshold: number;
+}, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export$3: __VLS_WithSlots$2<typeof __VLS_base$2, __VLS_Slots$2>;
+declare const _default$3: typeof __VLS_export$3;
+
+type __VLS_WithSlots$2<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+
+/** 建议项(空态 Prompts)——空接口再导出仅为语义命名,保留 */
+interface AiChatSuggestion extends AiMessagesSuggestion {
+}
+/** 可选特性开关 */
+interface AiChatFeatures {
+    artifacts?: boolean;
+    tts?: boolean;
+    queue?: boolean;
+    continueGenerate?: boolean;
+    fullscreenEditor?: boolean;
+}
+type __VLS_Props$2 = {
+    /** 默认模型(顶栏单选展示;未传 models 时作为单模型) */
+    model?: string;
+    /** 可选模型列表(multiple 选择器) */
+    models?: string[];
+    /** OpenAI 兼容服务地址(未传 adapter 时用它构造 OpenAIAdapter) */
+    baseURL?: string;
+    /** OpenAI 兼容服务密钥 */
+    apiKey?: string;
+    /** 聊天适配器(与 baseURL 二选一,优先) */
+    adapter?: ChatAdapter;
+    /** 消息链(v-model:messages,扁平数组同步) */
+    messages?: MessageNode[];
+    /** 顶栏标题 */
+    title?: string;
+    /** 输入框占位 */
+    placeholder?: string;
+    /** 空态建议列表 */
+    suggestions?: AiChatSuggestion[];
+    /** 特性开关 */
+    features?: AiChatFeatures;
+    /** 开启输入区附件上传(输入框上方回形针 + 附件列表,发送时随 @send 上抛 files) */
+    allowAttachments?: boolean;
+    /** 附件 input accept 属性(透传 Attachments),如 'image/*' */
+    accept?: string;
+    /** 附件数量上限(透传 Attachments,0 不限) */
+    attachmentLimit?: number;
+    /** 主题:light/dark/auto(注入 html dark class) */
+    theme?: 'light' | 'dark' | 'auto';
+};
+/** 停止生成:生成在途时置位 stopped(空闲时无待收口轮次,不置位避免残留误吞下一轮),再中止在途请求 */
+declare function stop(): void;
+/** 重生成:UI 与 ref 路径共用同一包装,完成后统一收口上抛事件(两条路径行为一致) */
+declare function regenerate(messageId?: string): void;
+declare function sendMessage(text: string, files?: ChatFile[]): void;
+/** 向指定消息追加文本(编辑/续写场景) */
+declare function appendToMessage(id: string, text: string): void;
+/** 清空消息树(整框重置) */
+declare function clearMessages(): void;
+/** 导出当前链为纯文本(角色: 内容 逐条) */
+declare function exportTxt(): string;
+/** 程序化打开某个 artifact(ref 方法) */
+declare function openArtifact(key: string): void;
+declare var __VLS_24: {
+    message: MessageNode;
+};
+declare var __VLS_27: {
+    message: MessageNode;
+};
+declare var __VLS_30: {};
+declare var __VLS_66: {};
+type __VLS_Slots$1 = {} & {
+    'message-avatar'?: (props: typeof __VLS_24) => any;
+} & {
+    'message-actions'?: (props: typeof __VLS_27) => any;
+} & {
+    empty?: (props: typeof __VLS_30) => any;
+} & {
+    'sender-prefix'?: (props: typeof __VLS_66) => any;
+};
+declare const __VLS_base$1: vue.DefineComponent<__VLS_Props$2, {
+    sendMessage: typeof sendMessage;
+    stop: typeof stop;
+    regenerate: typeof regenerate;
+    appendToMessage: typeof appendToMessage;
+    clearMessages: typeof clearMessages;
+    exportTxt: typeof exportTxt;
+    openArtifact: typeof openArtifact;
+}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
+    error: (err: Error, message?: MessageNode | undefined) => any;
+    "branch-change": (dir: BranchDirection, message: MessageNode) => any;
+    "update:messages": (value: MessageNode[]) => any;
+    send: (text: string, files?: ChatFile[] | undefined) => any;
+    "message-complete": (message: MessageNode) => any;
+    "attachment-exceed": (file: File) => any;
+    "tool-event": (ev: {
+        toolName: string;
+        status: "start" | "done";
+    }) => any;
+}, string, vue.PublicProps, Readonly<__VLS_Props$2> & Readonly<{
+    onError?: ((err: Error, message?: MessageNode | undefined) => any) | undefined;
+    "onBranch-change"?: ((dir: BranchDirection, message: MessageNode) => any) | undefined;
+    "onUpdate:messages"?: ((value: MessageNode[]) => any) | undefined;
+    onSend?: ((text: string, files?: ChatFile[] | undefined) => any) | undefined;
+    "onMessage-complete"?: ((message: MessageNode) => any) | undefined;
+    "onAttachment-exceed"?: ((file: File) => any) | undefined;
+    "onTool-event"?: ((ev: {
+        toolName: string;
+        status: "start" | "done";
+    }) => any) | undefined;
+}>, {
+    title: string;
+    placeholder: string;
+    accept: string;
+    baseURL: string;
+    apiKey: string;
+    model: string;
+    messages: MessageNode[];
+    suggestions: AiChatSuggestion[];
+    models: string[];
+    adapter: ChatAdapter;
+    features: AiChatFeatures;
+    allowAttachments: boolean;
+    attachmentLimit: number;
+    theme: "light" | "dark" | "auto";
+}, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export$2: __VLS_WithSlots$1<typeof __VLS_base$1, __VLS_Slots$1>;
+declare const _default$2: typeof __VLS_export$2;
+
+type __VLS_WithSlots$1<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+
+/** 单条消息展示需要的分支元数据(由 AiMessages 计算注入) */
+interface AiMessageBranchInfo {
+    /** 同层分支总数 */
+    count: number;
+    /** 当前分支序号(1 起) */
+    index: number;
+}
+type __VLS_Props$1 = {
+    /** 消息节点(树节点代理,流式期间 content/reasoning 增长驱动更新) */
+    message: MessageNode;
+    /** 同层分支元数据;缺省视为单分支(不渲染切换器) */
+    branch?: AiMessageBranchInfo;
+    /** 显示操作按钮(复制/重生成;仅 assistant) */
+    showActions?: boolean;
+    /** 显示分支切换器(branch.count > 1 时) */
+    showBranchSwitch?: boolean;
+    /** Thinking autoCollapse 透传 */
+    autoCollapse?: boolean;
+};
+declare var __VLS_1: {
+    message: MessageNode;
+};
+declare var __VLS_25: {
+    message: MessageNode;
+    files: ChatFile[];
+};
+declare var __VLS_44: {
+    message: MessageNode;
+};
+type __VLS_Slots = {} & {
+    'message-avatar'?: (props: typeof __VLS_1) => any;
+} & {
+    'message-files'?: (props: typeof __VLS_25) => any;
+} & {
+    'message-actions'?: (props: typeof __VLS_44) => any;
+};
+declare const __VLS_base: vue.DefineComponent<__VLS_Props$1, {
+    message: vue.ComputedRef<MessageNode>;
+}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
+    copy: (message: MessageNode) => any;
+    regenerate: (message: MessageNode) => any;
+    "branch-change": (dir: BranchDirection, message: MessageNode) => any;
+}, string, vue.PublicProps, Readonly<__VLS_Props$1> & Readonly<{
+    onCopy?: ((message: MessageNode) => any) | undefined;
+    onRegenerate?: ((message: MessageNode) => any) | undefined;
+    "onBranch-change"?: ((dir: BranchDirection, message: MessageNode) => any) | undefined;
+}>, {
+    autoCollapse: boolean;
+    branch: AiMessageBranchInfo;
+    showActions: boolean;
+    showBranchSwitch: boolean;
+}, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export$1: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default$1: typeof __VLS_export$1;
+
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+
+/** 单个 artifact 项 */
+interface AiArtifactItem {
+    /** 唯一 key */
+    key: string;
+    /** 内容类型:html / svg */
+    type: 'html' | 'svg';
+    /** 原始内容(html 片段或完整 svg 文本) */
+    content: string;
+    /** 展示标题(缺省回退 key) */
+    title?: string;
+}
+type __VLS_Props = {
+    /** artifact 列表(从消息 ```html / ```svg 代码块提取组装) */
+    artifacts: AiArtifactItem[];
+    /** 当前展示的 artifact key;为空时面板隐藏 */
+    activeKey?: string;
+};
+declare function open(key: string): void;
+declare function close(): void;
+declare const __VLS_export: vue.DefineComponent<__VLS_Props, {
+    open: typeof open;
+    close: typeof close;
+}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
+    change: (key: string) => any;
+    close: () => any;
+    navigate: (href: string) => any;
+}, string, vue.PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onChange?: ((key: string) => any) | undefined;
+    onClose?: (() => any) | undefined;
+    onNavigate?: ((href: string) => any) | undefined;
+}>, {
+    artifacts: AiArtifactItem[];
+    activeKey: string;
+}, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+
+interface UseXStreamReturn {
+    startStream(options: {
+        readableStream: ReadableStream<Uint8Array>;
+        transformStream?: TransformStream<any, any>;
+    }): Promise<void>;
+    cancel(): void;
+    data: Ref<SSEEvent[]>;
+    error: Ref<Error | null>;
+    isLoading: Ref<boolean>;
+}
+declare function useXStream(): UseXStreamReturn;
+
+/** send 请求参数 */
+interface SendOptions {
+    /** 请求地址 */
+    url: string;
+    /** 请求方法,默认 POST */
+    method?: string;
+    /** 请求头 */
+    headers?: Record<string, string>;
+    /** 请求体对象(内部 JSON.stringify) */
+    body?: object;
+    /** 可选转换流,接在 TextDecoderStream 之后(如协议转换) */
+    transformStream?: TransformStream<any, any>;
+    /** 全部 SSE 事件透传(含 event 名;tool/message_start 等非 content 事件不再被吞) */
+    onEvent?: (ev: SSEEvent) => void;
+    /** 内容分片回调:SSE data 为 JSON 且含字符串 content 时逐块触发 */
+    onChunk?: (text: string) => void;
+}
+interface UseSendReturn {
+    /** 发起请求并消费 SSE 流(逐块回调 onChunk) */
+    send: (options: SendOptions) => Promise<void>;
+    /** 中止当前请求/流消费 */
+    abort: () => void;
+    loading: Ref<boolean>;
+    error: Ref<Error | null>;
+}
+declare function useSend(): UseSendReturn;
+/**
+ * XRequest:Promise 化的流式请求,resolve 累计全文。
+ * options 同 SendOptions(url 由首参覆盖),onChunk 透传照常触发。
+ */
+declare function XRequest(url: string, options?: Omit<SendOptions, 'url'>): Promise<string>;
+
+interface UseRecordReturn {
+    /** 开始录音(+实时转写);失败不抛出,写入 error */
+    start: () => Promise<void>;
+    /** 停止录音与转写,合成 audioUrl */
+    stop: () => void;
+    isRecording: Ref<boolean>;
+    /** 实时转写文本(最终结果 + 中间结果拼接) */
+    text: Ref<string>;
+    /** 录音成品地址(Blob URL),stop 后生成,下次 start 前回收 */
+    audioUrl: Ref<string | null>;
+    error: Ref<Error | null>;
+}
+declare function useRecord(): UseRecordReturn;
+
+/** useMessages 返回体 */
+interface UseMessagesReturn {
+    /** 全量节点表(深层响应式;新增/删除键与节点字段变更均可被追踪) */
+    messages: Ref<Record<string, MessageNode>>;
+    /** 当前焦点节点 id(根到焦点构成当前链) */
+    currentId: Ref<string | null>;
+    /** 当前链(根 → 焦点,时间正序) */
+    chain: ComputedRef<MessageNode[]>;
+    /** 新增节点,parentId 缺省挂到当前焦点;返回带真实 id 的节点 */
+    add(node: MessageNodeInput): MessageNode;
+    /** 删除节点(子节点升级接替其在父 children 中的位置) */
+    remove(id: string): void;
+    /** 浅合并补丁(id/parentId/childrenIds 不可改) */
+    edit(id: string, patch: Partial<MessageNode>): void;
+    /** 追加正文 */
+    appendContent(id: string, text: string): void;
+    /** 分支导航,返回目标 id(越界返回 null);id 缺省取当前焦点 */
+    navigate(id?: string, dir?: BranchDirection): string | null;
+    /** 同步设置焦点节点(ref 写法经 watch 异步生效,此方法立即同步树内部状态) */
+    setCurrent(id: string): void;
+    /** 绑定/切换持久化适配器(不立即写盘;此后树变更自动去抖落盘) */
+    setStorage(adapter?: StorageAdapter): void;
+    /** 从存储恢复会话(覆盖当前树;无存储/无数据时保持原状) */
+    load(): Promise<void>;
+    /** 立即落盘(树变更后已自动调度,此为手动兜底,主要用于测试) */
+    flush(): Promise<void>;
+    /** 序列化整树({messages, currentId} JSON) */
+    toJSON(): string;
+}
+/**
+ * 聊天应用层状态中枢:把 Task 16 的纯数据 MessageTree 包装成响应式。
+ *
+ * 响应式策略:
+ * - messages 用深层 ref 容器,其 .value(reactive 代理)注入树 —— 树内增删/字段写全部经由代理,可被追踪
+ * - currentId 用 ref,与树内部 getter/setter 双向同步(watch 回写树,包装方法后拉取树)
+ * - chain 为 computed,依赖上两者;节点对象本身是代理,消费方读 content 等字段同样响应
+ *
+ * @param initial 初始节点表/焦点(恢复会话时传入)
+ */
+declare function useMessages(initial?: {
+    messages?: Record<string, MessageNode>;
+    currentId?: string | null;
+}): UseMessagesReturn;
+
+/** useChat 配置 */
+interface UseChatOptions {
+    /** 聊天适配器实例或工厂(工厂每次 send 惰性求值,便于按会话切模型) */
+    adapter: ChatAdapter | (() => ChatAdapter);
+    /** 选中模型列表(多模型生成多个 assistant;缺省单模型)。支持工厂函数,每次 send 惰性取用(顶栏切换模型即时生效) */
+    models?: string[] | (() => string[]);
+    /** 初始消息表/焦点(恢复会话时传入;透传 useMessages) */
+    initial?: {
+        messages?: Record<string, MessageNode>;
+        currentId?: string | null;
+    };
+    /** 工具调用轨迹事件透传(det-oms 风格 tool{status}):展示「正在查询库存…」等中间态 */
+    onToolEvent?: (ev: {
+        toolName: string;
+        status: 'start' | 'done';
+    }) => void;
+}
+/** 待发送队列项 */
+interface QueueItem {
+    text: string;
+    files?: ChatFile[];
+}
+/** useChat 返回体 */
+interface UseChatReturn {
+    /** 发送用户消息并生成回复;生成中再调用被拒(需要排队的走 enqueue) */
+    send(text: string, files?: ChatFile[]): Promise<void>;
+    /** 中止当前生成:adapter.abort + 在途消息置 done(保留已生成内容) */
+    stop(): void;
+    /** 重新生成:焦点回退到末 assistant 的父节点重发生成新分支(旧回答保留在树上);可指定消息 id */
+    regenerate(messageId?: string): Promise<void>;
+    /** 继续生成:以目标 assistant 既有内容为前缀再次请求,增量追加到同一节点 */
+    continueGenerate(messageId?: string): Promise<void>;
+    /** 待发送队列(生成中入队,完成后自动 flush 队首) */
+    queue: Ref<Array<QueueItem>>;
+    /** 生成中入队;空闲时直接发送 */
+    enqueue(text: string, files?: ChatFile[]): void;
+    /** 是否有生成在途 */
+    isLoading: Ref<boolean>;
+    /** 底层消息树读写面(appendToMessage/clearMessages 等整框层操作经此) */
+    msgs: UseMessagesReturn;
+    /** 全量节点表(ref;分支信息/遍历等场景直查,AiChat 整框 v-model 同步用) */
+    messages: UseMessagesReturn['messages'];
+    currentId: UseMessagesReturn['currentId'];
+    chain: UseMessagesReturn['chain'];
+}
+/**
+ * 聊天应用层编排:在 useMessages 树状态之上驱动"发送 → 流式回填 → 队列/重生成/续写"生命周期。
+ * 消息形态同构 open-webui:user 消息挂树后追加 pending assistant 节点,adapter 回调增量回填,结束置 done。
+ * 多模型(models 数组/modelIdx 字段)接口形状已对齐,各模型 assistant 挂 user 下互为兄弟分支并发回填。
+ */
+declare function useChat(options: UseChatOptions): UseChatReturn;
+
+/**
+ * 创建树形消息数据结构。
+ * 纯函数对象、非响应式;useMessages/useChat 包装 reactive 以驱动视图。
+ * @param initial 初始节点表(恢复会话时传入),currentId 缺省取最后一个无子节点节点
+ */
+declare function createMessageTree(initial?: {
+    messages?: Record<string, MessageNode>;
+    currentId?: string | null;
+}): MessageTree;
+
+declare const version = "0.1.0";
+
+export { DetOmsChatAdapter, DetOmsError, _default as FvAiArtifacts, _default$2 as FvAiChat, _default$1 as FvAiMessage, _default$3 as FvAiMessages, _default$5 as FvAttachments, _default$f as FvBubble, _default$e as FvBubbleList, _default$4 as FvConversations, _default$b as FvEditorSender, _default$6 as FvFilesCard, _default$h as FvMarkdown, _default$c as FvMentionSender, _default$7 as FvPrompts, _default$d as FvSender, _default$a as FvThinking, _default$9 as FvThoughtChain, _default$g as FvTypewriter, _default$8 as FvWelcome, OpenAIAdapter, XRequest, createLocalStorageAdapter, createMemoryAdapter, createMessageTree, createSSEParser, useChat, useMessages, useRecord, useSend, useXStream, version };
+export type { AdapterChatMessage, AiArtifactItem, AiChatFeatures, AiChatSuggestion, AiMessageBranchInfo, AiMessagesSuggestion, BranchDirection, ChatAdapter, ChatAdapterHandlers, ChatAdapterRequest, ChatFile, DetOmsChatAdapterConfig, DetOmsMessage, DetOmsMessagePage, DetOmsSendBody, DetOmsSessionDetail, DetOmsSessionItem, DetOmsToolEvent, MessageNode, MessageNodeInput, MessageRole, MessageStatus, MessageTree, MessageUsage, OpenAIAdapterConfig, QueueItem, RawUsage, SSEEvent, SSEParser, SendOptions, StorageAdapter, ToolCallItem, UseChatOptions, UseChatReturn, UseMessagesReturn, UseRecordReturn, UseSendReturn, UseXStreamReturn };