@fses/workbench-app 0.2.17 → 0.2.20

package/dist/internal/personal-workbench/controllers/workbenchChartDrilldownTable.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @fileoverview Workspace 图表明细表格纯模型 - 提供单元格文本和默认列宽算法。
+ * @author seadon
+ * @created 2026-09-01
+ */
+export interface ChartDrilldownColumn {
+    label?: string;
+    name: string;
+    type: string;
+}
+export interface ChartDrilldownColumnWidthOptions {
+    maxWidth: number;
+    minWidth: number;
+}
+/**
+ * 将明细单元格值转换为可展示文本。
+ * @param value - 原始单元格值。
+ * @returns 标量字符串、JSON 字符串或空字符串。
+ */
+export declare function chartDrilldownCellText(value: unknown): string;
+/**
+ * 估算表格文本宽度。
+ * @param text - 待估算文本。
+ * @returns 近似像素宽度。
+ */
+export declare function estimateChartDrilldownTextWidth(text: string): number;
+/**
+ * 根据当前页可见数据计算明细列默认宽度。
+ * @param column - 列元数据。
+ * @param rows - 当前页明细行。
+ * @param options - 最小和最大宽度。
+ * @returns 默认列宽像素值。
+ */
+export declare function chartDrilldownPreferredColumnWidth(column: ChartDrilldownColumn, rows: Array<Record<string, unknown>>, options: ChartDrilldownColumnWidthOptions): number;

package/dist/internal/personal-workbench/controllers/workbenchFdeVersionController.d.ts

