@fses/workbench-app 0.1.0

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

@@ -0,0 +1,107 @@
+/**
+ * @fileoverview 工作台分栏策略 - 统一计算左侧画布与右侧 AI 面板的默认宽度
+ * @author seadon
+ * @created 2026-05-15
+ */
+import type { MaterializedBlock, WorkbenchSnapshot } from '@fses/workbench-app/types';
+export declare const DEFAULT_WORKBENCH_STUDIO_PANEL_WIDTH = 320;
+export declare const WORKBENCH_SHELL_MIN_WIDTH = 1180;
+export declare const WORKBENCH_SPLITTER_WIDTH = 8;
+export declare const IMAGE_COMPOSE_AUTO_CANVAS_FOCUS_MAX_WIDTH = 1080;
+/**
+ * Checks whether a materialized card came from image reconstruction.
+ * @param block - Workbench block from the active snapshot.
+ * @returns True when image-generated layout should prioritize canvas fidelity.
+ */
+export declare function blockHasImageComposeSource(block: Pick<MaterializedBlock, 'id' | 'meta' | 'source' | 'data'>): boolean;
+/**
+ * Calculates the preferred source screenshot width for image-composed dashboards.
+ * @param snapshot - Current workbench snapshot.
+ * @returns Source frame width, or undefined when source-width evidence is unavailable.
+ */
+export declare function imageComposeSourceCanvasWidthFromSnapshot(snapshot: Pick<WorkbenchSnapshot, 'blocks'> | null | undefined): number | undefined;
+/**
+ * Checks whether the active snapshot was reconstructed from an uploaded image.
+ * @param snapshot - Workbench snapshot loaded from storage or image compose.
+ * @returns True when the first viewport must preserve screenshot top-left origin.
+ */
+export declare function snapshotHasImageComposeSource(snapshot: Pick<WorkbenchSnapshot, 'blocks'> | null | undefined): boolean;
+/**
+ * 将工作台左右分栏比例限制在可用范围内。
+ * @param value - 左侧工作台占整体宽度的百分比
+ * @returns 经过上下限保护后的左侧宽度百分比
+ */
+export declare function clampWorkbenchSplitRatio(value: number): number;
+/**
+ * 获取参与分栏计算的工作台外壳宽度。
+ * @param viewportWidth - 当前浏览器可视区宽度，缺省时使用最小外壳宽度
+ * @returns 不小于工作台最小宽度的分栏计算宽度
+ */
+export declare function effectiveWorkbenchShellWidth(viewportWidth?: number): number;
+/**
+ * 判断图生工作台是否应在窄视口下默认进入画布优先。
+ * @param viewportWidth - 当前浏览器可视区宽度。
+ * @returns 视口不足以同时保证右侧助手和图生卡可读时返回 true。
+ */
+export declare function shouldAutoFocusImageComposeCanvas(viewportWidth?: number, options?: {
+    sourceCanvasWidth?: number;
+    studioPanelWidth?: number;
+}): boolean;
+/**
+ * 根据期望的右侧 AI 面板宽度反算左侧工作台分栏比例。
+ * @param studioPanelWidth - 右侧 AI 面板目标宽度
+ * @param viewportWidth - 当前浏览器可视区宽度
+ * @returns 左侧工作台占整体宽度的百分比
+ */
+export declare function studioPanelWidthToSplitRatio(studioPanelWidth?: number, viewportWidth?: number): number;
+/**
+ * 根据左侧分栏比例计算右侧 AI 面板的实际宽度。
+ * @param splitRatio - 左侧工作台占整体宽度的百分比
+ * @param viewportWidth - 当前浏览器可视区宽度
+ * @returns 右侧 AI 面板宽度
+ */
+export declare function splitRatioToStudioPanelWidth(splitRatio: number, viewportWidth?: number): number;
+/**
+ * 将右侧 AI 面板像素宽度限制在当前外壳可用范围内。
+ * @param value - 候选右侧面板宽度
+ * @param viewportWidth - 当前工作台外壳宽度
+ * @returns 可用于右侧面板 flex-basis 的像素宽度
+ */
+export declare function clampWorkbenchStudioPanelWidth(value: number, viewportWidth?: number, options?: {
+    minWidth?: number;
+}): number;
+/**
+ * 根据工作台外壳右边界计算右侧 AI 面板拖拽宽度。
+ * @param clientX - 当前鼠标在视口内的横向坐标
+ * @param shellRight - 工作台实际分栏外壳的视口右边界
+ * @param shellWidth - 工作台实际分栏外壳宽度
+ * @returns 可直接用于右侧面板 flex-basis 的像素宽度
+ */
+export declare function draggedClientXToStudioPanelWidth(clientX: number, shellRight: number, shellWidth: number): number;
+/**
+ * 判断本地记忆里的比例是否只是历史默认值。
+ * @param rememberedSplitRatio - 本地存储读取到的左侧分栏比例
+ * @returns 是历史默认值时返回 true
+ */
+export declare function isLegacyDefaultWorkbenchSplitRatio(rememberedSplitRatio?: number): boolean;
+/**
+ * 解析工作台首次渲染使用的右侧 AI 面板像素宽度。
+ * @param rememberedStudioPanelWidth - 新版本本地存储中的右侧面板像素宽度
+ * @param remembered - 旧版本本地存储中的比例信息，仅用于兼容历史默认值判断
+ * @param viewportWidth - 当前工作台外壳宽度
+ * @returns 首次渲染时右侧 AI 面板像素宽度
+ */
+export declare function resolveInitialWorkbenchStudioPanelWidth(rememberedStudioPanelWidth?: number, remembered?: {
+    splitRatio?: number;
+    splitRatioCustomized?: boolean;
+} | null, viewportWidth?: number): number;
+/**
+ * 解析工作台首次渲染使用的左右分栏比例。
+ * @param rememberedSplitRatio - 用户历史拖拽后的左侧分栏比例
+ * @param viewportWidth - 当前浏览器可视区宽度
+ * @param options - 本地记忆中的分栏元信息
+ * @returns 首次渲染时左侧工作台占整体宽度的百分比
+ */
+export declare function resolveInitialWorkbenchSplitRatio(rememberedSplitRatio?: number, viewportWidth?: number, options?: {
+    customized?: boolean;
+}): number;

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

