@fses/workbench-app 0.2.18 → 0.2.20

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

@@ -0,0 +1,38 @@
+import { type MemoryRuntimeState } from './memoryRuntime';
+import type { WorkbenchStorageAdapter } from '../../../../adapters/types';
+export interface FdeCoreThreadSession {
+    eventsOpened: boolean;
+    eventsOpening?: Promise<void>;
+    eventsUrl?: string;
+    lastEventId?: string;
+    localConversationIds: Set<string>;
+    scopeKey: string;
+    threadId: string;
+}
+export interface FdeCoreSessionResources {
+    conversationAliasesByScope: Map<string, Map<string, string>>;
+    currentThreadSession: FdeCoreThreadSession | null;
+    pageThreadConversationIdsByScope: Map<string, Set<string>>;
+}
+export interface FdeRuntimeIdentityState extends MemoryRuntimeState {
+}
+/** 构建 FDE thread scope key。 */
+export declare function fdeThreadConversationScopeKey(state: Pick<FdeRuntimeIdentityState, 'appId' | 'tenantId' | 'userId' | 'workspaceId'>): string;
+/** 读取或创建当前 scope alias map。 */
+export declare function fdeCoreConversationAliasMap(resources: FdeCoreSessionResources, scopeKey: string): Map<string, string>;
+/** 记录本地 conversationId 对真实 threadId 的 alias。 */
+export declare function rememberFdeCoreConversationAlias(resources: FdeCoreSessionResources, scopeKey: string, localConversationId: string, threadId: string): void;
+/** 将本地 conversationId 解析为真实 FDE threadId。 */
+export declare function resolveFdeCoreConversationAlias(resources: FdeCoreSessionResources, scopeKey: string, conversationId: string): string;
+/** 创建或复用当前页面 FDE Core thread session。 */
+export declare function setCurrentFdeCoreThreadSession(resources: FdeCoreSessionResources, scopeKey: string, threadId: string): FdeCoreThreadSession;
+/** 清理当前页面 FDE Core thread session。 */
+export declare function clearCurrentFdeCoreThreadSession(resources: FdeCoreSessionResources, scopeKey?: string): void;
+/** 读取当前 scope 下已确认的 FDE thread IDs。 */
+export declare function readFdeThreadConversationIdsForScope(resources: FdeCoreSessionResources, scopeKey: string, userId: string | undefined, storage?: WorkbenchStorageAdapter): Set<string>;
+/** 判断 conversation 是否为当前 scope 已确认 thread。 */
+export declare function hasDeepAgentThreadConversationIdForCurrentScope(resources: FdeCoreSessionResources, state: Pick<FdeRuntimeIdentityState, 'appId' | 'tenantId' | 'userId' | 'workspaceId'>, conversationId: string, storage?: WorkbenchStorageAdapter): boolean;
+/** 分类 transcript 恢复错误。 */
+export declare function classifyConversationRestoreError(error: unknown): 'forbidden' | 'missing' | 'failed';
+/** 写入当前 scope 已确认的 FDE threadId。 */
+export declare function markFdeThreadConversationIdForStateScope(resources: FdeCoreSessionResources, state: FdeRuntimeIdentityState, conversationId: string, storage?: WorkbenchStorageAdapter): Record<string, string[]> | undefined;

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

