@aotui/runtime 1.0.0

package/dist/engine/core/desktop.d.ts

@@ -0,0 +1,208 @@
+import type { IDesktop, DesktopID, AppID, ViewID, UpdateSignal, AppState, DesktopStatus, OperationPayload, IAppHostService, ISignalService, ILLMOutputChannelService, IRuntimeContext } from '../../spi/index.js';
+import { SignalBus, type SignalOutputStream } from './signal-bus.js';
+import { DesktopLogger, type LogEntry } from './desktop-logger.js';
+import { AppManager, type InstalledApp } from '../app/index.js';
+import { ViewManager } from '../view/index.js';
+import { RuntimeConfig } from '../../spi/config/index.js';
+export { SignalOutputStream } from './signal-bus.js';
+export { LogEntry } from './desktop-logger.js';
+export { InstalledApp } from '../app/index.js';
+/**
+ * Desktop 构造参数
+ *
+ * [Option B] 支持新的 Service 接口注入
+ */
+export interface DesktopOptions {
+    /** 使用外部 SignalBus (默认创建内部实例) - 向后兼容 */
+    signalBus?: SignalBus;
+    /** 使用外部 DesktopLogger (默认创建内部实例) */
+    logger?: DesktopLogger;
+    /** 使用外部 AppManager (默认创建内部实例) - 向后兼容 */
+    appManager?: AppManager;
+    /** 使用外部 ViewManager (默认创建内部实例) */
+    viewManager?: ViewManager;
+    /** [Option B] 使用外部 IAppHostService */
+    appHostService?: IAppHostService;
+    /** [Option B] 使用外部 ISignalService */
+    signalService?: ISignalService;
+    runtimeConfig?: RuntimeConfig;
+    /** 使用外部 ILLMOutputChannelService */
+    llmOutputChannelService?: ILLMOutputChannelService;
+    context?: IRuntimeContext;
+}
+export declare class Desktop implements IDesktop {
+    readonly id: DesktopID;
+    readonly createdAt: number;
+    readonly context?: IRuntimeContext;
+    private _status;
+    private _disposed;
+    private _isDraining;
+    private signalBus;
+    private logger;
+    private appManager;
+    private viewManager;
+    private appHostService;
+    private signalService;
+    private config;
+    private llmOutputChannel;
+    constructor(id?: DesktopID, options?: DesktopOptions);
+    get status(): DesktopStatus;
+    get output(): SignalOutputStream;
+    getLLMOutputChannel(): ILLMOutputChannelService;
+    broadcastLLMOutput(payload: {
+        reasoning?: string;
+        content?: string;
+    }, type: 'complete', meta?: {
+        model?: string;
+        providerId?: string;
+        modelId?: string;
+        usage?: {
+            promptTokens: number;
+            completionTokens: number;
+            totalTokens: number;
+        };
+    }): void;
+    openApp(appId: AppID): Promise<void>;
+    closeApp(appId: AppID): Promise<void>;
+    collapseApp(appId: AppID): Promise<void>;
+    showApp(appId: AppID): Promise<void>;
+    dismountView(appId: AppID, viewId: ViewID): Promise<void>;
+    hideView(appId: AppID, viewId: ViewID): Promise<void>;
+    showView(appId: AppID, viewId: ViewID): Promise<void>;
+    /**
+     * [RFC-006] Mount view via ViewLink
+     *
+     * Called when Agent uses V2 mount API: mount(parent_view, link_id)
+     */
+    mountViewByLink(appId: AppID, parentViewId: ViewID, linkId: string): Promise<void>;
+    /**
+     * Get Window object (for ViewManager)
+     */
+    /**
+     * [Worker-Only] Install Dynamic Worker App
+     *
+     * App runs in a dedicated Worker Thread via IPC.
+     */
+    installDynamicWorkerApp(appModulePath: string, options?: {
+        workerScriptPath?: string;
+        appId?: string;
+        name?: string;
+        /** [RFC-013] App description for Agent */
+        description?: string;
+        /** App 是什么 */
+        whatItIs?: string;
+        /** 什么时候用 */
+        whenToUse?: string;
+        config?: import('../../spi/app/app-config.interface.js').AppLaunchConfig;
+        /** [RFC-014] App Role */
+        promptRole?: 'user' | 'assistant';
+    }): Promise<string>;
+    /**
+     * [RFC-014] 注册待启动 App (懒加载)
+     */
+    registerPendingApp(options: {
+        appId?: string;
+        name?: string;
+        description?: string;
+        whatItIs?: string;
+        whenToUse?: string;
+        modulePath: string;
+        workerScriptPath?: string;
+        /** [RFC-014] App Role */
+        promptRole?: 'user' | 'assistant';
+    }): Promise<string>;
+    /**
+     * Get Snapshot Fragments from all Apps
+     *
+     * When Worker-Side Transformation is enabled, Worker executes Transformer directly.
+     * This method aggregates cached Markdown + IndexMap + ViewTree from all workers.
+     *
+     * [RFC-007] Added viewTree for Application View Tree section
+     *
+     * @returns Snapshot Fragments from all apps, or empty array
+     */
+    getSnapshotFragments(): {
+        appId: AppID;
+        markup: string;
+        indexMap: Record<string, unknown>;
+        views?: Array<{
+            viewId: ViewID;
+            viewType: string;
+            viewName?: string;
+            markup: string;
+            timestamp: number;
+        }>;
+        viewTree?: string;
+        timestamp?: number;
+    }[];
+    /**
+     * 获取 App 信息
+     * @param appId - App ID
+     * @returns App 信息 (name, etc.) 或 undefined
+     */
+    getAppInfo(appId: AppID): {
+        name?: string;
+    } | undefined;
+    /**
+     * 暂停 Desktop
+     * 会调用所有动态 App 的 onPause()
+     */
+    suspend(): Promise<void>;
+    /**
+     * 恢复 Desktop
+     * 会调用所有动态 App 的 onResume()
+     */
+    resume(): Promise<void>;
+    getAppStates(): AppState[];
+    /**
+     * 获取已安装应用列表 (用于 SnapshotBuilder)
+     */
+    getInstalledApps(): InstalledApp[];
+    /**
+     * Get System Logs (for <desktop> area)
+     */
+    getSystemLogs(): LogEntry[];
+    /**
+     * Get App Operation Logs (for <application> <info> area)
+     */
+    getAppOperationLogs(appId: AppID): LogEntry[];
+    /**
+     * Log System Message
+     */
+    logSystem(message: string, level?: 'info' | 'warn' | 'error'): void;
+    /**
+     * Log App Operation
+     */
+    logAppOperation(appId: AppID, message: string, level?: 'info' | 'warn' | 'error'): void;
+    /**
+     * 获取动态 App ID 列表（用于序列化恢复）
+     */
+    getDynamicAppIds(): AppID[];
+    /**
+     * [RFC-014] 等待所有 App 关闭完成
+     *
+     * 关闭所有 App 并等待 Worker 清理。
+     * 调用后 Desktop 进入 draining 状态。
+     */
+    drain(): Promise<void>;
+    /**
+     * [RFC-015] Delete Desktop
+     *
+     * 1. 触发 App onDelete 清理数据
+     * 2. 调用 drain 关闭 Worker
+     * 3. 清理 Desktop 资源
+     */
+    delete(): Promise<void>;
+    dispose(): Promise<void>;
+    /**
+     * Dispatch Operation to App Container
+     *
+     * Desktop is responsible for converting Operation Payload to DOM Events (or IPC messages)
+     * and sending them to the App.
+     *
+     * [Worker-Only] For WorkerSandbox, use IPC instead of CustomEvent
+     * [P0-1 FIX] Now returns the actual OperationResult from the Worker
+     */
+    dispatchOperation(appId: AppID, payload: OperationPayload): Promise<import('../../spi/index.js').OperationResult>;
+    emitSignal(reason: UpdateSignal['reason']): void;
+}

