@fses/workbench-app 0.1.0

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

@@ -0,0 +1,21 @@
+import type { AssistantPersonaKey, AssistantPersonaPayload } from '@fses/workbench-app/types';
+export declare const DEFAULT_ASSISTANT_PERSONA: AssistantPersonaKey;
+export declare const ASSISTANT_PERSONA_PROFILES: readonly [{
+    readonly key: "warm";
+    readonly label: "热情";
+    readonly shortDescription: "主动联想，温暖充足";
+    readonly prompt: string;
+}, {
+    readonly key: "professional";
+    readonly label: "专业";
+    readonly shortDescription: "严谨克制，有理有据";
+    readonly prompt: string;
+}, {
+    readonly key: "reserved";
+    readonly label: "内敛";
+    readonly shortDescription: "安静克制，简洁稳妥";
+    readonly prompt: string;
+}];
+export declare function normalizeAssistantPersonaKey(value: unknown): AssistantPersonaKey;
+export declare function getAssistantPersonaProfile(value: unknown): AssistantPersonaPayload;
+export declare function buildAssistantPersonaPayload(value: unknown): AssistantPersonaPayload;

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

@@ -0,0 +1,25 @@
+/**
+ * @fileoverview 业务分组客户端 - 获取 SP 业务分组和分组资源并归一化为聊天上下文。
+ * @author seadon
+ * @created 2026-06-07
+ */
+import type { BusinessGroupOption, BusinessGroupResources } from '@fses/workbench-app/types';
+interface BusinessGroupClientContext {
+    userId?: string;
+}
+interface BusinessGroupResourcesInput extends BusinessGroupClientContext {
+    businessGroupCode: string;
+}
+/**
+ * 获取 SP 业务分组列表。
+ * @param context - 当前运行态用户上下文。
+ * @returns 归一化后的业务分组选项。
+ */
+export declare function fetchBusinessGroups(context?: BusinessGroupClientContext): Promise<BusinessGroupOption[]>;
+/**
+ * 获取 SP 业务分组资源。
+ * @param input - 业务分组编码与当前运行态用户上下文。
+ * @returns 归一化后的模型和指标资源。
+ */
+export declare function fetchBusinessGroupResources(input: BusinessGroupResourcesInput): Promise<BusinessGroupResources>;
+export {};

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

