@hkyhy/marsun-components-core 0.1.3 → 0.1.8

package/README.md

@@ -80,19 +80,17 @@ npm run typecheck
 
 ### 发布版本（npm）
 
-包名为 **`@hkyhy/marsun-components-core`**（npm scope 与 GitHub 发布账号 `hkyhy` 对齐；若需 `@marsun` 须先在 npm 创建该组织）。
+包名为 **`@hkyhy/marsun-components-core`**（npm scope 与 GitHub 发布账号 `hkyhy` 对齐）。
 
 1. 在 GitHub 仓库 **Settings → Secrets → Actions** 配置 `HKYHY_PACKAGE_PUBLISH`（npm Automation Token，对 `@hkyhy` 有 publish 权限）
-2. 更新 `package.json` 的 `version`，提交后打 tag 并推送：
+2. **推送 `main` 即自动发布**：`.github/workflows/release.yml` 会 patch 版本号、提交 `chore(release): v* `、打 tag 并 `npm publish`（`chore(release)` 提交本身不会再次触发，避免循环）
+3. 日常只需正常开发提交并 push：
 
 ```bash
-npm version patch   # 或 minor / major
-git push origin main --tags
+git push origin main
 ```
 
-推送 `v*` tag 后 `.github/workflows/publish.yml` 自动执行 `npm publish`（仅发布 `dist/`，不含 dev showcase）。
-
-也可在 Actions 中手动运行 **Publish npm**，填写已有 tag（如 `v0.1.2`）。
+也可在 Actions 中手动运行 **Publish npm**，填写已有 tag 重新发布。
 
 ## 后续接入 maoyang
 

package/dist/_virtual/_commonjs-dynamic-modules.js

@@ -0,0 +1,7 @@
+function r(o) {
+  throw new Error('Could not dynamically require "' + o + '". Please configure the dynamicRequireTargets or/and ignoreDynamicRequires option of @rollup/plugin-commonjs appropriately for this require call to work.');
+}
+export {
+  r as commonjsRequire
+};
+//# sourceMappingURL=_commonjs-dynamic-modules.js.map

package/dist/_virtual/_commonjs-dynamic-modules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_commonjs-dynamic-modules.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;"}

package/dist/_virtual/_commonjsHelpers.js

@@ -0,0 +1,9 @@
+var o = typeof globalThis < "u" ? globalThis : typeof window < "u" ? window : typeof global < "u" ? global : typeof self < "u" ? self : {};
+function l(e) {
+  return e && e.__esModule && Object.prototype.hasOwnProperty.call(e, "default") ? e.default : e;
+}
+export {
+  o as commonjsGlobal,
+  l as getDefaultExportFromCjs
+};
+//# sourceMappingURL=_commonjsHelpers.js.map

package/dist/_virtual/_commonjsHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_commonjsHelpers.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;"}

package/dist/_virtual/jszip.min.js

@@ -0,0 +1,8 @@
+import { getDefaultExportFromCjs as r } from "./_commonjsHelpers.js";
+import { __require as o } from "../node_modules/jszip/dist/jszip.min.js";
+var t = o();
+const m = /* @__PURE__ */ r(t);
+export {
+  m as default
+};
+//# sourceMappingURL=jszip.min.js.map

package/dist/_virtual/jszip.min.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jszip.min.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;"}

package/dist/_virtual/jszip2.min.js

@@ -0,0 +1,5 @@
+var e = { exports: {} };
+export {
+  e as __module
+};
+//# sourceMappingURL=jszip2.min.js.map

package/dist/_virtual/jszip2.min.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jszip2.min.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/_virtual/lodash.js

@@ -0,0 +1,6 @@
+import { __require as r } from "../node_modules/lodash/lodash.js";
+var a = r();
+export {
+  a as l
+};
+//# sourceMappingURL=lodash.js.map

package/dist/_virtual/lodash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lodash.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/_virtual/lodash2.js

@@ -0,0 +1,5 @@
+var o = { exports: {} };
+export {
+  o as __module
+};
+//# sourceMappingURL=lodash2.js.map

package/dist/_virtual/lodash2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lodash2.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/components/AgentHub/AgentHubAccessGuard.d.ts

