@fses/workbench-app 0.1.0

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

@@ -0,0 +1,106 @@
+/**
+ * @fileoverview 工作台 Image Compose 来源识别与判断 - 纯函数模块
+ * 从 WorkbenchCanvas.vue 提取的图片截图重建（Image Compose）相关的纯函数。
+ * 仅包含不依赖组件 reactive 状态的函数。
+ * @author seadon
+ * @created 2026-05-31
+ */
+import type { CustomCanvasNestedBlock, MaterializedBlock } from '@fses/workbench-app/types';
+/**
+ * 将数值限制在指定范围内。
+ * @param value - 待限制的值。
+ * @param min - 最小值。
+ * @param max - 最大值。
+ * @returns 落在范围内的数值。
+ */
+export declare function clampCanvasNumber(value: number, min: number, max: number): number;
+/**
+ * 读取图生卡片的原始截图识别框。
+ * @param block - 画布卡片。
+ * @returns 识别框坐标和宽高，不完整时返回 null。
+ */
+export declare function imageComposeRecognitionBox(block: MaterializedBlock): {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+} | null;
+/**
+ * Resolves the source screenshot frame covered by image-composed canvas cards.
+ * @param blocks - Current image-composed canvas cards.
+ * @returns Source screenshot frame, or null when recognition boxes are unavailable.
+ */
+export declare function resolveImageComposeSourceFrame(blocks: MaterializedBlock[]): {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+    width: number;
+    height: number;
+} | null;
+export interface ImageComposeSourceDimensions {
+    width?: number;
+    height?: number;
+}
+/**
+ * Expands a bbox-derived source frame with known uploaded image dimensions.
+ * @param frame - Frame inferred from model-recognized card boxes.
+ * @param dimensions - Original or optimized uploaded image dimensions.
+ * @returns Source frame that preserves full screenshot aspect when dimensions are known.
+ */
+export declare function expandImageComposeSourceFrameWithDimensions(frame: {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+    width: number;
+    height: number;
+} | null, dimensions: ImageComposeSourceDimensions | null | undefined): {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+    width: number;
+    height: number;
+} | null;
+/**
+ * 根据截图识别框估算源图内容区域的横纵比例。
+ * @param blocks - 当前图生画布卡片。
+ * @returns 源内容高度/宽度比例，不足以估算时返回 undefined。
+ */
+export declare function imageComposeSourceContentAspectRatio(blocks: MaterializedBlock[]): number | undefined;
+/**
+ * 根据图生卡片来源比例计算画布行高比例。
+ * @param blocks - 当前显示卡片。
+ * @param displayRows - 图生布局归一化后的总行数。
+ * @returns 行高相对列宽的比例。
+ */
+/**
+ * Calculates the source-proportional row height from an explicit source frame.
+ * @param frame - Full uploaded-image frame or bbox-derived source frame.
+ * @param displayRows - Normalized display row count.
+ * @returns Row-height ratio relative to one logical column width.
+ */
+export declare function imageComposeSourceProportionRowHeightRatioFromFrame(frame: {
+    width: number;
+    height: number;
+} | null | undefined, displayRows: number): number;
+export declare function imageComposeSourceProportionRowHeightRatio(blocks: MaterializedBlock[], displayRows: number): number;
+/**
+ * Reads text labels from customCanvas OCR elements.
+ * @param elements - Candidate element array from renderer data.
+ * @returns Joined label/value text.
+ */
+export declare function imageCustomCanvasElementText(elements: unknown): string;
+/**
+ * 获取卡片的 compose 来源标识。
+ * @param block - 物化卡片。
+ * @returns 来源标识或空字符串。
+ */
+export declare function blockComposeSource(block: MaterializedBlock): string;
+/**
+ * Checks whether a nested customCanvas block still carries image-compose origin metadata.
+ * @param nestedBlock - Candidate nested block.
+ * @returns True for nested cards reconstructed from uploaded screenshots.
+ */
+export declare function imageComposeNestedBlock(nestedBlock: CustomCanvasNestedBlock): boolean;

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

