@aotui/runtime 1.0.0

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

@@ -0,0 +1,397 @@
+/**
+ * AppWorkerHost - 主线程端 Worker 管理器
+ *
+ * 管理一个 App 的 Worker Thread，处理：
+ * - Worker 启动/终止
+ * - 消息发送/接收
+ * - 请求-响应匹配
+ *
+ * @module @aotui/runtime/engine/app-worker
+ */
+import { Worker } from 'worker_threads';
+import { fileURLToPath } from 'url';
+import { dirname, resolve } from 'path';
+import { WORKER_DEFAULTS } from '../../spi/config/index.js';
+import { generateRequestId, isResponse, isRequest, isSnapshotFragment, } from '../../spi/worker-protocol/index.js';
+// Compute default worker script path relative to this file
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const DEFAULT_WORKER_SCRIPT = resolve(__dirname, '../../worker-runtime/index.js');
+/**
+ * AppWorkerHost - 主线程端 Worker 管理
+ */
+export class AppWorkerHost {
+    appId;
+    desktopId;
+    name;
+    config;
+    worker = null;
+    status = 'starting';
+    pendingRequests = new Map();
+    timeout;
+    appModulePath;
+    workerScriptPath;
+    // 回调: Worker 请求 notifyUpdate
+    onUpdateRequest;
+    // 回调: Worker 请求 mount 子 View
+    onMountChildRequest;
+    // 回调: Worker 请求 dismount 子 View
+    onDismountChildRequest;
+    lastDomTimestamp = 0;
+    // [RFC-001] Snapshot Fragment Cache
+    // [RFC-007] Added viewTree field
+    snapshotFragment = null;
+    constructor(config) {
+        this.appId = config.appId;
+        this.desktopId = config.desktopId;
+        this.name = config.name;
+        this.appModulePath = config.appModulePath;
+        // [C1 Fix] Default to Runtime's built-in worker-runtime
+        this.workerScriptPath = config.workerScriptPath ?? DEFAULT_WORKER_SCRIPT;
+        // [RFC-005] Use Runtime Config
+        const workerConfig = config.runtimeConfig?.worker ?? WORKER_DEFAULTS;
+        this.timeout = config.timeout ?? workerConfig.timeoutMs;
+        this.config = config.config; // ✨ Store config
+        if (config.existingWorker) {
+            this.worker = config.existingWorker;
+            // 重新绑定 listeners (因为 Pool 可能移除过)
+            this.bindWorkerListeners();
+        }
+    }
+    /**
+     * 启动 Worker 并初始化 App
+     */
+    async start() {
+        if (!this.worker) {
+            // 创建新 Worker
+            this.worker = new Worker(this.workerScriptPath, {
+                workerData: {
+                    appId: this.appId,
+                    desktopId: this.desktopId,
+                    appModulePath: this.appModulePath,
+                },
+            });
+            this.bindWorkerListeners();
+        }
+        // 发送初始化消息
+        // 注意: 即使是复用的 Worker，也需要发送 INIT 消息来加载 App 模块
+        await this.sendRequest({
+            type: 'INIT',
+            requestId: generateRequestId(),
+            appId: this.appId,
+            desktopId: this.desktopId,
+            appModulePath: this.appModulePath,
+            config: this.config, // ✨ Send config to Worker
+        });
+        this.status = 'ready';
+    }
+    bindWorkerListeners() {
+        if (!this.worker)
+            return;
+        // 先移除旧的 (防止重复绑定)
+        this.worker.removeAllListeners('message');
+        this.worker.removeAllListeners('error');
+        this.worker.removeAllListeners('exit');
+        this.worker.on('message', this.handleMessage.bind(this));
+        this.worker.on('error', this.handleError.bind(this));
+        this.worker.on('exit', this.handleExit.bind(this));
+    }
+    /**
+     * 释放 Worker (用于归还给 Pool)
+     *
+     * 会先发送 RESET 消息，成功后解绑监听器并返回 Worker 实例。
+     */
+    async releaseWorker() {
+        if (!this.worker || this.status === 'closed')
+            return null;
+        try {
+            // 1. 发送 RESET
+            await this.sendRequest({
+                type: 'RESET',
+                requestId: generateRequestId(),
+            });
+            const worker = this.worker;
+            // 2. 解绑监听器
+            worker.removeAllListeners('message');
+            worker.removeAllListeners('error');
+            worker.removeAllListeners('exit');
+            this.worker = null;
+            this.status = 'closed'; // Host 标记为关闭，但 Worker 存活
+            // 清理待处理请求
+            this.cleanupPendingRequests();
+            return worker;
+        }
+        catch (error) {
+            console.error(`[AppWorkerHost] Failed to reset worker:`, error);
+            // 如果重置失败，直接终止
+            this.terminate();
+            return null;
+        }
+    }
+    cleanupPendingRequests() {
+        for (const [, pending] of this.pendingRequests) {
+            clearTimeout(pending.timeout);
+            pending.reject(new Error('Worker released/terminated'));
+        }
+        this.pendingRequests.clear();
+    }
+    /**
+     * 获取 Worker 状态
+     */
+    getStatus() {
+        return this.status;
+    }
+    /**
+     * [RFC-001] 获取缓存的 Snapshot Fragment
+     *
+     * 返回 Worker 最新推送的 Markdown + IndexMap + ViewTree，
+     * 供 Desktop 聚合为 Desktop-level Snapshot。
+     *
+     * [RFC-007] Added viewTree for Application View Tree section
+     */
+    getSnapshotFragment() {
+        if (!this.snapshotFragment)
+            return null;
+        return {
+            markup: this.snapshotFragment.markup,
+            indexMap: this.snapshotFragment.indexMap,
+            views: this.snapshotFragment.views,
+            viewTree: this.snapshotFragment.viewTree, // [RFC-007]
+            timestamp: this.snapshotFragment.timestamp, // propagate fragment recency
+        };
+    }
+    // ════════════════════════════════════════════════════════════════
+    //  App 生命周期
+    // ════════════════════════════════════════════════════════════════
+    async open() {
+        await this.sendRequest({
+            type: 'APP_OPEN',
+            requestId: generateRequestId(),
+        });
+        this.status = 'running';
+    }
+    async pause() {
+        await this.sendRequest({
+            type: 'APP_PAUSE',
+            requestId: generateRequestId(),
+        });
+        this.status = 'paused';
+    }
+    async resume() {
+        await this.sendRequest({
+            type: 'APP_RESUME',
+            requestId: generateRequestId(),
+        });
+        this.status = 'running';
+    }
+    async close() {
+        // 发送 APP_SHUTDOWN 信号给SDK，触发持久化flush
+        await this.sendRequest({
+            type: 'APP_SHUTDOWN',
+            requestId: generateRequestId(),
+        });
+        // 发送 APP_CLOSE 关闭App
+        await this.sendRequest({
+            type: 'APP_CLOSE',
+            requestId: generateRequestId(),
+        });
+        this.status = 'closed';
+    }
+    /**
+     * [RFC-015] Delete App (Data Cleanup)
+     *
+     * Triggers app.onDelete() in worker to clean up persisted data.
+     * Note: This does NOT close the worker, you must call close() after delete().
+     */
+    async delete() {
+        await this.sendRequest({
+            type: 'APP_DELETE',
+            requestId: generateRequestId(),
+        });
+    }
+    // ════════════════════════════════════════════════════════════════
+    //  View 生命周期
+    // ════════════════════════════════════════════════════════════════
+    async dismountView(viewId) {
+        await this.sendRequest({
+            type: 'VIEW_DISMOUNT',
+            requestId: generateRequestId(),
+            viewId,
+        });
+    }
+    /**
+     * [RFC-006] Mount view via ViewLink
+     */
+    async mountViewByLink(parentViewId, linkId) {
+        await this.sendRequest({
+            type: 'VIEW_MOUNT_BY_LINK',
+            requestId: generateRequestId(),
+            parentViewId,
+            linkId,
+        });
+    }
+    // ════════════════════════════════════════════════════════════════
+    //  Operation
+    // ════════════════════════════════════════════════════════════════
+    async executeOperation(operation, args, snapshotId, viewId) {
+        return this.sendRequest({
+            type: viewId ? 'VIEW_OPERATION' : 'APP_OPERATION',
+            requestId: generateRequestId(),
+            viewId,
+            operation,
+            args,
+            snapshotId,
+        });
+    }
+    // ════════════════════════════════════════════════════════════════
+    //  External Event
+    // ════════════════════════════════════════════════════════════════
+    async sendExternalEvent(viewId, eventType, data) {
+        await this.sendRequest({
+            type: 'EXTERNAL_EVENT',
+            requestId: generateRequestId(),
+            viewId,
+            eventType,
+            data,
+        });
+    }
+    // ════════════════════════════════════════════════════════════════
+    //  Render
+    // ════════════════════════════════════════════════════════════════
+    // ════════════════════════════════════════════════════════════════
+    //  [RFC-011] LLM Output Channel
+    // ════════════════════════════════════════════════════════════════
+    /**
+     * [RFC-011] Push LLM text to Worker for SDK's useLLMOutputChannel
+     * [RFC-020] Now accepts structured payload { reasoning?, content? }
+     *
+     * Fire-and-forget: no response expected from Worker
+     */
+    pushLLMOutput(payload, type, meta) {
+        if (!this.worker) {
+            console.warn('[AppWorkerHost] Cannot push LLM text: Worker not started');
+            return;
+        }
+        const totalLength = (payload.reasoning?.length ?? 0) + (payload.content?.length ?? 0);
+        console.log(`[AppWorkerHost] Pushing LLM text to Worker ${this.appId}, total length: ${totalLength}`);
+        this.worker.postMessage({
+            type: 'LLM_OUTPUT_PUSH',
+            reasoning: payload.reasoning,
+            content: payload.content,
+            eventType: type,
+            timestamp: Date.now(),
+            meta,
+        });
+    }
+    // ════════════════════════════════════════════════════════════════
+    //  Terminate
+    // ════════════════════════════════════════════════════════════════
+    terminate() {
+        if (this.worker) {
+            this.worker.postMessage({ type: 'TERMINATE' });
+            this.worker.terminate();
+            this.worker = null;
+        }
+        this.status = 'closed';
+        // 清理所有待处理请求
+        this.cleanupPendingRequests();
+    }
+    // ════════════════════════════════════════════════════════════════
+    //  Internal
+    // ════════════════════════════════════════════════════════════════
+    sendRequest(message) {
+        return new Promise((resolve, reject) => {
+            if (!this.worker) {
+                reject(new Error('Worker not started'));
+                return;
+            }
+            const requestId = message.requestId;
+            if (!requestId) {
+                reject(new Error('Message missing requestId'));
+                return;
+            }
+            // 设置超时
+            const timeout = setTimeout(() => {
+                this.pendingRequests.delete(requestId);
+                reject(new Error(`Request ${requestId} timed out after ${this.timeout}ms`));
+            }, this.timeout);
+            // 注册待处理请求
+            this.pendingRequests.set(requestId, { resolve, reject, timeout });
+            // 发送消息
+            this.worker.postMessage(message);
+        });
+    }
+    handleMessage(msg) {
+        // 处理响应消息
+        if (isResponse(msg)) {
+            const pending = this.pendingRequests.get(msg.requestId);
+            if (pending) {
+                clearTimeout(pending.timeout);
+                this.pendingRequests.delete(msg.requestId);
+                if (msg.success) {
+                    // 根据响应类型提取结果
+                    if (msg.type === 'OPERATION_RESPONSE') {
+                        pending.resolve(msg.result);
+                    }
+                    else {
+                        pending.resolve(undefined);
+                    }
+                }
+                else {
+                    pending.reject(new Error(msg.error?.message || 'Unknown error'));
+                }
+            }
+            return;
+        }
+        // 处理 Worker 主动请求
+        if (isRequest(msg)) {
+            switch (msg.type) {
+                case 'REQUEST_UPDATE':
+                    this.onUpdateRequest?.();
+                    break;
+                case 'REQUEST_MOUNT_CHILD':
+                    this.onMountChildRequest?.(msg.viewId);
+                    break;
+                case 'REQUEST_DISMOUNT_CHILD':
+                    this.onDismountChildRequest?.(msg.viewId);
+                    break;
+            }
+            return;
+        }
+        // [RFC-001] 处理 Snapshot Fragment 推送 (新协议)
+        if (isSnapshotFragment(msg)) {
+            const fragment = msg;
+            // console.log(`[AppWorkerHost] Received SNAPSHOT_FRAGMENT, markup length: ${fragment.markup?.length || 0}`);
+            if (fragment.timestamp > this.lastDomTimestamp) {
+                this.lastDomTimestamp = fragment.timestamp;
+                this.snapshotFragment = {
+                    markup: fragment.markup,
+                    indexMap: fragment.indexMap,
+                    views: fragment.views,
+                    viewTree: fragment.viewTree, // [RFC-007]
+                    timestamp: fragment.timestamp,
+                };
+                // [RFC-012] 仅当不抑制信号时才触发 UpdateSignal
+                // suppressSignal 由 Worker 根据 signalPolicy 设置
+                if (!fragment.suppressSignal) {
+                    this.onUpdateRequest?.();
+                }
+            }
+            return;
+        }
+    }
+    handleError(error) {
+        console.error(`[AppWorkerHost] Worker ${this.appId} error:`, error);
+        this.status = 'error';
+    }
+    handleExit(code) {
+        if (code !== 0) {
+            console.error(`[AppWorkerHost] Worker ${this.appId} exited with code ${code}`);
+        }
+        this.worker = null;
+        if (this.status !== 'closed') {
+            this.status = 'error';
+        }
+    }
+}
+//# sourceMappingURL=worker-host.js.map

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

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

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