@@ -0,0 +1,11 @@
+import { default as React } from 'react';
+export interface AgentHubAccessGuardProps {
+    mode: 'admin-only' | 'chat-manage';
+    /** 是否管理员 */
+    isAdmin?: boolean;
+    /** 无权限时重定向路径 */
+    redirectTo?: string;
+    children: React.ReactNode;
+}
+declare const AgentHubAccessGuard: React.FC<AgentHubAccessGuardProps>;
+export default AgentHubAccessGuard;

package/dist/components/AgentHub/AgentHubIndexRedirect.d.ts

@@ -0,0 +1,8 @@
+import { default as React } from 'react';
+export interface AgentHubIndexRedirectProps {
+    isAdmin?: boolean;
+    adminPath?: string;
+    userPath?: string;
+}
+declare const AgentHubIndexRedirect: React.FC<AgentHubIndexRedirectProps>;
+export default AgentHubIndexRedirect;

package/dist/components/AgentHub/Chat/Action/CreateButton.d.ts

@@ -0,0 +1,6 @@
+import { default as React } from 'react';
+export interface ChatCreateButtonProps {
+    onClick?: () => void;
+}
+declare const CreateButton: React.FC<ChatCreateButtonProps>;
+export default CreateButton;

package/dist/components/AgentHub/Chat/Action/ManageActionButtons.d.ts

@@ -0,0 +1,6 @@
+import { default as React } from 'react';
+export interface ChatManageActionButtonsProps {
+    onCreateClick: () => void;
+}
+declare const ManageActionButtons: React.FC<ChatManageActionButtonsProps>;
+export default ManageActionButtons;

package/dist/components/AgentHub/Chat/Action/SessionActionButtons.d.ts

@@ -0,0 +1,8 @@
+import { default as React } from 'react';
+export interface SessionActionButtonsProps {
+    streaming?: boolean;
+    clearDisabled?: boolean;
+    onClearConversation: () => void;
+}
+declare const SessionActionButtons: React.FC<SessionActionButtonsProps>;
+export default SessionActionButtons;

package/dist/components/AgentHub/Chat/Action/handlers.d.ts

@@ -0,0 +1,11 @@
+/** Action handlers 由消费方注入 API 回调；core 仅导出类型占位 */
+export type ChatActionHandlers = {
+    onDelete?: (id: string) => Promise<void>;
+    onCreate?: () => void;
+    onEdit?: (id: string) => void;
+};
+export type KnowledgeBaseActionHandlers = {
+    onDelete?: (id: string) => Promise<void>;
+    onCreate?: () => void;
+    onUpload?: (datasetId: string) => void;
+};

package/dist/components/AgentHub/Chat/Action/index.d.ts

@@ -0,0 +1,7 @@
+export { default as ChatCreateButton } from './CreateButton';
+export type { ChatCreateButtonProps } from './CreateButton';
+export * from './handlers';
+export { default as ChatManageActionButtons } from './ManageActionButtons';
+export type { ChatManageActionButtonsProps } from './ManageActionButtons';
+export { default as SessionActionButtons } from './SessionActionButtons';
+export type { SessionActionButtonsProps } from './SessionActionButtons';

package/dist/components/AgentHub/Chat/Detail/ChatInput/index.d.ts

@@ -0,0 +1,11 @@
+import { default as React } from 'react';
+export interface ChatInputProps {
+    value: string;
+    loading: boolean;
+    onChange: (v: string) => void;
+    onSend: () => void;
+    onStop?: () => void;
+    placeholder?: string;
+}
+declare const ChatInput: React.FC<ChatInputProps>;
+export default ChatInput;

package/dist/components/AgentHub/Chat/Detail/CitationContent/index.d.ts

@@ -0,0 +1,6 @@
+import { default as React } from 'react';
+export interface CitationContentProps {
+    content: string;
+}
+declare const CitationContent: React.FC<CitationContentProps>;
+export default CitationContent;

package/dist/components/AgentHub/Chat/Detail/CitationInlineBadge/index.d.ts

@@ -0,0 +1,7 @@
+import { default as React } from 'react';
+export interface CitationInlineBadgeProps {
+    number: number;
+    onClick?: () => void;
+}
+declare const CitationInlineBadge: React.FC<CitationInlineBadgeProps>;
+export default CitationInlineBadge;

