@aotui/runtime 1.0.0

package/dist/spi/runtime/desktop-dom.interface.js

@@ -0,0 +1,13 @@
+/**
+ * SPI Layer - IDesktopDOM Interface
+ *
+ * [C2 FIX] 从 AppManager 提取的接口，定义 Engine 层模块与 Desktop 交互的最小契约。
+ *
+ * 设计原则:
+ * - Interface Segregation: 只暴露 AppManager 等模块真正需要的方法
+ * - Stable Dependency: Engine 层模块依赖此 SPI 接口，而非具体 Desktop 实现
+ *
+ * @module @aotui/runtime/spi
+ */
+export {};
+//# sourceMappingURL=desktop-dom.interface.js.map

package/dist/spi/runtime/desktop-dom.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"desktop-dom.interface.js","sourceRoot":"","sources":["../../../src/spi/runtime/desktop-dom.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/spi/runtime/desktop-lifecycle.interface.d.ts

@@ -0,0 +1,23 @@
+import type { DesktopID } from '../core/types.js';
+/**
+ * Desktop 生命周期控制接口
+ *
+ * 职责: 暂停/恢复 Desktop
+ * 消费者: Kernel
+ *
+ * 可替换场景: 不同的暂停策略 (冷冻内存/序列化到磁盘)
+ */
+export interface IDesktopLifecycleController {
+    /**
+     * 暂停 Desktop
+     *
+     * 会调用所有动态 App 的 onPause()
+     */
+    suspend(desktopId: DesktopID): Promise<void>;
+    /**
+     * 恢复 Desktop
+     *
+     * 会调用所有动态 App 的 onResume()
+     */
+    resume(desktopId: DesktopID): Promise<void>;
+}

package/dist/spi/runtime/desktop-lifecycle.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=desktop-lifecycle.interface.js.map

package/dist/spi/runtime/desktop-lifecycle.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"desktop-lifecycle.interface.js","sourceRoot":"","sources":["../../../src/spi/runtime/desktop-lifecycle.interface.ts"],"names":[],"mappings":""}

package/dist/spi/runtime/desktop-lock.interface.d.ts

@@ -0,0 +1,50 @@
+import type { DesktopID } from '../core/types.js';
+/**
+ * 锁状态信息
+ */
+export interface LockInfo {
+    /** 锁持有者 ID */
+    ownerId: string;
+    /** 锁获取时间戳 */
+    acquiredAt: number;
+    /** 锁是否有效 (未过期) */
+    valid: boolean;
+}
+/**
+ * Desktop 锁服务接口
+ *
+ * 职责: 并发控制，防止多 Agent 同时操作同一 Desktop
+ * 消费者: Kernel (验证/刷新), Bridge (获取/释放)
+ *
+ * 可替换场景: 分布式锁实现 (Redis/Zookeeper)
+ */
+export interface IDesktopLockService {
+    /**
+     * 获取 Desktop 写锁
+     *
+     * - 支持重入: 同一 owner 多次获取会刷新时间戳
+     * - 锁过期时: 允许新 owner 接管
+     *
+     * @throws {AOTUIError} DESKTOP_LOCKED 如果已被其他 owner 锁定且未过期
+     */
+    acquireLock(desktopId: DesktopID, ownerId: string): void;
+    /**
+     * 释放 Desktop 写锁
+     * 仅锁持有者可释放，其他人调用静默忽略
+     */
+    releaseLock(desktopId: DesktopID, ownerId: string): void;
+    /**
+     * 验证锁所有权
+     * @returns true 如果 ownerId 持有有效锁
+     */
+    verifyLock(desktopId: DesktopID, ownerId: string): boolean;
+    /**
+     * 刷新锁时间戳
+     * 防止长时间操作导致锁过期
+     */
+    refreshLock(desktopId: DesktopID, ownerId: string): void;
+    /**
+     * 获取锁信息 (用于调试/监控)
+     */
+    getLockInfo(desktopId: DesktopID): LockInfo | undefined;
+}

package/dist/spi/runtime/desktop-lock.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=desktop-lock.interface.js.map

package/dist/spi/runtime/desktop-lock.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"desktop-lock.interface.js","sourceRoot":"","sources":["../../../src/spi/runtime/desktop-lock.interface.ts"],"names":[],"mappings":""}

package/dist/spi/runtime/desktop-manager.interface.d.ts

