@aotui/runtime 1.0.0

package/dist/engine/app/manager.d.ts

@@ -0,0 +1,194 @@
+/**
+ * AppManager - App 安装与生命周期管理
+ *
+ * [Worker-Only] 重构为使用 WorkerSandbox 实现 App 隔离
+ *
+ * 职责:
+ * - App 安装 (Worker 模式)
+ * - App 生命周期 (open/close/pause/resume)
+ * - App 状态查询
+ * - 管理 WorkerSandbox 集合
+ *
+ * 设计说明:
+ * - 每个 App 在独立的 Worker Thread 中运行
+ * - 通过 mirrorDOM 实现主线程 DOM 同步
+ * - AppManager 持有 Desktop 引用用于日志和信号
+ */
+import type { AppID, AppState, IDesktop } from '../../spi/index.js';
+import { WorkerSandbox } from './worker-sandbox.js';
+/**
+ * 已安装的 App 信息
+ */
+export interface InstalledApp {
+    appId: AppID;
+    name?: string;
+    /** [RFC-013] App 描述 - 告诉 Agent 什么时候使用此 App */
+    description?: string;
+    /** App 是什么 (用于 Desktop State 展示) */
+    whatItIs?: string;
+    /** 什么时候用 (用于 Desktop State 展示) */
+    whenToUse?: string;
+    html: string;
+    /**
+     * [RFC-014] App 状态
+     * - 'pending': 已注册但未启动 (懒加载)
+     * - 'running': 正在运行
+     * - 'closed': 已关闭
+     * - 'collapsed': 已折叠
+     */
+    status: 'pending' | 'running' | 'closed' | 'collapsed';
+    installedAt: number;
+    /** [RFC-014] 懒加载: 模块路径 */
+    modulePath?: string;
+    /** [RFC-014] 懒加载: Worker 脚本路径 */
+    workerScript?: string;
+    /** [RFC-014] 消息角色 */
+    promptRole?: 'user' | 'assistant';
+}
+export interface AppManagerOptions {
+    /** App 安装回调 */
+    onAppInstalled?: (appId: AppID) => void;
+    /** App 移除回调 */
+    onAppRemoved?: (appId: AppID) => void;
+}
+export declare class AppManager {
+    /** [Worker-Only] WorkerSandbox 集合 - 核心隔离机制 */
+    private workers;
+    /** 已安装 App 元数据 (用于序列化和状态查询) */
+    private installedApps;
+    /** App ID 计数器 */
+    private appIdCounter;
+    /** 配置选项 */
+    private options;
+    /** Desktop 引用 (用于日志和信号) */
+    private readonly desktop;
+    constructor(desktop: IDesktop, options?: AppManagerOptions);
+    /**
+     * [Worker-Only] 安装 App
+     *
+     * App 运行在独立的 Worker Thread 中，通过 IPC 通信
+     *
+     * [C1 Fix] workerScriptPath 现在是可选的，默认使用 Runtime 内置的 worker-runtime
+     */
+    install(appModulePath: string, options?: {
+        workerScriptPath?: string;
+        appId?: AppID;
+        name?: string;
+        /** [RFC-013] App description for Agent */
+        description?: string;
+        /** App 是什么 */
+        whatItIs?: string;
+        /** 什么时候用 */
+        whenToUse?: string;
+        config?: import('../../spi/app/app-config.interface.js').AppLaunchConfig;
+        runtimeConfig?: import('../../spi/config/index.js').RuntimeConfig;
+        /** [RFC-014] App Role */
+        promptRole?: 'user' | 'assistant';
+    }): Promise<AppID>;
+    /**
+     * [RFC-014] 注册待启动 App (懒加载)
+     *
+     * App 信息写入 installedApps，但不启动 Worker。
+     * Agent 可以在 Snapshot 中看到这些 App，并通过 open_app 启动。
+     */
+    registerPendingApp(options: {
+        appId?: AppID;
+        name?: string;
+        description?: string;
+        whatItIs?: string;
+        whenToUse?: string;
+        modulePath: string;
+        workerScriptPath?: string;
+        promptRole?: 'user' | 'assistant';
+    }): AppID;
+    /**
+     * [RFC-014] 启动待启动 App
+     *
+     * 将 pending 状态的 App 真正安装并启动 Worker
+     */
+    startPendingApp(appId: AppID): Promise<boolean>;
+    /**
+     * 暂停所有 App
+     */
+    pauseAll(): Promise<void>;
+    /**
+     * 恢复所有 App
+     */
+    resumeAll(): Promise<void>;
+    /**
+     * 关闭所有 App
+     */
+    closeAll(): Promise<void>;
+    /**
+     * [RFC-015] 删除所有 App
+     *
+     * 1. 触发每个 App 的 onDelete (数据清理)
+     * 2. 关闭并销毁 Worker
+     */
+    deleteAll(): Promise<void>;
+    /**
+     * 打开指定 App (显示已关闭/折叠的 App)
+     */
+    openApp(appId: AppID): Promise<void>;
+    /**
+     * 关闭指定 App (隐藏 UI)
+     */
+    closeApp(appId: AppID): Promise<void>;
+    /**
+     * 折叠指定 App
+     */
+    collapseApp(appId: AppID): Promise<void>;
+    /**
+     * 显示指定 App (从折叠状态恢复)
+     */
+    showApp(appId: AppID): Promise<void>;
+    /**
+     * 获取所有 Workers
+     */
+    getAllWorkers(): Map<AppID, WorkerSandbox>;
+    /**
+     * 获取所有已安装 App
+     */
+    getInstalledApps(): InstalledApp[];
+    /**
+     * 获取动态 App ID 列表
+     */
+    getDynamicAppIds(): AppID[];
+    /**
+     * 获取 App 状态列表
+     */
+    getAppStates(): AppState[];
+    /**
+     * 获取 WorkerSandbox
+     */
+    getWorkerSandbox(appId: AppID): WorkerSandbox | undefined;
+    /**
+     * 检查 App 是否运行在 Worker 模式
+     *
+     * 在 Worker-Only 架构下，始终返回 true
+     */
+    isWorkerMode(appId: AppID): boolean;
+    /**
+     * [RFC-011] Broadcast LLM text to all Workers
+     * [RFC-020] Now accepts structured payload { reasoning?, content? }
+     *
+     * Called by Desktop when LLMOutputChannelService receives new text.
+     */
+    broadcastLLMOutput(payload: {
+        reasoning?: string;
+        content?: string;
+    }, type: 'complete', meta?: {
+        model?: string;
+        providerId?: string;
+        modelId?: string;
+        usage?: {
+            promptTokens: number;
+            completionTokens: number;
+            totalTokens: number;
+        };
+    }): void;
+    /**
+     * 清理所有 Worker
+     */
+    cleanup(): void;
+}

