@aotui/runtime 1.0.0

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

@@ -0,0 +1,80 @@
+/**
+ * SPI Layer - Signal Service Interface
+ *
+ * 管理 Desktop 级别的事件发布订阅。
+ *
+ * @module @aotui/runtime/spi
+ */
+import type { DesktopID } from '../core/types.js';
+import type { UpdateSignal } from '../core/signals.js';
+/**
+ * Signal 监听器函数类型
+ */
+export type SignalListener = (signal: UpdateSignal) => void;
+/**
+ * 信号服务接口
+ *
+ * 管理 Desktop 级别的事件发布订阅。
+ *
+ * 设计原则:
+ * - 解耦: Signal 的产生和消费完全分离
+ * - 多租户: 每个 Desktop 有独立的信号空间
+ * - 可靠性: 订阅者异常不影响其他订阅者
+ *
+ * @example
+ * ```typescript
+ * const signalService: ISignalService = new SignalBusAdapter();
+ *
+ * // 订阅
+ * const unsubscribe = signalService.subscribe(desktopId, (signal) => {
+ *     console.log('Signal received:', signal.reason);
+ * });
+ *
+ * // 发布
+ * signalService.emit(desktopId, 'dom_mutation');
+ *
+ * // 取消订阅
+ * unsubscribe();
+ * ```
+ */
+export interface ISignalService {
+    /**
+     * 订阅信号
+     *
+     * @param desktopId - Desktop ID
+     * @param listener - 信号处理函数
+     * @returns 取消订阅的函数
+     */
+    subscribe(desktopId: DesktopID, listener: SignalListener): () => void;
+    /**
+     * 发布信号
+     *
+     * @param desktopId - Desktop ID
+     * @param reason - 信号原因 (dom_mutation, app_opened, manual_refresh 等)
+     */
+    emit(desktopId: DesktopID, reason: UpdateSignal['reason']): void;
+    /**
+     * 清理 Desktop 相关状态
+     *
+     * 当 Desktop 销毁时调用，释放订阅者和相关资源。
+     *
+     * @param desktopId - Desktop ID
+     */
+    cleanup(desktopId: DesktopID): void;
+}
+/**
+ * Signal Output Stream Interface
+ *
+ * Desktop.output 的公开接口，用于外部消费者订阅信号。
+ * 与 ISignalService 的区别是：此接口仅暴露单个 Desktop 的订阅能力。
+ */
+export interface ISignalOutputStream {
+    /**
+     * 订阅信号
+     */
+    subscribe(listener: SignalListener): void;
+    /**
+     * 取消订阅
+     */
+    unsubscribe(listener: SignalListener): void;
+}

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

@@ -0,0 +1,9 @@
+/**
+ * SPI Layer - Signal Service Interface
+ *
+ * 管理 Desktop 级别的事件发布订阅。
+ *
+ * @module @aotui/runtime/spi
+ */
+export {};
+//# sourceMappingURL=signal.interface.js.map

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

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

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

