@aotui/runtime 1.0.0

package/dist/kernel/index.d.ts

@@ -0,0 +1,120 @@
+import type { IKernel, Operation, OperationResult, DesktopID, SnapshotID, CachedSnapshot, IDesktop, IRegistry, DesktopState, ISystemOperationRegistry, IDesktopManager, ITransformer, IDispatcher, IRuntimeContext } from '../spi/index.js';
+/**
+ * Kernel - The core orchestrator of the AOTUI Runtime.
+ *
+ * Responsibilities:
+ * - Creates and manages Desktop instances (via IDesktopManager)
+ * - Handles concurrency via lock mechanism (delegated to IDesktopManager)
+ * - Generates and manages Snapshots for Agent consumption
+ * - Dispatches operations to Apps via IDispatcher
+ * - Manages Desktop lifecycle (suspend, resume, serialize, restore)
+ *
+ * [DIP] Kernel depends ONLY on interfaces (IDesktopManager, IRegistry, ITransformer, IDispatcher).
+ * Concrete implementations are injected via constructor (Inversion of Control).
+ *
+ * @example
+ * ```typescript
+ * // Use createKernel factory to get a properly configured Kernel
+ * import { createKernel } from '@aotui/runtime';
+ * const kernel = createKernel(desktopManager, registry, systemOps);
+ * ```
+ */
+export declare class Kernel implements IKernel {
+    private desktopManager;
+    private snapshotRegistry;
+    private transformer;
+    private dispatcher;
+    private systemOps;
+    constructor(desktopManager: IDesktopManager, snapshotRegistry: IRegistry, transformer: ITransformer, dispatcher: IDispatcher, systemOps: ISystemOperationRegistry);
+    getSystemToolDefinitions(): import("../spi/index.js").Tool[];
+    /**
+     * Creates a new Desktop instance with a clean state.
+     * The Desktop is immediately registered and ready for app installation.
+     *
+     * App installation is the responsibility of Product Layer (e.g., DesktopManager).
+     * This follows the microkernel principle: Kernel handles scheduling,
+     * Product Layer handles app discovery and installation.
+     *
+     * @param desktopId - Optional: specify a custom Desktop ID (for historical topics)
+     * @param context - Optional: Runtime Context to inject into the Desktop
+     * @returns The unique identifier of the created Desktop
+     */
+    createDesktop(desktopId?: DesktopID, context?: IRuntimeContext): Promise<DesktopID>;
+    /**
+     * Destroys a Desktop and releases all associated resources.
+     * This operation is idempotent - calling with non-existent ID is safe.
+     *
+     * @param desktopId - The ID of the Desktop to destroy
+     */
+    destroyDesktop(desktopId: DesktopID): Promise<void>;
+    /**
+     * 获取 Desktop 实例 (供 ToolCallAdapter 使用)
+     * @throws {Error} E_NOT_FOUND if Desktop doesn't exist
+     */
+    getDesktop(desktopId: DesktopID): IDesktop;
+    /**
+     * [Worker-Only] 安装 App
+     *
+     * [C1 Fix] workerScriptPath 现在是可选的，默认使用 Runtime 内置的 worker-runtime
+     */
+    installDynamicWorkerApp(desktopId: DesktopID, appModulePath: string, options?: {
+        workerScriptPath?: string;
+        appId?: string;
+        name?: string;
+        /** [RFC-013] App description for Agent */
+        description?: string;
+        config?: import('../spi/app/app-config.interface.js').AppLaunchConfig;
+        promptRole?: 'user' | 'assistant';
+    }): Promise<string>;
+    /**
+     * [C1 FIX] Lock management delegated to IDesktopManager
+     */
+    acquireLock(desktopId: DesktopID, ownerId: string): void;
+    releaseLock(desktopId: DesktopID, ownerId: string): void;
+    acquireSnapshot(desktopId: DesktopID, ttl?: number): Promise<CachedSnapshot>;
+    releaseSnapshot(snapshotId: SnapshotID): void;
+    execute(desktopId: DesktopID, operation: Operation, ownerId: string): Promise<OperationResult>;
+    /**
+     * Enrich OperationResult with execution metadata
+     *
+     * @param result - Original operation result
+     * @param operationName - Name of the executed operation
+     * @param startTime - Execution start timestamp
+     * @returns Result with added durationMs
+     */
+    private enrichResult;
+    /**
+     * [RFC-008] Log operation execution with semantic format
+     *
+     * Generates WHO/WHEN/WHERE/WHAT log entries:
+     * - WHO: The actor (agent name)
+     * - WHEN: Timestamp and duration
+     * - WHERE: Desktop > App > View
+     * - WHAT: Operation name and result
+     */
+    private logOperationExecution;
+    /**
+     * [C1 FIX] Now type-safe via IDesktopManager
+     */
+    suspend(desktopId: DesktopID): Promise<void>;
+    /**
+     * [C1 FIX] Now type-safe via IDesktopManager
+     */
+    resume(desktopId: DesktopID): Promise<void>;
+    serialize(desktopId: DesktopID): DesktopState;
+    /**
+     * [RFC-014] 优雅关闭 Desktop
+     *
+     * 1. 调用 Desktop.drain() 等待 App 清理
+     * 2. 执行 beforeClose 回调（如持久化）
+     * 3. 销毁 Desktop
+     *
+     * @param desktopId - Desktop ID
+     * @param options - 关闭选项
+     */
+    gracefulShutdown(desktopId: DesktopID, options?: import('../spi/index.js').ShutdownOptions): Promise<void>;
+    /**
+     * [RFC-015] 删除 Desktop (清理数据)
+     */
+    deleteDesktop(desktopId: DesktopID): Promise<void>;
+}