@@ -0,0 +1,45 @@
+/**
+ * Worker Pool Manager
+ *
+ * 管理 Worker 进程池，提供 Worker 复用能力。
+ *
+ * 职责:
+ * 1. 维护空闲 Worker 队列
+ * 2. 提供 acquire/release 接口
+ * 3. 自动扩缩容 (Warmup / Idle Timeout)
+ *
+ * @module @aotui/runtime/engine/worker-pool
+ */
+import { Worker } from 'worker_threads';
+import { type WorkerPoolConfig as SPIWorkerPoolConfig } from '../../spi/config/index.js';
+export interface WorkerPoolConfig extends Partial<SPIWorkerPoolConfig> {
+    /** Worker 脚本路径 */
+    workerScript: string;
+}
+export declare class WorkerPool {
+    private config;
+    private idleWorkers;
+    private activeWorkerCount;
+    private destroying;
+    constructor(config: WorkerPoolConfig);
+    /**
+     * 预热 Worker 池
+     */
+    warmup(): Promise<void>;
+    /**
+     * 获取一个 Worker
+     */
+    acquire(): Promise<Worker>;
+    /**
+     * 归还 Worker 到池中
+     *
+     * @param worker 要归还的 Worker
+     * @param isValid 是否仍然有效 (如果发生致命错误，应设为 false)
+     */
+    release(worker: Worker, isValid?: boolean): void;
+    /**
+     * 销毁池
+     */
+    destroy(): Promise<void>;
+    private createWorker;
+}

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

