@aotui/runtime 1.0.0

package/dist/engine/core/operation-log-formatter.js

@@ -0,0 +1,180 @@
+/**
+ * Operation Log Formatter
+ *
+ * Generates semantic, human-readable log messages from operation entries.
+ * Follows the WHO/WHEN/WHERE/WHAT pattern for clarity.
+ *
+ * [RFC-008] Operation Execution Optimization
+ *
+ * @module @aotui/runtime/engine/core
+ */
+// ============================================================================
+// Log ID Generator
+// ============================================================================
+let globalLogIdCounter = 0;
+/**
+ * Generate a unique log entry ID
+ */
+export function generateLogId() {
+    return `oplog_${Date.now()}_${++globalLogIdCounter}`;
+}
+// ============================================================================
+// Semantic Description Generator
+// ============================================================================
+/**
+ * Format an operation log entry into a semantic, human-readable string
+ *
+ * Format: `HH:MM:SS ✅/❌ [Actor] [Location] [Action] (Duration)`
+ *
+ * @param entry - The log entry to format
+ * @returns Formatted log string
+ *
+ * @example
+ * ```typescript
+ * const formatted = formatOperationLog(entry);
+ * // "15:32:45 ✅ Gemini in System-Chat/ChatView sent message "Hello..." (12ms)"
+ * ```
+ */
+export function formatOperationLog(entry) {
+    const time = new Date(entry.timestamp).toISOString().slice(11, 19); // HH:MM:SS
+    const status = entry.success ? '✅' : '❌';
+    const duration = `${entry.durationMs}ms`;
+    // Build location string
+    let location = '';
+    if (entry.appName && entry.viewName) {
+        location = `in ${entry.appName}/${entry.viewName}`;
+    }
+    else if (entry.appName) {
+        location = `on ${entry.appName}`;
+    }
+    else {
+        location = 'at Desktop level';
+    }
+    // Generate semantic description based on operation type
+    const opName = entry.operationName;
+    switch (opName) {
+        case 'dismount_view': {
+            const targetView = entry.keyArgs.viewId || entry.keyArgs.view_id || 'view';
+            const location = entry.appName ? `in ${entry.appName}` : 'at Desktop level';
+            return `${time} ${status} ${entry.actor} ${location} dismounted ${targetView} (${duration})`;
+        }
+        case 'open_app': {
+            const appId = entry.keyArgs.appId || 'app';
+            if (entry.success) {
+                return `${time} ${status} ${entry.actor} opened app ${appId} (${duration})`;
+            }
+            else {
+                return `${time} ${status} ${entry.actor} failed to open app ${appId}: ${entry.errorMessage} (${duration})`;
+            }
+        }
+        case 'close_app': {
+            const appId = entry.keyArgs.appId || 'app';
+            return `${time} ${status} ${entry.actor} closed app ${appId} (${duration})`;
+        }
+        case 'send_message': {
+            const content = entry.keyArgs.content || entry.keyArgs.message || '';
+            const preview = content
+                ? (content.length > 20 ? `${content.slice(0, 20)}...` : content)
+                : '';
+            if (entry.success) {
+                return `${time} ${status} ${entry.actor} ${location} sent message "${preview}" (${duration})`;
+            }
+            return `${time} ${status} ${entry.actor} ${location} failed to send message "${preview}": ${entry.errorMessage} (${duration})`;
+        }
+        default: {
+            // Generic format for unknown operations
+            const args = Object.entries(entry.keyArgs)
+                .slice(0, 3) // Limit to 3 args
+                .map(([k, v]) => `${k}=${v}`)
+                .join(', ');
+            const argsStr = args ? `(${args})` : '';
+            if (entry.success) {
+                return `${time} ${status} ${entry.actor} ${location} executed ${opName}${argsStr} (${duration})`;
+            }
+            else {
+                return `${time} ${status} ${entry.actor} ${location} failed ${opName}${argsStr}: ${entry.errorMessage} (${duration})`;
+            }
+        }
+    }
+}
+// ============================================================================
+// Log Entry Builder
+// ============================================================================
+/**
+ * Sanitize operation arguments for logging
+ *
+ * Removes sensitive data and converts values to strings.
+ * Only keeps first 50 chars of string values.
+ */
+function sanitizeArgs(args) {
+    const sanitized = {};
+    for (const [key, value] of Object.entries(args)) {
+        // Skip sensitive-looking keys
+        if (key.toLowerCase().includes('password') ||
+            key.toLowerCase().includes('token') ||
+            key.toLowerCase().includes('secret')) {
+            continue;
+        }
+        if (typeof value === 'string') {
+            sanitized[key] = value.length > 50 ? value.slice(0, 50) + '...' : value;
+        }
+        else if (typeof value === 'number' || typeof value === 'boolean') {
+            sanitized[key] = String(value);
+        }
+        else if (value === null || value === undefined) {
+            // Skip null/undefined
+        }
+        else {
+            // For objects/arrays, just note the type
+            sanitized[key] = `[${typeof value}]`;
+        }
+    }
+    return sanitized;
+}
+/**
+ * Build a complete OperationLogEntry from execution parameters
+ *
+ * @param params - Operation execution parameters
+ * @returns Complete log entry with semantic description
+ */
+export function buildOperationLogEntry(params) {
+    const keyArgs = sanitizeArgs(params.args);
+    const entry = {
+        id: generateLogId(),
+        actor: params.actor,
+        timestamp: Date.now(),
+        durationMs: params.durationMs,
+        desktopId: params.desktopId,
+        appId: params.appId,
+        appName: params.appName,
+        viewId: params.viewId,
+        viewName: params.viewName,
+        scope: params.scope,
+        operationName: params.operationName,
+        keyArgs,
+        success: params.success,
+        errorMessage: params.errorMessage,
+        semanticDescription: '' // Will be set below
+    };
+    // Generate semantic description
+    entry.semanticDescription = formatOperationLog(entry);
+    return entry;
+}
+// ============================================================================
+// Markdown Formatter for Snapshot
+// ============================================================================
+/**
+ * Format operation logs as Markdown list for snapshot inclusion
+ *
+ * @param logs - Array of log entries
+ * @returns Markdown formatted string
+ */
+export function formatLogsAsMarkdown(logs) {
+    if (logs.length === 0) {
+        return '';
+    }
+    return logs
+        .map(log => `- ${log.semanticDescription}`)
+        .join('\n');
+}
+//# sourceMappingURL=operation-log-formatter.js.map

