@fses/workbench-app 0.1.0

package/dist/adapters/defaults.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @fileoverview 工作台默认适配器 - 提供无平台副作用的存储、资源、消息和日志默认实现。
+ * @author seadon
+ * @created 2026-08-11
+ */
+import type { WorkbenchAssetAdapter, WorkbenchLoggerAdapter, WorkbenchMessageAdapter, WorkbenchStorageAdapter } from './types';
+/**
+ * 将浏览器 Storage 包装为工作台存储适配器。
+ * @param storage - 浏览器提供的 Storage 实例。
+ * @returns 工作台存储适配器。
+ */
+export declare function createBrowserStorageAdapter(storage: Storage): WorkbenchStorageAdapter;
+export declare const defaultWorkbenchAssetAdapter: WorkbenchAssetAdapter;
+export declare const defaultWorkbenchLoggerAdapter: WorkbenchLoggerAdapter;
+export declare const defaultWorkbenchMessageAdapter: WorkbenchMessageAdapter;

package/dist/adapters/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview 工作台适配器公共入口 - 显式导出适配器合同、默认实现和测试替身。
+ * @author seadon
+ * @created 2026-08-12
+ */
+export * from './defaults';
+export * from './testDoubles';
+export type { WorkbenchAgentTransportAdapter, WorkbenchAppAdapters, WorkbenchAssetAdapter, WorkbenchIdentityAdapter, WorkbenchIdentitySnapshot, WorkbenchLoggerAdapter, WorkbenchMessageAdapter, WorkbenchPlatformRequestAdapter, WorkbenchRouterAdapter, WorkbenchStorageAdapter, WorkbenchUploadAdapter, } from './types';

package/dist/adapters/testDoubles.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview 工作台测试适配器 - 为迁移回归提供可注入的无网络替身。
+ * @author seadon
+ * @created 2026-08-11
+ */
+import type { WorkbenchAppAdapters } from './types';
+/**
+ * 创建无网络副作用且合同完整的工作台测试适配器。
+ * @param overrides - 需要替换的适配器实现。
+ * @returns 可直接注入工作台主体的完整适配器集合。
+ */
+export declare function createWorkbenchAppTestAdapters(overrides?: Partial<WorkbenchAppAdapters>): WorkbenchAppAdapters;

package/dist/adapters/types.d.ts

@@ -0,0 +1,84 @@
+/**
+ * @fileoverview 工作台适配器类型 - 定义脚手架注入平台能力的最小接口。
+ * @author seadon
+ * @created 2026-08-11
+ */
+export interface WorkbenchIdentitySnapshot {
+    appId?: string;
+    entryResourceId?: string;
+    roleId?: string;
+    tenantId?: string;
+    userId?: string;
+}
+export interface WorkbenchIdentityAdapter {
+    readIdentity(): Promise<WorkbenchIdentitySnapshot> | WorkbenchIdentitySnapshot;
+}
+export interface WorkbenchPlatformRequestAdapter {
+    ensureSessionReady(): Promise<boolean>;
+    requestJson<T>(config: {
+        headers?: Record<string, string>;
+        method?: string;
+        params?: Record<string, unknown>;
+        payload?: unknown;
+        signal?: AbortSignal;
+        url: string;
+    }): Promise<T>;
+}
+export interface WorkbenchAgentTransportAdapter {
+    openEventStream(config: {
+        body?: unknown;
+        headers?: Record<string, string>;
+        signal?: AbortSignal;
+        url: string;
+        onEvent: (event: unknown) => void;
+    }): Promise<void>;
+    requestJson<T>(config: {
+        body?: unknown;
+        headers?: Record<string, string>;
+        method?: string;
+        signal?: AbortSignal;
+        url: string;
+    }): Promise<T>;
+}
+export interface WorkbenchUploadAdapter {
+    uploadFile(file: File | Blob, options?: {
+        fileName?: string;
+        signal?: AbortSignal;
+    }): Promise<Record<string, unknown>>;
+}
+export interface WorkbenchRouterAdapter {
+    push(to: string): Promise<void> | void;
+    readQuery(): Record<string, string | string[] | undefined>;
+    replaceQuery(query: Record<string, string | undefined>): Promise<void> | void;
+}
+export interface WorkbenchStorageAdapter {
+    getItem(key: string): string | null;
+    removeItem(key: string): void;
+    setItem(key: string, value: string): void;
+}
+export interface WorkbenchAssetAdapter {
+    resolveAssetUrl(path: string): string;
+}
+export interface WorkbenchMessageAdapter {
+    error(content: string): void;
+    info(content: string): void;
+    success(content: string): void;
+    warning(content: string): void;
+}
+export interface WorkbenchLoggerAdapter {
+    debug(message: string, payload?: unknown): void;
+    error(message: string, payload?: unknown): void;
+    info(message: string, payload?: unknown): void;
+    warn(message: string, payload?: unknown): void;
+}
+export interface WorkbenchAppAdapters {
+    agentTransportAdapter: WorkbenchAgentTransportAdapter;
+    assetAdapter?: WorkbenchAssetAdapter;
+    identityAdapter: WorkbenchIdentityAdapter;
+    loggerAdapter?: WorkbenchLoggerAdapter;
+    messageAdapter?: WorkbenchMessageAdapter;
+    platformRequestAdapter: WorkbenchPlatformRequestAdapter;
+    routerAdapter: WorkbenchRouterAdapter;
+    storageAdapter?: WorkbenchStorageAdapter;
+    uploadAdapter: WorkbenchUploadAdapter;
+}