@@ -0,0 +1,22 @@
+/**
+ * SPI Layer - Desktop Manager Interface (Composition)
+ *
+ * 管理 Desktop 实例的完整生命周期和并发控制。
+ *
+ * [RFC-004] Interface Composition:
+ * IDesktopManager 现在是一个组合类型，由 5 个聚焦的原子接口组成。
+ * 这允许未来的实现按需拆分，同时保持对现有消费者的向后兼容。
+ *
+ * @module @aotui/runtime/spi
+ */
+export type { LockInfo } from './desktop-lock.interface.js';
+import type { IDesktopRepository } from './desktop-repository.interface.js';
+import type { IDesktopLockService } from './desktop-lock.interface.js';
+import type { IAppInstaller } from './app-installer.interface.js';
+import type { IDesktopStateAccessor } from './desktop-state-accessor.interface.js';
+import type { IDesktopLifecycleController } from './desktop-lifecycle.interface.js';
+import type { DesktopID } from '../core/index.js';
+import type { IRuntimeContext } from './context.interface.js';
+export interface IDesktopManager extends IDesktopRepository, IDesktopLockService, IAppInstaller, IDesktopStateAccessor, IDesktopLifecycleController {
+    create(desktopId?: DesktopID, context?: IRuntimeContext): Promise<DesktopID>;
+}

package/dist/spi/runtime/desktop-manager.interface.js

@@ -0,0 +1,13 @@
+/**
+ * SPI Layer - Desktop Manager Interface (Composition)
+ *
+ * 管理 Desktop 实例的完整生命周期和并发控制。
+ *
+ * [RFC-004] Interface Composition:
+ * IDesktopManager 现在是一个组合类型，由 5 个聚焦的原子接口组成。
+ * 这允许未来的实现按需拆分，同时保持对现有消费者的向后兼容。
+ *
+ * @module @aotui/runtime/spi
+ */
+export {};
+//# sourceMappingURL=desktop-manager.interface.js.map

package/dist/spi/runtime/desktop-manager.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"desktop-manager.interface.js","sourceRoot":"","sources":["../../../src/spi/runtime/desktop-manager.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/spi/runtime/desktop-repository.interface.d.ts

@@ -0,0 +1,8 @@
+import type { DesktopID } from '../core/index.js';
+import type { IRuntimeContext } from './context.interface.js';
+export interface IDesktopRepository {
+    create(desktopId?: DesktopID, context?: IRuntimeContext): Promise<DesktopID>;
+    destroy(desktopId: DesktopID): Promise<void>;
+    has(desktopId: DesktopID): boolean;
+    get(desktopId: DesktopID): import('./kernel.interface.js').IDesktop | undefined;
+}

package/dist/spi/runtime/desktop-repository.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=desktop-repository.interface.js.map

package/dist/spi/runtime/desktop-repository.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"desktop-repository.interface.js","sourceRoot":"","sources":["../../../src/spi/runtime/desktop-repository.interface.ts"],"names":[],"mappings":""}

package/dist/spi/runtime/desktop-state-accessor.interface.d.ts

@@ -0,0 +1,22 @@
+import type { DesktopID, AppState, DesktopStatus } from '../core/types.js';
+/**
+ * Desktop 状态访问接口
+ *
+ * 职责: 只读访问 Desktop 和 App 状态
+ * 消费者: Kernel (序列化)
+ *
+ * 可替换场景: 缓存层、远程状态存储
+ */
+export interface IDesktopStateAccessor {
+    /**
+     * 获取 App 状态列表 (用于序列化)
+     */
+    getAppStates(desktopId: DesktopID): AppState[];
+    /**
+     * 获取 Desktop 状态信息 (用于序列化)
+     */
+    getDesktopInfo(desktopId: DesktopID): {
+        status: DesktopStatus;
+        createdAt: number;
+    } | undefined;
+}

package/dist/spi/runtime/desktop-state-accessor.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=desktop-state-accessor.interface.js.map

package/dist/spi/runtime/desktop-state-accessor.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"desktop-state-accessor.interface.js","sourceRoot":"","sources":["../../../src/spi/runtime/desktop-state-accessor.interface.ts"],"names":[],"mappings":""}

package/dist/spi/runtime/dispatcher.interface.d.ts