@@ -0,0 +1,122 @@
+/**
+ * Worker Pool Manager
+ *
+ * 管理 Worker 进程池，提供 Worker 复用能力。
+ *
+ * 职责:
+ * 1. 维护空闲 Worker 队列
+ * 2. 提供 acquire/release 接口
+ * 3. 自动扩缩容 (Warmup / Idle Timeout)
+ *
+ * @module @aotui/runtime/engine/worker-pool
+ */
+import { Worker } from 'worker_threads';
+import { AOTUIError } from '../../spi/core/errors.js';
+import { WORKER_DEFAULTS } from '../../spi/config/index.js';
+export class WorkerPool {
+    config;
+    idleWorkers = [];
+    activeWorkerCount = 0;
+    destroying = false;
+    constructor(config) {
+        this.config = { ...WORKER_DEFAULTS.pool, ...config };
+    }
+    /**
+     * 预热 Worker 池
+     */
+    async warmup() {
+        if (this.destroying)
+            return;
+        const targetSize = this.config.initialSize;
+        const currentSize = this.idleWorkers.length + this.activeWorkerCount;
+        if (currentSize < targetSize) {
+            const needed = targetSize - currentSize;
+            console.log(`[WorkerPool] Warming up ${needed} workers...`);
+            for (let i = 0; i < needed; i++) {
+                const worker = this.createWorker();
+                this.idleWorkers.push(worker);
+            }
+        }
+    }
+    /**
+     * 获取一个 Worker
+     */
+    async acquire() {
+        if (this.destroying) {
+            throw new AOTUIError('WORKER_TERMINATED', { reason: 'Pool is being destroyed' });
+        }
+        // 1. 优先复用空闲 Worker
+        const worker = this.idleWorkers.pop();
+        if (worker) {
+            // 验证 Worker 是否存活 (简单检查 exitCode)
+            if (worker.threadId < 0) { // 已退出
+                return this.acquire(); // 递归重试
+            }
+            this.activeWorkerCount++;
+            return worker;
+        }
+        // 2. 如果没达到最大限制，创建新 Worker
+        if (this.activeWorkerCount < this.config.maxSize) {
+            this.activeWorkerCount++;
+            return this.createWorker();
+        }
+        // 3. TODO: 如果达到最大限制，等待 (暂未实现，直接创建但警告)
+        console.warn('[WorkerPool] Pool exhausted, creating overflow worker');
+        this.activeWorkerCount++;
+        return this.createWorker();
+    }
+    /**
+     * 归还 Worker 到池中
+     *
+     * @param worker 要归还的 Worker
+     * @param isValid 是否仍然有效 (如果发生致命错误，应设为 false)
+     */
+    release(worker, isValid = true) {
+        this.activeWorkerCount--;
+        if (this.destroying || !isValid) {
+            worker.terminate();
+            return;
+        }
+        // 如果池已满，直接销毁
+        // 注意: 这里简单判断 idle + active 是否超过 max? 
+        // 实际上应该判断 idle 是否过多。
+        if (this.idleWorkers.length >= this.config.maxSize) {
+            worker.terminate();
+            return;
+        }
+        this.idleWorkers.push(worker);
+    }
+    /**
+     * 销毁池
+     */
+    async destroy() {
+        this.destroying = true;
+        await Promise.all(this.idleWorkers.map(w => w.terminate()));
+        this.idleWorkers = [];
+    }
+    createWorker() {
+        const worker = new Worker(this.config.workerScript, {
+            workerData: {
+            // 可以在这里传递通用配置
+            }
+        });
+        // 监听错误，防止僵尸进程
+        worker.on('error', (err) => {
+            console.error('[WorkerPool] Worker error:', err);
+            // 移除引用
+            const idx = this.idleWorkers.indexOf(worker);
+            if (idx >= 0) {
+                this.idleWorkers.splice(idx, 1);
+            }
+        });
+        worker.on('exit', (code) => {
+            // 移除引用
+            const idx = this.idleWorkers.indexOf(worker);
+            if (idx >= 0) {
+                this.idleWorkers.splice(idx, 1);
+            }
+        });
+        return worker;
+    }
+}
+//# sourceMappingURL=worker-pool.js.map

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

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