package/dist/canvas/api/types.d.ts

@@ -0,0 +1,117 @@
+/**
+ * @fileoverview 画布运行时 API 类型 - 定义插卡、改卡和持久化适配器合同。
+ * @author seadon
+ * @created 2026-08-12
+ */
+import type { CardRegistryEntry } from '@fses/workbench-card/registry';
+import type { BlockLayout, MaterializedBlock, RuntimeCapabilityMutation, WorkbenchSnapshot } from '@fses/workbench-card/types';
+export type CanvasMutationErrorCode = 'INVALID_PARAMS' | 'CAPABILITY_NOT_FOUND' | 'CARD_NOT_FOUND' | 'OBJECT_NOT_FOUND' | 'POLICY_REJECTED' | 'PRIMITIVE_GAP' | 'VERSION_CONFLICT' | 'PERSISTENCE_FAILED' | 'UNSUPPORTED_OPERATION';
+export type CardSizePreset = 'small' | 'medium' | 'componentTall' | 'large' | 'screen';
+export type CardTargetScope = 'cardObject' | 'card' | 'canvas';
+export type InsertCardTargetScope = 'canvas' | 'nested';
+export type CardLifecycleOperation = 'freeModify' | 'renameTitle' | 'editBodyText' | 'editText' | 'changeChart' | 'changeDataSource' | 'adjustLayout' | 'replaceCard' | 'locateCard' | 'modifyCard' | 'deleteCard' | 'clearCanvas' | 'overwriteCanvas' | 'rollback' | 'mutateCapability';
+export type LegacyCardOperation = 'patch' | 'updateData' | 'updateStyle' | 'updateTitle' | 'updateSize' | 'updatePosition' | 'replaceRenderer';
+export type UpdateCardOperation = CardLifecycleOperation | LegacyCardOperation;
+export interface CanvasMutationError {
+    code: CanvasMutationErrorCode;
+    message: string;
+    details?: unknown;
+}
+export interface CardMutationResult {
+    success: boolean;
+    requestId: string;
+    operation: 'insertCard' | 'updateCard';
+    affectedCardIds: string[];
+    snapshotVersion?: number;
+    data?: {
+        card?: MaterializedBlock;
+        cards?: MaterializedBlock[];
+        snapshot?: WorkbenchSnapshot;
+        transactionId?: string;
+        locatedCardId?: string;
+        pendingSync?: boolean;
+    };
+    error?: CanvasMutationError;
+}
+export interface InsertCardParams {
+    requestId?: string;
+    capabilityId?: string;
+    category?: string;
+    type?: string;
+    variant?: string;
+    title?: string;
+    subtitle?: string;
+    data?: Record<string, unknown>;
+    renderer?: {
+        rendererKey?: string;
+        engine?: string;
+        preset?: string;
+    };
+    size?: {
+        preset?: CardSizePreset;
+        width?: number;
+        height?: number;
+    };
+    layout?: Partial<BlockLayout>;
+    targetScope?: InsertCardTargetScope;
+    targetParentId?: string;
+    meta?: Record<string, unknown>;
+    baseSnapshotVersion?: number;
+    persistence?: CanvasPersistenceOptions;
+    registryEntry?: CardRegistryEntry;
+}
+export interface UpdateCardTarget {
+    scope?: CardTargetScope;
+    cardId?: string;
+    objectSelector?: {
+        objectId?: string;
+        objectType?: string;
+        path?: string;
+        textKeyword?: string;
+        seriesName?: string;
+        columnKey?: string;
+        componentId?: string;
+    };
+}
+export interface UpdateCardParams {
+    requestId?: string;
+    target?: UpdateCardTarget;
+    operation: UpdateCardOperation;
+    payload?: Record<string, unknown>;
+    baseSnapshotVersion?: number;
+    persistence?: CanvasPersistenceOptions;
+}
+export interface CanvasPersistenceOptions {
+    saveLocal?: boolean;
+    saveRemote?: boolean;
+    baseSnapshotVersion?: number;
+}
+export interface CanvasRuntimePersistenceState {
+    dirty: boolean;
+    pendingSync: boolean;
+    lastSavedVersion?: number;
+    lastError?: CanvasMutationError;
+}
+export interface PrimitiveGap {
+    missingPrimitives: string[];
+    gapType: 'runtime_capability_primitives';
+    userNeed: string;
+    missingCapabilities: Array<{
+        id: string;
+        userFacingName: string;
+        description: string;
+        status: 'planned' | 'unknown' | 'disabled';
+    }>;
+}
+export interface MutateCapabilityPayload {
+    mutation: RuntimeCapabilityMutation;
+}
+export interface CanvasRuntimeAdapter {
+    getSnapshot: () => WorkbenchSnapshot | null;
+    commitSnapshot: (snapshot: WorkbenchSnapshot, persistence?: CanvasPersistenceOptions) => Promise<WorkbenchSnapshot>;
+    locateCard?: (cardId: string) => void;
+}
+export type CanvasApi = {
+    insertCard: (params: InsertCardParams) => Promise<CardMutationResult>;
+    updateCard: (params: UpdateCardParams) => Promise<CardMutationResult>;
+};

