@fses/workbench-app 0.2.18 → 0.2.21

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

@@ -9,6 +9,7 @@ import type { FdeWorkbenchAssetPackage } from './fdeWorkbenchAssetPackage';
 import type { MetricFilterBinding } from './workbenchMetricFilterBinding';
 import type { SystemCardWorkbenchPromptParams } from './workbenchSystemCardPrompt';
 import type { WorkbenchChatHistoryMessage } from './workbenchChatHistory';
+import type { WorkbenchAgentTransportAdapter, WorkbenchPlatformRequestAdapter } from '../../../adapters/types';
 export { runtimeIdentityHeaders } from './runtimeIdentity';
 export interface WorkbenchUpdateInfoPayload {
     workspaceId: string;
@@ -131,18 +132,24 @@ export interface WorkbenchPromptAttachment {
     type?: string;
     url?: string;
 }
-export declare function fetchWorkbenchSnapshot(context: WorkbenchContext): Promise<WorkbenchSnapshot>;
+export interface WorkbenchApiTransportOptions {
+    /** 平台接口请求端口，保留平台 envelope。 */
+    requestJson?: WorkbenchPlatformRequestAdapter['requestJson'];
+    /** run-agent 接口请求端口，返回解包后的业务 data。 */
+    agentRequestJson?: WorkbenchAgentTransportAdapter['requestJson'];
+}
+export declare function fetchWorkbenchSnapshot(context: WorkbenchContext, transport?: WorkbenchApiTransportOptions): Promise<WorkbenchSnapshot>;
 /**
  * 读取后端可信运行态身份，供直接打开工作台 URL 时补齐用户作用域。
  * @returns 当前请求可信用户、租户和身份来源。
  */
-export declare function fetchWorkbenchIdentity(): Promise<WorkbenchRuntimeIdentity>;
+export declare function fetchWorkbenchIdentity(transport?: WorkbenchApiTransportOptions): Promise<WorkbenchRuntimeIdentity>;
 /**
  * Checks whether the current user can access a personal workbench resource.
  * @param resourceId - Workbench resource_id from the route entry.
  * @returns Normalized access check result.
  */
-export declare function fetchWorkbenchAccessCheck(resourceId: string): Promise<WorkbenchAccessCheckResult>;
+export declare function fetchWorkbenchAccessCheck(resourceId: string, transport?: WorkbenchApiTransportOptions): Promise<WorkbenchAccessCheckResult>;
 /**
  * Fetches current tenant manageable applications for chart config dropdowns.
  * @param options - Optional fuzzy app name search.
@@ -150,32 +157,32 @@ export declare function fetchWorkbenchAccessCheck(resourceId: string): Promise<W
  */
 export declare function fetchWorkbenchApplications(options?: {
     name?: string;
-}): Promise<WorkbenchApplicationOption[]>;
+}, transport?: WorkbenchApiTransportOptions): Promise<WorkbenchApplicationOption[]>;
 /**
  * Fetches model selectMore services for the selected platform application.
  * @param appId - Selected platform application id.
  * @returns Flattened model-service dropdown options.
  */
-export declare function fetchWorkbenchChartModelServices(appId: string): Promise<WorkbenchChartModelServiceOption[]>;
+export declare function fetchWorkbenchChartModelServices(appId: string, transport?: WorkbenchApiTransportOptions): Promise<WorkbenchChartModelServiceOption[]>;
 /**
  * Fetches metric dictionary options for the selected platform application.
  * @param appId - Selected platform application id.
  * @returns Metric dropdown options.
  */
-export declare function fetchWorkbenchChartMetrics(appId: string): Promise<WorkbenchChartMetricOption[]>;
+export declare function fetchWorkbenchChartMetrics(appId: string, transport?: WorkbenchApiTransportOptions): Promise<WorkbenchChartMetricOption[]>;
 /**
  * Fetches list pages for the selected platform application.
  * @param appId - Selected platform application id.
  * @returns Flattened list dropdown options.
  */
-export declare function fetchWorkbenchChartLists(appId: string): Promise<WorkbenchChartListOption[]>;
+export declare function fetchWorkbenchChartLists(appId: string, transport?: WorkbenchApiTransportOptions): Promise<WorkbenchChartListOption[]>;
 /**
  * Imports a FDE draft asset package into the ES-backed runtime workbench store.
  * @param context - Runtime target scope that will own the published workbench.
  * @param assetPackage - FDE asset package generated by the editor or host draft.
  * @returns Import counts returned by run-agent.
  */
-export declare function importWorkbenchAssetPackage(context: WorkbenchContext, assetPackage: FdeWorkbenchAssetPackage): Promise<WorkbenchAssetImportResult>;
+export declare function importWorkbenchAssetPackage(context: WorkbenchContext, assetPackage: FdeWorkbenchAssetPackage, transport?: WorkbenchApiTransportOptions): Promise<WorkbenchAssetImportResult>;
 /**
  * Ensures a published FDE system asset package has been imported before opening its runtime workspace.
  * @param context - Runtime target scope that will own the published workbench.
@@ -184,10 +191,10 @@ export declare function importWorkbenchAssetPackage(context: WorkbenchContext, a
  */
 export declare function ensurePublishedWorkbenchAssetPackage(context: WorkbenchContext, payload: {
     resource_id: string;
-}): Promise<WorkbenchAssetImportResult & {
+}, transport?: WorkbenchApiTransportOptions): Promise<WorkbenchAssetImportResult & {
     existed?: boolean;
 }>;
