@blueking/chat-x 0.0.47-beta.4 → 0.0.49-beta.1

package/dist/ag-ui/types/file.d.ts

@@ -0,0 +1,23 @@
+export declare enum AIFileType {
+    Html = "html",
+    Jpg = "jpg",
+    Json = "json",
+    /** 后台扩展名别名，与 Markdown 等价 */
+    Md = "md",
+    Markdown = "markdown",
+    Pdf = "pdf",
+    Txt = "txt"
+}
+export type AIFileInfo = {
+    name: string;
+    outputId: string;
+    size: number;
+    type: AIFileType;
+};
+/** 点击文件产物后异步获取的下载 / 预览地址（snake_case） */
+export type ArtifactUrlResult = {
+    download_url?: string;
+    preview_url?: string;
+};
+/** 异步获取文件产物下载 / 预览链接 */
+export type OnArtifactClick = (file: AIFileInfo) => Promise<ArtifactUrlResult>;

package/dist/ag-ui/types/index.d.ts

@@ -1,5 +1,6 @@
 export * from './constants';
 export * from './contents';
+export * from './file';
 export * from './interrupt';
 export * from './messages';
 export * from './schema';

package/dist/ag-ui/types/messages.d.ts

@@ -1,6 +1,7 @@
 import type { OldShortcut, Shortcut } from '../../types';
 import type { MessageContentType, MessageRole, MessageStatus } from './constants';
 import type { ContentMap, InputContent } from './contents';
