@fses/workbench-app 0.1.0

package/dist/internal/personal-workbench/types/workbenchV2.d.ts

@@ -0,0 +1,211 @@
+/**
+ * @fileoverview Workbench V2 文档、卡片、布局、数据绑定与编排流事件类型
+ * @author seadon
+ * @created 2026-05-09
+ */
+import type { BlockLayout, WorkbenchSnapshotVisualConfig } from '@fses/workbench-app/types';
+export type WorkbenchV2CardKind = 'metric' | 'chart' | 'table' | 'list' | 'container' | 'placeholder' | string;
+export type WorkbenchV2Surface = 'canvas' | 'conversation' | 'sidePanel' | string;
+export type WorkbenchV2Shell = 'card' | 'section' | 'inline' | 'none' | string;
+export interface WorkbenchV2Layout extends BlockLayout {
+    slot?: string;
+    parentId?: string;
+}
+export interface WorkbenchV2DataBinding {
+    id?: string;
+    bindingId?: string;
+    status?: string;
+    updatedAt?: string;
+    queryIntent?: string;
+    queryId?: string;
+    sourceType?: string;
+    refreshApi?: string;
+    params?: Record<string, unknown>;
+    schema?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export interface WorkbenchV2CardAppearance {
+    styleVariant?: string;
+    themeId?: string;
+    accentColor?: string;
+    backgroundColor?: string;
+    textColor?: string;
+    borderColor?: string;
+    density?: string;
+    [key: string]: unknown;
+}
+export interface WorkbenchV2Card {
+    id: string;
+    capabilityId?: string;
+    kind?: WorkbenchV2CardKind;
+    title: string;
+    subtitle?: string;
+    surface?: WorkbenchV2Surface;
+    shell?: WorkbenchV2Shell;
+    layout?: WorkbenchV2Layout;
+    renderData?: unknown;
+    dataBinding?: WorkbenchV2DataBinding;
+    dataSources?: WorkbenchV2DataSource[];
+    dataPatch?: Record<string, unknown>;
+    appearance?: WorkbenchV2CardAppearance;
+    recognition?: Record<string, unknown>;
+    fallback?: Record<string, unknown>;
+    children?: string[];
+    slots?: Record<string, string[]>;
+    meta?: {
+        rendererKey?: string;
+        dataShape?: string;
+        registryTitle?: string;
+        shell?: string;
+        styleVariants?: string[];
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+export interface WorkbenchV2Document {
+    id?: string;
+    workspaceId?: string;
+    workbenchId?: string;
+    schemaVersion?: string;
+    roleId?: string;
+    userId?: string;
+    version: number;
+    layoutConfig?: Record<string, unknown>;
+    cards: WorkbenchV2Card[];
+    layout?: WorkbenchV2Layout[];
+    dataSources?: WorkbenchV2DataSource[];
+    visualConfig?: WorkbenchSnapshotVisualConfig;
+    updatedAt?: string;
+    imageComposeMeta?: Record<string, unknown>;
+    meta?: Record<string, unknown>;
+}
+export interface WorkbenchV2DataSource {
+    id: string;
+    type: string;
+    name?: string;
+    config?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export interface WorkbenchV2CardDataPatch {
+    cardId: string;
+    bindingId: string;
+    capabilityId?: string;
+    rendererKey?: string;
+    dataShape?: string;
+    registryTitle?: string;
+    status: 'ready' | 'error' | string;
+    data: Record<string, unknown>;
+    diagnostics?: Record<string, unknown>;
+    humanIntervention?: Record<string, unknown>;
+    updatedAt: string;
+    error?: string;
+    dataBinding?: WorkbenchV2DataBinding;
+    renderData?: unknown;
+    patch?: Record<string, unknown>;
+    baseVersion?: number;
+}
+export interface WorkbenchV2MatchedCard {
+    cardId: string;
+    title?: string;
+    kind?: WorkbenchV2CardKind;
+    capabilityId?: string;
+    rendererKey?: string;
+    dataShape?: string;
+    registryTitle?: string;
+    bindable?: boolean;
+    bindingId?: string;
+    queryIntent?: string;
+    confidence?: number;
+    reason?: string;
+    placeholder?: boolean;
+    appearance?: WorkbenchV2CardAppearance;
+    fallback?: Record<string, unknown>;
+    recognition?: Record<string, unknown>;
+    layout?: WorkbenchV2Layout;
+    children?: string[];
+    slots?: Record<string, string[]>;
+    manualReplacement?: {
+        suggestedKind?: string;
+        suggestedCapabilityId?: string;
+        suggestedRendererKey?: string;
+        suggestedDataShape?: string;
+        suggestedRegistryTitle?: string;
+        reason?: string;
+        action?: string;
+        queryIntent?: string;
+        originalRegion?: Record<string, unknown>;
+        [key: string]: unknown;
+    };
+}
+export type ComposeStreamEvent = {
+    type: 'image_received';
+    data: {
+        mimeType?: string;
+        hasImage: boolean;
+        conversationId?: string;
+    };
+} | {
+    type: 'layout_detected';
+    data: {
+        source: string;
+        cardCount: number;
+        layout: WorkbenchV2Layout[];
+        visualConfig?: WorkbenchSnapshotVisualConfig;
+    };
+} | {
+    type: 'cards_matched';
+    data: {
+        cards: WorkbenchV2MatchedCard[];
+        backfillPolicy?: {
+            maxCards: number;
+            budgetMs: number;
+        };
+    };
+} | {
+    type: 'document_ready';
+    data: {
+        document: WorkbenchV2Document;
+    };
+} | {
+    type: 'data_binding_running';
+    data: {
+        cardId: string;
+        bindingId: string;
+        queryIntent: string;
+        capabilityId?: string;
+        rendererKey?: string;
+        dataShape?: string;
+        registryTitle?: string;
+    };
+} | {
+    type: 'card_data_patch';
+    data: WorkbenchV2CardDataPatch;
+} | {
+    type: 'done';
+    data: {
+        workbenchId: string;
+        cardCount: number;
+        dataPatchTotal?: number;
+        dataPatchReady?: number;
+        dataPatchFailed?: number;
+        dataPatchHumanIntervention?: number;
+    };
+} | {
+    type: 'compose_error';
+    data: {
+        message: string;
+        code?: string;
+    };
+};
+/**
+ * 运行时窄化 Workbench V2 编排流事件。
+ * @param value - JSON 解析后的未知值。
+ * @returns 当事件符合后端 V2 SSE 契约时返回 true。
+ */
+export declare function isComposeStreamEvent(value: unknown): value is ComposeStreamEvent;
+/**
+ * 安全解析 Workbench V2 编排流事件。
+ * @param json - SSE data 字段合并后的 JSON 字符串。
+ * @returns 符合契约的事件；非法或未知事件返回 null。
+ */
+export declare function parseComposeStreamEvent(json: string): ComposeStreamEvent | null;

package/dist/internal/personal-workbench/vue-types/workbenchRuntime.d.ts

@@ -0,0 +1,191 @@
+import type { ComputedRef, Ref } from 'vue';
+import type { BusinessGroupContext, CardRecommendationItem } from '@fses/workbench-app/types';
+import type { ChartCardSpec } from '@fses/workbench-app/types';
+import type { MetricWorkbenchCardSpec } from '@workbench-internal/lib/aiMetricCardSpec';
+import type { WorkbenchChatHistoryMessage } from '@workbench-internal/lib/workbenchChatHistory';
+import type { WorkbenchDataBindingQueryResult, WorkbenchContext, WorkbenchUpdateInfoPayload } from '@workbench-internal/lib/workbenchApi';
+import type { SystemCardWorkbenchPromptParams } from '@workbench-internal/lib/workbenchSystemCardPrompt';
+import type { AssistantPersonaKey, BlockLayout, ConversationTurn, LayoutConfig, MaterializedBlock, PlanResponse, RoleId, WorkbenchLayoutV4, WorkbenchSnapshot, WorkbenchTemplate } from '@fses/workbench-app/types';
+export interface RuntimeMessage {
+    id: string;
+    role: 'user' | 'assistant';
+    content: string;
+    createdAt: string;
+}
+export interface ActivityItem {
+    id: string;
+    title: string;
+    detail: string;
+    status: 'done' | 'running' | 'info';
+    createdAt: string;
+}
+export interface WorkbenchConversationSummary {
+    id: string;
+    title: string;
+    updatedAt: string;
+}
+export interface WorkbenchRuntimeRunPromptOptions {
+    attachments?: Array<{
+        id?: string;
+        name?: string;
+        type?: string;
+        url?: string;
+    }>;
+    selectedBlockId?: string | null;
+    selectedNestedBlock?: {
+        parentId: string;
+        childId: string;
+    } | null;
+    assistantPersona?: AssistantPersonaKey;
+    businessGroup?: BusinessGroupContext;
+    chatThreadId?: string;
+    clientDraftId?: string;
+    onThreadReady?: (threadId: string) => void;
+    chatMessages?: WorkbenchChatHistoryMessage[];
+    selectedSystemCard?: SystemCardWorkbenchPromptParams | null;
+    cardDataTask?: WorkbenchCardDataTaskContinuation | null;
+}
+export interface WorkbenchCardDataTaskConfirmedOption {
+    type: 'semantic_model' | 'join_path' | 'metric_subject' | 'filter';
+    value: unknown;
+}
+export interface WorkbenchCardDataTaskContinuation {
+    taskId?: string;
+    targetBlockId?: string;
+    confirmedOption?: WorkbenchCardDataTaskConfirmedOption;
+}
+export type WorkbenchCardDataTaskStatus = 'pending' | 'querying' | 'confirming' | 'empty' | 'bound' | 'failed' | 'config_required';
+export interface WorkbenchCardDataTaskRuntimeState {
+    taskId: string;
+    turnId: string;
+    capabilityId: string;
+    title?: string;
+    status: WorkbenchCardDataTaskStatus;
+    targetBlockId?: string;
+    confirmationType?: 'semantic_model' | 'join_path' | 'metric_subject' | 'filter';
+    options?: Array<Record<string, unknown>>;
+    selectedOption?: Record<string, unknown>;
+    reason?: string;
+    blockId?: string;
+    changedBlockIds?: string[];
+    insertedBlockIds?: string[];
+    layoutChangedBlockIds?: string[];
+    affectedBlockIds?: string[];
+    updatedAt: string;
+}
+export interface UseWorkbenchRuntimeOptions {
+    autoLoad?: boolean;
+    workspaceId?: string;
+    userId?: string;
+    roleId?: RoleId | string;
+    mode?: string;
+    fdeMode?: boolean | string;
+    resourceId?: string;
+    fdeResourceId?: string;
+    path?: string;
+    fdePath?: string;
+    name?: string;
+    fdeName?: string;
+}
+export interface WorkbenchRuntimeRefs {
+    context: ComputedRef<WorkbenchContext>;
+    workspaceId: Ref<string>;
+    userId: Ref<string>;
+    workbenches: Ref<WorkbenchTemplate[]>;
+    workbenchPrologue: Ref<string>;
+    roleId: Ref<RoleId | ''>;
+    snapshot: Ref<WorkbenchSnapshot | null>;
+    layoutConfig: Ref<LayoutConfig>;
+    planResult: Ref<PlanResponse | null>;
+    turns: ComputedRef<ConversationTurn[]>;
+    activeTurnId: Ref<string | null>;
+    conversations: ComputedRef<WorkbenchConversationSummary[]>;
+    messages: ComputedRef<RuntimeMessage[]>;
+    activities: ComputedRef<ActivityItem[]>;
+    loading: Ref<boolean>;
+    planning: Ref<boolean>;
+    saving: Ref<boolean>;
+    error: Ref<string>;
+    autoInsertComposePlan: Ref<boolean>;
+    lastComposeInsertedBlockIds: Ref<string[]>;
+    patchHighlightBlockIds: Ref<string[]>;
+    patchCandidateBlockIds: Ref<string[]>;
+    patchHighlightReason: Ref<string>;
+}
+export interface WorkbenchRuntimeActions {
+    setRoleId: (roleId: RoleId) => Promise<void>;
+    loadWorkbenches: () => Promise<void>;
+    loadSnapshot: () => Promise<void>;
+    runPrompt: (input: string, selectedBlockIdOrOptions?: string | null | WorkbenchRuntimeRunPromptOptions, assistantPersona?: AssistantPersonaKey) => Promise<string | void>;
+    applyCardPatchPrompt: (input: string, options?: Pick<WorkbenchRuntimeRunPromptOptions, 'selectedBlockId' | 'selectedNestedBlock' | 'assistantPersona' | 'chatThreadId' | 'clientDraftId' | 'chatMessages'>) => Promise<void>;
+    stopCurrentTask: () => void;
+    confirmLayoutDraft: (turnId: string) => Promise<void>;
+    confirmCardMutation: (turnId: string) => Promise<void>;
+    cancelCardMutation: (turnId: string) => Promise<void>;
+    confirmSubmitDraft: (turnId: string) => Promise<void>;
+    insertPreview: (turnId?: string) => Promise<void>;
+    rollbackPreview: (turnId: string) => Promise<void>;
+    saveLayout: (layout: ReadonlyArray<BlockLayout>) => Promise<WorkbenchSnapshot | null>;
+    saveGridstackLayout: (layoutTree: WorkbenchLayoutV4) => Promise<WorkbenchSnapshot | null>;
+    saveCanvasConfig: (blocks: MaterializedBlock[], nextLayoutConfig?: LayoutConfig, nextVisualConfig?: WorkbenchSnapshot['visualConfig'] | null) => Promise<WorkbenchSnapshot | null>;
+    insertAiChartCard: (card: ChartCardSpec) => Promise<WorkbenchSnapshot | null>;
+    insertAiMetricCard: (card: MetricWorkbenchCardSpec) => Promise<WorkbenchSnapshot | null>;
+    insertRegisteredCardRecommendation: (item: CardRecommendationItem) => Promise<WorkbenchSnapshot | null>;
+    undoLastRegisteredCardInsert: (cardId: string) => Promise<WorkbenchSnapshot | null>;
+    setLayoutTemplate: (nextLayoutConfig: LayoutConfig) => Promise<WorkbenchSnapshot | null>;
+    clearConversation: () => void;
+    startNewConversation: () => void;
+    selectConversation: (conversationId: string) => Promise<void>;
+    restoreConversation: (conversationId: string, source: 'url' | 'storage' | 'history' | 'chat', options?: {
+        expectedCurrentConversationId?: string;
+    }) => Promise<'restored' | 'empty' | 'ignored' | 'forbidden' | 'missing' | 'failed'>;
+    loadDeepAgentHistoryConversation: (conversationId: string, options?: {
+        allowUnmarked?: boolean;
+        throwOnError?: boolean;
+    }) => Promise<void>;
+    deleteConversation: (conversationId: string) => void;
+    toggleTurnCollapse: (turnId: string) => void;
+    openWorkspace: (workspaceId: string, userId?: string) => Promise<void>;
+    switchWorkbench: (nextWorkspaceId: string) => Promise<void>;
+    updateWorkbenchInfo: (payload: WorkbenchUpdateInfoPayload) => Promise<void>;
+    deleteWorkbench: (targetWorkspaceId: string) => Promise<void>;
+    refreshAll: () => Promise<void>;
+    refreshBlock: (blockId: string) => Promise<void>;
+    retryDataBindingRefresh: (blockId: string, options?: {
+        businessWording?: string;
+        bindingId?: string;
+        filterValues?: Record<string, unknown>;
+    }) => Promise<WorkbenchDataBindingQueryResult>;
+    rebindCardDataBinding: (blockId: string, options: {
+        businessWording: string;
+        bindingId?: string;
+        fieldMapping?: Record<string, unknown>;
+        fieldLabels?: Record<string, unknown>;
+        cardConfig?: Record<string, unknown>;
+        selectedConfig?: Record<string, unknown>;
+    }) => Promise<WorkbenchDataBindingQueryResult>;
+    moveBlock: (blockId: string, direction: 'up' | 'down') => Promise<void>;
+    removeBlock: (blockId: string) => Promise<void>;
+    submitForm: (blockId: string, values: Record<string, unknown>) => Promise<void>;
+    submitSurvey: (blockId: string, answers: Record<string, unknown>) => Promise<void>;
+    executeAction: (blockId: string, actionId: string, actionLabel: string) => Promise<void>;
+    generateReport: (blockId: string) => Promise<void>;
+    replaceSnapshot: (nextSnapshot: WorkbenchSnapshot) => void;
+    setAutoInsertComposePlan: (enabled: boolean) => void;
+    setPatchHighlight: (payload: {
+        highlightBlockIds?: string[];
+        candidateBlockIds?: string[];
+        reason?: string;
+    }) => void;
+    clearPatchHighlight: () => void;
+    persistUiMemory: (patch?: {
+        selectedConversationId?: string;
+        conversationView?: 'current' | 'history';
+        collapsedTurnIds?: string[];
+        collapsedTraceTurnIds?: string[];
+        autoInsertComposePlan?: boolean;
+        layoutConfig?: LayoutConfig;
+        assistantPersona?: AssistantPersonaKey;
+    }) => void;
+}
+export type WorkbenchRuntimeComposable = WorkbenchRuntimeRefs & WorkbenchRuntimeActions;

package/dist/runtime/context/workbenchAppContext.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @fileoverview 工作台应用上下文 - 向宿主 slots 提供配置、平台适配器和用户扩展。
+ * @author seadon
+ * @created 2026-08-12
+ */
+import { type InjectionKey, type Ref } from 'vue';
+import type { WorkbenchAppAdapters } from '../../adapters/types';
+import type { WorkbenchAppConfig } from '../../config/workbenchAppConfig';
+import type { WorkbenchAppExtensions } from '../../extensions';
+export interface WorkbenchAppContextSource {
+    adapters: Partial<WorkbenchAppAdapters>;
+    config: WorkbenchAppConfig;
+    extensions: WorkbenchAppExtensions;
+}
+export interface WorkbenchAppContext {
+    adapters: Readonly<Ref<Partial<WorkbenchAppAdapters>>>;
+    config: Readonly<Ref<WorkbenchAppConfig>>;
+    extensions: Readonly<Ref<WorkbenchAppExtensions>>;
+}
+export declare const WORKBENCH_APP_CONTEXT_KEY: InjectionKey<WorkbenchAppContext>;
+/**
+ * 从 Vue reactive props 创建可跟随引用替换的只读工作台上下文。
+ * @param source - WorkbenchWorkspaceCore 的响应式 props。
+ * @returns 包含 adapters、config 和 extensions 只读 refs 的上下文。
+ */
+export declare function createWorkbenchAppContext(source: WorkbenchAppContextSource): WorkbenchAppContext;
+/**
+ * 读取最近的工作台应用上下文。
+ * @returns 工作台配置、适配器和扩展。
+ * @throws 当组件未挂载在 WorkbenchWorkspaceCore 下时抛出错误。
+ */
+export declare function useWorkbenchAppContext(): WorkbenchAppContext;

package/dist/runtime/conversation/workbenchChatMessageOrdering.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @fileoverview 工作台聊天消息排序工具 - 维护最终回答和插卡推荐的展示顺序。
+ * @author seadon
+ * @created 2026-07-29
+ */
+type WorkbenchChatOrderedMessage = {
+    id?: string;
+    role?: string;
+    content?: string;
+    workbenchTurnId?: string;
+    cardRecommendationDraft?: unknown;
+};
+export interface WorkbenchChatMessageOrderController<TMessage extends WorkbenchChatOrderedMessage> {
+    appendedMessages: Map<string, TMessage>;
+    messages: TMessage[];
+}
+export interface WorkbenchChatStructuredMessageFields {
+    attachments?: unknown;
+    cards?: unknown;
+    cardRecommendationDraft?: unknown;
+    defaultExpanded?: unknown;
+    detail?: unknown;
+    error?: unknown;
+    initialEventsPending?: unknown;
+    markThinking?: unknown;
+    memoryCaptureDraft?: unknown;
+    planDraft?: unknown;
+    processInvocations?: unknown;
+    processPreamble?: unknown;
+    queryResultTable?: unknown;
+    queryResultTables?: unknown;
+    registeredCardInsertDraft?: unknown;
+    removeThinking?: unknown;
+    taskStateDraft?: unknown;
+    thinkingProcess?: unknown;
+    thinkingProcessMessages?: unknown;
+    workbenchTurnId?: unknown;
+}
+/**
+ * Syncs structured ai-chat payload fields when an existing streamed message is refreshed.
+ * @param target - Existing rendered message.
+ * @param source - Latest message payload from the workbench stream bridge.
+ */
+export declare function syncWorkbenchChatStructuredMessageFields(target: WorkbenchChatStructuredMessageFields, source: WorkbenchChatStructuredMessageFields): void;
+/**
+ * 将推荐卡片消息放回来源 turn 的回答之后，避免刷新历史时统一堆到对话底部。
+ * @param controller - Message queue controller used by the chat transport.
+ */
+export declare function placeCardRecommendationDraftMessagesAfterTurnReplies<TMessage extends WorkbenchChatOrderedMessage>(controller: WorkbenchChatMessageOrderController<TMessage>): void;
+export {};

package/dist/runtime/conversation/workbenchChatStatusCompletion.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @fileoverview 工作台聊天状态完成文案 - 区分模型自述过程与工具调用过程。
+ * @author seadon
+ * @created 2026-07-08
+ */
+import type { FsesAiChatTransportMessageInput } from '@fses/ai-chat';
+type WorkbenchStatusCompletionMessage = Pick<FsesAiChatTransportMessageInput, 'content' | 'processInvocations' | 'thinkingProcess' | 'loading' | 'startTime' | 'endTime'>;
+export interface WorkbenchCompletedStatusPatch {
+    content: string;
+    loading: false;
+    startTime?: number;
+    endTime?: number;
+}
+/**
+ * 生成工作台状态行完成后的展示文案。
+ * @param message - 工作台聊天状态消息。
+ * @returns 完成态展示文案。
+ */
+export declare function resolveWorkbenchCompletedStatusContent(message: WorkbenchStatusCompletionMessage): string;
+/**
+ * 生成运行中状态行在工作台 turn 终态后的收尾补丁。
+ * @param message - 工作台聊天状态消息。
+ * @param fallbackEndTime - 服务端终态时间兜底。
+ * @returns 可直接合并到聊天状态消息的完成态字段。
+ */
+export declare function resolveWorkbenchCompletedStatusPatch(message: WorkbenchStatusCompletionMessage, fallbackEndTime?: number): WorkbenchCompletedStatusPatch;
+export {};

package/dist/runtime/conversation/workbenchChatTurnSignature.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview 工作台聊天 turn 签名工具 - 为聊天同步 watcher 提供轻量变更摘要。
+ * @author seadon
+ * @created 2026-08-06
+ */
+/**
+ * 生成返回项 payload 的轻量摘要，保留可触发聊天同步的结构信号。
+ * @param payload - 工作台返回项 payload。
+ * @returns 可用于 watcher 的轻量签名。
+ */
+export declare function returnItemPayloadSignature(payload: unknown): string;

package/dist/runtime/data-binding/workbenchDataBindingRefreshPolicy.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @fileoverview 工作台数据绑定刷新策略 - 统一控制渲染器挂载后的自动问数刷新
+ * @author seadon
+ * @created 2026-05-11
+ */
+export interface WorkbenchDataBindingRefreshLike {
+    bindingKind?: unknown;
+    dataPayload?: unknown;
+    dataVersion?: unknown;
+    lastRefreshedAt?: unknown;
+    refreshApi?: unknown;
+    status?: unknown;
+    params?: unknown;
+    sourceType?: unknown;
+    updatedAt?: unknown;
+}
+export interface WorkbenchDataBindingRefreshPolicyContext {
+    data?: unknown;
+    meta?: unknown;
+    recognition?: unknown;
+    source?: unknown;
+    sourceType?: unknown;
+    suppressImageComposeAutoRefresh?: boolean;
+}
+/**
+ * 读取可用的刷新接口路径。
+ * @param value - 数据绑定刷新元信息。
+ * @returns trim 后的 refreshApi，缺失时返回空字符串。
+ */
+export declare function workbenchDataBindingRefreshApi(value: WorkbenchDataBindingRefreshLike | undefined): string;
+/**
+ * 判断渲染器挂载后是否应该主动调用数据绑定刷新接口。
+ * @param value - 数据绑定刷新元信息。
+ * @returns true 表示允许自动刷新，false 表示无刷新接口、手动候选入口、活跃服务端回填或非终态刷新。
+ */
+export declare function shouldAutoRefreshWorkbenchDataBinding(value: WorkbenchDataBindingRefreshLike | undefined, context?: WorkbenchDataBindingRefreshPolicyContext): boolean;

package/dist/runtime/deep-agent/deepAgentProcessGroups.d.ts

@@ -0,0 +1,84 @@
+/**
+ * @fileoverview DeepAgent 处理过程归约 - 将公开过程事件转换为会话过程树。
+ * @author seadon
+ * @created 2026-07-05
+ */
+import type { ConversationProcessInvocationKind, ConversationProcessStatus, ConversationTurn } from '@fses/workbench-card/types';
+export type TerminalStatus = 'completed' | 'failed' | 'interrupted' | 'cancelled';
+interface BaseDeepAgentProcessUiEvent {
+    runId: string;
+    threadId?: string;
+    seq: number;
+    createdAt: string;
+    sourceMessageId?: string;
+}
+export type DeepAgentProcessUiEvent = (BaseDeepAgentProcessUiEvent & {
+    type: 'process_step_started';
+    stepId: string;
+    title: string;
+    summary?: string;
+}) | (BaseDeepAgentProcessUiEvent & {
+    type: 'process_step_completed';
+    stepId: string;
+    summary?: string;
+    status: ConversationProcessStatus;
+}) | (BaseDeepAgentProcessUiEvent & {
+    type: 'invocation_started';
+    stepId?: string;
+    invocationId: string;
+    invocationKind: ConversationProcessInvocationKind;
+    name: string;
+    label?: string;
+    summary?: string;
+    inputSummary?: string;
+}) | (BaseDeepAgentProcessUiEvent & {
+    type: 'invocation_completed';
+    stepId?: string;
+    invocationId: string;
+    invocationKind: ConversationProcessInvocationKind;
+    name: string;
+    summary?: string;
+    resultSummary?: string;
+    durationMs?: number;
+    status: ConversationProcessStatus;
+    publicPayload?: unknown;
+}) | (BaseDeepAgentProcessUiEvent & {
+    type: 'run_completed';
+    terminalStatus: TerminalStatus;
+});
+/**
+ * 将 DeepAgent 公开过程事件归约到 ConversationTurn。
+ * @param turn - 当前会话轮次
+ * @param event - DeepAgent 公开过程事件
+ * @returns 更新后的会话轮次
+ */
+export declare function applyDeepAgentProcessEventToTurn(turn: ConversationTurn, event: DeepAgentProcessUiEvent): ConversationTurn;
+/**
+ * 用户手动切换处理过程容器折叠状态。
+ * @param turn - 当前会话轮次
+ * @returns 切换后的会话轮次
+ */
+export declare function toggleConversationProcessCollapsed(turn: ConversationTurn): ConversationTurn;
+export interface DeepAgentPreambleMessageUiEvent {
+    content: string;
+    createdAt: string;
+    done: boolean;
+    messageId: string;
+    runId: string;
+    threadId?: string;
+}
+/**
+ * 将 channel=preamble 的 assistant message 写入临时过程组。
+ * @param turn - 当前会话轮次
+ * @param event - preamble message 事件
+ * @returns 更新后的会话轮次
+ */
+export declare function applyDeepAgentPreambleMessageToTurn(turn: ConversationTurn, event: DeepAgentPreambleMessageUiEvent): ConversationTurn;
+/**
+ * 移除已被正式 process_step 接管的临时 preamble 过程组。
+ * @param turn - 当前会话轮次
+ * @param sourceMessageId - process_step.sourceMessageId
+ * @returns 更新后的会话轮次
+ */
+export declare function removeTemporaryPreambleProcessGroup(turn: ConversationTurn, sourceMessageId: string | undefined): ConversationTurn;
+export {};

package/dist/runtime/deep-agent/deepAgentProgressMessage.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @fileoverview DeepAgent 进度消息工具 - 拆分可见进度前缀和最终回答。
+ * @author seadon
+ * @created 2026-07-02
+ */
+export declare const DEEP_AGENT_VISIBLE_PROGRESS_TEXTS: string[];
+export interface DeepAgentProgressMessageParts {
+    progressText: string;
+    finalText: string;
+}
+/**
+ * 判断当前累计内容是否仍可能只是固定 DeepAgent 进度文案的前缀。
+ * @param content - 当前累计消息文本。
+ * @returns 仍可能补齐为固定进度文案时返回 true。
+ */
+export declare function isPossibleDeepAgentProgressMessagePrefix(content: string): boolean;
+/**
+ * 拆分 DeepAgent 完成消息中的可见进度前缀和最终回答。
+ * @param content - DeepAgent message_completed 的完整文本。
+ * @returns progressText 用于思考过程，finalText 用于最终回复。
+ */
+export declare function splitDeepAgentProgressMessage(content: string): DeepAgentProgressMessageParts;

package/dist/runtime/deep-agent/deepAgentToolDisplayName.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview DeepAgent 工具中文展示名 - 为实时过程、最终回答和历史回显提供前端兜底标签。
+ * @author seadon
+ * @created 2026-07-05
+ */
+export declare const DEEP_AGENT_TOOL_DISPLAY_NAMES: Record<string, string>;
+/**
+ * 获取 DeepAgent 工具的用户可见中文展示名。
+ * @param toolName - 原始工具名。
+ * @returns 中文展示名；未知工具返回原始工具名。
+ */
+export declare function deepAgentToolDisplayName(toolName: string): string;