package/dist/engine/core/desktop.js

@@ -0,0 +1,351 @@
+import { createDesktopId, createSnapshotId, createOperationId } from '../../spi/index.js';
+import { AOTUIError, failedResult } from '../../spi/core/errors.js';
+import { SignalBus, createSignalOutputStream } from './signal-bus.js';
+import { DesktopLogger } from './desktop-logger.js';
+import { AppManager } from '../app/index.js';
+import { ViewManager } from '../view/index.js';
+import { LLMOutputChannelService } from './llm-output-channel.js';
+import { RUNTIME_DEFAULTS } from '../../spi/config/index.js';
+// Desktop now explicitly implements IDesktopDOM for type safety
+export class Desktop {
+    id;
+    createdAt;
+    // [RFC-026] Runtime Context
+    context;
+    _status = 'active';
+    _disposed = false;
+    _isDraining = false; // [RFC-014] Draining 状态标志
+    // Use injected SignalBus or create internal instance
+    signalBus;
+    // Use injected DesktopLogger or create internal instance
+    logger;
+    // Use injected AppManager or create internal instance
+    appManager;
+    // Use injected ViewManager or create internal instance
+    viewManager;
+    // [Option B] New Service interfaces
+    appHostService = null;
+    signalService = null;
+    config;
+    // [RFC-011] LLM Output Channel Service
+    llmOutputChannel;
+    constructor(id, options) {
+        this.id = id ?? createDesktopId();
+        this.createdAt = Date.now();
+        this.config = options?.runtimeConfig ?? RUNTIME_DEFAULTS;
+        this.context = options?.context;
+        // Desktop is Headless (No Mirror DOM)
+        // [Option B] 新 Service 接口注入
+        this.appHostService = options?.appHostService ?? null;
+        this.signalService = options?.signalService ?? null;
+        // 向后兼容: 使用 SignalBus 或从 SignalService 获取
+        if (options?.signalBus) {
+            this.signalBus = options.signalBus;
+        }
+        else if (this.signalService && this.signalService.getBus) {
+            this.signalBus = this.signalService.getBus();
+        }
+        else {
+            this.signalBus = new SignalBus();
+        }
+        this.logger = options?.logger || new DesktopLogger({
+            maxSystemLogs: this.config.logger.maxSystemLogs,
+            maxAppLogs: this.config.logger.maxAppLogs
+        });
+        this.appManager = options?.appManager || new AppManager(this);
+        this.viewManager = options?.viewManager || new ViewManager();
+        // [RFC-011] LLM Output Channel Service
+        this.llmOutputChannel = options?.llmOutputChannelService ?? new LLMOutputChannelService();
+        this.logSystem('Desktop initialized.');
+        if (this.context) {
+            this.logSystem(`Context injected: ${JSON.stringify(Object.keys(this.context.env))}`);
+        }
+    }
+    get status() {
+        return this._status;
+    }
+    // Delegate to SignalBus
+    get output() {
+        return createSignalOutputStream(this.signalBus, this.id);
+    }
+    // [RFC-011] Expose LLM Output Channel for Bridge access
+    getLLMOutputChannel() {
+        return this.llmOutputChannel;
+    }
+    // [RFC-011] Broadcast LLM text to all Workers
+    // [RFC-020] Now accepts structured payload
+    broadcastLLMOutput(payload, type, meta) {
+        this.appManager.broadcastLLMOutput(payload, type, meta);
+    }
+    // --- System Commands (App) ---
+    async openApp(appId) {
+        return this.appManager.openApp(appId);
+    }
+    async closeApp(appId) {
+        return this.appManager.closeApp(appId);
+    }
+    async collapseApp(appId) {
+        return this.appManager.collapseApp(appId);
+    }
+    async showApp(appId) {
+        return this.appManager.showApp(appId);
+    }
+    // --- System Commands (View) ---
+    // Delegate to ViewManager
+    async dismountView(appId, viewId) {
+        // [Worker-Only] Use IPC for Worker Apps
+        const sandbox = this.appManager.getWorkerSandbox(appId);
+        if (sandbox) {
+            await sandbox.dismountView(viewId);
+        }
+        else {
+            await this.viewManager.dismount(appId, viewId);
+        }
+        this.emitSignal('dom_mutation'); // Notify after view state change
+    }
+    async hideView(appId, viewId) {
+        await this.viewManager.hide(appId, viewId);
+        this.emitSignal('dom_mutation'); // Notify after view state change
+    }
+    async showView(appId, viewId) {
+        await this.viewManager.show(appId, viewId);
+        this.emitSignal('dom_mutation'); // Notify after view state change
+    }
+    /**
+     * [RFC-006] Mount view via ViewLink
+     *
+     * Called when Agent uses V2 mount API: mount(parent_view, link_id)
+     */
+    async mountViewByLink(appId, parentViewId, linkId) {
+        // [Worker-Only] Use IPC for Worker Apps
+        const sandbox = this.appManager.getWorkerSandbox(appId);
+        if (sandbox) {
+            await sandbox.mountViewByLink(parentViewId, linkId);
+        }
+        else {
+            // Non-worker apps: delegate to ViewManager (fallback)
+            await this.viewManager.mountByLink(appId, parentViewId, linkId);
+        }
+        this.emitSignal('dom_mutation'); // Notify after view state change
+    }
+    /**
+     * Get Window object (for ViewManager)
+     */
+    // --- Core Methods ---
+    /**
+     * [Worker-Only] Install Dynamic Worker App
+     *
+     * App runs in a dedicated Worker Thread via IPC.
+     */
+    async installDynamicWorkerApp(appModulePath, options) {
+        // [RFC-026] Merge Runtime Context into AppLaunchConfig
+        // Priority: App Specific Config > Runtime Context
+        // Note: We inject env vars from context into config.env if not present
+        let mergedConfig = options?.config;
+        if (this.context?.env) {
+            mergedConfig = mergedConfig || {};
+            // Inject all env vars from context
+            for (const [key, value] of Object.entries(this.context.env)) {
+                if (mergedConfig[key] === undefined) {
+                    mergedConfig[key] = value;
+                }
+            }
+        }
+        return this.appManager.install(appModulePath, {
+            workerScriptPath: options?.workerScriptPath, // Now optional, AppManager/AppWorkerHost will use default
+            appId: options?.appId,
+            name: options?.name,
+            description: options?.description, // [RFC-013]
+            whatItIs: options?.whatItIs,
+            whenToUse: options?.whenToUse,
+            config: mergedConfig, // [RFC-026] Injected Config
+            runtimeConfig: this.config, // [RFC-005] Pass Runtime Config
+            promptRole: options?.promptRole
+        });
+    }
+    /**
+     * [RFC-014] 注册待启动 App (懒加载)
+     */
+    async registerPendingApp(options) {
+        return this.appManager.registerPendingApp({
+            appId: options.appId,
+            name: options.name,
+            description: options.description,
+            whatItIs: options.whatItIs,
+            whenToUse: options.whenToUse,
+            modulePath: options.modulePath,
+            workerScriptPath: options.workerScriptPath,
+            promptRole: options.promptRole
+        });
+    }
+    /**
+     * Get Snapshot Fragments from all Apps
+     *
+     * When Worker-Side Transformation is enabled, Worker executes Transformer directly.
+     * This method aggregates cached Markdown + IndexMap + ViewTree from all workers.
+     *
+     * [RFC-007] Added viewTree for Application View Tree section
+     *
+     * @returns Snapshot Fragments from all apps, or empty array
+     */
+    getSnapshotFragments() {
+        if (this._disposed)
+            throw new AOTUIError('DESKTOP_DISPOSED', { desktopId: this.id });
+        const fragments = [];
+        for (const [appId, worker] of this.appManager.getAllWorkers()) {
+            const fragment = worker.getSnapshotFragment();
+            if (fragment) {
+                fragments.push({
+                    appId,
+                    markup: fragment.markup,
+                    indexMap: fragment.indexMap,
+                    views: fragment.views,
+                    viewTree: fragment.viewTree, // [RFC-007]
+                    timestamp: fragment.timestamp,
+                });
+            }
+        }
+        return fragments;
+    }
+    /**
+     * 获取 App 信息
+     * @param appId - App ID
+     * @returns App 信息 (name, etc.) 或 undefined
+     */
+    getAppInfo(appId) {
+        if (this._disposed)
+            throw new AOTUIError('DESKTOP_DISPOSED', { desktopId: this.id });
+        const worker = this.appManager.getAllWorkers().get(appId);
+        if (worker) {
+            return { name: worker.name };
+        }
+        return undefined;
+    }
+    // --- Lifecycle Methods ---
+    /**
+     * 暂停 Desktop
+     * 会调用所有动态 App 的 onPause()
+     */
+    async suspend() {
+        this._status = 'suspended';
+        this.signalBus.stopObserving(this.id);
+        await this.appManager.pauseAll();
+    }
+    /**
+     * 恢复 Desktop
+     * 会调用所有动态 App 的 onResume()
+     */
+    async resume() {
+        if (this._status === 'suspended') {
+            this._status = 'active';
+            await this.appManager.resumeAll();
+        }
+    }
+    getAppStates() {
+        return this.appManager.getAppStates();
+    }
+    /**
+     * 获取已安装应用列表 (用于 SnapshotBuilder)
+     */
+    getInstalledApps() {
+        return this.appManager.getInstalledApps();
+    }
+    /**
+     * Get System Logs (for <desktop> area)
+     */
+    getSystemLogs() {
+        return this.logger.getSystemLogs(this.id);
+    }
+    /**
+     * Get App Operation Logs (for <application> <info> area)
+     */
+    getAppOperationLogs(appId) {
+        return this.logger.getAppLogs(this.id, appId);
+    }
+    /**
+     * Log System Message
+     */
+    logSystem(message, level = 'info') {
+        this.logger.logSystem(this.id, message, level);
+    }
+    /**
+     * Log App Operation
+     */
+    logAppOperation(appId, message, level = 'info') {
+        this.logger.logApp(this.id, appId, message, level);
+    }
+    /**
+     * 获取动态 App ID 列表（用于序列化恢复）
+     */
+    getDynamicAppIds() {
+        return this.appManager.getDynamicAppIds();
+    }
+    /**
+     * [RFC-014] 等待所有 App 关闭完成
+     *
+     * 关闭所有 App 并等待 Worker 清理。
+     * 调用后 Desktop 进入 draining 状态。
+     */
+    async drain() {
+        if (this._disposed || this._isDraining)
+            return;
+        this._isDraining = true;
+        this.logSystem('Desktop draining: closing all apps...');
+        // 关闭所有 App（等待 Worker 清理）
+        await this.appManager.closeAll();
+        this.logSystem('Desktop drained: all apps closed.');
+    }
+    /**
+     * [RFC-015] Delete Desktop
+     *
+     * 1. 触发 App onDelete 清理数据
+     * 2. 调用 drain 关闭 Worker
+     * 3. 清理 Desktop 资源
+     */
+    async delete() {
+        if (this._disposed)
+            return;
+        this.logSystem('Desktop deleting: cleaning up app data...');
+        // 1. 触发 App 数据清理
+        await this.appManager.deleteAll();
+        // 2. 标记为 draining (避免重复 close)
+        this._isDraining = true;
+        // 3. 销毁 Desktop
+        await this.dispose();
+        this.logSystem('Desktop deleted.');
+    }
+    async dispose() {
+        if (this._disposed)
+            return;
+        // [RFC-014] 确保 drain 过
+        if (!this._isDraining) {
+            await this.drain();
+        }
+        this._disposed = true;
+        this.signalBus.cleanup(this.id);
+    }
+    // --- Internals ---
+    /**
+     * Dispatch Operation to App Container
+     *
+     * Desktop is responsible for converting Operation Payload to DOM Events (or IPC messages)
+     * and sending them to the App.
+     *
+     * [Worker-Only] For WorkerSandbox, use IPC instead of CustomEvent
+     * [P0-1 FIX] Now returns the actual OperationResult from the Worker
+     */
+    async dispatchOperation(appId, payload) {
+        const sandbox = this.appManager.getWorkerSandbox(appId);
+        if (!sandbox) {
+            return failedResult('APP_NOT_FOUND', { appId, desktopId: this.id });
+        }
+        // WorkerSandbox Mode: Dispatch operation via IPC
+        // [P0-1 FIX] Return the actual result from executeOperation
+        return await sandbox.executeOperation(createOperationId(payload.operation), payload.args || {}, createSnapshotId(payload.context.snapshotId || ''), payload.context.viewId);
+    }
+    // Delegate to SignalBus
+    emitSignal(reason) {
+        this.signalBus.emitSignal(this.id, reason);
+    }
+}
+//# sourceMappingURL=desktop.js.map