package/dist/components/AgentHub/Chat/Detail/CitationMarkdownContent/index.d.ts

@@ -0,0 +1,12 @@
+import { Citation } from '../../../types';
+import { default as React } from 'react';
+export interface CitationMarkdownContentProps {
+    content: string;
+    citations: Citation[];
+    citationSourceContent: string;
+    onCitationClick?: (citations: Citation[], index?: number) => void;
+    className?: string;
+    deferMermaid?: boolean;
+}
+declare const CitationMarkdownContent: React.FC<CitationMarkdownContentProps>;
+export default CitationMarkdownContent;

package/dist/components/AgentHub/Chat/Detail/CitationPanel/index.d.ts

@@ -0,0 +1,9 @@
+import { Citation } from '../../../types';
+import { default as React } from 'react';
+export interface CitationPanelProps {
+    citations: Citation[];
+    highlightedIndex?: number;
+    onClose?: () => void;
+}
+declare const CitationPanel: React.FC<CitationPanelProps>;
+export default CitationPanel;

package/dist/components/AgentHub/Chat/Detail/MermaidBlock/index.d.ts

@@ -0,0 +1,7 @@
+import { default as React } from 'react';
+export interface MermaidBlockProps {
+    chart: string;
+    enabled?: boolean;
+}
+declare const MermaidBlock: React.FC<MermaidBlockProps>;
+export default MermaidBlock;

package/dist/components/AgentHub/Chat/Detail/MessageActions/index.d.ts

@@ -0,0 +1,33 @@
+import { default as React } from 'react';
+import { MessageEditPopoverProps } from '../MessageEditPopover';
+export type MessageActionKey = 'edit' | 'copy' | 'resend' | 'like' | 'dislike';
+export interface MessageActionItem {
+    key: MessageActionKey;
+    label: string;
+    icon: React.ReactNode;
+    onClick: () => void;
+    hidden?: boolean;
+    disabled?: boolean;
+    active?: boolean;
+}
+export interface MessageActionsProps {
+    items: MessageActionItem[];
+    align?: 'left' | 'right';
+    editPopover?: Omit<MessageEditPopoverProps, 'children'>;
+    actionsVisible?: boolean;
+}
+declare const MessageActions: React.FC<MessageActionsProps>;
+export declare const createUserMessageActions: (options: {
+    onEdit?: () => void;
+    onCopy: () => void;
+    onResend?: () => void;
+    editDisabled?: boolean;
+}) => MessageActionItem[];
+export declare const createAssistantMessageActions: (options: {
+    onCopy: () => void;
+    onLike?: () => void;
+    onDislike?: () => void;
+    thumbup?: boolean | null;
+    feedbackDisabled?: boolean;
+}) => MessageActionItem[];
+export default MessageActions;

package/dist/components/AgentHub/Chat/Detail/MessageEditPopover/index.d.ts

@@ -0,0 +1,13 @@
+import { default as React } from 'react';
+export interface MessageEditPopoverProps {
+    open: boolean;
+    value: string;
+    originalContent: string;
+    onOpenChange: (open: boolean) => void;
+    onChange: (value: string) => void;
+    onConfirm: () => void;
+    onCancel: () => void;
+    children: React.ReactNode;
+}
+declare const MessageEditPopover: React.FC<MessageEditPopoverProps>;
+export default MessageEditPopover;

package/dist/components/AgentHub/Chat/Detail/MessageItem/index.d.ts

@@ -0,0 +1,14 @@
+import { ChatMessage, Citation } from '../../../types';
+import { default as React } from 'react';
+export interface MessageItemProps {
+    message: ChatMessage;
+    onCitationClick?: (citations: Citation[], index?: number) => void;
+    onTypingChange?: (typing: boolean) => void;
+    onEditMessage?: (messageId: string, content: string) => void;
+    onResendMessage?: (content: string) => void;
+    onMessageFeedback?: (messageId: string, thumbup: boolean) => void | Promise<void>;
+    editDisabled?: boolean;
+    feedbackDisabled?: boolean;
+}
+declare const MessageItem: React.FC<MessageItemProps>;
+export default MessageItem;

package/dist/components/AgentHub/Chat/Detail/ThinkingSection/index.d.ts

