@fses/workbench-app 0.2.17 → 0.2.20

package/dist/adapters/defaultAgentTransportAdapter.d.ts

@@ -0,0 +1,6 @@
+import type { WorkbenchAgentTransportAdapter } from './types';
+/**
+ * 复用现有平台请求链路的 Agent JSON/SSE 适配器。
+ * 该适配器不绑定具体 URL，业务端点由 endpoint resolver 或调用方传入。
+ */
+export declare const defaultWorkbenchAgentTransportAdapter: WorkbenchAgentTransportAdapter;

package/dist/adapters/defaultBrowserAdapters.d.ts

@@ -0,0 +1,22 @@
+import type { WorkbenchEndpointResolver, WorkbenchIdentityAdapter, WorkbenchRouterAdapter, WorkbenchStorageAdapter, WorkbenchUploadAdapter } from './types';
+/**
+ * 创建基于浏览器 History API 的默认路由适配器。
+ * @returns 浏览器路由适配器。
+ */
+export declare function createDefaultWorkbenchRouterAdapter(): WorkbenchRouterAdapter;
+/**
+ * 创建带内存回退的浏览器存储适配器。
+ * @returns 工作台存储适配器。
+ */
+export declare function createDefaultWorkbenchStorageAdapter(): WorkbenchStorageAdapter;
+/**
+ * 创建复用工作台可信 identity 接口的身份适配器。
+ * @param endpointResolver - 宿主 endpoint resolver。
+ * @returns 工作台身份适配器。
+ */
+export declare function createDefaultWorkbenchIdentityAdapter(endpointResolver: WorkbenchEndpointResolver): WorkbenchIdentityAdapter;
+/**
+ * 默认复用平台上传链路的文件适配器。
+ * 上传 URL 必须由调用方传入，避免在公共包内固化业务端点。
+ */
+export declare const defaultWorkbenchUploadAdapter: WorkbenchUploadAdapter;

package/dist/adapters/defaultPlatformRequestAdapter.d.ts

@@ -0,0 +1,6 @@
+import type { WorkbenchPlatformRequestAdapter } from './types';
+/**
+ * 复用现有 platformFetchClient 的平台请求适配器。
+ * 该适配器只在调用 requestJson 或 ensureSessionReady 时访问网络。
+ */
+export declare const defaultWorkbenchPlatformRequestAdapter: WorkbenchPlatformRequestAdapter;

package/dist/adapters/defaultRealtimeAdapter.d.ts

@@ -0,0 +1,6 @@
+import type { WorkbenchRealtimeAdapter } from './types';
+/**
+ * 复用现有工作台 Socket 客户端的实时适配器。
+ * `channel` 作为 API base URL，客户端会沿用现有 `/workbench` 路径、join、ACK 和去重语义。
+ */
+export declare const defaultWorkbenchRealtimeAdapter: WorkbenchRealtimeAdapter;

package/dist/adapters/endpointResolver.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @fileoverview 工作台 endpoint resolver - 将插件声明的 endpoint ID 解析为宿主配置路径。
+ * @author seadon
+ * @created 2026-08-31
+ */
+import type { WorkbenchEndpointResolver } from './types';
+export interface WorkbenchEndpointResolverOptions {
+    /** 宿主提供的 endpoint ID 到相对路径映射。 */
+    endpoints?: Record<string, string>;
+}
+/**
+ * 创建不绑定具体业务 API 的 endpoint resolver。
+ * @param options - endpoint 映射配置。
+ * @returns 可供 Service Ports 使用的 endpoint resolver。
+ */
+export declare function createWorkbenchEndpointResolver(options?: WorkbenchEndpointResolverOptions): WorkbenchEndpointResolver;

package/dist/adapters/index.d.ts

@@ -4,5 +4,11 @@
  * @created 2026-08-12
  */
 export * from './defaults';