@@ -0,0 +1,46 @@
+/**
+ * @fileoverview 工作台画布手动布局覆盖标记 - 纯函数模块
+ * 从 WorkbenchCanvas.vue 提取的布局覆盖标记读/写/检测纯函数。
+ * 仅包含不依赖 imageComposeCanvasCard / imageLayoutBasisBox 的函数。
+ * @author seadon
+ * @created 2026-05-31
+ */
+import type { MaterializedBlock } from '@fses/workbench-app/types';
+/** 布局覆盖来源标识 */
+export declare const MANUAL_LAYOUT_OVERRIDE_SOURCE = "gridstack";
+/**
+ * 检查图生卡片是否由当前 GridStack 编辑器保存（非旧版 canvas 路径）。
+ * @param block - 候选图生卡片。
+ * @returns 手动 x/y/w/h 是否应保持权威时返回 true。
+ */
+export declare function hasFreshImageManualLayoutOverride(block: MaterializedBlock): boolean;
+/**
+ * 检查图生父卡片是否拥有当前 GridStack 编辑器保存的嵌套子卡片。
+ * @param block - 候选图生父卡片。
+ * @returns 嵌套子卡片的 x/y/w/h 是否应保持权威时返回 true。
+ */
+export declare function blockHasFreshGridstackNestedImageChildren(block: MaterializedBlock): boolean;
+/**
+ * 检查旧版保存的图生容器是否仍持有 CIO 首行 KPI 预览。
+ * @param block - 候选图生画布卡片。
+ * @returns 即使旧版手动标记存在，显示恢复也必须运行时返回 true。
+ */
+export declare function imageBlockContainsStaleCioTopKpiNestedPreview(block: MaterializedBlock): boolean;
+/**
+ * 将卡片布局标记为画布编辑器显式保存。
+ * @param block - 配置模式中正在保存的卡片。
+ * @returns 附加了手动布局元数据的卡片。
+ */
+export declare function markManualLayoutOverride(block: MaterializedBlock): MaterializedBlock;
+/**
+ * 标记图生卡片在配置模式中真正编辑过的布局。
+ * @param block - 正在保存的图生卡片。
+ * @returns 附加了图生专用手动布局元数据的卡片。
+ */
+export declare function markImageManualLayoutOverride(block: MaterializedBlock): MaterializedBlock;
+/**
+ * 移除图生卡片上的显式手动覆盖元数据，保留保存的画布卡片身份。
+ * @param block - 配置模式中正在保存的图生卡片。
+ * @returns 保持画布卡片身份但不禁止来源图片渲染的卡片。
+ */
+export declare function markSourceImageSavedLayout(block: MaterializedBlock): MaterializedBlock;

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

@@ -0,0 +1,45 @@
+/**
+ * @fileoverview 工作台卡片配置画像 - 将注册卡片映射为可直接插入、可配置或外部依赖状态。
+ * @author seadon
+ * @created 2026-06-18
+ */
+import type { CardRegistryEntry } from '@fses/workbench-app/types';
+export type WorkbenchCardConfigMode = 'directInsert' | 'queryGenerated' | 'configurable' | 'externalDependency' | 'customComponent';
+export interface WorkbenchCardConfigField {
+    key: string;
+    label: string;
+    type: 'text' | 'url' | 'select';
+    required?: boolean;
+    defaultValue?: string;
+    options?: Array<{
+        label: string;
+        value: string;
+    }>;
+    placeholder?: string;
+}
+export interface WorkbenchCardConfigProfile {
+    capabilityId: string;
+    mode: WorkbenchCardConfigMode;
+    label: string;
+    primaryAction: 'insert' | 'configureAndInsert' | 'copyPrompt' | 'viewRequirement';
+    fields: WorkbenchCardConfigField[];
+    requirementText: string;
+}
+export interface WorkbenchCardResolvedConfig {
+    capabilityId: string;
+    mode: WorkbenchCardConfigMode;
+    values: Record<string, string>;
+}
+export type WorkbenchCardConfigProfileEntry = Pick<CardRegistryEntry, 'capabilityId' | 'category' | 'dataShape' | 'title'>;
+/**
+ * 解析卡片配置画像。
+ * @param entry - 卡片注册表条目。
+ * @returns 可供卡片目录和配置弹窗消费的配置画像。
+ */
+export declare function resolveWorkbenchCardConfigProfile(entry: WorkbenchCardConfigProfileEntry): WorkbenchCardConfigProfile;
+/**
+ * 根据配置画像生成默认表单值。
+ * @param profile - 卡片配置画像。
+ * @returns 默认表单值。
+ */
+export declare function defaultWorkbenchCardConfigValues(profile: WorkbenchCardConfigProfile): Record<string, string>;

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

