@fses/workbench-app 0.1.0

package/dist/internal/personal-workbench/lib/vueRuntimeAdapters.d.ts

@@ -0,0 +1,450 @@
+/**
+ * @fileoverview 工作台 Vue 运行态适配工具 - 负责将流式事件归约为对话、画布和历史上下文状态。
+ * @author seadon
+ * @created 2026-05-31
+ */
+import type { ActivityItem, RuntimeMessage, WorkbenchConversationSummary } from '@workbench-internal/vue-types/workbenchRuntime';
+import type { AssistantPersonaKey, ConversationProcessGroup, ConversationReturnItem, ConversationTaskState, ConversationTurn, ConversationTurnTraceItem, LayoutConfig, MaterializedBlock, PlanResponse, PreviewSnapshotDraft, RoleId, StreamActionItem, WorkbenchPlanStreamEvent, WorkbenchSnapshot, WorklogStageText } from '@fses/workbench-app/types';
+type StreamMessageEvent = Extract<WorkbenchPlanStreamEvent, {
+    type: 'stream_message';
+}>;
+type TraceEvent = Extract<WorkbenchPlanStreamEvent, {
+    type: 'trace';
+}>;
+type PlanningAgentPlanEvent = Extract<WorkbenchPlanStreamEvent, {
+    type: 'planning.agent_plan';
+}>;
+type PlanningPolicyGuardEvent = Extract<WorkbenchPlanStreamEvent, {
+    type: 'planning.policy_guard';
+}>;
+type ProcessLineEvent = Extract<WorkbenchPlanStreamEvent, {
+    type: 'process.line';
+}>;
+type PatchPlanReadyEvent = Extract<WorkbenchPlanStreamEvent, {
+    type: 'patch_plan_ready';
+}>;
+type NeedsConfirmationEvent = Extract<WorkbenchPlanStreamEvent, {
+    type: 'needs_confirmation';
+}>;
+type StatusPulseEvent = Extract<WorkbenchPlanStreamEvent, {
+    type: 'status.pulse';
+}>;
+type ActionStreamEvent = Extract<WorkbenchPlanStreamEvent, {
+    type: 'action.started' | 'action.done' | 'action.failed';
+}>;
+type FinalDeltaEvent = Extract<WorkbenchPlanStreamEvent, {
+    type: 'final.delta';
+}>;
+type UsageStreamEvent = Extract<WorkbenchPlanStreamEvent, {
+    type: 'usage';
+}>;
+type TaskStateEvent = Extract<WorkbenchPlanStreamEvent, {
+    type: 'task_state';
+}>;
+export declare function createRuntimeId(prefix: string): string;
+export declare function createTraceItem(category: ConversationTurnTraceItem['category'], title: string, detail: string, status?: ConversationTurnTraceItem['status'], rawPayload?: string, humanReadable?: string): ConversationTurnTraceItem;
+export declare function createReturnItem(kind: ConversationReturnItem['kind'], title: string, summary: string, payload?: unknown, options?: Partial<Pick<ConversationReturnItem, 'id' | 'status' | 'collapsed' | 'payloadLabel'>>): ConversationReturnItem;
+export declare function appendReturnItem(turn: ConversationTurn, item: ConversationReturnItem): ConversationTurn;
+/**
+ * 清理可持久化历史返回项，避免 SQL 等技术细节进入历史会话。
+ * @param item - 运行时返回项。
+ * @returns 去除技术细节后的历史返回项。
+ */
+export declare function sanitizeReturnItemForHistory(item: ConversationReturnItem): ConversationReturnItem;
+/**
+ * 清理可进入下一轮上下文或历史恢复的 turn，避免当前会话技术细节跨轮透传。
+ * @param turn - 运行时对话轮次。
+ * @returns 已清理返回项技术细节的对话轮次。
+ */
+export declare function sanitizeTurnForHistory(turn: ConversationTurn): ConversationTurn;
+/**
+ * 提取可传给后端连续对话的助手历史文本。
+ * @param turn - 已清理的运行时对话轮次。
+ * @returns 助手最终回答或最近的澄清/结论摘要；没有可读内容时返回空字符串。
+ */
+export declare function conversationTurnAssistantHistoryContent(turn: ConversationTurn): string;
+export declare function createTurn(userPrompt: string): ConversationTurn;
+/**
+ * 将 DeepAgent transcript 分页结果恢复为工作台会话 turn。
+ * @param response - /deep-agent/messages 返回值。
+ * @param conversationId - DeepAgent thread id。
+ * @returns 可直接写入运行态 store 的历史 turns。
+ */
+export declare function turnsFromDeepAgentTranscriptMessages(response: unknown, conversationId: string): ConversationTurn[];
+export declare function createConversationId(): string;
+export declare function compactConversationTitle(value: string): string;
+export declare function buildConversationTitle(planResult: PlanResponse, fallback: string): string;
+export declare function applyStreamMessageEvent(turn: ConversationTurn, event: StreamMessageEvent): {
+    returnItems: ConversationReturnItem[];
+    updatedAt: string;
+    id: string;
+    conversationId?: string;
+    title?: string;
+    mode: import("@fses/workbench-card").WorkbenchTurnMode;
+    intentChannel: import("@fses/workbench-card").WorkbenchIntentChannel;
+    userPrompt: string;
+    assistantStreamingText: string;
+    assistantFinalText: string;
+    assistantConclusion: string;
+    planResult?: PlanResponse;
+    layoutDraft?: import("@fses/workbench-card").LayoutDraft;
+    previewDraft?: PreviewSnapshotDraft;
+    rollbackSnapshot?: WorkbenchSnapshot;
+    mutationTransaction?: import("@fses/workbench-card").MutationTransaction;
+    traceItems: ConversationTurnTraceItem[];
+    streamActions?: StreamActionItem[];
+    confirmation?: import("@fses/workbench-card").ConversationConfirmation;
+    taskStates?: ConversationTaskState[];
+    worklogStartedAt?: string;
+    worklogEndedAt?: string;
+    worklogStageText?: WorklogStageText;
+    worklogStageDetail?: string;
+    worklogStageVisible?: boolean;
+    worklogCollapsed?: boolean;
+    finalContentVisible?: boolean;
+    pendingPatch?: import("@fses/workbench-card").PendingWorkbenchPatch | null;
+    processCollapsed?: boolean;
+    processCollapseSource?: import("@fses/workbench-card").ConversationProcessCollapseSource;
+    processGroups?: ConversationProcessGroup[];
+    status: import("@fses/workbench-card").ConversationTurnStatus;
+    createdAt: string;
+    error?: string;
+    suppressErrorDisplay?: boolean;
+    collapsed?: boolean;
+};
+/**
+ * 应用智能体规划事件。
+ * @param turn - 当前 turn。
+ * @param event - 后端规划事件。
+ * @returns 更新后的 turn。
+ */
+export declare function applyPlanningAgentPlanEvent(turn: ConversationTurn, event: PlanningAgentPlanEvent): ConversationTurn;
+/**
+ * 应用规划策略检查事件。
+ * @param turn - 当前 turn。
+ * @param event - 后端策略检查事件。
+ * @returns 更新后的 turn。
+ */
+export declare function applyPlanningPolicyGuardEvent(turn: ConversationTurn, event: PlanningPolicyGuardEvent): ConversationTurn;
+export declare function applyProcessLineEvent(turn: ConversationTurn, event: ProcessLineEvent): ConversationTurn;
+/**
+ * 将任务状态 SSE 事件写入当前 turn，并按 taskId 更新已有任务状态。
+ * @param turn - 当前对话轮次。
+ * @param event - 后端任务状态 SSE 事件。
+ * @returns 写入任务状态后的对话轮次。
+ */
+export declare function applyTaskStateEvent(turn: ConversationTurn, event: TaskStateEvent): ConversationTurn;
+/**
+ * 将卡片修改方案事件写入返回项，作为流式过程消息展示给用户。
+ * @param turn - 当前对话轮次。
+ * @param event - 后端返回的卡片修改方案事件。
+ * @returns 写入方案返回项后的对话轮次。
+ */
+export declare function applyPatchPlanReadyEvent(turn: ConversationTurn, event: PatchPlanReadyEvent): {
+    returnItems: ConversationReturnItem[];
+    updatedAt: string;
+    id: string;
+    conversationId?: string;
+    title?: string;
+    mode: import("@fses/workbench-card").WorkbenchTurnMode;
+    intentChannel: import("@fses/workbench-card").WorkbenchIntentChannel;
+    userPrompt: string;
+    assistantStreamingText: string;
+    assistantFinalText: string;
+    assistantConclusion: string;
+    planResult?: PlanResponse;
+    layoutDraft?: import("@fses/workbench-card").LayoutDraft;
+    previewDraft?: PreviewSnapshotDraft;
+    rollbackSnapshot?: WorkbenchSnapshot;
+    mutationTransaction?: import("@fses/workbench-card").MutationTransaction;
+    traceItems: ConversationTurnTraceItem[];
+    streamActions?: StreamActionItem[];
+    confirmation?: import("@fses/workbench-card").ConversationConfirmation;
+    taskStates?: ConversationTaskState[];
+    worklogStartedAt?: string;
+    worklogEndedAt?: string;
+    worklogStageText?: WorklogStageText;
+    worklogStageDetail?: string;
+    worklogStageVisible?: boolean;
+    worklogCollapsed?: boolean;
+    finalContentVisible?: boolean;
+    pendingPatch?: import("@fses/workbench-card").PendingWorkbenchPatch | null;
+    processCollapsed?: boolean;
+    processCollapseSource?: import("@fses/workbench-card").ConversationProcessCollapseSource;
+    processGroups?: ConversationProcessGroup[];
+    status: import("@fses/workbench-card").ConversationTurnStatus;
+    createdAt: string;
+    error?: string;
+    suppressErrorDisplay?: boolean;
+    collapsed?: boolean;
+};
+/**
+ * 将确认请求事件写入 turn 状态和返回项，保证左右两侧都有统一的渲染数据。
+ * @param turn - 当前对话轮次。
+ * @param event - 后端流式返回的确认请求事件。
+ * @returns 写入确认信息和 confirmation 返回项后的对话轮次。
+ */
+export declare function applyNeedsConfirmationEvent(turn: ConversationTurn, event: NeedsConfirmationEvent): {
+    returnItems: ConversationReturnItem[];
+    updatedAt: string;
+    id: string;
+    conversationId?: string;
+    title?: string;
+    mode: import("@fses/workbench-card").WorkbenchTurnMode;
+    intentChannel: import("@fses/workbench-card").WorkbenchIntentChannel;
+    userPrompt: string;
+    assistantStreamingText: string;
+    assistantFinalText: string;
+    assistantConclusion: string;
+    planResult?: PlanResponse;
+    layoutDraft?: import("@fses/workbench-card").LayoutDraft;
+    previewDraft?: PreviewSnapshotDraft;
+    rollbackSnapshot?: WorkbenchSnapshot;
+    mutationTransaction?: import("@fses/workbench-card").MutationTransaction;
+    traceItems: ConversationTurnTraceItem[];
+    streamActions?: StreamActionItem[];
+    confirmation?: import("@fses/workbench-card").ConversationConfirmation;
+    taskStates?: ConversationTaskState[];
+    worklogStartedAt?: string;
+    worklogEndedAt?: string;
+    worklogStageText?: WorklogStageText;
+    worklogStageDetail?: string;
+    worklogStageVisible?: boolean;
+    worklogCollapsed?: boolean;
+    finalContentVisible?: boolean;
+    pendingPatch?: import("@fses/workbench-card").PendingWorkbenchPatch | null;
+    processCollapsed?: boolean;
+    processCollapseSource?: import("@fses/workbench-card").ConversationProcessCollapseSource;
+    processGroups?: ConversationProcessGroup[];
+    status: import("@fses/workbench-card").ConversationTurnStatus;
+    createdAt: string;
+    error?: string;
+    suppressErrorDisplay?: boolean;
+    collapsed?: boolean;
+};
+export declare function applyStatusPulseEvent(turn: ConversationTurn, event: StatusPulseEvent): {
+    worklogStageText: WorklogStageText;
+    worklogStageDetail: WorklogStageText;
+    worklogStageVisible: boolean;
+    updatedAt: string;
+    id: string;
+    conversationId?: string;
+    title?: string;
+    mode: import("@fses/workbench-card").WorkbenchTurnMode;
+    intentChannel: import("@fses/workbench-card").WorkbenchIntentChannel;
+    userPrompt: string;
+    assistantStreamingText: string;
+    assistantFinalText: string;
+    assistantConclusion: string;
+    planResult?: PlanResponse;
+    layoutDraft?: import("@fses/workbench-card").LayoutDraft;
+    previewDraft?: PreviewSnapshotDraft;
+    rollbackSnapshot?: WorkbenchSnapshot;
+    mutationTransaction?: import("@fses/workbench-card").MutationTransaction;
+    traceItems: ConversationTurnTraceItem[];
+    returnItems: ConversationReturnItem[];
+    streamActions?: StreamActionItem[];
+    confirmation?: import("@fses/workbench-card").ConversationConfirmation;
+    taskStates?: ConversationTaskState[];
+    worklogStartedAt?: string;
+    worklogEndedAt?: string;
+    worklogCollapsed?: boolean;
+    finalContentVisible?: boolean;
+    pendingPatch?: import("@fses/workbench-card").PendingWorkbenchPatch | null;
+    processCollapsed?: boolean;
+    processCollapseSource?: import("@fses/workbench-card").ConversationProcessCollapseSource;
+    processGroups?: ConversationProcessGroup[];
+    status: import("@fses/workbench-card").ConversationTurnStatus;
+    createdAt: string;
+    error?: string;
+    suppressErrorDisplay?: boolean;
+    collapsed?: boolean;
+};
+export declare function applyActionStreamEvent(turn: ConversationTurn, event: ActionStreamEvent): {
+    streamActions: StreamActionItem[];
+    returnItems: ConversationReturnItem[];
+    worklogStageText: WorklogStageText;
+    worklogStageDetail: WorklogStageText;
+    worklogStageVisible: boolean;
+    updatedAt: string;
+    id: string;
+    conversationId?: string;
+    title?: string;
+    mode: import("@fses/workbench-card").WorkbenchTurnMode;
+    intentChannel: import("@fses/workbench-card").WorkbenchIntentChannel;
+    userPrompt: string;
+    assistantStreamingText: string;
+    assistantFinalText: string;
+    assistantConclusion: string;
+    planResult?: PlanResponse;
+    layoutDraft?: import("@fses/workbench-card").LayoutDraft;
+    previewDraft?: PreviewSnapshotDraft;
+    rollbackSnapshot?: WorkbenchSnapshot;
+    mutationTransaction?: import("@fses/workbench-card").MutationTransaction;
+    traceItems: ConversationTurnTraceItem[];
+    confirmation?: import("@fses/workbench-card").ConversationConfirmation;
+    taskStates?: ConversationTaskState[];
+    worklogStartedAt?: string;
+    worklogEndedAt?: string;
+    worklogCollapsed?: boolean;
+    finalContentVisible?: boolean;
+    pendingPatch?: import("@fses/workbench-card").PendingWorkbenchPatch | null;
+    processCollapsed?: boolean;
+    processCollapseSource?: import("@fses/workbench-card").ConversationProcessCollapseSource;
+    processGroups?: ConversationProcessGroup[];
+    status: import("@fses/workbench-card").ConversationTurnStatus;
+    createdAt: string;
+    error?: string;
+    suppressErrorDisplay?: boolean;
+    collapsed?: boolean;
+};
+export declare function applyFinalDeltaEvent(turn: ConversationTurn, event: FinalDeltaEvent): ConversationTurn;
+export declare function applyUsageStreamEvent(turn: ConversationTurn, event: UsageStreamEvent): {
+    returnItems: ConversationReturnItem[];
+    updatedAt: string;
+    id: string;
+    conversationId?: string;
+    title?: string;
+    mode: import("@fses/workbench-card").WorkbenchTurnMode;
+    intentChannel: import("@fses/workbench-card").WorkbenchIntentChannel;
+    userPrompt: string;
+    assistantStreamingText: string;
+    assistantFinalText: string;
+    assistantConclusion: string;
+    planResult?: PlanResponse;
+    layoutDraft?: import("@fses/workbench-card").LayoutDraft;
+    previewDraft?: PreviewSnapshotDraft;
+    rollbackSnapshot?: WorkbenchSnapshot;
+    mutationTransaction?: import("@fses/workbench-card").MutationTransaction;
+    traceItems: ConversationTurnTraceItem[];
+    streamActions?: StreamActionItem[];
+    confirmation?: import("@fses/workbench-card").ConversationConfirmation;
+    taskStates?: ConversationTaskState[];
+    worklogStartedAt?: string;
+    worklogEndedAt?: string;
+    worklogStageText?: WorklogStageText;
+    worklogStageDetail?: string;
+    worklogStageVisible?: boolean;
+    worklogCollapsed?: boolean;
+    finalContentVisible?: boolean;
+    pendingPatch?: import("@fses/workbench-card").PendingWorkbenchPatch | null;
+    processCollapsed?: boolean;
+    processCollapseSource?: import("@fses/workbench-card").ConversationProcessCollapseSource;
+    processGroups?: ConversationProcessGroup[];
+    status: import("@fses/workbench-card").ConversationTurnStatus;
+    createdAt: string;
+    error?: string;
+    suppressErrorDisplay?: boolean;
+    collapsed?: boolean;
+};
+export declare function applyTraceEvent(turn: ConversationTurn, event: TraceEvent): {
+    returnItems: ConversationReturnItem[];
+    updatedAt: string;
+    id: string;
+    conversationId?: string;
+    title?: string;
+    mode: import("@fses/workbench-card").WorkbenchTurnMode;
+    intentChannel: import("@fses/workbench-card").WorkbenchIntentChannel;
+    userPrompt: string;
+    assistantStreamingText: string;
+    assistantFinalText: string;
+    assistantConclusion: string;
+    planResult?: PlanResponse;
+    layoutDraft?: import("@fses/workbench-card").LayoutDraft;
+    previewDraft?: PreviewSnapshotDraft;
+    rollbackSnapshot?: WorkbenchSnapshot;
+    mutationTransaction?: import("@fses/workbench-card").MutationTransaction;
+    traceItems: ConversationTurnTraceItem[];
+    streamActions?: StreamActionItem[];
+    confirmation?: import("@fses/workbench-card").ConversationConfirmation;
+    taskStates?: ConversationTaskState[];
+    worklogStartedAt?: string;
+    worklogEndedAt?: string;
+    worklogStageText?: WorklogStageText;
+    worklogStageDetail?: string;
+    worklogStageVisible?: boolean;
+    worklogCollapsed?: boolean;
+    finalContentVisible?: boolean;
+    pendingPatch?: import("@fses/workbench-card").PendingWorkbenchPatch | null;
+    processCollapsed?: boolean;
+    processCollapseSource?: import("@fses/workbench-card").ConversationProcessCollapseSource;
+    processGroups?: ConversationProcessGroup[];
+    status: import("@fses/workbench-card").ConversationTurnStatus;
+    createdAt: string;
+    error?: string;
+    suppressErrorDisplay?: boolean;
+    collapsed?: boolean;
+};
+export declare function finishStreamedTurn(turn: ConversationTurn, fillFinalText?: boolean): {
+    assistantFinalText: string;
+    status: ConversationTurn["status"];
+    processGroups: ConversationProcessGroup[];
+    worklogEndedAt: string;
+    worklogStageVisible: boolean;
+    worklogCollapsed: boolean;
+    finalContentVisible: boolean;
+    updatedAt: string;
+    id: string;
+    conversationId?: string;
+    title?: string;
+    mode: import("@fses/workbench-card").WorkbenchTurnMode;
+    intentChannel: import("@fses/workbench-card").WorkbenchIntentChannel;
+    userPrompt: string;
+    assistantStreamingText: string;
+    assistantConclusion: string;
+    planResult?: PlanResponse;
+    layoutDraft?: import("@fses/workbench-card").LayoutDraft;
+    previewDraft?: PreviewSnapshotDraft;
+    rollbackSnapshot?: WorkbenchSnapshot;
+    mutationTransaction?: import("@fses/workbench-card").MutationTransaction;
+    traceItems: ConversationTurnTraceItem[];
+    returnItems: ConversationReturnItem[];
+    streamActions?: StreamActionItem[];
+    confirmation?: import("@fses/workbench-card").ConversationConfirmation;
+    taskStates?: ConversationTaskState[];
+    worklogStartedAt?: string;
+    worklogStageText?: WorklogStageText;
+    worklogStageDetail?: string;
+    pendingPatch?: import("@fses/workbench-card").PendingWorkbenchPatch | null;
+    processCollapsed?: boolean;
+    processCollapseSource?: import("@fses/workbench-card").ConversationProcessCollapseSource;
+    createdAt: string;
+    error?: string;
+    suppressErrorDisplay?: boolean;
+    collapsed?: boolean;
+};
+export declare function updateTurn(turns: ConversationTurn[], turnId: string, updater: (turn: ConversationTurn) => ConversationTurn): ConversationTurn[];
+export declare function sortBlocks(blocks: MaterializedBlock[]): MaterializedBlock[];
+export declare function finalizePreviewBlock(block: MaterializedBlock): MaterializedBlock;
+export declare function mergePreviewLayoutConfig(current: LayoutConfig | undefined, preview: LayoutConfig): {
+    cols: number;
+    rows: number;
+    maxRows: number;
+    maxCols: number;
+    isSquareCell: boolean;
+    layoutVersion: number;
+};
+export declare function applyPreviewDraftDeltaToSnapshot(snapshot: WorkbenchSnapshot, previewDraft: PreviewSnapshotDraft): MaterializedBlock[];
+export declare function summarizeSnapshot(snapshot: WorkbenchSnapshot | null, roleId: RoleId | '', selectedBlockId?: string | null, assistantPersona?: AssistantPersonaKey): {
+    workspaceId: string;
+    roleId: "" | RoleId;
+    blockCount: number;
+    blockTitles: string[];
+    layoutConfig: LayoutConfig;
+    assistantPersona: {
+        prompt: string;
+        key: AssistantPersonaKey;
+        label: string;
+        shortDescription: string;
+    };
+    selectedBlock: {
+        id: string;
+        title: string;
+        blockType: import("@fses/workbench-card").BlockType;
+        subType: string;
+    };
+};
+export declare function buildConversationSummaries(turns: ConversationTurn[], archivedConversationIds: string[]): WorkbenchConversationSummary[];
+export declare function buildRuntimeMessages(turns: ConversationTurn[]): RuntimeMessage[];
+export declare function buildRuntimeActivities(turns: ConversationTurn[]): ActivityItem[];
+export {};