@@ -0,0 +1,126 @@
+/**
+ * SPI - Snapshot Interfaces
+ *
+ * [RFC-007] Interfaces for System Prompt Enhancement.
+ *
+ * These interfaces define contracts for:
+ * - Desktop metadata access (for snapshot generation)
+ * - Snapshot fragment structure (from Worker Runtime)
+ * - Snapshot formatter (for TUI output)
+ *
+ * @module @aotui/runtime/spi/runtime
+ */
+/**
+ * Installed application info (readonly)
+ */
+export interface InstalledAppInfo {
+    readonly appId: string;
+    readonly name: string;
+    readonly status: 'pending' | 'running' | 'closed' | 'collapsed';
+    readonly description?: string;
+    readonly whatItIs?: string;
+    readonly whenToUse?: string;
+    /** [RFC-014] App 消息角色 */
+    readonly promptRole?: 'user' | 'assistant';
+}
+/**
+ * Log entry (readonly)
+ */
+export interface LogEntry {
+    readonly timestamp: number;
+    readonly message: string;
+    readonly level?: 'info' | 'warn' | 'error';
+}
+/**
+ * Desktop metadata for snapshot generation
+ *
+ * Provides read-only access to Desktop state information
+ * needed for generating the `<desktop>` section of TUI snapshots.
+ *
+ * @remarks
+ * This interface is optional for Desktop implementations.
+ * SnapshotFormatter will gracefully handle missing methods.
+ */
+export interface IDesktopMetadata {
+    /**
+     * Get all installed applications
+     */
+    getInstalledApps(): ReadonlyArray<InstalledAppInfo>;
+    /**
+     * Get recent system logs
+     * @param limit - Maximum number of logs to return (default: 5)
+     */
+    getSystemLogs(limit?: number): ReadonlyArray<LogEntry>;
+    /**
+     * Get operation logs for a specific app
+     * @param appId - Application ID
+     * @param limit - Maximum number of logs to return (default: 3)
+     */
+    getAppOperationLogs(appId: string, limit?: number): ReadonlyArray<LogEntry>;
+}
+/**
+ * Snapshot fragment from Worker Runtime
+ *
+ * Each Worker app pushes its own fragment containing:
+ * - Rendered view markup
+ * - IndexMap for semantic references
+ * - Optional viewTree for Application View Tree
+ */
+export interface ISnapshotFragment {
+    readonly appId: string;
+    readonly markup: string;
+    readonly indexMap: Record<string, unknown>;
+    readonly timestamp?: number;
+    /**
+     * View 级别片段（可选）
+     *
+     * 由 Worker Runtime 计算并推送，支持细粒度时间排序。
+     */
+    readonly views?: ReadonlyArray<{
+        viewId: string;
+        viewType: string;
+        viewName?: string;
+        markup: string;
+        timestamp: number;
+    }>;
+    /**
+     * [RFC-007] View tree markdown for Application Info section
+     *
+     * Format:
+     * ```markdown
+     * ## Application View Tree
+     * - [Chat](view:view_0, mounted)
+     *     ↳ [Detail](link:CD_0)
+     * ```
+     */
+    readonly viewTree?: string;
+}
+/**
+ * Formatted snapshot result
+ */
+export interface FormattedSnapshotResult {
+    readonly markup: string;
+    readonly indexMap: Record<string, unknown>;
+}
+/**
+ * Snapshot formatter interface
+ *
+ * Transforms Worker fragments and Desktop metadata into
+ * a complete TUI snapshot conforming to TUI_DEMO.md format.
+ *
+ * @example
+ * ```typescript
+ * const formatter: ISnapshotFormatter = new SnapshotFormatter();
+ * const { markup, indexMap } = formatter.format(fragments, metadata);
+ * ```
+ */
+export interface ISnapshotFormatter {
+    /**
+     * Format complete TUI snapshot
+     *
+     * @param fragments - Snapshot fragments from Worker apps
+     * @param metadata - Desktop metadata for global info
+     * @returns Formatted snapshot with markup and merged indexMap
+     */
+    format(fragments: ReadonlyArray<ISnapshotFragment>, metadata: IDesktopMetadata): FormattedSnapshotResult;
+}

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

@@ -0,0 +1,14 @@
+/**
+ * SPI - Snapshot Interfaces
+ *
+ * [RFC-007] Interfaces for System Prompt Enhancement.
+ *
+ * These interfaces define contracts for:
+ * - Desktop metadata access (for snapshot generation)
+ * - Snapshot fragment structure (from Worker Runtime)
+ * - Snapshot formatter (for TUI output)
+ *
+ * @module @aotui/runtime/spi/runtime
+ */
+export {};
+//# sourceMappingURL=snapshot.interface.js.map

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

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

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