-export declare function fetchWorkbenchWorkspaces(context: WorkbenchIdentityContext): Promise<{
+export declare function fetchWorkbenchWorkspaces(context: WorkbenchIdentityContext, transport?: WorkbenchApiTransportOptions): Promise<{
     workbenches: WorkbenchTemplate[];
     preference: UserWorkbenchPreference;
 }>;
@@ -196,31 +203,31 @@ export declare function fetchWorkbenchWorkspaces(context: WorkbenchIdentityConte
  * @param resourceId - 当前工作台 resource_id。
  * @returns 归一化后的开场白文案。
  */
-export declare function fetchWorkbenchPrologue(resourceId: string): Promise<WorkbenchPrologueResult>;
+export declare function fetchWorkbenchPrologue(resourceId: string, transport?: WorkbenchApiTransportOptions): Promise<WorkbenchPrologueResult>;
 export declare function selectWorkbench(context: WorkbenchIdentityContext, payload: {
     workspaceId: string;
     assistantPersona?: AssistantPersonaKey;
-}): Promise<UserWorkbenchPreference>;
+}, transport?: WorkbenchApiTransportOptions): Promise<UserWorkbenchPreference>;
 export declare function saveAssistantPersonaPreference(context: WorkbenchIdentityContext, payload: {
     workspaceId: string;
     assistantPersona: AssistantPersonaKey;
-}): Promise<UserWorkbenchPreference>;
-export declare function updateWorkbenchInfo(context: WorkbenchIdentityContext, payload: WorkbenchUpdateInfoPayload): Promise<WorkbenchTemplate>;
+}, transport?: WorkbenchApiTransportOptions): Promise<UserWorkbenchPreference>;
+export declare function updateWorkbenchInfo(context: WorkbenchIdentityContext, payload: WorkbenchUpdateInfoPayload, transport?: WorkbenchApiTransportOptions): Promise<WorkbenchTemplate>;
 export declare function deleteWorkbench(context: WorkbenchIdentityContext, payload: {
     workspaceId: string;
-}): Promise<{
+}, transport?: WorkbenchApiTransportOptions): Promise<{
     message: string;
 }>;
 export declare function saveWorkbenchSnapshot(context: WorkbenchContext, snapshot: WorkbenchSnapshot, options?: {
     baseVersion?: number;
     persistenceFallbackReason?: string;
     persistenceFallbackSummary?: Record<string, unknown>;
-}): Promise<WorkbenchSnapshot>;
+}, transport?: WorkbenchApiTransportOptions): Promise<WorkbenchSnapshot>;
 export declare function confirmCardMutation(context: WorkbenchContext, payload: {
     turnId: string;
     conversationId?: string;
     confirmed: boolean;
-}): Promise<{
+}, transport?: WorkbenchApiTransportOptions): Promise<{
     snapshot: WorkbenchSnapshot;
     mutationTransaction?: MutationTransaction;
     confirmation: ConversationConfirmation;
@@ -239,7 +246,7 @@ export declare function applyWorkbenchCardPatch(context: WorkbenchContext, paylo
     baseVersion?: number;
     selectedBlockId?: string;
     screenContext?: ConversationScreenContext;
-}): Promise<{
+}, transport?: WorkbenchApiTransportOptions): Promise<{
     status: "applied" | "needs_confirmation" | "failed" | "blocked" | "version_conflict";
     patchPlan?: PatchPlan;
     snapshot?: WorkbenchSnapshot;
@@ -276,7 +283,7 @@ export declare function planWorkbench(context: WorkbenchContext, payload: {
     };
     messages: WorkbenchChatHistoryMessage[];
     screenContext?: ConversationScreenContext;
-}): Promise<PlanResponse>;
+}, transport?: WorkbenchApiTransportOptions): Promise<PlanResponse>;
 export declare function confirmLayoutDraftStream(context: WorkbenchContext, payload: {
     turnId: string;
     sourceTurnId?: string;
@@ -284,18 +291,20 @@ export declare function confirmLayoutDraftStream(context: WorkbenchContext, payl
     layoutDraftId: string;
 }, onEvent: (event: WorkbenchPlanStreamEvent) => void, onError?: (error: Error) => void, options?: {
     signal?: AbortSignal;
+}, transport?: {
+    openEventStream: WorkbenchAgentTransportAdapter['openEventStream'];
 }): Promise<void>;
 export declare function materializeBlocks(context: WorkbenchContext, payload: {
     blockPlans: BlockPlan[];
     mode: 'preview' | 'final';
-}): Promise<MaterializeResponse>;
+}, transport?: WorkbenchApiTransportOptions): Promise<MaterializeResponse>;
 export declare function saveWorkbenchLayout(context: WorkbenchContext, payload: {
     baseVersion?: number;
     layoutVersion?: number;
     layout: BlockLayout[];
     layoutConfig?: LayoutConfig;
     visualConfig?: WorkbenchSnapshot['visualConfig'] | null;
-}): Promise<WorkbenchSnapshot>;
+}, transport?: WorkbenchApiTransportOptions): Promise<WorkbenchSnapshot>;
 export declare function insertWorkbenchCard(context: WorkbenchContext, payload: {
     baseVersion: number;
     title: string;
@@ -307,7 +316,7 @@ export declare function insertWorkbenchCard(context: WorkbenchContext, payload:
     style?: Record<string, unknown>;
     commonMeta?: Record<string, unknown>;
     dataBinding?: Record<string, unknown>;
-}): Promise<WorkbenchSnapshot>;
+}, transport?: WorkbenchApiTransportOptions): Promise<WorkbenchSnapshot>;
 export type SmartInsertStatus = 'applied' | 'needs_confirmation' | 'blocked' | 'requires_query' | 'version_conflict' | 'layout_conflict' | 'legacy_host_resolved' | 'failed';
 export type LayoutResolutionSource = 'frontend_runtime' | 'host_port' | 'host_existing_insert' | 'fallback_layout';
 export interface CanonicalLayoutContextSummary {
@@ -379,7 +388,7 @@ export declare function recommendWorkbenchCards(context: WorkbenchContext, paylo
     conversationId: string;
     input?: string;
     preferredCategories?: string[];
-}): Promise<WorkbenchCardRecommendationResult>;
+}, transport?: WorkbenchApiTransportOptions): Promise<WorkbenchCardRecommendationResult>;
 /**
  * Inserts a selected registered/system card through CardModule instead of the workbench chat stream.
  * @param context - Current workbench identity context.
@@ -398,7 +407,7 @@ export declare function insertRegisteredWorkbenchCard(context: Pick<WorkbenchCon
     canonicalLayoutContext?: Record<string, unknown>;
     targetResolution?: Record<string, unknown>;
     screenContext?: Omit<ConversationScreenContext, 'roleId'>;
-}): Promise<RegisteredWorkbenchCardInsertResult>;
+}, transport?: WorkbenchApiTransportOptions): Promise<RegisteredWorkbenchCardInsertResult>;
 export interface WorkbenchDataBindingQueryResult {
     bindingId: string;
     success: boolean;
@@ -456,7 +465,7 @@ export interface WorkbenchDataBindingRepairResult {
  * @param context - Current workbench identity context.
  * @returns Scoped repair report returned by run-agent.
  */
