@aotui/runtime 1.0.0

package/dist/engine/app/worker-sandbox.d.ts

@@ -0,0 +1,152 @@
+/**
+ * WorkerSandbox - Worker-based App 隔离沙箱
+ *
+ * 与 AppSandbox 相同接口，但 App 运行在独立的 Worker Thread 中。
+ * 所有 App 交互通过 IPC 进行。
+ *
+ * 优点:
+ * - 真正的 DOM 隔离 (每个 Worker 有独立 globalThis.document)
+ * - 进程级错误隔离
+ * - 支持任意 UI 框架
+ *
+ * @module @aotui/runtime/engine/app-sandbox
+ */
+import type { AppID, DesktopID, DataPayload, ViewID, OperationID, SnapshotID } from '../../spi/index.js';
+import { type WorkerStatus } from './worker-host.js';
+/**
+ * Sandbox 状态机
+ *
+ * 状态转换:
+ * created → running (installDynamic)
+ * running ↔ paused
+ * running/paused → closed
+ */
+export type SandboxStatus = 'created' | 'running' | 'paused' | 'closed';
+/**
+ * WorkerSandbox 配置
+ */
+export interface WorkerSandboxConfig {
+    /** App ID */
+    appId: AppID;
+    /** Desktop ID */
+    desktopId: DesktopID;
+    /** App 名称 */
+    name?: string;
+    /** App 模块路径 (用于动态 import) */
+    appModulePath: string;
+    /**
+     * Worker runtime 脚本路径 (可选)
+     * [C1 Fix] 默认使用 Runtime 内置的 worker-runtime
+     */
+    workerScriptPath?: string;
+    /** 应用启动配置 (环境变量、初始状态等) */
+    config?: import('../../spi/app/app-config.interface.js').AppLaunchConfig;
+    /** [RFC-005] Runtime Config */
+    runtimeConfig?: import('../../spi/config/index.js').RuntimeConfig;
+}
+/**
+ * WorkerSandbox - Worker-based App 隔离
+ *
+ * 实现与 AppSandbox 兼容的接口，但使用 Worker 执行 App
+ */
+export declare class WorkerSandbox {
+    private readonly config;
+    readonly appId: AppID;
+    readonly desktopId: DesktopID;
+    readonly name?: string;
+    readonly createdAt: number;
+    private workerHost;
+    private _status;
+    private _disposed;
+    onUpdateRequest?: () => void;
+    constructor(config: WorkerSandboxConfig);
+    get status(): SandboxStatus;
+    get disposed(): boolean;
+    /**
+     * 获取 Worker 状态
+     */
+    getWorkerStatus(): WorkerStatus | null;
+    /**
+     * [RFC-001] 获取 Snapshot Fragment
+     *
+     * 返回 Worker 最新推送的 Markdown + IndexMap + ViewTree。
+     * 当 USE_WORKER_TRANSFORM 启用时，Worker 直接执行 Transformer，
+     * 此方法返回缓存的结果。
+     *
+     * [RFC-007] Added viewTree for Application View Tree section
+     */
+    getSnapshotFragment(): {
+        markup: string;
+        indexMap: Record<string, DataPayload>;
+        views?: Array<{
+            viewId: ViewID;
+            viewType: string;
+            viewName?: string;
+            markup: string;
+            timestamp: number;
+        }>;
+        viewTree?: string;
+        timestamp?: number;
+    } | null;
+    /**
+     * 安装动态 App (启动 Worker)
+     *
+     * [WorkerPool] 从池中获取 Worker
+     */
+    installDynamic(): Promise<void>;
+    /**
+     * 暂停 App
+     */
+    pause(): Promise<void>;
+    /**
+     * 恢复 App
+     */
+    resume(): Promise<void>;
+    /**
+     * 关闭 App
+     */
+    close(): Promise<void>;
+    /**
+     * [RFC-015] 删除 App
+     *
+     * 1. 调用 Worker delete() 清理数据
+     * 2. 调用 close() 关闭 Worker
+     */
+    delete(): Promise<void>;
+    /**
+     * 销毁 Sandbox (终止 Worker)
+     */
+    dispose(): void;
+    /**
+     * 执行 Operation
+     */
+    executeOperation(operation: OperationID, args: Record<string, unknown>, snapshotId: SnapshotID, viewId?: ViewID): Promise<import("../../spi/index.js").OperationResult>;
+    /**
+     * 发送外部事件
+     */
+    sendExternalEvent(viewId: ViewID, eventType: string, data: Record<string, unknown>): Promise<void>;
+    /**
+     * 卸载 View (通过 IPC 发送到 Worker)
+     */
+    dismountView(viewId: ViewID): Promise<void>;
+    /**
+     * [RFC-006] 通过 ViewLink 挂载 View (通过 IPC 发送到 Worker)
+     */
+    mountViewByLink(parentViewId: ViewID, linkId: string): Promise<void>;
+    /**
+     * [RFC-011] Push LLM text to Worker
+     * [RFC-020] Now accepts structured payload { reasoning?, content? }
+     */
+    pushLLMOutput(payload: {
+        reasoning?: string;
+        content?: string;
+    }, type: 'complete', meta?: {
+        model?: string;
+        usage?: {
+            promptTokens: number;
+            completionTokens: number;
+            totalTokens: number;
+        };
+    }): void;
+    private ensureNotDisposed;
+}

