@aotui/runtime 1.0.0

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

@@ -0,0 +1,189 @@
+/**
+ * Engine Layer - Worker App Host Service
+ *
+ * [Option B] IAppHostService 的 Worker-based 实现。
+ *
+ * 将原有 AppManager 的功能封装为 Service 接口，
+ * 解除 Desktop 对 AppManager 的直接依赖。
+ *
+ * 设计说明:
+ * - 每个 Desktop 有独立的 AppManager 实例
+ * - Service 管理所有 Desktop 的 App 托管
+ * - Signal 发射通过回调解耦
+ *
+ * @module @aotui/runtime/engine/app
+ */
+import { createAppId, createOperationId, createSnapshotId } from '../../spi/index.js';
+import { AOTUIError } from '../../spi/core/errors.js';
+import { WorkerSandbox } from './worker-sandbox.js';
+// ============================================================================
+// Worker App Host Service Implementation
+// ============================================================================
+/**
+ * Worker-based App Host Service
+ *
+ * 实现 IAppHostService，管理所有 Desktop 的 App 托管。
+ *
+ * @example
+ * ```typescript
+ * const appHost = new WorkerAppHostService();
+ * appHost.setSignalEmitter((desktopId, reason) => {
+ *     signalService.emit(desktopId, reason);
+ * });
+ *
+ * const appId = await appHost.install(desktopId, './app.js');
+ * ```
+ */
+export class WorkerAppHostService {
+    // ─────────────────────────────────────────────────────────────
+    //  Private State
+    // ─────────────────────────────────────────────────────────────
+    /** 每个 Desktop 的 App 状态 */
+    desktopStates = new Map();
+    /** Signal 发射器回调 */
+    signalEmitter = null;
+    // ─────────────────────────────────────────────────────────────
+    //  IAppHostService Implementation
+    // ─────────────────────────────────────────────────────────────
+    setSignalEmitter(emitter) {
+        this.signalEmitter = emitter;
+    }
+    async install(desktopId, modulePath, options) {
+        const state = this.getOrCreateState(desktopId);
+        // 分配 ID
+        const appId = options?.appId ?? createAppId(state.appIdCounter++);
+        // 创建 WorkerSandbox
+        const workerSandbox = new WorkerSandbox({
+            appId,
+            desktopId,
+            name: options?.name,
+            appModulePath: modulePath,
+            workerScriptPath: options?.workerScriptPath,
+            config: options?.config,
+        });
+        // 设置更新回调 - 通过 Signal Emitter 解耦
+        workerSandbox.onUpdateRequest = () => {
+            this.emitSignal(desktopId, 'manual_refresh');
+        };
+        // 启动 Worker
+        await workerSandbox.installDynamic();
+        // 注册
+        state.workers.set(appId, workerSandbox);
+        // 发射 App 安装信号
+        this.emitSignal(desktopId, 'app_opened');
+        return appId;
+    }
+    async executeOperation(desktopId, appId, payload) {
+        const sandbox = this.getWorkerSandbox(desktopId, appId);
+        if (!sandbox) {
+            throw new AOTUIError('APP_NOT_FOUND', { appId, desktopId });
+        }
+        await sandbox.executeOperation(createOperationId(payload.operation), payload.args || {}, createSnapshotId(payload.context.snapshotId || ''), payload.context.viewId);
+    }
+    async dismountView(desktopId, appId, viewId) {
+        const sandbox = this.getWorkerSandbox(desktopId, appId);
+        if (!sandbox) {
+            throw new AOTUIError('APP_NOT_FOUND', { appId, desktopId });
+        }
+        await sandbox.dismountView(viewId);
+        this.emitSignal(desktopId, 'dom_mutation');
+    }
+    getSnapshotFragments(desktopId) {
+        const state = this.desktopStates.get(desktopId);
+        if (!state)
+            return [];
+        const fragments = [];
+        for (const [appId, worker] of state.workers) {
+            const fragment = worker.getSnapshotFragment();
+            if (fragment) {
+                fragments.push({
+                    appId,
+                    markup: fragment.markup,
+                    indexMap: fragment.indexMap,
+                });
+            }
+        }
+        return fragments;
+    }
+    getAppInfo(desktopId, appId) {
+        const sandbox = this.getWorkerSandbox(desktopId, appId);
+        if (!sandbox)
+            return undefined;
+        return { name: sandbox.name };
+    }
+    hasApp(desktopId, appId) {
+        const state = this.desktopStates.get(desktopId);
+        return state?.workers.has(appId) ?? false;
+    }
+    async pauseAll(desktopId) {
+        const state = this.desktopStates.get(desktopId);
+        if (!state)
+            return;
+        for (const [, worker] of state.workers) {
+            if (worker.status === 'running') {
+                await worker.pause();
+            }
+        }
+    }
+    async resumeAll(desktopId) {
+        const state = this.desktopStates.get(desktopId);
+        if (!state)
+            return;
+        for (const [, worker] of state.workers) {
+            if (worker.status === 'paused') {
+                await worker.resume();
+            }
+        }
+    }
+    async closeAll(desktopId) {
+        const state = this.desktopStates.get(desktopId);
+        if (!state)
+            return;
+        for (const [, worker] of state.workers) {
+            await worker.close();
+            worker.dispose();
+        }
+        state.workers.clear();
+        // 清理 Desktop 状态
+        this.desktopStates.delete(desktopId);
+    }
+    // ─────────────────────────────────────────────────────────────
+    //  Additional Query Methods (for compatibility)
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * 获取指定 Desktop 的所有 Worker
+     *
+     * 用于 Desktop 的 getSnapshotFragments 等方法的向后兼容
+     */
+    getAllWorkers(desktopId) {
+        const state = this.desktopStates.get(desktopId);
+        return state?.workers ?? new Map();
+    }
+    /**
+     * 获取 WorkerSandbox
+     */
+    getWorkerSandbox(desktopId, appId) {
+        const state = this.desktopStates.get(desktopId);
+        return state?.workers.get(appId);
+    }
+    // ─────────────────────────────────────────────────────────────
+    //  Private Helpers
+    // ─────────────────────────────────────────────────────────────
+    getOrCreateState(desktopId) {
+        let state = this.desktopStates.get(desktopId);
+        if (!state) {
+            state = {
+                workers: new Map(),
+                appIdCounter: 0,
+            };
+            this.desktopStates.set(desktopId, state);
+        }
+        return state;
+    }
+    emitSignal(desktopId, reason) {
+        if (this.signalEmitter) {
+            this.signalEmitter(desktopId, reason);
+        }
+    }
+}
+//# sourceMappingURL=worker-app-host.service.js.map

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

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

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