@@ -0,0 +1,60 @@
+import type { LayoutConfig, MaterializedBlock, RoleId } from '@fses/workbench-app/types';
+export declare const SHOWCASE_ALL_TAB_ID = "all-capabilities";
+export declare const WORKBENCH_ORGANIZATION_MACRO_ID = "card.workbench_organization";
+export declare const WORKBENCH_ORG_BLOCK_ID_PREFIX = "workbench-org-";
+export interface WorkbenchShowcaseGroup {
+    id: string;
+    name: string;
+    shortName: string;
+    description: string;
+    productUse: string;
+    toneClass: string;
+}
+export interface WorkbenchShowcaseTab {
+    id: string;
+    name: string;
+    shortName: string;
+    count: number;
+    description: string;
+    productUse: string;
+    toneClass: string;
+    activeBlocks: MaterializedBlock[];
+}
+export interface WorkbenchShowcaseModel {
+    totalCount: number;
+    acceptanceCount: number;
+    categoryCount: number;
+    groupingEnabled: boolean;
+    activeTab: WorkbenchShowcaseTab;
+    tabs: WorkbenchShowcaseTab[];
+    displayBlocks: MaterializedBlock[];
+    displayLayoutConfig: LayoutConfig;
+    layoutEditable: boolean;
+    layoutScope: 'all' | 'category';
+    contentStartY: number;
+    categoryGroupStartYByTabId: Record<string, number>;
+    blockCategoryLayoutById: Record<string, {
+        tabId: string;
+        groupStartY: number;
+    }>;
+    activeBlockIds: string[];
+    organizationBlockIds: string[];
+    role: {
+        label: string;
+        focus: string;
+    };
+}
+export declare const SHOWCASE_GROUPS: WorkbenchShowcaseGroup[];
+export declare function isWorkbenchOrganizationBlock(block: MaterializedBlock): boolean;
+export declare function isWorkbenchOrganizationBlockId(blockId: string): boolean;
+export declare function isWorkbenchCategoryNavigatorBlock(block: MaterializedBlock): boolean;
+export declare function isWorkbenchTabContainerBlock(block: MaterializedBlock): boolean;
+export declare function buildWorkbenchShowcaseModel(input: {
+    blocks: MaterializedBlock[];
+    roleId: RoleId | '';
+    activeTabId: string;
+    layoutConfig: LayoutConfig;
+    suppressDefaultOrganizationBlocks?: boolean;
+    workspaceId?: string;
+    runtimePresetResourceId?: string;
+}): WorkbenchShowcaseModel;

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