package/dist/engine/core/operation-log-formatter.js.map

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

package/dist/engine/core/services/lock.service.d.ts

@@ -0,0 +1,33 @@
+import type { IDesktopLockService, LockInfo, DesktopID } from '../../../spi/index.js';
+/**
+ * 内存锁服务实现
+ *
+ * 职责: 管理 Desktop 互斥锁。
+ *
+ * 特性:
+ * - 纯内存存储 (Map)
+ * - 支持重入
+ * - 自动过期检查
+ * - 允许过期接管
+ *
+ * 可替换为分布式锁实现 (如 RedisLockService)
+ */
+export declare class InMemoryLockService implements IDesktopLockService {
+    private desktopExists;
+    private locks;
+    private readonly ttlMs;
+    constructor(desktopExists: (id: DesktopID) => boolean, options?: {
+        ttlMs?: number;
+    });
+    acquireLock(desktopId: DesktopID, ownerId: string): void;
+    releaseLock(desktopId: DesktopID, ownerId: string): void;
+    verifyLock(desktopId: DesktopID, ownerId: string): boolean;
+    refreshLock(desktopId: DesktopID, ownerId: string): void;
+    getLockInfo(desktopId: DesktopID): LockInfo | undefined;
+    /**
+     * [Internal] 清理指定 Desktop 的锁
+     * 当 Desktop 被销毁时调用
+     */
+    clearLock(desktopId: DesktopID): void;
+    private isLockValid;
+}

package/dist/engine/core/services/lock.service.js