package/dist/canvas/bridge/workbenchCanvasBus.d.ts

@@ -0,0 +1,7 @@
+import type { CardMutationResult, InsertCardParams, UpdateCardParams } from '../api/types';
+export type WorkbenchCanvasBusEvents = {
+    'workbench:card:insert': InsertCardParams;
+    'workbench:card:update': UpdateCardParams;
+    'workbench:card:mutation-result': CardMutationResult;
+};
+export declare const workbenchCanvasBus: import("mitt").Emitter<WorkbenchCanvasBusEvents>;

package/dist/canvas/layout/logicalLayoutEngine.d.ts

@@ -0,0 +1,85 @@
+/**
+ * @fileoverview 工作台逻辑布局引擎 - 提供卡片插入、吸附、紧凑排布和坐标转换能力
+ * @author seadon
+ * @created 2026-05-07
+ */
+import type { BlockLayout } from '@fses/workbench-card/types';
+import type { CardSizePreset } from '../api/types';
+export declare const LOGICAL_CANVAS_COLUMNS = 100;
+export declare const SNAP_UNIT = 5;
+export type LogicalRect = Pick<BlockLayout, 'x' | 'y' | 'w' | 'h'>;
+export declare const DEFAULT_LOGICAL_CARD_PRESET_SIZES: Record<CardSizePreset, Pick<BlockLayout, 'w' | 'h'>>;
+export declare function getLogicalScale(canvasPixelWidth: number): number;
+export declare function logicalToPixel(value: number, scale: number): number;
+export declare function pixelToLogical(value: number, scale: number): number;
+export declare function snapLogical(value: number, unit?: number): number;
+export declare function defaultLogicalSize(preset?: CardSizePreset): {
+    w: number;
+    h: number;
+};
+export declare function clampLogicalRect(rect: LogicalRect): LogicalRect;
+export declare function rectsOverlap(left: LogicalRect, right: LogicalRect): boolean;
+export declare function isSlotFree(candidate: LogicalRect, placed: LogicalRect[]): boolean;
+export declare function findFreeLogicalRect(requested: LogicalRect, placed: LogicalRect[]): LogicalRect;
+/**
+ * Resolves an automatic insert position by filling existing row slots before accepting default coordinates.
+ * @param requested - Requested fallback rect from service/default card metadata.
+ * @param placed - Existing canvas card layouts.
+ * @returns Free layout rect for an automatic insert.
+ */
+export declare function findAutoInsertLogicalRect(requested: LogicalRect, placed: LogicalRect[]): LogicalRect;
+export declare function compactLogicalRows<T extends {
+    layout: LogicalRect;
+}>(items: T[]): (T & {
+    layout: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+})[];
+/**
+ * Re-packs cards into dense rows while preserving each card's current size.
+ * @param blocks - Cards ordered by previous visual position.
+ * @returns Cards with updated x/y only; w/h remain unchanged.
+ */
+export declare function repackLogicalBlocksPreserveSize<T extends {
+    id: string;
+    layout: LogicalRect;
+}>(blocks: T[]): (T & {
+    layout: {
+        i: string;
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+})[];
+export declare function compactLogicalBlocksAfterInsert<T extends {
+    id: string;
+    layout: LogicalRect;
+}>(blocks: T[]): (T & {
+    layout: {
+        i: string;
+        w: number;
+        h: number;
+        x: number;
+        y: number;
+    };
+})[];
+export declare function canvasLogicalHeight(rects: LogicalRect[], bottomPadding?: number): number;
+export declare function resolveInitialLogicalRect(input: {
+    preset?: CardSizePreset;
+    width?: number;
+    height?: number;
+    layout?: Partial<BlockLayout>;
+    placed: LogicalRect[];
+}): LogicalRect;
+export declare function resolveAutoInsertLogicalRect(input: {
+    preset?: CardSizePreset;
+    width?: number;
+    height?: number;
+    layout?: Partial<BlockLayout>;
+    placed: LogicalRect[];
+}): LogicalRect;
+export declare function logicalRectToBlockLayout(id: string, rect: LogicalRect): BlockLayout;

package/dist/canvas/persistence/canvasSnapshotStorage.d.ts

@@ -0,0 +1,3 @@
+import type { WorkbenchSnapshot } from '@fses/workbench-card/types';
+export declare function readCanvasLocalSnapshot(workspaceId: string, userId: string): WorkbenchSnapshot;
+export declare function writeCanvasLocalSnapshot(snapshot: WorkbenchSnapshot): void;

package/dist/card/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview 工作台卡片公共入口 - 显式转出脚手架使用的稳定卡片、注册表和渲染能力。
+ * @author seadon
+ * @created 2026-08-12
+ */
+export { workbenchCardShellStyle } from '@fses/workbench-card';
+export { CARD_CATEGORIES, CARD_REGISTRY, cardRegistryByCapabilityId, compositeCardPatternById, resolveCardRegistryEntry, } from '@fses/workbench-card/registry';
+export { EChartsProtocolAdapter, EChartsProtocolRenderer, WorkbenchBlockRenderer, applyWorkbenchResizableColumns, setWorkbenchResizableColumnWidth, workbenchResizableTableScrollX, } from '@fses/workbench-card/renderers';

package/dist/card/index.js

@@ -0,0 +1,17 @@
+import { workbenchCardShellStyle as o } from "@fses/workbench-card";
+import { CARD_CATEGORIES as l, CARD_REGISTRY as a, cardRegistryByCapabilityId as R, compositeCardPatternById as c, resolveCardRegistryEntry as n } from "@fses/workbench-card/registry";
+import { EChartsProtocolAdapter as C, EChartsProtocolRenderer as b, WorkbenchBlockRenderer as d, applyWorkbenchResizableColumns as h, setWorkbenchResizableColumnWidth as i, workbenchResizableTableScrollX as p } from "@fses/workbench-card/renderers";
+export {
+  l as CARD_CATEGORIES,
+  a as CARD_REGISTRY,
+  C as EChartsProtocolAdapter,
+  b as EChartsProtocolRenderer,
+  d as WorkbenchBlockRenderer,
+  h as applyWorkbenchResizableColumns,
+  R as cardRegistryByCapabilityId,
+  c as compositeCardPatternById,
+  n as resolveCardRegistryEntry,
+  i as setWorkbenchResizableColumnWidth,
+  o as workbenchCardShellStyle,
+  p as workbenchResizableTableScrollX
+};

package/dist/chat/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview 工作台聊天公共入口 - 显式转出脚手架使用的稳定聊天能力。
+ * @author seadon
+ * @created 2026-08-12
+ */
+export { CardRecommendationDraftView, FsesAiChat, canShowRecommendationFieldConfig, } from '@fses/ai-chat';
+export { deriveChartCardsFromMarkdown } from '@fses/ai-chat/chart-card/from-markdown';
+export { resolveCardRecommendationFieldLabel } from '@fses/ai-chat/utils/card-recommendation-field-label';
+export { isMetricServiceRecommendation } from '@fses/ai-chat/utils/card-recommendation-source';

package/dist/chat/index.js

@@ -0,0 +1,12 @@
+import { CardRecommendationDraftView as r, FsesAiChat as a, canShowRecommendationFieldConfig as i } from "@fses/ai-chat";
+import { deriveChartCardsFromMarkdown as t } from "@fses/ai-chat/chart-card/from-markdown";
+import { resolveCardRecommendationFieldLabel as n } from "@fses/ai-chat/utils/card-recommendation-field-label";
+import { isMetricServiceRecommendation as f } from "@fses/ai-chat/utils/card-recommendation-source";
+export {
+  r as CardRecommendationDraftView,
+  a as FsesAiChat,
+  i as canShowRecommendationFieldConfig,
+  t as deriveChartCardsFromMarkdown,
+  f as isMetricServiceRecommendation,
+  n as resolveCardRecommendationFieldLabel
+};

package/dist/components/WorkbenchAppHost.vue.d.ts

@@ -0,0 +1,28 @@
+import type { WorkbenchAppAdapters } from '../adapters/types';
+import type { WorkbenchAppConfig } from '../config/workbenchAppConfig';
+import type { WorkbenchAppExtensions } from '../extensions';
+import type { WorkbenchRuntimeFacade } from '../runtime/store/workbenchRuntimeFacade';
+type __VLS_Props = {
+    adapters: Partial<WorkbenchAppAdapters>;
+    config: WorkbenchAppConfig;
+    extensions: WorkbenchAppExtensions;
+    runtime: WorkbenchRuntimeFacade;
+};
+declare var __VLS_12: {}, __VLS_14: {}, __VLS_16: {}, __VLS_18: {};
+type __VLS_Slots = {} & {
+    left?: (props: typeof __VLS_12) => any;
+} & {
+    right?: (props: typeof __VLS_14) => any;
+} & {
+    'collapsed-right'?: (props: typeof __VLS_16) => any;
+} & {
+    drawer?: (props: typeof __VLS_18) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, 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/components/WorkbenchApplication.vue.d.ts

@@ -0,0 +1,13 @@
+import type { WorkbenchAppAdapters } from '../adapters/types';
+import type { WorkbenchAppConfig } from '../config/workbenchAppConfig';
+import type { WorkbenchAppExtensions } from '../extensions';
+type __VLS_Props = {
+    adapters: Partial<WorkbenchAppAdapters>;
+    config: WorkbenchAppConfig;
+    embedInPortal?: boolean;
+    extensions: WorkbenchAppExtensions;
+};
+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, false, {}, any>;
+export default _default;

package/dist/components/WorkbenchShell.vue.d.ts

@@ -0,0 +1,32 @@
+type __VLS_Props = {
+    studioPanelWidth: number;
+    studioPanelCollapsed: boolean;
+    studioPanelEnabled?: boolean;
+    drawerOpen?: boolean;
+    drawerWidth?: number;
+    dragging: boolean;
+    canvasFocusMode: boolean;
+    imageWorkbench?: boolean;
+};
+declare var __VLS_1: {}, __VLS_3: {}, __VLS_9: {}, __VLS_11: {};
+type __VLS_Slots = {} & {
+    left?: (props: typeof __VLS_1) => any;
+} & {
+    right?: (props: typeof __VLS_3) => any;
+} & {
+    'collapsed-right'?: (props: typeof __VLS_9) => any;
+} & {
+    drawer?: (props: typeof __VLS_11) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    startDrag: (event: PointerEvent) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onStartDrag?: (event: PointerEvent) => any;
+}>, {}, {}, {}, {}, 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/components/WorkbenchWorkspaceCore.vue.d.ts

@@ -0,0 +1,20 @@
+import type { WorkbenchAppAdapters } from '../adapters/types';
+import type { WorkbenchAppConfig } from '../config/workbenchAppConfig';
+import type { WorkbenchAppExtensions } from '../extensions';
+type __VLS_Props = {
+    adapters: Partial<WorkbenchAppAdapters>;
+    config: WorkbenchAppConfig;
+    extensions: WorkbenchAppExtensions;
+};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, 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/config/workbenchAppConfig.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @fileoverview 工作台应用配置类型 - 定义脚手架传入公共工作台主体的静态配置。
+ * @author seadon
+ * @created 2026-08-11
+ */
+import type { RoleId } from '@fses/workbench-card/types';
+export interface WorkbenchAppBrandConfig {
+    logoUrl?: string;
+    name?: string;
+    welcomeText?: string;
+}
+export interface WorkbenchAppFeatureFlags {
+    cardCenter?: boolean;
+    debugRoutes?: boolean;
+    fdeMode?: boolean;
+    imageCompose?: boolean;
+    themeSwitch?: boolean;
+}
+export interface WorkbenchAppDefaults {
+    canvasGapPreset?: string;
+    cardPresetSize?: string;
+    roleId?: RoleId | string;
+    studioPanelWidth?: number;
+    workbenchId?: string;
+}
+export interface WorkbenchAppRouteConfig {
+    helpUrl?: string;
+    resolveDetailUrl?: (payload: {
+        blockId?: string;
+        resourceId?: string;
+        type: string;
+    }) => string;
+}
+export interface WorkbenchAppConfig {
+    brand?: WorkbenchAppBrandConfig;
+    defaults?: WorkbenchAppDefaults;
+    features?: WorkbenchAppFeatureFlags;
+    routes?: WorkbenchAppRouteConfig;
+    theme?: {
+        defaultThemeKey?: string;
+        designSpecKey?: string;
+    };
+}

package/dist/contracts/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview workbench-app 协议合同入口 - 收敛脚手架使用的技能载荷校验器和 FDE Core 类型。
+ * @author seadon
+ * @created 2026-08-12
+ */
+export { isQueryClarificationPayloadV1, isQueryResultArtifactPayloadV1, validateWorkbenchSkillPayloadV1, } from '@byteluck/workbench-skill-contracts';
+export type { FdeCoreLiveNotification, FdeCoreProjectionWire, FdeCoreServerRequestEnvelope, FdeCoreSubscriptionFrame, FdeDeltaNotification, FdeEventAppendedNotification, FdeFullThreadItem, } from '@byteluck/agentic-protocol';

package/dist/contracts/index.js

@@ -0,0 +1,6 @@
+import { isQueryClarificationPayloadV1 as l, isQueryResultArtifactPayloadV1 as o, validateWorkbenchSkillPayloadV1 as r } from "@byteluck/workbench-skill-contracts";
+export {
+  l as isQueryClarificationPayloadV1,
+  o as isQueryResultArtifactPayloadV1,
+  r as validateWorkbenchSkillPayloadV1
+};

package/dist/extensions/index.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @fileoverview 工作台扩展类型 - 定义脚手架和用户智能体可插入的卡片、模板页、主题和快捷入口。
+ * @author seadon
+ * @created 2026-08-11
+ */
+import type { Component } from 'vue';
+import type { RouteRecordRaw } from 'vue-router';
+import type { CardRegistryEntry } from '@fses/workbench-card/registry';
+import type { WorkbenchRendererCustomComponentEntry, WorkbenchRendererCustomComponentRegistry } from '@fses/workbench-card/renderers';
+import type { FdeSkillCardIntent } from '../internal/personal-workbench/fde-skill-cards/runtime/fdeSkillCardTypes';
+import type { FdeSkillDashboardManifest } from '../internal/personal-workbench/fde-skill-cards/runtime/fdeSkillDashboardTypes';
+import type { FdeSkillTemplatePageManifest } from '../internal/personal-workbench/fde-skill-cards/runtime/fdeSkillTemplatePageTypes';
+import type { WorkbenchThemeSourceConfig } from '../internal/personal-workbench/themes/workbenchThemeDefinitions';
+export interface WorkbenchCustomComponentRegistryEntry {
+    component: Component;
+    componentName: string;
+    componentRef: string;
+    enabled?: boolean;
+    exportName: string;
+    packageName: string;
+    validateProps?: (props: Record<string, unknown>, data?: unknown) => boolean | string;
+    version: string;
+}
+export interface WorkbenchCustomCardCatalogEntry extends CardRegistryEntry {
+    componentRef: string;
+    defaultProps: Record<string, unknown>;
+    exportName: string;
+    insertionMode: 'host' | 'registered';
+    packageName: string;
+    packageVersion: string;
+    previewUrl: string;
+    sourceLabel: string;
+}
+export type FdeGeneratedCards = readonly FdeSkillCardIntent[];
+export type FdeGeneratedDashboard = FdeSkillDashboardManifest | null;
+export type FdeGeneratedTemplatePage = FdeSkillTemplatePageManifest | null;
+export type WorkbenchThemeDefinition = WorkbenchThemeSourceConfig;
+export type WorkbenchPageRouteExtension = RouteRecordRaw;
+export interface WorkbenchAppExtensions {
+    assistantPersonaProfiles?: Record<string, unknown>;
+    cards?: {
+        customCardCatalog?: WorkbenchCustomCardCatalogEntry[];
+        customComponentRegistry?: WorkbenchRendererCustomComponentRegistry;
+    };
+    fde?: {
+        generatedCards?: FdeGeneratedCards;
+        generatedDashboard?: FdeGeneratedDashboard;
+        generatedTemplatePage?: FdeGeneratedTemplatePage;
+        generatedTemplateShell?: Component;
+        workbenchTheme?: WorkbenchThemeDefinition;
+    };
+    pages?: {
+        routes?: readonly WorkbenchPageRouteExtension[];
+    };
+    quickEntryGroups?: unknown[];
+    systemCardPromptSelections?: unknown[];
+    themeDefinitions?: readonly WorkbenchThemeDefinition[];
+}
+export type { WorkbenchRendererCustomComponentEntry, WorkbenchRendererCustomComponentRegistry, };

package/dist/fde-runtime/runtime/fdeSkillDisplayLabel.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @fileoverview FDE 技能卡展示名工具 - 将技术字段名兜底转换为中文可见文案。
+ * @author seadon
+ * @created 2026-07-15
+ */
+/**
+ * 解析列表卡列头的中文展示名，避免前端兜底显示 SQL/接口字段名。
+ * @param input - 列字段、标题和序号。
+ * @returns 中文可见列头。
+ */
+export declare function resolveFdeSkillVisibleColumnTitle(input: {
+    field: string;
+    title?: string;
+    index: number;
+}): string;