@aotui/runtime 1.0.0

package/dist/cli.js

@@ -0,0 +1,314 @@
+#!/usr/bin/env node
+/**
+ * agentina CLI - Third-Party App Management
+ *
+ * 命令:
+ *   agentina add <source>     安装 App
+ *   agentina remove <name>    卸载 App
+ *   agentina list             列出已安装
+ *   agentina enable <name>    启用 App
+ *   agentina disable <name>   禁用 App
+ *   agentina autostart <name> <on|off>  设置自动启动
+ *   agentina link <path>      链接本地开发目录
+ *   agentina run [name]       Run installed apps (or specific app)
+ *
+ * @module @aotui/cli
+ */
+import { AppRegistry } from './engine/app/index.js';
+import { createRuntime } from './facades/index.js';
+import * as readline from 'readline';
+const HELP = `
+Agentina App Manager
+
+Usage: agentina <command> [options]
+
+Commands:
+  link <path>          Link a local app directory
+  remove <name>        Uninstall an app
+  list                 List installed apps
+  enable <name>        Enable an app
+  disable <name>       Disable an app
+  autostart <name> <on|off>  Set auto-start behavior
+  run [name]           Run installed apps (or specific app)
+
+Options:
+  --force              Force link (overwrite existing)
+  --as <alias>         Link with a different name
+  --no-autostart       Link without auto-start
+  --help               Show help
+
+Examples:
+  agentina link .                     # Link current directory as an app
+  agentina link ./my-app              # Link a local app directory
+  agentina list                       # Show all installed apps
+  agentina run my-app                 # Run a specific app
+`;
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
+        console.log(HELP);
+        return;
+    }
+    const command = args[0];
+    const registry = new AppRegistry();
+    await registry.loadFromConfig();
+    try {
+        switch (command) {
+            case 'remove':
+                await handleRemove(registry, args.slice(1));
+                break;
+            case 'list':
+                handleList(registry);
+                break;
+            case 'enable':
+                await handleEnable(registry, args.slice(1), true);
+                break;
+            case 'disable':
+                await handleEnable(registry, args.slice(1), false);
+                break;
+            case 'link':
+                await handleLink(registry, args.slice(1));
+                break;
+            case 'autostart':
+                await handleAutoStart(registry, args.slice(1));
+                break;
+            case 'run':
+                await handleRun(registry, args.slice(1));
+                break;
+            default:
+                console.error(`Unknown command: ${command}`);
+                console.log(HELP);
+                process.exit(1);
+        }
+    }
+    catch (error) {
+        console.error(`Error: ${error.message}`);
+        process.exit(1);
+    }
+}
+// ════════════════════════════════════════════════════════════════
+//  Command Handlers
+// ════════════════════════════════════════════════════════════════
+async function handleRemove(registry, args) {
+    if (args.length === 0) {
+        console.error('Usage: agentina remove <name>');
+        process.exit(1);
+    }
+    const name = args[0];
+    await registry.remove(name);
+    console.log(`✅ Successfully removed: ${name}`);
+}
+function handleList(registry) {
+    const config = registry.getConfig();
+    const appNames = Object.keys(config.apps);
+    if (appNames.length === 0) {
+        console.log('No apps installed.');
+        console.log('');
+        console.log('Install an app with: tui add <package>');
+        return;
+    }
+    console.log('Installed apps:');
+    console.log('');
+    // Show all apps from config (including disabled ones)
+    for (const name of appNames) {
+        const entry = config.apps[name];
+        const loadedApp = registry.get(name);
+        // [RFC-014] Two-layer status: enabled + autoStart
+        const enabledStatus = entry.enabled ? '✅' : '❌';
+        const autoStartStatus = (entry.autoStart ?? true) ? '🚀' : '⏸️';
+        // Use loaded manifest if available, otherwise show basic info
+        if (loadedApp) {
+            // [方案 B] manifest 在 kernelConfig 模式下可能为 undefined
+            const displayName = loadedApp.manifest?.displayName ?? loadedApp.factory.displayName ?? name;
+            const version = loadedApp.manifest?.version ?? 'N/A';
+            console.log(`  ${enabledStatus}${autoStartStatus} ${displayName} (${name})`);
+            console.log(`     Version: ${version}`);
+        }
+        else {
+            console.log(`  ${enabledStatus}${autoStartStatus} ${name} (disabled)`);
+        }
+        console.log(`     Source: ${entry.source}`);
+        console.log('');
+    }
+    // [RFC-014] Legend
+    console.log('Legend: ✅=enabled ❌=disabled 🚀=auto-start ⏸️=manual-start');
+}
+async function handleEnable(registry, args, enable) {
+    if (args.length === 0) {
+        console.error(`Usage: agentina ${enable ? 'enable' : 'disable'} <name>`);
+        process.exit(1);
+    }
+    const name = args[0];
+    await registry.setEnabled(name, enable);
+    console.log(`✅ ${enable ? 'Enabled' : 'Disabled'}: ${name}`);
+}
+/**
+ * [RFC-014] Handle autostart command
+ */
+async function handleAutoStart(registry, args) {
+    if (args.length < 2) {
+        console.error('Usage: agentina autostart <name> <on|off>');
+        process.exit(1);
+    }
+    const name = args[0];
+    const value = args[1].toLowerCase();
+    if (value !== 'on' && value !== 'off') {
+        console.error('Value must be "on" or "off"');
+        process.exit(1);
+    }
+    await registry.setAutoStart(name, value === 'on');
+    console.log(`✅ Auto-start ${value === 'on' ? 'enabled' : 'disabled'}: ${name}`);
+}
+async function handleLink(registry, args) {
+    if (args.length === 0) {
+        console.error('Usage: agentina link <path>');
+        process.exit(1);
+    }
+    const localPath = args[0];
+    const path = await import('path');
+    const absolutePath = path.resolve(localPath);
+    console.log(`Linking ${absolutePath}...`);
+    const name = await registry.add(`local:${absolutePath}`);
+    console.log(`✅ Successfully linked: ${name}`);
+}
+async function handleRun(registry, args) {
+    const targetApp = args[0]; // Optional: run specific app
+    console.log('[TUI] Starting Runtime...');
+    const runtime = createRuntime();
+    const desktopId = await runtime.createDesktop();
+    const desktop = runtime.desktopManager.get(desktopId);
+    console.log(`[TUI] Desktop created: ${desktopId}`);
+    // [Fix] Move rl creation before signal subscription so callback can use it
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+        prompt: 'tui> '
+    });
+    let isInteractive = false;
+    // Auto-print snapshots on update
+    if (desktop.signalBus) {
+        desktop.signalBus.subscribe(desktopId, (signal) => {
+            // Filter relevant signals
+            if (signal.reason === 'dom_mutation' || signal.reason === 'manual_refresh' || signal.reason === 'app_opened') {
+                console.log('\n[TUI] UI Updated:');
+                const fragments = desktop.getSnapshotFragments();
+                fragments.forEach((f) => {
+                    console.log(`--- App ${f.appId} ---`);
+                    console.log(f.markup);
+                });
+                // Only prompt if in interactive loop
+                if (isInteractive) {
+                    rl.prompt(true);
+                }
+            }
+        });
+    }
+    // Install apps from registry
+    const config = registry.getConfig();
+    const appsToRun = targetApp ? [targetApp] : Object.keys(config.apps);
+    const runningAppIds = [];
+    for (const name of appsToRun) {
+        const entry = config.apps[name];
+        if (!entry) {
+            console.error(`App "${name}" not found in registry.`);
+            continue;
+        }
+        if (!entry.enabled && !targetApp) {
+            continue;
+        }
+        const loadedApp = registry.get(name);
+        if (!loadedApp) {
+            console.error(`App "${name}" could not be loaded (check if enabled or valid source).`);
+            continue;
+        }
+        // HACK: for local apps, source starts with local:
+        let realPath = loadedApp.source;
+        if (realPath.startsWith('local:')) {
+            realPath = realPath.substring(6);
+            // Resolve relative to cwd
+            const path = await import('path');
+            const fs = await import('fs');
+            const url = await import('url');
+            realPath = path.resolve(process.cwd(), realPath);
+            // Add dist/index.js if directory
+            if (fs.statSync(realPath).isDirectory()) {
+                realPath = path.join(realPath, 'dist/index.js');
+            }
+            // Convert to file URL
+            realPath = url.pathToFileURL(realPath).href;
+        }
+        console.log(`[TUI] Installing ${name} from ${realPath}...`);
+        try {
+            const appId = await desktop.installDynamicWorkerApp(realPath, {
+                name: name,
+                config: {} // TODO: support config injection
+            });
+            runningAppIds.push(appId);
+            console.log(`[TUI] Started ${name} (AppID: ${appId})`);
+            // Auto open
+            await desktop.appManager.openApp(appId);
+        }
+        catch (e) {
+            console.error(`[TUI] Failed to start ${name}: ${e.message}`);
+        }
+    }
+    if (runningAppIds.length === 0) {
+        console.log('[TUI] No apps started.');
+        process.exit(0);
+    }
+    console.log('[TUI] Runtime ready. Type JSON event to send, or "exit" to quit.');
+    console.log('Example: {"type":"EXTERNAL_EVENT", "eventType":"grep-result", "data":{"line":"foo"}}');
+    isInteractive = true;
+    rl.prompt();
+    rl.on('line', async (line) => {
+        const input = line.trim();
+        if (input === 'exit') {
+            rl.close();
+            process.exit(0);
+        }
+        if (input.startsWith('{')) {
+            try {
+                const event = JSON.parse(input);
+                if (event.type === 'EXTERNAL_EVENT') {
+                    // Send to all running apps
+                    for (const appId of runningAppIds) {
+                        const workerSandbox = desktop.appManager.workers.get(appId);
+                        if (workerSandbox && workerSandbox.workerHost) {
+                            workerSandbox.workerHost.worker.postMessage({
+                                type: 'EXTERNAL_EVENT',
+                                requestId: `cli_${Date.now()}`,
+                                viewId: event.viewId || 'view_0',
+                                eventType: event.eventType,
+                                data: event.data
+                            });
+                            console.log(`[TUI] Sent event to ${appId}`);
+                        }
+                    }
+                }
+                else {
+                    console.log('Unknown command. Support JSON with type="EXTERNAL_EVENT"');
+                }
+            }
+            catch (e) {
+                console.error('Invalid JSON');
+            }
+        }
+        else {
+            // Render Snapshot check
+            if (input === 'snapshot') {
+                const fragments = desktop.getSnapshotFragments();
+                fragments.forEach((f) => {
+                    console.log(`--- App ${f.appId} ---`);
+                    console.log(f.markup);
+                });
+            }
+        }
+        rl.prompt();
+    });
+}
+// Run
+main().catch(error => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

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

@@ -0,0 +1,81 @@
+/**
+ * TUI App Configuration Types
+ *
+ * 定义 ~/.agentina/config.json 的结构
+ *
+ * [Option D] Version 2 adds runtime.workerScript for config-driven Worker installation.
+ *
+ * @module @aotui/runtime/engine/app-registry
+ */
+/**
+ * 单个 App 的配置
+ */
+export interface AppConfigEntry {
+    /**
+     * 来源
+     * - npm:@scope/name -- npm 包
+     * - local:/path/to/app -- 本地目录
+     * - git:github:user/repo -- Git 仓库
+     */
+    source: string;
+    /** 版本约束 (仅 npm 来源有效) */
+    version?: string;
+    /** 是否启用 */
+    enabled: boolean;
+    /** 安装时间 */
+    installedAt?: string;
+    /** 别名 (用于解决命名冲突) */
+    alias?: string;
+    /**
+     * [Option D] 自定义 Worker 脚本路径 (可选)
+     * 为空时使用 runtime.workerScript 默认值
+     */
+    workerScript?: string;
+    /**
+     * App 简介 (兼容旧字段)
+     * - 建议使用 whatItIs + whenToUse
+     */
+    description?: string;
+    /** App 是什么 (用于 Desktop State 展示) */
+    whatItIs?: string;
+    /** 什么时候用 (用于 Desktop State 展示) */
+    whenToUse?: string;
+    /**
+     * [RFC-014] Desktop 创建时是否自动启动此 App
+     * - true: Desktop 创建时自动安装并启动 (默认行为)
+     * - false: App 已安装但不自动启动，需按需启动
+     * @default true
+     */
+    autoStart?: boolean;
+    /** [Fix] App 角色 */
+    promptRole?: 'user' | 'assistant';
+}
+/**
+ * [Option D] Runtime 配置
+ */
+export interface RuntimeConfig {
+    /**
+     * Worker 脚本的默认路径
+     * 所有 App 默认使用此脚本运行在 Worker 中
+     */
+    workerScript: string;
+}
+/**
+ * ~/.agentina/config.json 结构
+ *
+ * Version 1: 基础 App 配置
+ * Version 2: 增加 runtime.workerScript 配置
+ */
+export interface TUIConfig {
+    /** 配置版本 */
+    version: number;
+    /** [Option D] Runtime 配置 */
+    runtime?: RuntimeConfig;
+    /** 已安装的 App */
+    apps: Record<string, AppConfigEntry>;
+}
+/**
+ * 创建默认配置 (Version 2)
+ */
+export declare function createDefaultConfig(): TUIConfig;
+export declare function validateConfig(config: unknown): config is TUIConfig;

package/dist/engine/app/config.js

@@ -0,0 +1,32 @@
+/**
+ * TUI App Configuration Types
+ *
+ * 定义 ~/.agentina/config.json 的结构
+ *
+ * [Option D] Version 2 adds runtime.workerScript for config-driven Worker installation.
+ *
+ * @module @aotui/runtime/engine/app-registry
+ */
+/**
+ * 创建默认配置 (Version 2)
+ */
+export function createDefaultConfig() {
+    return {
+        version: 2,
+        runtime: {
+            workerScript: '' // 留空，由 Product Layer 设置
+        },
+        apps: {}
+    };
+}
+export function validateConfig(config) {
+    if (typeof config !== 'object' || config === null)
+        return false;
+    const c = config;
+    if (typeof c.version !== 'number')
+        return false;
+    if (typeof c.apps !== 'object' || c.apps === null)
+        return false;
+    return true;
+}
+//# sourceMappingURL=config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/engine/app/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAoFH;;GAEG;AACH,MAAM,UAAU,mBAAmB;IAC/B,OAAO;QACH,OAAO,EAAE,CAAC;QACV,OAAO,EAAE;YACL,YAAY,EAAE,EAAE,CAAC,wBAAwB;SAC5C;QACD,IAAI,EAAE,EAAE;KACX,CAAC;AACN,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAe;IAC1C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAEhE,MAAM,CAAC,GAAG,MAAiC,CAAC;IAC5C,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAChD,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAEhE,OAAO,IAAI,CAAC;AAChB,CAAC"}

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

@@ -0,0 +1,14 @@
+/**
+ * App Domain
+ *
+ * 包含 App 生命周期管理、注册机制、Worker 隔离及通信相关模块。
+ *
+ * @module @aotui/runtime/engine/app
+ */
+export { AppManager, type InstalledApp, type AppManagerOptions } from './manager.js';
+export { AppRegistry, type LoadedApp, type AppRegistryOptions, validateManifest, isValidAppName } from './registry.js';
+export { createDefaultConfig, validateConfig, type TUIConfig, type AppConfigEntry } from './config.js';
+export { WorkerSandbox, type WorkerSandboxConfig, type SandboxStatus } from './worker-sandbox.js';
+export { AppWorkerHost, type AppWorkerHostConfig, type WorkerStatus } from './worker-host.js';
+export { WorkerPool, type WorkerPoolConfig } from './worker-pool.js';
+export { WorkerAppHostService } from './worker-app-host.service.js';

package/dist/engine/app/index.js

@@ -0,0 +1,33 @@
+/**
+ * App Domain
+ *
+ * 包含 App 生命周期管理、注册机制、Worker 隔离及通信相关模块。
+ *
+ * @module @aotui/runtime/engine/app
+ */
+// ============================================================================
+// AppManager - App 生命周期管理
+// ============================================================================
+export { AppManager } from './manager.js';
+// ============================================================================
+// AppRegistry - 第三方 App 加载
+// ============================================================================
+export { AppRegistry, validateManifest, isValidAppName } from './registry.js';
+export { createDefaultConfig, validateConfig } from './config.js';
+// ============================================================================
+// WorkerSandbox - Worker 线程隔离
+// ============================================================================
+export { WorkerSandbox } from './worker-sandbox.js';
+// ============================================================================
+// AppWorkerHost - 主线程 IPC Host
+// ============================================================================
+export { AppWorkerHost } from './worker-host.js';
+// ============================================================================
+// WorkerPool - Worker 池管理
+// ============================================================================
+export { WorkerPool } from './worker-pool.js';
+// ============================================================================
+// WorkerAppHostService - IAppHostService 实现 (Option B)
+// ============================================================================
+export { WorkerAppHostService } from './worker-app-host.service.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/app/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAC/E,OAAO,EAAE,UAAU,EAA6C,MAAM,cAAc,CAAC;AAErF,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAC/E,OAAO,EAAE,WAAW,EAA2C,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACvH,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAuC,MAAM,aAAa,CAAC;AAEvG,+EAA+E;AAC/E,8BAA8B;AAC9B,+EAA+E;AAC/E,OAAO,EAAE,aAAa,EAAgD,MAAM,qBAAqB,CAAC;AAElG,+EAA+E;AAC/E,+BAA+B;AAC/B,+EAA+E;AAC/E,OAAO,EAAE,aAAa,EAA+C,MAAM,kBAAkB,CAAC;AAG9F,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAC/E,OAAO,EAAE,UAAU,EAAyB,MAAM,kBAAkB,CAAC;AAErE,+EAA+E;AAC/E,uDAAuD;AACvD,+EAA+E;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC"}