+export * from './defaultAgentTransportAdapter';
+export * from './defaultBrowserAdapters';
+export * from './defaultPlatformRequestAdapter';
+export * from './defaultRealtimeAdapter';
+export * from './endpointResolver';
+export * from './servicePorts';
 export * from './testDoubles';
-export type { WorkbenchAgentTransportAdapter, WorkbenchAppAdapters, WorkbenchAssetAdapter, WorkbenchIdentityAdapter, WorkbenchIdentitySnapshot, WorkbenchLoggerAdapter, WorkbenchMessageAdapter, WorkbenchPlatformRequestAdapter, WorkbenchRouterAdapter, WorkbenchStorageAdapter, WorkbenchUploadAdapter, } from './types';
+export type { WorkbenchAgentTransportAdapter, WorkbenchAppAdapters, WorkbenchAssetAdapter, WorkbenchEndpointResolver, WorkbenchIdentityAdapter, WorkbenchIdentitySnapshot, WorkbenchLoggerAdapter, WorkbenchMessageAdapter, WorkbenchPlatformRequestAdapter, WorkbenchRealtimeAdapter, WorkbenchRealtimeConnection, WorkbenchRouterAdapter, WorkbenchStorageAdapter, WorkbenchUploadAdapter, } from './types';

package/dist/adapters/servicePorts.d.ts

@@ -0,0 +1,20 @@
+import type { WorkbenchAppAdapters, WorkbenchAssetAdapter, WorkbenchEndpointResolver, WorkbenchLoggerAdapter, WorkbenchMessageAdapter } from './types';
+export type WorkbenchServicePorts = Partial<WorkbenchAppAdapters> & {
+    assetAdapter: WorkbenchAssetAdapter;
+    endpointResolver: WorkbenchEndpointResolver;
+    loggerAdapter: WorkbenchLoggerAdapter;
+    messageAdapter: WorkbenchMessageAdapter;
+    transportMode: WorkbenchTransportMode;
+};
+export type WorkbenchTransportMode = 'adapter' | 'legacy';
+export declare const defaultWorkbenchEndpointResolver: WorkbenchEndpointResolver;
+export interface WorkbenchServicePortsOptions {
+    endpoints?: Record<string, string>;
+    transportMode?: WorkbenchTransportMode;
+}
+/**
+ * 将宿主 partial adapters 归一化为插件可安全读取的 Service Ports。
+ * @param adapters - 冻结宿主当前提供的适配器。
+ * @returns 保留宿主引用并补齐无网络默认实现的 Service Ports。
+ */
+export declare function createWorkbenchServicePorts(adapters: Partial<WorkbenchAppAdapters>, options?: WorkbenchServicePortsOptions): WorkbenchServicePorts;

package/dist/adapters/types.d.ts