@@ -0,0 +1,107 @@
+import type { FdeWorkbenchAssetPackage } from '../lib/fdeWorkbenchAssetPackage';
+import type { WorkbenchJsonRequestTransport } from '../lib/workbenchRequestTransport';
+import { type FdeWorkbenchConfigRecord, type FdeWorkbenchContext, type FdeWorkbenchRestoreResult, type FdeWorkbenchVersionRecord } from '../lib/fdeWorkbenchConfigClient';
+export interface WorkbenchFdeVersionRuntimePort {
+    applyFdeHostInit(payload: {
+        type: 'bt-workbench:fde-init';
+        protocolVersion: 1;
+        resourceId: string;
+        versionId?: string;
+        draftPackage: FdeWorkbenchAssetPackage | null;
+        user: {
+            userId: string;
+            roleId: string;
+        };
+    }): unknown;
+    canvasDirty: boolean;
+    canvasPendingSync: boolean;
+    exportFdeDraftPackage(): Promise<FdeWorkbenchAssetPackage>;
+    fdeMode: boolean;
+    fdeName: string;
+    fdeResourceId: string;
+    workspaceId: string;
+}
+export interface WorkbenchFdeVersionServices {
+    decodeConfig(configJson?: string | null): FdeWorkbenchAssetPackage | null;
+    getConfig(context: FdeWorkbenchContext): Promise<FdeWorkbenchConfigRecord | null>;
+    listVersions(context: FdeWorkbenchContext): Promise<FdeWorkbenchVersionRecord[]>;
+    restoreVersion(context: FdeWorkbenchContext, versionNo: number | string): Promise<FdeWorkbenchRestoreResult>;
+    saveConfig(context: FdeWorkbenchContext, assetPackage: FdeWorkbenchAssetPackage): Promise<unknown>;
+    saveVersion(context: FdeWorkbenchContext, versionName: string, assetPackage: FdeWorkbenchAssetPackage): Promise<unknown>;
+}
+export interface WorkbenchFdeVersionControllerOptions {
+    flushCanvasDraft(): Promise<boolean>;
+    loadDelayMs?: number;
+    notify: {
+        error(message: string): void;
+        success(message: string): void;
+    };
+    requestTransport?: WorkbenchJsonRequestTransport;
+    runtime: WorkbenchFdeVersionRuntimePort;
+    services?: WorkbenchFdeVersionServices;
+}
+export interface WorkbenchFdeVersionOption {
+    current: boolean;
+    description: string;
+    versionName: string;
+    versionNo: number | string;
+}
+/**
+ * 归一化版本列表。
+ * @param versions - 服务端版本记录。
+ * @param currentVersionNo - 当前版本号。
+ * @returns UI 可直接展示的版本选项。
+ */
+export declare function normalizeFdeVersionOptions(versions: FdeWorkbenchVersionRecord[], currentVersionNo: number | string): WorkbenchFdeVersionOption[];
+/**
+ * 创建 FDE 配置版本控制器。
+ * @param options - 运行时端口、配置服务、通知与画布 flush 回调。
+ * @returns reactive 状态和完整版本生命周期操作。
+ */
+export declare function createWorkbenchFdeVersionController(options: WorkbenchFdeVersionControllerOptions): {
+    busy: import("vue").Ref<boolean, boolean>;
+    closeVersionMenu: () => void;
+    context: import("vue").Ref<{
+        resourceId: string;
+        appId: string;
+        tenantId: string;
+        userId: string;
+        egoUserinfo: string;
+        resourceName: string;
+    }, FdeWorkbenchContext | {
+        resourceId: string;
+        appId: string;
+        tenantId: string;
+        userId: string;
+        egoUserinfo: string;
+        resourceName: string;
+    }>;
+    currentVersionNo: import("vue").Ref<string | number, string | number>;
+    dirty: import("vue").Ref<boolean, boolean>;
+    dispose(): void;
+    draftChanged: import("vue").ComputedRef<boolean>;
+    handleVersionMenuFocusout: (event: FocusEvent) => void;
+    handleVersionOutsidePointerDown: (event: PointerEvent) => void;
+    load: () => Promise<void>;
+    refreshVersions: () => Promise<void>;
+    restore: (versionNo: number | string) => Promise<void>;
+    save: () => Promise<void>;
+    saveAsVersion: () => Promise<void>;
+    setContext: (nextContext: FdeWorkbenchContext, setOptions?: {
+        scheduleLoad?: boolean;
+    }) => void;
+    versionLabel: import("vue").ComputedRef<string>;
+    versionMenuOpen: import("vue").Ref<boolean, boolean>;
+    versionMenuRef: import("vue").Ref<HTMLElement, HTMLElement>;
+    versions: import("vue").Ref<{
+        current: boolean;
+        description: string;
+        versionName: string;
+        versionNo: number | string;
+    }[], WorkbenchFdeVersionOption[] | {
+        current: boolean;
+        description: string;
+        versionName: string;
+        versionNo: number | string;
+    }[]>;
+};

package/dist/internal/personal-workbench/controllers/workbenchRecommendationConfigModel.d.ts

