@opentiny/tiny-robot 0.3.1-alpha.4 → 0.4.0-alpha.1

package/dist/index.d.ts

@@ -9,7 +9,6 @@ import { ComponentOptionsMixin } from 'vue';
 import { ComponentProvideOptions } from 'vue';
 import { ComponentPublicInstance } from 'vue';
 import { ComputedRef } from 'vue';
-import { Config } from 'dompurify';
 import { CreateComponentPublicInstanceWithMixins } from 'vue';
 import { CSSProperties } from 'vue';
 import { DebuggerEvent } from 'vue';
@@ -18,9 +17,10 @@ import { Directive } from 'vue';
 import { ExtractPropTypes } from 'vue';
 import { GlobalComponents } from 'vue';
 import { GlobalDirectives } from 'vue';
+import { MaybeComputedElementRef } from '@vueuse/core';
+import { MaybeRefOrGetter } from 'vue';
 import { nextTick } from 'vue';
 import { OnCleanup } from '@vue/reactivity';
-import { Options } from 'markdown-it';
 import { PropType } from 'vue';
 import { PublicProps } from 'vue';
 import { Ref } from 'vue';
@@ -34,14 +34,47 @@ import { VNodeProps } from 'vue';
 import { WatchOptions } from 'vue';
 import { WatchStopHandle } from 'vue';
 
-declare const __VLS_component: DefineComponent<BubbleProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<BubbleProps> & Readonly<{}>, {
-content: string | BubbleContentItem[];
+declare const __VLS_component: DefineComponent<BubbleProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+"state-change": (payload: {
+key: string;
+value: unknown;
+messageIndex: number;
+contentIndex?: number;
+}) => any;
+}, string, PublicProps, Readonly<BubbleProps> & Readonly<{
+"onState-change"?: ((payload: {
+key: string;
+value: unknown;
+messageIndex: number;
+contentIndex?: number;
+}) => any) | undefined;
+}>, {
 placement: "start" | "end";
-shape: "rounded" | "corner";
-abortedText: string;
+shape: "corner" | "rounded" | "none";
+contentRenderMode: "single" | "split";
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
 
-declare const __VLS_component_10: DefineComponent<__VLS_PublicProps_4, {
+declare const __VLS_component_10: DefineComponent<__VLS_PublicProps_3, {
+children: ComputedRef<(HTMLElement | SVGElement)[]>;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+"update:showAll": (value: boolean | undefined) => any;
+} & {
+"click-outside": (event: MouseEvent) => any;
+}, string, PublicProps, Readonly<__VLS_PublicProps_3> & Readonly<{
+"onClick-outside"?: ((event: MouseEvent) => any) | undefined;
+"onUpdate:showAll"?: ((value: boolean | undefined) => any) | undefined;
+}>, {
+showAllButtonOn: "hover" | "always";
+overflowMode: "expand" | "scroll";
+}, {}, {}, {}, string, ComponentProvideOptions, false, {
+containerWrapperRef: HTMLDivElement;
+containerRef: HTMLDivElement;
+staticMaybeItemRefs: unknown[];
+floatingItemsRef: HTMLDivElement;
+floatingMaybeItemRefs: unknown[];
+}, HTMLDivElement>;
+
+declare const __VLS_component_11: DefineComponent<__VLS_PublicProps_4, {
 update: () => void;
 }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
 "update:selectedGroup": (value: string) => any;
@@ -177,7 +210,7 @@ show?: TooltipContentProps["show"];
 }>, {}, {}, {}, {}, {}> | null;
 }, any>;
 
