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

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,23 @@
+export declare enum AIFileType {
+    Html = "html",
+    Jpg = "jpg",
+    Json = "json",
+    Markdown = "markdown",
+    /** 后台扩展名别名，与 Markdown 等价 */
+    Md = "md",
+    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-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,7 @@
+import type { AIFileInfo } from '../../../../../ag-ui/types/file';
+type __VLS_Props = {
+    file?: AIFileInfo;
+};
+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,23 @@
+import type { AIFileInfo, ArtifactUrlResult } from '../../../../../ag-ui/types/file';
+import type { ResolveArtifactUrlsOptions } from '../../../../../composables/use-artifact-preview';
+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 type ArtifactPreviewLoadOptions = ResolveArtifactUrlsOptions;
+export declare const useArtifactPreviewLoader: (options: {
+    canResolve: () => boolean;
+    getFile: () => AIFileInfo | undefined;
+    resolveUrls: (file: AIFileInfo, options?: ResolveArtifactUrlsOptions) => Promise<ArtifactUrlResult>;
+}) => {
+    content: import("vue").ShallowRef<string, string>;
+    dispose: () => void;
+    load: (loadOptions?: ArtifactPreviewLoadOptions) => 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,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,18 @@ 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;
+    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/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,56 @@
+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";
+/** 临时链接缓存有效期（短于后端 token 常见 10 分钟时效） */
+export declare const ARTIFACT_URL_CACHE_TTL_MS: number;
+export type OpenArtifactPreviewPayload = {
+    /** 被点击的文件 */
+    file: AIFileInfo;
+};
+/** resolveArtifactUrls 可选参数 */
+export type ResolveArtifactUrlsOptions = {
+    /** 为 true 时跳过 TTL 缓存，强制重新取链（如预览重试） */
+    force?: boolean;
+};
+/**
+ * 会话级文件产物：以 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：TTL 内复用缓存；force 时强制刷新；并发去重 */
+    resolveArtifactUrls: (file: AIFileInfo, options?: ResolveArtifactUrlsOptions) => Promise<ArtifactUrlResult>;
+    /** 直接设置命中文件 outputId（侧栏列表内切换用） */
+    setActiveArtifactId: (id: string) => void;
+};
+/** 通过临时 <a> 触发浏览器下载 */
+export declare const triggerArtifactDownload: (url: string, fileName: string) => void;
+/**
+ * 文件产物预览 Provider（在 ChatContainer 内使用）。
+ * 维护「命中文件」状态，并封装 onArtifactClick 取链（TTL 缓存 + 并发去重）；
+ * 打开侧栏 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, resolveOptions?: ResolveArtifactUrlsOptions) => Promise<ArtifactUrlResult>;
+    setActiveArtifactId: (id: string) => void;
+};
+/** 文件产物预览 Consumer（在深层文件卡片中使用），无 Provider 时返回 undefined 兜底 */
+export declare const useArtifactPreviewConsumer: () => ArtifactPreviewContext | undefined;
+export {};

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

@@ -34,6 +34,7 @@ export declare function useCustomTabProvider<T extends Record<string, unknown>>(
     }>;
     isCollapse: ShallowRef<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 +42,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>;