@@ -0,0 +1,64 @@
+/**
+ * @fileoverview 工作台卡片推荐绑定标准化 - 安全恢复历史绑定并比较问数结果身份
+ * @author seadon
+ * @created 2026-08-03
+ */
+export type RecommendationRecord = Record<string, unknown>;
+export interface RecommendationDataBindingCandidate {
+    path: string;
+    value: unknown;
+}
+/**
+ * 安全恢复 transcript 已公开保存的 dataBinding。
+ * @param value - 对象或 JSON 对象字符串。
+ * @returns 非空绑定对象；非法值返回 undefined。
+ */
+export declare function normalizeRecommendationDataBinding(value: unknown): RecommendationRecord | undefined;
+/**
+ * 从设计允许的五个位置读取原始绑定候选。
+ * @param value - 推荐项记录。
+ * @returns 带稳定路径的绑定候选，未出现的路径不返回。
+ */
+export declare function recommendationDataBindingCandidatesFromItem(value: unknown): RecommendationDataBindingCandidate[];
+/**
+ * 从设计允许的位置按显式优先级读取首个可解析绑定。
+ * @param value - 推荐项记录。
+ * @returns 首个有效对象绑定或 undefined。
+ */
+export declare function recommendationDataBindingFromItem(value: unknown): RecommendationRecord | undefined;
+/**
+ * 递归收集无法解析为普通对象的字符串绑定路径。
+ * @param value - 推荐项或 queryResult carrier。
+ * @param prefix - 递归路径前缀。
+ * @returns 仅包含字段路径的脱敏失败列表。
+ */
+export declare function invalidSerializedRecommendationDataBindingPaths(value: unknown, prefix?: string): string[];
+/**
+ * 按 resultId/sourceTurnId 规则归一化问数结果身份。
+ * @param value - 问数结果或证据记录。
+ * @returns 可比较的结果和轮次标识。
+ */
+export declare function recommendationResultIdentity(value: unknown): {
+    resultId?: string;
+    sourceTurnId?: string;
+};
+/**
+ * 判断两个问数结果是否具有同一结构化身份。
+ * @param left - 左侧结果。
+ * @param right - 右侧结果。
+ * @returns resultId 或 sourceTurnId 可比较且相同时返回 true。
+ */
+export declare function sameRecommendationResultIdentity(left: unknown, right: unknown): boolean;
+/**
+ * 把 queryResult 自身及 data 下的字符串绑定恢复为对象。
+ * @param value - queryResult 候选。
+ * @returns 标准化后的 queryResult 或 undefined。
+ */
+export declare function normalizedRecommendationQueryResult(value: unknown): RecommendationRecord | undefined;
+/**
+ * 合并同一身份的 item/shared queryResult，并保持 item 字段优先。
+ * @param itemResult - 推荐项自身结果。
+ * @param sharedResult - 推荐事件共享结果。
+ * @returns 合并结果；身份不兼容时只返回 item 结果。
+ */
+export declare function mergeRecommendationQueryResultBinding(itemResult: unknown, sharedResult: unknown): RecommendationRecord | undefined;

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