-declare const __VLS_component_11: DefineComponent<__VLS_PublicProps_5, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+declare const __VLS_component_12: DefineComponent<__VLS_PublicProps_5, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
 "update:theme": (value: string) => any;
 "update:colorMode": (value: ColorMode) => any;
 }, string, PublicProps, Readonly<__VLS_PublicProps_5> & Readonly<{
@@ -188,15 +221,37 @@ targetElement: string;
 storageKey: string;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
-declare const __VLS_component_12: DefineComponent<WelcomeProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<WelcomeProps> & Readonly<{}>, {
+declare const __VLS_component_13: DefineComponent<WelcomeProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<WelcomeProps> & Readonly<{}>, {
 align: "left" | "center" | "right" | string;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
 
-declare const __VLS_component_2: DefineComponent<__VLS_Props, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
-contentRenderers: Record<string, BubbleContentRenderer>;
-}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+declare const __VLS_component_2: DefineComponent<BubbleListProps, {
+scrollToBottom: (behavior?: ScrollBehavior) => Promise<void>;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+"state-change": (payload: {
+key: string;
+value: unknown;
+messageIndex: number;
+contentIndex?: number;
+}) => any;
+}, string, PublicProps, Readonly<BubbleListProps> & Readonly<{
+"onState-change"?: ((payload: {
+key: string;
+value: unknown;
+messageIndex: number;
+contentIndex?: number;
+}) => any) | undefined;
+}>, {
+groupStrategy: "consecutive" | "divider" | ((messages: BubbleMessage[], dividerRole?: string) => BubbleMessageGroup[]);
+dividerRole: string;
+fallbackRole: string;
+}, {}, {}, {}, string, ComponentProvideOptions, false, {
+listRef: HTMLDivElement;
+}, HTMLDivElement>;
 
-declare const __VLS_component_3: DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+declare const __VLS_component_3: DefineComponent<BubbleProviderProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<BubbleProviderProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+
+declare const __VLS_component_4: DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
 "update:show": (value: boolean) => any;
 "update:fullscreen": (value: boolean | undefined) => any;
 } & {
@@ -209,9 +264,9 @@ onClose?: (() => any) | undefined;
 title: string;
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
 
-declare const __VLS_component_4: DefineComponent<DragOverlayProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<DragOverlayProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+declare const __VLS_component_5: DefineComponent<DragOverlayProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<DragOverlayProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
 
-declare const __VLS_component_5: DefineComponent<__VLS_PublicProps_2, {
+declare const __VLS_component_6: DefineComponent<__VLS_PublicProps_2, {
 update: () => void;
 }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
 "update:show": (value: boolean) => any;
@@ -319,13 +374,13 @@ content?: () => VNode[];
 }) | null;
 }, any>;
 
-declare const __VLS_component_6: DefineComponent<PromptsProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+declare const __VLS_component_7: DefineComponent<PromptsProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
 "item-click": (ev: MouseEvent, item: PromptProps) => any;
 }, string, PublicProps, Readonly<PromptsProps> & Readonly<{
 "onItem-click"?: ((ev: MouseEvent, item: PromptProps) => any) | undefined;
 }>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
 
-declare const __VLS_component_7: DefineComponent<SenderProps, {
+declare const __VLS_component_8: DefineComponent<SenderProps, {
 focus: () => void;
 blur: () => void;
 clear: () => void;
@@ -369,8 +424,8 @@ onSubmit?: ((value: string) => any) | undefined;
 disabled: boolean;
 modelValue: string;
 placeholder: string;
-mode: InputMode;
 loading: boolean;
+mode: InputMode;
 autofocus: boolean;
 allowSpeech: boolean;
 allowFiles: boolean;
@@ -880,73 +935,49 @@ inputBoxType: string;
 buttonsContainerRef: HTMLDivElement;
 }, HTMLDivElement>;
 
-declare const __VLS_component_8: DefineComponent<SuggestionPillButtonProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<SuggestionPillButtonProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLButtonElement>;
-
-declare const __VLS_component_9: DefineComponent<__VLS_PublicProps_3, {
-children: ComputedRef<(HTMLElement | SVGElement)[]>;
-}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
-"update:showAll": (value: boolean | undefined) => any;
-} & {
-"click-outside": (event: MouseEvent) => any;
-}, string, PublicProps, Readonly<__VLS_PublicProps_3> & Readonly<{
-"onClick-outside"?: ((event: MouseEvent) => any) | undefined;
-"onUpdate:showAll"?: ((value: boolean | undefined) => any) | undefined;
-}>, {
-showAllButtonOn: "hover" | "always";
-overflowMode: "expand" | "scroll";
-}, {}, {}, {}, string, ComponentProvideOptions, false, {
-containerWrapperRef: HTMLDivElement;
-containerRef: HTMLDivElement;
-staticMaybeItemRefs: unknown[];
-floatingItemsRef: HTMLDivElement;
-floatingMaybeItemRefs: unknown[];
-}, HTMLDivElement>;
+declare const __VLS_component_9: DefineComponent<SuggestionPillButtonProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<SuggestionPillButtonProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLButtonElement>;
 
 declare type __VLS_PrettifyLocal<T> = {
     [K in keyof T]: T[K];
 } & {};
 
-declare type __VLS_Props = {
-    contentRenderers?: Record<string, BubbleContentRenderer>;
-};
-
-declare type __VLS_Props_2 = ContainerProps;
+declare type __VLS_Props = ContainerProps;
 
-declare type __VLS_Props_3 = DropdownMenuProps;
+declare type __VLS_Props_2 = DropdownMenuProps;
 
-declare type __VLS_Props_4 = SuggestionPillsProps;
+declare type __VLS_Props_3 = SuggestionPillsProps;
 
-declare type __VLS_Props_5 = SuggestionPopoverProps;
+declare type __VLS_Props_4 = SuggestionPopoverProps;
 
-declare type __VLS_Props_6 = ThemeProviderProps;
+declare type __VLS_Props_5 = ThemeProviderProps;
 