package/dist/engine/core/desktop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"desktop.js","sourceRoot":"","sources":["../../../src/engine/core/desktop.ts"],"names":[],"mappings":"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"}

package/dist/engine/core/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Core Domain
+ *
+ * 包含 Desktop 编排、信号总线及日志服务。
+ *
+ * @module @aotui/runtime/engine/core
+ */
+export { Desktop, type InstalledApp, type LogEntry } from './desktop.js';
+export { DesktopManager } from './manager.js';
+export { DesktopLogger, type DesktopLoggerOptions, type LogLevel } from './desktop-logger.js';
+export { SignalBus, createSignalOutputStream, type SignalListener, type SignalBusOptions, type SignalOutputStream } from './signal-bus.js';
+export { SignalServiceImpl } from './signal-service.js';

package/dist/engine/core/index.js

@@ -0,0 +1,28 @@
+/**
+ * Core Domain
+ *
+ * 包含 Desktop 编排、信号总线及日志服务。
+ *
+ * @module @aotui/runtime/engine/core
+ */
+// ============================================================================
+// Desktop - 核心编排
+// ============================================================================
+export { Desktop } from './desktop.js';
+// ============================================================================
+// DesktopManager - Desktop 工厂
+// ============================================================================
+export { DesktopManager } from './manager.js';
+// ============================================================================
+// DesktopLogger - 日志服务
+// ============================================================================
+export { DesktopLogger } from './desktop-logger.js';
+// ============================================================================
+// SignalBus - 信号总线
+// ============================================================================
+export { SignalBus, createSignalOutputStream } from './signal-bus.js';
+// ============================================================================
+// SignalService - ISignalService 实现 (Option B)
+// ============================================================================
+export { SignalServiceImpl } from './signal-service.js';
+//# sourceMappingURL=index.js.map