@@ -0,0 +1,13 @@
+import { Citation } from '../../../types';
+import { default as React } from 'react';
+export interface ThinkingSectionProps {
+    thinking: string;
+    isThinking?: boolean;
+    isTyping?: boolean;
+    citations?: Citation[];
+    citationSourceContent?: string;
+    onCitationClick?: (citations: Citation[], index?: number) => void;
+    deferMermaid?: boolean;
+}
+declare const ThinkingSection: React.FC<ThinkingSectionProps>;
+export default ThinkingSection;

package/dist/components/AgentHub/Chat/Detail/index.d.ts

@@ -0,0 +1,12 @@
+export { default as CitationMarkdownContent } from './CitationMarkdownContent';
+export type { CitationMarkdownContentProps } from './CitationMarkdownContent';
+export { default as ChatInput } from './ChatInput';
+export type { ChatInputProps } from './ChatInput';
+export { default as CitationPanel } from './CitationPanel';
+export type { CitationPanelProps } from './CitationPanel';
+export { default as MessageEditPopover } from './MessageEditPopover';
+export type { MessageEditPopoverProps } from './MessageEditPopover';
+export { default as MessageItem } from './MessageItem';
+export type { MessageItemProps } from './MessageItem';
+export { default as MessageActions } from './MessageActions';
+export type { MessageActionsProps, MessageActionItem } from './MessageActions';

package/dist/components/AgentHub/Chat/Form/Form.d.ts

@@ -0,0 +1,16 @@
+import { Dataset } from '../../types';
+import { FormInstance } from 'antd';
+import { default as React } from 'react';
+export interface ChatAssistantFormProps {
+    form: FormInstance;
+    datasets: Dataset[];
+    initialValues?: {
+        name?: string;
+        description?: string;
+        dataset_ids?: string[];
+        prologue?: string;
+        empty_response?: string;
+    };
+}
+declare const ChatAssistantForm: React.FC<ChatAssistantFormProps>;
+export default ChatAssistantForm;

package/dist/components/AgentHub/Chat/Form/index.d.ts

@@ -0,0 +1,2 @@
+export { default as ChatAssistantForm } from './Form';
+export type { ChatAssistantFormProps } from './Form';

package/dist/components/AgentHub/Chat/List/ChatCard/index.d.ts

@@ -0,0 +1,11 @@
+import { ChatAssistant, Dataset } from '../../../types';
+import { default as React } from 'react';
+export interface ChatCardProps {
+    chat: ChatAssistant;
+    datasets: Dataset[];
+    onStartChat: (chat: ChatAssistant) => void;
+    onEdit: (chat: ChatAssistant) => void;
+    onDelete: (chat: ChatAssistant) => void;
+}
+declare const ChatCard: React.FC<ChatCardProps>;
+export default ChatCard;

package/dist/components/AgentHub/Chat/List/FilterBar.d.ts

@@ -0,0 +1,7 @@
+import { default as React } from 'react';
+export interface ChatFilterBarProps {
+    keyword: string;
+    onKeywordChange: (v: string) => void;
+}
+declare const ChatFilterBar: React.FC<ChatFilterBarProps>;
+export default ChatFilterBar;

package/dist/components/AgentHub/Chat/List/SessionSidebar/index.d.ts

@@ -0,0 +1,15 @@
+import { ChatSession } from '../../../types';
+import { default as React } from 'react';
+export interface SessionSidebarProps {
+    title: string;
+    sessions: ChatSession[];
+    activeSessionId?: string;
+    loading?: boolean;
+    disabled?: boolean;
+    onSelect: (sessionId: string) => void;
+    onCreateSession: () => void;
+    onClearSession: (sessionId: string) => void;
+    onDeleteSession: (sessionId: string) => void;
+}
+declare const SessionSidebar: React.FC<SessionSidebarProps>;
+export default SessionSidebar;

package/dist/components/AgentHub/Chat/List/index.d.ts

@@ -0,0 +1,6 @@
+export { default as ChatCard } from './ChatCard';
+export type { ChatCardProps } from './ChatCard';
+export { default as ChatFilterBar } from './FilterBar';
+export type { ChatFilterBarProps } from './FilterBar';
+export { default as SessionSidebar } from './SessionSidebar';
+export type { SessionSidebarProps } from './SessionSidebar';

package/dist/components/AgentHub/Chat/Modal/FormModal.d.ts