@@ -0,0 +1,34 @@
+/**
+ * SPI - IDispatcher Interface
+ *
+ * Defines the contract for operation dispatching.
+ * The Kernel depends on this interface, not on concrete implementations.
+ *
+ * @module @aotui/runtime/spi/runtime
+ */
+import type { IDesktop, IRegistry } from './kernel.interface.js';
+import type { Operation, OperationResult } from '../core/index.js';
+/**
+ * Dispatcher Interface
+ *
+ * Dispatches operations to the target application.
+ * Handles argument resolution and delegates transport to Desktop.
+ *
+ * @example
+ * ```typescript
+ * const dispatcher: IDispatcher = new Dispatcher();
+ * const result = await dispatcher.dispatch(desktop, operation, registry);
+ * console.log(result.success); // true or false
+ * ```
+ */
+export interface IDispatcher {
+    /**
+     * Dispatches an operation to the target application
+     *
+     * @param desktop - The Desktop instance containing the target app
+     * @param operation - The Operation to dispatch
+     * @param registry - The SnapshotRegistry for argument resolution
+     * @returns The result of the operation execution
+     */
+    dispatch(desktop: IDesktop, operation: Operation, registry: IRegistry): Promise<OperationResult>;
+}

package/dist/spi/runtime/dispatcher.interface.js

@@ -0,0 +1,10 @@
+/**
+ * SPI - IDispatcher Interface
+ *
+ * Defines the contract for operation dispatching.
+ * The Kernel depends on this interface, not on concrete implementations.
+ *
+ * @module @aotui/runtime/spi/runtime
+ */
+export {};
+//# sourceMappingURL=dispatcher.interface.js.map

package/dist/spi/runtime/dispatcher.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.interface.js","sourceRoot":"","sources":["../../../src/spi/runtime/dispatcher.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/spi/runtime/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * SPI Runtime Layer - Internal Interfaces
+ *
+ * Runtime 内部使用的接口，不对外公开。
+ * Product Layer 和 Runtime Engine 使用这些接口。
+ *
+ * @module @aotui/runtime/spi/runtime
+ * @internal
+ */
+export type { IDesktop, IRegistry, IKernel, ShutdownOptions, } from './kernel.interface.js';
+export type { IDesktopManager, LockInfo, } from './desktop-manager.interface.js';
+export type { IDesktopRepository } from './desktop-repository.interface.js';
+export type { IDesktopLockService } from './desktop-lock.interface.js';
+export type { IAppInstaller } from './app-installer.interface.js';
+export type { IDesktopStateAccessor } from './desktop-state-accessor.interface.js';
+export type { IDesktopLifecycleController } from './desktop-lifecycle.interface.js';
+export type { IDesktopDOM } from './desktop-dom.interface.js';
+export type { IWorkerRuntime, WorkerRuntimeConfig, WorkerDOMEnvironment, WorkerMessage, IAppAdapter, AppAdapterMountResult, } from './worker-runtime.interface.js';
+export type { RequestID, WorkerMessageType, IWorkerMessage, IWorkerRequest, IWorkerResponse, IWorkerError, } from './worker-message.interface.js';
+export { generateRequestId, isWorkerResponse, isWorkerRequest, isDomUpdateMessage, isWorkerPush, } from './worker-message.interface.js';
+export type { ITransformer, TransformResult } from './transformer.interface.js';
+export type { IDispatcher } from './dispatcher.interface.js';
+export type { IAppHostService, SnapshotFragment, AppInstallOptions, } from './app-host.interface.js';
+export type { ISignalService, ISignalOutputStream, SignalListener, } from './signal.interface.js';
+export type { DesktopContext, DesktopContextFactory, } from './desktop-context.interface.js';
+export type { IRuntimeContext } from './context.interface.js';
+export type { InstalledAppInfo, LogEntry, IDesktopMetadata, ISnapshotFragment, FormattedSnapshotResult, ISnapshotFormatter, } from './snapshot.interface.js';
+export type { ILLMOutputChannelService } from './llm-output-channel.interface.js';

package/dist/spi/runtime/index.js

@@ -0,0 +1,11 @@
+/**
+ * SPI Runtime Layer - Internal Interfaces
+ *
+ * Runtime 内部使用的接口，不对外公开。
+ * Product Layer 和 Runtime Engine 使用这些接口。
+ *
+ * @module @aotui/runtime/spi/runtime
+ * @internal
+ */
+export { generateRequestId, isWorkerResponse, isWorkerRequest, isDomUpdateMessage, isWorkerPush, } from './worker-message.interface.js';
+//# sourceMappingURL=index.js.map