@@ -0,0 +1,24 @@
+/**
+ * @fileoverview 工作台推荐卡片空态兜底 - 将真实问数结果转换为默认清单列表候选。
+ * @author seadon
+ * @created 2026-07-03
+ */
+import type { CardRecommendationItem } from '@fses/workbench-app/types';
+interface BuildFallbackRecommendationsInput {
+    queryResult?: Record<string, unknown>;
+    source?: unknown;
+    sourceTurnId?: string;
+}
+/**
+ * 判断 queryResult 是否足以生成默认清单列表候选。
+ * @param queryResult - 问数结果。
+ * @returns 存在可选字段时返回 true。
+ */
+export declare function canBuildCardRecommendationFallbackRecommendations(queryResult: unknown): queryResult is Record<string, unknown>;
+/**
+ * 基于真实问数结果生成默认清单列表推荐项。
+ * @param input - 问数结果和来源信息。
+ * @returns 可由现有推荐 UI 渲染的默认清单列表推荐项。
+ */
+export declare function buildCardRecommendationFallbackRecommendations(input: BuildFallbackRecommendationsInput): CardRecommendationItem[];
+export {};

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

@@ -0,0 +1,24 @@
+/**
+ * @fileoverview 工作台推荐卡片视图归并 - 将同源候选收敛为默认表格视图的可切换备选项。
+ * @author seadon
+ * @created 2026-07-06
+ */
+export interface WorkbenchCardRecommendationViewItem {
+    capabilityId?: unknown;
+    cardConfig?: unknown;
+    dataBinding?: unknown;
+    dataShape?: unknown;
+    protocolKind?: unknown;
+    queryResult?: unknown;
+    selectedConfig?: unknown;
+    title?: unknown;
+    viewAlternatives?: unknown;
+    visualIntent?: unknown;
+    blockPlan?: unknown;
+}
+/**
+ * 将同一批推荐中的视图候选归并到默认表格项的 viewAlternatives。
+ * @param recommendations - 后端或工具返回的推荐项。
+ * @returns 适合新推荐卡片样式展示的推荐项。
+ */
+export declare function groupCardRecommendationViews<T extends WorkbenchCardRecommendationViewItem>(recommendations: T[]): T[];

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

@@ -0,0 +1,33 @@
+/**
+ * @fileoverview 工作台卡片可用性画像 - 按注册表能力说明卡片验收所需的数据与限制。
+ * @author seadon
+ * @created 2026-06-12
+ */
+import type { CardRegistryEntry } from '@fses/workbench-app/types';
+export type WorkbenchCardUsageMode = 'realQuery' | 'runtimeMetric' | 'template' | 'externalDependency' | 'customComponent';
+export type WorkbenchCardAcceptanceTier = 'real_data' | 'metric_data' | 'template' | 'limited' | 'custom_component';
+export interface WorkbenchCardUsabilityProfile {
+    capabilityId: string;
+    usageMode: WorkbenchCardUsageMode;
+    usageLabel: string;
+    recommendedPrompt: string;
+    dataRequirement: string;
+    limitationReason?: string;
+    acceptanceTier: WorkbenchCardAcceptanceTier;
+}
+export type WorkbenchCardUsabilityProfileEntry = Pick<CardRegistryEntry, 'capabilityId' | 'category' | 'dataShape' | 'title'>;
+/**
+ * 解析单张系统卡片的可用性画像。
+ * @param entry - 系统卡片注册表条目。
+ * @returns 可用于验收展示与覆盖检查的卡片画像。
+ */
+export declare function resolveCardUsabilityProfile(entry: WorkbenchCardUsabilityProfileEntry): WorkbenchCardUsabilityProfile;
+/**
+ * 汇总卡片可用性画像覆盖数量。
+ * @param entries - 系统卡片注册表条目列表。
+ * @returns 总数与各使用模式数量。
+ */
+export declare function cardUsabilityProfileSummary(entries: CardRegistryEntry[]): {
+    total: number;
+    byUsageMode: Record<WorkbenchCardUsageMode, number>;
+};

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

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview 工作台聊天历史序列化 - 保留续接任务所需的安全结构化上下文。
+ * @author seadon
+ * @created 2026-06-10
+ */
+import type { ChatMessage, FsesAiChatTransportMessageInput } from '@fses/workbench-app/types';
+export interface WorkbenchChatHistoryMessage {
+    role: 'assistant' | 'user';
+    content: string;
+    queryResultTable?: FsesAiChatTransportMessageInput['queryResultTable'];
+    queryResultTables?: FsesAiChatTransportMessageInput['queryResultTables'];
+    taskStateDraft?: FsesAiChatTransportMessageInput['taskStateDraft'];
+}
+/**
+ * 将 ai-chat 历史消息序列化为工作台聊天流请求体。
+ * @param messages - ai-chat 当前会话消息。
+ * @returns 仅包含后端续接所需字段的用户/助手历史消息。
+ */
+export declare function serializeWorkbenchChatHistoryForTransport(messages: ChatMessage[]): WorkbenchChatHistoryMessage[];

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