@@ -0,0 +1,12 @@
+import { ChatAssistant, Dataset } from '../../types';
+import { default as React } from 'react';
+export interface ChatFormModalProps {
+    open: boolean;
+    record?: ChatAssistant | null;
+    datasets: Dataset[];
+    onSubmit: (values: Record<string, unknown>, record?: ChatAssistant | null) => Promise<void>;
+    onSuccess: () => void;
+    onCancel: () => void;
+}
+declare const ChatFormModal: React.FC<ChatFormModalProps>;
+export default ChatFormModal;

package/dist/components/AgentHub/Chat/Modal/index.d.ts

@@ -0,0 +1,2 @@
+export { default as ChatFormModal } from './FormModal';
+export type { ChatFormModalProps } from './FormModal';

package/dist/components/AgentHub/Chat/constants/index.d.ts

@@ -0,0 +1 @@
+export * from './types';

package/dist/components/AgentHub/Chat/constants/types.d.ts

@@ -0,0 +1,2 @@
+import { ChatAssistant, ChatMessage, ChatSession, Citation, SSEChunk } from '../../types';
+export type { ChatAssistant, ChatMessage, ChatSession, Citation, SSEChunk };

package/dist/components/AgentHub/Chat/hooks/index.d.ts

@@ -0,0 +1,5 @@
+export { useAutoScrollToBottom } from './useAutoScrollToBottom';
+export { useChat } from './useChat';
+export { useChatSessions } from './useChatSessions';
+export { useSSECompletion } from './useSSECompletion';
+export { useTypewriter } from './useTypewriter';

package/dist/components/AgentHub/Chat/hooks/useAutoScrollToBottom.d.ts

@@ -0,0 +1,21 @@
+import { RefObject } from 'react';
+interface UseAutoScrollToBottomOptions {
+    /** When true, always scroll regardless of current scroll position */
+    force?: boolean;
+    /** Pixel threshold to treat the viewport as "at bottom" */
+    threshold?: number;
+    /** Re-run scroll when this value changes (e.g. messages) */
+    trigger?: unknown;
+    /** Disable observers when there is nothing to scroll */
+    enabled?: boolean;
+}
+/**
+ * Keeps a scroll container pinned to the bottom while messages grow,
+ * including typewriter-driven height changes that do not update React state.
+ */
+export declare function useAutoScrollToBottom(containerRef: RefObject<HTMLElement | null>, contentRef: RefObject<HTMLElement | null>, options?: UseAutoScrollToBottomOptions): {
+    scrollToBottom: (behavior?: ScrollBehavior) => void;
+    stickToBottom: () => void;
+    handleScroll: () => void;
+};
+export {};

package/dist/components/AgentHub/Chat/hooks/useChat.d.ts

@@ -0,0 +1,19 @@
+import { ChatAssistant, Dataset } from '../../types';
+export type UseChatOptions = {
+    listUrl?: string;
+    datasetsUrl?: string;
+    transformList?: (raw: unknown) => ChatAssistant[];
+    transformDatasets?: (raw: unknown) => Dataset[];
+    /** 删除助手 fetch URL 模板，{id} 占位 */
+    deleteUrl?: string;
+    onDeleteSuccess?: () => void;
+};
+export declare const useChat: (options?: UseChatOptions) => {
+    data: ChatAssistant[];
+    loading: boolean;
+    datasets: Dataset[];
+    keyword: string;
+    setKeyword: import('react').Dispatch<import('react').SetStateAction<string>>;
+    fetchData: () => void;
+    deleteChat: (id: string) => Promise<void>;
+};

package/dist/components/AgentHub/Chat/hooks/useChatSessions.d.ts

@@ -0,0 +1,20 @@
+import { ChatMessage, ChatSession } from '../../types';
+export type UseChatSessionsOptions = {
+    chatId?: string;
+    userId?: string;
+    listUrl?: string;
+    detailUrl?: string;
+    transformList?: (raw: unknown) => ChatSession[];
+    transformDetail?: (raw: unknown) => ChatSession | null;
+};
+export declare const useChatSessions: (options?: UseChatSessionsOptions) => {
+    sessions: ChatSession[];
+    sessionId: string | undefined;
+    setSessionId: import('react').Dispatch<import('react').SetStateAction<string | undefined>>;
+    sessionsLoading: boolean;
+    sessionLoading: boolean;
+    messages: ChatMessage[];
+    setMessages: import('react').Dispatch<import('react').SetStateAction<ChatMessage[]>>;
+    loadSessions: () => Promise<void>;
+    userId: string | undefined;
+};