+import type { AIFileInfo } from './file';
 import type { InterruptMessage } from './interrupt';
 export interface ActivityMessage extends BaseMessage<MessageRole.Activity, ContentMap[MessageContentType.FlowAgent] | ContentMap[MessageContentType.KnowledgeRag] | ContentMap[MessageContentType.ReferenceDocument]> {
     activityType: MessageContentType.FlowAgent | MessageContentType.KnowledgeRag | MessageContentType.ReferenceDocument | string;
@@ -21,6 +22,7 @@ export interface BaseMessage<T extends MessageType, C = string> {
     status: MessageStatus;
     uid?: string;
     property?: {
+        artifacts?: AIFileInfo[];
         extra?: {
             cite: {
                 data: {

package/dist/components/chat-input/chat-input.vue.d.ts

@@ -1,14 +1,17 @@
 import { type Interrupt, type InterruptResume, type UserMessage, MessageContentType, MessageStatus } from '../../ag-ui/types';
 import { type AITippyProps, type IAiSlashMenuItem, type ISkillListItem, type Shortcut, type TagSchema, type UploadFile, UploadStatus } from '../../types';
+import type { IModelOption } from './model-selector';
 export type ChatInputEmits = {
     (e: 'selectShortcut', shortcut: Shortcut): void;
     (e: 'deleteShortcut'): void;
     (e: 'update:modelValue', value: string | TagSchema, selectedResourceList: IAiSlashMenuItem[]): void;
+    (e: 'modelChange', model: IModelOption): void;
 };
 export type ChatInputProps = {
     defaultUploadFiles?: UploadFile[];
     inputMaxHeight?: number;
     messageStatus?: MessageStatus;
+    models?: IModelOption[];
     modelValue: string | TagSchema;
     onSendMessage?: (message: UserMessage['content'], docSchema: TagSchema, options?: {
         interrupt?: Interrupt;
@@ -31,6 +34,7 @@ export type ChatInputProps = {
 type __VLS_Props = ChatInputProps;
 type __VLS_ModelProps = {
     'cite'?: string;
+    'selectedModel'?: string;
 };
 type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
 declare var __VLS_1: {}, __VLS_3: {}, __VLS_5: {}, __VLS_14: {
@@ -55,7 +59,10 @@ declare var __VLS_1: {}, __VLS_3: {}, __VLS_5: {}, __VLS_14: {
         } | undefined;
         status?: UploadStatus | undefined;
     }[];
-}, __VLS_51: {}, __VLS_75: {};
+}, __VLS_51: {}, __VLS_75: {
+    models: IModelOption[] | undefined;
+    selectedModel: string | undefined;
+}, __VLS_85: {};
 type __VLS_Slots = {} & {
     top?: (props: typeof __VLS_1) => any;
 } & {
@@ -67,13 +74,16 @@ type __VLS_Slots = {} & {
 } & {
     attachment?: (props: typeof __VLS_51) => any;
 } & {
-    'send-icon'?: (props: typeof __VLS_75) => any;
+    'model-selector'?: (props: typeof __VLS_75) => any;
+} & {
+    'send-icon'?: (props: typeof __VLS_85) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {
     focus: () => void;
     triggerSendMessage: () => Promise<void>;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:cite": (value: string) => any;
+    "update:selectedModel": (value: string | undefined) => any;
 } & {
     "update:modelValue": (value: string | ({
         text: string;
@@ -88,6 +98,7 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {
     })[][], selectedResourceList: IAiSlashMenuItem[]) => any;
     selectShortcut: (shortcut: Shortcut) => any;
     deleteShortcut: () => any;
+    modelChange: (model: IModelOption) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: string | ({
         text: string;
@@ -102,7 +113,9 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {
     })[][], selectedResourceList: IAiSlashMenuItem[]) => any) | undefined;
     onSelectShortcut?: ((shortcut: Shortcut) => any) | undefined;
     onDeleteShortcut?: (() => any) | undefined;
+    onModelChange?: ((model: IModelOption) => any) | undefined;
     "onUpdate:cite"?: ((value: string) => any) | undefined;
+    "onUpdate:selectedModel"?: ((value: string | undefined) => any) | undefined;
 }>, {
     placeholder: string;
     prompts: string[];

package/dist/components/chat-input/input-attachment/input-attachment.vue.d.ts

@@ -6,11 +6,13 @@ type __VLS_Props = {
     sendDisabledTip?: string;
     tippyOptions?: AITippyProps;
 };
-declare var __VLS_1: {}, __VLS_3: {};
+declare var __VLS_1: {}, __VLS_3: {}, __VLS_5: {};
 type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_1) => any;
 } & {
-    'send-icon'?: (props: typeof __VLS_3) => any;
+    'before-send'?: (props: typeof __VLS_3) => any;
+} & {
+    'send-icon'?: (props: typeof __VLS_5) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
     sendMessage: () => any;

package/dist/components/chat-input/model-selector/capabilities.d.ts

@@ -0,0 +1,3 @@
+import type { IModelCapability, IModelOption } from './types';
+/** 根据模型 property 派生能力标签列表（仅保留已开启的能力，文案走 i18n） */
+export declare const resolveModelCapabilities: (model: IModelOption) => IModelCapability[];

package/dist/components/chat-input/model-selector/index.d.ts

@@ -0,0 +1,3 @@
+export { default as ModelSelector } from './model-selector.vue';
+export type { IModelCapability, IModelOption, IModelProperty, ModelCapabilityTheme } from './types';
+export { useModelSelector } from './use-model-selector';

package/dist/components/chat-input/model-selector/model-selector-panel.vue.d.ts

@@ -0,0 +1,26 @@
+import type { IModelOption } from './types';
+type __VLS_Props = {
+    /** 待展示的模型列表（已按关键字过滤） */
+    models: IModelOption[];
+    /** 搜索框占位文案 */
+    searchPlaceholder?: string;
+    /** 当前选中模型的 llm_name */
+    selectedName?: string;
+};
+type __VLS_ModelProps = {
+    /** 搜索关键字（受控，回传给容器交由 composable 过滤） */
+    'keyword'?: string;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {
+    focusSearch: () => void;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:keyword": (value: string) => any;
+} & {
+    select: (model: IModelOption) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    onSelect?: ((model: IModelOption) => any) | undefined;
+    "onUpdate:keyword"?: ((value: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/chat-input/model-selector/model-selector-trigger.vue.d.ts

@@ -0,0 +1,14 @@
+import type { IModelOption } from './types';
+type __VLS_Props = {
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 是否展开（下拉打开），用于箭头翻转与背景态 */
+    expanded?: boolean;
+    /** 当前选中的模型 */
+    model?: IModelOption;
+    /** 无选中时的占位文案 */
+    placeholder?: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/chat-input/model-selector/model-selector.vue.d.ts

@@ -0,0 +1,39 @@
+import { type TippyOptions } from 'vue-tippy';
+import type { IModelOption } from './types';
+import 'tippy.js/dist/tippy.css';
+type __VLS_Props = {
+    /** 是否禁用整个选择器 */
+    disabled?: boolean;
+    /** 模型列表 */
+    models?: IModelOption[];
+    /** trigger 无选中时的占位文案 */
+    placeholder?: string;
+    /** 搜索框占位文案 */
+    searchPlaceholder?: string;
+    /** 透传给 tippy 的额外配置 */
+    tippyOptions?: Partial<Omit<TippyOptions, 'getReferenceClientRect' | 'triggerTarget'>>;
+};
+type __VLS_ModelProps = {
+    /** 当前选中的模型（值为 llm_name，v-model） */
+    modelValue?: string;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: string | undefined) => any;
+} & {
+    change: (model: IModelOption) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    onChange?: ((model: IModelOption) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: string | undefined) => any) | undefined;
+}>, {
+    placeholder: string;
+    searchPlaceholder: string;
+    tippyOptions: Partial<Omit<Partial<Omit<import("tippy.js").Props, "content" | "triggerTarget" | "getReferenceClientRect"> & {
+        content: import("vue-tippy").TippyContent;
+        triggerTarget: import("vue-tippy").TippyTarget;
+        getReferenceClientRect: null | (() => DOMRect & any);
+    }>, "triggerTarget" | "getReferenceClientRect">>;
+    models: IModelOption[];
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/chat-input/model-selector/types.d.ts

@@ -0,0 +1,61 @@
+/** 模型能力标签，如「图生文」「深度思考」「快速思考」（由组件依据 property 派生，走内置 i18n） */
+export interface IModelCapability {
+    /** 标签文案 */
+    text: string;
+    /** 语义主题，决定标签配色，缺省为 default */
+    theme?: ModelCapabilityTheme;
+}
+/** 模型选项（贴合后端模型接口结构） */
+export interface IModelOption {
+    /** 基础模型标识，如 deepseek */
+    base_model?: string;
+    /** 模型描述，作为选项 hover 的 title 提示 */
+    description?: string;
+    /** 是否禁用（前端扩展字段，后端无此字段时默认不禁用） */
+    disabled?: boolean;
+    /** 模型图标地址 */
+    icon?: string;
+    /** 模型主键 id */
+    id: number;
+    /** 模型编码 */
+    llm_code: string;
+    /** 模型展示名，同时作为选中值（v-model:selectedModel） */
+    llm_name: string;
+    /** 模型类型，如 chat.completion */
+    llm_type: string;
+    /** 最大 token 数 */
+    max_token_size: number;
+    /** 模型能力属性，用于派生能力标签 */
+    property: IModelProperty;
+    /** 空间维度鉴权模式，如 APPLY */
+    space_auth_mode: string;
+    /** 标签名列表 */
+    tag_names?: string[];
+    /** 用户维度鉴权模式，如 PUBLIC */
+    user_auth_mode: string;
+}
+/** 模型属性（后端 property 字段），描述模型支持的能力开关与运行参数 */
+export interface IModelProperty {
+    /** 智能体类型，如 openai */
+    agent_type?: string;
+    /** 是否为默认模型 */
+    default?: boolean;
+    /** 是否自建部署 */
+    is_self_host?: boolean;
+    /** 模型最大上下文长度 */
+    max_model_len?: number;
+    /** 是否支持摘要 */
+    support_summary?: boolean;
+    /** 是否支持深度思考 */
+    support_thinking?: boolean;
+    /** 是否支持快速思考 */
+    support_thinking_quick?: boolean;
+    /** 是否支持工具调用 */
+    support_tools?: boolean;
+    /** 是否支持图生文（视觉） */
+    support_vision?: boolean;
+    /** 是否支持上下文窗口 */
+    support_window?: boolean;
+}
+/** 模型能力标签的语义主题，决定标签配色（与设计稿语义色一一对应） */
+export type ModelCapabilityTheme = 'default' | 'primary' | 'success' | 'warning';

package/dist/components/chat-input/model-selector/use-model-selector.d.ts

@@ -0,0 +1,17 @@
+import { type ComputedRef, type Ref } from 'vue';
+import type { IModelOption } from './types';
+/**
+ * 模型选择的纯数据逻辑（与 UI 解耦，可独立单测）：
+ * 仅负责「按关键字过滤」与「解析当前选中模型」，不持有任何展示/交互态。
+ */
+export declare const useModelSelector: (params: {
+    /** 模型列表 */
+    models: ComputedRef<IModelOption[]> | Ref<IModelOption[]>;
+    /** 当前选中模型（值为 llm_name） */
+    selectedModel: Ref<string | undefined>;
+}) => {
+    keyword: import("vue").ShallowRef<string, string>;
+    filteredModels: ComputedRef<IModelOption[]>;
+    currentModel: ComputedRef<IModelOption | undefined>;
+    resetKeyword: () => void;
+};

package/dist/components/chat-message/assistant-message/message-artifacts/artifact-file-card.vue.d.ts

@@ -0,0 +1,14 @@
+import type { AIFileInfo } from '../../../../ag-ui/types/file';
+import 'tippy.js/dist/tippy.css';
+type __VLS_Props = {
+    active?: boolean;
+    file: AIFileInfo;
+    index?: number;
+    messageUid?: string;
+    onDownload?: (file: AIFileInfo) => void;
+    onPreview?: (file: AIFileInfo) => void;
+    variant?: 'card' | 'list';
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/chat-message/assistant-message/message-artifacts/artifact-preview/artifact-preview-host.vue.d.ts

@@ -0,0 +1,8 @@
+import type { AIFileInfo } from '../../../../../ag-ui/types/file';
+import type { SessionArtifact } from '../../../../../composables/use-artifact-preview';
+type __VLS_Props = {
+    file?: AIFileInfo | SessionArtifact;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/chat-message/assistant-message/message-artifacts/artifact-preview/preview-strategy.d.ts

@@ -0,0 +1,9 @@
+import { AIFileType } from '../../../../../ag-ui/types/file';
+export type ArtifactPreviewLoadStrategy = 'preview_url_iframe' | 'text_from_download';
+export type ArtifactPreviewRendererKind = 'html' | 'markdown' | 'txt' | 'urlIframe';
+export type ArtifactPreviewStrategy = {
+    load: ArtifactPreviewLoadStrategy;
+    renderer: ArtifactPreviewRendererKind;
+};
+/** 按文件类型解析预览加载策略与渲染器；未单独注册的类型默认 preview_url iframe */
+export declare const getArtifactPreviewStrategy: (type: AIFileType) => ArtifactPreviewStrategy;

package/dist/components/chat-message/assistant-message/message-artifacts/artifact-preview/renderers/html-preview.vue.d.ts

@@ -0,0 +1,6 @@
+type __VLS_Props = {
+    content: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/chat-message/assistant-message/message-artifacts/artifact-preview/renderers/markdown-preview.vue.d.ts

@@ -0,0 +1,6 @@
+type __VLS_Props = {
+    content: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/chat-message/assistant-message/message-artifacts/artifact-preview/renderers/txt-preview.vue.d.ts

@@ -0,0 +1,6 @@
+type __VLS_Props = {
+    content: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/chat-message/assistant-message/message-artifacts/artifact-preview/renderers/url-iframe-preview.vue.d.ts

@@ -0,0 +1,6 @@
+type __VLS_Props = {
+    url: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/chat-message/assistant-message/message-artifacts/artifact-preview/use-artifact-preview-loader.d.ts

@@ -0,0 +1,21 @@
+import type { AIFileInfo, ArtifactUrlResult } from '../../../../../ag-ui/types/file';
+import type { ArtifactPreviewRendererKind } from './preview-strategy';
+export type ArtifactPreviewPayload = {
+    content: string;
+    previewUrl: string;
+    renderer: ArtifactPreviewRendererKind;
+    status: ArtifactPreviewStatus;
+};
+export type ArtifactPreviewStatus = 'empty' | 'error' | 'idle' | 'loading' | 'ready';
+export declare const useArtifactPreviewLoader: (options: {
+    canResolve: () => boolean;
+    getFile: () => AIFileInfo | undefined;
+    resolveUrls: (file: AIFileInfo) => Promise<ArtifactUrlResult>;
+}) => {
+    content: import("vue").ShallowRef<string, string>;
+    dispose: () => void;
+    load: () => Promise<void>;
+    previewUrl: import("vue").ShallowRef<string, string>;
+    renderer: import("vue").ShallowRef<ArtifactPreviewRendererKind, ArtifactPreviewRendererKind>;
+    status: import("vue").ShallowRef<ArtifactPreviewStatus, ArtifactPreviewStatus>;
+};

package/dist/components/chat-message/assistant-message/message-artifacts/file-artifact-panel.vue.d.ts

@@ -0,0 +1,12 @@
+import type { SessionArtifact } from '../../../../composables/use-artifact-preview';
+type __VLS_Props = {
+    activeId: string;
+    artifacts: SessionArtifact[];
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    select: (id: string) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSelect?: ((id: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/chat-message/assistant-message/message-artifacts/file-icon.d.ts

@@ -0,0 +1,29 @@
+import { AIFileType } from '../../../../ag-ui/types/file';
+/** 文件类型 → 图标映射；未命中类型兜底用文本图标 */
+export declare const FILE_ICON_MAP: {
+    readonly html: import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+        [key: string]: any;
+    }>;
+    readonly jpg: import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+        [key: string]: any;
+    }>;
+    readonly json: import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+        [key: string]: any;
+    }>;
+    readonly md: import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+        [key: string]: any;
+    }>;
+    readonly markdown: import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+        [key: string]: any;
+    }>;
+    readonly pdf: import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+        [key: string]: any;
+    }>;
+    readonly txt: import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+        [key: string]: any;
+    }>;
+};
+/** 图标为共享 VNode，克隆后再渲染，避免同类型多处复用同一实例 */
+export declare const getFileIcon: (type: AIFileType) => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>;

package/dist/components/chat-message/assistant-message/message-artifacts/message-artifacts.vue.d.ts

@@ -0,0 +1,10 @@
+import type { AIFileInfo } from '../../../../ag-ui/types/file';
+type __VLS_Props = {
+    artifacts: AIFileInfo[];
+    messageUid?: string;
+    onDownload?: (file: AIFileInfo) => void;
+    onPreview?: (file: AIFileInfo) => void;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/chat-message/message-container/message-container.vue.d.ts

@@ -14,6 +14,7 @@ export type MessageContainerProps = {
     messageGroups: MessageGroup[];
     messages: Message[];
     messageStatus?: MessageStatus;
+    messageTools?: IToolBtn[];
     messageToolsStatus?: MessageToolsStatus;
     messageToolsTippyOptions?: MessageToolsProps['tippyOptions'];
     onAgentAction?: AgentActionCallback;
@@ -21,6 +22,7 @@ export type MessageContainerProps = {
     onInterruptResume?: OnInterruptResume;
     onUserAction?: UserActionCallback;
     renderMode?: RenderMode;
+    updateTools?: IToolBtn[];
 } & {
     onUserInputConfirm?: (message: Message, content: UserMessage['content'], docSchema: TagSchema) => Promise<void>;
     onUserShortcutConfirm?: (message: Message, formModel: Record<string, unknown>) => Promise<void>;

package/dist/components/index.d.ts

@@ -8,7 +8,9 @@ import ChatContainer from './chat-container/chat-container.vue';
 import commonErrorContent from './chat-content/common-error-content/common-error-content.vue';
 import ContentRender from './chat-content/content-render/content-render.vue';
 import ChatInput from './chat-input/chat-input.vue';
+import { ModelSelector } from './chat-input/model-selector';
 export * from './chat-content';
+export type { IModelCapability, IModelOption, IModelProperty, ModelCapabilityTheme } from './chat-input/model-selector';
 import MessageContainer from './chat-message/message-container/message-container.vue';
 import MessageRender from './chat-message/message-render/message-render.vue';
 import ExecutionSummary from './execution-summary/execution-summary.vue';
@@ -23,4 +25,4 @@ import SelectionFooter from './selection-footer/selection-footer.vue';
 import ToolCallRender from './tool-call/toolcall-render/toolcall-render.vue';
 export * from './chat-message/interrupt-message';
 export * from './markdown-token';
-export { AiImage, AiLoading, AiSelection, ChatContainer, ChatInput, commonErrorContent, ContentRender, ExecutionSummary, HighlightKeyword, ImagePreview, ImagePreviewGroup, MessageContainer, MessageLoading, MessageRender, MessageTools, MessageUserFeedback, ScrollBtn, SelectionFooter, ShortcutBtn, ShortcutBtns, ShortcutRender, ToolCallRender, };
+export { AiImage, AiLoading, AiSelection, ChatContainer, ChatInput, commonErrorContent, ContentRender, ExecutionSummary, HighlightKeyword, ImagePreview, ImagePreviewGroup, MessageContainer, MessageLoading, MessageRender, MessageTools, MessageUserFeedback, ModelSelector, ScrollBtn, SelectionFooter, ShortcutBtn, ShortcutBtns, ShortcutRender, ToolCallRender, };

package/dist/composables/index.d.ts

@@ -1,4 +1,5 @@
 export * from './use-animation-text';
+export * from './use-artifact-preview';
 export * from './use-clipboard';
 export * from './use-command-selection';
 export * from './use-container-scroll';

package/dist/composables/use-artifact-preview.d.ts

@@ -0,0 +1,59 @@
+import { type ComputedRef, type Ref } from 'vue';
+import type { AIFileInfo, ArtifactUrlResult, OnArtifactClick } from '../ag-ui/types/file';
+/** 文件产物预览 Provider/Consumer 通信 token */
+export declare const ARTIFACT_PREVIEW_TOKEN: unique symbol;
+/** 文件产物侧栏 Tab 的保留唯一标识（固定 Tab，不可关闭） */
+export declare const FILE_ARTIFACT_TAB_NAME = "file-artifact";
+export type OpenArtifactPreviewPayload = {
+    /** 被点击的文件 */
+    file: AIFileInfo;
+    /** 文件在所属消息 artifacts 中的下标 */
+    index: number;
+    /** 所属 AssistantMessage 的 uid */
+    messageUid: string;
+};
+/**
+ * 会话级文件产物：在 AIFileInfo 基础上补充命中所需的唯一 id 与所属消息。
+ * 由于同一会话可能出现「多个 AssistantMessage + 同名文件」，文件名不可作为唯一键，
+ * 统一用 messageUid + 消息内下标 + outputId 组合出全局唯一 id。
+ */
+export type SessionArtifact = AIFileInfo & {
+    artifactId: string;
+    messageUid: string;
+};
+type ArtifactPreviewContext = {
+    /** 当前命中的文件 id */
+    activeArtifactId: Ref<string>;
+    /** 是否具备异步取链能力（有 onArtifactClick 时下载按钮可见） */
+    canResolveArtifactUrl: ComputedRef<boolean>;
+    /** 由文件卡片触发：命中文件并弹出/切换到文件产物侧栏 */
+    openPreview: (payload: OpenArtifactPreviewPayload) => void;
+    /** 按 outputId 缓存并解析 download_url / preview_url */
+    resolveArtifactUrls: (file: AIFileInfo) => Promise<ArtifactUrlResult>;
+    /** 直接设置命中文件 id（侧栏列表内切换用） */
+    setActiveArtifactId: (id: string) => void;
+};
+/** 统一的文件产物唯一 id 生成规则，Provider 与文件卡片两侧必须一致 */
+export declare const buildArtifactId: (messageUid: string, index: number, outputId: string) => string;
+/** 通过临时 <a> 触发浏览器下载 */
+export declare const triggerArtifactDownload: (url: string, fileName: string) => void;
+/**
+ * 文件产物预览 Provider（在 ChatContainer 内使用）。
+ * 维护「命中文件」状态，并封装 onArtifactClick 的 URL 解析与按 outputId 缓存；
+ * 打开侧栏 Tab 的副作用由外部 onOpen 注入。
+ */
+export declare const useArtifactPreviewProvider: (options: {
+    /** 读取业务侧异步取链回调（用 getter 保持对 props 变更敏感） */
+    getOnArtifactClick?: () => OnArtifactClick | undefined;
+    /** 命中文件后触发：由容器负责 addCustomTab + 展开侧栏 + 选中 Tab */
+    onOpen: (artifactId: string) => void;
+}) => {
+    activeArtifactId: import("vue").ShallowRef<string, string>;
+    canResolveArtifactUrl: ComputedRef<boolean>;
+    openPreview: (payload: OpenArtifactPreviewPayload) => void;
+    resolveArtifactUrls: (file: AIFileInfo) => Promise<ArtifactUrlResult>;
+    setActiveArtifactId: (id: string) => void;
+};
+/** 文件产物预览 Consumer（在深层文件卡片中使用），无 Provider 时返回 undefined 兜底 */
+export declare const useArtifactPreviewConsumer: () => ArtifactPreviewContext | undefined;
+export {};