@@ -0,0 +1,28 @@
+import { type ManagerOptions, type Socket, type SocketOptions } from 'socket.io-client';
+export interface WorkbenchSocketEvent {
+    eventId: string;
+    type: string;
+    workspaceId: string;
+    userId: string;
+    version: number;
+    baseVersion?: number;
+    changedCardIds: string[];
+    payload: Record<string, unknown>;
+}
+export interface WorkbenchSocketClient {
+    connect(): void;
+    disconnect(): void;
+    requestSnapshot(): void;
+}
+type WorkbenchSocketFactory = (url: string, options: Partial<ManagerOptions & SocketOptions>) => Socket;
+type WorkbenchSocketTransport = 'polling' | 'websocket';
+export declare function createWorkbenchSocketClient(input: {
+    baseUrl?: string;
+    workspaceId: string;
+    userId: string;
+    onEvent: (event: WorkbenchSocketEvent) => void;
+    socketPath?: string;
+    transports?: WorkbenchSocketTransport[];
+    socketFactory?: WorkbenchSocketFactory;
+}): WorkbenchSocketClient;
+export {};

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

@@ -0,0 +1,67 @@
+import type { AssistantPersonaKey, LayoutConfig, RoleId } from '@fses/workbench-app/types';
+import type { WorkbenchCanvasGapPreset, WorkbenchCardPresetSizeConfig } from './cardSizeConfig';
+import type { WorkbenchCardStyleConfig } from './cardStyleConfig';
+export interface WorkbenchCanvasSettingsMemory {
+    layoutConfig?: LayoutConfig;
+    cardStyleConfig?: WorkbenchCardStyleConfig;
+    cardPresetSizeConfig?: WorkbenchCardPresetSizeConfig;
+    canvasGapPreset?: WorkbenchCanvasGapPreset;
+}
+export interface WorkbenchConversationScope {
+    tenantId?: string;
+    userId?: string;
+    appId?: string;
+    workspaceId?: string;
+    roleId?: string;
+    chatMode?: 'runtime' | 'fde' | string;
+}
+export interface WorkbenchUiMemory {
+    roleId?: RoleId | '';
+    lastVisitedBlockId?: string;
+    splitRatio?: number;
+    splitRatioCustomized?: boolean;
+    studioPanelWidth?: number;
+    studioPanelCollapsed?: boolean;
+    lastPrompt?: string;
+    selectedConversationId?: string;
+    selectedConversationScopeKey?: string;
+    selectedConversationIdByScope?: Record<string, string>;
+    conversationView?: 'current' | 'history';
+    collapsedTurnIds?: string[];
+    collapsedTraceTurnIds?: string[];
+    fdeThreadConversationIdsByScope?: Record<string, string[]>;
+    autoInsertComposePlan?: boolean;
+    layoutConfig?: LayoutConfig;
+    assistantPersona?: AssistantPersonaKey;
+    cardStyleConfig?: WorkbenchCardStyleConfig;
+    cardPresetSizeConfig?: WorkbenchCardPresetSizeConfig;
+    canvasGapPreset?: WorkbenchCanvasGapPreset;
+    canvasSettingsByWorkspaceId?: Record<string, WorkbenchCanvasSettingsMemory>;
+}
+/**
+ * 构建会话恢复作用域 key。
+ * @param scope - 当前运行态身份、工作台和聊天模式。
+ * @returns 稳定的 scope key；关键身份缺失时返回空字符串。
+ */
+export declare function buildConversationScopeKey(scope: WorkbenchConversationScope): string;
+export declare function readWorkbenchUiMemory(): WorkbenchUiMemory | null;
+export declare function writeWorkbenchUiMemory(memory: WorkbenchUiMemory): void;
+/**
+ * 读取当前 scope 的最近真实会话 ID。
+ * @param scope - 当前运行态身份、工作台和聊天模式。
+ * @returns DeepAgent threadId；没有可恢复会话时返回空字符串。
+ */
+export declare function readScopedSelectedConversationId(scope: WorkbenchConversationScope): string;
+/**
+ * 写入当前 scope 的最近真实会话 ID。
+ * @param scope - 当前运行态身份、工作台和聊天模式。
+ * @param conversationId - DeepAgent threadId。
+ */
+export declare function writeScopedSelectedConversationId(scope: WorkbenchConversationScope, conversationId: string): void;
+/**
+ * 清理当前 scope 的最近真实会话 ID。
+ * @param scope - 当前运行态身份、工作台和聊天模式。
+ */
+export declare function clearScopedSelectedConversationId(scope: WorkbenchConversationScope): void;
+export declare function readWorkbenchCanvasSettings(workspaceId: string): WorkbenchCanvasSettingsMemory;
+export declare function writeWorkbenchCanvasSettings(workspaceId: string, settings: WorkbenchCanvasSettingsMemory): void;

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