@@ -0,0 +1,47 @@
+/**
+ * SPI - ITransformer Interface
+ *
+ * Defines the contract for DOM-to-TUI transformation.
+ * The Kernel depends on this interface, not on concrete implementations.
+ *
+ * @module @aotui/runtime/spi/runtime
+ */
+import type { IndexMap } from '../core/index.js';
+/**
+ * Result of a transformation operation
+ */
+export interface TransformResult {
+    /** Generated TUI Markup (Markdown-like format) */
+    markup: string;
+    /** Map of data paths to payloads for Agent resolution */
+    indexMap: IndexMap;
+}
+/**
+ * Transformer Interface
+ *
+ * Transforms DOM structures into TUI-compatible markup.
+ * Implementations must be stateless and thread-safe.
+ *
+ * @example
+ * ```typescript
+ * const transformer: ITransformer = new Transformer();
+ * const { markup, indexMap } = transformer.transform(document);
+ * ```
+ */
+export interface ITransformer {
+    /**
+     * Transforms a full DOM (Window or Document) to TUI Markup
+     *
+     * @param dom - The DOM object (Window, Document, or DesktopDOM structure)
+     * @returns TransformResult with markup and indexMap
+     */
+    transform(dom: unknown): TransformResult;
+    /**
+     * Transforms a single Element to TUI Markup
+     *
+     * @param element - The DOM Element to transform
+     * @param appId - Optional App ID for namespacing operations
+     * @returns TransformResult with markup and indexMap
+     */
+    transformElement(element: Element, appId?: string): TransformResult;
+}

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

@@ -0,0 +1,10 @@
+/**
+ * SPI - ITransformer Interface
+ *
+ * Defines the contract for DOM-to-TUI transformation.
+ * The Kernel depends on this interface, not on concrete implementations.
+ *
+ * @module @aotui/runtime/spi/runtime
+ */
+export {};
+//# sourceMappingURL=transformer.interface.js.map

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

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

package/dist/spi/runtime/worker-message.interface.d.ts

@@ -0,0 +1,80 @@
+/**
+ * SPI Layer - Worker Message Interface
+ *
+ * Defines the stable contract for Worker-Main thread communication.
+ *
+ * [架构原则] 这是 SPI 层的抽象接口，只暴露最小必要的消息契约。
+ * 具体的消息结构由 Engine 层定义，SDK Worker 使用本地兼容类型。
+ *
+ * 这样设计的长期收益:
+ * 1. SPI 保持纯粹的契约层
+ * 2. 未来可替换 IPC 实现 (如 SharedArrayBuffer)
+ * 3. 协议变更不破坏 SDK 兼容性
+ *
+ * @module @aotui/runtime/spi
+ */
+/**
+ * 请求 ID 类型
+ *
+ * 用于匹配 Worker 请求-响应对
+ */
+export type RequestID = string;
+/**
+ * 生成唯一请求 ID
+ */
+export declare function generateRequestId(): RequestID;
+/**
+ * Worker 消息类型枚举
+ *
+ * 这是稳定的 API 契约，新增类型是向后兼容的，
+ * 但移除或重命名类型需要版本升级。
+ */
+export type WorkerMessageType = 'INIT' | 'APP_OPEN' | 'APP_PAUSE' | 'APP_RESUME' | 'APP_CLOSE' | 'VIEW_DISMOUNT' | 'APP_OPERATION' | 'VIEW_OPERATION' | 'EXTERNAL_EVENT' | 'RENDER_VIEW' | 'RENDER_ALL' | 'GET_DOM_HTML' | 'TERMINATE' | 'RESET' | 'INIT_RESPONSE' | 'LIFECYCLE_RESPONSE' | 'OPERATION_RESPONSE' | 'RENDER_RESPONSE' | 'ERROR_RESPONSE' | 'DOM_UPDATE' | 'REQUEST_UPDATE' | 'REQUEST_MOUNT_CHILD' | 'REQUEST_DISMOUNT_CHILD' | 'RESET_RESPONSE';
+/**
+ * 基础消息接口
+ *
+ * 所有 Worker 消息都必须包含 type 字段
+ */
+export interface IWorkerMessage {
+    readonly type: WorkerMessageType;
+}
+/**
+ * 请求消息接口
+ *
+ * Main → Worker 的请求消息
+ */
+export interface IWorkerRequest extends IWorkerMessage {
+    readonly requestId: RequestID;
+}
+/**
+ * 响应消息接口
+ *
+ * Worker → Main 的响应消息
+ */
+export interface IWorkerResponse extends IWorkerMessage {
+    readonly requestId: RequestID;
+    readonly success: boolean;
+}
+/**
+ * 错误信息结构
+ */
+export interface IWorkerError {
+    readonly code: string;
+    readonly message: string;
+}
+/**
+ * 检查消息是否为响应类型
+ */
+export declare function isWorkerResponse(msg: IWorkerMessage): msg is IWorkerResponse;
+/**
+ * 检查消息是否为请求类型
+ */
+export declare function isWorkerRequest(msg: IWorkerMessage): msg is IWorkerRequest;
+/**
+ * 检查是否为 DOM 更新推送
+ */
+export declare function isDomUpdateMessage(msg: IWorkerMessage): boolean;
+/**
+ * 检查是否为 Worker 主动请求
+ */
+export declare function isWorkerPush(msg: IWorkerMessage): boolean;