@@ -0,0 +1,25 @@
+/**
+ * @fileoverview 工作台聊天历史回放 - 从已恢复的会话轮次提取可展示的过程与结构化产物。
+ * @author seadon
+ * @created 2026-08-03
+ */
+import type { FsesAiChatTransportMessageInput } from '@fses/workbench-app/types';
+import type { ConversationTurn } from '@fses/workbench-app/types';
+/**
+ * Builds the ordered replacement sequence for a restored turn with multiple independent result sections.
+ * @param turn - Restored workbench turn.
+ * @returns Interleaved answer sections and recommendations, or an empty array when the original layout should remain.
+ */
+export declare function workbenchChatInterleavedTurnMessages(turn: ConversationTurn, deferCardRecommendationRender?: boolean): FsesAiChatTransportMessageInput[];
+/**
+ * Builds a lazily rendered interleaved sequence for restored history.
+ * @param turn - Restored workbench turn.
+ * @returns Interleaved history messages with deferred recommendation rendering.
+ */
+export declare function restoredWorkbenchChatInterleavedTurnMessages(turn: ConversationTurn): FsesAiChatTransportMessageInput[];
+/**
+ * 从历史会话轮次恢复聊天区可展示的过程与结构化产物。
+ * @param turns - 已恢复的工作台会话轮次。
+ * @returns 仅包含思考过程、结果表和推荐卡片的聊天消息。
+ */
+export declare function restoredWorkbenchChatArtifactsFromTurns(turns: ConversationTurn[]): FsesAiChatTransportMessageInput[];

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

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview 兼容转发 - 工作台聊天消息排序逻辑已迁移到 @fses/workbench-app。
+ * @author seadon
+ * @created 2026-08-12
+ */
+export * from '../../../runtime/conversation/workbenchChatMessageOrdering';

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

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview Workbench chat pending turn matcher - binds local chat transports to runtime turns.
+ * @author seadon
+ * @created 2026-05-31
+ */
+import type { ConversationTurn } from '@fses/workbench-app/types';
+export declare const WORKBENCH_CHAT_IDLE_TIMEOUT_MS = 120000;
+export interface WorkbenchChatPendingTurnMatcherInput {
+    conversationId?: string;
+    input: string;
+    knownTurnIds?: Set<string>;
+    startedAt: number;
+    turnId?: string;
+}
+/**
+ * 判断工作台聊天 transport 对应的运行态 turn。
+ * @param turns - 当前工作台运行态 turns。
+ * @param pending - 本地等待回复的 transport 关键信息。
+ * @returns 匹配到的 turn；没有可靠候选时返回 null。
+ */
+export declare function findWorkbenchChatPendingTurn(turns: ConversationTurn[], pending: WorkbenchChatPendingTurnMatcherInput): ConversationTurn | null;

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