package/dist/engine/app/manager.js

@@ -0,0 +1,340 @@
+/**
+ * AppManager - App 安装与生命周期管理
+ *
+ * [Worker-Only] 重构为使用 WorkerSandbox 实现 App 隔离
+ *
+ * 职责:
+ * - App 安装 (Worker 模式)
+ * - App 生命周期 (open/close/pause/resume)
+ * - App 状态查询
+ * - 管理 WorkerSandbox 集合
+ *
+ * 设计说明:
+ * - 每个 App 在独立的 Worker Thread 中运行
+ * - 通过 mirrorDOM 实现主线程 DOM 同步
+ * - AppManager 持有 Desktop 引用用于日志和信号
+ */
+import { createAppId } from '../../spi/index.js';
+import { WorkerSandbox } from './worker-sandbox.js';
+export class AppManager {
+    // ════════════════════════════════════════════════════════════════
+    //  Private State
+    // ════════════════════════════════════════════════════════════════
+    /** [Worker-Only] WorkerSandbox 集合 - 核心隔离机制 */
+    workers = new Map();
+    /** 已安装 App 元数据 (用于序列化和状态查询) */
+    installedApps = new Map();
+    /** App ID 计数器 */
+    appIdCounter = 0;
+    /** 配置选项 */
+    options;
+    /** Desktop 引用 (用于日志和信号) */
+    desktop;
+    // ════════════════════════════════════════════════════════════════
+    //  Constructor
+    // ════════════════════════════════════════════════════════════════
+    constructor(desktop, options) {
+        this.desktop = desktop;
+        this.options = options || {};
+    }
+    // ════════════════════════════════════════════════════════════════
+    //  安装方法
+    // ════════════════════════════════════════════════════════════════
+    /**
+     * [Worker-Only] 安装 App
+     *
+     * App 运行在独立的 Worker Thread 中，通过 IPC 通信
+     *
+     * [C1 Fix] workerScriptPath 现在是可选的，默认使用 Runtime 内置的 worker-runtime
+     */
+    async install(appModulePath, options) {
+        // 分配 ID
+        const appId = options?.appId ?? createAppId(this.appIdCounter++);
+        // 创建 WorkerSandbox
+        const workerSandbox = new WorkerSandbox({
+            appId,
+            desktopId: this.desktop.id,
+            name: options?.name,
+            appModulePath,
+            workerScriptPath: options?.workerScriptPath,
+            config: options?.config, // ✨ 传递配置
+            runtimeConfig: options?.runtimeConfig, // [RFC-005] Pass configuration
+        });
+        // 设置更新回调
+        workerSandbox.onUpdateRequest = () => {
+            this.desktop.emitSignal('manual_refresh');
+        };
+        // 启动 Worker 并打开 App
+        await workerSandbox.installDynamic();
+        // [RFC-001 Phase 2] Removed Mirror DOM initialization and initial HTML push
+        // Worker now uses Snapshot Fragment protocol exclusively.
+        // 注册
+        this.workers.set(appId, workerSandbox);
+        // 记录元数据
+        this.installedApps.set(appId, {
+            appId,
+            name: options?.name,
+            description: options?.description, // [RFC-013]
+            whatItIs: options?.whatItIs,
+            whenToUse: options?.whenToUse,
+            html: '', // 初始为空，之后通过 mirrorDOM 同步
+            status: 'running',
+            installedAt: Date.now(),
+            promptRole: options?.promptRole,
+        });
+        this.desktop.logSystem(`Installed Worker app: ${appId}`);
+        this.desktop.emitSignal('app_opened');
+        this.options.onAppInstalled?.(appId);
+        return appId;
+    }
+    /**
+     * [RFC-014] 注册待启动 App (懒加载)
+     *
+     * App 信息写入 installedApps，但不启动 Worker。
+     * Agent 可以在 Snapshot 中看到这些 App，并通过 open_app 启动。
+     */
+    registerPendingApp(options) {
+        const appId = options.appId ?? createAppId(this.appIdCounter++);
+        this.installedApps.set(appId, {
+            appId,
+            name: options.name,
+            description: options.description,
+            whatItIs: options.whatItIs,
+            whenToUse: options.whenToUse,
+            html: '',
+            status: 'pending',
+            installedAt: Date.now(),
+            modulePath: options.modulePath,
+            workerScript: options.workerScriptPath,
+            promptRole: options.promptRole,
+        });
+        this.desktop.logSystem(`Registered pending app: ${appId} (${options.name ?? 'unnamed'})`);
+        return appId;
+    }
+    /**
+     * [RFC-014] 启动待启动 App
+     *
+     * 将 pending 状态的 App 真正安装并启动 Worker
+     */
+    async startPendingApp(appId) {
+        const app = this.installedApps.get(appId);
+        if (!app) {
+            console.warn(`[AppManager] Cannot start ${appId}: not found`);
+            return false;
+        }
+        if (app.status !== 'pending') {
+            console.warn(`[AppManager] App ${appId} is not pending (status: ${app.status})`);
+            return false;
+        }
+        if (!app.modulePath) {
+            console.error(`[AppManager] Cannot start ${appId}: missing modulePath`);
+            return false;
+        }
+        // 真正安装 Worker
+        await this.install(app.modulePath, {
+            appId,
+            name: app.name,
+            description: app.description,
+            workerScriptPath: app.workerScript,
+            promptRole: app.promptRole,
+        });
+        this.desktop.logSystem(`Started pending app: ${appId}`);
+        return true;
+    }
+    // ════════════════════════════════════════════════════════════════
+    //  生命周期方法
+    // ════════════════════════════════════════════════════════════════
+    /**
+     * 暂停所有 App
+     */
+    async pauseAll() {
+        for (const [appId, worker] of this.workers) {
+            if (worker.status === 'running') {
+                await worker.pause();
+            }
+        }
+    }
+    /**
+     * 恢复所有 App
+     */
+    async resumeAll() {
+        for (const [appId, worker] of this.workers) {
+            if (worker.status === 'paused') {
+                await worker.resume();
+            }
+        }
+    }
+    /**
+     * 关闭所有 App
+     */
+    async closeAll() {
+        for (const [appId, worker] of this.workers) {
+            await worker.close();
+            worker.dispose();
+            this.options.onAppRemoved?.(appId);
+        }
+        this.workers.clear();
+    }
+    /**
+     * [RFC-015] 删除所有 App
+     *
+     * 1. 触发每个 App 的 onDelete (数据清理)
+     * 2. 关闭并销毁 Worker
+     */
+    async deleteAll() {
+        for (const [appId, worker] of this.workers) {
+            await worker.delete();
+            worker.dispose();
+            this.options.onAppRemoved?.(appId);
+        }
+        this.workers.clear();
+    }
+    /**
+     * 打开指定 App (显示已关闭/折叠的 App)
+     */
+    async openApp(appId) {
+        // [RFC-014] Check if app is pending and start it
+        const app = this.installedApps.get(appId);
+        if (app?.status === 'pending') {
+            const started = await this.startPendingApp(appId);
+            if (!started) {
+                console.warn(`Failed to start pending app ${appId}`);
+                return;
+            }
+            // After start, worker should exist and status should be running
+        }
+        const worker = this.workers.get(appId);
+        if (!worker) {
+            console.warn(`App ${appId} not found.`);
+            return;
+        }
+        // [RFC-001 Phase 2] UI logic should be handled by Frontend/Product layer based on app status
+        if (app)
+            app.status = 'running';
+        this.desktop.logSystem(`Opened application: ${appId}`);
+        this.desktop.logAppOperation(appId, 'Application opened.');
+        this.desktop.emitSignal('app_opened');
+    }
+    /**
+     * 关闭指定 App (隐藏 UI)
+     */
+    async closeApp(appId) {
+        const worker = this.workers.get(appId);
+        if (!worker)
+            return;
+        // [RFC-001 Phase 2] UI logic should be handled by Frontend/Product layer based on app status
+        const app = this.installedApps.get(appId);
+        if (app)
+            app.status = 'closed';
+        this.desktop.logSystem(`Closed application: ${appId}`);
+        this.desktop.logAppOperation(appId, 'Application closed.');
+        this.desktop.emitSignal('dom_mutation');
+    }
+    /**
+     * 折叠指定 App
+     */
+    async collapseApp(appId) {
+        const worker = this.workers.get(appId);
+        if (!worker)
+            return;
+        // [RFC-001 Phase 2] UI logic should be handled by Frontend/Product layer based on app status
+        const app = this.installedApps.get(appId);
+        if (app)
+            app.status = 'collapsed';
+        this.desktop.logAppOperation(appId, 'Application collapsed.');
+        this.desktop.emitSignal('dom_mutation');
+    }
+    /**
+     * 显示指定 App (从折叠状态恢复)
+     */
+    async showApp(appId) {
+        const worker = this.workers.get(appId);
+        if (!worker)
+            return;
+        // [RFC-001 Phase 2] UI logic should be handled by Frontend/Product layer based on app status
+        const app = this.installedApps.get(appId);
+        if (app)
+            app.status = 'running';
+        this.desktop.logAppOperation(appId, 'Application shown.');
+        this.desktop.emitSignal('dom_mutation');
+    }
+    // ════════════════════════════════════════════════════════════════
+    //  查询方法
+    // ════════════════════════════════════════════════════════════════
+    /**
+     * 获取所有 Workers
+     */
+    getAllWorkers() {
+        return this.workers;
+    }
+    /**
+     * 获取所有已安装 App
+     */
+    getInstalledApps() {
+        return Array.from(this.installedApps.values());
+    }
+    /**
+     * 获取动态 App ID 列表
+     */
+    getDynamicAppIds() {
+        return Array.from(this.workers.keys());
+    }
+    /**
+     * 获取 App 状态列表
+     */
+    getAppStates() {
+        // [RFC-001 Phase 2] HTML is no longer available in AppManager (Headless)
+        // Clients should subscribe to Snapshots.
+        return Array.from(this.installedApps.entries()).map(([appId, app]) => ({
+            appId,
+            name: app.name,
+            html: app.html,
+            status: app.status,
+            installedAt: app.installedAt
+        }));
+    }
+    /**
+     * 获取 WorkerSandbox
+     */
+    getWorkerSandbox(appId) {
+        return this.workers.get(appId);
+    }
+    /**
+     * 检查 App 是否运行在 Worker 模式
+     *
+     * 在 Worker-Only 架构下，始终返回 true
+     */
+    isWorkerMode(appId) {
+        return this.workers.has(appId);
+    }
+    // ════════════════════════════════════════════════════════════════
+    //  [RFC-011] LLM Output Channel
+    // ════════════════════════════════════════════════════════════════
+    /**
+     * [RFC-011] Broadcast LLM text to all Workers
+     * [RFC-020] Now accepts structured payload { reasoning?, content? }
+     *
+     * Called by Desktop when LLMOutputChannelService receives new text.
+     */
+    broadcastLLMOutput(payload, type, meta) {
+        console.log(`[AppManager] Broadcasting LLM text to ${this.workers.size} workers`);
+        for (const [appId, worker] of this.workers) {
+            worker.pushLLMOutput(payload, type, meta);
+        }
+    }
+    // ════════════════════════════════════════════════════════════════
+    //  清理
+    // ════════════════════════════════════════════════════════════════
+    /**
+     * 清理所有 Worker
+     */
+    cleanup() {
+        for (const worker of this.workers.values()) {
+            worker.dispose();
+        }
+        this.workers.clear();
+        this.installedApps.clear();
+        this.appIdCounter = 0;
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/engine/app/manager.js.map

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

package/dist/engine/app/registry.d.ts

@@ -0,0 +1,138 @@
+/**
+ * App Registry
+ *
+ * 管理第三方 TUI App 的注册和加载。
+ *
+ * 职责:
+ * - 从 ~/.agentina/config.json 加载配置
+ * - 动态加载 App 模块
+ * - 为 Desktop 提供 App 安装服务
+ *
+ * @module @aotui/runtime/engine/app-registry
+ */
+import type { IDesktop, AppID, TUIAppFactory, AOAppManifest } from '../../spi/index.js';
+import type { TUIConfig } from './config.js';
+import type { AppLaunchConfig } from '../../spi/app/app-config.interface.js';
+export type { TUIConfig, AppConfigEntry } from './config.js';
+/**
+ * 已加载的 App 信息
+ */
+export interface LoadedApp {
+    /** App 名称 (来自 manifest) */
+    name: string;
+    /** App 清单 (传统模式) 或 undefined (方案 B kernelConfig 模式) */
+    manifest?: AOAppManifest;
+    /** 工厂对象 */
+    factory: TUIAppFactory;
+    /** 来源 */
+    source: string;
+}
+/**
+ * AppRegistry 配置
+ */
+export interface AppRegistryOptions {
+    /** 配置文件路径 (默认 ~/.agentina/config.json) */
+    configPath?: string;
+    /** 是否自动加载 (默认 true) */
+    autoLoad?: boolean;
+}
+/**
+ * App Registry
+ *
+ * 管理第三方 TUI App 的生命周期
+ *
+ * @example
+ * ```typescript
+ * const registry = new AppRegistry();
+ * await registry.loadFromConfig();
+ *
+ * // 为 Desktop 安装所有已注册的 App
+ * await registry.installAllTo(desktop);
+ * ```
+ */
+export declare class AppRegistry {
+    private apps;
+    private config;
+    private configPath;
+    constructor(options?: AppRegistryOptions);
+    /**
+     * 从配置文件加载所有 App
+     */
+    loadFromConfig(): Promise<void>;
+    /**
+     * 添加 App 到配置
+     *
+     * @param source 来源 (npm:xxx, local:xxx, git:xxx)
+     * @param options 选项
+     */
+    add(source: string, options?: {
+        force?: boolean;
+        alias?: string;
+    }): Promise<string>;
+    /**
+     * 注册临时 App (不保存到配置文件)
+     * 用于开发环境自动发现或运行时动态添加
+     */
+    registerTransient(source: string, options?: {
+        alias?: string;
+    }): Promise<string>;
+    /**
+     * 移除 App
+     */
+    remove(name: string): Promise<void>;
+    /**
+     * 列出所有已安装的 App
+     */
+    list(): LoadedApp[];
+    /**
+     * 获取已安装的 App
+     */
+    get(name: string): LoadedApp | undefined;
+    /**
+     * 检查 App 是否已安装
+     */
+    has(name: string): boolean;
+    /**
+     * 启用/禁用 App
+     */
+    setEnabled(name: string, enabled: boolean): Promise<void>;
+    /**
+     * [RFC-014] 设置 App 自动启动状态
+     *
+     * @param name - App 名称
+     * @param autoStart - 是否在 Desktop 创建时自动启动
+     */
+    setAutoStart(name: string, autoStart: boolean): Promise<void>;
+    /**
+     * [Option D] 为 Desktop 安装所有已注册的 App (配置驱动)
+     *
+     * 使用 config.json 中的 runtime.workerScript 作为默认 Worker 脚本，
+     * 各 App 可以通过 workerScript 字段覆盖。
+     *
+     * @param desktop - 目标 Desktop
+     * @param options - 可选配置
+     * @returns 已安装的 App ID 列表
+     */
+    installAll(desktop: IDesktop, options?: {
+        defaultWorkerScript?: string;
+        /** [RFC-025] Dynamic config to inject into all apps (e.g. projectPath) */
+        dynamicConfig?: AppLaunchConfig;
+    }): Promise<AppID[]>;
+    /**
+     * 解析模块路径
+     *
+     * [Fix] Now properly resolves directory paths to their entry points
+     * by checking aoapp.json, package.json, or defaulting to index.js
+     */
+    resolveModulePath(source: string): string | null;
+    /**
+     * 获取配置（用于调试）
+     */
+    getConfig(): TUIConfig;
+    private getDefaultConfigPath;
+    private readConfig;
+    private saveConfig;
+    private loadFactory;
+}
+export type { TUIAppFactory, AOAppManifest } from '../../spi/index.js';
+export { isTUIAppFactory, validateManifest, isValidAppName } from '../../spi/index.js';