@@ -0,0 +1,82 @@
+import type { CardRecommendationItem, MaterializedBlock } from '@fses/workbench-app/types';
+/**
+ * 读取推荐项字段映射。
+ * @param item - 推荐项。
+ * @returns 第一份非空字段映射。
+ */
+export declare function configuredRecommendationFieldMapping(item: CardRecommendationItem): Record<string, unknown>;
+/**
+ * 合并推荐项字段标签。
+ * @param item - 推荐项。
+ * @returns 字段标签映射。
+ */
+export declare function configuredRecommendationFieldLabels(item: CardRecommendationItem): Record<string, unknown>;
+/**
+ * 返回第一份非空记录。
+ * @param candidates - 候选记录。
+ * @returns 第一份非空记录或空对象。
+ */
+export declare function firstNonEmptyRecord(...candidates: Array<Record<string, unknown>>): Record<string, unknown>;
+/**
+ * 合并已有卡片 dataBinding 元数据。
+ * @param block - 已有卡片。
+ * @returns 合并后的 dataBinding。
+ */
+export declare function existingCardDataBindingRecord(block: MaterializedBlock): Record<string, unknown>;
+/**
+ * 读取已有卡片字段映射。
+ * @param block - 已有卡片。
+ * @returns 历史兼容字段映射。
+ */
+export declare function existingCardFieldMapping(block: MaterializedBlock): Record<string, unknown>;
+/**
+ * 合并已有卡片字段标签。
+ * @param block - 已有卡片。
+ * @returns 字段标签映射。
+ */
+export declare function existingCardFieldLabels(block: MaterializedBlock): Record<string, unknown>;
+/**
+ * 读取列定义字段名。
+ * @param column - 列定义或字段字符串。
+ * @returns 字段名。
+ */
+export declare function existingCardColumnName(column: unknown): string;
+/**
+ * 从列数组读取去重字段名。
+ * @param value - 候选列数组。
+ * @returns 去重字段名。
+ */
+export declare function existingCardColumnNamesFromArray(value: unknown): string[];
+/**
+ * 从字段映射提取字段名。
+ * @param mapping - 字段映射。
+ * @returns 去重字段名。
+ */
+export declare function existingCardFieldNamesFromMapping(mapping: Record<string, unknown>): string[];
+/**
+ * 读取已有卡片行样本。
+ * @param block - 已有卡片。
+ * @returns 非空行样本。
+ */
+export declare function existingCardRows(block: MaterializedBlock): Array<Record<string, unknown>>;
+/**
+ * 读取已有卡片列定义。
+ * @param block - 已有卡片。
+ * @returns 字段名与展示名。
+ */
+export declare function existingCardColumns(block: MaterializedBlock): Array<{
+    name: string;
+    label: string;
+}>;
+/**
+ * 生成已有卡片重绑定问数口径。
+ * @param block - 已有卡片。
+ * @returns 可复用问数口径。
+ */
+export declare function existingCardRebindBusinessWording(block: MaterializedBlock): string;
+/**
+ * 将已有卡片投影为字段配置推荐项。
+ * @param block - 已有卡片或空值。
+ * @returns 配置推荐项或 null。
+ */
+export declare function existingCardFieldConfigItem(block: MaterializedBlock | null): CardRecommendationItem | null;

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

@@ -1,5 +1,8 @@
 import { type RuntimeIdentityContext } from './runtimeIdentity';
+import type { WorkbenchAgentTransportAdapter } from '../../../adapters/types';
 export type DeepAgentClientContext = RuntimeIdentityContext;