@@ -0,0 +1,55 @@
+/**
+ * @fileoverview 工作台聊天回复桥接 - 将运行时 turn 状态转换为右侧聊天消息。
+ * @author seadon
+ * @created 2026-05-08
+ */
+import type { FsesAiChatTransportMessageInput } from "@fses/workbench-app/types";
+import type { ConversationTurn } from '@fses/workbench-app/types';
+/**
+ * 判断运行时 turn 是否已经结束，可用于解除聊天 transport 的 pending 状态。
+ * @param turn - 工作台运行时 turn。
+ * @returns 已结束返回 true，仍在流式处理返回 false。
+ */
+export declare function isWorkbenchTurnFinished(turn: ConversationTurn): boolean;
+/**
+ * Collects the same structured field labels used by rendered query-result tables.
+ * @param queryResult - Query result payload.
+ * @returns Display labels keyed by runtime field.
+ */
+export declare function queryResultDisplayFieldLabels(queryResult: Record<string, unknown>): Record<string, string>;
+/**
+ * 列出不应独立渲染、需要从聊天区移除的 queryResult 表消息 ID。
+ * @param turn - 工作台对话轮次。
+ * @returns 可清理的表格消息 ID 列表。
+ */
+export declare function workbenchSuppressedQueryResultTableMessageIds(turn: ConversationTurn): string[];
+/**
+ * 获取流式结论消息的 ID。
+ * @param turn - 工作台对话轮次。
+ * @returns 流式结论消息 ID。
+ */
+export declare function workbenchConclusionMessageId(turn: ConversationTurn): string;
+/**
+ * 判断 turn 是否已有可输出的流式结论文本。
+ * @param turn - 工作台对话轮次。
+ * @returns 有流式结论时返回 true。
+ */
+export declare function hasStreamedConclusion(turn: ConversationTurn): boolean;
+export declare const WORKBENCH_CARD_MUTATION_TASK_ID_PREFIX = "workbench-card-mutation:";
+/**
+ * Interleaves independent recommendation panels after their matching Markdown table sections.
+ * Single-result recommendations preserve the existing answer-then-recommendation layout.
+ * @param messages - Final chat messages for one workbench turn.
+ * @param turnId - Current frontend turn id.
+ * @param requireStructuredSubqueryIdentity - Whether every recommendation must carry a structured subquery source id.
+ * @returns Messages with multi-query recommendation panels placed beside their source sections.
+ */
+export declare function interleaveIndependentRecommendationsAfterMarkdownSections(messages: FsesAiChatTransportMessageInput[], turnId: string, requireStructuredSubqueryIdentity?: boolean): FsesAiChatTransportMessageInput[];
+export declare function buildWorkbenchChatStreamMessages(turn: ConversationTurn): FsesAiChatTransportMessageInput[];
+/**
+ * 将工作台运行结果转换成聊天区可展示的消息。
+ * 已流式输出结论时跳过，避免重复输出。
+ * @param turn - 已结束或正在运行的工作台 turn。
+ * @returns 可追加到 FsesAiChat 的消息；已流式输出或无有效内容时返回 null。
+ */
+export declare function buildWorkbenchChatReplyMessage(turn: ConversationTurn): FsesAiChatTransportMessageInput | null;

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

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview 兼容转发 - 工作台聊天状态完成判断已迁移到 @fses/workbench-app。
+ * @author seadon
+ * @created 2026-08-12
+ */
+export * from '../../../runtime/conversation/workbenchChatStatusCompletion';

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

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview 兼容转发 - 工作台聊天轮次签名已迁移到 @fses/workbench-app。
+ * @author seadon
+ * @created 2026-08-12
+ */
+export * from '../../../runtime/conversation/workbenchChatTurnSignature';

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

@@ -0,0 +1,18 @@
+/**
+ * @fileoverview 工作台配置草稿重置策略 - 判断运行时快照变化是否允许覆盖本地编辑草稿。
+ * @author seadon
+ * @created 2026-07-06
+ */
+interface ConfigDraftReseedInput {
+    draftDirty: boolean;
+    savingConfig: boolean;
+    draftBlockIds: string[];
+    snapshotBlockIds: string[];
+}
+/**
+ * Checks whether a config-mode draft may be reseeded from a changed runtime snapshot.
+ * @param input - Draft state and runtime snapshot card id lists.
+ * @returns True when it is safe to rebuild the draft from the runtime snapshot.
+ */
+export declare function shouldReseedConfigDraftForSnapshotChange(input: ConfigDraftReseedInput): boolean;
+export {};

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