package/dist/components/AgentHub/Chat/hooks/useSSECompletion.d.ts

@@ -0,0 +1,13 @@
+import { Citation } from '../../types';
+export type SSECompletionOptions = {
+    completionUrl: string;
+    getAuthHeaders?: () => Record<string, string>;
+};
+export declare const useSSECompletion: ({ completionUrl, getAuthHeaders }: SSECompletionOptions) => {
+    send: (messages: {
+        role: "user" | "assistant";
+        content: string;
+    }[], onChunk: (text: string) => void, onCitations: (citations: Citation[]) => void, onDone: () => void, onError: (err: string) => void, sessionId?: string) => Promise<void>;
+    streaming: boolean;
+    abort: () => void;
+};

package/dist/components/AgentHub/Chat/hooks/useTypewriter.d.ts

@@ -0,0 +1,16 @@
+interface UseTypewriterOptions {
+    /** Fixed reveal rate in characters per second. Default: 60 */
+    charsPerSecond?: number;
+}
+/**
+ * Smoothly reveals streaming text character-by-character using requestAnimationFrame.
+ *
+ * Live streaming messages animate from empty; once the stream ends, any remaining
+ * characters continue at the same rate until fully revealed. Historical messages
+ * with `streaming: false` that were never streamed show in full immediately.
+ */
+export declare function useTypewriter(content: string, streaming: boolean, options?: UseTypewriterOptions): {
+    displayed: string;
+    isTyping: boolean;
+};
+export {};

package/dist/components/AgentHub/Chat/index.d.ts

@@ -0,0 +1,7 @@
+export * from './Action';
+export * from './constants';
+export * from './Detail';
+export * from './Form';
+export * from './hooks';
+export * from './List';
+export * from './Modal';

package/dist/components/AgentHub/Chat/utils/citationContent.d.ts

@@ -0,0 +1,37 @@
+import { Citation } from '../../types';
+export declare const CITATION_LINK_PREFIX = "#cite-";
+/** 从正文中提取所有引用 ID（支持 [ID:n]、（ID:n）、ID:n 等格式） */
+export declare function extractCitationIdsFromContent(content: string): number[];
+/** 正文中实际引用到的来源数量（去重后的 citations 下标） */
+export declare function countUniqueCitedSources(content: string, citationsLength: number): number;
+/** 判断 [ID:n] 是 0-based 还是 1-based（RAGFlow 用 0-based，部分 mock/旧数据用 1-based） */
+export declare function detectCitationIdBase(content: string, citationsLength: number): 'zero' | 'one';
+/** 将正文中的引用标记转为可自定义渲染的 markdown 链接 */
+export declare function injectCitationMarkdownLinks(content: string): string;
+export declare function parseCitationLinkHref(href?: string): number | null;
+/** [ID:n] 映射到 citations 数组下标 */
+export declare function citationIdToIndex(id: number, citationsLength: number, content?: string): number;
+/** 与侧栏 panel 一致的 1-based 展示序号 */
+export declare function citationDisplayNumber(citationId: number, citationsLength: number, content?: string): number;
+/** 去掉 RAG chunk 顶部的 YAML frontmatter */
+export declare function stripCitationFrontmatter(content: string): string;
+/** 文档路径取文件名（去扩展名） */
+export declare function formatCitationDocBasename(docName?: string): string | undefined;
+/** 将 RAGFlow chunk 字段归一化为 Citation */
+export declare function normalizeCitation(raw: Record<string, unknown>): Citation;
+/** 从 chunk 正文提取展示标题 */
+export declare function extractCitationTitle(content: string, fallback: string): string;
+/** 引用侧栏标题：展示 document_name */
+export declare function resolveCitationTitle(citation: Citation, index: number): string;
+/** 格式化 chunk positions（RAGFlow: [页码, left, right, top, bottom]） */
+export declare function formatCitationPositions(positions?: unknown): string | undefined;
+/** 引用侧栏元信息：positions · 匹配度 */
+export declare function formatCitationMeta(citation: Citation): string;
+export interface PreparedCitationContent {
+    body: string;
+    isHtml: boolean;
+}
+/** 预处理引用正文，供 Markdown / HTML 分支渲染 */
+export declare function prepareCitationContent(content: string): PreparedCitationContent;
+/** 引用 HTML 仅做基础清理（内容来自可信 RAG 知识库） */
+export declare function sanitizeCitationHtml(html: string): string;