@@ -0,0 +1,31 @@
+/**
+ * @fileoverview 系统卡片预览工具 - 生成 registry 实时预览块并维护自定义卡片静态预览路径。
+ * @author seadon
+ * @created 2026-06-01
+ */
+import type { MaterializedBlock } from '@fses/workbench-app/types';
+export declare const WORKBENCH_CUSTOM_CARD_PREVIEW_BASE_PATH = "/workbench-card-previews/custom-cards";
+/**
+ * 将卡片能力 ID 转成稳定的预览图文件名。
+ * @param capabilityId - 系统卡片能力 ID。
+ * @returns 预览图文件名。
+ */
+export declare function systemCardPreviewFileName(capabilityId: string): string;
+/**
+ * 根据系统卡片能力生成实时预览块，确保 hover 内容和当前注册表条目保持一致。
+ * @param capabilityId - 系统卡片能力 ID。
+ * @returns 可交给 WorkbenchBlockRenderer 渲染的预览卡片，未命中时返回 null。
+ */
+export declare function systemCardPreviewBlock(capabilityId: string): MaterializedBlock | null;
+/**
+ * 异步生成系统卡片实时预览块，用于需要加载外部模板资源的卡片。
+ * @param capabilityId - 系统卡片能力 ID。
+ * @returns 可交给 WorkbenchBlockRenderer 渲染的预览卡片，未命中时返回 null。
+ */
+export declare function systemCardPreviewBlockAsync(capabilityId: string): Promise<MaterializedBlock | null>;
+/**
+ * 获取自定义卡片预览图的 public 访问路径。
+ * @param fileName - 自定义卡片截图文件名。
+ * @returns 预览图 URL。
+ */
+export declare function customCardPreviewUrl(fileName: string): string;

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