+type DeepAgentJsonTransport = Pick<WorkbenchAgentTransportAdapter, 'requestJson'>;
+type DeepAgentEventTransport = Pick<WorkbenchAgentTransportAdapter, 'openEventStream'>;
 export interface DeepAgentRunMessagePayload {
     content: string;
     metadata?: Record<string, unknown>;
@@ -103,7 +106,7 @@ export declare function classifyDeepAgentCreateError(error: unknown): DeepAgentC
  * @param payload - 用户输入和 UI 上下文
  * @returns run 视图
  */
-export declare function createDeepAgentRun(context: DeepAgentClientContext, payload: CreateDeepAgentRunPayload, idempotencyKey: string): Promise<DeepAgentRunView>;
+export declare function createDeepAgentRun(context: DeepAgentClientContext, payload: CreateDeepAgentRunPayload, idempotencyKey: string, transport?: DeepAgentJsonTransport): Promise<DeepAgentRunView>;
 /**
  * 在已有 thread 下创建后续 run。
  * @param context - 运行态身份上下文
@@ -111,14 +114,14 @@ export declare function createDeepAgentRun(context: DeepAgentClientContext, payl
  * @param payload - 用户输入和 UI 上下文
  * @returns run 视图
  */
-export declare function createDeepAgentThreadRun(context: DeepAgentClientContext, threadId: string, payload: CreateDeepAgentRunPayload, idempotencyKey: string): Promise<DeepAgentRunView>;
+export declare function createDeepAgentThreadRun(context: DeepAgentClientContext, threadId: string, payload: CreateDeepAgentRunPayload, idempotencyKey: string, transport?: DeepAgentJsonTransport): Promise<DeepAgentRunView>;
 /**
  * 查询 thread 当前 active owner 与 FIFO pending 快照。
  * @param context - 运行态身份上下文。
  * @param threadId - DeepAgent thread id。
  * @returns 带单调版本号的队列快照。
  */
-export declare function getDeepAgentThreadQueue(context: DeepAgentClientContext, threadId: string): Promise<DeepAgentThreadQueueView>;
+export declare function getDeepAgentThreadQueue(context: DeepAgentClientContext, threadId: string, transport?: DeepAgentJsonTransport): Promise<DeepAgentThreadQueueView>;
 /**
  * 查询 run 视图。
  * @param context - 运行态身份上下文
@@ -126,7 +129,7 @@ export declare function getDeepAgentThreadQueue(context: DeepAgentClientContext,
  * @param runId - DeepAgent run id
  * @returns run 视图
  */
-export declare function getDeepAgentRun(context: DeepAgentClientContext, threadId: string, runId: string): Promise<DeepAgentRunView>;
+export declare function getDeepAgentRun(context: DeepAgentClientContext, threadId: string, runId: string, transport?: DeepAgentJsonTransport): Promise<DeepAgentRunView>;
 /**
  * 查询 thread 消息。
  * @param context - 运行态身份上下文
@@ -134,7 +137,7 @@ export declare function getDeepAgentRun(context: DeepAgentClientContext, threadI
  * @param query - 分页参数
  * @returns messages page
  */
-export declare function listDeepAgentMessages(context: DeepAgentClientContext, threadId: string, query?: ListDeepAgentMessagesQuery): Promise<unknown>;
+export declare function listDeepAgentMessages(context: DeepAgentClientContext, threadId: string, query?: ListDeepAgentMessagesQuery, transport?: DeepAgentJsonTransport): Promise<unknown>;
 /**
  * 提交 run resume 决策。
  * @param context - 运行态身份上下文
@@ -143,7 +146,7 @@ export declare function listDeepAgentMessages(context: DeepAgentClientContext, t
  * @param payload - resume payload
  * @returns resume 结果
  */
-export declare function resumeDeepAgentRun(context: DeepAgentClientContext, threadId: string, runId: string, payload: ResumeDeepAgentRunPayload): Promise<DeepAgentRunView>;
+export declare function resumeDeepAgentRun(context: DeepAgentClientContext, threadId: string, runId: string, payload: ResumeDeepAgentRunPayload, transport?: DeepAgentJsonTransport): Promise<DeepAgentRunView>;
 /**
  * 取消 run。
  * @param context - 运行态身份上下文
@@ -152,7 +155,7 @@ export declare function resumeDeepAgentRun(context: DeepAgentClientContext, thre
  * @param payload - cancel payload
  * @returns cancel 结果
  */
-export declare function cancelDeepAgentRun(context: DeepAgentClientContext, threadId: string, runId: string, payload?: CancelDeepAgentRunPayload): Promise<unknown>;
+export declare function cancelDeepAgentRun(context: DeepAgentClientContext, threadId: string, runId: string, payload?: CancelDeepAgentRunPayload, transport?: DeepAgentJsonTransport): Promise<unknown>;
 /**
  * 存档 run。
  * @param context - 运行态身份上下文
@@ -161,7 +164,7 @@ export declare function cancelDeepAgentRun(context: DeepAgentClientContext, thre
  * @param payload - archive payload
  * @returns archive 结果
  */
-export declare function archiveDeepAgentRun(context: DeepAgentClientContext, threadId: string, runId: string, payload?: ArchiveDeepAgentRunPayload): Promise<unknown>;
+export declare function archiveDeepAgentRun(context: DeepAgentClientContext, threadId: string, runId: string, payload?: ArchiveDeepAgentRunPayload, transport?: DeepAgentJsonTransport): Promise<unknown>;
 /**
  * 打开 run events SSE。
  * @param context - 运行态身份上下文
@@ -179,7 +182,7 @@ export declare function openDeepAgentRunEvents(context: DeepAgentClientContext,
     signal?: AbortSignal;
     lastEventId?: string;
     eventsUrl?: string;
-}): Promise<void>;
+}, transport?: DeepAgentEventTransport): Promise<void>;
 /**
  * 解析后端返回的 DeepAgent events URL 为 gateway URL。
  * @param threadId - DeepAgent thread id
@@ -188,3 +191,4 @@ export declare function openDeepAgentRunEvents(context: DeepAgentClientContext,
  * @returns gateway 下的 events URL
  */
 export declare function resolveDeepAgentEventsUrl(threadId: string, runId: string, eventsUrl?: string): string;
+export {};

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

@@ -37,6 +37,8 @@ interface RecoverableTurnInput {
     clientContext?: unknown;
 }
 export interface VersionedDeepAgentQueueSnapshot {
+    active?: unknown;
+    pending?: unknown[];
     version?: string;
 }
 export interface DeepAgentQueueSnapshotRun {
@@ -105,7 +107,7 @@ export declare function recoverableDeepAgentTurnSnapshot(turn: RecoverableTurnIn
  * @param incoming - 新到达快照。
  * @returns 版本不倒退的快照。
  */
-export declare function mergeDeepAgentQueueSnapshot<T extends VersionedDeepAgentQueueSnapshot & Record<string, unknown>>(current: T | null, incoming: T): T & {
+export declare function mergeDeepAgentQueueSnapshot<T extends VersionedDeepAgentQueueSnapshot>(current: T | null, incoming: T): T & {
     version: string;
 };
 /**

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

@@ -4,6 +4,7 @@
  * @created 2026-05-25
  */
 import type { FdeWorkbenchAssetPackage } from './fdeWorkbenchAssetPackage';
+import { type WorkbenchJsonRequestTransport } from './workbenchRequestTransport';
 export declare const FDE_WORKBENCH_CONTEXT_TYPE = "bt-workbench:fde-context";
 export interface FdeWorkbenchContext {
     resourceId: string;
@@ -65,14 +66,14 @@ export declare function makeFdeConfigHeaders(context: FdeWorkbenchContext): Reco
  * @param context - FDE 上下文
  * @returns 当前配置记录
  */
-export declare function getFdeWorkbenchConfig(context: FdeWorkbenchContext): Promise<FdeWorkbenchConfigRecord | null>;
+export declare function getFdeWorkbenchConfig(context: FdeWorkbenchContext, transport?: WorkbenchJsonRequestTransport): Promise<FdeWorkbenchConfigRecord | null>;
 /**
  * 保存当前预置模板草稿。
  * @param context - FDE 上下文
  * @param assetPackage - 草稿包对象
  * @returns 接口保存结果
  */
-export declare function saveFdeWorkbenchConfig(context: FdeWorkbenchContext, assetPackage: FdeWorkbenchAssetPackage): Promise<unknown>;
+export declare function saveFdeWorkbenchConfig(context: FdeWorkbenchContext, assetPackage: FdeWorkbenchAssetPackage, transport?: WorkbenchJsonRequestTransport): Promise<unknown>;
 /**
  * 保存当前草稿为新版本。
  * @param context - FDE 上下文
@@ -80,17 +81,17 @@ export declare function saveFdeWorkbenchConfig(context: FdeWorkbenchContext, ass
  * @param assetPackage - 草稿包对象
  * @returns 接口保存结果
  */
-export declare function saveFdeWorkbenchConfigVersion(context: FdeWorkbenchContext, versionName: string, assetPackage: FdeWorkbenchAssetPackage): Promise<unknown>;
+export declare function saveFdeWorkbenchConfigVersion(context: FdeWorkbenchContext, versionName: string, assetPackage: FdeWorkbenchAssetPackage, transport?: WorkbenchJsonRequestTransport): Promise<unknown>;
 /**
  * 查询预置模板版本列表。
  * @param context - FDE 上下文
  * @returns 版本列表
  */
-export declare function listFdeWorkbenchConfigVersions(context: FdeWorkbenchContext): Promise<FdeWorkbenchVersionRecord[]>;
+export declare function listFdeWorkbenchConfigVersions(context: FdeWorkbenchContext, transport?: WorkbenchJsonRequestTransport): Promise<FdeWorkbenchVersionRecord[]>;
 /**
  * 恢复指定预置模板版本。
  * @param context - FDE 上下文
  * @param versionNo - 版本号
  * @returns 接口恢复结果
  */
-export declare function restoreFdeWorkbenchConfigVersion(context: FdeWorkbenchContext, versionNo: number | string): Promise<FdeWorkbenchRestoreResult>;
+export declare function restoreFdeWorkbenchConfigVersion(context: FdeWorkbenchContext, versionNo: number | string, transport?: WorkbenchJsonRequestTransport): Promise<FdeWorkbenchRestoreResult>;

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

@@ -28,6 +28,11 @@ export declare function resolveRuntimeTenantId(context: RuntimeIdentityContext):
  * @returns 规范化后的应用 ID。
  */
 export declare function resolveRuntimeAppId(context: RuntimeIdentityContext): string;
+/**
+ * 解析当前工作台语言，优先使用 URL 显式语言，再使用浏览器本地持久化语言。
+ * @returns 当前工作台 locale。
+ */
+export declare function resolveRuntimeLocale(): string;
 /**
  * 构建 run-agent 运行态身份请求头。
  * @param context - 当前运行态用户上下文。

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

@@ -36,7 +36,7 @@ export declare function runtimeCapabilityPrimitiveIds(capability: RuntimeCapabil
     icon: string;
     data: import("@fses/workbench-card").RuntimeCapabilityDataSource;
     actions: import("@fses/workbench-card").RuntimeCapabilityActionType[];
-    triggers: ("onSelectResult" | "onSubmit" | "onClick" | "onChange")[];
+    triggers: ("onSubmit" | "onSelectResult" | "onClick" | "onChange")[];
     routeTargets: string[];
 };
 export declare function missingRuntimePrimitivesForCapability(capability: RuntimeCapabilityMount): string[];

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

@@ -65,7 +65,24 @@ export declare function createTurn(userPrompt: string): ConversationTurn;
  * @param conversationId - DeepAgent thread id。
  * @returns 可直接写入运行态 store 的历史 turns。
  */
-export declare function turnsFromDeepAgentTranscriptMessages(response: unknown, conversationId: string): ConversationTurn[];
+export declare function turnsFromDeepAgentTranscriptMessages(response: unknown, conversationId: string): RestoredConversationTurn[];
+/**
+ * DeepAgent transcript 中可恢复到聊天用户消息的附件元数据。
+ */
+export interface RestoredConversationUserAttachment {
+    type: 'file' | 'image';
+    name: string;
+    mimeType: string;
+    fileId?: string;
+    downloadUrl?: string;
+    url?: string;
+}
+/**
+ * 携带 transcript 用户附件的工作台历史轮次。
+ */
+export type RestoredConversationTurn = ConversationTurn & {
+    userAttachments?: RestoredConversationUserAttachment[];
+};
 export declare function createConversationId(): string;
 export declare function compactConversationTitle(value: string): string;
 export declare function buildConversationTitle(planResult: PlanResponse, fallback: string): string;
@@ -245,8 +262,8 @@ export declare function applyNeedsConfirmationEvent(turn: ConversationTurn, even
     };
 };
 export declare function applyStatusPulseEvent(turn: ConversationTurn, event: StatusPulseEvent): {
-    worklogStageText: WorklogStageText;
-    worklogStageDetail: WorklogStageText;
+    worklogStageText: string;
+    worklogStageDetail: string;
     worklogStageVisible: boolean;
     updatedAt: string;
     id: string;
@@ -294,8 +311,8 @@ export declare function applyStatusPulseEvent(turn: ConversationTurn, event: Sta
 export declare function applyActionStreamEvent(turn: ConversationTurn, event: ActionStreamEvent): {
     streamActions: StreamActionItem[];
     returnItems: ConversationReturnItem[];
-    worklogStageText: WorklogStageText;
-    worklogStageDetail: WorklogStageText;
+    worklogStageText: string;
+    worklogStageDetail: string;
     worklogStageVisible: boolean;
     updatedAt: string;
     id: string;