@@ -0,0 +1,16 @@
+/**
+ * @fileoverview 工作台自定义卡片目录 - 维护 npm 自定义组件卡片在设置面板中的展示与插入元数据。
+ * @author seadon
+ * @created 2026-06-01
+ */
+import type { WorkbenchCustomCardCatalogEntry } from '@fses/workbench-app/types';
+export declare const WORKBENCH_TEMPLATE_WEATHER_PREVIEW_URL: string;
+export declare const WORKBENCH_TEMPLATE_WEATHER_COMPONENT_REF = "@byteluck-fe/workbench-template.WeatherCard";
+export declare const WORKBENCH_TEMPLATE_WEATHER_CAPABILITY_ID = "card.fde.templateWeather";
+export declare const WORKBENCH_CUSTOM_CARD_CATALOG: WorkbenchCustomCardCatalogEntry[];
+/**
+ * 读取设置面板可展示的自定义卡片目录。
+ * @returns 已启用的 npm 自定义卡片条目。
+ */
+export declare function workbenchCustomCardEntries(): WorkbenchCustomCardCatalogEntry[];
+export type { WorkbenchCustomCardCatalogEntry } from '@fses/workbench-app/types';

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

@@ -0,0 +1,4 @@
+import type { WorkbenchRendererCustomComponentEntry, WorkbenchRendererCustomComponentRegistry } from '@fses/workbench-app/types';
+import '@byteluck-fe/workbench-template/style.css';
+export declare const customComponentRegistry: WorkbenchRendererCustomComponentRegistry;
+export type { WorkbenchRendererCustomComponentEntry };

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

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview 工作台问数徽标工具 - 统一识别普通问数状态、候选问数状态和人工补充业务口径状态
+ * @author seadon
+ * @created 2026-05-13
+ */
+import type { MaterializedBlock } from '@fses/workbench-app/types';
+export type WorkbenchDataBindingBadgeTone = 'info' | 'success' | 'error' | 'idle' | 'warning';
+export interface WorkbenchDataBindingBadge {
+    label: string;
+    tone: WorkbenchDataBindingBadgeTone;
+    retryable: boolean;
+    title?: string;
+}
+/**
+ * Chooses the badge shown beside a card title.
+ * @param block - Canvas block whose binding state should be summarized.
+ * @returns Candidate badge first, otherwise nested or normal refresh badge.
+ */
+export declare function dataBindingBadgeForBlock(block: MaterializedBlock): WorkbenchDataBindingBadge | null;

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

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview 兼容转发 - 工作台数据绑定刷新策略已迁移到 @fses/workbench-app。
+ * @author seadon
+ * @created 2026-08-12
+ */
+export * from '../../../runtime/data-binding/workbenchDataBindingRefreshPolicy';

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

@@ -0,0 +1,47 @@
+/**
+ * @fileoverview 工作台问数刷新目标解析 - 统一识别顶层卡片与嵌套预览子卡的 refreshApi
+ * @author seadon
+ * @created 2026-05-11
+ */
+import type { MaterializedBlock } from '@fses/workbench-app/types';
+export interface WorkbenchDataBindingRefreshTarget {
+    bindingId: string;
+    refreshApi: string;
+}
+/**
+ * Extracts a data-binding id from a stored refresh API path.
+ * @param refreshApi - Relative, proxied, or absolute refresh API path.
+ * @returns Decoded data-binding id when the path follows the workbench contract.
+ */
+export declare function dataBindingIdFromRefreshApi(refreshApi: string): string | undefined;
+/**
+ * Finds refresh metadata on renderer data or a nested child preview object.
+ * @param data - Renderer data or nested block object.
+ * @returns Binding id and refresh API when both can be resolved.
+ */
+export declare function dataBindingRefreshTargetFromData(data: unknown): WorkbenchDataBindingRefreshTarget | null;
+/**
+ * Finds the first refreshable nested child preview on a customCanvas block.
+ * @param data - Card renderer data that may contain nestedBlocks.
+ * @returns First nested child refresh target when available.
+ */
+export declare function nestedDataBindingRefreshTarget(data: unknown): WorkbenchDataBindingRefreshTarget | null;
+/**
+ * Finds a nested child refresh target that represents an actionable lifecycle state.
+ * @param data - Card renderer data that may contain nestedBlocks.
+ * @returns First failed/running nested child refresh target when available.
+ */
+export declare function actionableNestedDataBindingRefreshTarget(data: unknown): WorkbenchDataBindingRefreshTarget | null;
+/**
+ * Finds a normal data-binding refresh target stored on a materialized block.
+ * @param block - Canvas block whose renderer data may carry refresh metadata.
+ * @param preferredBindingId - Optional exact binding id selected from a checklist row.
+ * @returns Top-level refresh target first, then nested child target.
+ */
+export declare function dataBindingRefreshTargetFromBlock(block: Pick<MaterializedBlock, 'data'>, preferredBindingId?: string): WorkbenchDataBindingRefreshTarget | null;
+/**
+ * Checks whether a materialized block exposes any refresh target.
+ * @param block - Canvas block to inspect.
+ * @returns True when a top-level or nested refresh target exists.
+ */
+export declare function hasDataBindingRefreshTarget(block: Pick<MaterializedBlock, 'data'>): boolean;

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