package/dist/engine/app/worker-sandbox.js

@@ -0,0 +1,290 @@
+/**
+ * WorkerSandbox - Worker-based App 隔离沙箱
+ *
+ * 与 AppSandbox 相同接口，但 App 运行在独立的 Worker Thread 中。
+ * 所有 App 交互通过 IPC 进行。
+ *
+ * 优点:
+ * - 真正的 DOM 隔离 (每个 Worker 有独立 globalThis.document)
+ * - 进程级错误隔离
+ * - 支持任意 UI 框架
+ *
+ * @module @aotui/runtime/engine/app-sandbox
+ */
+import { fileURLToPath } from 'url';
+import { dirname, resolve } from 'path';
+import { AOTUIError } from '../../spi/core/errors.js';
+import { AppWorkerHost } from './worker-host.js';
+import { WorkerPool } from './worker-pool.js';
+// [C1 Fix] Default worker script path from Runtime package
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const DEFAULT_WORKER_SCRIPT = resolve(__dirname, '../../worker-runtime/index.js');
+// [WorkerPool] Global singleton pool
+// Assume all worker apps use the same runtime script
+let globalWorkerPool = null;
+function getWorkerPool(scriptPath) {
+    if (!globalWorkerPool) {
+        console.log(`[WorkerSandbox] Initializing global WorkerPool with script: ${scriptPath}`);
+        globalWorkerPool = new WorkerPool({
+            workerScript: scriptPath,
+            initialSize: 2,
+            maxSize: 8,
+            idleTimeoutMs: 60000,
+        });
+        globalWorkerPool.warmup().catch(err => {
+            console.error('[WorkerSandbox] Failed to warmup worker pool:', err);
+        });
+    }
+    return globalWorkerPool;
+}
+/**
+ * WorkerSandbox - Worker-based App 隔离
+ *
+ * 实现与 AppSandbox 兼容的接口，但使用 Worker 执行 App
+ */
+export class WorkerSandbox {
+    config;
+    appId;
+    desktopId;
+    name;
+    createdAt;
+    workerHost = null;
+    _status = 'created';
+    _disposed = false;
+    // 回调
+    onUpdateRequest;
+    constructor(config) {
+        this.config = config;
+        this.appId = config.appId;
+        this.desktopId = config.desktopId;
+        this.name = config.name;
+        this.createdAt = Date.now();
+    }
+    // ════════════════════════════════════════════════════════════════
+    //  Public Getters (兼容 AppSandbox 接口)
+    // ════════════════════════════════════════════════════════════════
+    get status() {
+        return this._status;
+    }
+    get disposed() {
+        return this._disposed;
+    }
+    /**
+     * 获取 Worker 状态
+     */
+    getWorkerStatus() {
+        return this.workerHost?.getStatus() ?? null;
+    }
+    /**
+     * [RFC-001] 获取 Snapshot Fragment
+     *
+     * 返回 Worker 最新推送的 Markdown + IndexMap + ViewTree。
+     * 当 USE_WORKER_TRANSFORM 启用时，Worker 直接执行 Transformer，
+     * 此方法返回缓存的结果。
+     *
+     * [RFC-007] Added viewTree for Application View Tree section
+     */
+    getSnapshotFragment() {
+        return this.workerHost?.getSnapshotFragment() ?? null;
+    }
+    // ════════════════════════════════════════════════════════════════
+    //  Lifecycle Methods
+    // ════════════════════════════════════════════════════════════════
+    /**
+     * 安装动态 App (启动 Worker)
+     *
+     * [WorkerPool] 从池中获取 Worker
+     */
+    async installDynamic() {
+        this.ensureNotDisposed();
+        if (this._status !== 'created') {
+            throw new AOTUIError('CONFIG_INVALID', {
+                reason: `Cannot install, sandbox is already '${this._status}'`,
+                appId: this.appId
+            });
+        }
+        // 1. 获取 Worker (可能来自 Pool)
+        // [C1 Fix] Use default script path if not specified
+        // [Fix] Also treat empty string as undefined (config may have workerScript: "")
+        const scriptPath = this.config.workerScriptPath || DEFAULT_WORKER_SCRIPT;
+        const pool = getWorkerPool(scriptPath);
+        const worker = await pool.acquire();
+        // 2. 创建 WorkerHost
+        this.workerHost = new AppWorkerHost({
+            ...this.config, // Pass all config properties
+            existingWorker: worker, // 注入 Worker
+            runtimeConfig: this.config.runtimeConfig, // [RFC-005] Pass Runtime Config
+        });
+        // 设置回调
+        this.workerHost.onUpdateRequest = () => {
+            this.onUpdateRequest?.();
+        };
+        // 3. 启动 Host (初始化 App)
+        try {
+            await this.workerHost.start();
+            // 打开 App
+            await this.workerHost.open();
+        }
+        catch (error) {
+            // 如果启动失败，尝试归还 worker (如果是 Reset 失败，release 会处理)
+            const w = await this.workerHost.releaseWorker();
+            if (w)
+                pool.release(w, false); // 标记无效
+            throw error;
+        }
+        this._status = 'running';
+    }
+    /**
+     * 暂停 App
+     */
+    async pause() {
+        this.ensureNotDisposed();
+        if (this._status !== 'running') {
+            return;
+        }
+        if (this.workerHost) {
+            await this.workerHost.pause();
+        }
+        this._status = 'paused';
+    }
+    /**
+     * 恢复 App
+     */
+    async resume() {
+        this.ensureNotDisposed();
+        if (this._status !== 'paused') {
+            return;
+        }
+        if (this.workerHost) {
+            await this.workerHost.resume();
+        }
+        this._status = 'running';
+    }
+    /**
+     * 关闭 App
+     */
+    async close() {
+        this.ensureNotDisposed();
+        if (this._status === 'closed') {
+            return;
+        }
+        if (this.workerHost) {
+            await this.workerHost.close();
+            // [WorkerPool] 归还 Worker
+            // [C1 Fix] Use default script path if not specified
+            // [Fix] Also treat empty string as undefined
+            const scriptPath = this.config.workerScriptPath || DEFAULT_WORKER_SCRIPT;
+            const pool = getWorkerPool(scriptPath);
+            const worker = await this.workerHost.releaseWorker();
+            if (worker) {
+                console.log(`[WorkerSandbox] Releasing worker for ${this.appId} to pool`);
+                pool.release(worker, true);
+            }
+        }
+        this._status = 'closed';
+    }
+    /**
+     * [RFC-015] 删除 App
+     *
+     * 1. 调用 Worker delete() 清理数据
+     * 2. 调用 close() 关闭 Worker
+     */
+    async delete() {
+        this.ensureNotDisposed();
+        if (this.workerHost) {
+            await this.workerHost.delete();
+            await this.close();
+        }
+    }
+    /**
+     * 销毁 Sandbox (终止 Worker)
+     */
+    dispose() {
+        if (this._disposed)
+            return;
+        this._disposed = true;
+        // 尝试归还 Worker (如果还没 close)
+        if (this.workerHost) {
+            // [C1 Fix] Use default script path if not specified
+            // [Fix] Also treat empty string as undefined
+            const scriptPath = this.config.workerScriptPath || DEFAULT_WORKER_SCRIPT;
+            const pool = getWorkerPool(scriptPath);
+            // 这里我们不能异步等待，所以如果是 dispose，可能只能 terminate 或者 fire-and-forget release
+            // 为了安全，我们还是尝试 release
+            this.workerHost.releaseWorker().then(worker => {
+                if (worker) {
+                    pool.release(worker, true);
+                }
+            }).catch(err => {
+                console.error('[WorkerSandbox] Error releasing worker during dispose:', err);
+            });
+            this.workerHost = null;
+        }
+    }
+    // ════════════════════════════════════════════════════════════════
+    //  Operations (通过 IPC)
+    // ════════════════════════════════════════════════════════════════
+    /**
+     * 执行 Operation
+     */
+    async executeOperation(operation, args, snapshotId, viewId) {
+        if (!this.workerHost) {
+            throw new AOTUIError('WORKER_NOT_STARTED', { appId: this.appId });
+        }
+        return this.workerHost.executeOperation(operation, args, snapshotId, viewId);
+    }
+    /**
+     * 发送外部事件
+     */
+    async sendExternalEvent(viewId, eventType, data) {
+        if (!this.workerHost) {
+            throw new AOTUIError('WORKER_NOT_STARTED', { appId: this.appId });
+        }
+        await this.workerHost.sendExternalEvent(viewId, eventType, data);
+    }
+    // ════════════════════════════════════════════════════════════════
+    //  View Lifecycle (通过 IPC)
+    // ════════════════════════════════════════════════════════════════
+    /**
+     * 卸载 View (通过 IPC 发送到 Worker)
+     */
+    async dismountView(viewId) {
+        if (!this.workerHost) {
+            throw new AOTUIError('WORKER_NOT_STARTED', { appId: this.appId });
+        }
+        await this.workerHost.dismountView(viewId);
+    }
+    /**
+     * [RFC-006] 通过 ViewLink 挂载 View (通过 IPC 发送到 Worker)
+     */
+    async mountViewByLink(parentViewId, linkId) {
+        if (!this.workerHost) {
+            throw new AOTUIError('WORKER_NOT_STARTED', { appId: this.appId });
+        }
+        await this.workerHost.mountViewByLink(parentViewId, linkId);
+    }
+    // ════════════════════════════════════════════════════════════════
+    //  [RFC-011] LLM Output Channel
+    // ════════════════════════════════════════════════════════════════
+    /**
+     * [RFC-011] Push LLM text to Worker
+     * [RFC-020] Now accepts structured payload { reasoning?, content? }
+     */
+    pushLLMOutput(payload, type, meta) {
+        if (!this.workerHost) {
+            console.warn(`[WorkerSandbox] Cannot push LLM text: Worker not started for ${this.appId}`);
+            return;
+        }
+        this.workerHost.pushLLMOutput(payload, type, meta);
+    }
+    // ════════════════════════════════════════════════════════════════
+    //  Internal
+    // ════════════════════════════════════════════════════════════════
+    ensureNotDisposed() {
+        if (this._disposed) {
+            throw new AOTUIError('DESKTOP_DISPOSED', { desktopId: this.desktopId, appId: this.appId });
+        }
+    }
+}
+//# sourceMappingURL=worker-sandbox.js.map