package/dist/spi/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/spi/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA6DH,OAAO,EACH,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,YAAY,GACf,MAAM,+BAA+B,CAAC"}

package/dist/spi/runtime/kernel.interface.d.ts

@@ -0,0 +1,221 @@
+/**
+ * SPI Layer - Kernel Interfaces
+ *
+ * 定义 Kernel、Desktop、Registry 的契约。
+ */
+import type { SnapshotID, DesktopID, AppID, ViewID, DataPayload, IndexMap, DesktopState } from '../core/types.js';
+import type { Tool } from '../core/tool-call.js';
+import type { Operation, OperationResult, OperationPayload } from '../core/operations.js';
+import type { UpdateSignal } from '../core/signals.js';
+import type { CachedSnapshot } from '../core/snapshot.js';
+import type { IRuntimeContext } from './context.interface.js';
+/**
+ * Desktop 接口
+ *
+ * [Worker-Only] 隔离的运行时沙箱，托管多个 App。
+ * 所有 App 运行在独立的 Worker Thread 中。
+ */
+export interface IDesktop {
+    id: DesktopID;
+    /**
+     * [Worker-Only] 安装 App
+     *
+     * App 运行在独立的 Worker Thread 中。
+     *
+     * [C1 Fix] workerScriptPath 现在是可选的，默认使用 Runtime 内置的 worker-runtime
+     */
+    installDynamicWorkerApp(appModulePath: string, options?: {
+        workerScriptPath?: string;
+        appId?: string;
+        name?: string;
+        /** [RFC-013] App description for Agent */
+        description?: string;
+        whatItIs?: string;
+        whenToUse?: string;
+        config?: import('../app/app-config.interface.js').AppLaunchConfig;
+        promptRole?: 'user' | 'assistant';
+    }): Promise<string>;
+    /**
+     * [RFC-014] 注册待启动 App (懒加载)
+     *
+     * App 信息写入 installedApps，但不启动 Worker。
+     * Agent 可以在 Snapshot 中看到这些 App，并通过 open_app 启动。
+     */
+    registerPendingApp(options: {
+        appId?: string;
+        name?: string;
+        description?: string;
+        whatItIs?: string;
+        whenToUse?: string;
+        modulePath: string;
+        workerScriptPath?: string;
+        promptRole?: 'user' | 'assistant';
+    }): Promise<string>;
+    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>;
+    mountViewByLink(appId: AppID, parentViewId: ViewID, linkId: string): Promise<void>;
+    /**
+     * 分发操作到应用容器
+     *
+     * [C2 Refactor] 替代 Dispatcher 直接操作 DOM
+     * Desktop 负责将操作载荷转换为 DOM 事件并发送给 App。
+     *
+     * @param appId - 目标 App ID
+     * @param payload - 操作载荷
+     * @returns 操作执行结果
+     */
+    dispatchOperation(appId: AppID, payload: OperationPayload): Promise<OperationResult>;
+    output: {
+        subscribe(listener: (signal: UpdateSignal) => void): void;
+        unsubscribe(listener: (signal: UpdateSignal) => void): void;
+    };
+    /**
+     * [RFC-001] 获取所有 App 的 Snapshot Fragments
+     *
+     * 当 Worker-Side Transformation 启用时，Worker 直接执行 Transformer，
+     * 此方法返回所有 App 的缓存 Markdown + IndexMap + ViewTree。
+     *
+     * [RFC-007] Added viewTree for Application View Tree section
+     *
+     * @returns 所有 App 的 Snapshot Fragments
+     */
+    getSnapshotFragments(): {
+        appId: AppID;
+        markup: string;
+        indexMap: Record<string, unknown>;
+        views?: Array<{
+            viewId: ViewID;
+            viewType: string;
+            viewName?: string;
+            markup: string;
+            timestamp: number;
+        }>;
+        viewTree?: string;
+    }[];
+    /**
+     * 获取 App 信息
+     * @param appId - App ID
+     * @returns App 信息 (name, etc.) 或 undefined
+     */
+    getAppInfo?(appId: AppID): {
+        name?: string;
+    } | undefined;
+    /**
+     * 等待所有活动 Worker 结束
+     *
+     * 用于 Graceful Shutdown
+     */
+    drain(): Promise<void>;
+    /**
+     * [RFC-015] 删除 Desktop
+     *
+     * 1. 调用所有 App 的 onDelete() (清理持久化数据)
+     * 2. 调用 drain() (关闭 Worker)
+     * 3. 清理资源
+     */
+    delete(): Promise<void>;
+}
+/**
+     * Registry 接口
+     *
+     * 管理 Snapshot 的存储和生命周期。
+     */
+export interface IRegistry {
+    /**
+     * 创建并注册新快照
+     *
+     * @param indexMap - 索引映射
+     * @param markup - 完整的 Markdown 内容 (向后兼容)
+     * @param ttl - 可选的生存时间
+     * @param structured - [RFC-014] 可选的结构化快照
+     */
+    create(indexMap: IndexMap, markup: string, ttl?: number, structured?: import('../core/snapshot.js').StructuredSnapshot): CachedSnapshot;
+    retain(id: SnapshotID): void;
+    release(id: SnapshotID): void;
+    resolve(id: SnapshotID, path: string): DataPayload | undefined;
+}
+/**
+ * Kernel 接口
+ *
+ * Runtime 的核心编排器。
+ */
+export interface IKernel {
+    createDesktop(desktopId?: DesktopID, context?: IRuntimeContext): Promise<DesktopID>;
+    destroyDesktop(desktopId: DesktopID): Promise<void>;
+    /**
+     * [Worker-Only] 安装 App
+     *
+     * @param desktopId - 目标桌面 ID
+     * @param appModulePath - App 模块路径
+     * @param workerScriptPath - Worker 脚本路径 (可选，默认使用 Runtime 内置)
+     * @param options - 可选配置
+     * @returns 分配的 appId
+     *
+     * [C1 Fix] workerScriptPath 现在是可选的
+     */
+    installDynamicWorkerApp(desktopId: DesktopID, appModulePath: string, options?: {
+        workerScriptPath?: string;
+        appId?: string;
+        name?: string;
+        /** [RFC-013] App description for Agent */
+        description?: string;
+        config?: import('../app/app-config.interface.js').AppLaunchConfig;
+        promptRole?: 'user' | 'assistant';
+    }): Promise<string>;
+    /**
+     * 获取 Desktop 实例
+     * @throws {Error} E_NOT_FOUND if Desktop doesn't exist
+     */
+    getDesktop(desktopId: DesktopID): IDesktop;
+    acquireLock(desktopId: DesktopID, ownerId: string): void;
+    releaseLock(desktopId: DesktopID, ownerId: string): void;
+    acquireSnapshot(desktopId: DesktopID, ttl?: number): Promise<CachedSnapshot>;
+    releaseSnapshot(snapshotId: SnapshotID): void;
+    /**
+     * 执行操作
+     *
+     * @param desktopId - 目标 Desktop
+     * @param operation - 操作对象
+     * @param ownerId - 锁持有者 ID
+     */
+    execute(desktopId: DesktopID, operation: Operation, ownerId: string): Promise<OperationResult>;
+    /**
+     * 获取系统工具定义
+     */
+    getSystemToolDefinitions(): Tool[];
+    suspend(desktopId: DesktopID): Promise<void>;
+    resume(desktopId: DesktopID): Promise<void>;
+    serialize(desktopId: DesktopID): DesktopState;
+    /**
+     * [RFC-014] 优雅关闭 Desktop
+     *
+     * 1. 调用 Desktop.drain() 等待 App 清理
+     * 2. 执行 beforeClose 回调（如持久化）
+     * 3. 销毁 Desktop
+     *
+     * @param desktopId - Desktop ID
+     * @param options - 关闭选项
+     */
+    gracefulShutdown(desktopId: DesktopID, options?: ShutdownOptions): Promise<void>;
+    /**
+     * [RFC-015] 删除 Desktop
+     *
+     * 永久销毁 Desktop 及其所有数据。
+     * 会触发 App 的 onDelete 生命周期钩子。
+     */
+    deleteDesktop(desktopId: DesktopID): Promise<void>;
+}
+/**
+ * [RFC-014] 优雅关闭选项
+ */
+export interface ShutdownOptions {
+    /** 超时时间(ms)，默认 30000 */
+    timeoutMs?: number;
+    /** 关闭前回调 */
+    beforeClose?: () => Promise<void>;
+}

