@fses/workbench-app 0.2.0 → 0.2.1

package/node_modules/@fses/ai-chat/dist/composables/types.d.ts

@@ -0,0 +1,465 @@
+/**
+ * @fileoverview Chat composable shared types - describes messages, conversations, and runtime options.
+ * @author seadon
+ * @created 2026-05-06
+ */
+import type { Ref } from 'vue';
+import type { ChartCardSpec, MetricWorkbenchCardSpec } from '../chart-card/types';
+import type { ContextUsage } from './context-usage';
+export interface ChatAttachment {
+    downloadUrl?: string;
+    fileId?: string;
+    mimeType: string;
+    name: string;
+    rawFile?: File;
+    size?: number;
+    type: 'file' | 'image';
+    url?: string;
+}
+export type ChatProcessInvocationKind = 'tool' | 'skill';
+export type ChatProcessInvocationStatus = 'running' | 'done' | 'error';
+export interface ChatProcessInvocation {
+    collapsed?: boolean;
+    completedAt?: string;
+    durationMs?: number;
+    error?: string;
+    id: string;
+    inputSummary?: string;
+    kind: ChatProcessInvocationKind;
+    name: string;
+    resultSummary?: string;
+    startedAt?: string;
+    status: ChatProcessInvocationStatus;
+    summary?: string;
+    title: string;
+}
+export interface QueryResultTableColumn {
+    key: string;
+    label: string;
+}
+export interface QueryResultTable {
+    columns: QueryResultTableColumn[];
+    /** 同轮助手答案的 Markdown 已经展示过这张表时，仅把结构化表作为字段标签和卡片数据来源。 */
+    renderedInMarkdown?: boolean;
+    returnedCount?: number;
+    rows: Array<Record<string, unknown>>;
+    title?: string;
+    totalCount?: number;
+}
+export interface ChatMessage {
+    attachments?: ChatAttachment[];
+    cards?: ChartCardSpec[];
+    content: string;
+    detail?: string;
+    error?: string;
+    endTime?: number;
+    id: string;
+    loading?: boolean;
+    /** 标记该状态文案来自 message_delta / preamble，可进入 commentary。 */
+    processPreamble?: boolean;
+    /** 标记该状态消息是助手回复的思考过程，应挂到同轮 assistant 正文上方展示。 */
+    thinkingProcess?: boolean;
+    /** 标记该状态消息是当前对话 `/events` 首次返回前的临时占位。 */
+    initialEventsPending?: boolean;
+    /** 挂载到当前 assistant 回复前方的思考过程状态消息。 */
+    thinkingProcessMessages?: ChatMessage[];
+    /** 当前思考过程下的 skill 或工具调用，默认由组件折叠展示。 */
+    processInvocations?: ChatProcessInvocation[];
+    markThinking?: boolean;
+    /** 工作台等宿主可标记关键过程行默认展开，避免用户只能看到笼统的处理中状态。 */
+    defaultExpanded?: boolean;
+    removeThinking?: boolean;
+    role: 'assistant' | 'status' | 'user';
+    startTime?: number;
+    /** 助手回答正在流式更新中，组件会合并 Markdown 渲染以保持输出顺滑。 */
+    streaming?: boolean;
+    /** 标记该助手消息是否来自最终结论，用于限制图表卡片派生范围。 */
+    conclusion?: boolean;
+    /** Workbench turn id used to anchor restored artifacts such as card recommendations. */
+    workbenchTurnId?: string;
+    /** Multi-query history placement used to keep result sections, recommendations, and separators visually grouped. */
+    workbenchInterleavedPlacement?: 'recommendation' | 'result' | 'separator-result' | 'separator-tail';
+    timestamp: string;
+    planDraft?: PlanDraft;
+    queryResultTable?: QueryResultTable;
+    queryResultTables?: QueryResultTable[];
+    cardRecommendationDraft?: CardRecommendationDraft;
+    /** 标记推荐卡片应先显示轻量占位，待用户触发后再渲染完整预览。 */
+    deferCardRecommendationRender?: boolean;
+    registeredCardInsertDraft?: CardRecommendationItem;
+    memoryCaptureDraft?: MemoryCaptureDraft;
+    taskStateDraft?: TaskStateDraft;
+}
+export interface Conversation {
+    id: string;
+    messages: ChatMessage[];
+    persisted?: boolean;
+    title: string;
+    /** 已确认的 DeepAgent threadId；草稿态为空。 */
+    threadId?: string;
+    /** 历史消息是否已从后端加载成功；空历史也应标记为已加载。 */
+    historyLoaded?: boolean;
+    /** 本地草稿 ID，仅用于前端 UI 关联，不允许写入后端。 */
+    clientDraftId?: string;
+    /** 对话模式标识，'fde' 或 'runtime'，用于区分 FDE 设计态与 runtime 运行态对话 */
+    chatMode?: string;
+    createdAt?: string;
+    updatedAt?: string;
+}
+export interface AssistantPersonaPayload {
+    key: string;
+    label: string;
+    prompt: string;
+}
+export interface BusinessGroupOption {
+    businessGroupCode: string;
+    businessGroupDescription?: string;
+    businessGroupName: string;
+    groupType?: string;
+}
+export interface BusinessGroupResourceModel {
+    appId: string;
+    modelCode: string;
+    modelName?: string;
+}
+export interface BusinessGroupResourceMetric {
+    appId?: string;
+    metricCode: string;
+    metricName?: string;
+}
+export interface BusinessGroupResources {
+    businessGroupCode?: string;
+    metrics: BusinessGroupResourceMetric[];
+    models: BusinessGroupResourceModel[];
+}
+export interface BusinessGroupContext extends BusinessGroupOption {
+    resources?: BusinessGroupResources;
+}
+export interface MemoryCaptureDraft {
+    turnId: string;
+    itemId: string;
+    title: string;
+    content: string;
+    confirmLabel: string;
+    dismissLabel: string;
+    status: 'draft' | 'candidate_created' | 'dismissed' | 'saving';
+}
+export interface TaskStateDraftField {
+    code: string;
+    name: string;
+    displayValue?: string;
+    required?: boolean;
+    source?: string;
+}
+export interface TaskStateDraftConfirmationOption {
+    index: number;
+    label: string;
+    description?: string;
+    /** 候选所属应用编码，仅用于历史续接，不在任务卡片中直接展示。 */
+    appId?: string;
+    /** 候选所属模型编码，仅用于历史续接，不在任务卡片中直接展示。 */
+    modelCode?: string;
+    /** 候选指标编码，仅用于历史续接，不在任务卡片中直接展示。 */
+    metricCode?: string;
+    /** 候选字段编码，仅用于历史续接，不在任务卡片中直接展示。 */
+    fieldCode?: string;
+    /** 候选来源，供后端刷新后恢复澄清上下文。 */
+    source?: string;
+}
+export interface TaskStateDraft {
+    turnId: string;
+    taskId: string;
+    taskKind: string;
+    taskKindLabel: string;
+    title: string;
+    status: string;
+    statusLabel: string;
+    statusTone: 'neutral' | 'brand' | 'warning' | 'success' | 'danger';
+    fields: TaskStateDraftField[];
+    missingFields: TaskStateDraftField[];
+    canConfirm: boolean;
+    confirmPhrase?: string;
+    cancelPhrase?: string;
+    confirmationOptions?: TaskStateDraftConfirmationOption[];
+    /** 已确认的候选项，仅用于后端历史续接，不在任务卡片中直接展示。 */
+    confirmedSelection?: TaskStateDraftConfirmationOption;
+    lastErrorMessage?: string;
+    resultSummary?: string;
+}
+export type RuntimeStringOption = (() => string | undefined) | string;
+export type RuntimeBusinessGroupOption = (() => BusinessGroupContext | undefined) | BusinessGroupContext;
+export type FsesAiChatTransportMessageInput = Omit<ChatMessage, 'id' | 'timestamp'> & Partial<Pick<ChatMessage, 'id' | 'timestamp'>>;
+export interface FsesAiChatQuickEntryActionPayload {
+    action?: string;
+    capabilityId: string;
+    quickEntryId?: string;
+    source?: string;
+    [key: string]: unknown;
+}
+export interface FsesAiChatQuickEntry {
+    actionPayload: FsesAiChatQuickEntryActionPayload;
+    entryId?: string;
+    id?: string;
+    label: string;
+    source: string;
+}
+export interface FsesAiChatSendMessageOptions {
+    attachments?: ChatAttachment[];
+    quickEntry?: FsesAiChatQuickEntry;
+}
+export interface FsesAiChatTransportContext {
+    appendMessage: (message: FsesAiChatTransportMessageInput) => ChatMessage;
+    /**
+     * 消费宿主 transport 已经获取到的文本/工具事件流。
+     *
+     * ai-chat 只负责把事件流转换为可渲染消息，不再在共享包内部拼接或请求根 POST /chat；
+     * 鉴权、路由、/fde-core 请求以及运行态协议适配都必须由宿主 transport 完成。
+     */
+    consumeAssistantStream: (body: ReadableStream<Uint8Array>) => Promise<void>;
+    /** 将已有消息移到聊天列表末尾，用于保证流式结论始终在工具状态消息之后。 */
+    moveMessageToEnd: (msg: ChatMessage | null) => void;
+    assistantPersona?: AssistantPersonaPayload;
+    businessGroup?: BusinessGroupContext;
+    /** 当前会话模式，由宿主 transport 传给运行态 /fde-core，用于隔离设计态与运行态历史。 */
+    chatMode?: string;
+    /** 已确认的 DeepAgent threadId；首次发送草稿态为空。 */
+    threadId?: string;
+    /** 本地草稿 ID，仅供宿主日志或 UI 关联，不允许写入后端。 */
+    clientDraftId?: string;
+    /** DeepAgent 创建 thread 后立即回调，让 ai-chat 将草稿会话收敛到 threadId。 */
+    onThreadReady?: (threadId: string) => void;
+    attachments?: ChatAttachment[];
+    input: string;
+    messages: ChatMessage[];
+    quickEntry?: FsesAiChatQuickEntry;
+    /** 从 headers 回调提取的链路 ID，供宿主 transport 继续透传到运行态。 */
+    traceId?: string;
+    userId?: string;
+    workspaceId?: string;
+    /** Abort signal — fired when user clicks stop; transport should resolve/reject its promise. */
+    signal?: AbortSignal;
+}
+export interface FsesAiChatTransportResult {
+    threadId?: string;
+}
+export type FsesAiChatTransport = (context: FsesAiChatTransportContext) => Promise<FsesAiChatTransportResult | void>;
+export interface FsesAiChatConversationChangeMeta {
+    id: string;
+    threadId?: string;
+    clientDraftId?: string;
+    persisted: boolean;
+}
+export interface UseChatOptions {
+    /** 历史会话管理接口基础地址；发送消息必须通过 transport 接入运行态执行入口。 */
+    apiBaseUrl: string;
+    assistantPersona?: (() => AssistantPersonaPayload | undefined) | AssistantPersonaPayload;
+    businessGroup?: RuntimeBusinessGroupOption;
+    /** 是否在初始化聊天实例时立即拉取历史会话列表，关闭后由宿主在历史面板打开时触发。 */
+    autoLoadConversations?: boolean;
+    /** 宿主受控的当前会话 ID，用于刷新恢复后同步外部当前 DeepAgent thread。 */
+    activeConversationId?: RuntimeStringOption;
+    /** 对话模式标识，'fde' 或 'runtime'，用于按模式筛选对话历史 */
+    chatMode?: RuntimeStringOption;
+    /** 编排流 API 基础 URL（不传则使用 apiBaseUrl） */
+    composeApiBaseUrl?: RuntimeStringOption;
+    enableChartCards?: boolean;
+    headers?: () => Record<string, string>;
+    onChartCardRefined?: (card: ChartCardSpec, context: {
+        cardId: string;
+        conversationId?: string;
+        messageId?: string;
+    }) => void;
+    onConversationChange?: (id: string, meta: FsesAiChatConversationChangeMeta) => void;
+    onHistoryLoaded?: (id: string) => void;
+    onError?: (error: Error) => void;
+    /** 消息执行 transport；根 POST /chat 已删除，宿主必须显式接入 /fde-core 等运行态入口。 */
+    transport?: FsesAiChatTransport;
+    userId?: RuntimeStringOption;
+    workspaceId?: RuntimeStringOption;
+}
+/** 图片上传 payload */
+export interface ImagePayload {
+    base64: string;
+    downloadUrl?: string;
+    file: File;
+    fileId?: string;
+    fileName?: string;
+    messageId?: string;
+    mimeType: string;
+    previewUrl?: string;
+    text?: string;
+}
+/** 通用附件上传 payload */
+export interface AttachmentPayload {
+    downloadUrl?: string;
+    file: File;
+    fileId?: string;
+    fileName: string;
+    messageId?: string;
+    mimeType: string;
+    previewUrl?: string;
+    size: number;
+    text?: string;
+    type: 'file' | 'image';
+}
+/** 对话输入区排队附件的提交载荷 */
+export interface ComposerAttachmentPayload {
+    base64?: string;
+    downloadUrl?: string;
+    file: File;
+    fileId?: string;
+    fileName: string;
+    mimeType: string;
+    previewUrl?: string;
+    size: number;
+    type: 'file' | 'image';
+}
+/** 对话输入区一次提交的文本与附件集合 */
+export interface ComposerAttachmentsSubmitPayload {
+    attachments: ComposerAttachmentPayload[];
+    text: string;
+}
+/** 编排计划中的单个卡片块摘要 */
+export interface PlanDraftBlock {
+    blockId: string;
+    capabilityId: string;
+    title: string;
+    subtitle?: string;
+    layout: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    confidence: number;
+    bodyJson?: Record<string, unknown>;
+}
+/** 编排计划草案 */
+export interface PlanDraft {
+    planId: string;
+    source: 'text';
+    blocks: PlanDraftBlock[];
+}
+/** 注册卡片推荐项 */
+export type CardRecommendationPreviewStatus = 'ready' | 'requires_execution' | 'requires_config' | 'empty' | 'blocked';
+export type CardRecommendationNextAction = 'insert' | 'configure' | 'execute_query' | 'disabled';
+export interface CardRecommendationConfigRequirement {
+    kind: string;
+    message: string;
+    fields?: Array<{
+        name: string;
+        label: string;
+        type: 'text' | 'number' | 'select' | 'url' | 'boolean' | string;
+        required?: boolean;
+        options?: Array<{
+            label: string;
+            value: string;
+        }>;
+    }>;
+}
+export interface CardRecommendationVisualIntent {
+    chartIntent?: 'metric' | 'trend' | 'ranking' | 'share' | 'detail' | string;
+    dimensionFields?: string[];
+    seriesFields?: string[];
+    measureFields?: string[];
+    filterFields?: string[];
+    projectionSummary?: string;
+}
+export interface CardRecommendationDiagnostics {
+    reasonCodes: string[];
+    requiredFields: string[];
+    selectedFields: string[];
+    missingFields: string[];
+}
+export interface CardRecommendationItem {
+    recommendationId?: string;
+    capabilityId: string;
+    title: string;
+    reason: string;
+    confidence?: number;
+    dataShape?: string;
+    source?: 'sql' | 'metric' | 'mixed';
+    conversationId?: string;
+    sourceTurnId?: string;
+    sourceLabel?: string;
+    previewStatus?: CardRecommendationPreviewStatus;
+    nextAction?: CardRecommendationNextAction;
+    configRequirement?: CardRecommendationConfigRequirement;
+    queryRequirement?: Record<string, unknown>;
+    previewReason?: string;
+    assetRefs?: Array<{
+        type: string;
+        id: string;
+        label?: string;
+    }>;
+    cardConfig?: Record<string, unknown>;
+    selectedConfig?: Record<string, unknown>;
+    dataBinding?: Record<string, unknown>;
+    queryResult?: Record<string, unknown>;
+    visualIntent?: CardRecommendationVisualIntent;
+    diagnosticStatus?: string;
+    diagnosticReason?: string;
+    protocolKind?: string;
+    diagnostics?: CardRecommendationDiagnostics;
+    coverage?: Record<string, unknown>;
+    viewAlternatives?: Array<Omit<CardRecommendationItem, 'viewAlternatives'>>;
+    blockPlan?: Record<string, unknown>;
+}
+export interface CardRecommendationChooseFeedback {
+    done: (ok: boolean) => void;
+}
+export type CardRecommendationFallbackActionType = 'insert_table' | 'configure_chart' | 'retry_query';
+export interface CardRecommendationFallbackAction {
+    action: CardRecommendationFallbackActionType;
+    label: string;
+    description?: string;
+    item?: CardRecommendationItem;
+}
+/** 注册卡片推荐草案 */
+export interface CardRecommendationDraft {
+    recommendationId: string;
+    prompt: string;
+    message: string;
+    conversationId?: string;
+    sourceTurnId?: string;
+    exhausted?: boolean;
+    totalRecommendationCount?: number;
+    eligibleCandidateCount?: number;
+    returnedCandidateCount?: number;
+    readyCandidateCount?: number;
+    diagnosticCandidateCount?: number;
+    chartFamilyCoverage?: string[];
+    projectionFamilyCoverage?: Record<string, string[]>;
+    queryResult?: Record<string, unknown>;
+    echartsCoverage?: Record<string, unknown>;
+    registryCoverage?: Record<string, unknown>;
+    fallbackActions?: CardRecommendationFallbackAction[];
+    recommendations: CardRecommendationItem[];
+}
+export interface UseChatReturn {
+    abortStream: () => void;
+    clearConversations: () => Promise<void>;
+    compactContext: () => Promise<void>;
+    contextUsage: Ref<ContextUsage>;
+    conversations: Ref<Conversation[]>;
+    createConversation: () => Promise<string>;
+    currentConversationId: Ref<null | string>;
+    deleteConversation: (id: string) => Promise<void>;
+    isCompacting: Ref<boolean>;
+    isLoading: Ref<boolean>;
+    isLoadingConversations: Ref<boolean>;
+    isSwitchingConversation: Ref<boolean>;
+    latestChartCard: Ref<ChartCardSpec | null>;
+    latestMetricCard: Ref<MetricWorkbenchCardSpec | null>;
+    assignWorkbenchTurnIds: (conversationId: string, turnIds: string[]) => boolean;
+    appendMessage: (message: FsesAiChatTransportMessageInput, conversationId?: string) => ChatMessage;
+    replaceWorkbenchTurnAnswer: (conversationId: string, turnId: string, replacementMessages: FsesAiChatTransportMessageInput[]) => boolean;
+    loadConversations: () => Promise<void>;
+    loadHistory: (id: string) => Promise<void>;
+    messages: Ref<ChatMessage[]>;
+    moveMessageToEnd: (msg: ChatMessage | null) => void;
+    renameConversation: (id: string, name: string) => Promise<void>;
+    sendMessage: (content: string, sendOptions?: FsesAiChatSendMessageOptions) => Promise<void>;
+    streamingMessageId: Ref<null | string>;
+    switchConversation: (id: string) => Promise<void>;
+}

package/node_modules/@fses/ai-chat/dist/composables/useChat.d.ts

@@ -0,0 +1,2 @@
+import type { UseChatOptions, UseChatReturn } from './types';
+export declare function useChat(options: UseChatOptions): UseChatReturn;

package/node_modules/@fses/ai-chat/dist/composables/useSystemEChartsIcon.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 创建系统 ECharts 推荐图标路径状态。
+ * @returns 路径解析、失败标记和可见性判断方法。
+ */
+export declare function useSystemEChartsIcon(): {
+    isLoaded: (iconPath: string) => boolean;
+    markFailed: (iconPath: string) => void;
+    markLoaded: (iconPath: string) => void;
+    resolvePath: (value: unknown) => string;
+    shouldShow: (iconPath: string) => boolean;
+};