package/dist/engine/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAC/E,OAAO,EAAE,OAAO,EAAoC,MAAM,cAAc,CAAC;AAEzE,+EAA+E;AAC/E,8BAA8B;AAC9B,+EAA+E;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAC/E,OAAO,EAAE,aAAa,EAA4C,MAAM,qBAAqB,CAAC;AAE9F,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAC/E,OAAO,EACH,SAAS,EACT,wBAAwB,EAI3B,MAAM,iBAAiB,CAAC;AAEzB,+EAA+E;AAC/E,+CAA+C;AAC/C,+EAA+E;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/engine/core/llm-output-channel.d.ts

@@ -0,0 +1,45 @@
+/**
+ * LLMOutputChannelService - LLM 文本输出通道
+ *
+ * [RFC-011] LLM Output Output Channel
+ *
+ * 管理 Desktop 级别的 LLM 文本发布订阅。
+ * 支持历史缓冲，新订阅者可获取最近 N 条消息。
+ *
+ * 职责:
+ * - 管理 per-Desktop 的订阅者
+ * - 维护历史消息缓冲 (默认 3 条)
+ * - 在 Desktop cleanup 时释放资源
+ */
+import type { DesktopID } from '../../spi/core/types.js';
+import type { LLMOutputEvent, LLMOutputListener, LLMOutputEventMeta } from '../../spi/core/llm-output.js';
+import type { ILLMOutputChannelService } from '../../spi/runtime/llm-output-channel.interface.js';
+/**
+ * LLM 文本通道服务实现
+ */
+export declare class LLMOutputChannelService implements ILLMOutputChannelService {
+    private states;
+    /**
+     * 订阅 LLM 文本事件
+     *
+     * 订阅时立即推送历史消息。
+     */
+    subscribe(desktopId: DesktopID, listener: LLMOutputListener): () => void;
+    /**
+     * 推送 LLM 文本事件
+     * [RFC-020] 支持结构化 payload { reasoning?, content? }
+     */
+    push(desktopId: DesktopID, payload: {
+        reasoning?: string;
+        content?: string;
+    }, meta?: LLMOutputEventMeta): void;
+    /**
+     * 获取历史消息
+     */
+    getHistory(desktopId: DesktopID): LLMOutputEvent[];
+    /**
+     * 清理 Desktop 相关资源
+     */
+    cleanup(desktopId: DesktopID): void;
+    private getOrCreateState;
+}