@@ -0,0 +1,99 @@
+import { AOTUIError } from '../../../spi/core/errors.js';
+import { LOCK_DEFAULTS } from '../../../spi/config/index.js';
+/**
+ * 内存锁服务实现
+ *
+ * 职责: 管理 Desktop 互斥锁。
+ *
+ * 特性:
+ * - 纯内存存储 (Map)
+ * - 支持重入
+ * - 自动过期检查
+ * - 允许过期接管
+ *
+ * 可替换为分布式锁实现 (如 RedisLockService)
+ */
+export class InMemoryLockService {
+    desktopExists;
+    locks = new Map();
+    ttlMs;
+    constructor(
+    // 依赖注入: 检查 Desktop 是否存在
+    desktopExists, options) {
+        this.desktopExists = desktopExists;
+        this.ttlMs = options?.ttlMs ?? LOCK_DEFAULTS.ttlMs;
+    }
+    acquireLock(desktopId, ownerId) {
+        if (!this.desktopExists(desktopId)) {
+            throw new AOTUIError('DESKTOP_NOT_FOUND', { desktopId });
+        }
+        const lock = this.locks.get(desktopId);
+        if (lock) {
+            // 1. 检查是否过期
+            if (!this.isLockValid(lock)) {
+                // Lock expired, allowing takeover
+                // [Strategy] Silent takeover (Last Writer Wins)
+                this.locks.set(desktopId, { ownerId, timestamp: Date.now() });
+                return;
+            }
+            // 2. 检查所有者
+            if (lock.ownerId !== ownerId) {
+                // 有效锁被他人持有 -> 拒绝
+                throw new AOTUIError('DESKTOP_LOCKED', {
+                    desktopId,
+                    ownerId: lock.ownerId,
+                    claimant: ownerId,
+                });
+            }
+            // 3. 重入: 刷新时间戳
+            lock.timestamp = Date.now();
+        }
+        else {
+            // 4. 新锁
+            this.locks.set(desktopId, { ownerId, timestamp: Date.now() });
+        }
+    }
+    releaseLock(desktopId, ownerId) {
+        const lock = this.locks.get(desktopId);
+        // 仅 Owner 可释放
+        if (lock && lock.ownerId === ownerId) {
+            this.locks.delete(desktopId);
+        }
+    }
+    verifyLock(desktopId, ownerId) {
+        const lock = this.locks.get(desktopId);
+        if (!lock)
+            return false;
+        if (!this.isLockValid(lock))
+            return false;
+        return lock.ownerId === ownerId;
+    }
+    refreshLock(desktopId, ownerId) {
+        const lock = this.locks.get(desktopId);
+        // 仅 Owner 可刷新
+        if (lock && lock.ownerId === ownerId) {
+            lock.timestamp = Date.now();
+        }
+    }
+    getLockInfo(desktopId) {
+        const lock = this.locks.get(desktopId);
+        if (!lock)
+            return undefined;
+        return {
+            ownerId: lock.ownerId,
+            acquiredAt: lock.timestamp,
+            valid: this.isLockValid(lock)
+        };
+    }
+    /**
+     * [Internal] 清理指定 Desktop 的锁
+     * 当 Desktop 被销毁时调用
+     */
+    clearLock(desktopId) {
+        this.locks.delete(desktopId);
+    }
+    isLockValid(lock) {
+        return Date.now() - lock.timestamp < this.ttlMs;
+    }
+}
+//# sourceMappingURL=lock.service.js.map

package/dist/engine/core/services/lock.service.js.map

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

package/dist/engine/core/signal-bus.d.ts

@@ -0,0 +1,84 @@
+/**
+ * SignalBus - Desktop 信号发布订阅
+ *
+ * [H1 拆分] 从 Desktop 提取的信号管理模块。
+ *
+ * 职责:
+ * - 管理 UpdateSignal 订阅者
+ * - 发布信号到订阅者
+ * - 管理 MutationObserver 并触发 dom_mutation 信号
+ */
+import type { DesktopID, UpdateSignal } from '../../spi/index.js';
+export type SignalListener = (signal: UpdateSignal) => void;
+/**
+ * SignalBus 配置
+ */
+export interface SignalBusOptions {
+    /** 是否在 emit 时 catch 异常，默认 true */
+    catchErrors?: boolean;
+}
+/**
+ * SignalBus - 统一管理所有 Desktop 的信号发布订阅
+ */
+export declare class SignalBus {
+    private states;
+    private options;
+    constructor(options?: SignalBusOptions);
+    /**
+     * 订阅指定 Desktop 的信号
+     *
+     * @param desktopId Desktop ID
+     * @param listener 信号处理函数
+     * @returns 取消订阅的函数
+     */
+    subscribe(desktopId: DesktopID, listener: SignalListener): () => void;
+    /**
+     * 取消订阅
+     */
+    unsubscribe(desktopId: DesktopID, listener: SignalListener): void;
+    /**
+     * 发布信号到指定 Desktop 的所有订阅者
+     */
+    emit(desktopId: DesktopID, signal: UpdateSignal): void;
+    /**
+     * 便捷方法：发布带原因的信号
+     */
+    emitSignal(desktopId: DesktopID, reason: UpdateSignal['reason']): void;
+    /**
+     * 绑定 MutationObserver 到 Document
+     *
+     * 当 DOM 变化时自动发布 'dom_mutation' 信号
+     *
+     * @param desktopId Desktop ID
+     * @param window linkedom window 对象
+     */
+    observeDOM(desktopId: DesktopID, window: any): void;
+    /**
+     * 停止观察 DOM
+     */
+    stopObserving(desktopId: DesktopID): void;
+    /**
+     * 清理指定 Desktop 的所有状态
+     */
+    cleanup(desktopId: DesktopID): void;
+    /**
+     * 获取订阅者数量（用于调试）
+     */
+    getListenerCount(desktopId: DesktopID): number;
+    private getOrCreateState;
+}
+/**
+ * SignalOutputStream 兼容接口
+ *
+ * 用于保持 Desktop.output 的 API 兼容
+ */
+export interface SignalOutputStream {
+    subscribe(listener: SignalListener): void;
+    unsubscribe(listener: SignalListener): void;
+}
+/**
+ * 创建 SignalOutputStream 适配器
+ *
+ * 将 SignalBus 的 per-desktop subscribe 适配为原有 API
+ */
+export declare function createSignalOutputStream(bus: SignalBus, desktopId: DesktopID): SignalOutputStream;