package/dist/spi/runtime/worker-message.interface.js

@@ -0,0 +1,49 @@
+/**
+ * SPI Layer - Worker Message Interface
+ *
+ * Defines the stable contract for Worker-Main thread communication.
+ *
+ * [架构原则] 这是 SPI 层的抽象接口，只暴露最小必要的消息契约。
+ * 具体的消息结构由 Engine 层定义，SDK Worker 使用本地兼容类型。
+ *
+ * 这样设计的长期收益:
+ * 1. SPI 保持纯粹的契约层
+ * 2. 未来可替换 IPC 实现 (如 SharedArrayBuffer)
+ * 3. 协议变更不破坏 SDK 兼容性
+ *
+ * @module @aotui/runtime/spi
+ */
+/**
+ * 生成唯一请求 ID
+ */
+export function generateRequestId() {
+    return `req_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+}
+// ============================================================================
+// Type Guards (稳定契约)
+// ============================================================================
+/**
+ * 检查消息是否为响应类型
+ */
+export function isWorkerResponse(msg) {
+    return 'requestId' in msg && 'success' in msg;
+}
+/**
+ * 检查消息是否为请求类型
+ */
+export function isWorkerRequest(msg) {
+    return 'requestId' in msg && !('success' in msg);
+}
+/**
+ * 检查是否为 DOM 更新推送
+ */
+export function isDomUpdateMessage(msg) {
+    return msg.type === 'DOM_UPDATE';
+}
+/**
+ * 检查是否为 Worker 主动请求
+ */
+export function isWorkerPush(msg) {
+    return msg.type.startsWith('REQUEST_') || msg.type === 'DOM_UPDATE';
+}
+//# sourceMappingURL=worker-message.interface.js.map

package/dist/spi/runtime/worker-message.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-message.interface.js","sourceRoot":"","sources":["../../../src/spi/runtime/worker-message.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAaH;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC7B,OAAO,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACzE,CAAC;AAoFD,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAmB;IAChD,OAAO,WAAW,IAAI,GAAG,IAAI,SAAS,IAAI,GAAG,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,GAAmB;IAC/C,OAAO,WAAW,IAAI,GAAG,IAAI,CAAC,CAAC,SAAS,IAAI,GAAG,CAAC,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAmB;IAClD,OAAO,GAAG,CAAC,IAAI,KAAK,YAAY,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,GAAmB;IAC5C,OAAO,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,CAAC;AACxE,CAAC"}

package/dist/spi/runtime/worker-runtime.interface.d.ts

@@ -0,0 +1,177 @@
+/**
+ * Worker Runtime SPI - 通用 Worker 基础设施接口
+ *
+ * 本文件定义了 Worker 侧运行时的标准接口，用于支持多框架生态。
+ *
+ * 设计原则：
+ * 1. 框架无关：不依赖任何具体的 UI 框架（Preact, Vue, Solid）
+ * 2. 职责分离：Worker Runtime 负责"管道"，App Adapter 负责"逻辑"
+ * 3. 可测试性：接口可被 Mock，便于单元测试
+ *
+ * @module @aotui/runtime/spi/worker-runtime
+ */
+import type { AppContext } from '../app/store.interface.js';
+import type { OperationContext, OperationResult } from '../core/operations.js';
+import type { AppID, DesktopID } from '../core/types.js';
+/**
+ * Worker 运行时接口
+ *
+ * 职责：
+ * - 初始化 Virtual DOM 环境 (LinkedOM)
+ * - 处理 IPC 消息路由
+ * - 提供 DOM 观察与同步能力
+ * - 管理 App 生命周期框架
+ */
+export interface IWorkerRuntime {
+    /**
+     * 初始化 Worker 环境
+     * @param config Worker 配置信息
+     */
+    initialize(config: WorkerRuntimeConfig): Promise<void>;
+    /**
+     * 加载并初始化 App
+     * @param modulePath App 模块路径
+     * @param adapter UI 框架适配器
+     */
+    loadApp(modulePath: string, adapter: IAppAdapter): Promise<void>;
+    /**
+     * 获取 Virtual DOM 环境
+     */
+    getDOMEnvironment(): WorkerDOMEnvironment;
+    /**
+     * 发送消息到主线程
+     */
+    sendMessage(message: WorkerMessage): void;
+    /**
+     * 启动 DOM 观察器
+     * @param container 要观察的容器元素
+     */
+    observeDOM(container: Element): void;
+    /**
+     * 手动触发 DOM 同步
+     */
+    syncDOM(): void;
+    /**
+     * 关闭 Worker
+     */
+    shutdown(): Promise<void>;
+}
+/**
+ * Worker Runtime 配置
+ */
+export interface WorkerRuntimeConfig {
+    /** 应用 ID (Branded Type) */
+    appId: AppID;
+    /** Desktop ID (Branded Type) */
+    desktopId: DesktopID;
+    /**
+     * DOM 更新节流时间 (ms)
+     * @default 16
+     */
+    domUpdateThrottle?: number;
+}
+/**
+ * Virtual DOM 环境
+ *
+ * 提供 Worker 内的 DOM API 访问
+ */
+export interface WorkerDOMEnvironment {
+    /** LinkedOM document 实例 */
+    document: Document;
+    /** LinkedOM window 实例 */
+    window: Window;
+    /**
+     * App 根容器元素
+     */
+    container: HTMLElement;
+}
+/**
+ * Worker 消息类型 (简化，详细定义在 worker-message.interface.ts)
+ */
+export interface WorkerMessage {
+    type: string;
+    [key: string]: unknown;
+}
+/**
+ * App 适配器接口
+ *
+ * 职责：
+ * - 将 UI 框架挂载到 Virtual DOM
+ * - 处理框架特定的生命周期
+ * - 提供渲染回调机制
+ *
+ * @template TApp App 实例类型（框架特定）
+ */
+export interface IAppAdapter<TApp = unknown> {
+    /**
+     * 适配器名称
+     *
+     * @example "preact", "vue", "solid"
+     */
+    readonly name: string;
+    /**
+     * 初始化框架环境
+     *
+     * 例如：设置 globalThis.document, 注册全局 API
+     *
+     * @param env Virtual DOM 环境
+     */
+    setupEnvironment(env: WorkerDOMEnvironment): void;
+    /**
+     * 创建 App 实例
+     *
+     * 从动态导入的模块中提取并创建 App
+     *
+     * @param appModule 动态 import() 的模块对象
+     * @returns App 实例
+     */
+    createApp(appModule: any): Promise<TApp>;
+    /**
+     * 挂载 App 到容器
+     *
+     * @param app App 实例
+     * @param context Runtime 提供的 App 上下文
+     * @param container 挂载目标容器
+     * @returns 挂载结果，包含生命周期钩子和操作处理器
+     */
+    mount(app: TApp, context: AppContext, container: HTMLElement): Promise<AppAdapterMountResult>;
+    /**
+     * 卸载 App
+     *
+     * @param app App 实例
+     */
+    unmount(app: TApp): Promise<void>;
+}
+/**
+ * App 挂载结果
+ *
+ * Adapter 在 mount() 后返回，用于连接 App 与 Worker Runtime
+ */
+export interface AppAdapterMountResult {
+    /**
+     * 生命周期钩子
+     *
+     * 当 Runtime 调用对应生命周期方法时触发
+     */
+    lifecycle: {
+        /** App 暂停 */
+        onPause?: () => Promise<void>;
+        /** App 恢复 */
+        onResume?: () => Promise<void>;
+        /** App 关闭 */
+        onClose?: () => Promise<void>;
+    };
+    /**
+     * 操作处理器
+     *
+     * 当 Agent 或 Desktop 发起 Operation 时调用
+     */
+    onOperation: (context: OperationContext, operation: string, args: Record<string, unknown>) => Promise<OperationResult>;
+    /**
+     * 渲染回调 (可选)
+     *
+     * 当 App 调用 `markDirty()` 后，Runtime 会调用此回调。
+     * 适用于需要手动触发渲染的情况（如 ViewBasedApp）。
+     */
+    onRender?: () => void;
+}

package/dist/spi/runtime/worker-runtime.interface.js

@@ -0,0 +1,14 @@
+/**
+ * Worker Runtime SPI - 通用 Worker 基础设施接口
+ *
+ * 本文件定义了 Worker 侧运行时的标准接口，用于支持多框架生态。
+ *
+ * 设计原则：
+ * 1. 框架无关：不依赖任何具体的 UI 框架（Preact, Vue, Solid）
+ * 2. 职责分离：Worker Runtime 负责"管道"，App Adapter 负责"逻辑"
+ * 3. 可测试性：接口可被 Mock，便于单元测试
+ *
+ * @module @aotui/runtime/spi/worker-runtime
+ */
+export {};
+//# sourceMappingURL=worker-runtime.interface.js.map

package/dist/spi/runtime/worker-runtime.interface.js.map

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

package/dist/spi/worker-protocol/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Worker Protocol - SPI Entry Point
+ *
+ * 统一的 Worker IPC 协议定义。
+ *
+ * 这是 AppWorkerHost (主线程) 和 Worker Runtime (工作线程) 之间的契约。
+ *
+ * ## 职责边界
+ *
+ * - **Runtime (AppWorkerHost)**: 发送命令消息，接收响应/推送
+ * - **Worker Runtime**: 接收命令消息，发送响应/推送
+ *
+ * ## 使用方式
+ *
+ * ```typescript
+ * // Runtime 端 (AppWorkerHost)
+ * import type { MainToWorkerMessage, WorkerToMainMessage } from '@aotui/runtime/spi';
+ *
+ * // Worker 端 (worker-runtime)
+ * import type { MainToWorkerMessage, WorkerToMainMessage } from '../spi/worker-protocol/index.js';
+ * ```
+ *
+ * @module @aotui/runtime/spi/worker-protocol
+ */
+export * from './types.js';
+export * from './messages.js';

package/dist/spi/worker-protocol/index.js

@@ -0,0 +1,29 @@
+/**
+ * Worker Protocol - SPI Entry Point
+ *
+ * 统一的 Worker IPC 协议定义。
+ *
+ * 这是 AppWorkerHost (主线程) 和 Worker Runtime (工作线程) 之间的契约。
+ *
+ * ## 职责边界
+ *
+ * - **Runtime (AppWorkerHost)**: 发送命令消息，接收响应/推送
+ * - **Worker Runtime**: 接收命令消息，发送响应/推送
+ *
+ * ## 使用方式
+ *
+ * ```typescript
+ * // Runtime 端 (AppWorkerHost)
+ * import type { MainToWorkerMessage, WorkerToMainMessage } from '@aotui/runtime/spi';
+ *
+ * // Worker 端 (worker-runtime)
+ * import type { MainToWorkerMessage, WorkerToMainMessage } from '../spi/worker-protocol/index.js';
+ * ```
+ *
+ * @module @aotui/runtime/spi/worker-protocol
+ */
+// Type definitions
+export * from './types.js';
+// Message definitions
+export * from './messages.js';
+//# sourceMappingURL=index.js.map

package/dist/spi/worker-protocol/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/spi/worker-protocol/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,mBAAmB;AACnB,cAAc,YAAY,CAAC;AAE3B,sBAAsB;AACtB,cAAc,eAAe,CAAC"}