package/dist/kernel/index.js

@@ -0,0 +1,328 @@
+import { AOTUIError } from '../spi/core/errors.js';
+import { createOperationId } from '../spi/core/id-factory.js';
+import { buildOperationLogEntry } from '../engine/core/operation-log-formatter.js';
+/**
+ * Kernel - The core orchestrator of the AOTUI Runtime.
+ *
+ * Responsibilities:
+ * - Creates and manages Desktop instances (via IDesktopManager)
+ * - Handles concurrency via lock mechanism (delegated to IDesktopManager)
+ * - Generates and manages Snapshots for Agent consumption
+ * - Dispatches operations to Apps via IDispatcher
+ * - Manages Desktop lifecycle (suspend, resume, serialize, restore)
+ *
+ * [DIP] Kernel depends ONLY on interfaces (IDesktopManager, IRegistry, ITransformer, IDispatcher).
+ * Concrete implementations are injected via constructor (Inversion of Control).
+ *
+ * @example
+ * ```typescript
+ * // Use createKernel factory to get a properly configured Kernel
+ * import { createKernel } from '@aotui/runtime';
+ * const kernel = createKernel(desktopManager, registry, systemOps);
+ * ```
+ */
+export class Kernel {
+    desktopManager;
+    snapshotRegistry;
+    transformer;
+    dispatcher;
+    systemOps;
+    constructor(desktopManager, snapshotRegistry, transformer, dispatcher, systemOps) {
+        this.desktopManager = desktopManager;
+        this.snapshotRegistry = snapshotRegistry;
+        this.transformer = transformer;
+        this.dispatcher = dispatcher;
+        this.systemOps = systemOps;
+    }
+    getSystemToolDefinitions() {
+        return this.systemOps.getToolDefinitions();
+    }
+    /**
+     * Creates a new Desktop instance with a clean state.
+     * The Desktop is immediately registered and ready for app installation.
+     *
+     * App installation is the responsibility of Product Layer (e.g., DesktopManager).
+     * This follows the microkernel principle: Kernel handles scheduling,
+     * Product Layer handles app discovery and installation.
+     *
+     * @param desktopId - Optional: specify a custom Desktop ID (for historical topics)
+     * @param context - Optional: Runtime Context to inject into the Desktop
+     * @returns The unique identifier of the created Desktop
+     */
+    async createDesktop(desktopId, context) {
+        return this.desktopManager.create(desktopId, context);
+    }
+    /**
+     * Destroys a Desktop and releases all associated resources.
+     * This operation is idempotent - calling with non-existent ID is safe.
+     *
+     * @param desktopId - The ID of the Desktop to destroy
+     */
+    async destroyDesktop(desktopId) {
+        await this.desktopManager.destroy(desktopId);
+    }
+    /**
+     * 获取 Desktop 实例 (供 ToolCallAdapter 使用)
+     * @throws {Error} E_NOT_FOUND if Desktop doesn't exist
+     */
+    getDesktop(desktopId) {
+        const desktop = this.desktopManager.get(desktopId);
+        if (!desktop) {
+            throw new AOTUIError('DESKTOP_NOT_FOUND', { desktopId });
+        }
+        return desktop;
+    }
+    /**
+     * [Worker-Only] 安装 App
+     *
+     * [C1 Fix] workerScriptPath 现在是可选的，默认使用 Runtime 内置的 worker-runtime
+     */
+    async installDynamicWorkerApp(desktopId, appModulePath, options) {
+        const desktop = this.desktopManager.get(desktopId);
+        if (!desktop) {
+            throw new AOTUIError('DESKTOP_NOT_FOUND', { desktopId });
+        }
+        // [Refactor] Use DesktopManager to centralize log/signal if needed, but direct Desktop call is fine via Kernel
+        // Actually, Kernel mostly delegates to DesktopManager or Desktop directly.
+        // Let's delegate to DesktopManager to keep symmetry if Manager has it.
+        // Wait, Kernel line 110 calls 'desktop.installDynamicWorkerApp'.
+        // But DesktopManager ALSO has 'installDynamicWorkerApp'.
+        // Let's stick to what Kernel was doing: calling `desktop.installDynamicWorkerApp`.
+        return desktop.installDynamicWorkerApp(appModulePath, options);
+    }
+    /**
+     * [C1 FIX] Lock management delegated to IDesktopManager
+     */
+    acquireLock(desktopId, ownerId) {
+        this.desktopManager.acquireLock(desktopId, ownerId);
+    }
+    releaseLock(desktopId, ownerId) {
+        this.desktopManager.releaseLock(desktopId, ownerId);
+    }
+    async acquireSnapshot(desktopId, ttl) {
+        const desktop = this.desktopManager.get(desktopId);
+        if (!desktop) {
+            throw new AOTUIError('DESKTOP_NOT_FOUND', { desktopId });
+        }
+        // [RFC-001] Get Worker-pushed SnapshotFragments
+        const fragments = desktop.getSnapshotFragments();
+        // [RFC-007] Use SnapshotFormatter for complete TUI output
+        // [RFC-014] SnapshotFormatter now returns structured output
+        const { SnapshotFormatter } = await import('../engine/view/snapshot/index.js');
+        const formatter = new SnapshotFormatter();
+        // Desktop implements IDesktopMetadata (getInstalledApps, getSystemLogs, etc.)
+        const result = formatter.format(fragments, desktop);
+        // [RFC-014] Pass structured output to Registry
+        return this.snapshotRegistry.create(result.indexMap, result.markup, ttl, result.structured);
+    }
+    releaseSnapshot(snapshotId) {
+        this.snapshotRegistry.release(snapshotId);
+    }
+    async execute(desktopId, operation, ownerId) {
+        const startTime = Date.now();
+        try {
+            // 1. Verify Desktop
+            const desktop = this.desktopManager.get(desktopId);
+            if (!desktop)
+                throw new AOTUIError('DESKTOP_NOT_FOUND', { desktopId });
+            // 2. Verify Lock (delegated to desktopManager)
+            if (!this.desktopManager.verifyLock(desktopId, ownerId)) {
+                const lockInfo = this.desktopManager.getLockInfo(desktopId);
+                throw new AOTUIError('DESKTOP_LOCKED', {
+                    desktopId,
+                    ownerId: lockInfo?.ownerId ?? 'none',
+                    claimant: ownerId,
+                });
+            }
+            // Refresh timestamp on successful lock verification
+            this.desktopManager.refreshLock(desktopId, ownerId);
+            const { context, name: operationName, args } = operation;
+            // 3. System Operation Dispatch (via Registry - replaces switch statement)
+            if (this.systemOps.has(operationName)) {
+                const systemCtx = {
+                    desktopId,
+                    args: { ...args, appId: context.appId } // Inject appId for view operations
+                };
+                const result = await this.systemOps.execute(operationName, systemCtx, desktop);
+                if (result.success && 'emitSignal' in desktop) {
+                    desktop.emitSignal('manual_refresh');
+                }
+                return this.enrichResult(result, operationName, startTime, desktop, desktopId, context.appId, args || {});
+            }
+            // 4. App Operation Dispatch
+            // [Worker-Only] 所有 App 操作通过 Dispatcher 路由到 Worker
+            if (!context.appId) {
+                throw new AOTUIError('OPERATION_REQUIRES_CONTEXT', { operationName });
+            }
+            // Pass Operation directly to Dispatcher (handles Worker IPC routing)
+            const dispatchOp = {
+                context,
+                name: operationName,
+                args
+            };
+            // [P0-1 FIX] Now returns the actual OperationResult from the App
+            const result = await this.dispatcher.dispatch(desktop, dispatchOp, this.snapshotRegistry);
+            return this.enrichResult(result, operationName, startTime, desktop, desktopId, context.appId, args || {});
+        }
+        catch (e) {
+            // If already AOTUIError, preserve it. Otherwise wrap.
+            const aotuiError = AOTUIError.is(e) ? e : AOTUIError.fromError(e, 'EXECUTION_FAILED');
+            const durationMs = Date.now() - startTime;
+            // [RFC-008] Log failed operation
+            const desktop = this.desktopManager.get(desktopId);
+            if (desktop) {
+                this.logOperationExecution(desktop, desktopId, operation.context.appId, operation.name, operation.args || {}, false, durationMs, 'agent', // Default actor for now - could be passed in
+                aotuiError.message);
+            }
+            return {
+                success: false,
+                error: aotuiError.toOperationError(),
+                data: { durationMs }
+            };
+        }
+    }
+    /**
+     * Enrich OperationResult with execution metadata
+     *
+     * @param result - Original operation result
+     * @param operationName - Name of the executed operation
+     * @param startTime - Execution start timestamp
+     * @returns Result with added durationMs
+     */
+    enrichResult(result, operationName, startTime, desktop, desktopId, appId, args) {
+        const durationMs = Date.now() - startTime;
+        // [RFC-008] Log successful operation
+        this.logOperationExecution(desktop, desktopId, appId, operationName, args, result.success, durationMs, 'agent' // Default actor for now
+        );
+        return {
+            ...result,
+            data: {
+                ...result.data,
+                durationMs,
+                operationName
+            }
+        };
+    }
+    /**
+     * [RFC-008] Log operation execution with semantic format
+     *
+     * Generates WHO/WHEN/WHERE/WHAT log entries:
+     * - WHO: The actor (agent name)
+     * - WHEN: Timestamp and duration
+     * - WHERE: Desktop > App > View
+     * - WHAT: Operation name and result
+     */
+    logOperationExecution(desktop, desktopId, appId, operationName, args, success, durationMs, actor, errorMessage) {
+        const scope = this.systemOps.has(operationName) ? 'system' : 'app';
+        // Get app name for semantic description (getAppInfo is optional on IDesktop)
+        let appName;
+        if (appId && desktop.getAppInfo) {
+            const appInfo = desktop.getAppInfo(appId);
+            appName = appInfo?.name;
+        }
+        const entry = buildOperationLogEntry({
+            actor,
+            desktopId,
+            scope,
+            operationName: createOperationId(operationName),
+            args,
+            success,
+            durationMs,
+            appId,
+            appName,
+            errorMessage
+        });
+        // Log using Desktop's existing logger (duck typing for concrete Desktop methods)
+        // These methods exist on concrete Desktop but not on IDesktop interface
+        const desktopWithLogger = desktop;
+        if (scope === 'system' && desktopWithLogger.logSystem) {
+            desktopWithLogger.logSystem(entry.semanticDescription, success ? 'info' : 'error');
+        }
+        else if (appId && desktopWithLogger.logAppOperation) {
+            desktopWithLogger.logAppOperation(appId, entry.semanticDescription, success ? 'info' : 'error');
+        }
+    }
+    /**
+     * [C1 FIX] Now type-safe via IDesktopManager
+     */
+    async suspend(desktopId) {
+        await this.desktopManager.suspend(desktopId);
+    }
+    /**
+     * [C1 FIX] Now type-safe via IDesktopManager
+     */
+    async resume(desktopId) {
+        await this.desktopManager.resume(desktopId);
+    }
+    serialize(desktopId) {
+        const info = this.desktopManager.getDesktopInfo(desktopId);
+        if (!info) {
+            throw new AOTUIError('DESKTOP_NOT_FOUND', { desktopId });
+        }
+        return {
+            id: desktopId,
+            status: info.status,
+            createdAt: info.createdAt,
+            serializedAt: Date.now(),
+            apps: this.desktopManager.getAppStates(desktopId)
+        };
+    }
+    /**
+     * [RFC-014] 优雅关闭 Desktop
+     *
+     * 1. 调用 Desktop.drain() 等待 App 清理
+     * 2. 执行 beforeClose 回调（如持久化）
+     * 3. 销毁 Desktop
+     *
+     * @param desktopId - Desktop ID
+     * @param options - 关闭选项
+     */
+    async gracefulShutdown(desktopId, options) {
+        const timeout = options?.timeoutMs ?? 30000;
+        const desktop = this.desktopManager.get(desktopId);
+        if (!desktop) {
+            // 已不存在，直接返回
+            console.log(`[Kernel] gracefulShutdown: Desktop ${desktopId} not found, skipping`);
+            return;
+        }
+        const shutdownTask = async () => {
+            // 1. Drain Desktop (等待 App 清理)
+            await desktop.drain();
+            // 2. 执行 beforeClose 回调
+            if (options?.beforeClose) {
+                await options.beforeClose();
+            }
+            // 3. 销毁 Desktop
+            await this.destroyDesktop(desktopId);
+        };
+        // 超时保护
+        const timeoutPromise = new Promise((_, reject) => {
+            setTimeout(() => reject(new Error('gracefulShutdown timeout')), timeout);
+        });
+        try {
+            await Promise.race([shutdownTask(), timeoutPromise]);
+            console.log(`[Kernel] gracefulShutdown completed for ${desktopId}`);
+        }
+        catch (e) {
+            console.warn(`[Kernel] gracefulShutdown timeout for ${desktopId}, forcing destroy`);
+            await this.destroyDesktop(desktopId);
+        }
+    }
+    /**
+     * [RFC-015] 删除 Desktop (清理数据)
+     */
+    async deleteDesktop(desktopId) {
+        const desktop = this.desktopManager.get(desktopId);
+        if (!desktop) {
+            console.log(`[Kernel] deleteDesktop: Desktop ${desktopId} not found, skipping`);
+            return;
+        }
+        console.log(`[Kernel] Deleting Desktop ${desktopId}...`);
+        // 1. 调用 Desktop.delete() (触发 App onDelete + drain)
+        await desktop.delete();
+        // 2. 从 DesktopManager 移除
+        this.desktopManager.destroy(desktopId);
+        console.log(`[Kernel] Desktop ${desktopId} deleted.`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/kernel/index.js.map

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

package/dist/spi/app/aoapp.d.ts

@@ -0,0 +1,86 @@
+/**
+ * aoapp.json Manifest Types
+ *
+ * 定义第三方 TUI App 的清单文件格式。
+ * 每个 TUI App 包必须包含 aoapp.json。
+ *
+ * @module @aotui/runtime/spi/aoapp
+ */
+/**
+ * View 定义
+ */
+export interface AOAppView {
+    /** View 名称 */
+    name: string;
+    /** View 描述 */
+    description?: string;
+}
+/**
+ * Runtime 兼容性要求
+ */
+export interface AOAppRuntime {
+    /** 最低支持的 Runtime 版本 */
+    minVersion?: string;
+    /** 最高支持的 Runtime 版本 */
+    maxVersion?: string;
+}
+/**
+ * 入口点配置
+ */
+export interface AOAppEntry {
+    /** 主入口文件 (相对路径) */
+    main: string;
+    /** TypeScript 类型定义文件 (可选) */
+    types?: string;
+}
+/**
+ * aoapp.json 清单文件结构
+ *
+ * @example
+ * ```json
+ * {
+ *   "name": "weather",
+ *   "displayName": "Weather App",
+ *   "version": "1.0.0",
+ *   "entry": { "main": "./dist/index.js" }
+ * }
+ * ```
+ */
+export interface AOAppManifest {
+    /**
+     * App 唯一标识符 (用于安装和卸载)
+     * 格式: 小写字母、数字、连字符，如 "weather", "todo-list"
+     */
+    name: string;
+    /** 显示名称 (用于 UI 展示) */
+    displayName: string;
+    /** 语义化版本号 */
+    version: string;
+    /** App 描述 */
+    description?: string;
+    /** App 是什么 (用于 Desktop State 展示) */
+    whatItIs?: string;
+    /** 什么时候用 (用于 Desktop State 展示) */
+    whenToUse?: string;
+    /** 作者信息 */
+    author?: string;
+    /** 许可证 */
+    license?: string;
+    /** Runtime 兼容性 */
+    runtime?: AOAppRuntime;
+    /** 入口点 */
+    entry: AOAppEntry;
+    /** View 列表 (用于文档生成) */
+    views?: AOAppView[];
+    /** [Fix] App 角色 (用于 LLM Prompt) */
+    promptRole?: 'user' | 'assistant';
+}
+/**
+ * 验证 aoapp.json 是否有效
+ */
+export declare function validateManifest(manifest: unknown): manifest is AOAppManifest;
+/**
+ * 验证 App 名称格式
+ * 规则: 小写字母、数字、连字符，长度 1-50
+ */
+export declare function isValidAppName(name: string): boolean;

package/dist/spi/app/aoapp.js

@@ -0,0 +1,39 @@
+/**
+ * aoapp.json Manifest Types
+ *
+ * 定义第三方 TUI App 的清单文件格式。
+ * 每个 TUI App 包必须包含 aoapp.json。
+ *
+ * @module @aotui/runtime/spi/aoapp
+ */
+/**
+ * 验证 aoapp.json 是否有效
+ */
+export function validateManifest(manifest) {
+    if (typeof manifest !== 'object' || manifest === null) {
+        return false;
+    }
+    const m = manifest;
+    // 必填字段检查
+    if (typeof m.name !== 'string' || !m.name)
+        return false;
+    if (typeof m.displayName !== 'string' || !m.displayName)
+        return false;
+    if (typeof m.version !== 'string' || !m.version)
+        return false;
+    // entry 检查
+    if (typeof m.entry !== 'object' || m.entry === null)
+        return false;
+    const entry = m.entry;
+    if (typeof entry.main !== 'string' || !entry.main)
+        return false;
+    return true;
+}
+/**
+ * 验证 App 名称格式
+ * 规则: 小写字母、数字、连字符，长度 1-50
+ */
+export function isValidAppName(name) {
+    return /^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/.test(name) && name.length <= 50;
+}
+//# sourceMappingURL=aoapp.js.map

package/dist/spi/app/aoapp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aoapp.js","sourceRoot":"","sources":["../../../src/spi/app/aoapp.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAsFH;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAiB;IAC9C,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACpD,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,MAAM,CAAC,GAAG,QAAmC,CAAC;IAE9C,SAAS;IACT,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxD,IAAI,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,WAAW;QAAE,OAAO,KAAK,CAAC;IACtE,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAE9D,WAAW;IACX,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAClE,MAAM,KAAK,GAAG,CAAC,CAAC,KAAgC,CAAC;IACjD,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IAEhE,OAAO,IAAI,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACvC,OAAO,iCAAiC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;AAC7E,CAAC"}

package/dist/spi/app/app-config.interface.d.ts

@@ -0,0 +1,9 @@
+/**
+ * App Launch Configuration
+ *
+ * Passed to AppKernel during initialization.
+ * [RFC-026] Now supports index signature for env vars injection
+ */
+export interface AppLaunchConfig {
+    [key: string]: unknown;
+}

package/dist/spi/app/app-config.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=app-config.interface.js.map

package/dist/spi/app/app-config.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-config.interface.js","sourceRoot":"","sources":["../../../src/spi/app/app-config.interface.ts"],"names":[],"mappings":""}