package/dist/engine/core/signal-bus.js

@@ -0,0 +1,160 @@
+/**
+ * SignalBus - Desktop 信号发布订阅
+ *
+ * [H1 拆分] 从 Desktop 提取的信号管理模块。
+ *
+ * 职责:
+ * - 管理 UpdateSignal 订阅者
+ * - 发布信号到订阅者
+ * - 管理 MutationObserver 并触发 dom_mutation 信号
+ */
+/**
+ * SignalBus - 统一管理所有 Desktop 的信号发布订阅
+ */
+export class SignalBus {
+    states = new Map();
+    options;
+    constructor(options) {
+        this.options = {
+            catchErrors: options?.catchErrors ?? true
+        };
+    }
+    /**
+     * 订阅指定 Desktop 的信号
+     *
+     * @param desktopId Desktop ID
+     * @param listener 信号处理函数
+     * @returns 取消订阅的函数
+     */
+    subscribe(desktopId, listener) {
+        const state = this.getOrCreateState(desktopId);
+        state.listeners.add(listener);
+        return () => {
+            state.listeners.delete(listener);
+        };
+    }
+    /**
+     * 取消订阅
+     */
+    unsubscribe(desktopId, listener) {
+        const state = this.states.get(desktopId);
+        if (state) {
+            state.listeners.delete(listener);
+        }
+    }
+    /**
+     * 发布信号到指定 Desktop 的所有订阅者
+     */
+    emit(desktopId, signal) {
+        const state = this.states.get(desktopId);
+        if (!state)
+            return;
+        state.listeners.forEach(listener => {
+            if (this.options.catchErrors) {
+                try {
+                    listener(signal);
+                }
+                catch (e) {
+                    console.error('[SignalBus] Error in signal listener:', e);
+                }
+            }
+            else {
+                listener(signal);
+            }
+        });
+    }
+    /**
+     * 便捷方法：发布带原因的信号
+     */
+    emitSignal(desktopId, reason) {
+        this.emit(desktopId, {
+            desktopId,
+            timestamp: Date.now(),
+            reason
+        });
+    }
+    /**
+     * 绑定 MutationObserver 到 Document
+     *
+     * 当 DOM 变化时自动发布 'dom_mutation' 信号
+     *
+     * @param desktopId Desktop ID
+     * @param window linkedom window 对象
+     */
+    observeDOM(desktopId, window) {
+        const state = this.getOrCreateState(desktopId);
+        // 如果已有 observer，先停止
+        if (state.observer) {
+            state.observer.disconnect();
+        }
+        // [Worker-Only Fix] LinkedOM 可能没有 MutationObserver，跳过
+        const MutationObserver = window?.MutationObserver;
+        if (!MutationObserver) {
+            console.log(`[SignalBus] MutationObserver not available for desktop ${desktopId}, skipping DOM observation`);
+            return;
+        }
+        // 创建新的 MutationObserver
+        const observer = new MutationObserver(() => {
+            this.emit(desktopId, {
+                desktopId,
+                timestamp: Date.now(),
+                reason: 'dom_mutation'
+            });
+        });
+        state.observer = observer;
+        // 开始观察
+        observer.observe(window.document.body, {
+            childList: true,
+            subtree: true,
+            attributes: true,
+            characterData: true
+        });
+    }
+    /**
+     * 停止观察 DOM
+     */
+    stopObserving(desktopId) {
+        const state = this.states.get(desktopId);
+        if (state?.observer) {
+            state.observer.disconnect();
+            state.observer = null;
+        }
+    }
+    /**
+     * 清理指定 Desktop 的所有状态
+     */
+    cleanup(desktopId) {
+        this.stopObserving(desktopId);
+        this.states.delete(desktopId);
+    }
+    /**
+     * 获取订阅者数量（用于调试）
+     */
+    getListenerCount(desktopId) {
+        return this.states.get(desktopId)?.listeners.size ?? 0;
+    }
+    // ---- 私有方法 ----
+    getOrCreateState(desktopId) {
+        let state = this.states.get(desktopId);
+        if (!state) {
+            state = {
+                listeners: new Set(),
+                observer: null
+            };
+            this.states.set(desktopId, state);
+        }
+        return state;
+    }
+}
+/**
+ * 创建 SignalOutputStream 适配器
+ *
+ * 将 SignalBus 的 per-desktop subscribe 适配为原有 API
+ */
+export function createSignalOutputStream(bus, desktopId) {
+    return {
+        subscribe: (listener) => { bus.subscribe(desktopId, listener); },
+        unsubscribe: (listener) => { bus.unsubscribe(desktopId, listener); }
+    };
+}
+//# sourceMappingURL=signal-bus.js.map