@@ -28,9 +28,16 @@ export interface WorkbenchAgentTransportAdapter {
     openEventStream(config: {
         body?: unknown;
         headers?: Record<string, string>;
+        method?: string;
+        onError?: (error: Error) => void;
+        onOpen?: () => void;
+        openWhenHidden?: boolean;
+        lastEventId?: string;
         signal?: AbortSignal;
         url: string;
-        onEvent: (event: unknown) => void;
+        onEvent: (event: unknown, meta?: {
+            id?: string;
+        }) => void;
     }): Promise<void>;
     requestJson<T>(config: {
         body?: unknown;
@@ -44,6 +51,7 @@ export interface WorkbenchUploadAdapter {
     uploadFile(file: File | Blob, options?: {
         fileName?: string;
         signal?: AbortSignal;
+        url?: string;
     }): Promise<Record<string, unknown>>;
 }
 export interface WorkbenchRouterAdapter {
@@ -57,6 +65,7 @@ export interface WorkbenchStorageAdapter {
     setItem(key: string, value: string): void;
 }
 export interface WorkbenchAssetAdapter {
+    loadJson?<T>(path: string): Promise<T>;
     resolveAssetUrl(path: string): string;
 }
 export interface WorkbenchMessageAdapter {
@@ -71,13 +80,30 @@ export interface WorkbenchLoggerAdapter {
     info(message: string, payload?: unknown): void;
     warn(message: string, payload?: unknown): void;
 }
+export interface WorkbenchRealtimeConnection {
+    disconnect(): void;
+    requestSnapshot?(): void;
+}
+export interface WorkbenchRealtimeAdapter {
+    connect(config: {
+        channel: string;
+        onEvent(event: unknown): void | Promise<void>;
+        params?: Record<string, string>;
+        socketPath?: string;
+    }): WorkbenchRealtimeConnection;
+}
+export interface WorkbenchEndpointResolver {
+    resolve(endpointId: string, params?: Record<string, string | number | undefined>): string;
+}
 export interface WorkbenchAppAdapters {
     agentTransportAdapter: WorkbenchAgentTransportAdapter;
     assetAdapter?: WorkbenchAssetAdapter;
+    endpointResolver?: WorkbenchEndpointResolver;
     identityAdapter: WorkbenchIdentityAdapter;
     loggerAdapter?: WorkbenchLoggerAdapter;
     messageAdapter?: WorkbenchMessageAdapter;
     platformRequestAdapter: WorkbenchPlatformRequestAdapter;
+    realtimeAdapter?: WorkbenchRealtimeAdapter;
     routerAdapter: WorkbenchRouterAdapter;
     storageAdapter?: WorkbenchStorageAdapter;
     uploadAdapter: WorkbenchUploadAdapter;

package/dist/canvas/api/index.js

@@ -1,4 +1,4 @@
-import { c } from "../../canvasFacade-B8jYm_aO.js";
+import { c } from "../../canvasFacade-ZFqB_i7z.js";
 export {
   c as createCanvasApiFacade
 };

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

@@ -1,7 +1,19 @@
+/**
+ * @fileoverview 工作台 Canvas 事件总线 - 提供实例工厂并保留 legacy 单例兼容入口。
+ * @author seadon
+ * @created 2026-08-31
+ */
+import { type Emitter } from 'mitt';
 import type { CardMutationResult, InsertCardParams, UpdateCardParams } from '../api/types';
 export type WorkbenchCanvasBusEvents = {
     'workbench:card:insert': InsertCardParams;
     'workbench:card:update': UpdateCardParams;
     'workbench:card:mutation-result': CardMutationResult;
 };
-export declare const workbenchCanvasBus: import("mitt").Emitter<WorkbenchCanvasBusEvents>;
+export type WorkbenchCanvasBus = Emitter<WorkbenchCanvasBusEvents>;
+/**
+ * 创建实例级 Canvas 事件总线。
+ * @returns 与 legacy 总线事件合同一致的新总线实例。
+ */
+export declare function createWorkbenchCanvasBus(): WorkbenchCanvasBus;
+export declare const workbenchCanvasBus: WorkbenchCanvasBus;

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

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

package/dist/{canvasFacade-B8jYm_aO.js → canvasFacade-ZFqB_i7z.js}

@@ -1,4 +1,4 @@
-import { d as u, L as Kt, a as rt, r as zt, l as Vt, b as qt } from "./cardFactory-DmEBcCf4.js";
+import { d as u, L as Kt, c as rt, r as zt, l as Vt, a as qt } from "./cardFactory-D5dyYSC3.js";
 const Et = [
   { id: "card.header.left", kind: "slot", status: "active", displayName: "Card header left slot", userFacingName: u("FWA.ff101787571029524"), description: u("FWA.cc9c1787570656561"), riskLevel: "low", sideEffects: [] },
   { id: "card.header.right", kind: "slot", status: "active", displayName: "Card header right slot", userFacingName: u("FWA.28db1787571030051"), description: u("FWA.eed41787570610595"), riskLevel: "low", sideEffects: [] },