-export declare function repairWorkbenchDataBindings(context: Pick<WorkbenchContext, 'workspaceId' | 'userId' | 'tenantId' | 'appId'>): Promise<WorkbenchDataBindingRepairResult>;
+export declare function repairWorkbenchDataBindings(context: Pick<WorkbenchContext, 'workspaceId' | 'userId' | 'tenantId' | 'appId'>, transport?: WorkbenchApiTransportOptions): Promise<WorkbenchDataBindingRepairResult>;
 /**
  * Runs scoped data-binding repair after a stale refresh failure.
  * @param context - User scope for the current workbench.
@@ -464,7 +473,7 @@ export declare function repairWorkbenchDataBindings(context: Pick<WorkbenchConte
  * @param error - Refresh error to inspect.
  * @returns Repair report when repair was triggered, otherwise null.
  */
-export declare function repairWorkbenchDataBindingsForRefreshApi(context: Pick<WorkbenchContext, 'userId' | 'tenantId' | 'appId'>, refreshApi: string, error: unknown): Promise<WorkbenchDataBindingRepairResult | null>;
+export declare function repairWorkbenchDataBindingsForRefreshApi(context: Pick<WorkbenchContext, 'userId' | 'tenantId' | 'appId'>, refreshApi: string, error: unknown, transport?: WorkbenchApiTransportOptions, pendingRepairsByScope?: Map<string, Promise<WorkbenchDataBindingRepairResult>>): Promise<WorkbenchDataBindingRepairResult | null>;
 export declare function queryWorkbenchDataBinding(context: Pick<WorkbenchContext, 'userId'> & Partial<Pick<WorkbenchContext, 'tenantId' | 'appId' | 'roleId'>> & {
     conversationId?: string;
 }, refreshApi: string, options?: {
@@ -472,7 +481,7 @@ export declare function queryWorkbenchDataBinding(context: Pick<WorkbenchContext
     semanticAppId?: string;
     filterValues?: Record<string, unknown>;
     metricFilterBindings?: MetricFilterBinding[];
-}): Promise<WorkbenchDataBindingQueryResult>;
+}, transport?: WorkbenchApiTransportOptions): Promise<WorkbenchDataBindingQueryResult>;
 /**
  * 更新已有运行态指标卡的 FDE 筛选绑定。
  * @param context - 当前可信运行时身份
@@ -481,7 +490,7 @@ export declare function queryWorkbenchDataBinding(context: Pick<WorkbenchContext
  * @param bindings - 已确认指标筛选绑定
  * @returns 更新后的前端安全绑定摘要
  */
