@blueking/chat-x 0.0.49-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

@@ -2,9 +2,9 @@ export declare enum AIFileType {
     Html = "html",
     Jpg = "jpg",
     Json = "json",
+    Markdown = "markdown",
     /** 后台扩展名别名，与 Markdown 等价 */
     Md = "md",
-    Markdown = "markdown",
     Pdf = "pdf",
     Txt = "txt"
 }

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

@@ -3,8 +3,6 @@ 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';

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

@@ -1,7 +1,6 @@
 import type { AIFileInfo } from '../../../../../ag-ui/types/file';
-import type { SessionArtifact } from '../../../../../composables/use-artifact-preview';
 type __VLS_Props = {
-    file?: AIFileInfo | SessionArtifact;
+    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;

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

@@ -1,4 +1,5 @@
 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;
@@ -7,14 +8,15 @@ export type ArtifactPreviewPayload = {
     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) => Promise<ArtifactUrlResult>;
+    resolveUrls: (file: AIFileInfo, options?: ResolveArtifactUrlsOptions) => Promise<ArtifactUrlResult>;
 }) => {
     content: import("vue").ShallowRef<string, string>;
     dispose: () => void;
-    load: () => Promise<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/message-artifacts.vue.d.ts

@@ -1,7 +1,6 @@
 import type { AIFileInfo } from '../../../../ag-ui/types/file';
 type __VLS_Props = {
     artifacts: AIFileInfo[];
-    messageUid?: string;
     onDownload?: (file: AIFileInfo) => void;
     onPreview?: (file: AIFileInfo) => void;
 };

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/use-artifact-preview.d.ts

@@ -4,54 +4,51 @@ import type { AIFileInfo, ArtifactUrlResult, OnArtifactClick } from '../ag-ui/ty
 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;
-    /** 文件在所属消息 artifacts 中的下标 */
-    index: number;
-    /** 所属 AssistantMessage 的 uid */
-    messageUid: string;
+};
+/** resolveArtifactUrls 可选参数 */
+export type ResolveArtifactUrlsOptions = {
+    /** 为 true 时跳过 TTL 缓存，强制重新取链（如预览重试） */
+    force?: boolean;
 };
 /**
- * 会话级文件产物：在 AIFileInfo 基础上补充命中所需的唯一 id 与所属消息。
- * 由于同一会话可能出现「多个 AssistantMessage + 同名文件」，文件名不可作为唯一键，
- * 统一用 messageUid + 消息内下标 + outputId 组合出全局唯一 id。
+ * 会话级文件产物：以 outputId 为会话内唯一键（同 outputId 视为同一文件）。
+ * 拍平去重后即为 AIFileInfo，此处用别名标明语义。
  */
-export type SessionArtifact = AIFileInfo & {
-    artifactId: string;
-    messageUid: string;
-};
+export type SessionArtifact = AIFileInfo;
 type ArtifactPreviewContext = {
-    /** 当前命中的文件 id */
+    /** 当前命中的文件 outputId */
     activeArtifactId: Ref<string>;
     /** 是否具备异步取链能力（有 onArtifactClick 时下载按钮可见） */
     canResolveArtifactUrl: ComputedRef<boolean>;
     /** 由文件卡片触发：命中文件并弹出/切换到文件产物侧栏 */
     openPreview: (payload: OpenArtifactPreviewPayload) => void;
-    /** 按 outputId 缓存并解析 download_url / preview_url */
-    resolveArtifactUrls: (file: AIFileInfo) => Promise<ArtifactUrlResult>;
-    /** 直接设置命中文件 id（侧栏列表内切换用） */
+    /** 解析 download_url / preview_url：TTL 内复用缓存；force 时强制刷新；并发去重 */
+    resolveArtifactUrls: (file: AIFileInfo, options?: ResolveArtifactUrlsOptions) => Promise<ArtifactUrlResult>;
+    /** 直接设置命中文件 outputId（侧栏列表内切换用） */
     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 缓存；
+ * 维护「命中文件」状态，并封装 onArtifactClick 取链（TTL 缓存 + 并发去重）；
  * 打开侧栏 Tab 的副作用由外部 onOpen 注入。
  */
 export declare const useArtifactPreviewProvider: (options: {
     /** 读取业务侧异步取链回调（用 getter 保持对 props 变更敏感） */
     getOnArtifactClick?: () => OnArtifactClick | undefined;
     /** 命中文件后触发：由容器负责 addCustomTab + 展开侧栏 + 选中 Tab */
-    onOpen: (artifactId: string) => void;
+    onOpen: (outputId: string) => void;
 }) => {
     activeArtifactId: import("vue").ShallowRef<string, string>;
     canResolveArtifactUrl: ComputedRef<boolean>;
     openPreview: (payload: OpenArtifactPreviewPayload) => void;
-    resolveArtifactUrls: (file: AIFileInfo) => Promise<ArtifactUrlResult>;
+    resolveArtifactUrls: (file: AIFileInfo, resolveOptions?: ResolveArtifactUrlsOptions) => Promise<ArtifactUrlResult>;
     setActiveArtifactId: (id: string) => void;
 };
 /** 文件产物预览 Consumer（在深层文件卡片中使用），无 Provider 时返回 undefined 兜底 */

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>;

package/dist/composables/use-message-group.d.ts

@@ -1,7 +1,6 @@
 import type { ComputedRef, MaybeRef, Ref, ShallowRef } from 'vue';
 import { type Message, APPROVAL_STATUS, InterruptReason, MessageContentType, MessageRole, MessageStatus } from '../ag-ui/types';
 import { RenderMode } from '../common/constants';
-import { type SessionArtifact } from './use-artifact-preview';
 import type { UserQuestionInterrupt } from '../ag-ui/types/interrupt';
 export type MessageGroup = {
     checked: boolean;
@@ -26289,7 +26288,7 @@ export declare const useMessageGroup: (options: {
         userMessageTitle?: number | string | undefined;
     }[]>;
     executionGroups: ComputedRef<MessageGroup[]>;
-    sessionArtifacts: ComputedRef<SessionArtifact[]>;
+    sessionArtifacts: ComputedRef<import("..").AIFileInfo[]>;
     activeUserQuestionInterrupt: ComputedRef<UserQuestionInterrupt | undefined>;
     pendingApprovalCount: ComputedRef<number>;
     pendingApprovalTipText: ComputedRef<string>;