@fses/workbench-app 0.1.0

package/dist/internal/personal-workbench/components/workbench/WorkbenchStudio.vue.d.ts

@@ -0,0 +1,301 @@
+import { type WorkbenchCardStyleConfig } from "@workbench-internal/lib/cardStyleConfig";
+import { type WorkbenchChatHistoryMessage } from "@workbench-internal/lib/workbenchChatHistory";
+import { type MetricWorkbenchCardSpec } from "@workbench-internal/lib/aiMetricCardSpec";
+import { type WorkbenchCanvasGapPreset, type WorkbenchCardPresetSizeConfig } from "@workbench-internal/lib/cardSizeConfig";
+import { type WorkbenchActionPayload } from "@workbench-internal/lib/workbenchApi";
+import type { WorkbenchStyleCodeMap, WorkbenchStyleKey } from "@workbench-internal/lib/workbenchThemes";
+import type { SystemCardPromptSelection, SystemCardWorkbenchPromptParams } from "@workbench-internal/lib/workbenchSystemCardPrompt";
+import type { CardRecommendationChooseFeedback, CardRecommendationItem, ChatAttachment, FsesAiChatQuickEntry } from "@fses/workbench-app/types";
+import type { AssistantPersonaKey, ConversationGroupSummary, ConversationTurn, LayoutConfig, WorkbenchIntentChannel, WorkbenchTemplate } from '@fses/workbench-app/types';
+import type { BusinessGroupContext } from "@fses/workbench-app/types";
+import type { ChartCardSpec } from "@fses/workbench-app/types";
+type UploadedChatAttachmentPayload = {
+    downloadUrl?: string;
+    fileId?: string;
+    fileName: string;
+    messageId?: string;
+    mimeType: string;
+    text?: string;
+    type?: 'file' | 'image';
+};
+export interface WorkbenchChatSendPayload {
+    actionPayload?: WorkbenchActionPayload;
+    attachments?: ChatAttachment[];
+    businessGroup?: BusinessGroupContext;
+    threadId?: string;
+    clientDraftId?: string;
+    onThreadReady?: (threadId: string) => void;
+    input?: string;
+    messages?: WorkbenchChatHistoryMessage[];
+    quickEntry?: FsesAiChatQuickEntry;
+    selectedBlockId?: string;
+    selectedSystemCard?: SystemCardWorkbenchPromptParams | null;
+}
+type __VLS_Props = {
+    input: string;
+    planning: boolean;
+    saving: boolean;
+    turns: ConversationTurn[];
+    activeTurnId?: string | null;
+    activeConversationId?: string;
+    conversations?: ConversationGroupSummary[];
+    workbenches: WorkbenchTemplate[];
+    workbenchPrologue?: string;
+    activeWorkbenchId: string;
+    userId?: string;
+    layoutConfig: LayoutConfig;
+    assistantPersona: AssistantPersonaKey;
+    workbenchStyle: WorkbenchStyleKey;
+    workbenchStyleCodes: WorkbenchStyleCodeMap;
+    cardStyleConfig?: WorkbenchCardStyleConfig;
+    cardPresetSizeConfig?: WorkbenchCardPresetSizeConfig;
+    canvasGapPreset?: WorkbenchCanvasGapPreset;
+    canvasConfigActive?: boolean;
+    isFdeMode?: boolean;
+    hasCardGenerationIntent?: boolean;
+    previewReadyForEdit?: boolean;
+    pendingComposePlan?: {
+        planId: string;
+        source: 'text';
+        blocks: Array<Record<string, unknown>>;
+    } | null;
+    pendingComposeStatus?: {
+        messageId: string;
+        content: string;
+        loading?: boolean;
+        error?: string;
+        detail?: string;
+    } | null;
+    pendingSystemCardTitle?: string;
+    pendingSystemCardRequirement?: string;
+    selectedPatchTarget?: {
+        id: string;
+        title: string;
+        blockType?: string;
+        subType?: string;
+    } | null;
+    autoInsertComposePlan?: boolean;
+    canSendPrompt?: boolean;
+    routeImagesAsAttachments?: boolean;
+    conversationRestoring?: boolean;
+    conversationRestoringText?: string;
+};
+/**
+ * 从工作台外层把 Prompt 写入 ai-chat 输入框。
+ * @param text - 要显示在聊天输入框里的文本。
+ */
+declare function setWorkbenchInputText(text: string): void;
+/**
+ * 把焦点交还给右侧 ai-chat 输入框，用于插卡/改卡后的连续对话。
+ */
+declare function focusWorkbenchComposer(): void;
+/**
+ * 打开工作台问数聊天面板。
+ * @returns 无返回值。
+ */
+declare function openWorkbenchChat(): void;
+/**
+ * 打开工作台会话记录面板。
+ * @returns 无返回值。
+ */
+declare function openWorkbenchHistory(): void;
+/**
+ * 打开工作台设置面板。
+ * @returns 无返回值。
+ */
+declare function openWorkbenchSettings(): void;
+declare var __VLS_36: {}, __VLS_38: {};
+type __VLS_Slots = {} & {
+    'topbar-leading'?: (props: typeof __VLS_36) => any;
+} & {
+    'utility-header-extra'?: (props: typeof __VLS_38) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {
+    setWorkbenchInputText: typeof setWorkbenchInputText;
+    focusWorkbenchComposer: typeof focusWorkbenchComposer;
+    openWorkbenchChat: typeof openWorkbenchChat;
+    openWorkbenchHistory: typeof openWorkbenchHistory;
+    openWorkbenchSettings: typeof openWorkbenchSettings;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    workbenchStyleChange: (style: WorkbenchStyleKey) => any;
+    workbenchStyleCodeSave: (style: WorkbenchStyleKey, code: string) => any;
+    cardStyleConfigChange: (config: WorkbenchCardStyleConfig) => any;
+    cardPresetSizeConfigChange: (config: WorkbenchCardPresetSizeConfig) => any;
+    canvasGapPresetChange: (preset: WorkbenchCanvasGapPreset) => any;
+    pasteCardPrompt: (selection: SystemCardPromptSelection) => any;
+    insertSystemCard: (selection: SystemCardPromptSelection) => any;
+    inputChange: (value: string) => any;
+    send: (payload?: WorkbenchChatSendPayload) => any;
+    stop: () => any;
+    composerIntentSelect: (intent: WorkbenchIntentChannel) => any;
+    toggleTurnCollapse: (turnId: string) => any;
+    confirmLayoutDraft: (turnId: string) => any;
+    confirmCardMutation: (turnId: string) => any;
+    cancelCardMutation: (turnId: string) => any;
+    confirmSubmitDraft: (turnId: string) => any;
+    memoryCaptureDismiss: (payload: {
+        turnId: string;
+        itemId: string;
+    }) => any;
+    memoryCaptureSave: (payload: {
+        turnId: string;
+        itemId: string;
+        done?: (ok: boolean) => void;
+    }) => any;
+    insertPreview: (turnId: string) => any;
+    rollbackPreview: (turnId: string) => any;
+    applyLayoutConfig: (next: LayoutConfig) => any;
+    canvasConfigModeChange: (active: boolean) => any;
+    settingsOpen: () => any;
+    settingsClose: () => any;
+    insertAiChartCard: (card: ChartCardSpec) => any;
+    insertAiMetricCard: (card: MetricWorkbenchCardSpec) => any;
+    updateAiChartCard: (card: ChartCardSpec) => any;
+    newConversation: () => any;
+    clearConversation: () => any;
+    selectConversation: (conversationId: string) => any;
+    deleteConversation: (conversationId: string) => any;
+    selectWorkbench: (workspaceId: string) => any;
+    deleteWorkbench: (workspaceId: string) => any;
+    assistantPersonaChange: (persona: AssistantPersonaKey) => any;
+    quickHelpRequest: (kind: "examples" | "guide" | "manual") => any;
+    "compose-image": (payload: {
+        base64: string;
+        mimeType: string;
+        file: File;
+        messageId?: string;
+        text?: string;
+    }) => any;
+    "attachment-upload": (payload: UploadedChatAttachmentPayload) => any;
+    "confirm-compose-plan": (planId: string) => any;
+    "cancel-compose-plan": () => any;
+    "modify-compose-plan": (payload: {
+        planId: string;
+        prompt: string;
+    }) => any;
+    "auto-insert-compose-plan-change": (enabled: boolean) => any;
+    settingsSave: (done?: (ok: boolean) => void) => any;
+    autoArrange: () => any;
+    chooseCardRecommendation: (item: CardRecommendationItem, feedback?: CardRecommendationChooseFeedback) => any;
+    configureCardRecommendation: (item: CardRecommendationItem) => any;
+    registeredCardInsertReady: (item: CardRecommendationItem) => any;
+    taskStatePhrase: (payload: {
+        turnId: string;
+        taskId: string;
+        phrase: string;
+    }) => any;
+    clearSelectedPatchTarget: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onWorkbenchStyleChange?: (style: WorkbenchStyleKey) => any;
+    onWorkbenchStyleCodeSave?: (style: WorkbenchStyleKey, code: string) => any;
+    onCardStyleConfigChange?: (config: WorkbenchCardStyleConfig) => any;
+    onCardPresetSizeConfigChange?: (config: WorkbenchCardPresetSizeConfig) => any;
+    onCanvasGapPresetChange?: (preset: WorkbenchCanvasGapPreset) => any;
+    onPasteCardPrompt?: (selection: SystemCardPromptSelection) => any;
+    onInsertSystemCard?: (selection: SystemCardPromptSelection) => any;
+    onInputChange?: (value: string) => any;
+    onSend?: (payload?: WorkbenchChatSendPayload) => any;
+    onStop?: () => any;
+    onComposerIntentSelect?: (intent: WorkbenchIntentChannel) => any;
+    onToggleTurnCollapse?: (turnId: string) => any;
+    onConfirmLayoutDraft?: (turnId: string) => any;
+    onConfirmCardMutation?: (turnId: string) => any;
+    onCancelCardMutation?: (turnId: string) => any;
+    onConfirmSubmitDraft?: (turnId: string) => any;
+    onMemoryCaptureDismiss?: (payload: {
+        turnId: string;
+        itemId: string;
+    }) => any;
+    onMemoryCaptureSave?: (payload: {
+        turnId: string;
+        itemId: string;
+        done?: (ok: boolean) => void;
+    }) => any;
+    onInsertPreview?: (turnId: string) => any;
+    onRollbackPreview?: (turnId: string) => any;
+    onApplyLayoutConfig?: (next: LayoutConfig) => any;
+    onCanvasConfigModeChange?: (active: boolean) => any;
+    onSettingsOpen?: () => any;
+    onSettingsClose?: () => any;
+    onInsertAiChartCard?: (card: ChartCardSpec) => any;
+    onInsertAiMetricCard?: (card: MetricWorkbenchCardSpec) => any;
+    onUpdateAiChartCard?: (card: ChartCardSpec) => any;
+    onNewConversation?: () => any;
+    onClearConversation?: () => any;
+    onSelectConversation?: (conversationId: string) => any;
+    onDeleteConversation?: (conversationId: string) => any;
+    onSelectWorkbench?: (workspaceId: string) => any;
+    onDeleteWorkbench?: (workspaceId: string) => any;
+    onAssistantPersonaChange?: (persona: AssistantPersonaKey) => any;
+    onQuickHelpRequest?: (kind: "examples" | "guide" | "manual") => any;
+    "onCompose-image"?: (payload: {
+        base64: string;
+        mimeType: string;
+        file: File;
+        messageId?: string;
+        text?: string;
+    }) => any;
+    "onAttachment-upload"?: (payload: UploadedChatAttachmentPayload) => any;
+    "onConfirm-compose-plan"?: (planId: string) => any;
+    "onCancel-compose-plan"?: () => any;
+    "onModify-compose-plan"?: (payload: {
+        planId: string;
+        prompt: string;
+    }) => any;
+    "onAuto-insert-compose-plan-change"?: (enabled: boolean) => any;
+    onSettingsSave?: (done?: (ok: boolean) => void) => any;
+    onAutoArrange?: () => any;
+    onChooseCardRecommendation?: (item: CardRecommendationItem, feedback?: CardRecommendationChooseFeedback) => any;
+    onConfigureCardRecommendation?: (item: CardRecommendationItem) => any;
+    onRegisteredCardInsertReady?: (item: CardRecommendationItem) => any;
+    onTaskStatePhrase?: (payload: {
+        turnId: string;
+        taskId: string;
+        phrase: string;
+    }) => any;
+    onClearSelectedPatchTarget?: () => any;
+}>, {
+    activeTurnId: string | null;
+    cardStyleConfig: WorkbenchCardStyleConfig;
+    cardPresetSizeConfig: WorkbenchCardPresetSizeConfig;
+    canvasGapPreset: WorkbenchCanvasGapPreset;
+    activeConversationId: string;
+    conversations: ConversationGroupSummary[];
+    workbenchPrologue: string;
+    canvasConfigActive: boolean;
+    isFdeMode: boolean;
+    pendingComposePlan: {
+        planId: string;
+        source: "text";
+        blocks: Array<Record<string, unknown>>;
+    } | null;
+    pendingComposeStatus: {
+        messageId: string;
+        content: string;
+        loading?: boolean;
+        error?: string;
+        detail?: string;
+    } | null;
+    pendingSystemCardTitle: string;
+    pendingSystemCardRequirement: string;
+    selectedPatchTarget: {
+        id: string;
+        title: string;
+        blockType?: string;
+        subType?: string;
+    } | null;
+    autoInsertComposePlan: boolean;
+    canSendPrompt: boolean;
+    routeImagesAsAttachments: boolean;
+    hasCardGenerationIntent: boolean;
+    previewReadyForEdit: boolean;
+    conversationRestoring: boolean;
+    conversationRestoringText: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/internal/personal-workbench/components/workbench/WorkbenchThemePicker.vue.d.ts

@@ -0,0 +1,10 @@
+import { type WorkbenchStyleKey } from '@workbench-internal/lib/workbenchThemes';
+type __VLS_Props = {
+    workbenchStyle: WorkbenchStyleKey;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    workbenchStyleChange: (style: WorkbenchStyleKey) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onWorkbenchStyleChange?: (style: WorkbenchStyleKey) => any;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/internal/personal-workbench/components/workbench/helpers.d.ts

@@ -0,0 +1,18 @@
+import type { BlockLayout, WorkbenchBlock } from '@fses/workbench-app/types';
+export { formatDateTime } from '@workbench-internal/lib/formatters';
+export declare function blockTypeLabel(block: WorkbenchBlock): string;
+export declare function blockSpanClass(span: number): string;
+export declare function buildRglLayout(layout: BlockLayout): {
+    i: string;
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    minW: number;
+    minH: number;
+    maxW: number;
+    maxH: number;
+    static: boolean;
+};
+export declare function shellHeight(embedInPortal: boolean): "h-full min-h-0" | "h-screen min-h-0 overflow-hidden";
+export declare function imageWorkbenchShellHeight(embedInPortal: boolean): "h-screen min-h-0 overflow-hidden" | "h-full min-h-0 overflow-hidden";

package/dist/internal/personal-workbench/components/workbench/showcase/WorkbenchShowcase.vue.d.ts

@@ -0,0 +1,273 @@
+import { type WorkbenchCanvasGapPreset, type WorkbenchCardPresetSizeConfig } from '@workbench-internal/lib/cardSizeConfig';
+import type { WorkbenchCardStyleConfig } from '@workbench-internal/lib/cardStyleConfig';
+import type { WorkbenchStyleCodeMap, WorkbenchStyleKey } from '@workbench-internal/lib/workbenchThemes';
+import type { SystemCardPromptSelection } from '@workbench-internal/lib/workbenchSystemCardPrompt';
+import type { BusinessGapWordingSubmission } from '@workbench-internal/lib/workbenchCanvasBusinessGapChecklist';
+import type { WorkbenchEchartClickParams } from '@fses/workbench-app/types';
+import type { LayoutConfig, MaterializedBlock, RoleId, WorkbenchLayoutV4, WorkbenchSnapshot } from '@fses/workbench-app/types';
+import type { WorkbenchCustomCardCatalogEntry } from '@fses/workbench-app/types';
+type WorkbenchChartClickPayload = WorkbenchEchartClickParams & {
+    blockId: string;
+    block: MaterializedBlock;
+};
+type WorkbenchMetricDetailPayload = {
+    blockId: string;
+    block: MaterializedBlock;
+};
+type ChartConfigDataRange = 'metric' | 'model_service' | 'list';
+type ChartConfigDataSourceDraft = {
+    applicationId: string;
+    dataRange: ChartConfigDataRange;
+    metricId: string;
+    modelServiceId: string;
+    listId: string;
+};
+type WorkbenchCardBasicConfigDraft = {
+    title: string;
+    hideTitle: boolean;
+    widthPx?: number;
+    heightPx?: number;
+    chartConfigDataSource?: ChartConfigDataSourceDraft;
+};
+type WorkbenchCardRenderedSize = {
+    width: number;
+    height: number;
+};
+type __VLS_Props = {
+    blocks: MaterializedBlock[];
+    roleId: RoleId | '';
+    workspaceId?: string;
+    runtimePresetResourceId?: string;
+    userId?: string;
+    layoutConfig: LayoutConfig;
+    visualConfig?: WorkbenchSnapshot['visualConfig'];
+    version?: number;
+    loading: boolean;
+    saving?: boolean;
+    error: string;
+    resizing?: boolean;
+    layoutResizeRevision?: number;
+    configModeActive?: boolean;
+    selectedBlockId?: string | null;
+    cardRefs?: Record<string, HTMLElement | null>;
+    canvasNotice?: {
+        id: string;
+        title: string;
+        detail: string;
+        tone?: 'info' | 'warning';
+        actionLabel?: string;
+        actionId?: string;
+    } | null;
+    workbenchStyle: WorkbenchStyleKey;
+    workbenchStyleCodes: WorkbenchStyleCodeMap;
+    cardStyleConfig: WorkbenchCardStyleConfig;
+    cardPresetSizeConfig?: WorkbenchCardPresetSizeConfig;
+    canvasGapPreset?: WorkbenchCanvasGapPreset;
+    canvasGapPx?: number;
+    canvasFocusMode?: boolean;
+    drawerOpen?: boolean;
+    imageWorkbench?: boolean;
+    canConfigureCard?: boolean;
+    showWorkbenchThemePicker?: boolean;
+    snapshotReady?: boolean;
+    highlightBlockIds?: string[];
+    candidateBlockIds?: string[];
+    highlightReason?: string;
+};
+/**
+ * 代理画布自动排列能力，供右侧 AI 设置面板调用。
+ */
+declare function requestAutoArrangeDraftBlocks(): void;
+/**
+ * 代理画布保存能力，供右侧 AI 设置面板调用。
+ */
+declare function requestSaveConfigMode(done?: (ok: boolean) => void): void;
+/**
+ * 代理画布草稿数据应用能力，供展示层或侧边桥接调用。
+ * @param blockId - 目标卡片 ID
+ * @param data - 要写入的卡片数据
+ * @returns 是否成功命中并写入草稿块
+ */
+declare function requestApplyCardDataDraft(blockId: string, data: Record<string, unknown>): boolean;
+/**
+ * 代理画布基础配置草稿应用能力，供右侧配置抽屉调用。
+ * @param blockId - 目标卡片 ID
+ * @param draft - 标题、隐藏标题、宽高和数据源表单草稿
+ * @returns 是否成功命中并写入草稿块
+ */
+declare function requestApplyCardBasicConfigDraft(blockId: string, draft: WorkbenchCardBasicConfigDraft): boolean;
+/**
+ * 代理配置态草稿刷新能力，用最新快照内容刷新目标卡片。
+ * @param blockId - 目标卡片 ID
+ * @returns 是否成功刷新草稿块
+ */
+declare function requestRefreshConfigDraftBlock(blockId: string): boolean;
+/**
+ * 读取画布当前渲染的卡片像素尺寸。
+ * @param blockId - 目标卡片 ID
+ * @returns 当前渲染尺寸；未找到时返回 null。
+ */
+declare function requestCardRenderedSize(blockId: string): WorkbenchCardRenderedSize;
+declare const _default: import("vue").DefineComponent<__VLS_Props, {
+    requestAutoArrangeDraftBlocks: typeof requestAutoArrangeDraftBlocks;
+    requestSaveConfigMode: typeof requestSaveConfigMode;
+    requestApplyCardDataDraft: typeof requestApplyCardDataDraft;
+    requestApplyCardBasicConfigDraft: typeof requestApplyCardBasicConfigDraft;
+    requestRefreshConfigDraftBlock: typeof requestRefreshConfigDraftBlock;
+    requestCardRenderedSize: typeof requestCardRenderedSize;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    focusBlock: (blockId: string) => any;
+    metricDetail: (payload: WorkbenchMetricDetailPayload) => any;
+    focusNestedBlock: (payload: {
+        parentId: string;
+        childId: string;
+    }) => any;
+    layoutTreeChange: (layoutTree: WorkbenchLayoutV4) => any;
+    chartClick: (payload: WorkbenchChartClickPayload) => any;
+    workbenchStyleChange: (style: WorkbenchStyleKey) => any;
+    workbenchStyleCodeSave: (style: WorkbenchStyleKey, code: string) => any;
+    cardStyleConfigChange: (config: WorkbenchCardStyleConfig) => any;
+    cardPresetSizeConfigChange: (config: WorkbenchCardPresetSizeConfig) => any;
+    canvasGapPresetChange: (preset: WorkbenchCanvasGapPreset) => any;
+    pasteCardPrompt: (selection: SystemCardPromptSelection) => any;
+    insertSystemCard: (selection: SystemCardPromptSelection) => any;
+    insertCustomCard: (entry: WorkbenchCustomCardCatalogEntry) => any;
+    layoutChange: (layout: readonly {
+        i: string;
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    }[]) => any;
+    configModeChange: (active: boolean) => any;
+    configDirtyChange: (dirty: boolean) => any;
+    saveCanvasConfig: (payload: {
+        blocks: MaterializedBlock[];
+        layoutConfig: LayoutConfig;
+        done?: (ok: boolean) => void;
+        visualConfig?: WorkbenchSnapshot["visualConfig"];
+    }) => any;
+    canvasFocusModeChange: (active: boolean) => any;
+    replaceManualPlaceholder: (payload: {
+        block: MaterializedBlock;
+        overrideCapabilityId?: string;
+    }) => any;
+    replaceManualPlaceholders: (blocks: MaterializedBlock[]) => any;
+    configureCard: (block: MaterializedBlock) => any;
+    retryDataBindingCandidate: (block: MaterializedBlock) => any;
+    showDataBindingHint: (payload: {
+        title: string;
+        detail: string;
+    }) => any;
+    submitBusinessGapWording: (payload: {
+        cardId: string;
+        bindingId: string;
+        title: string;
+        businessWording: string;
+        location: "top_level" | "nested";
+    }) => any;
+    submitBusinessGapWordings: (payload: {
+        items: BusinessGapWordingSubmission[];
+    }) => any;
+    canvasNoticeAction: (actionId: string) => any;
+    autoArrangeFeedback: (payload: {
+        title: string;
+        detail: string;
+        tone?: "info" | "warning";
+    }) => any;
+    runShortcut: (prompt: string) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onFocusBlock?: (blockId: string) => any;
+    onMetricDetail?: (payload: WorkbenchMetricDetailPayload) => any;
+    onFocusNestedBlock?: (payload: {
+        parentId: string;
+        childId: string;
+    }) => any;
+    onLayoutTreeChange?: (layoutTree: WorkbenchLayoutV4) => any;
+    onChartClick?: (payload: WorkbenchChartClickPayload) => any;
+    onWorkbenchStyleChange?: (style: WorkbenchStyleKey) => any;
+    onWorkbenchStyleCodeSave?: (style: WorkbenchStyleKey, code: string) => any;
+    onCardStyleConfigChange?: (config: WorkbenchCardStyleConfig) => any;
+    onCardPresetSizeConfigChange?: (config: WorkbenchCardPresetSizeConfig) => any;
+    onCanvasGapPresetChange?: (preset: WorkbenchCanvasGapPreset) => any;
+    onPasteCardPrompt?: (selection: SystemCardPromptSelection) => any;
+    onInsertSystemCard?: (selection: SystemCardPromptSelection) => any;
+    onInsertCustomCard?: (entry: WorkbenchCustomCardCatalogEntry) => any;
+    onLayoutChange?: (layout: readonly {
+        i: string;
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    }[]) => any;
+    onConfigModeChange?: (active: boolean) => any;
+    onConfigDirtyChange?: (dirty: boolean) => any;
+    onSaveCanvasConfig?: (payload: {
+        blocks: MaterializedBlock[];
+        layoutConfig: LayoutConfig;
+        done?: (ok: boolean) => void;
+        visualConfig?: WorkbenchSnapshot["visualConfig"];
+    }) => any;
+    onCanvasFocusModeChange?: (active: boolean) => any;
+    onReplaceManualPlaceholder?: (payload: {
+        block: MaterializedBlock;
+        overrideCapabilityId?: string;
+    }) => any;
+    onReplaceManualPlaceholders?: (blocks: MaterializedBlock[]) => any;
+    onConfigureCard?: (block: MaterializedBlock) => any;
+    onRetryDataBindingCandidate?: (block: MaterializedBlock) => any;
+    onShowDataBindingHint?: (payload: {
+        title: string;
+        detail: string;
+    }) => any;
+    onSubmitBusinessGapWording?: (payload: {
+        cardId: string;
+        bindingId: string;
+        title: string;
+        businessWording: string;
+        location: "top_level" | "nested";
+    }) => any;
+    onSubmitBusinessGapWordings?: (payload: {
+        items: BusinessGapWordingSubmission[];
+    }) => any;
+    onCanvasNoticeAction?: (actionId: string) => any;
+    onAutoArrangeFeedback?: (payload: {
+        title: string;
+        detail: string;
+        tone?: "info" | "warning";
+    }) => any;
+    onRunShortcut?: (prompt: string) => any;
+}>, {
+    drawerOpen: boolean;
+    canvasFocusMode: boolean;
+    imageWorkbench: boolean;
+    workspaceId: string;
+    userId: string;
+    visualConfig: WorkbenchSnapshot["visualConfig"];
+    selectedBlockId: string | null;
+    showWorkbenchThemePicker: boolean;
+    cardPresetSizeConfig: WorkbenchCardPresetSizeConfig;
+    canvasGapPreset: WorkbenchCanvasGapPreset;
+    saving: boolean;
+    version: number;
+    resizing: boolean;
+    layoutResizeRevision: number;
+    configModeActive: boolean;
+    cardRefs: Record<string, HTMLElement | null>;
+    canvasNotice: {
+        id: string;
+        title: string;
+        detail: string;
+        tone?: "info" | "warning";
+        actionLabel?: string;
+        actionId?: string;
+    } | null;
+    canvasGapPx: number;
+    canConfigureCard: boolean;
+    highlightBlockIds: string[];
+    candidateBlockIds: string[];
+    highlightReason: string;
+    runtimePresetResourceId: string;
+    snapshotReady: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/internal/personal-workbench/composables/useWorkbenchRuntime.d.ts

@@ -0,0 +1,9 @@
+import type { UseWorkbenchRuntimeOptions, WorkbenchRuntimeComposable } from '@workbench-internal/vue-types/workbenchRuntime';
+import type { RoleId } from '@fses/workbench-app/types';
+/**
+ * 初始化并订阅工作台运行时 store。
+ * @param initialRoleId - 初始角色 ID。
+ * @param options - 运行时初始化选项。
+ * @returns 工作台运行时状态与动作集合。
+ */
+export declare function useWorkbenchRuntime(initialRoleId: RoleId, options?: UseWorkbenchRuntimeOptions): WorkbenchRuntimeComposable;

package/dist/internal/personal-workbench/extensions/cards/customCardCatalog.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @fileoverview 用户卡片目录桥 - 从脚手架扩展读取当前可见卡片。
+ * @author seadon
+ * @created 2026-08-12
+ */
+import type { CardRegistryEntry, WorkbenchCustomCardCatalogEntry } from '@fses/workbench-app/types';
+export declare const WORKBENCH_CUSTOM_CARD_CATALOG: WorkbenchCustomCardCatalogEntry[];
+/**
+ * 读取当前已实现卡片。
+ * @returns 用户扩展中的卡片目录。
+ */
+export declare function workbenchCustomCardEntries(): WorkbenchCustomCardCatalogEntry[];
+export declare const buildWorkbenchCustomCardGroups: (entries: readonly WorkbenchCustomCardCatalogEntry[], defaultEntries?: readonly CardRegistryEntry[]) => ({
+    id: "default";
+    name: string;
+    description: string;
+    entries: CardRegistryEntry[];
+} | {
+    id: "npm";
+    name: string;
+    description: string;
+    entries: WorkbenchCustomCardCatalogEntry[];
+})[];
+export declare const WORKBENCH_TEMPLATE_WEATHER_CAPABILITY_ID = "card.fde.templateWeather";
+export declare const WORKBENCH_TEMPLATE_WEATHER_COMPONENT_REF = "@byteluck-fe/workbench-template.WeatherCard";
+export declare const WORKBENCH_TEMPLATE_WEATHER_PREVIEW_URL = "";
+export type { WorkbenchCustomCardCatalogEntry };

package/dist/internal/personal-workbench/extensions/cards/customComponentRegistry.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview 用户组件注册桥 - 将卡片渲染解析委托给脚手架扩展。
+ * @author seadon
+ * @created 2026-08-12
+ */
+import type { WorkbenchRendererCustomComponentRegistry } from '@fses/workbench-app/types';
+export declare const customComponentRegistry: WorkbenchRendererCustomComponentRegistry;

package/dist/internal/personal-workbench/extensions/cards/userCustomCardInsertion.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview 用户 npm 卡片插入物化器 - 将扩展目录和组件注册表转换为画布插入参数。
+ * @author seadon
+ * @created 2026-08-12
+ */
+import type { WorkbenchCustomCardCatalogEntry, WorkbenchRendererCustomComponentRegistry } from '@fses/workbench-app/types';
+import type { InsertCardParams } from '../../canvas-runtime/api/types';
+export type UserCustomCardInsertMaterialization = {
+    ok: true;
+    params: InsertCardParams;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * 将用户卡片物化为画布插入参数。
+ * @param entry - 卡片目录项。
+ * @param registry - 组件注册表。
+ * @returns 成功参数或失败原因。
+ */
+export declare function materializeUserCustomCardInsert(entry: WorkbenchCustomCardCatalogEntry, registry: WorkbenchRendererCustomComponentRegistry): UserCustomCardInsertMaterialization;

package/dist/internal/personal-workbench/extensions/fde/fdeGeneratedCards.d.ts

@@ -0,0 +1,2 @@
+import type { FdeSkillCardIntent } from '../../fde-skill-cards/runtime/fdeSkillCardTypes';
+export declare const fdeGeneratedCards: FdeSkillCardIntent[];

package/dist/internal/personal-workbench/extensions/fde/fdeGeneratedDashboard.d.ts

@@ -0,0 +1 @@
+export declare const fdeGeneratedDashboard: import("../../../..").FdeSkillDashboardManifest;

package/dist/internal/personal-workbench/extensions/fde/fdeGeneratedTemplatePage.d.ts

@@ -0,0 +1 @@
+export declare const fdeGeneratedTemplatePage: import("../../../..").FdeSkillTemplatePageManifest;