-export declare function updateWorkbenchMetricFilterBindings(context: Pick<WorkbenchContext, 'userId'> & Partial<Pick<WorkbenchContext, 'tenantId' | 'appId' | 'roleId'>>, workspaceId: string, bindingId: string, bindings: MetricFilterBinding[]): Promise<{
+export declare function updateWorkbenchMetricFilterBindings(context: Pick<WorkbenchContext, 'userId'> & Partial<Pick<WorkbenchContext, 'tenantId' | 'appId' | 'roleId'>>, workspaceId: string, bindingId: string, bindings: MetricFilterBinding[], transport?: WorkbenchApiTransportOptions): Promise<{
     bindingId: string;
     refreshApi: string;
     fieldMapping: Record<string, unknown>;
@@ -495,7 +504,7 @@ export declare function updateWorkbenchMetricFilterBindings(context: Pick<Workbe
  */
 export declare function queryWorkbenchDataBindingCandidate(context: WorkbenchContext & {
     conversationId?: string;
-}, cardId: string): Promise<WorkbenchDataBindingQueryResult>;
+}, cardId: string, transport?: WorkbenchApiTransportOptions): Promise<WorkbenchDataBindingQueryResult>;
 /**
  * Rebinds any card to a user-supplied business wording and executes a real query.
  * @param context - Current workbench identity and optional conversation scope.
@@ -511,7 +520,7 @@ export declare function rebindWorkbenchCardDataBinding(context: WorkbenchContext
     fieldLabels?: Record<string, unknown>;
     cardConfig?: Record<string, unknown>;
     selectedConfig?: Record<string, unknown>;
-}): Promise<WorkbenchDataBindingQueryResult>;
+}, transport?: WorkbenchApiTransportOptions): Promise<WorkbenchDataBindingQueryResult>;
 /**
  * Queries paged detail rows for a clicked chart category.
  * @param context - Current workbench identity.
@@ -524,7 +533,7 @@ export declare function queryWorkbenchManualSqlDrilldownPage(context: WorkbenchC
     categoryValue: unknown;
     pageIndex: number;
     pageSize: number;
-}): Promise<WorkbenchManualSqlDrilldownPageResult>;
+}, transport?: WorkbenchApiTransportOptions): Promise<WorkbenchManualSqlDrilldownPageResult>;
 export declare function updateWorkbenchCard(context: WorkbenchContext, cardId: string, payload: {
     baseVersion: number;
     cardVersion: number;
@@ -539,7 +548,7 @@ export declare function updateWorkbenchCard(context: WorkbenchContext, cardId: s
         commonMeta?: Record<string, unknown>;
         bodyJson?: Record<string, unknown>;
     };
-}): Promise<WorkbenchSnapshot>;
+}, transport?: WorkbenchApiTransportOptions): Promise<WorkbenchSnapshot>;
 /**
  * 删除指定工作台卡片，并返回后端增量处理后的最新快照。
  * @param context - 当前工作台上下文。
@@ -550,10 +559,10 @@ export declare function updateWorkbenchCard(context: WorkbenchContext, cardId: s
 export declare function deleteWorkbenchCard(context: WorkbenchContext, cardId: string, payload: {
     baseVersion: number;
     cardVersion: number;
-}): Promise<WorkbenchSnapshot>;
+}, transport?: WorkbenchApiTransportOptions): Promise<WorkbenchSnapshot>;
 export declare function refreshWorkbench(context: WorkbenchContext, payload?: {
     blockId?: string;
-}): Promise<WorkbenchSnapshot>;
+}, transport?: WorkbenchApiTransportOptions): Promise<WorkbenchSnapshot>;
 export interface RuntimeBusinessQueryResult {
     objectType: string;
     objectLabel: string;
@@ -572,13 +581,13 @@ export interface RuntimeBusinessQueryResult {
 }
 export declare function queryRuntimeBusinessObjects(context: WorkbenchContext, payload: {
     params: Record<string, unknown>;
-}): Promise<RuntimeBusinessQueryResult>;
+}, transport?: WorkbenchApiTransportOptions): Promise<RuntimeBusinessQueryResult>;
 export declare function executeRuntimeAction(context: WorkbenchContext, payload: {
     actionType: string;
     blockId?: string;
     capabilityId?: string;
     params?: Record<string, unknown>;
-}): Promise<{
+}, transport?: WorkbenchApiTransportOptions): Promise<{
     snapshot: WorkbenchSnapshot;
     actionLog: Array<Record<string, unknown>>;
     event: Record<string, unknown>;
@@ -588,7 +597,7 @@ export declare function submitWorkbenchForm(context: WorkbenchContext, payload:
     blockId: string;
     values: Record<string, unknown>;
     confirmed?: boolean;
-}): Promise<{
+}, transport?: WorkbenchApiTransportOptions): Promise<{
     snapshot: WorkbenchSnapshot;
     message: string;
 }>;
@@ -596,7 +605,7 @@ export declare function submitWorkbenchSurvey(context: WorkbenchContext, payload
     blockId: string;
     answers: Record<string, unknown>;
     confirmed?: boolean;
-}): Promise<{
+}, transport?: WorkbenchApiTransportOptions): Promise<{
     snapshot: WorkbenchSnapshot;
     message: string;
 }>;
@@ -605,7 +614,7 @@ export declare function executeWorkbenchAction(context: WorkbenchContext, payloa
     actionId: string;
     actionLabel: string;
     confirmed?: boolean;
-}): Promise<{
+}, transport?: WorkbenchApiTransportOptions): Promise<{
     snapshot: WorkbenchSnapshot;
     actionLog: Array<Record<string, unknown>>;
     message: string;
@@ -613,7 +622,7 @@ export declare function executeWorkbenchAction(context: WorkbenchContext, payloa
 export declare function generateWorkbenchReport(context: WorkbenchContext, payload: {
     blockId: string;
     confirmed?: boolean;
-}): Promise<{
+}, transport?: WorkbenchApiTransportOptions): Promise<{
     snapshot: WorkbenchSnapshot;
     artifact: Record<string, unknown>;
     message: string;
@@ -624,7 +633,7 @@ export declare function confirmSubmitDraft(context: WorkbenchContext, payload: {
     turnId?: string;
     conversationId?: string;
     filledFields?: Record<string, unknown>;
-}): Promise<{
+}, transport?: WorkbenchApiTransportOptions): Promise<{
     snapshot?: WorkbenchSnapshot;
     submitDraft: SubmitDraft;
     confirmation: ConversationConfirmation;
@@ -635,10 +644,11 @@ export declare function confirmSubmitDraft(context: WorkbenchContext, payload: {
     submission?: Record<string, unknown>;
 }>;
 /**
- * 发起编排流请求（SSE）
- * @param params - 编排请求参数
- * @param onEvent - SSE 事件回调
- * @returns Promise，在流完成后 resolve
+ * 发起编排流请求（SSE）。
+ * @param params - 编排请求参数。
+ * @param onEvent - SSE 事件回调。
+ * @param transport - 可选 Agent 流传输端口。
+ * @returns Promise，在流完成后 resolve。
  */
 export declare function composeStream(params: {
     workspaceId: string;
@@ -650,7 +660,9 @@ export declare function composeStream(params: {
 }, onEvent: (event: {
     type: string;
     data?: unknown;
-}) => void): Promise<void>;
+}) => void, transport?: {
+    openEventStream: WorkbenchAgentTransportAdapter['openEventStream'];
+}): Promise<void>;
 /**
  * 发起 Workbench V2 图片编排流请求。
  * @param params - V2 图片编排请求参数。
@@ -683,4 +695,6 @@ export declare function composeImageV2Stream(params: {
         optimizedHeight?: number;
     };
     conversationId?: string;
-}, onEvent: (event: ComposeStreamEvent) => void, options?: ComposeImageV2StreamOptions): Promise<void>;
+}, onEvent: (event: ComposeStreamEvent) => void, options?: ComposeImageV2StreamOptions, transport?: {
+    openEventStream: WorkbenchAgentTransportAdapter['openEventStream'];
+}): Promise<void>;

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

@@ -3,6 +3,7 @@
  * @author seadon
  * @created 2026-07-12
  */