@@ -0,0 +1,139 @@
+/**
+ * AppWorkerHost - 主线程端 Worker 管理器
+ *
+ * 管理一个 App 的 Worker Thread，处理：
+ * - Worker 启动/终止
+ * - 消息发送/接收
+ * - 请求-响应匹配
+ *
+ * @module @aotui/runtime/engine/app-worker
+ */
+import { Worker } from 'worker_threads';
+import type { AppID, DesktopID, ViewID, OperationID, OperationResult, SnapshotID } from '../../spi/index.js';
+import { type WorkerConfig } from '../../spi/config/index.js';
+import { type DataPayload } from '../../spi/worker-protocol/index.js';
+/**
+ * AppWorkerHost 配置
+ */
+/**
+ * AppWorkerHost 配置
+ */
+export interface AppWorkerHostConfig {
+    appId: AppID;
+    desktopId: DesktopID;
+    name?: string;
+    appModulePath: string;
+    /**
+     * Worker 脚本路径 (可选，默认使用 Runtime 内置 worker-runtime)
+     * [C1 Fix] 不再强制要求传入 SDK 内部路径
+     */
+    workerScriptPath?: string;
+    timeout?: number;
+    existingWorker?: Worker;
+    config?: import('../../spi/app/app-config.interface.js').AppLaunchConfig;
+    runtimeConfig?: {
+        worker: WorkerConfig;
+    };
+}
+/**
+ * Worker 状态
+ */
+export type WorkerStatus = 'starting' | 'ready' | 'running' | 'paused' | 'closed' | 'error';
+/**
+ * AppWorkerHost - 主线程端 Worker 管理
+ */
+export declare class AppWorkerHost {
+    readonly appId: AppID;
+    readonly desktopId: DesktopID;
+    readonly name?: string;
+    private readonly config?;
+    private worker;
+    private status;
+    private pendingRequests;
+    private readonly timeout;
+    private readonly appModulePath;
+    private readonly workerScriptPath;
+    onUpdateRequest?: () => void;
+    onMountChildRequest?: (viewId: ViewID) => Promise<void>;
+    onDismountChildRequest?: (viewId: ViewID) => Promise<void>;
+    private lastDomTimestamp;
+    private snapshotFragment;
+    constructor(config: AppWorkerHostConfig);
+    /**
+     * 启动 Worker 并初始化 App
+     */
+    start(): Promise<void>;
+    private bindWorkerListeners;
+    /**
+     * 释放 Worker (用于归还给 Pool)
+     *
+     * 会先发送 RESET 消息，成功后解绑监听器并返回 Worker 实例。
+     */
+    releaseWorker(): Promise<Worker | null>;
+    private cleanupPendingRequests;
+    /**
+     * 获取 Worker 状态
+     */
+    getStatus(): WorkerStatus;
+    /**
+     * [RFC-001] 获取缓存的 Snapshot Fragment
+     *
+     * 返回 Worker 最新推送的 Markdown + IndexMap + ViewTree，
+     * 供 Desktop 聚合为 Desktop-level Snapshot。
+     *
+     * [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;
+    open(): Promise<void>;
+    pause(): Promise<void>;
+    resume(): Promise<void>;
+    close(): Promise<void>;
+    /**
+     * [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().
+     */
+    delete(): Promise<void>;
+    dismountView(viewId: ViewID): Promise<void>;
+    /**
+     * [RFC-006] Mount view via ViewLink
+     */
+    mountViewByLink(parentViewId: ViewID, linkId: string): Promise<void>;
+    executeOperation(operation: OperationID, args: Record<string, unknown>, snapshotId: SnapshotID, viewId?: ViewID): Promise<OperationResult>;
+    sendExternalEvent(viewId: ViewID, eventType: string, data: Record<string, unknown>): Promise<void>;
+    /**
+     * [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: {
+        reasoning?: string;
+        content?: string;
+    }, type: 'complete', meta?: {
+        model?: string;
+        usage?: {
+            promptTokens: number;
+            completionTokens: number;
+            totalTokens: number;
+        };
+    }): void;
+    terminate(): void;
+    private sendRequest;
+    private handleMessage;
+    private handleError;
+    private handleExit;
+}