package/dist/engine/core/signal-bus.js.map

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

package/dist/engine/core/signal-service.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Engine Layer - Signal Bus Adapter
+ *
+ * [Option B] ISignalService 的实现。
+ *
+ * 将现有 SignalBus 适配为 ISignalService 接口，
+ * 实现 Desktop 解耦。
+ *
+ * @module @aotui/runtime/engine/core
+ */
+import type { ISignalService, SignalListener, DesktopID } from '../../spi/index.js';
+import { SignalBus } from './signal-bus.js';
+/**
+ * Signal Service 实现
+ *
+ * 基于现有 SignalBus 实现 ISignalService 接口。
+ *
+ * @example
+ * ```typescript
+ * const signalService = new SignalServiceImpl();
+ *
+ * const unsubscribe = signalService.subscribe(desktopId, (signal) => {
+ *     console.log('Signal:', signal.reason);
+ * });
+ *
+ * signalService.emit(desktopId, 'dom_mutation');
+ * ```
+ */
+export declare class SignalServiceImpl implements ISignalService {
+    /** 内部 SignalBus 实例 */
+    private bus;
+    constructor(bus?: SignalBus);
+    subscribe(desktopId: DesktopID, listener: SignalListener): () => void;
+    emit(desktopId: DesktopID, reason: string): void;
+    cleanup(desktopId: DesktopID): void;
+    /**
+     * 获取底层 SignalBus
+     *
+     * 用于需要直接访问 SignalBus 的场景 (如 Desktop.output)
+     */
+    getBus(): SignalBus;
+}

package/dist/engine/core/signal-service.js

@@ -0,0 +1,58 @@
+/**
+ * Engine Layer - Signal Bus Adapter
+ *
+ * [Option B] ISignalService 的实现。
+ *
+ * 将现有 SignalBus 适配为 ISignalService 接口，
+ * 实现 Desktop 解耦。
+ *
+ * @module @aotui/runtime/engine/core
+ */
+import { SignalBus } from './signal-bus.js';
+// ============================================================================
+// Signal Service Implementation
+// ============================================================================
+/**
+ * Signal Service 实现
+ *
+ * 基于现有 SignalBus 实现 ISignalService 接口。
+ *
+ * @example
+ * ```typescript
+ * const signalService = new SignalServiceImpl();
+ *
+ * const unsubscribe = signalService.subscribe(desktopId, (signal) => {
+ *     console.log('Signal:', signal.reason);
+ * });
+ *
+ * signalService.emit(desktopId, 'dom_mutation');
+ * ```
+ */
+export class SignalServiceImpl {
+    /** 内部 SignalBus 实例 */
+    bus;
+    constructor(bus) {
+        this.bus = bus ?? new SignalBus();
+    }
+    subscribe(desktopId, listener) {
+        return this.bus.subscribe(desktopId, listener);
+    }
+    emit(desktopId, reason) {
+        this.bus.emitSignal(desktopId, reason);
+    }
+    cleanup(desktopId) {
+        this.bus.cleanup(desktopId);
+    }
+    // ─────────────────────────────────────────────────────────────
+    //  Additional Methods (for compatibility)
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * 获取底层 SignalBus
+     *
+     * 用于需要直接访问 SignalBus 的场景 (如 Desktop.output)
+     */
+    getBus() {
+        return this.bus;
+    }
+}
+//# sourceMappingURL=signal-service.js.map