@blueking/chat-x 0.0.48-beta.1 → 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-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/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 {};