@@ -0,0 +1,36 @@
+/**
+ * @fileoverview 系统卡片 Prompt 构造 - 将卡片库选择转换为自然业务问数指令
+ * @author seadon
+ * @created 2026-05-22
+ */
+import type { CardSizePreset } from '@fses/workbench-app/canvas/api/types';
+import type { CardRegistryEntry } from '@fses/workbench-app/types';
+import { type WorkbenchCardUsabilityProfileEntry } from './workbenchCardUsabilityProfile';
+import type { WorkbenchCardResolvedConfig } from './workbenchCardConfigProfile';
+export interface SystemCardWorkbenchPromptParams extends WorkbenchCardUsabilityProfileEntry, Pick<CardRegistryEntry, 'subType' | 'rendererKey'> {
+    defaultSize: CardSizePreset | CardRegistryEntry['defaultSize'];
+    description?: string;
+    config?: WorkbenchCardResolvedConfig;
+}
+export interface SystemCardPromptSelection {
+    prompt: string;
+    selectedSystemCard: SystemCardWorkbenchPromptParams;
+}
+/**
+ * 构造系统卡片点选后的短提示词。
+ * @param params - 系统卡片注册信息。
+ * @returns 面向用户可编辑的短提示词。
+ */
+export declare function buildSystemCardWorkbenchPrompt(params: SystemCardWorkbenchPromptParams): string;
+/**
+ * 构造系统卡片直接插入时使用的短指令。
+ * @param params - 系统卡片注册信息。
+ * @returns 面向插卡链路的短指令。
+ */
+export declare function buildSystemCardInsertPrompt(params: SystemCardWorkbenchPromptParams): string;
+/**
+ * 构造系统卡片点选上下文，用户只看到短 Prompt，后端通过隐藏元数据精确识别卡片。
+ * @param params - 系统卡片注册信息。
+ * @returns 可传递给工作台输入框和请求体的选择上下文。
+ */
+export declare function buildSystemCardPromptSelection(params: SystemCardWorkbenchPromptParams): SystemCardPromptSelection;

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

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview 工作台文本意图工具 - 决定右侧文本输入是否交给 run-agent 意图路由。
+ * @author seadon
+ * @created 2026-05-09
+ */
+/**
+ * 判断文本输入是否应统一交给 run-agent 的工作台聊天意图路由。
+ * @param text - 用户输入文本。
+ * @returns 有效文本返回 true，空文本返回 false。
+ */
+export declare function shouldRouteWorkbenchTextThroughAgent(text: string): boolean;

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

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview 工作台主题兼容入口 - 转发 personal-workbench/themes 的主题配置能力
+ * @author seadon
+ * @created 2026-07-03
+ */
+export * from '../themes/index';

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

@@ -0,0 +1,49 @@
+/**
+ * @fileoverview Workbench V2 卡片到现有画布 MaterializedBlock 的适配器
+ * @author seadon
+ * @created 2026-05-09
+ */
+import type { MaterializedBlock, RoleId } from '@fses/workbench-app/types';
+import type { WorkbenchV2Card, WorkbenchV2CardDataPatch } from '@workbench-internal/types/workbenchV2';
+type WorkbenchV2ProjectionIndexes = {
+    siblingById: Map<string, WorkbenchV2Card>;
+    childIdsByContainerId: Map<string, string[]>;
+    nestedOwnerByChildId: Map<string, string>;
+    topLevelCardIds: Set<string>;
+};
+export interface WorkbenchV2AdapterContext {
+    roleId: RoleId | string;
+    source?: 'image' | 'text' | string;
+    siblingCards?: WorkbenchV2Card[];
+    topLevelCardIds?: Set<string>;
+    projectionIndexes?: WorkbenchV2ProjectionIndexes;
+}
+/**
+ * 将单张 Workbench V2 卡片转换为现有画布可消费的 MaterializedBlock。
+ * @param card - 后端 V2 卡片。
+ * @param context - 当前角色与编排来源上下文。
+ * @returns 可被现有 WorkbenchCanvas 渲染的 MaterializedBlock。
+ */
+export declare function v2CardToMaterializedBlock(card: WorkbenchV2Card, context: WorkbenchV2AdapterContext): MaterializedBlock;
+/**
+ * Keeps screenshot visual scaffolding on image-composed cards after real query data arrives.
+ * @param card - Existing V2 card before the data patch.
+ * @param projected - Renderer-ready data projected from a successful query.
+ * @returns Render data with real values and preserved screenshot visual metadata.
+ */
+export declare function preserveImageScaffoldRenderData(card: WorkbenchV2Card, projected: Record<string, unknown>): Record<string, unknown>;
+/**
+ * 批量将 Workbench V2 卡片转换为现有画布 blocks。
+ * @param cards - 后端 V2 卡片列表。
+ * @param context - 当前角色与编排来源上下文。
+ * @returns MaterializedBlock 列表。
+ */
+export declare function v2CardsToMaterializedBlocks(cards: WorkbenchV2Card[], context: WorkbenchV2AdapterContext): MaterializedBlock[];
+/**
+ * 将后端 V2 问数结果补丁应用到单张卡片实例。
+ * @param card - 待更新的 V2 卡片。
+ * @param patch - 后端 card_data_patch 事件数据。
+ * @returns 命中卡片 ID 时返回更新后的卡片，否则返回原卡片。
+ */
+export declare function applyV2CardDataPatch(card: WorkbenchV2Card, patch: WorkbenchV2CardDataPatch): WorkbenchV2Card;
+export {};

