@aotui/runtime 1.0.0

package/dist/engine/system/registry.js

@@ -0,0 +1,101 @@
+import { createSnapshotId } from '../../spi/index.js';
+import { AOTUIError } from '../../spi/core/errors.js';
+export class SnapshotRegistry {
+    snapshots = new Map();
+    config;
+    constructor(config = { ttl: 10 * 60 * 1000 }) {
+        this.config = config;
+    }
+    /**
+     * Creates a new snapshot and registers it.
+     * Starts with RefCount = 1.
+     *
+     * [RFC-014] Now accepts optional structured parameter.
+     */
+    create(indexMap, markup, ttl, structured) {
+        const id = createSnapshotId();
+        // Use provided TTL or default config TTL
+        const effectiveTTL = ttl !== undefined && ttl > 0 ? ttl : this.config.ttl;
+        // Set Hard TTL safety timer
+        const timer = setTimeout(() => {
+            this.forceDestroy(id);
+        }, effectiveTTL);
+        const createdAt = Date.now();
+        const snapshot = {
+            id,
+            indexMap,
+            markup,
+            structured, // [RFC-014] Include structured output
+            createdAt,
+            refCount: 1,
+            ttl: effectiveTTL,
+            expiresAt: createdAt + effectiveTTL
+        };
+        this.snapshots.set(id, {
+            ...snapshot,
+            timer
+        });
+        return snapshot;
+    }
+    /**
+     * Increases reference count.
+     */
+    retain(id) {
+        const snap = this.snapshots.get(id);
+        if (!snap) {
+            throw new AOTUIError('SNAPSHOT_EXPIRED', { snapshotId: id });
+        }
+        snap.refCount++;
+    }
+    /**
+     * Decreases reference count. Destroys if 0.
+     */
+    release(id) {
+        const snap = this.snapshots.get(id);
+        if (!snap)
+            return; // Already gone, ignore
+        snap.refCount--;
+        if (snap.refCount <= 0) {
+            this.destroy(id);
+        }
+    }
+    /**
+     * Resolves a data path from the snapshot.
+     */
+    resolve(id, path) {
+        const snap = this.snapshots.get(id);
+        if (!snap) {
+            console.log(`[Registry] Snapshot ${id} not found`);
+            return undefined;
+        }
+        const result = snap.indexMap[path];
+        if (result === undefined) {
+            console.log(`[Registry] Key "${path}" not found in snapshot ${id}`);
+            console.log(`[Registry] Available keys in IndexMap:`, Object.keys(snap.indexMap).slice(0, 20));
+        }
+        return result;
+    }
+    /**
+     * Returns snapshot without internal implementation details.
+     * [H1 FIX] No longer exposes internal `timer` field.
+     */
+    getSnapshot(id) {
+        const snap = this.snapshots.get(id);
+        if (!snap)
+            return undefined;
+        // Destructure to exclude internal timer field
+        const { timer, ...publicSnapshot } = snap;
+        return publicSnapshot;
+    }
+    destroy(id) {
+        const snap = this.snapshots.get(id);
+        if (snap) {
+            clearTimeout(snap.timer);
+            this.snapshots.delete(id);
+        }
+    }
+    forceDestroy(id) {
+        this.destroy(id);
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/engine/system/registry.js.map

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

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

@@ -0,0 +1,13 @@
+/**
+ * View Domain
+ *
+ * 包含视图状态管理、Transformer 及 Snapshot 构建。
+ *
+ * @module @aotui/runtime/engine/view
+ */
+export type { IViewTree, ViewContextFactory } from '../../spi/index.js';
+export type { ViewContext } from './types.js';
+export type { IView, IViewContext } from './types.js';
+export { ViewManager } from './manager.js';
+export { Transformer, type TransformResult } from './transformer/index.js';
+export { SnapshotBuilder, type SnapshotResult } from './snapshot/index.js';

package/dist/engine/view/index.js

@@ -0,0 +1,20 @@
+/**
+ * View Domain
+ *
+ * 包含视图状态管理、Transformer 及 Snapshot 构建。
+ *
+ * @module @aotui/runtime/engine/view
+ */
+// ============================================================================
+// ViewManager - 视图状态管理
+// ============================================================================
+export { ViewManager } from './manager.js';
+// ============================================================================
+// Transformer - DOM → TUI Markdown
+// ============================================================================
+export { Transformer } from './transformer/index.js';
+// ============================================================================
+// SnapshotBuilder - 快照构建
+// ============================================================================
+export { SnapshotBuilder } from './snapshot/index.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/view/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,+EAA+E;AAC/E,mCAAmC;AACnC,+EAA+E;AAC/E,OAAO,EAAE,WAAW,EAAwB,MAAM,wBAAwB,CAAC;AAE3E,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAC/E,OAAO,EAAE,eAAe,EAAuB,MAAM,qBAAqB,CAAC"}

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

@@ -0,0 +1,42 @@
+/**
+ * ViewManager - View 生命周期管理
+ *
+ * [H1 拆分 Phase 4] 从 Desktop 提取的 View 管理模块。
+ *
+ * 职责:
+ * - View 挂载/卸载 (mount/dismount)
+ * - View 显示/隐藏 (show/hide)
+ *
+ * 设计说明:
+ * - ViewManager 通过 DesktopDOM 接口与 Desktop 交互
+ * - View 操作通过 CustomEvent 分发到 App 容器
+ */
+import type { AppID, ViewID } from '../../spi/index.js';
+/**
+ * ViewManager - View 生命周期管理
+ *
+ * [RFC-001 Phase 2] Worker-Only 架构下，View 管理主要由 Worker 内部处理。
+ * 此类保留用于向后兼容或未来扩展，目前主要为空操作。
+ */
+export declare class ViewManager {
+    /**
+     * 挂载 View
+     */
+    mount(appId: AppID, viewId: ViewID): Promise<void>;
+    /**
+     * 卸载 View
+     */
+    dismount(appId: AppID, viewId: ViewID): Promise<void>;
+    /**
+     * 隐藏 View
+     */
+    hide(appId: AppID, viewId: ViewID): Promise<void>;
+    /**
+     * 显示 View
+     */
+    show(appId: AppID, viewId: ViewID): Promise<void>;
+    /**
+     * [RFC-006] Mount view via ViewLink
+     */
+    mountByLink(appId: AppID, parentViewId: ViewID, linkId: string): Promise<void>;
+}

package/dist/engine/view/manager.js

@@ -0,0 +1,57 @@
+/**
+ * ViewManager - View 生命周期管理
+ *
+ * [H1 拆分 Phase 4] 从 Desktop 提取的 View 管理模块。
+ *
+ * 职责:
+ * - View 挂载/卸载 (mount/dismount)
+ * - View 显示/隐藏 (show/hide)
+ *
+ * 设计说明:
+ * - ViewManager 通过 DesktopDOM 接口与 Desktop 交互
+ * - View 操作通过 CustomEvent 分发到 App 容器
+ */
+/**
+ * ViewManager - View 生命周期管理
+ *
+ * [RFC-001 Phase 2] Worker-Only 架构下，View 管理主要由 Worker 内部处理。
+ * 此类保留用于向后兼容或未来扩展，目前主要为空操作。
+ */
+export class ViewManager {
+    // ========================================================================
+    // View 生命周期方法
+    // ========================================================================
+    /**
+     * 挂载 View
+     */
+    async mount(appId, viewId) {
+        // Worker App 应该通过 IPC 处理，进入此路径意味着非 Worker App 或错误
+        console.warn(`[ViewManager] Legacy mount called for ${appId}:${viewId}. Ignored in Worker-Only mode.`);
+    }
+    /**
+     * 卸载 View
+     */
+    async dismount(appId, viewId) {
+        // No-op
+    }
+    /**
+     * 隐藏 View
+     */
+    async hide(appId, viewId) {
+        // No-op
+    }
+    /**
+     * 显示 View
+     */
+    async show(appId, viewId) {
+        // No-op
+    }
+    /**
+     * [RFC-006] Mount view via ViewLink
+     */
+    async mountByLink(appId, parentViewId, linkId) {
+        // Worker App 应该通过 IPC 处理，进入此路径意味着非 Worker App 或错误
+        console.warn(`[ViewManager] Legacy mountByLink called for ${appId}:${parentViewId}:${linkId}. Ignored in Worker-Only mode.`);
+    }
+}
+//# sourceMappingURL=manager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../../src/engine/view/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH;;;;;GAKG;AACH,MAAM,OAAO,WAAW;IAEpB,2EAA2E;IAC3E,cAAc;IACd,2EAA2E;IAE3E;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,KAAY,EAAE,MAAc;QACpC,kDAAkD;QAClD,OAAO,CAAC,IAAI,CAAC,yCAAyC,KAAK,IAAI,MAAM,gCAAgC,CAAC,CAAC;IAC3G,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,KAAY,EAAE,MAAc;QACvC,QAAQ;IACZ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,KAAY,EAAE,MAAc;QACnC,QAAQ;IACZ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,KAAY,EAAE,MAAc;QACnC,QAAQ;IACZ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,KAAY,EAAE,YAAoB,EAAE,MAAc;QAChE,kDAAkD;QAClD,OAAO,CAAC,IAAI,CAAC,+CAA+C,KAAK,IAAI,YAAY,IAAI,MAAM,gCAAgC,CAAC,CAAC;IACjI,CAAC;CACJ"}

package/dist/engine/view/snapshot/builder.d.ts

@@ -0,0 +1,34 @@
+/**
+ * SnapshotBuilder - TUI Snapshot Aggregator
+ *
+ * Combines Desktop metadata with Transformer output to create
+ * complete TUI snapshots conforming to TUI_DEMO.md specification.
+ */
+import type { IndexMap } from '../../../spi/index.js';
+import { Transformer } from '../transformer/index.js';
+import { Desktop } from '../../core/desktop.js';
+export interface SnapshotResult {
+    markup: string;
+    indexMap: IndexMap;
+}
+export declare class SnapshotBuilder {
+    private transformer;
+    private mergedIndexMap;
+    constructor(transformer?: Transformer);
+    /**
+     * Build complete TUI snapshot from Desktop state
+     */
+    build(desktop: Desktop): SnapshotResult;
+    /**
+     * Build <desktop> section with system info
+     */
+    private buildDesktopSection;
+    /**
+     * Build <application> section with app info and views
+     */
+    private buildApplicationSection;
+    /**
+     * Build simplified view tree from app container
+     */
+    private buildViewTree;
+}

package/dist/engine/view/snapshot/builder.js

@@ -0,0 +1,119 @@
+import { Transformer } from '../transformer/index.js';
+import { SYSTEM_INSTRUCTION, formatTimestamp, formatAppStatus } from './templates.js';
+export class SnapshotBuilder {
+    transformer;
+    mergedIndexMap = {};
+    constructor(transformer) {
+        this.transformer = transformer || new Transformer();
+    }
+    /**
+     * Build complete TUI snapshot from Desktop state
+     */
+    build(desktop) {
+        this.mergedIndexMap = {};
+        const parts = [];
+        // 1. Build <desktop> section
+        parts.push(this.buildDesktopSection(desktop));
+        // 2. Build <application> sections for running apps
+        const apps = desktop.getInstalledApps();
+        for (const app of apps) {
+            if (app.status === 'running') {
+                parts.push(this.buildApplicationSection(desktop, app));
+            }
+        }
+        return {
+            markup: parts.join('\n\n'),
+            indexMap: this.mergedIndexMap
+        };
+    }
+    /**
+     * Build <desktop> section with system info
+     */
+    buildDesktopSection(desktop) {
+        const apps = desktop.getInstalledApps();
+        const logs = desktop.getSystemLogs();
+        // [RFC-013] Format installed apps list with description
+        const appsMarkup = apps.length === 0
+            ? '- No applications installed.'
+            : apps.map((app, index) => {
+                const name = app.name || app.appId;
+                const whatItIs = app.whatItIs ?? app.description ?? 'Not provided';
+                const whenToUse = app.whenToUse ?? 'Not provided';
+                return `${index + 1}. ${name}
+    - Status: ${formatAppStatus(app.status)}
+    - What it is: ${whatItIs}
+    - When to use: ${whenToUse}`;
+            }).join('\n');
+        // Format system logs (last 5)
+        const logsMarkup = logs.slice(-5).map(log => `- [${formatTimestamp(log.timestamp)}] ${log.message}`).join('\n');
+        return `<desktop>
+
+${SYSTEM_INSTRUCTION}
+
+## Installed TUI Applications
+${appsMarkup}
+
+## System Logs
+${logsMarkup || '- No logs yet.'}
+
+</desktop>`;
+    }
+    /**
+     * Build <application> section with app info and views
+     */
+    buildApplicationSection(desktop, app) {
+        const logs = desktop.getAppOperationLogs(app.appId);
+        const appName = app.name || app.appId;
+        // [P1 Fix] Removed dead code: getAppContainer is deprecated/removed.
+        // SnapshotBuilder no longer supports DOM traversal for apps.
+        // Use getSnapshotFragments() in Kernel instead.
+        const viewsMarkup = '';
+        // Format operation logs (last 5)
+        const logsMarkup = logs.slice(-5).map(log => `- [${formatTimestamp(log.timestamp)}] ${log.message}`).join('\n');
+        // Build view tree (simplified version based on DOM structure)
+        // [P1 Fix] SnapshotBuilder DOM traversal is disabled.
+        const viewTree = this.buildViewTree(null);
+        return `<application id="${app.appId}" name="${appName}">
+
+<application_info>
+## Operation Log
+${logsMarkup || '- No operations yet.'}
+
+## Application View Tree
+${viewTree || '- No views.'}
+</application_info>
+
+${viewsMarkup}
+
+</application>`;
+    }
+    /**
+     * Build simplified view tree from app container
+     */
+    buildViewTree(container) {
+        if (!container)
+            return '';
+        // [H3 FIX] Query both mounted views AND unmounted view links (siblings)
+        const elements = container.querySelectorAll('[view], [data-view-link]');
+        if (elements.length === 0)
+            return '- No views.';
+        return Array.from(elements).map((el) => {
+            // Case 1: Mounted View
+            if (el.hasAttribute('view')) {
+                const viewName = el.getAttribute('name') || el.getAttribute('view') || 'Unknown';
+                const viewId = el.id || 'unknown';
+                const state = el.getAttribute('data-state');
+                const stateStr = state === 'hidden' ? '' : ', mounted';
+                return `- [${viewName}](view:${viewId}${stateStr})`;
+            }
+            // Case 2: Unmounted View Link (Sibling)
+            else if (el.hasAttribute('data-view-link')) {
+                const viewId = el.getAttribute('data-view-link');
+                const text = el.textContent || 'View Link';
+                return `- [${text}](view:${viewId})`;
+            }
+            return '';
+        }).filter(Boolean).join('\n');
+    }
+}
+//# sourceMappingURL=builder.js.map

package/dist/engine/view/snapshot/builder.js.map

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

package/dist/engine/view/snapshot/formatter.d.ts

@@ -0,0 +1,76 @@
+/**
+ * SnapshotFormatter - TUI Snapshot Formatter
+ *
+ * [RFC-007] Transforms Worker fragments and Desktop metadata into
+ * complete TUI snapshots conforming to TUI_DEMO.md format.
+ * [RFC-014] Added structured output for semantic separation.
+ *
+ * @module @aotui/runtime/engine/view/snapshot/formatter
+ */
+import type { ISnapshotFormatter, ISnapshotFragment, IDesktopMetadata, FormattedSnapshotResult, StructuredSnapshot } from '../../../spi/index.js';
+/**
+ * [RFC-014] Extended snapshot result with structured output
+ */
+export interface ExtendedSnapshotResult extends FormattedSnapshotResult {
+    /** [RFC-014] Structured output for semantic separation */
+    structured: StructuredSnapshot;
+}
+/**
+ * SnapshotFormatter configuration
+ */
+export interface SnapshotFormatterConfig {
+    /** Maximum system logs to include (default: 5) */
+    systemLogLimit?: number;
+    /** Maximum app operation logs to include (default: 3) */
+    appLogLimit?: number;
+}
+/**
+ * SnapshotFormatter Implementation
+ *
+ * Assembles complete TUI snapshots from:
+ * 1. Desktop metadata (`<desktop>` section)
+ * 2. Worker fragments (`<application>` sections)
+ *
+ * [RFC-014] Now also returns structured output for semantic separation.
+ *
+ * @example
+ * ```typescript
+ * const formatter = new SnapshotFormatter();
+ * const { markup, indexMap, structured } = formatter.format(fragments, metadata);
+ * ```
+ */
+export declare class SnapshotFormatter implements ISnapshotFormatter {
+    private readonly systemLogLimit;
+    private readonly appLogLimit;
+    constructor(config?: SnapshotFormatterConfig);
+    private resolveUniqueToolKey;
+    /**
+     * Format complete TUI snapshot
+     *
+     * [RFC-014] Now returns both legacy markup and structured output.
+     */
+    format(fragments: ReadonlyArray<ISnapshotFragment>, metadata: IDesktopMetadata): ExtendedSnapshotResult;
+    /**
+     * [RFC-014] Build desktop state without system instruction
+     *
+     * Returns only "Where" information:
+     * - Installed Applications
+     * - System Logs
+     */
+    private buildDesktopStateOnly;
+    /**
+     * Format apps list markup (shared between legacy and structured output)
+     */
+    private formatAppsMarkup;
+    /**
+     * Build <desktop> section with system info
+     */
+    private buildDesktopSection;
+    /**
+     * Build <application> section with app info and views
+     *
+     * [RFC-017] Removed "## Recent Operations" section - feedback now provided
+     * via AI SDK standard tool-result messages (RFC-015)
+     */
+    private buildApplicationSection;
+}