@@ -0,0 +1,38 @@
+/**
+ * @fileoverview Canonical layout context helpers - builds stable persisted-layout summaries for card operations.
+ * @author seadon
+ * @created 2026-07-11
+ */
+import type { BlockLayout, WorkbenchSnapshot } from '@fses/workbench-app/types';
+export interface CanonicalLayoutContext extends Record<string, unknown> {
+    baseVersion: number;
+    layoutVersion: number;
+    layoutSource: 'gridstack_layout_tree' | 'block_layout';
+    layoutFingerprint: string;
+    layoutTree?: Record<string, unknown>;
+    blockLayouts?: Array<{
+        blockId: string;
+        layout: Pick<BlockLayout, 'x' | 'y' | 'w' | 'h'>;
+    }>;
+    updatedAt?: string;
+}
+interface FingerprintNode {
+    id: string;
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+/**
+ * Builds a canonical layout summary from the persisted workbench snapshot.
+ * @param snapshot - Current persisted workbench snapshot.
+ * @returns Canonical layout context, or undefined when no snapshot is available.
+ */
+export declare function buildCanonicalLayoutContext(snapshot: WorkbenchSnapshot | null | undefined): CanonicalLayoutContext | undefined;
+/**
+ * Generates a stable fingerprint for layout nodes independent of input ordering.
+ * @param nodes - Layout nodes to fingerprint.
+ * @returns Stable short layout hash.
+ */
+export declare function fingerprintLayoutNodes(nodes: FingerprintNode[]): string;
+export {};

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

@@ -0,0 +1,20 @@
+export interface DemoCardContract {
+    capabilityId: string;
+    contractVersion: string;
+    dataMode: 'manualDemo';
+    title?: string;
+    category?: string;
+    rendererKey?: string;
+    dataShape?: string;
+    outputSchema: Record<string, unknown>;
+    defaultData: Record<string, unknown>;
+}
+export declare const DEMO_BAR_CHART_CAPABILITY_ID = "card.chart.bar";
+export declare const DEMO_CUSTOM_ECHARTS_CAPABILITY_ID = "card.chart.customEcharts";
+export declare function supportsDemoCardContract(capabilityId: string): boolean;
+export declare function supportsNativeEchartsOption(capabilityId: string): capabilityId is "card.chart.customEcharts";
+export declare function defaultDemoCardContract(capabilityId: string): DemoCardContract | null;
+export declare function readDemoCardContract(capabilityId: string): DemoCardContract | null;
+export declare function writeDemoCardContract(contract: DemoCardContract): void;
+export declare function resetDemoCardContract(capabilityId: string): void;
+export declare function demoDefaultDataForCapability(capabilityId: string): Record<string, unknown> | null;

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

@@ -0,0 +1 @@
+export declare function displayCardSubtitle(subtitle: unknown): string;

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

@@ -0,0 +1,29 @@
+/**
+ * @fileoverview 工作台卡片尺寸配置 - 统一管理卡片尺寸预设、画布间距和持久化配置归一化
+ * @author seadon
+ * @created 2026-05-14
+ */
+import type { CardSizePreset } from '@fses/workbench-app/canvas/api/types';
+export interface WorkbenchCardPresetSize {
+    w: number;
+    h: number;
+}
+export type WorkbenchCardPresetSizeConfig = Record<CardSizePreset, WorkbenchCardPresetSize>;
+export type WorkbenchCanvasGapPreset = 'large' | 'medium' | 'small' | 'none';
+export declare const WORKBENCH_CARD_SIZE_PRESETS: Array<{
+    preset: CardSizePreset;
+    label: string;
+    description: string;
+}>;
+export declare const DEFAULT_WORKBENCH_CARD_PRESET_SIZE_CONFIG: WorkbenchCardPresetSizeConfig;
+export declare const WORKBENCH_CANVAS_GAP_PRESETS: Array<{
+    preset: WorkbenchCanvasGapPreset;
+    label: string;
+    px: number;
+}>;
+export declare const DEFAULT_WORKBENCH_CANVAS_GAP_PRESET: WorkbenchCanvasGapPreset;
+export declare const DEFAULT_WORKBENCH_CANVAS_GAP_PX = 10;
+export declare function normalizeWorkbenchCardPresetSizeConfig(value: unknown): WorkbenchCardPresetSizeConfig;
+export declare function sameWorkbenchCardPresetSizeConfig(left: WorkbenchCardPresetSizeConfig, right: WorkbenchCardPresetSizeConfig): boolean;
+export declare function normalizeWorkbenchCanvasGapPreset(value: unknown): WorkbenchCanvasGapPreset;
+export declare function canvasGapPresetToPx(preset: WorkbenchCanvasGapPreset): number;

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

@@ -0,0 +1,128 @@
+/**
+ * @fileoverview 工作台卡片外壳样式配置 - 负责本地 UI 风格与远端 visualConfig 的互转
+ * @author seadon
+ * @created 2026-05-10
+ */
+import type { WorkbenchSnapshot } from '@fses/workbench-app/types';
+export type WorkbenchCardRadius = 'square' | 'small' | 'standard' | 'large';
+export type WorkbenchCardBorder = 'none' | 'light' | 'strong';
+export type WorkbenchCardShadow = 'none' | 'soft' | 'strong';
+export type WorkbenchCardTexture = 'white' | 'muted' | 'glass' | 'texture' | 'color';
+export type WorkbenchCardMotion = 'none' | 'lift' | 'glow';
+export type WorkbenchCardDensity = 'loose' | 'standard' | 'compact';
+export interface WorkbenchCardStyleConfig {
+    radius: WorkbenchCardRadius;
+    border: WorkbenchCardBorder;
+    shadow: WorkbenchCardShadow;
+    texture: WorkbenchCardTexture;
+    textureColor: string;
+    motion: WorkbenchCardMotion;
+    density: WorkbenchCardDensity;
+}
+export type WorkbenchCardStyleGroupKey = Exclude<keyof WorkbenchCardStyleConfig, 'textureColor'>;
+export type WorkbenchCardStyleValue = WorkbenchCardStyleConfig[WorkbenchCardStyleGroupKey];
+export declare const DEFAULT_WORKBENCH_CARD_STYLE_CONFIG: WorkbenchCardStyleConfig;
+export declare const WORKBENCH_CARD_STYLE_GROUPS: readonly [{
+    readonly key: "radius";
+    readonly label: "圆角";
+    readonly options: readonly [{
+        readonly value: "square";
+        readonly label: "直角";
+    }, {
+        readonly value: "small";
+        readonly label: "小圆角";
+    }, {
+        readonly value: "standard";
+        readonly label: "标准圆角";
+    }, {
+        readonly value: "large";
+        readonly label: "大圆角";
+    }];
+}, {
+    readonly key: "border";
+    readonly label: "边框";
+    readonly options: readonly [{
+        readonly value: "none";
+        readonly label: "无边框";
+    }, {
+        readonly value: "light";
+        readonly label: "浅色细边框";
+    }, {
+        readonly value: "strong";
+        readonly label: "强边框";
+    }];
+}, {
+    readonly key: "shadow";
+    readonly label: "阴影";
+    readonly options: readonly [{
+        readonly value: "none";
+        readonly label: "无阴影";
+    }, {
+        readonly value: "soft";
+        readonly label: "弱悬浮";
+    }, {
+        readonly value: "strong";
+        readonly label: "强悬浮";
+    }];
+}, {
+    readonly key: "texture";
+    readonly label: "质感";
+    readonly options: readonly [{
+        readonly value: "white";
+        readonly label: "纯白";
+    }, {
+        readonly value: "muted";
+        readonly label: "浅灰底";
+    }, {
+        readonly value: "glass";
+        readonly label: "磨砂玻璃";
+    }, {
+        readonly value: "texture";
+        readonly label: "纹理底";
+    }];
+}, {
+    readonly key: "motion";
+    readonly label: "动效";
+    readonly options: readonly [{
+        readonly value: "none";
+        readonly label: "无动效";
+    }, {
+        readonly value: "lift";
+        readonly label: "悬浮微动";
+    }, {
+        readonly value: "glow";
+        readonly label: "渐变光效";
+    }];
+}, {
+    readonly key: "density";
+    readonly label: "密度";
+    readonly options: readonly [{
+        readonly value: "loose";
+        readonly label: "宽松版";
+    }, {
+        readonly value: "standard";
+        readonly label: "标准版";
+    }, {
+        readonly value: "compact";
+        readonly label: "高密度紧凑版";
+    }];
+}];
+export declare function normalizeWorkbenchCardStyleConfig(value: unknown): WorkbenchCardStyleConfig;
+/**
+ * 判断卡片外壳样式是否仍是系统默认值。
+ * @param value - 候选卡片样式配置。
+ * @returns 与默认配置完全一致时返回 true。
+ */
+export declare function isDefaultWorkbenchCardStyleConfig(value: unknown): boolean;
+/**
+ * Converts the UI card shell style into the canonical snapshot visual config.
+ * @param config - Card shell style selected in the workbench settings panel.
+ * @returns Snapshot visualConfig payload for layout persistence.
+ */
+export declare function cardStyleConfigToSnapshotVisualConfig(config: WorkbenchCardStyleConfig): WorkbenchSnapshot['visualConfig'];
+/**
+ * Converts a persisted snapshot visual config back into the UI card shell style.
+ * @param visualConfig - Snapshot visualConfig from the backend.
+ * @returns Normalized UI card style config.
+ */
+export declare function cardStyleConfigFromSnapshotVisualConfig(visualConfig: WorkbenchSnapshot['visualConfig'] | null | undefined): WorkbenchCardStyleConfig;

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

@@ -0,0 +1,30 @@
+/**
+ * @fileoverview 对话屏幕上下文构建工具 - 汇总画布、会话、产物索引与最近焦点信息。
+ * @author seadon
+ * @created 2026-05-21
+ */
+import type { ConversationScreenContext, ConversationTurn, RoleId, WorkbenchSnapshot } from '@fses/workbench-app/types';
+export interface SelectedNestedBlockTarget {
+    parentId: string;
+    childId: string;
+}
+type ConversationScreenContextBaseParams = {
+    currentConversationId: string;
+    activeTurnId?: string | null;
+    activeWorkItemId?: string | null;
+    turns: ConversationTurn[];
+    snapshot: WorkbenchSnapshot | null;
+    selectedBlockId?: string | null;
+    selectedNestedBlock?: SelectedNestedBlockTarget | null;
+    input: string;
+    workspaceId: string;
+    userId: string;
+    recentFocusPatch?: Partial<ConversationScreenContext['recentFocus']>;
+};
+type ConversationScreenContextWithRoleParams = ConversationScreenContextBaseParams & {
+    roleId: RoleId | '';
+};
+type ConversationScreenContextWithoutRole = Omit<ConversationScreenContext, 'roleId'>;
+export declare function buildConversationScreenContext(params: ConversationScreenContextWithRoleParams): ConversationScreenContext;
+export declare function buildConversationScreenContext(params: ConversationScreenContextBaseParams): ConversationScreenContextWithoutRole;
+export {};

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

@@ -0,0 +1,133 @@
+import { type RuntimeIdentityContext } from './runtimeIdentity';
+export type DeepAgentClientContext = RuntimeIdentityContext;
+export interface DeepAgentRunMessagePayload {
+    content: string;
+    metadata?: Record<string, unknown>;
+}
+export interface CreateDeepAgentRunPayload {
+    workbenchId: string;
+    resource_id?: string;
+    businessGroupId?: string;
+    message: DeepAgentRunMessagePayload;
+    clientContext?: {
+        cardAction?: Record<string, unknown>;
+        selectedCardId?: string;
+        viewState?: Record<string, unknown>;
+    };
+}
+export interface DeepAgentRunView {
+    runId: string;
+    threadId: string;
+    status: string;
+    eventsUrl?: string;
+    currentInterrupt?: unknown;
+    error?: unknown;
+}
+export interface ListDeepAgentMessagesQuery {
+    cursor?: string;
+    limit?: number;
+    order?: 'asc' | 'desc';
+}
+export interface ResumeDeepAgentRunPayload {
+    interruptId: string;
+    decision: unknown;
+}
+export interface CancelDeepAgentRunPayload {
+    reason?: string;
+}
+export interface ArchiveDeepAgentRunPayload {
+    reason?: string;
+}
+export interface DeepAgentRunEventMeta {
+    id: string;
+}
+/**
+ * 判断后端错误是否为同一 thread 已有 active run 的稳定冲突。
+ * @param error - 平台请求层抛出的任意错误
+ * @returns true 表示前端应展示等待当前任务完成的业务提示
+ */
+export declare function isDeepAgentActiveRunConflict(error: unknown): boolean;
+/**
+ * 首次创建 DeepAgent run。
+ * @param context - 运行态身份上下文
+ * @param payload - 用户输入和 UI 上下文
+ * @returns run 视图
+ */
+export declare function createDeepAgentRun(context: DeepAgentClientContext, payload: CreateDeepAgentRunPayload): Promise<DeepAgentRunView>;
+/**
+ * 在已有 thread 下创建后续 run。
+ * @param context - 运行态身份上下文
+ * @param threadId - DeepAgent thread id
+ * @param payload - 用户输入和 UI 上下文
+ * @returns run 视图
+ */
+export declare function createDeepAgentThreadRun(context: DeepAgentClientContext, threadId: string, payload: CreateDeepAgentRunPayload): Promise<DeepAgentRunView>;
+/**
+ * 查询 run 视图。
+ * @param context - 运行态身份上下文
+ * @param threadId - DeepAgent thread id
+ * @param runId - DeepAgent run id
+ * @returns run 视图
+ */
+export declare function getDeepAgentRun(context: DeepAgentClientContext, threadId: string, runId: string): Promise<DeepAgentRunView>;
+/**
+ * 查询 thread 消息。
+ * @param context - 运行态身份上下文
+ * @param threadId - DeepAgent thread id
+ * @param query - 分页参数
+ * @returns messages page
+ */
+export declare function listDeepAgentMessages(context: DeepAgentClientContext, threadId: string, query?: ListDeepAgentMessagesQuery): Promise<unknown>;
+/**
+ * 提交 run resume 决策。
+ * @param context - 运行态身份上下文
+ * @param threadId - DeepAgent thread id
+ * @param runId - DeepAgent run id
+ * @param payload - resume payload
+ * @returns resume 结果
+ */
+export declare function resumeDeepAgentRun(context: DeepAgentClientContext, threadId: string, runId: string, payload: ResumeDeepAgentRunPayload): Promise<unknown>;
+/**
+ * 取消 run。
+ * @param context - 运行态身份上下文
+ * @param threadId - DeepAgent thread id
+ * @param runId - DeepAgent run id
+ * @param payload - cancel payload
+ * @returns cancel 结果
+ */
+export declare function cancelDeepAgentRun(context: DeepAgentClientContext, threadId: string, runId: string, payload?: CancelDeepAgentRunPayload): Promise<unknown>;
+/**
+ * 存档 run。
+ * @param context - 运行态身份上下文
+ * @param threadId - DeepAgent thread id
+ * @param runId - DeepAgent run id
+ * @param payload - archive payload
+ * @returns archive 结果
+ */
+export declare function archiveDeepAgentRun(context: DeepAgentClientContext, threadId: string, runId: string, payload?: ArchiveDeepAgentRunPayload): Promise<unknown>;
+/**
+ * 打开 run events SSE。
+ * @param context - 运行态身份上下文
+ * @param threadId - DeepAgent thread id
+ * @param runId - DeepAgent run id
+ * @param handlers - event callbacks
+ * @param options - abort and resume options
+ * @returns fetch-event-source promise
+ */
+export declare function openDeepAgentRunEvents(context: DeepAgentClientContext, threadId: string, runId: string, handlers: {
+    onEvent: (event: unknown, meta: DeepAgentRunEventMeta) => void;
+    onError?: (error: Error) => void;
+    onOpen?: () => void;
+}, options?: {
+    signal?: AbortSignal;
+    lastEventId?: string;
+    eventsUrl?: string;
+}): Promise<void>;
+/**
+ * 解析后端返回的 DeepAgent events URL 为 gateway URL。
+ * @param threadId - DeepAgent thread id
+ * @param runId - DeepAgent run id
+ * @param eventsUrl - 后端返回的相对 URL
+ * @returns gateway 下的 events URL
+ */
+export declare function resolveDeepAgentEventsUrl(threadId: string, runId: string, eventsUrl?: string): string;

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

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview 兼容转发 - Deep Agent 过程分组已迁移到 @fses/workbench-app。
+ * @author seadon
+ * @created 2026-08-12
+ */
+export * from '../../../runtime/deep-agent/deepAgentProcessGroups';

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

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview 兼容转发 - Deep Agent 进度消息已迁移到 @fses/workbench-app。
+ * @author seadon
+ * @created 2026-08-12
+ */
+export * from '../../../runtime/deep-agent/deepAgentProgressMessage';

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

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview 兼容转发 - Deep Agent 工具展示名已迁移到 @fses/workbench-app。
+ * @author seadon
+ * @created 2026-08-12
+ */
+export * from '../../../runtime/deep-agent/deepAgentToolDisplayName';

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

@@ -0,0 +1,39 @@
+/**
+ * @fileoverview DeepAgent 工作台卡片 mutation 投影器 - 校验组合结果中的可应用快照与结构化反馈
+ * @author seadon
+ * @created 2026-08-02
+ */
+import type { ConversationConfirmation } from '@fses/workbench-app/types';
+export interface ProjectedWorkbenchCardMutation {
+    kind: 'workbench_card_mutation';
+    status: 'applied';
+    publicPayload: {
+        changedBlockIds?: string[];
+        insertedBlockIds?: string[];
+        message?: string;
+        snapshot: Record<string, unknown> & {
+            blocks: unknown[];
+        };
+    };
+}
+export type WorkbenchCardMutationFeedbackSeverity = 'info' | 'warning' | 'error' | 'confirmation';
+export type CombinedMutationFeedbackStatus = 'not_attempted' | 'needs_confirmation' | 'requires_query' | 'version_conflict' | 'blocked' | 'failed';
+export interface ProjectedWorkbenchCardMutationFeedback {
+    status: CombinedMutationFeedbackStatus;
+    severity: WorkbenchCardMutationFeedbackSeverity;
+    message: string;
+    errorCode?: string;
+    confirmation?: ConversationConfirmation;
+}
+/**
+ * Projects a standalone or combined DeepAgent card mutation only when it is applied and has a valid snapshot.
+ * @param value - Tool public payload.
+ * @returns Normalized applied mutation, or null for non-applicable states.
+ */
+export declare function projectDeepAgentWorkbenchCardMutationPayload(value: unknown): ProjectedWorkbenchCardMutation | null;
+/**
+ * Projects non-applied feedback from a combined recommend-and-insert result.
+ * @param value - Tool public payload.
+ * @returns Structured feedback, or null when success/another operation owns the result.
+ */
+export declare function projectDeepAgentWorkbenchCardMutationFeedback(value: unknown): ProjectedWorkbenchCardMutationFeedback | null;

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

@@ -0,0 +1,66 @@
+/**
+ * @fileoverview DeepAgent workbench card recommendation adapter - converts tool payloads into chat UI events.
+ * @author seadon
+ * @created 2026-07-02
+ */
+import type { WorkbenchPlanStreamEvent } from '@fses/workbench-app/types';
+import { recommendationResultIdentity } from '@workbench-internal/lib/workbenchCardRecommendationBinding';
+type CardRecommendationsReadyEvent = Extract<WorkbenchPlanStreamEvent, {
+    type: 'card_recommendations_ready';
+}> & {
+    conversationId?: string;
+    placementTurnId?: string;
+    recommendationOrigin?: 'deep_agent_transcript';
+    source?: 'sql' | 'metric' | 'mixed';
+    sourceTurnId?: string;
+    exhausted?: boolean;
+    totalRecommendationCount?: number;
+    eligibleCandidateCount?: number;
+    returnedCandidateCount?: number;
+    readyCandidateCount?: number;
+    diagnosticCandidateCount?: number;
+    chartFamilyCoverage?: string[];
+    projectionFamilyCoverage?: Record<string, string[]>;
+    queryResult?: Record<string, unknown>;
+    echartsCoverage?: Record<string, unknown>;
+    registryCoverage?: Record<string, unknown>;
+};
+type RegisteredCardInsertReadyEvent = Extract<WorkbenchPlanStreamEvent, {
+    type: 'registered_card_insert_ready';
+}> & {
+    conversationId?: string;
+    message?: string;
+    source?: 'sql' | 'metric' | 'mixed';
+    cardConfig?: Record<string, unknown>;
+    selectedConfig?: Record<string, unknown>;
+};
+type RecommendationResultIdentity = ReturnType<typeof recommendationResultIdentity>;
+/**
+ * Reads query-result identities carried by a DeepAgent workbench-card recommendation payload.
+ * @param value - Candidate DeepAgent tool payload.
+ * @returns Comparable query-result identities from shared and item-level query results.
+ */
+export declare function deepAgentWorkbenchCardRecommendationQueryResultIdentities(value: unknown): RecommendationResultIdentity[];
+/**
+ * Converts a DeepAgent workbench-card recommendation payload into the event already handled by the workbench chat bridge.
+ * @param input - DeepAgent payload and local turn binding.
+ * @returns Frontend recommendation event, or null for non-recommendation payloads.
+ */
+export declare function buildDeepAgentWorkbenchCardRecommendationEvent(input: {
+    payload: unknown;
+    turnId: string;
+    conversationId?: string;
+    recommendationOrigin?: 'deep_agent_transcript';
+    sourceTurnId?: string;
+}): CardRecommendationsReadyEvent | null;
+/**
+ * Converts a DeepAgent workbench-card direct insert payload into the insert-ready event consumed by ai-chat.
+ * @param input - DeepAgent payload and local turn binding.
+ * @returns Registered-card insert event, or null when no direct insert is present.
+ */
+export declare function buildDeepAgentWorkbenchCardDirectInsertEvent(input: {
+    payload: unknown;
+    turnId: string;
+    conversationId?: string;
+}): RegisteredCardInsertReadyEvent | null;
+export {};

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

@@ -0,0 +1,14 @@
+import type { EChartsOption } from 'echarts';
+export interface DynamicEchartRowsPayload {
+    rows: Array<Record<string, unknown>>;
+    fieldMapping: {
+        xField?: unknown;
+        yFields?: unknown;
+    };
+}
+export interface DynamicEchartFieldMapping {
+    xField?: string;
+    yFields: string[];
+}
+export declare function normalizeDynamicEchartFieldMapping(fieldMapping: unknown): DynamicEchartFieldMapping;
+export declare function buildDynamicEchartOption(optionTemplate: unknown, payload: DynamicEchartRowsPayload): EChartsOption;

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

@@ -0,0 +1,34 @@
+/**
+ * @fileoverview ECharts option 编辑桥接 - 在用户侧标准 option 与内部 protocolRender 数据之间转换。
+ * @author seadon
+ * @created 2026-06-22
+ */
+type JsonRecord = Record<string, unknown>;
+type EChartsOptionDraftResult = {
+    ok: true;
+    option: JsonRecord;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * 判断 card.data 是否为 ECharts protocolRender 数据。
+ * @param value - 候选 card.data。
+ * @returns 是 ECharts 协议卡数据时返回 true。
+ */
+export declare function isEChartsProtocolRenderCardData(value: unknown): value is JsonRecord;
+/**
+ * 从 protocolRender card.data 构造用户可编辑的标准 ECharts option。
+ * @param cardData - 当前卡片 card.data。
+ * @returns 转换结果；非协议卡或转换失败时返回失败原因。
+ */
+export declare function buildEChartsOptionEditorDraft(cardData: unknown): EChartsOptionDraftResult;
+/**
+ * 将用户编辑的标准 ECharts option 写回 protocolRender card.data。
+ * @param cardData - 当前卡片 card.data。
+ * @param option - 用户编辑后的 ECharts option。
+ * @returns 保留协议壳和模板信息的下一份 card.data。
+ * @throws 当 card.data 或 option 不符合预期时抛错。
+ */
+export declare function applyEChartsOptionEditorDraft(cardData: unknown, option: unknown): JsonRecord;
+export {};

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

@@ -0,0 +1,24 @@
+/**
+ * @fileoverview ECharts 协议数据精简 - 移除运行态交互不需要的生成期元数据。
+ * @author seadon
+ * @created 2026-06-22
+ */
+import type { MaterializedBlock, WorkbenchSnapshot } from '@fses/workbench-app/types';
+/**
+ * 精简工作台快照中的 ECharts protocolRender 卡片数据。
+ * @param snapshot - 候选快照。
+ * @returns 精简后的快照；无变化时返回原快照。
+ */
+export declare function slimEChartsProtocolSnapshot(snapshot: WorkbenchSnapshot): WorkbenchSnapshot;
+/**
+ * 精简单张工作台卡片中的 ECharts protocolRender 数据。
+ * @param block - 候选卡片。
+ * @returns 精简后的卡片；无变化时返回原卡片。
+ */
+export declare function slimEChartsProtocolBlock(block: MaterializedBlock): MaterializedBlock;
+/**
+ * 精简 ECharts protocolRender 卡片数据。
+ * @param value - 候选卡片数据。
+ * @returns 精简后的数据；非 ECharts protocolRender 数据原样返回。
+ */
+export declare function slimEChartsProtocolCardData(value: Record<string, unknown>): Record<string, unknown>;

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

@@ -0,0 +1,24 @@
+/**
+ * @fileoverview ECharts 模板资源工具 - 读取模板部署 manifest、config 和 data 资源。
+ * @author seadon
+ * @created 2026-06-22
+ */
+import type { EChartsTemplateDeployManifestEntry } from '@fses/workbench-app/types';
+import type { ProtocolConfigPayload, ProtocolDataPayload } from '@fses/workbench-app/types';
+export interface EChartsTemplateDeployManifest {
+    version: 1;
+    entries: EChartsTemplateDeployManifestEntry[];
+}
+/**
+ * 根据 exampleId 查找模板部署资源。
+ * @param manifest - 部署 manifest。
+ * @param exampleId - 官方示例 ID。
+ * @returns manifest 条目。
+ */
+export declare function echartsTemplateDeployEntry(manifest: EChartsTemplateDeployManifest | null | undefined, exampleId: string): EChartsTemplateDeployManifestEntry | undefined;
+/**
+ * 加载 ECharts 模板 JSON 资源。
+ * @param publicPath - public 下可访问的 JSON 路径。
+ * @returns JSON 资源内容。
+ */
+export declare function loadEChartsTemplateJson<T extends ProtocolConfigPayload | ProtocolDataPayload>(publicPath: string): Promise<T>;