@@ -0,0 +1,41 @@
+/**
+ * @fileoverview 工作台删除布局压缩工具 - 删除卡片后移除画布上方大空白
+ * @author seadon
+ * @created 2026-06-21
+ */
+import type { MaterializedBlock, WorkbenchLayoutV4, WorkbenchSnapshot } from '@fses/workbench-app/types';
+/**
+ * 删除卡片后按现有视觉顺序重新紧凑排列剩余卡片。
+ * @param blocks - 删除目标卡片后的剩余卡片列表。
+ * @returns 仅调整坐标后的卡片列表，卡片宽高和业务数据保持不变。
+ */
+export declare function compactWorkbenchBlocksAfterDelete<T extends Pick<MaterializedBlock, 'id' | 'layout'>>(blocks: T[]): T[];
+/**
+ * 删除卡片后同步 V4 布局树到已压缩的卡片坐标。
+ * @param layoutTree - 当前 V4 布局树。
+ * @param blocks - 已完成删除压缩的剩余卡片。
+ * @param removedBlockId - 被删除的卡片 ID。
+ * @returns 删除目标节点并同步剩余顶层节点坐标后的布局树。
+ */
+export declare function compactWorkbenchLayoutTreeAfterDelete(layoutTree: WorkbenchLayoutV4, blocks: ReadonlyArray<Pick<MaterializedBlock, 'id' | 'layout'>>, removedBlockId: string): WorkbenchLayoutV4;
+/**
+ * 同步删除后的 GridStack V4 布局树，避免旧 visualConfig 覆盖已压缩的卡片坐标。
+ * @param visualConfig - 当前快照的视觉配置。
+ * @param blocks - 已完成删除压缩的剩余卡片。
+ * @param removedBlockId - 被删除的卡片 ID。
+ * @returns 已同步顶层节点坐标和删除节点的视觉配置。
+ */
+export declare function compactWorkbenchVisualConfigAfterDelete(visualConfig: WorkbenchSnapshot['visualConfig'] | undefined, blocks: ReadonlyArray<Pick<MaterializedBlock, 'id' | 'layout'>>, removedBlockId: string): WorkbenchSnapshot['visualConfig'] | undefined;
+/**
+ * 删除卡片后生成可持久化的紧凑工作台快照。
+ * @param snapshot - 删除前或后端删除后得到的快照。
+ * @param removedBlockId - 被删除的卡片 ID。
+ * @returns 已移除目标卡片、压缩剩余卡片并同步视觉布局树的快照。
+ */
+export declare function compactWorkbenchSnapshotAfterDelete(snapshot: WorkbenchSnapshot, removedBlockId: string): WorkbenchSnapshot;
+/**
+ * 修复已删除卡片残留在 GridStack 布局树中的历史快照。
+ * @param snapshot - 从后端、socket 或本地缓存进入画布的快照。
+ * @returns 若发现布局树包含已不存在的顶层卡片，则返回已清理并重新压缩的快照。
+ */
+export declare function compactWorkbenchSnapshotIfDeletedLayoutTreeStale(snapshot: WorkbenchSnapshot): WorkbenchSnapshot;