@@ -0,0 +1,53 @@
+/**
+ * @fileoverview 工作台记忆 runtime domain - 管理记忆类型、capture scope 和 UI memory patch。
+ * @author seadon
+ * @created 2026-09-01
+ */
+import type { WorkbenchContext } from '../../lib/workbenchApi';
+import type { AgentMemoryScope, AgentMemoryType } from '../../lib/agentMemoryClient';
+import { type WorkbenchUiMemory } from '../../lib/workbenchStorage';
+import type { WorkbenchStorageAdapter } from '../../../../adapters/types';
+export interface MemoryRuntimeState {
+    appId: string;
+    currentConversationId: string;
+    fdeMode: boolean;
+    roleId: NonNullable<WorkbenchUiMemory['roleId']>;
+    tenantId: string;
+    userId: string;
+    workspaceId: string;
+}
+/** 判断字符串是否为记忆类型。 */
+export declare function isAgentMemoryType(value: string): value is AgentMemoryType;
+/**
+ * 归一化 trace 中的记忆类型。
+ * @param value - 候选类型。
+ * @returns API 接受的记忆类型。
+ */
+export declare function normalizeAgentMemoryType(value?: string): AgentMemoryType;
+/**
+ * 构建候选记忆保存作用域。
+ * @param scopeLevel - 候选作用域层级。
+ * @param context - 当前工作台上下文。
+ * @param conversationId - 当前对话 ID。
+ * @returns 记忆作用域。
+ */
+export declare function buildMemoryCaptureScope(scopeLevel: string | undefined, context: WorkbenchContext, conversationId?: string): AgentMemoryScope;
+/**
+ * 移除已经由独立 canvas settings 存储管理的字段。
+ * @param memory - UI memory。
+ * @returns 不含画布设置的 memory。
+ */
+export declare function stripCanvasSettingsMemory(memory: Partial<WorkbenchUiMemory> | null | undefined): Partial<WorkbenchUiMemory>;
+/**
+ * 构建当前 runtime conversation scope key。
+ * @param state - 最小运行态身份。
+ * @returns tenant/user/app/workspace/role/chatMode scope key。
+ */
+export declare function currentConversationScopeKeyFromState(state: Pick<MemoryRuntimeState, 'appId' | 'fdeMode' | 'roleId' | 'tenantId' | 'userId' | 'workspaceId'>): string;
+/**
+ * 合并 UI memory patch，并补当前作用域与会话。
+ * @param state - 当前运行态。
+ * @param patch - 待保存 patch。
+ * @returns 可整体写入的 UI memory。
+ */
+export declare function makeMemoryPatch(state: MemoryRuntimeState, patch?: Partial<WorkbenchUiMemory>, storage?: WorkbenchStorageAdapter): WorkbenchUiMemory;

package/dist/internal/personal-workbench/stores/workbenchRuntime.d.ts

@@ -8,6 +8,9 @@ import type { BusinessGroupContext } from '@fses/workbench-app/types';
 import { type CreateDeepAgentRunPayload, type DeepAgentAttachmentPayload } from '@workbench-internal/lib/deepAgentApi';
 import { type WorkbenchActionPayload, type WorkbenchChatRequestRefs } from '@workbench-internal/lib/workbenchApi';
 import type { SystemCardWorkbenchPromptParams } from '@workbench-internal/lib/workbenchSystemCardPrompt';
+import type { WorkbenchAgentTransportAdapter, WorkbenchEndpointResolver, WorkbenchPlatformRequestAdapter, WorkbenchRealtimeAdapter, WorkbenchStorageAdapter, WorkbenchTransportMode } from '../../../adapters';
+import { type WorkbenchCanvasBus } from '../../../canvas/bridge/workbenchCanvasBus';
+import { createWorkbenchSocketClient } from '@workbench-internal/lib/workbenchSocketClient';
 import { type FdeWorkbenchAssetPackage } from '@workbench-internal/lib/fdeWorkbenchAssetPackage';
 import type { AssistantPersonaKey, ConversationTurn, LayoutConfig, PlanResponse, RoleId, WorkbenchSnapshot, WorkbenchTemplate } from '@fses/workbench-app/types';
 import type { WorkbenchV2Document } from '@workbench-internal/types/workbenchV2';