package/dist/internal/personal-workbench/pages/Workspace.vue.d.ts

@@ -0,0 +1,7 @@
+type __VLS_Props = {
+    embedInPortal?: boolean;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    embedInPortal: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/internal/personal-workbench/stores/workbenchRuntime.d.ts

@@ -0,0 +1,170 @@
+/**
+ * @fileoverview 个人工作台运行态 Pinia store，管理画布快照、对话流和远端同步。
+ * @author seadon
+ * @created 2026-05-06
+ */
+import { type StoreDefinition } from 'pinia';
+import type { BusinessGroupContext } from '@fses/workbench-app/types';
+import { type CreateDeepAgentRunPayload } from '@workbench-internal/lib/deepAgentApi';
+import { type WorkbenchActionPayload, type WorkbenchChatRequestRefs } from '@workbench-internal/lib/workbenchApi';
+import type { SystemCardWorkbenchPromptParams } from '@workbench-internal/lib/workbenchSystemCardPrompt';
+import { type FdeWorkbenchAssetPackage } from '@workbench-internal/lib/fdeWorkbenchAssetPackage';
+import type { AssistantPersonaKey, ConversationTurn, LayoutConfig, PlanResponse, RoleId, WorkbenchSnapshot, WorkbenchTemplate } from '@fses/workbench-app/types';
+import type { WorkbenchV2Document } from '@workbench-internal/types/workbenchV2';
+import type { WorkbenchCardDataTaskRuntimeState } from '@workbench-internal/vue-types/workbenchRuntime';
+interface WorkbenchRuntimeState {
+    roleId: RoleId | '';
+    workspaceId: string;
+    userId: string;
+    tenantId: string;
+    appId: string;
+    entryResourceId: string;
+    fdeMode: boolean;
+    fdeResourceId: string;
+    fdePath: string;
+    fdeName: string;
+    fdeAssetPackage: FdeWorkbenchAssetPackage | null;
+    workbenches: WorkbenchTemplate[];
+    workbenchPrologue: string;
+    workbenchPrologueLoading: boolean;
+    workbenchPrologueRequestSeq: number;
+    restoreConversationRequestSeq: number;
+    snapshot: WorkbenchSnapshot | null;
+    v2Document: WorkbenchV2Document | null;
+    planResult: PlanResponse | null;
+    turns: ConversationTurn[];
+    activeTurnId: string | null;
+    currentConversationId: string;
+    archivedConversationIds: string[];
+    deepAgentHistoryLoadingThreadIds: string[];
+    deepAgentHistoryLoadedThreadIds: string[];
+    loading: boolean;
+    planning: boolean;
+    saving: boolean;
+    canvasDirty: boolean;
+    canvasPendingSync: boolean;
+    canvasPersistenceError: string;
+    error: string;
+    layoutConfig: LayoutConfig;
+    initialized: boolean;
+    pendingAiChartInsertCardIds: string[];
+    autoInsertComposePlan: boolean;
+    lastComposeInsertedBlockIds: string[];
+    patchHighlightBlockIds: string[];
+    patchCandidateBlockIds: string[];
+    patchHighlightReason: string;
+    v2ComposeDataPatchTotal: number;
+    v2ComposePatchedCardIds: string[];
+    v2ComposeFailedCardIds: string[];
+    v2ComposeBusinessGapDetails: string[];
+    pendingComposePlan: {
+        planId: string;
+        source: 'text';
+        blocks: Array<{
+            blockId: string;
+            capabilityId: string;
+            title: string;
+            subtitle?: string;
+            layout: {
+                x: number;
+                y: number;
+                w: number;
+                h: number;
+            };
+            confidence: number;
+            bodyJson: Record<string, unknown>;
+        }>;
+    } | null;
+    pendingComposeStatus: {
+        messageId: string;
+        content: string;
+        loading?: boolean;
+        error?: string;
+        detail?: string;
+        matchedSummary?: string;
+        composeStage?: 'receiving' | 'matched' | 'document_ready' | 'backfilling' | 'done' | 'error' | 'processing';
+    } | null;
+    pendingDeepAgentRequiredAction: PendingDeepAgentRequiredAction | null;
+    cardDataTasks: Record<string, WorkbenchCardDataTaskRuntimeState>;
+    assistantPersonaPreference?: AssistantPersonaKey;
+}
+interface PendingDeepAgentRequiredAction {
+    allowedDecisions: Array<'approve' | 'edit' | 'reject' | 'respond'>;
+    interruptId: string;
+    responseId?: string;
+    payload?: unknown;
+    reason: string;
+    runId: string;
+    threadId: string;
+}
+export interface BuildWorkbenchDeepAgentRunPayloadInput {
+    workbenches: WorkbenchTemplate[];
+    resourceId?: string;
+    workspaceId: string;
+    appId?: string;
+    businessGroup?: BusinessGroupContext;
+    content: string;
+    refs?: WorkbenchChatRequestRefs | null;
+    turnId: string;
+    selectedBlockId?: string | null;
+    selectedNestedBlock?: {
+        parentId: string;
+        childId: string;
+    } | null;
+    selectedSystemCard?: SystemCardWorkbenchPromptParams | null;
+    attachments?: Array<{
+        id?: string;
+        name?: string;
+        type?: string;
+        url?: string;
+    }>;
+    actionPayload?: WorkbenchActionPayload | null;
+}
+/**
+ * 查找当前激活工作台对应的 resource_id。
+ * @param workbenches - 已归一化工作台列表。
+ * @param workspaceId - 当前激活 workspaceId。
+ * @returns trim 后的 resource_id；找不到时返回空字符串。
+ */
+export declare function findActiveWorkbenchResourceId(workbenches: WorkbenchTemplate[], workspaceId: string): string;
+/**
+ * 解析当前运行态应透传给个人工作台接口的 resource_id。
+ * @param resourceId - URL 中的 resourceId。
+ * @param workbenches - 已归一化工作台列表。
+ * @param workspaceId - 当前激活 workspaceId。
+ * @returns 优先返回 URL resourceId；缺失时兼容工作台列表中的 resource_id。
+ */
+export declare function resolveWorkbenchRuntimeResourceId(resourceId: string | undefined, workbenches: WorkbenchTemplate[], workspaceId: string): string;
+/**
+ * 判断开场白接口响应是否仍属于当前工作台请求。
+ * @param current - 当前 store 中的工作台和请求序号。
+ * @param request - 发起请求时记录的工作台和请求序号。
+ * @returns 请求仍属于当前工作台时返回 true。
+ */
+export declare function isWorkbenchPrologueRequestCurrent(current: {
+    resourceId?: string;
+    workbenches: WorkbenchTemplate[];
+    workspaceId: string;
+    requestSeq: number;
+}, request: {
+    resourceId: string;
+    requestSeq: number;
+}): boolean;
+/**
+ * 构建 DeepAgent run 请求中的个人工作台 resource_id 片段。
+ * @param workbenches - 已归一化工作台列表。
+ * @param workspaceId - 当前激活 workspaceId。
+ * @param resourceId - URL 中的 resourceId。
+ * @returns 可直接展开进 run payload 的 resource_id 片段。
+ */
+export declare function buildWorkbenchResourceIdPayload(workbenches: WorkbenchTemplate[], workspaceId: string, resourceId?: string): {
+    resource_id?: string;
+};
+/**
+ * 构建 DeepAgent run 的完整请求 payload。
+ * @param input - 当前会话、选中卡片、附件和工作台上下文。
+ * @returns 可直接传给 createDeepAgentRun/createDeepAgentThreadRun 的 payload。
+ */
+export declare function buildWorkbenchDeepAgentRunPayload(input: BuildWorkbenchDeepAgentRunPayloadInput): CreateDeepAgentRunPayload;
+export declare const useWorkbenchRuntimeStore: StoreDefinition<'personal-workbench-runtime', WorkbenchRuntimeState, any, any>;
+export {};

package/dist/internal/personal-workbench/themes/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview 工作台主题公共入口 - 汇总主题配置、类型和解析工具
+ * @author seadon
+ * @created 2026-07-05
+ */
+export * from './workbenchThemeDefinitions';

package/dist/internal/personal-workbench/themes/workbenchThemeDefinitions.d.ts

@@ -0,0 +1,78 @@
+/**
+ * @fileoverview 工作台主题配置 - 管理工作台级 CSS token 和 ECharts 色系
+ * @author seadon
+ * @created 2026-07-03
+ */
+export type WorkbenchStyleKey = 'dark' | 'clear' | 'simple' | 'deep';
+export interface WorkbenchEChartsTheme {
+    colors: string[];
+    axisColor: string;
+    axisLabelColor: string;
+    splitLineColor: string;
+    legendTextColor: string;
+    tooltipBg: string;
+    tooltipTextColor: string;
+}
+export interface WorkbenchStyleOption {
+    id: WorkbenchStyleKey;
+    label: string;
+    description: string;
+    colors: string[];
+    preview: {
+        shell: string;
+        panel: string;
+        card: string;
+        mutedCard: string;
+        primary: string;
+        secondary: string;
+        line: string;
+        text: string;
+    };
+    echarts: WorkbenchEChartsTheme;
+    defaultCode: string;
+}
+export type WorkbenchStyleCodeMap = Record<WorkbenchStyleKey, string>;
+export interface WorkbenchThemeSourceConfig {
+    style?: WorkbenchStyleKey;
+    styleCodes?: Partial<WorkbenchStyleCodeMap>;
+}
+export declare const DEFAULT_WORKBENCH_STYLE: WorkbenchStyleKey;
+export declare const WORKBENCH_STYLE_OPTIONS: WorkbenchStyleOption[];
+/**
+ * 清洗用户自定义主题 CSS，只允许 `--wb-*` 变量。
+ * @param code - 用户输入的 CSS token 文本。
+ * @returns 可安全注入的 CSS token 文本。
+ */
+export declare function sanitizeWorkbenchStyleCode(code: string): string;
+/**
+ * 归一化主题 key，未知值回退到默认主题。
+ * @param value - 外部输入或源码配置中的主题 key。
+ * @returns 有效的主题 key。
+ */
+export declare function normalizeWorkbenchStyleKey(value: unknown): WorkbenchStyleKey;
+/**
+ * 归一化源码模板中的主题配置。
+ * @param value - 源码配置对象。
+ * @returns 可直接用于运行态的主题配置。
+ */
+export declare function normalizeWorkbenchThemeSourceConfig(value: unknown): Required<WorkbenchThemeSourceConfig>;
+/**
+ * 解析某个主题最终使用的 CSS token。
+ * @param styleKey - 主题 key。
+ * @param overrides - 可选自定义 token map。
+ * @returns 最终 CSS token 文本。
+ */
+export declare function resolveWorkbenchStyleCode(styleKey: WorkbenchStyleKey, overrides?: Partial<WorkbenchStyleCodeMap>): string;
+/**
+ * 解析所有主题最终使用的 CSS token。
+ * @param overrides - 可选自定义 token map。
+ * @returns 全部主题 CSS token map。
+ */
+export declare function resolveWorkbenchStyleCodes(overrides?: Partial<WorkbenchStyleCodeMap>): WorkbenchStyleCodeMap;
+/**
+ * 构建当前选中主题的作用域 CSS。
+ * @param styleKey - 当前选中主题。
+ * @param code - 当前主题 CSS token 文本。
+ * @returns 可注入页面的 CSS 文本。
+ */
+export declare function buildWorkbenchStyleCss(styleKey: WorkbenchStyleKey, code: string): string;