package/dist/engine/app/worker-sandbox.js.map

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

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

@@ -0,0 +1,69 @@
+/**
+ * DesktopLogger - Desktop 日志记录模块
+ *
+ * [H1 拆分 Phase 2] 从 Desktop 提取的日志管理模块。
+ *
+ * 职责:
+ * - 记录系统级日志 (Desktop 生命周期事件)
+ * - 记录 App 操作日志 (App 内部操作)
+ * - 提供日志查询接口
+ */
+import type { DesktopID, AppID } from '../../spi/index.js';
+/**
+ * 日志条目
+ */
+export interface LogEntry {
+    timestamp: number;
+    message: string;
+    level: 'info' | 'warn' | 'error';
+}
+export type LogLevel = LogEntry['level'];
+/**
+ * DesktopLogger 配置
+ */
+export interface DesktopLoggerOptions {
+    /** 每个 Desktop 最大系统日志条数，默认 100 */
+    maxSystemLogs?: number;
+    /** 每个 App 最大操作日志条数，默认 50 */
+    maxAppLogs?: number;
+}
+/**
+ * DesktopLogger - 统一管理所有 Desktop 的日志
+ */
+export declare class DesktopLogger {
+    private systemLogs;
+    private appLogs;
+    private options;
+    constructor(options?: DesktopLoggerOptions);
+    /**
+     * 记录系统日志
+     */
+    logSystem(desktopId: DesktopID, message: string, level?: LogLevel): void;
+    /**
+     * 获取系统日志
+     */
+    getSystemLogs(desktopId: DesktopID): LogEntry[];
+    /**
+     * 记录 App 操作日志
+     */
+    logApp(desktopId: DesktopID, appId: AppID, message: string, level?: LogLevel): void;
+    /**
+     * 获取 App 操作日志
+     */
+    getAppLogs(desktopId: DesktopID, appId: AppID): LogEntry[];
+    /**
+     * 清理指定 Desktop 的所有日志
+     */
+    cleanup(desktopId: DesktopID): void;
+    /**
+     * 清理指定 App 的日志
+     */
+    cleanupApp(desktopId: DesktopID, appId: AppID): void;
+    /**
+     * 获取日志统计（用于调试）
+     */
+    getStats(desktopId: DesktopID): {
+        systemCount: number;
+        appCounts: Record<string, number>;
+    };
+}