@@ -100,6 +103,7 @@ interface PendingDeepAgentRequiredAction {
 export interface BuildWorkbenchDeepAgentRunPayloadInput {
     workbenches: WorkbenchTemplate[];
     resourceId?: string;
+    snapshotVersion?: number;
     workspaceId: string;
     appId?: string;
     businessGroup?: BusinessGroupContext;
@@ -161,5 +165,28 @@ export declare function buildWorkbenchResourceIdPayload(workbenches: WorkbenchTe
  * @returns 可直接传给 createDeepAgentRun/createDeepAgentThreadRun 的 payload。
  */
 export declare function buildWorkbenchDeepAgentRunPayload(input: BuildWorkbenchDeepAgentRunPayloadInput): CreateDeepAgentRunPayload;
-export declare const useWorkbenchRuntimeStore: StoreDefinition<'personal-workbench-runtime', WorkbenchRuntimeState, any, any>;
+export interface CreateWorkbenchRuntimeStoreDefinitionOptions {
+    agentTransportAdapter?: WorkbenchAgentTransportAdapter;
+    canvasBus?: WorkbenchCanvasBus;
+    endpointResolver?: WorkbenchEndpointResolver;
+    platformRequestAdapter?: WorkbenchPlatformRequestAdapter;
+    realtimeAdapter?: WorkbenchRealtimeAdapter;
+    socketClientFactory?: typeof createWorkbenchSocketClient;
+    storageAdapter?: WorkbenchStorageAdapter;
+    transportMode?: WorkbenchTransportMode;
+}
+/**
+ * 创建可独立挂载到 Pinia 的工作台 runtime store 定义。
+ * @param storeId - 当前实例稳定 store ID。
+ * @param options - 实例专属 Canvas bus 和 Socket client 工厂。
+ * @returns 保持现有 state/actions 合同的 Pinia store definition。
+ */
+export declare function createWorkbenchRuntimeStoreDefinition<TStoreId extends string>(storeId: TStoreId, options?: CreateWorkbenchRuntimeStoreDefinitionOptions): StoreDefinition<TStoreId, WorkbenchRuntimeState, any, any>;
+declare const useDefaultWorkbenchRuntimeStore: StoreDefinition<"personal-workbench-runtime", WorkbenchRuntimeState, any, any>;
+/**
+ * 读取当前组件树注入的 runtime store；脱离工作台宿主时回退到 legacy 默认 store。
+ * @param args - Pinia store 可选参数。
+ * @returns 当前实例 runtime store。
+ */
+export declare function useWorkbenchRuntimeStore(...args: Parameters<typeof useDefaultWorkbenchRuntimeStore>): ReturnType<typeof useDefaultWorkbenchRuntimeStore>;
 export {};

package/dist/kernel/command/createCommandRegistry.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview 工作台命令注册表 - 统一插件命令注册、查询和类型化执行入口。
+ * @author seadon
+ * @created 2026-08-31
+ */
+import type { WorkbenchCommandContribution, WorkbenchCommandExecutionContext, WorkbenchRegistrationHandle } from '../../plugin/types';
+import { type WorkbenchRegistry } from '../registry/createRegistry';
+export interface WorkbenchCommandRegistry {
+    execute<TResult = unknown>(id: string, payload?: unknown): Promise<TResult>;
+    has(id: string): boolean;
+    register(ownerId: string, contribution: WorkbenchCommandContribution): WorkbenchRegistrationHandle;
+}
+/**
+ * 创建实例级工作台命令注册表。
+ * @param executionContext - 命令执行时可读取的稳定宿主上下文。
+ * @param registry - 可选底层贡献注册表。
+ * @returns 命令注册与执行接口。
+ */
+export declare function createWorkbenchCommandRegistry(executionContext: WorkbenchCommandExecutionContext, registry?: WorkbenchRegistry<WorkbenchCommandContribution>): WorkbenchCommandRegistry;

package/dist/kernel/createWorkbenchHostContext.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @fileoverview 工作台宿主上下文工厂 - 为应用或 Feature Outlet 创建隔离微内核实例。
+ * @author seadon
+ * @created 2026-08-31
+ */
+import type { WorkbenchAppAdapters } from '../adapters/types';
+import type { WorkbenchServicePorts } from '../adapters/servicePorts';
+import type { WorkbenchAppConfig } from '../config/workbenchAppConfig';
+import type { WorkbenchExtensionInput, WorkbenchExtensionManifestV1 } from '../extensions/manifest';
+import type { WorkbenchPlugin } from '../plugin/types';
+import type { WorkbenchKernel } from './types';
+import type { WorkbenchRuntimeScope } from '../runtime/scope/createWorkbenchRuntimeScope';
+export interface WorkbenchHostDefinition {
+    adapters: Partial<WorkbenchAppAdapters>;
+    config: WorkbenchAppConfig;
+    extensions: WorkbenchExtensionInput;
+}
+export interface WorkbenchHostContext {
+    config: Readonly<WorkbenchAppConfig>;
+    dispose(): Promise<void>;
+    extensions: WorkbenchExtensionManifestV1;
+    instanceId: string;
+    kernel: WorkbenchKernel;
+    ready: Promise<void>;
+    runtime: WorkbenchRuntimeScope;
+    services: Readonly<WorkbenchServicePorts>;
+}
+export interface CreateWorkbenchHostContextOptions {
+    builtInPlugins?: ReadonlyArray<{
+        criticality: 'core' | 'optional';
+        plugin: WorkbenchPlugin;
+    }>;
+    disabledPluginIds?: readonly string[];
+    instanceId?: string;
+    strictRegistrations?: boolean;
+}
+/**
+ * 创建一个工作台组合根的实例级宿主上下文。
+ * @param host - 冻结宿主提供的 adapters、config 和 extensions。
+ * @param options - 内置插件、实例 ID、远程禁用项和注册严格度。
+ * @returns 可等待初始化并在卸载时统一销毁的宿主上下文。
+ */
+export declare function createWorkbenchHostContext(host: WorkbenchHostDefinition, options?: CreateWorkbenchHostContextOptions): WorkbenchHostContext;

package/dist/kernel/createWorkbenchKernel.d.ts

@@ -0,0 +1,7 @@
+import type { CreateWorkbenchKernelOptions, WorkbenchKernel } from './types';
+/**
+ * 创建一个实例级工作台微内核。
+ * @param options - 当前宿主配置、服务和注册严格度。
+ * @returns 插件管理器及全部稳定贡献注册表。
+ */
+export declare function createWorkbenchKernel(options?: CreateWorkbenchKernelOptions): WorkbenchKernel;

package/dist/kernel/diagnostics/createWorkbenchDiagnostics.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @fileoverview 工作台内核诊断 - 记录插件状态、贡献冲突和无敏感数据的告警摘要。
+ * @author seadon
+ * @created 2026-08-31
+ */
+export type WorkbenchPluginDiagnosticStatus = 'registered' | 'active' | 'disabled' | 'failed';
+export interface WorkbenchPluginDiagnostic {
+    id: string;
+    reason?: string;
+    status: WorkbenchPluginDiagnosticStatus;
+    version: string;
+}
+export interface WorkbenchContributionDiagnostic {
+    id: string;
+    ownerId: string;
+    reason?: string;
+    status: 'active' | 'conflict' | 'disabled';
+    type: string;
+}
+export interface WorkbenchKernelDiagnosticsSnapshot {
+    contributions: WorkbenchContributionDiagnostic[];
+    plugins: WorkbenchPluginDiagnostic[];
+    warnings: string[];
+}
+export interface WorkbenchDiagnostics {
+    recordContribution(diagnostic: WorkbenchContributionDiagnostic): void;
+    recordPlugin(diagnostic: WorkbenchPluginDiagnostic): void;
+    snapshot(): WorkbenchKernelDiagnosticsSnapshot;
+    warn(message: string): void;
+}
+/**
+ * 创建实例级内核诊断容器。
+ * @returns 只保存结构化摘要的诊断接口。
+ */
+export declare function createWorkbenchDiagnostics(): WorkbenchDiagnostics;

package/dist/kernel/event/createEventBus.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @fileoverview 工作台实例事件总线 - 隔离插件事件并提供可清理订阅。
+ * @author seadon
+ * @created 2026-08-31
+ */
+import type { WorkbenchRegistrationHandle } from '../../plugin/types';
+export interface WorkbenchEventBus {
+    emit(eventName: string, payload?: unknown): Promise<void>;
+    on(eventName: string, listener: (payload: unknown) => void | Promise<void>): WorkbenchRegistrationHandle;
+}
+/**
+ * 创建一个工作台实例专属事件总线。
+ * @param onListenerError - 监听器异常摘要回调。
+ * @returns 支持异步监听和取消订阅的事件总线。
+ */
+export declare function createWorkbenchEventBus(onListenerError?: (eventName: string, error: unknown) => void): WorkbenchEventBus;

package/dist/kernel/plugin/createPluginManager.d.ts

@@ -0,0 +1,7 @@
+import type { WorkbenchPluginManager, WorkbenchPluginManagerOptions } from './types';
+/**
+ * 创建实例级插件管理器。
+ * @param options - 插件上下文工厂和诊断容器。
+ * @returns 插件注册、初始化和销毁接口。
+ */
+export declare function createWorkbenchPluginManager(options: WorkbenchPluginManagerOptions): WorkbenchPluginManager;

package/dist/kernel/plugin/registrationScope.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @fileoverview 插件事务注册作用域 - 统一追踪 setup 期间创建的可清理资源。
+ * @author seadon
+ * @created 2026-08-31
+ */
+import type { WorkbenchRegistrationHandle } from '../../plugin/types';
+export interface WorkbenchRegistrationScope {
+    dispose(): void;
+    track(registration: WorkbenchRegistrationHandle): WorkbenchRegistrationHandle;
+}
+/**
+ * 创建插件事务注册作用域。
+ * @returns 可按逆序撤销所有注册句柄的作用域。
+ */
+export declare function createWorkbenchRegistrationScope(): WorkbenchRegistrationScope;

package/dist/kernel/plugin/types.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @fileoverview 插件管理器内部类型 - 区分可信注册来源和核心级别。
+ * @author seadon
+ * @created 2026-08-31
+ */
+import type { WorkbenchPlugin, WorkbenchPluginContext } from '../../plugin/types';
+import type { WorkbenchDiagnostics } from '../diagnostics/createWorkbenchDiagnostics';
+import type { WorkbenchRegistrationScope } from './registrationScope';
+export type WorkbenchPluginCriticality = 'core' | 'optional';
+export type WorkbenchPluginSource = 'built-in' | 'host';
+export interface WorkbenchPluginRegistration {
+    criticality: WorkbenchPluginCriticality;
+    plugin: WorkbenchPlugin;
+    source: WorkbenchPluginSource;
+}
+export interface WorkbenchPluginInitializeOptions {
+    disabledPluginIds?: readonly string[];
+}
+export interface WorkbenchPluginManagerOptions {
+    createContext(pluginId: string, scope: WorkbenchRegistrationScope): WorkbenchPluginContext;
+    diagnostics: WorkbenchDiagnostics;
+}
+export interface WorkbenchPluginManager {
+    dispose(): Promise<void>;
+    initialize(options?: WorkbenchPluginInitializeOptions): Promise<void>;
+    registerBuiltIn(plugin: WorkbenchPlugin, options: {
+        criticality: WorkbenchPluginCriticality;
+    }): void;
+    registerHost(plugin: WorkbenchPlugin): void;
+}

package/dist/kernel/registry/createRegistry.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @fileoverview 工作台通用贡献注册表 - 提供确定排序、冲突策略和可回滚注册句柄。
+ * @author seadon
+ * @created 2026-08-31
+ */
+export interface WorkbenchContributionBase {
+    id: string;
+    order?: number;
+    overridable?: boolean;
+}
+export interface WorkbenchRegistryEntry<TContribution extends WorkbenchContributionBase> {
+    contribution: TContribution;
+    ownerId: string;
+}
+export interface WorkbenchRegistryConflict<TContribution extends WorkbenchContributionBase> {
+    id: string;
+    existingOwnerId: string;
+    existingContribution: TContribution;
+    incomingOwnerId: string;
+    incomingContribution: TContribution;
+}
+export interface WorkbenchRegistryRegistration {
+    active: boolean;
+    dispose(): void;
+}
+export interface WorkbenchRegistry<TContribution extends WorkbenchContributionBase> {
+    clear(): void;
+    get(id: string): WorkbenchRegistryEntry<TContribution> | undefined;
+    has(id: string): boolean;
+    list(): Array<WorkbenchRegistryEntry<TContribution>>;
+    register(ownerId: string, contribution: TContribution): WorkbenchRegistryRegistration;
+}
+export interface WorkbenchRegistryOptions<TContribution extends WorkbenchContributionBase> {
+    duplicatePolicy?: 'preserve-first' | 'throw';
+    onConflict?: (conflict: WorkbenchRegistryConflict<TContribution>) => void;
+}
+/**
+ * 创建一个实例级贡献注册表。
+ * @param options - 重复 ID 策略和冲突回调。
+ * @returns 支持确定排序和回滚的贡献注册表。
+ */
+export declare function createWorkbenchRegistry<TContribution extends WorkbenchContributionBase>(options?: WorkbenchRegistryOptions<TContribution>): WorkbenchRegistry<TContribution>;

package/dist/kernel/registry/resolveSlotContributions.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @fileoverview 工作台 slot 贡献解析 - 逐项隔离条件错误并保留其他可见贡献。
+ * @author seadon
+ * @created 2026-08-31
+ */
+import type { WorkbenchSlotContribution } from '../../plugin/types';
+/**
+ * 解析一个语义 slot 当前可见的贡献列表。
+ * @param contributions - 已按 registry 规则排序的全部 slot 贡献。
+ * @param slotName - 当前语义 slot 名称。
+ * @param onConditionError - 单项 when 条件异常回调。
+ * @returns 当前 slot 可安全渲染的贡献。
+ */
+export declare function resolveWorkbenchSlotContributions(contributions: readonly WorkbenchSlotContribution[], slotName: string, onConditionError?: (contributionId: string, error: unknown) => void): WorkbenchSlotContribution[];

package/dist/kernel/types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @fileoverview 工作台微内核类型 - 汇总实例级注册表、命令、事件和插件生命周期。
+ * @author seadon
+ * @created 2026-08-31
+ */
+import type { WorkbenchAppAdapters } from '../adapters/types';
+import type { WorkbenchServicePorts } from '../adapters/servicePorts';
+import type { WorkbenchAppConfig } from '../config/workbenchAppConfig';
+import type { WorkbenchCapabilityContribution, WorkbenchCardContribution, WorkbenchDrawerContribution, WorkbenchPlugin, WorkbenchRouteContribution, WorkbenchSlotContribution } from '../plugin/types';
+import type { WorkbenchCommandRegistry } from './command/createCommandRegistry';
+import type { WorkbenchDiagnostics } from './diagnostics/createWorkbenchDiagnostics';
+import type { WorkbenchEventBus } from './event/createEventBus';
+import type { WorkbenchRuntimeScope } from '../runtime/scope/createWorkbenchRuntimeScope';
+import type { WorkbenchPluginCriticality, WorkbenchPluginInitializeOptions } from './plugin/types';
+import type { WorkbenchRegistry, WorkbenchRegistryRegistration } from './registry/createRegistry';
+export interface WorkbenchOwnedRegistry<TContribution extends {
+    id: string;
+    order?: number;
+    overridable?: boolean;
+}> {
+    get(id: string): ReturnType<WorkbenchRegistry<TContribution>['get']>;
+    has(id: string): boolean;
+    list(): ReturnType<WorkbenchRegistry<TContribution>['list']>;
+    register(ownerId: string, contribution: TContribution): WorkbenchRegistryRegistration;
+}
+export interface WorkbenchCapabilityRegistry extends WorkbenchOwnedRegistry<WorkbenchCapabilityContribution> {
+    isEnabled(id: string): boolean;
+}
+export interface WorkbenchKernel {
+    capabilities: WorkbenchCapabilityRegistry;
+    cards: WorkbenchOwnedRegistry<WorkbenchCardContribution>;
+    commands: WorkbenchCommandRegistry;
+    diagnostics: WorkbenchDiagnostics;
+    dispose(): Promise<void>;
+    drawers: WorkbenchOwnedRegistry<WorkbenchDrawerContribution>;
+    events: WorkbenchEventBus;
+    initialize(options?: WorkbenchPluginInitializeOptions): Promise<void>;
+    registerBuiltInPlugin(plugin: WorkbenchPlugin, options: {
+        criticality: WorkbenchPluginCriticality;
+    }): void;
+    registerHostPlugin(plugin: WorkbenchPlugin): void;
+    routes: WorkbenchOwnedRegistry<WorkbenchRouteContribution>;
+    runtime: WorkbenchRuntimeScope;
+    services: WorkbenchServicePorts;
+    slots: WorkbenchOwnedRegistry<WorkbenchSlotContribution>;
+}
+export interface CreateWorkbenchKernelOptions {
+    config?: WorkbenchAppConfig;
+    instanceId?: string;
+    services?: WorkbenchServicePorts | Partial<WorkbenchAppAdapters>;
+    strictRegistrations?: boolean;
+}

package/dist/kernel/workbenchHostContext.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @fileoverview 工作台宿主上下文注入 - 让包内组件读取最近的实例级微内核。
+ * @author seadon
+ * @created 2026-08-31
+ */
+import { type InjectionKey } from 'vue';
+import type { WorkbenchHostContext } from './createWorkbenchHostContext';
+export declare const WORKBENCH_HOST_CONTEXT_KEY: InjectionKey<WorkbenchHostContext>;
+/**
+ * 读取最近工作台组合根提供的实例级宿主上下文。
+ * @returns 当前 WorkbenchApplication 或 Feature Outlet 的宿主上下文。
+ * @throws 当组件未位于工作台组合根下时抛出错误。
+ */
+export declare function useWorkbenchHostContext(): WorkbenchHostContext;