+import { type WorkbenchJsonRequestTransport } from './workbenchRequestTransport';
 export interface WorkbenchMetricDetailColumn {
     label?: string;
     name: string;
@@ -59,4 +60,4 @@ export interface WorkbenchMetricDetailPageResult {
  * @param request - 指标详情分页请求
  * @returns 分页表格数据
  */
-export declare function queryWorkbenchMetricDetailPage(request: WorkbenchMetricDetailPageRequest): Promise<WorkbenchMetricDetailPageResult>;
+export declare function queryWorkbenchMetricDetailPage(request: WorkbenchMetricDetailPageRequest, transport?: WorkbenchJsonRequestTransport): Promise<WorkbenchMetricDetailPageResult>;

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

@@ -4,6 +4,7 @@
  * @created 2026-05-10
  */
 import type { BlockLayout, LayoutConfig, RoleId, WorkbenchSnapshot } from '@fses/workbench-app/types';
+import type { WorkbenchPlatformRequestAdapter } from '../../../adapters/types';
 export interface WorkbenchRemoteContext {
     workspaceId: string;
     userId: string;
@@ -13,6 +14,7 @@ export interface WorkbenchRemoteContext {
 }
 export interface WorkbenchRemoteClientOptions {
     baseUrl?: string;
+    requestJson?: WorkbenchPlatformRequestAdapter['requestJson'];
 }
 export interface WorkbenchRemoteSaveLayoutPayload {
     baseVersion: number;
@@ -32,7 +34,7 @@ export interface WorkbenchRemoteSaveSnapshotPayload {
  * @param options - 远端客户端配置。
  * @returns 工作台快照读取与保存客户端。
  */
-export declare function createWorkbenchRemoteClient({ baseUrl }?: WorkbenchRemoteClientOptions): {
+export declare function createWorkbenchRemoteClient({ baseUrl, requestJson }?: WorkbenchRemoteClientOptions): {
     fetchSnapshot(context: WorkbenchRemoteContext): Promise<WorkbenchSnapshot>;
     saveLayout(context: WorkbenchRemoteContext, payload: WorkbenchRemoteSaveLayoutPayload): Promise<WorkbenchSnapshot>;
     saveSnapshot(context: WorkbenchRemoteContext, payload: WorkbenchRemoteSaveSnapshotPayload): Promise<WorkbenchSnapshot>;

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

@@ -0,0 +1,24 @@
+/**
+ * @fileoverview 工作台 JSON 请求 transport - 在实例 Service Port 与 legacy 请求间做单路选择。
+ * @author seadon
+ * @created 2026-09-01
+ */
+import type { WorkbenchAgentTransportAdapter, WorkbenchPlatformRequestAdapter } from '../../../adapters/types';
+export interface WorkbenchJsonRequestTransport {
+    agentRequestJson?: WorkbenchAgentTransportAdapter['requestJson'];
+    requestJson?: WorkbenchPlatformRequestAdapter['requestJson'];
+}
+export interface WorkbenchJsonRequestConfig {
+    headers?: Record<string, string>;
+    method?: string;
+    payload?: unknown;
+    signal?: AbortSignal;
+    url: string;
+}
+/**
+ * 通过当前实例 JSON port 发起请求；未提供 port 时回退 legacy。
+ * @param config - 请求配置。
+ * @param transport - 当前实例 transport。
+ * @returns JSON 业务响应。
+ */
+export declare function requestWorkbenchJsonWithTransport<T>(config: WorkbenchJsonRequestConfig, transport?: WorkbenchJsonRequestTransport): Promise<T>;

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

@@ -2,6 +2,7 @@ import type { AssistantPersonaKey, LayoutConfig, RoleId } from '@fses/workbench-
 import type { WorkbenchCanvasGapPreset, WorkbenchCardPresetSizeConfig } from './cardSizeConfig';
 import type { WorkbenchCardStyleConfig } from './cardStyleConfig';
 import type { RecoverableDeepAgentTurnSnapshot } from './deepAgentQueueState';
+import type { WorkbenchStorageAdapter } from '../../../adapters/types';
 export interface WorkbenchCanvasSettingsMemory {
     layoutConfig?: LayoutConfig;
     cardStyleConfig?: WorkbenchCardStyleConfig;
@@ -46,24 +47,24 @@ export interface WorkbenchUiMemory {
  * @returns 稳定的 scope key；关键身份缺失时返回空字符串。
  */
 export declare function buildConversationScopeKey(scope: WorkbenchConversationScope): string;
-export declare function readWorkbenchUiMemory(): WorkbenchUiMemory | null;
-export declare function writeWorkbenchUiMemory(memory: WorkbenchUiMemory): void;
+export declare function readWorkbenchUiMemory(storage?: WorkbenchStorageAdapter): WorkbenchUiMemory | null;
+export declare function writeWorkbenchUiMemory(memory: WorkbenchUiMemory, storage?: WorkbenchStorageAdapter): void;
 /**
  * 读取当前 scope 的最近真实会话 ID。
  * @param scope - 当前运行态身份、工作台和聊天模式。
  * @returns DeepAgent threadId；没有可恢复会话时返回空字符串。
  */
-export declare function readScopedSelectedConversationId(scope: WorkbenchConversationScope): string;
+export declare function readScopedSelectedConversationId(scope: WorkbenchConversationScope, storage?: WorkbenchStorageAdapter): string;
 /**
  * 写入当前 scope 的最近真实会话 ID。
  * @param scope - 当前运行态身份、工作台和聊天模式。
  * @param conversationId - DeepAgent threadId。
  */
-export declare function writeScopedSelectedConversationId(scope: WorkbenchConversationScope, conversationId: string): void;
+export declare function writeScopedSelectedConversationId(scope: WorkbenchConversationScope, conversationId: string, storage?: WorkbenchStorageAdapter): void;
 /**
  * 清理当前 scope 的最近真实会话 ID。
  * @param scope - 当前运行态身份、工作台和聊天模式。
  */
-export declare function clearScopedSelectedConversationId(scope: WorkbenchConversationScope): void;
-export declare function readWorkbenchCanvasSettings(workspaceId: string): WorkbenchCanvasSettingsMemory;
-export declare function writeWorkbenchCanvasSettings(workspaceId: string, settings: WorkbenchCanvasSettingsMemory): void;
+export declare function clearScopedSelectedConversationId(scope: WorkbenchConversationScope, storage?: WorkbenchStorageAdapter): void;
+export declare function readWorkbenchCanvasSettings(workspaceId: string, storage?: WorkbenchStorageAdapter): WorkbenchCanvasSettingsMemory;
+export declare function writeWorkbenchCanvasSettings(workspaceId: string, settings: WorkbenchCanvasSettingsMemory, storage?: WorkbenchStorageAdapter): void;

package/dist/internal/personal-workbench/pages/Workspace.vue.d.ts

@@ -1,9 +1,9 @@
 type __VLS_Props = {
     embedInPortal?: boolean;
 };
-declare var __VLS_16: {};
+declare var __VLS_31: {};
 type __VLS_Slots = {} & {
-    'before-workbench'?: (props: typeof __VLS_16) => any;
+    'before-workbench'?: (props: typeof __VLS_31) => any;
 };
 declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
     embedInPortal: boolean;

package/dist/internal/personal-workbench/stores/domains/actionsRuntime.d.ts

@@ -0,0 +1,35 @@
+import type { ConversationTaskState, ConversationTurn, WorkbenchPlanStreamEvent } from '@fses/workbench-app/types';
+import type { WorkbenchCardDataTaskContinuation, WorkbenchCardDataTaskRuntimeState } from '../../vue-types/workbenchRuntime';
+export type CardDataTaskStreamEvent = Extract<WorkbenchPlanStreamEvent, {
+    type: 'card_data_task_started' | 'card_data_task_progress' | 'card_data_task_confirmation' | 'card_data_task_empty' | 'card_data_task_bound' | 'card_data_task_config_required' | 'card_data_task_failed';
+}>;
+/** 判断轮次是否已有指定任务状态。 */
+export declare function turnHasTaskState(turn: ConversationTurn, taskId: string | undefined): boolean;
+/** 将 task_state 同步写入当前和历史轮次。 */
+export declare function applyTaskStateEventToTurns(turns: ConversationTurn[], targetTurnId: string, event: Extract<WorkbenchPlanStreamEvent, {
+    type: 'task_state';
+}>): ConversationTurn[];
+/** 判断是否为 card-data-task 流事件。 */
+export declare function isCardDataTaskStreamEvent(event: WorkbenchPlanStreamEvent): event is CardDataTaskStreamEvent;
+/** 返回 card-data-task 的展示标题。 */
+export declare function cardDataTaskReturnTitle(event: CardDataTaskStreamEvent): string;
+/** 返回 card-data-task 的展示摘要。 */
+export declare function cardDataTaskReturnSummary(event: CardDataTaskStreamEvent): string;
+/** 将后端确认候选转换为任务状态候选。 */
+export declare function cardDataTaskClarificationOptions(options: Array<Record<string, unknown>>): ConversationTaskState['clarificationOptions'];
+/** 将 card-data-task 确认事件转换为通用任务状态。 */
+export declare function cardDataTaskConfirmationState(event: Extract<WorkbenchPlanStreamEvent, {
+    type: 'card_data_task_confirmation';
+}>): ConversationTaskState;
+/** 判断 card-data-task 事件是否需要展示返回项。 */
+export declare function shouldAppendCardDataTaskReturnItem(event: CardDataTaskStreamEvent): boolean;
+/** 根据确认短语构造 card-data-task 续接参数。 */
+export declare function cardDataTaskContinuationFromPhrase(task: WorkbenchCardDataTaskRuntimeState, phrase: string): WorkbenchCardDataTaskContinuation | null;
+/** 判断输入是否为任务取消短语。 */
+export declare function isTaskCancelPhrase(value: string): boolean;
+/** 判断输入是否为候选序号。 */
+export declare function isTaskOptionSelectionPhrase(value: string): boolean;
+/** 本地更新一个任务确认状态。 */
+export declare function taskStateAfterPhraseSubmit(task: ConversationTaskState, phrase: string): ConversationTaskState;
+/** 同步更新所有持有同 taskId 的任务卡。 */
+export declare function markTaskStatePhraseSubmittedInTurns(turns: ConversationTurn[], taskId: string, phrase: string): ConversationTurn[];

package/dist/internal/personal-workbench/stores/domains/canvasRuntime.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @fileoverview 工作台 canvas runtime domain - 管理图表可读尺寸和 V2 布局树投影算法。
+ * @author seadon
+ * @created 2026-09-01
+ */
+import type { BlockLayout, MaterializedBlock } from '@fses/workbench-app/types';
+import type { WorkbenchV2Card, WorkbenchV2Document } from '../../types/workbenchV2';
+export interface ReadableChartMinimumSize {
+    height?: number;
+    width?: number;
+}
+/** 读取有限正数。 */
+export declare function positiveRuntimeNumber(value: unknown): number | undefined;
+/** 估算中英文标签展示宽度。 */
+export declare function runtimeDisplayWidth(value: unknown): number;
+/** 将布局数值规整到三位小数。 */
+export declare function roundRuntimeLayoutValue(value: number): number;
+/** 估算类目轴最小可读宽度。 */
+export declare function readableCategoryAxisMinimumWidth(categoryCount: number, longestLabelWidth: number): number | undefined;
+/** 读取 ECharts series 记录。 */
+export declare function runtimeEChartsSeries(option: unknown): Record<string, unknown>[];
+/** 判断 series 是否为南丁格尔玫瑰图。 */
+export declare function isRuntimeRosePieSeries(series: Record<string, unknown>): boolean;
+/** 估算 pie/rose 标签统计。 */
+export declare function runtimePieSeriesLabelStats(series: Record<string, unknown>): {
+    count: number;
+    longest: number;
+};
+/** 估算原生 ECharts option 最小可读尺寸。 */
+export declare function readableEChartsOptionMinimumSize(option: unknown): ReadableChartMinimumSize;
+/** 按 renderer data 估算图表最小可读尺寸。 */
+export declare function readableChartMinimumSize(data: Record<string, unknown>): ReadableChartMinimumSize;
+/** 判断扩宽后是否仍为空槽。 */
+export declare function canGrowReadableChartWidth(layout: BlockLayout, width: number, height: number, siblingLayouts: readonly BlockLayout[]): boolean;
+/** 计算可应用的图表增长宽度。 */
+export declare function readableChartNextWidth(layout: BlockLayout, minimumWidth: number | undefined, siblingLayouts: readonly BlockLayout[], height?: number): number | undefined;
+/** 在不缩小已有布局的前提下应用可读尺寸。 */
+export declare function layoutWithReadableChartMinimumSize(layout: BlockLayout, data: Record<string, unknown>, siblingLayouts?: readonly BlockLayout[]): BlockLayout;
+/** 应用 MaterializedBlock 图表可读尺寸。 */
+export declare function layoutWithReadableChartMinimum(block: MaterializedBlock, data: Record<string, unknown>, siblingBlocks?: readonly MaterializedBlock[]): BlockLayout;
+/** 应用 V2 card layout 图表可读尺寸。 */
+export declare function v2LayoutWithReadableChartMinimum(layout: WorkbenchV2Card['layout'] | undefined, cardId: string, data: Record<string, unknown>, siblingLayouts?: readonly BlockLayout[]): WorkbenchV2Card['layout'] | undefined;
+/** 同步 V2 visualConfig.layoutTree 中的图表可读尺寸。 */
+export declare function v2DocumentWithReadableChartLayoutTree(document: WorkbenchV2Document, cardId: string, data: Record<string, unknown>): WorkbenchV2Document;

package/dist/internal/personal-workbench/stores/domains/conversationRuntime.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @fileoverview 工作台 conversation runtime domain - 管理 DeepAgent run 与 invocation 去重资源。
+ * @author seadon
+ * @created 2026-09-01
+ */
+export interface DeepAgentDedupeResources {
+    terminalRunIds: Set<string>;
+    visibleInvocationIdsByRun: Map<string, Set<string>>;
+}
+export interface DeepAgentRuntimeEventLike {
+    status?: string;
+    type: string;
+}
+/** 生成 run 级去重 key。 */
+export declare function deepAgentRunDedupeKey(threadId: string, runId: string): string;
+/** 标记已展示的结构化 invocation。 */
+export declare function markDeepAgentVisibleInvocation(resources: DeepAgentDedupeResources, threadId: string, runId: string, invocationId: string): void;
+/** 判断 invocation 是否已经展示。 */
+export declare function hasDeepAgentVisibleInvocation(resources: DeepAgentDedupeResources, threadId: string, runId: string, invocationId: string): boolean;
+/** 标记 run 已进入终态。 */
+export declare function markDeepAgentTerminalRun(resources: DeepAgentDedupeResources, threadId: string, runId: string): void;
+/** 判断 run 是否已经终止。 */
+export declare function isDeepAgentTerminalRun(resources: DeepAgentDedupeResources, threadId: string, runId: string): boolean;
+/** 清理 run 终态标记。 */
+export declare function clearDeepAgentTerminalRuns(resources: DeepAgentDedupeResources, threadId?: string | null, runId?: string | null): void;
+/** 清理 invocation 去重状态。 */
+export declare function clearDeepAgentVisibleInvocations(resources: DeepAgentDedupeResources, threadId?: string | null, runId?: string | null): void;
+/** 判断运行态事件是否代表 run 终态。 */
+export declare function isDeepAgentTerminalRuntimeEvent(event: DeepAgentRuntimeEventLike): boolean;

package/dist/internal/personal-workbench/stores/domains/dataBindingRuntime.d.ts

@@ -0,0 +1,27 @@
+import type { MaterializedBlock, WorkbenchSnapshot } from '@fses/workbench-app/types';
+/** 判断 renderer series 是否包含数据。 */
+export declare function rendererSeriesHasValues(value: unknown): boolean;
+/** 判断 renderer data 是否已有可渲染 payload。 */
+export declare function rendererDataHasRenderablePayload(rendererData: Record<string, unknown>): boolean;
+/** 判断 binding 或 renderer 是否已有确认查询数据。 */
+export declare function dataBindingHasConfirmedPayload(bindingValue: unknown, rendererDataValue?: unknown): boolean;
+/** 判断 renderer data 是否包含 binding 生命周期 metadata。 */
+export declare function hasDataBindingRuntimeMetadata(value: unknown): boolean;
+/** 将 source 中缺失的 runtime 字段补到 target。 */
+export declare function fillMissingRuntimeFields(target: Record<string, unknown>, source: Record<string, unknown>, fields: string[]): void;
+/** 读取 binding id。 */
+export declare function dataBindingRuntimeId(value: unknown): string;
+/** 判断旧 metadata 是否可安全复制到 incoming。 */
+export declare function canPreserveRuntimeMetadata(previous: Record<string, unknown>, incoming: Record<string, unknown>): boolean;
+/** 判断 incoming 是否仍是失败状态。 */
+export declare function canPreserveRuntimeErrorMetadata(value: Record<string, unknown>): boolean;
+/** 读取 binding 生命周期状态。 */
+export declare function runtimeDataBindingStatus(value: Record<string, unknown>): string;
+/** 将仅由旧 metadata 复制出的 running 状态收敛到终态。 */
+export declare function normalizeImplicitRunningRuntimeMetadata(value: Record<string, unknown>): Record<string, unknown>;
+/** 判断卡片是否为手动替换占位卡。 */
+export declare function isRuntimeManualReplacementPlaceholder(block: MaterializedBlock): boolean;
+/** 保留单卡 sparse response 中省略的 data-binding metadata。 */
+export declare function preserveBlockDataBindingRuntimeMetadata(previous: MaterializedBlock | undefined, incoming: MaterializedBlock): MaterializedBlock;
+/** 保留 sparse snapshot 中同 ID 卡片的 data-binding metadata。 */
+export declare function preserveSnapshotDataBindingRuntimeMetadata(previousSnapshot: WorkbenchSnapshot | null, nextSnapshot: WorkbenchSnapshot): WorkbenchSnapshot;