package/dist/engine/core/desktop-logger.js

@@ -0,0 +1,124 @@
+/**
+ * DesktopLogger - Desktop 日志记录模块
+ *
+ * [H1 拆分 Phase 2] 从 Desktop 提取的日志管理模块。
+ *
+ * 职责:
+ * - 记录系统级日志 (Desktop 生命周期事件)
+ * - 记录 App 操作日志 (App 内部操作)
+ * - 提供日志查询接口
+ */
+/**
+ * DesktopLogger - 统一管理所有 Desktop 的日志
+ */
+export class DesktopLogger {
+    systemLogs = new Map();
+    appLogs = new Map(); // key: desktopId:appId
+    options;
+    constructor(options) {
+        this.options = {
+            maxSystemLogs: options?.maxSystemLogs ?? 100,
+            maxAppLogs: options?.maxAppLogs ?? 50
+        };
+    }
+    // ========================================================================
+    // 系统日志
+    // ========================================================================
+    /**
+     * 记录系统日志
+     */
+    logSystem(desktopId, message, level = 'info') {
+        let logs = this.systemLogs.get(desktopId);
+        if (!logs) {
+            logs = [];
+            this.systemLogs.set(desktopId, logs);
+        }
+        logs.push({
+            timestamp: Date.now(),
+            message,
+            level
+        });
+        // 限制日志数量
+        if (logs.length > this.options.maxSystemLogs) {
+            logs.shift();
+        }
+    }
+    /**
+     * 获取系统日志
+     */
+    getSystemLogs(desktopId) {
+        return this.systemLogs.get(desktopId) ?? [];
+    }
+    // ========================================================================
+    // App 操作日志
+    // ========================================================================
+    /**
+     * 记录 App 操作日志
+     */
+    logApp(desktopId, appId, message, level = 'info') {
+        const key = `${desktopId}:${appId}`;
+        let logs = this.appLogs.get(key);
+        if (!logs) {
+            logs = [];
+            this.appLogs.set(key, logs);
+        }
+        logs.push({
+            timestamp: Date.now(),
+            message,
+            level
+        });
+        // 限制日志数量
+        if (logs.length > this.options.maxAppLogs) {
+            logs.shift();
+        }
+    }
+    /**
+     * 获取 App 操作日志
+     */
+    getAppLogs(desktopId, appId) {
+        const key = `${desktopId}:${appId}`;
+        return this.appLogs.get(key) ?? [];
+    }
+    // ========================================================================
+    // 清理
+    // ========================================================================
+    /**
+     * 清理指定 Desktop 的所有日志
+     */
+    cleanup(desktopId) {
+        this.systemLogs.delete(desktopId);
+        // 清理该 Desktop 下所有 App 的日志
+        const keysToDelete = [];
+        for (const key of this.appLogs.keys()) {
+            if (key.startsWith(`${desktopId}:`)) {
+                keysToDelete.push(key);
+            }
+        }
+        keysToDelete.forEach(key => this.appLogs.delete(key));
+    }
+    /**
+     * 清理指定 App 的日志
+     */
+    cleanupApp(desktopId, appId) {
+        const key = `${desktopId}:${appId}`;
+        this.appLogs.delete(key);
+    }
+    // ========================================================================
+    // 调试辅助
+    // ========================================================================
+    /**
+     * 获取日志统计（用于调试）
+     */
+    getStats(desktopId) {
+        const systemCount = this.systemLogs.get(desktopId)?.length ?? 0;
+        const appCounts = {};
+        for (const [key, logs] of this.appLogs.entries()) {
+            if (key.startsWith(`${desktopId}:`)) {
+                const appId = key.split(':')[1];
+                appCounts[appId] = logs.length;
+            }
+        }
+        return { systemCount, appCounts };
+    }
+}
+//# sourceMappingURL=desktop-logger.js.map

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

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