@blueking/chat-x 0.0.48-beta.1 → 0.0.49-beta.10

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

@@ -49,6 +49,7 @@ export declare enum MessageRole {
 }
 export declare enum MessageStatus {
     Complete = "complete",
+    Completed = "completed",
     Disabled = "disabled",
     Error = "error",
     Fetching = "fetching",// 请求中

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

@@ -0,0 +1,13 @@
+export type AIFileInfo = {
+    name: string;
+    outputId: string;
+    size: number;
+    type: string;
+};
+/** 点击文件产物后异步获取的下载 / 预览地址（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;
@@ -14,6 +15,8 @@ declare global {
 }
 export interface BaseMessage<T extends MessageType, C = string> {
     content: C;
+    /** 消息创建时间，ISO 字符串或毫秒时间戳，由消息层（chat-helper）写入 */
+    createdAt?: number | string;
     id: number | string;
     messageId: number | string;
     name?: string;
@@ -21,6 +24,7 @@ export interface BaseMessage<T extends MessageType, C = string> {
     status: MessageStatus;
     uid?: string;
     property?: {
+        artifacts?: AIFileInfo[];
         extra?: {
             cite: {
                 data: {

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

@@ -1,11 +1,22 @@
 import type { AssistantMessage } from '../../../ag-ui/types/messages';
+interface AssistantMessageProps {
+    content?: string;
+    id?: AssistantMessage['id'];
+    messageId?: AssistantMessage['messageId'];
+    name?: AssistantMessage['name'];
+    property?: AssistantMessage['property'];
+    role?: AssistantMessage['role'];
+    status?: AssistantMessage['status'];
+    toolCalls?: AssistantMessage['toolCalls'];
+    uid?: AssistantMessage['uid'];
+}
 declare var __VLS_1: {
     content: string;
 };
 type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_1) => any;
 };
-declare const __VLS_base: import("vue").DefineComponent<Partial<AssistantMessage>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<Partial<AssistantMessage>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_base: import("vue").DefineComponent<AssistantMessageProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<AssistantMessageProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
 export default _default;

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

@@ -0,0 +1,12 @@
+import type { AIFileInfo } from '../../../../ag-ui/types/file';
+import 'tippy.js/dist/tippy.css';
+type __VLS_Props = {
+    active?: boolean;
+    file: AIFileInfo;
+    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,11 @@
+import type { AIFileInfo } from '../../../../../ag-ui/types/file';
+type __VLS_Props = {
+    file?: AIFileInfo;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {
+    content: import("vue").ShallowRef<string, string>;
+    renderer: import("vue").ShallowRef<import("./preview-strategy.ts").ArtifactPreviewRendererKind, import("./preview-strategy.ts").ArtifactPreviewRendererKind>;
+    status: import("vue").ShallowRef<import("./use-artifact-preview-loader").ArtifactPreviewStatus, import("./use-artifact-preview-loader").ArtifactPreviewStatus>;
+}, {}, {}, {}, 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,8 @@
+export type ArtifactPreviewLoadStrategy = 'preview_url' | 'text_from_download';
+export type ArtifactPreviewRendererKind = 'code' | 'html' | 'image' | 'markdown' | 'txt' | 'urlIframe';
+export type ArtifactPreviewStrategy = {
+    load: ArtifactPreviewLoadStrategy;
+    renderer: ArtifactPreviewRendererKind;
+};
+/** 按文件类型解析预览加载策略与渲染器；未登记的类型默认 preview_url iframe */
+export declare const getArtifactPreviewStrategy: (type?: string, name?: string) => ArtifactPreviewStrategy;

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

@@ -0,0 +1,8 @@
+import 'highlight.js/styles/github-dark.css';
+type __VLS_Props = {
+    content: string;
+    extension: 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/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/image-preview.vue.d.ts

@@ -0,0 +1,7 @@
+type __VLS_Props = {
+    name?: string;
+    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/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,22 @@
+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;
+    downloadUrl: import("vue").ShallowRef<string, string>;
+    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,13 @@
+import type { SessionArtifact } from '../../../../composables/use-artifact-preview';
+import 'tippy.js/dist/tippy.css';
+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/message-artifacts.vue.d.ts

@@ -0,0 +1,9 @@
+import type { AIFileInfo } from '../../../../ag-ui/types/file';
+type __VLS_Props = {
+    artifacts: AIFileInfo[];
+    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/interrupt-message/user-question/use-user-question.d.ts

@@ -9,9 +9,9 @@ export type NormalizedUserQuestionOption = UserQuestionOptionItem & {
     letter: string;
 };
 /**
- * 用户回答问题（human-in-the-loop）的答案聚合与 resume payload 构建。
+ * 用户回答问题（human-in-the-loop）的答案聚合、题目分页与 resume payload 构建。
  *
- * 设计目标：composable 只负责「收集每题答案 + 完成态计算 + payload 组装」，
+ * 设计目标：composable 只负责「收集每题答案 + 完成态计算 + 分页定位 + payload 组装」，
  * 对「回答形态」（单选/多选/表单/任意自定义）零感知；
  * 各题如何作答与如何校验，全部下沉到对应的渲染组件（默认为选择题），
  * 渲染组件作答有效时回传已组装的 {@link UserQuestionAnswerItem}，无效时回传 undefined。
@@ -23,6 +23,11 @@ export declare const useUserQuestion: (getInterrupt: () => undefined | UserQuest
     answeredCount: import("vue").ComputedRef<number>;
     totalCount: import("vue").ComputedRef<number>;
     completed: import("vue").ComputedRef<boolean>;
+    currentIndex: import("vue").ShallowRef<number, number>;
+    canGoPrev: import("vue").ComputedRef<boolean>;
+    canGoNext: import("vue").ComputedRef<boolean>;
+    goPrev: () => void;
+    goNext: () => void;
     getAnswer: (questionIndex: number) => undefined | UserQuestionAnswerItem;
     setAnswer: (questionIndex: number, answer: undefined | UserQuestionAnswerItem) => void;
     buildResolvePayload: () => UserQuestionResume;

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

@@ -1,3 +1,4 @@
+import { type InputContent } from '../../../ag-ui/types';
 import { type TagSchema, MessageToolsStatus } from '../../../types';
 import { type MessageToolsProps } from '../../message-tools/message-tools.vue';
 import type { UserMessage } from '../../../ag-ui/types/messages';
@@ -6,7 +7,19 @@ export type UserMessageActionsProps = {
     onInputConfirm?: (content: UserMessage['content'], docSchema: TagSchema) => Promise<void>;
     onShortcutConfirm?: (formModel: Record<string, unknown>) => Promise<void>;
 };
-type __VLS_Props = Partial<UserMessage> & Pick<MessageToolsProps, 'onAction' | 'tippyOptions'> & UserMessageActionsProps;
-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>;
+interface UserMessageProps extends UserMessageActionsProps {
+    content?: InputContent[] | string;
+    createdAt?: UserMessage['createdAt'];
+    id?: UserMessage['id'];
+    messageId?: UserMessage['messageId'];
+    name?: UserMessage['name'];
+    onAction?: MessageToolsProps['onAction'];
+    property?: UserMessage['property'];
+    role?: UserMessage['role'];
+    status?: UserMessage['status'];
+    tippyOptions?: MessageToolsProps['tippyOptions'];
+    uid?: UserMessage['uid'];
+}
+declare const __VLS_export: import("vue").DefineComponent<UserMessageProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<UserMessageProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/components/file-icon/file-icon.vue.d.ts

@@ -0,0 +1,7 @@
+type __VLS_Props = {
+    fileName?: string;
+    fileType?: 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/index.d.ts

@@ -14,15 +14,17 @@ export type { IModelCapability, IModelOption, IModelProperty, ModelCapabilityThe
 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';
+import FileIcon from './file-icon/file-icon.vue';
 import HighlightKeyword from './highlight-keyword/highlight-keyword';
 import ImagePreviewGroup from './image-preview/image-preview-group.vue';
 import ImagePreview from './image-preview/image-preview.vue';
 import AiImage from './image-preview/image.vue';
 import MessageLoading from './message-loading/message-loading.vue';
+import MessageTime from './message-tools/message-time/message-time.vue';
 import MessageTools from './message-tools/message-tools.vue';
 import MessageUserFeedback from './message-tools/user-feedback/user-feedback.vue';
 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, ModelSelector, ScrollBtn, SelectionFooter, ShortcutBtn, ShortcutBtns, ShortcutRender, ToolCallRender, };
+export { AiImage, AiLoading, AiSelection, ChatContainer, ChatInput, commonErrorContent, ContentRender, ExecutionSummary, FileIcon, HighlightKeyword, ImagePreview, ImagePreviewGroup, MessageContainer, MessageLoading, MessageRender, MessageTime, MessageTools, MessageUserFeedback, ModelSelector, ScrollBtn, SelectionFooter, ShortcutBtn, ShortcutBtns, ShortcutRender, ToolCallRender, };

package/dist/components/message-tools/message-time/format-message-time.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 格式化消息时间，四档规则来自设计稿标注
+ * 今天 `12:00`；昨天 `昨天 12:00`；今年内更早 `3-12 12:00`；非今年 `2026-3-12 12:00`
+ * @param createdAt 消息创建时间，ISO 字符串或毫秒时间戳
+ * @param timezone IANA 时区名；不传则按浏览器时区展示
+ * @returns 无值或非法时间时返回空字符串，由调用方决定是否渲染
+ */
+export declare const formatMessageTime: (createdAt?: number | string, timezone?: string) => string;

package/dist/components/message-tools/message-time/message-time.vue.d.ts

@@ -0,0 +1,8 @@
+export type MessageTimeProps = {
+    createdAt?: number | string;
+    /** IANA 时区名；优先于全局配置，两者都未配置时按浏览器时区展示 */
+    timezone?: string;
+};
+declare const __VLS_export: import("vue").DefineComponent<MessageTimeProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<MessageTimeProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/message-tools/message-tools.vue.d.ts

@@ -9,7 +9,11 @@ export type MessageToolsProps = {
     tippyOptions?: AITippyProps;
     updateTools?: IToolBtn[];
 };
-declare const __VLS_export: import("vue").DefineComponent<MessageToolsProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+type __VLS_Slots = {
+    append?: () => unknown;
+    prepend?: () => unknown;
+};
+declare const __VLS_base: import("vue").DefineComponent<MessageToolsProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
     feedback: (tool: IToolBtn, reasonList: string[], otherReason: string) => any;
 }, string, import("vue").PublicProps, Readonly<MessageToolsProps> & Readonly<{
     onFeedback?: ((tool: IToolBtn, reasonList: string[], otherReason: string) => any) | undefined;
@@ -17,5 +21,11 @@ declare const __VLS_export: import("vue").DefineComponent<MessageToolsProps, {},
     messageTools: IToolBtn[];
     updateTools: IToolBtn[];
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
 export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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,49 @@
+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;
+};
+/**
+ * 会话级文件产物：以 outputId 为会话内唯一键（同 outputId 视为同一文件）。
+ * 拍平去重后即为 AIFileInfo，此处用别名标明语义。
+ */
+export type SessionArtifact = AIFileInfo;
+type ArtifactPreviewContext = {
+    /** 当前命中的文件 outputId */
+    activeArtifactId: Ref<string>;
+    /** 是否具备异步取链能力（有 onArtifactClick 时下载按钮可见） */
+    canResolveArtifactUrl: ComputedRef<boolean>;
+    /** 由文件卡片触发：命中文件并弹出/切换到文件产物侧栏 */
+    openPreview: (payload: OpenArtifactPreviewPayload) => void;
+    /** 解析 download_url / preview_url：每次重新取链；同文件并发去重 */
+    resolveArtifactUrls: (file: AIFileInfo) => Promise<ArtifactUrlResult>;
+    /** 直接设置命中文件 outputId（侧栏列表内切换用） */
+    setActiveArtifactId: (id: string) => void;
+};
+/** 通过临时 <a> 触发浏览器下载 */
+export declare const triggerArtifactDownload: (url: string, fileName: string) => void;
+/**
+ * 文件产物预览 Provider（在 ChatContainer 内使用）。
+ * 维护「命中文件」状态，并封装 onArtifactClick 取链（每次重新获取 + 并发去重）；
+ * 打开侧栏 Tab 的副作用由外部 onOpen 注入。
+ */
+export declare const useArtifactPreviewProvider: (options: {
+    /** 读取业务侧异步取链回调（用 getter 保持对 props 变更敏感） */
+    getOnArtifactClick?: () => OnArtifactClick | undefined;
+    /** 命中文件后触发：由容器负责 addCustomTab + 展开侧栏 + 选中 Tab */
+    onOpen: (outputId: 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 {};

package/dist/composables/use-container-scroll.d.ts

@@ -1,18 +1,25 @@
 import { type ComputedRef, type MaybeRef } from 'vue';
 export declare const CONTAINER_SCROLL_TOKEN: unique symbol;
 export declare const SHOW_SCROLL_BOTTOM_BTN_DISTANCE = 100;
+/**
+ * 距底部超过该距离时视为大跨度定位（首屏渲染、切换会话、异步内容撑高），
+ * 此时直接瞬时贴底；平滑滚动只用于流式输出过程中的小幅跟随。
+ */
+export declare const INSTANT_SCROLL_DISTANCE = 600;
 export type ContainerScrollData = {
     autoScrollEnabled: boolean;
     isScrollBottom: boolean;
+    jumpToBottom: () => void;
     scrollBottomHeight: number;
-    toScrollBottom: () => void;
+    toScrollBottom: (behavior?: ScrollBehavior) => void;
     toScrollTop: () => void;
 };
 export declare const useContainerScrollProvider: (containerRef: MaybeRef<HTMLElement | null>, bottomRef: MaybeRef<HTMLElement | null>) => {
     autoScrollEnabled: import("vue").ShallowRef<boolean, boolean>;
     isScrollBottom: import("vue").ShallowRef<boolean, boolean>;
     scrollBottomHeight: import("vue").ShallowRef<number, number>;
-    toScrollBottom: () => void;
+    jumpToBottom: () => void;
+    toScrollBottom: (behavior?: ScrollBehavior) => void;
     toScrollTop: () => void;
     debouncedShowScrollBottomBtn: import("vue").Ref<boolean, boolean>;
 };

package/dist/composables/use-custom-tab.d.ts

@@ -1,17 +1,19 @@
-import { type ComputedRef, type ShallowRef } from 'vue';
+import { type ComputedRef, type Ref, type ShallowRef } from 'vue';
 import type { CustomTab } from '../types';
 export declare const CUSTOM_TAB_TOKEN: unique symbol;
 export declare const EXECUTION_TAB_NAME = "execution";
 /** 自定义 Tab 默认排序权重；执行情况固定为 0，业务自定义 Tab 缺省回退到此值 */
 export declare const DEFAULT_TAB_ORDER = 100;
 export declare function useCustomTabProvider<T extends Record<string, unknown>>(options: {
+    /** 侧栏折叠态；由容器传入受控 ref（如 ChatContainer 的 v-model:asideCollapsed），缺省内部自持 */
+    collapsed?: Ref<boolean>;
     /** 执行情况 Tab 是否展示，缺省 true；传 getter 以保持响应式 */
     executionTabVisible?: () => boolean | undefined;
     onTabChange?: (tab: CustomTab<T>) => void;
 }): {
     tabs: ShallowRef<CustomTab<T>[], CustomTab<T>[]>;
     displayTabs: ComputedRef<CustomTab<T>[]>;
-    selectedTab: import("vue").Ref<{
+    selectedTab: Ref<{
         closable?: boolean | undefined;
         data?: import("vue").UnwrapRef<T & {
             messageUid?: string;
@@ -32,8 +34,9 @@ export declare function useCustomTabProvider<T extends Record<string, unknown>>(
         order?: number | undefined;
         visible?: boolean | undefined;
     }>;
-    isCollapse: ShallowRef<boolean, boolean>;
+    isCollapse: Ref<boolean, boolean>;
     addCustomTab: (tab: CustomTab<T>) => void;
+    ensureCustomTab: (tab: CustomTab<T>) => void;
     removeCustomTab: (tabName: CustomTab<T>["name"]) => void;
     selectCustomTab: (tab: CustomTab<T>) => void;
     resetCustomTab: () => void;
@@ -41,6 +44,7 @@ export declare function useCustomTabProvider<T extends Record<string, unknown>>(
 export declare const useCustomTabConsumer: <T extends Record<string, unknown>>() => {
     addCustomTab: (tab: CustomTab<T>) => void;
     displayTabs: ComputedRef<CustomTab<T>[]>;
+    ensureCustomTab: (tab: CustomTab<T>) => void;
     removeCustomTab: (tabName: CustomTab<T>["name"]) => void;
     selectCustomTab: (tab: CustomTab<T>) => void;
     selectedTab: ShallowRef<CustomTab<T> | null>;

package/dist/composables/use-global-config.d.ts

@@ -4,9 +4,12 @@ export type AiSizeMode = 'normal' | 'small';
 export type GlobalConfig = {
     size?: ComputedRef<AiSizeMode>;
     supportUpload: ComputedRef<boolean>;
+    /** IANA 时区名，用于消息时间展示；未配置时按浏览器时区展示 */
+    timezone?: ComputedRef<string | undefined>;
 };
 export declare const useGlobalConfig: (options: GlobalConfig) => {
     size: ComputedRef<AiSizeMode> | undefined;
     supportUpload: ComputedRef<boolean>;
+    timezone: ComputedRef<string | undefined> | undefined;
 };
 export declare const injectGlobalConfig: () => GlobalConfig | undefined;