-declare type __VLS_Props_7 = McpServerPickerProps;
+declare type __VLS_Props_6 = McpServerPickerProps;
 
 declare type __VLS_PublicProps = {
     'show': ContainerProps['show'];
     'fullscreen'?: ContainerProps['fullscreen'];
-} & __VLS_Props_2;
+} & __VLS_Props;
 
 declare type __VLS_PublicProps_2 = {
     'show'?: boolean;
-} & __VLS_Props_3;
+} & __VLS_Props_2;
 
 declare type __VLS_PublicProps_3 = {
     'showAll'?: SuggestionPillsProps['showAll'];
-} & __VLS_Props_4;
+} & __VLS_Props_3;
 
 declare type __VLS_PublicProps_4 = {
     'selectedGroup'?: string;
-} & __VLS_Props_5;
+} & __VLS_Props_4;
 
 declare type __VLS_PublicProps_5 = {
     'theme'?: string;
     'colorMode'?: ColorMode;
-} & __VLS_Props_6;
+} & __VLS_Props_5;
 
 declare type __VLS_PublicProps_6 = {
     'visible': boolean;
-} & __VLS_Props_7;
+} & __VLS_Props_6;
 
 declare function __VLS_template(): {
     attrs: Partial<{}>;
@@ -956,6 +987,19 @@ declare function __VLS_template(): {
 };
 
 declare function __VLS_template_10(): {
+    attrs: Partial<{}>;
+    slots: Readonly<SuggestionPillsSlots> & SuggestionPillsSlots;
+    refs: {
+        containerWrapperRef: HTMLDivElement;
+        containerRef: HTMLDivElement;
+        staticMaybeItemRefs: unknown[];
+        floatingItemsRef: HTMLDivElement;
+        floatingMaybeItemRefs: unknown[];
+    };
+    rootEl: HTMLDivElement;
+};
+
+declare function __VLS_template_11(): {
     attrs: Partial<{}>;
     slots: Readonly<SuggestionPopoverSlots> & SuggestionPopoverSlots;
     refs: {
@@ -1074,7 +1118,7 @@ declare function __VLS_template_10(): {
     rootEl: any;
 };
 
-declare function __VLS_template_11(): {
+declare function __VLS_template_12(): {
     attrs: Partial<{}>;
     slots: {
         default?(_: {}): any;
@@ -1083,7 +1127,7 @@ declare function __VLS_template_11(): {
     rootEl: any;
 };
 
-declare function __VLS_template_12(): {
+declare function __VLS_template_13(): {
     attrs: Partial<{}>;
     slots: Readonly<WelcomeSlots> & WelcomeSlots;
     refs: {};
@@ -1091,6 +1135,15 @@ declare function __VLS_template_12(): {
 };
 
 declare function __VLS_template_2(): {
+    attrs: Partial<{}>;
+    slots: Readonly<BubbleListSlots> & BubbleListSlots;
+    refs: {
+        listRef: HTMLDivElement;
+    };
+    rootEl: HTMLDivElement;
+};
+
+declare function __VLS_template_3(): {
     attrs: Partial<{}>;
     slots: {
         default?(_: {}): any;
@@ -1099,14 +1152,14 @@ declare function __VLS_template_2(): {
     rootEl: any;
 };
 
-declare function __VLS_template_3(): {
+declare function __VLS_template_4(): {
     attrs: Partial<{}>;
     slots: Readonly<ContainerSlots> & ContainerSlots;
     refs: {};
     rootEl: HTMLDivElement;
 };
 
-declare function __VLS_template_4(): {
+declare function __VLS_template_5(): {
     attrs: Partial<{}>;
     slots: {
         overlay?(_: {
@@ -1117,7 +1170,7 @@ declare function __VLS_template_4(): {
     rootEl: any;
 };
 
-declare function __VLS_template_5(): {
+declare function __VLS_template_6(): {
     attrs: Partial<{}>;
     slots: {
         trigger?(_: {}): any;
@@ -1219,14 +1272,14 @@ declare function __VLS_template_5(): {
     rootEl: any;
 };
 
-declare function __VLS_template_6(): {
+declare function __VLS_template_7(): {
     attrs: Partial<{}>;
     slots: Readonly<PromptsSlots> & PromptsSlots;
     refs: {};
     rootEl: HTMLDivElement;
 };
 
-declare function __VLS_template_7(): {
+declare function __VLS_template_8(): {
     attrs: Partial<{}>;
     slots: {
         header?(_: {}): any;
@@ -1736,26 +1789,13 @@ declare function __VLS_template_7(): {
     rootEl: HTMLDivElement;
 };
 
-declare function __VLS_template_8(): {
+declare function __VLS_template_9(): {
     attrs: Partial<{}>;
     slots: Readonly<SuggestionPillButtonSlots> & SuggestionPillButtonSlots;
     refs: {};
     rootEl: HTMLButtonElement;
 };
 
-declare function __VLS_template_9(): {
-    attrs: Partial<{}>;
-    slots: Readonly<SuggestionPillsSlots> & SuggestionPillsSlots;
-    refs: {
-        containerWrapperRef: HTMLDivElement;
-        containerRef: HTMLDivElement;
-        staticMaybeItemRefs: unknown[];
-        floatingItemsRef: HTMLDivElement;
-        floatingMaybeItemRefs: unknown[];
-    };
-    rootEl: HTMLDivElement;
-};
-
 declare type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
 
 declare type __VLS_TemplateResult_10 = ReturnType<typeof __VLS_template_10>;
@@ -1764,6 +1804,8 @@ declare type __VLS_TemplateResult_11 = ReturnType<typeof __VLS_template_11>;
 
 declare type __VLS_TemplateResult_12 = ReturnType<typeof __VLS_template_12>;
 
+declare type __VLS_TemplateResult_13 = ReturnType<typeof __VLS_template_13>;
+
 declare type __VLS_TemplateResult_2 = ReturnType<typeof __VLS_template_2>;
 
 declare type __VLS_TemplateResult_3 = ReturnType<typeof __VLS_template_3>;
@@ -1804,6 +1846,12 @@ declare type __VLS_WithTemplateSlots_12<T, S> = T & {
     };
 };
 
+declare type __VLS_WithTemplateSlots_13<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
+
 declare type __VLS_WithTemplateSlots_2<T, S> = T & {
     new (): {
         $slots: S;
@@ -1931,58 +1979,32 @@ declare const Bubble: typeof _default_18 & {
 export { Bubble }
 export { Bubble as TrBubble }
 
-export declare interface BubbleCommonProps {
-    /**
-     * 气泡对齐位置
-     */
-    placement?: 'start' | 'end';
-    /**
-     * 气泡头像
-     */
-    avatar?: VNode;
-    /**
-     * 气泡形状，默认 'corner'
-     */
-    shape?: 'rounded' | 'corner';
-    /**
-     * 气泡内容渲染器。
-     * 如果 Bubble 中的 content 是长度大于 0 的数组，则 contentRenderer 无效。将会使用 BubbleProvider 中注册的渲染器
-     */
-    contentRenderer?: BubbleContentRenderer;
-    /**
-     * 自定义气泡内容字段。比如 customContentField 设置为 'my-content'，则 Bubble 优先渲染 my-content 属性到气泡内容
-     */
-    customContentField?: string;
-    /**
-     * 气泡中止文本
-     */
-    abortedText?: string;
-    /**
-     * 气泡最大宽度
-     */
-    maxWidth?: string | number;
-}
-
-export declare abstract class BubbleContentClassRenderer {
-    abstract render(options: {
-        [key: string]: any;
-    }): VNode;
-}
+export declare type BubbleBoxRendererMatch = {
+    find: (messages: BubbleMessage[], contentIndex?: number) => boolean;
+    renderer: Component<BubbleBoxRendererProps>;
+    priority?: number;
+    attributes?: Record<string, string>;
+};
 
-export declare type BubbleContentFunctionRenderer = (options: {
-    [key: string]: any;
-}) => VNode;
+export declare type BubbleBoxRendererProps = Pick<BubbleProps, 'placement' | 'shape'>;
 
-export declare interface BubbleContentItem {
-    type: string;
-    [key: string]: any;
-}
+export declare type BubbleContentRendererMatch = {
+    find: (message: BubbleMessage, contentIndex?: number) => boolean;
+    renderer: Component<BubbleContentRendererProps>;
+    priority?: number;
+    attributes?: Record<string, string>;
+};
 
-export declare type BubbleContentRenderer = BubbleContentFunctionRenderer | BubbleContentClassRenderer | Component | {
-    component: Component;
-    defaultProps: Record<string, unknown>;
+export declare type BubbleContentRendererProps<T extends ChatMessageContent = ChatMessageContent, S extends Record<string, unknown> = Record<string, unknown>> = {
+    message: BubbleMessage<T, S>;
+    contentIndex?: number;
 };
 
+/**
+ * 自定义分组函数类型
+ */
+declare type BubbleGroupFunction = (messages: BubbleMessage[], dividerRole?: string) => BubbleMessageGroup[];
+
 declare const bubbleInstall: (app: App) => void;
 
 declare const BubbleList: typeof _default_19 & {
@@ -1994,56 +2016,79 @@ export { BubbleList as TrBubbleList }
 declare const bubbleListInstall: (app: App) => void;
 
 export declare interface BubbleListProps {
-    items: (BubbleProps & {
-        slots?: BubbleSlots;
-    })[];
+    messages: BubbleMessage[];
     /**
-     * 每个角色的默认配置项
+     * 分组策略：
+     * - 'consecutive': 连续相同角色的消息合并为一组
+     * - 'divider': 按分割角色分组（连续的分割角色在一组，其他消息在另一组）
+     * - 自定义函数: (messages, dividerRole) => BubbleMessageGroup[]
+     *
+     * 特殊情况：
+     * - 当 message 的 content 为数组时，该 message 会被单独作为一个独立分组
+     * - 该独立分组会被"密封"，后续的消息（即使角色相同）也不会被添加到这个分组中
      */
-    roles?: Record<string, BubbleRoleConfig>;
+    groupStrategy?: 'consecutive' | 'divider' | BubbleGroupFunction;
     /**
-     * 列表是否加载中
+     * 'divider' 策略的分割角色
+     * 具有此角色的消息将作为分割线
+     * @default 'user'
      */
-    loading?: boolean;
+    dividerRole?: string;
+    /**
+     * 当消息没有角色或角色为空时，使用此角色
+     * @default 'assistant'
+     */
+    fallbackRole?: string;
     /**
-     * 指定哪个角色可以有加载中状态
+     * 角色配置（头像、位置、形状）
+     */
+    roleConfigs?: Record<string, BubbleRoleConfig>;
+    contentRenderMode?: BubbleProps['contentRenderMode'];
+    /**
+     * 是否自动滚动到底部。需要满足以下条件：
+     * - BubbleList 是可滚动容器（需要 scrollHeight > clientHeight）
+     * - 滚动容器接近底部
+     *
+     * @default false
      */
-    loadingRole?: string;
     autoScroll?: boolean;
 }
 
-export declare class BubbleMarkdownContentRenderer extends BubbleContentClassRenderer {
-    readonly mdConfig: Options;
-    readonly dompurifyConfig: Config;
-    readonly sanitizeDisabled: boolean;
-    readonly defaultAttrs: Record<string, unknown>;
-    private md;
-    constructor(options?: BubbleMarkdownRendererOptions);
-    render(options: {
-        content?: string;
-        [key: string]: unknown;
-    }): VNode<RendererNode, RendererElement, {
-    [key: string]: any;
-    }>;
-}
+declare type BubbleListSlotProps = BubbleSlotProps & {
+    messageIndexes: number[];
+};
 
-declare interface BubbleMarkdownRendererOptions {
-    mdConfig?: Options;
-    dompurifyConfig?: Config;
-    sanitizeDisabled?: boolean;
-    defaultAttrs?: Record<string, unknown>;
+export declare interface BubbleListSlots {
+    prefix?: (slotProps: BubbleListSlotProps) => VNode | VNode[];
+    suffix?: (slotProps: BubbleListSlotProps) => VNode | VNode[];
+    after?: (slotProps: BubbleListSlotProps) => VNode | VNode[];
+    'content-footer'?: (slotProps: BubbleListSlotProps & {
+        contentIndex?: number;
+    }) => VNode | VNode[];
 }
 
-export declare interface BubbleProps extends BubbleCommonProps {
-    /**
-     * 气泡内容
-     */
-    content?: string | BubbleContentItem[];
-    id?: string | number | symbol;
-    role?: string;
+export declare type BubbleMessage<T extends ChatMessageContent = ChatMessageContent, S extends Record<string, unknown> = Record<string, unknown>> = ChatMessageWithOptionalRole<T> & {
+    id?: string;
     loading?: boolean;
-    aborted?: boolean;
-}
+    state?: S;
+};
+
+export declare type BubbleMessageGroup = {
+    role: string;
+    messages: BubbleMessage[];
+    messageIndexes: number[];
+    startIndex: number;
+};
+
+export declare type BubbleProps = BubbleMessage & {
+    hidden?: boolean;
+    avatar?: VNode | Component;
+    placement?: 'start' | 'end';
+    shape?: 'corner' | 'rounded' | 'none';
+    contentRenderMode?: 'single' | 'split';
+    fallbackBoxRenderer?: Component<BubbleBoxRendererProps>;
+    fallbackContentRenderer?: Component<BubbleContentRendererProps>;
+};
 
 declare const BubbleProvider: typeof _default_20 & {
     install: typeof bubbleProviderInstall;
@@ -2053,28 +2098,139 @@ export { BubbleProvider as TrBubbleProvider }
 
 declare const bubbleProviderInstall: (app: App) => void;
 
-export declare type BubbleRoleConfig = BubbleCommonProps & {
-    hidden?: boolean;
-    slots?: BubbleSlots;
+export declare interface BubbleProviderProps {
+    boxRendererMatches?: BubbleBoxRendererMatch[];
+    contentRendererMatches?: BubbleContentRendererMatch[];
+    fallbackBoxRenderer?: Component<BubbleBoxRendererProps>;
+    fallbackContentRenderer?: Component<BubbleContentRendererProps>;
+    initialStore?: Record<string, unknown>;
+}
+
+/**
+ * 气泡渲染器匹配优先级常量
+ *
+ * 用于定义不同类型渲染器的匹配优先级，数值越小优先级越高
+ *
+ * - LOADING: 通常基于 message.loading 判断。比如: `{ loading: true }`
+ * - NORMAL: 普通渲染器的默认优先级
+ * - CONTENT: 通常基于 message.content 判断。比如: `{ content: [{ type: 'image_url', image_url: 'xxx' }] }`
+ * - ROLE: 通常基于 message.role 判断。比如: `{ role: 'tool' }`
+ */
+export declare const BubbleRendererMatchPriority: {
+    readonly LOADING: -1;
+    readonly NORMAL: 0;
+    readonly CONTENT: 10;
+    readonly ROLE: 20;
+};
+
+export declare const BubbleRenderers: {
+    Box: {
+        new (...args: any[]): CreateComponentPublicInstanceWithMixins<Readonly<BubbleBoxRendererProps> & Readonly<{}>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, PublicProps, {}, false, {}, {}, GlobalComponents, GlobalDirectives, string, {}, HTMLDivElement, ComponentProvideOptions, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+        }, Readonly<BubbleBoxRendererProps> & Readonly<{}>, {}, {}, {}, {}, {}>;
+        __isFragment?: never;
+        __isTeleport?: never;
+        __isSuspense?: never;
+    } & ComponentOptionsBase<Readonly<BubbleBoxRendererProps> & Readonly<{}>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, {}, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & VNodeProps & AllowedComponentProps & ComponentCustomProps & (new () => {
+        $slots: {
+            default?(_: {}): any;
+        };
+    });
+    Image: DefineComponent<    {
+    message: BubbleMessage<ChatMessageContent, Record<string, unknown>>;
+    contentIndex?: number;
+    }, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{
+    message: BubbleMessage<ChatMessageContent, Record<string, unknown>>;
+    contentIndex?: number;
+    }> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLImageElement>;
+    Loading: DefineComponent<    {
+    message: BubbleMessage<ChatMessageContent, Record<string, unknown>>;
+    contentIndex?: number;
+    }, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{
+    message: BubbleMessage<ChatMessageContent, Record<string, unknown>>;
+    contentIndex?: number;
+    }> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
+    Markdown: DefineComponent<    {
+    message: BubbleMessage<ChatMessageContent, Record<string, unknown>>;
+    contentIndex?: number;
+    }, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{
+    message: BubbleMessage<ChatMessageContent, Record<string, unknown>>;
+    contentIndex?: number;
+    }> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+    Reasoning: DefineComponent<    {
+    message: BubbleMessage<ChatMessageContent, {
+    thinking?: boolean;
+    open?: boolean;
+    }>;
+    contentIndex?: number;
+    }, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{
+    message: BubbleMessage<ChatMessageContent, {
+    thinking?: boolean;
+    open?: boolean;
+    }>;
+    contentIndex?: number;
+    }> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+    Text: DefineComponent<    {
+    message: BubbleMessage<ChatMessageContent, Record<string, unknown>>;
+    contentIndex?: number;
+    }, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{
+    message: BubbleMessage<ChatMessageContent, Record<string, unknown>>;
+    contentIndex?: number;
+    }> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+    Tool: DefineComponent<BubbleContentRendererProps<ChatMessageContent, {
+    toolCall?: Record<string, {
+    status?: "success" | "running" | "failed" | "cancelled";
+    open?: boolean;
+    }>;
+    }> & {
+    toolIndex: number;
+    }, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<BubbleContentRendererProps<ChatMessageContent, {
+    toolCall?: Record<string, {
+    status?: "success" | "running" | "failed" | "cancelled";
+    open?: boolean;
+    }>;
+    }> & {
+    toolIndex: number;
+    }> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
+    ToolRole: DefineComponent<    {
+    message: BubbleMessage<string, Record<string, unknown>>;
+    contentIndex?: number;
+    }, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{
+    message: BubbleMessage<string, Record<string, unknown>>;
+    contentIndex?: number;
+    }> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+    Tools: DefineComponent<    {
+    message: BubbleMessage<ChatMessageContent, Record<string, unknown>>;
+    contentIndex?: number;
+    }, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{
+    message: BubbleMessage<ChatMessageContent, Record<string, unknown>>;
+    contentIndex?: number;
+    }> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+};
+
+/**
+ * 角色配置
+ * 用于配置不同角色的气泡样式
+ */
+export declare type BubbleRoleConfig = Pick<BubbleProps, 'avatar' | 'placement' | 'shape' | 'hidden' | 'fallbackBoxRenderer' | 'fallbackContentRenderer'>;
+
+declare type BubbleSlotProps = {
+    messages: BubbleMessage[];
+    role?: string;
 };
 
 export declare interface BubbleSlots {
-    default?: (slotProps: {
-        bubbleProps: BubbleProps;
-        index?: number;
-    }) => unknown;
-    footer?: (slotProps: {
-        bubbleProps: BubbleProps;
-        index?: number;
-    }) => unknown;
-    loading?: (slotProps: {
-        bubbleProps: BubbleProps;
-        index?: number;
-    }) => unknown;
-    trailer?: (slotProps: {
-        bubbleProps: BubbleProps;
-        index?: number;
-    }) => unknown;
+    prefix?: (slotProps: BubbleSlotProps) => VNode | VNode[];
+    suffix?: (slotProps: BubbleSlotProps) => VNode | VNode[];
+    after?: (slotProps: BubbleSlotProps) => VNode | VNode[];
+    'content-footer'?: (slotProps: BubbleSlotProps & {
+        contentIndex?: number;
+    }) => VNode | VNode[];
 }
 
 export declare interface ButtonGroupConfig {
@@ -2083,6 +2239,29 @@ export declare interface ButtonGroupConfig {
     voice?: VoiceButtonConfig;
 }
 
+/**
+ * 聊天消息接口（支持 OpenAI 格式）
+ */
+declare interface ChatMessage<T extends ChatMessageContent = ChatMessageContent> {
+    role: string;
+    content?: T;
+    reasoning_content?: string;
+    tool_calls?: ToolCall[];
+    tool_call_id?: string;
+    name?: string;
+}
+
+export declare type ChatMessageContent = string | ChatMessageContentItem[];
+
+export declare type ChatMessageContentItem = {
+    type: string;
+    [key: string]: any;
+};
+
+declare type ChatMessageWithOptionalRole<T extends ChatMessageContent = ChatMessageContent> = Omit<ChatMessage<T>, 'role'> & {
+    role?: string;
+};
+
 export declare type ColorMode = 'light' | 'dark' | 'auto';
 
 export declare interface ContainerEmits {
@@ -2189,9 +2368,7 @@ variant: DisplayVariant;
 
 declare const _default_18: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 
-declare const _default_19: DefineComponent<BubbleListProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<BubbleListProps> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {
-scrollContainerRef: HTMLDivElement;
-}, HTMLDivElement>;
+declare const _default_19: __VLS_WithTemplateSlots_2<typeof __VLS_component_2, __VLS_TemplateResult_2["slots"]>;
 
 declare const _default_2: typeof _default_17 & {
     install: typeof install;
@@ -2199,15 +2376,15 @@ declare const _default_2: typeof _default_17 & {
 export { _default_2 as Attachments }
 export { _default_2 as TrAttachments }
 
-declare const _default_20: __VLS_WithTemplateSlots_2<typeof __VLS_component_2, __VLS_TemplateResult_2["slots"]>;
+declare const _default_20: __VLS_WithTemplateSlots_3<typeof __VLS_component_3, __VLS_TemplateResult_3["slots"]>;
 
-declare const _default_21: __VLS_WithTemplateSlots_3<typeof __VLS_component_3, __VLS_TemplateResult_3["slots"]>;
+declare const _default_21: __VLS_WithTemplateSlots_4<typeof __VLS_component_4, __VLS_TemplateResult_4["slots"]>;
 
 declare const _default_22: DefineComponent<    {}, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, any>;
 
-declare const _default_23: __VLS_WithTemplateSlots_4<typeof __VLS_component_4, __VLS_TemplateResult_4["slots"]>;
+declare const _default_23: __VLS_WithTemplateSlots_5<typeof __VLS_component_5, __VLS_TemplateResult_5["slots"]>;
 
-declare const _default_24: __VLS_WithTemplateSlots_5<typeof __VLS_component_5, __VLS_TemplateResult_5["slots"]>;
+declare const _default_24: __VLS_WithTemplateSlots_6<typeof __VLS_component_6, __VLS_TemplateResult_6["slots"]>;
 
 declare const _default_25: DefineComponent<FeedbackProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
 action: (name: string) => any;
@@ -2244,7 +2421,7 @@ declare const _default_28: DefineComponent<PromptProps, {}, {}, {}, {}, Componen
 size: "small" | "medium" | "large";
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
 
-declare const _default_29: __VLS_WithTemplateSlots_6<typeof __VLS_component_6, __VLS_TemplateResult_6["slots"]>;
+declare const _default_29: __VLS_WithTemplateSlots_7<typeof __VLS_component_7, __VLS_TemplateResult_7["slots"]>;
 
 declare const _default_3: typeof _default_21 & {
     install: typeof install_2;
@@ -2252,17 +2429,17 @@ declare const _default_3: typeof _default_21 & {
 export { _default_3 as Container }
 export { _default_3 as TrContainer }
 
-declare const _default_30: __VLS_WithTemplateSlots_7<typeof __VLS_component_7, __VLS_TemplateResult_7["slots"]>;
+declare const _default_30: __VLS_WithTemplateSlots_8<typeof __VLS_component_8, __VLS_TemplateResult_8["slots"]>;
 
-declare const _default_31: __VLS_WithTemplateSlots_8<typeof __VLS_component_8, __VLS_TemplateResult_8["slots"]>;
+declare const _default_31: __VLS_WithTemplateSlots_9<typeof __VLS_component_9, __VLS_TemplateResult_9["slots"]>;
 
-declare const _default_32: __VLS_WithTemplateSlots_9<typeof __VLS_component_9, __VLS_TemplateResult_9["slots"]>;
+declare const _default_32: __VLS_WithTemplateSlots_10<typeof __VLS_component_10, __VLS_TemplateResult_10["slots"]>;
 
-declare const _default_33: __VLS_WithTemplateSlots_10<typeof __VLS_component_10, __VLS_TemplateResult_10["slots"]>;
+declare const _default_33: __VLS_WithTemplateSlots_11<typeof __VLS_component_11, __VLS_TemplateResult_11["slots"]>;
 
-declare const _default_34: __VLS_WithTemplateSlots_11<typeof __VLS_component_11, __VLS_TemplateResult_11["slots"]>;
+declare const _default_34: __VLS_WithTemplateSlots_12<typeof __VLS_component_12, __VLS_TemplateResult_12["slots"]>;
 
-declare const _default_35: __VLS_WithTemplateSlots_12<typeof __VLS_component_12, __VLS_TemplateResult_12["slots"]>;
+declare const _default_35: __VLS_WithTemplateSlots_13<typeof __VLS_component_13, __VLS_TemplateResult_13["slots"]>;
 
 declare const _default_36: DefineComponent<__VLS_PublicProps_6, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
 "update:visible": (value: boolean) => any;
@@ -3191,6 +3368,19 @@ export declare type ThemeStorage = Pick<Storage, 'getItem' | 'setItem'>;
  */
 export declare type ThemeType = 'light' | 'dark';
 
+/**
+ * 工具调用接口（支持 OpenAI 格式）
+ */
+declare interface ToolCall {
+    id: string;
+    type: 'function' | string;
+    function: {
+        name: string;
+        arguments: string;
+    };
+    [x: string]: any;
+}
+
 declare interface TooltipContentProps {
     show?: boolean;
     content: string;
@@ -3209,6 +3399,43 @@ export declare interface UrlAttachment extends BaseAttachment {
     rawFile?: File;
 }
 
+/**
+ * 当目标滚动容器 `target` 接近底部时，且源数据 `source` 变化，自动滚动到底部
+ * @param target 目标滚动容器的元素引用
+ * @param source 监听的源数据，当该数据变化时会触发自动滚动
+ * @param options 配置选项
+ * @param options.scrollOnMount 是否在组件挂载时滚动到底部，默认为 true
+ * @param options.bottomThreshold 判断接近底部的阈值（像素），默认为 20
+ * @returns scrollToBottom 手动滚动到底部的方法
+ */
+export declare function useAutoScroll(target: MaybeComputedElementRef, source: MaybeRefOrGetter<any>, options?: {
+    scrollOnMount?: boolean;
+    scrollThrottle?: number;
+    bottomThreshold?: number;
+}): {
+    scrollToBottom: (behavior?: ScrollBehavior) => Promise<void>;
+};
+
+export declare function useBubbleBoxRenderer(messages: MaybeRefOrGetter<BubbleMessage[]>, contentIndex?: number): ComputedRef<{
+    renderer: Component;
+    attributes?: Record<string, string>;
+}>;
+
+export declare function useBubbleContentRenderer(message: MaybeRefOrGetter<BubbleMessage>, contentIndex?: number): ComputedRef<Component>;
+
+export declare function useBubbleStateChangeFn(): (key: string, _value: unknown) => void;
+
+/**
+ * Omit specified fields from message and return computed props
+ * @param props - The original props containing the message
+ * @param fields - Array of field names to omit from the message
+ * @returns An object containing restMessage and restProps computed refs
+ */
+export declare function useOmitMessageFields<P extends BubbleContentRendererProps, K extends keyof BubbleMessage>(props: P, fields: K[]): {
+    restMessage: ComputedRef<Omit<BubbleMessage, K>>;
+    restProps: ComputedRef<P>;
+};
+
 export declare type UserItem = UserTextItem | UserTemplateItem;
 
 export declare type UserTemplateItem = Omit<Pick<TemplateItem, 'type' | 'content'>, 'id'> & {