package/dist/components/AgentHub/Chat/utils/index.d.ts

@@ -0,0 +1,5 @@
+export { CITATION_LINK_PREFIX, citationDisplayNumber, citationIdToIndex, countUniqueCitedSources, detectCitationIdBase, extractCitationIdsFromContent, extractCitationTitle, formatCitationDocBasename, formatCitationMeta, formatCitationPositions, injectCitationMarkdownLinks, normalizeCitation, parseCitationLinkHref, prepareCitationContent, resolveCitationTitle, sanitizeCitationHtml, stripCitationFrontmatter, } from './citationContent';
+export { hasCitationMarkers, normalizeAssistantMarkdown, normalizeDisplayText, parseAssistantContent, } from './messageContent';
+export type { ParsedAssistantContent } from './messageContent';
+export { sanitizeMermaidChart, stripProseFromMermaid } from './sanitizeMermaidChart';
+export { extractCitations, formatSessionTime, getSessionDisplayName, isWelcomeOnlyMessages, parseSessionMessages, toDisplayMessages, } from './sessionMessages';

package/dist/components/AgentHub/Chat/utils/messageContent.d.ts

@@ -0,0 +1,18 @@
+export interface ParsedAssistantContent {
+    /** Reasoning text extracted from think blocks */
+    thinking: string;
+    /** User-facing answer (outside think blocks) */
+    answer: string;
+    /** Stream still inside an unclosed think block */
+    isThinking: boolean;
+}
+/** Collapse excessive blank lines and trim trailing whitespace for display */
+export declare function normalizeDisplayText(text: string): string;
+/** Normalize assistant markdown from persisted sessions (fences, mermaid blocks). */
+export declare function normalizeAssistantMarkdown(content: string): string;
+export declare function hasCitationMarkers(content: string): boolean;
+/**
+ * Split assistant output into hidden reasoning and visible answer.
+ * RAGFlow / reasoning models may wrap chain-of-thought in think tags.
+ */
+export declare function parseAssistantContent(content: string, streaming?: boolean): ParsedAssistantContent;

package/dist/components/AgentHub/Chat/utils/sanitizeMermaidChart.d.ts

@@ -0,0 +1,7 @@
+/** Remove non-Mermaid prose lines (e.g. 风格说明) that LLMs append inside code blocks. */
+export declare function stripProseFromMermaid(chart: string): string;
+/**
+ * Fix common AI-generated Mermaid syntax issues before rendering.
+ * e.g. C[梳理(生條)] → C["梳理(生條)"]
+ */
+export declare function sanitizeMermaidChart(chart: string): string;

package/dist/components/AgentHub/Chat/utils/sessionMessages.d.ts

@@ -0,0 +1,21 @@
+import { ChatMessage, ChatSession, Citation, MessageRole } from '../../types';
+interface RawSessionMessage {
+    id?: string;
+    role: MessageRole;
+    content?: unknown;
+    reference?: SessionReference;
+    created_at?: number;
+    create_time?: number;
+    thumbup?: boolean;
+}
+type SessionReference = {
+    chunks?: Citation[] | Record<string, Citation>;
+} | Citation[] | Record<string, unknown> | null;
+export declare const formatSessionTime: (value?: string | number) => string;
+export declare const normalizeMessageContent: (content: unknown) => string;
+export declare const getSessionDisplayName: (session: ChatSession) => string;
+export declare const isWelcomeOnlyMessages: (messages: ChatMessage[], prologue?: string) => boolean;
+export declare const extractCitations: (reference?: SessionReference) => Citation[] | undefined;
+export declare const parseSessionMessages: (rawMessages?: RawSessionMessage[], references?: SessionReference[]) => ChatMessage[];
+export declare const toDisplayMessages: (messages: ChatMessage[], prologue?: string) => ChatMessage[];
+export {};