package/dist/spi/runtime/kernel.interface.js

@@ -0,0 +1,7 @@
+/**
+ * SPI Layer - Kernel Interfaces
+ *
+ * 定义 Kernel、Desktop、Registry 的契约。
+ */
+export {};
+//# sourceMappingURL=kernel.interface.js.map

package/dist/spi/runtime/kernel.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel.interface.js","sourceRoot":"","sources":["../../../src/spi/runtime/kernel.interface.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/spi/runtime/llm-output-channel.interface.d.ts

@@ -0,0 +1,81 @@
+/**
+ * SPI Layer - LLM Output Channel Service Interface
+ *
+ * [RFC-011] LLM Output Output Channel
+ *
+ * 管理 Desktop 级别的 LLM 文本发布订阅。
+ * 每个 Desktop 有独立的通道，支持历史缓冲。
+ *
+ * @module @aotui/runtime/spi
+ */
+import type { DesktopID } from '../core/types.js';
+import type { LLMOutputEvent, LLMOutputListener, LLMOutputEventMeta } from '../core/llm-output.js';
+/**
+ * LLM Output Channel Service 接口
+ *
+ * 管理 Desktop 级别的 LLM 文本发布订阅。
+ *
+ * 设计原则:
+ * - Opt-in: Apps 按需订阅，不关心则无开销
+ * - Desktop 隔离: 每个 Desktop 有独立的通道
+ * - 历史支持: 新订阅者可获取最近 N 条消息
+ *
+ * @example
+ * ```typescript
+ * const service: ILLMOutputChannelService = new LLMOutputChannelService();
+ *
+ * // 订阅
+ * const unsubscribe = service.subscribe(desktopId, (event) => {
+ *     console.log('LLM said:', event.content);
+ * });
+ *
+ * // 推送 (由 AgentDriver 调用)
+ * service.push(desktopId, 'Thinking...', 'complete');
+ *
+ * // 取消订阅
+ * unsubscribe();
+ * ```
+ */
+export interface ILLMOutputChannelService {
+    /**
+     * 订阅 LLM 文本事件
+     *
+     * 订阅时会立即接收到历史消息 (最近 N 条)。
+     *
+     * @param desktopId - Desktop ID
+     * @param listener - 事件处理函数
+     * @returns 取消订阅的函数
+     */
+    subscribe(desktopId: DesktopID, listener: LLMOutputListener): () => void;
+    /**
+     * 推送 LLM 文本事件
+     *
+     * [RFC-020] 支持结构化 payload { reasoning?, content? }
+     * 由 AgentDriver 通过 Bridge 调用。
+     *
+     * @param desktopId - Desktop ID
+     * @param payload - 结构化内容 { reasoning?, content? }
+     * @param meta - 可选元数据
+     */
+    push(desktopId: DesktopID, payload: {
+        reasoning?: string;
+        content?: string;
+    }, meta?: LLMOutputEventMeta): void;
+    /**
+     * 获取历史消息
+     *
+     * 返回最近 N 条消息 (默认 3 条)。
+     *
+     * @param desktopId - Desktop ID
+     * @returns 历史事件数组
+     */
+    getHistory(desktopId: DesktopID): LLMOutputEvent[];
+    /**
+     * 清理 Desktop 相关资源
+     *
+     * 当 Desktop 销毁时调用，释放订阅者和历史记录。
+     *
+     * @param desktopId - Desktop ID
+     */
+    cleanup(desktopId: DesktopID): void;
+}

package/dist/spi/runtime/llm-output-channel.interface.js

@@ -0,0 +1,12 @@
+/**
+ * SPI Layer - LLM Output Channel Service Interface
+ *
+ * [RFC-011] LLM Output Output Channel
+ *
+ * 管理 Desktop 级别的 LLM 文本发布订阅。
+ * 每个 Desktop 有独立的通道，支持历史缓冲。
+ *
+ * @module @aotui/runtime/spi
+ */
+export {};
+//# sourceMappingURL=llm-output-channel.interface.js.map

package/dist/spi/runtime/llm-output-channel.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-output-channel.interface.js","sourceRoot":"","sources":["../../../src/spi/runtime/llm-output-channel.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}