@aotui/runtime 1.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"signal-service.js","sourceRoot":"","sources":["../../../src/engine/core/signal-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,+EAA+E;AAC/E,gCAAgC;AAChC,+EAA+E;AAE/E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,iBAAiB;IAC1B,sBAAsB;IACd,GAAG,CAAY;IAEvB,YAAY,GAAe;QACvB,IAAI,CAAC,GAAG,GAAG,GAAG,IAAI,IAAI,SAAS,EAAE,CAAC;IACtC,CAAC;IAED,SAAS,CAAC,SAAoB,EAAE,QAAwB;QACpD,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,CAAC,SAAoB,EAAE,MAAc;QACrC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,EAAE,MAAa,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,CAAC,SAAoB;QACxB,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,CAAC;IAED,gEAAgE;IAChE,0CAA0C;IAC1C,gEAAgE;IAEhE;;;;OAIG;IACH,MAAM;QACF,OAAO,IAAI,CAAC,GAAG,CAAC;IACpB,CAAC;CACJ"}

package/dist/engine/system/dispatcher.d.ts

@@ -0,0 +1,18 @@
+import type { Operation, OperationResult, IDesktop, IRegistry } from '../../spi/index.js';
+import type { IDispatcher } from '../../spi/runtime/dispatcher.interface.js';
+/**
+ * Dispatcher - Operation routing and argument resolution
+ *
+ * [DIP] Implements IDispatcher interface for Kernel decoupling.
+ */
+export declare class Dispatcher implements IDispatcher {
+    /**
+     * Dispatches an operation to the target application container in the desktop.
+     *
+     * [C2 Refactor] Now delegates transport details to Desktop to ensure type safety.
+     * Dispatcher is only responsible for Argument Resolution.
+     *
+     * @returns The result from the App's operation handler
+     */
+    dispatch(desktop: IDesktop, operation: Operation, registry: IRegistry): Promise<OperationResult>;
+}

package/dist/engine/system/dispatcher.js

@@ -0,0 +1,48 @@
+/**
+ * Dispatcher - Operation routing and argument resolution
+ *
+ * [DIP] Implements IDispatcher interface for Kernel decoupling.
+ */
+export class Dispatcher {
+    /**
+     * Dispatches an operation to the target application container in the desktop.
+     *
+     * [C2 Refactor] Now delegates transport details to Desktop to ensure type safety.
+     * Dispatcher is only responsible for Argument Resolution.
+     *
+     * @returns The result from the App's operation handler
+     */
+    async dispatch(desktop, operation, registry) {
+        const { context, name: operationName, args } = operation;
+        // 1. Data Resolution (Argument Injection)
+        const resolvedArgs = {};
+        const snapshotId = context.snapshotId;
+        for (const [key, value] of Object.entries(args)) {
+            if (typeof value === 'string' && snapshotId && context.appId && context.viewId) {
+                // 构造完整 namespace key: "appId:viewId:refId"
+                // 例如: "app_0:view_0:pinned_msgs[0]"
+                const fullKey = `${context.appId}:${context.viewId}:${value}`;
+                console.log(`[Dispatcher] Attempting to resolve: "${value}" → "${fullKey}"`);
+                const payload = registry.resolve(snapshotId, fullKey);
+                if (payload !== undefined) {
+                    console.log(`[Dispatcher] ✓ Resolved "${fullKey}" →`, typeof payload, payload);
+                    resolvedArgs[key] = payload;
+                    continue;
+                }
+                else {
+                    console.log(`[Dispatcher] ✗ Failed to resolve "${fullKey}" (not found in registry)`);
+                }
+            }
+            resolvedArgs[key] = value;
+        }
+        // 2. Delegate Dispatch to Desktop (Environment Agnostic)
+        // [P0-1 FIX] Now returns the actual OperationResult from the App
+        return await desktop.dispatchOperation(context.appId, {
+            context,
+            operation: operationName,
+            args: resolvedArgs,
+            meta: { snapshotId }
+        });
+    }
+}
+//# sourceMappingURL=dispatcher.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.js","sourceRoot":"","sources":["../../../src/engine/system/dispatcher.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,OAAO,UAAU;IACnB;;;;;;;OAOG;IACH,KAAK,CAAC,QAAQ,CAAC,OAAiB,EAAE,SAAoB,EAAE,QAAmB;QACvE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,SAAS,CAAC;QAEzD,0CAA0C;QAC1C,MAAM,YAAY,GAA4B,EAAE,CAAC;QACjD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QAEtC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,UAAU,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBAC7E,2CAA2C;gBAC3C,oCAAoC;gBACpC,MAAM,OAAO,GAAG,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC;gBAE9D,OAAO,CAAC,GAAG,CAAC,wCAAwC,KAAK,QAAQ,OAAO,GAAG,CAAC,CAAC;gBAC7E,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;gBAEtD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;oBACxB,OAAO,CAAC,GAAG,CAAC,4BAA4B,OAAO,KAAK,EAAE,OAAO,OAAO,EAAE,OAAO,CAAC,CAAC;oBAC/E,YAAY,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC;oBAC5B,SAAS;gBACb,CAAC;qBAAM,CAAC;oBACJ,OAAO,CAAC,GAAG,CAAC,qCAAqC,OAAO,2BAA2B,CAAC,CAAC;gBACzF,CAAC;YACL,CAAC;YACD,YAAY,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC9B,CAAC;QAED,yDAAyD;QACzD,iEAAiE;QACjE,OAAO,MAAM,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,KAAK,EAAE;YAClD,OAAO;YACP,SAAS,EAAE,aAAa;YACxB,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,EAAE,UAAU,EAAE;SACvB,CAAC,CAAC;IACP,CAAC;CACJ"}

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

@@ -0,0 +1,10 @@
+/**
+ * System Domain
+ *
+ * 包含系统操作调度、快照注册表及操作定义。
+ *
+ * @module @aotui/runtime/engine/system
+ */
+export { Dispatcher } from './dispatcher.js';
+export { SnapshotRegistry } from './registry.js';
+export { SystemOperationRegistry, createSystemOperationRegistry } from './operations/index.js';

package/dist/engine/system/index.js

@@ -0,0 +1,20 @@
+/**
+ * System Domain
+ *
+ * 包含系统操作调度、快照注册表及操作定义。
+ *
+ * @module @aotui/runtime/engine/system
+ */
+// ============================================================================
+// Dispatcher - 操作路由与参数解析
+// ============================================================================
+export { Dispatcher } from './dispatcher.js';
+// ============================================================================
+// SnapshotRegistry - Snapshot 数据索引
+// ============================================================================
+export { SnapshotRegistry } from './registry.js';
+// ============================================================================
+// SystemOperationRegistry - 系统操作定义
+// ============================================================================
+export { SystemOperationRegistry, createSystemOperationRegistry } from './operations/index.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/system/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,+EAA+E;AAC/E,mCAAmC;AACnC,+EAA+E;AAC/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,+EAA+E;AAC/E,mCAAmC;AACnC,+EAA+E;AAC/E,OAAO,EAAE,uBAAuB,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/engine/system/operations/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Operations Module
+ *
+ * 提供系统操作注册表和预注册的系统操作。
+ *
+ * @module @aotui/runtime/engine/operations
+ */
+export { SystemOperationRegistry } from './registry.js';
+export { OpenAppOperation, CloseAppOperation, DismountViewOperation } from './system/index.js';
+export type { ISystemOperation, ISystemOperationRegistry, SystemOperationContext, IDesktopForOperation } from '../../../spi/index.js';
+import { SystemOperationRegistry } from './registry.js';
+/**
+ * 创建预注册所有系统操作的注册表
+ *
+ * 这是创建 SystemOperationRegistry 的推荐方式。
+ * 所有内置系统操作在编译时固定注册。
+ *
+ * @returns 已注册所有系统操作的 Registry
+ *
+ * @example
+ * ```typescript
+ * const registry = createSystemOperationRegistry();
+ * const result = await registry.execute('open', ctx, desktop);
+ * ```
+ */
+export declare function createSystemOperationRegistry(): SystemOperationRegistry;

package/dist/engine/system/operations/index.js

@@ -0,0 +1,38 @@
+/**
+ * Operations Module
+ *
+ * 提供系统操作注册表和预注册的系统操作。
+ *
+ * @module @aotui/runtime/engine/operations
+ */
+export { SystemOperationRegistry } from './registry.js';
+// System Operations
+export { OpenAppOperation, CloseAppOperation, DismountViewOperation } from './system/index.js';
+// ============================================================================
+// Factory Function
+// ============================================================================
+import { SystemOperationRegistry } from './registry.js';
+import { OpenAppOperation, CloseAppOperation, DismountViewOperation } from './system/index.js';
+/**
+ * 创建预注册所有系统操作的注册表
+ *
+ * 这是创建 SystemOperationRegistry 的推荐方式。
+ * 所有内置系统操作在编译时固定注册。
+ *
+ * @returns 已注册所有系统操作的 Registry
+ *
+ * @example
+ * ```typescript
+ * const registry = createSystemOperationRegistry();
+ * const result = await registry.execute('open', ctx, desktop);
+ * ```
+ */
+export function createSystemOperationRegistry() {
+    const registry = new SystemOperationRegistry();
+    // 注册所有内置系统操作
+    registry.register(new OpenAppOperation());
+    registry.register(new CloseAppOperation());
+    registry.register(new DismountViewOperation());
+    return registry;
+}
+//# sourceMappingURL=index.js.map

package/dist/engine/system/operations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/engine/system/operations/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAExD,oBAAoB;AACpB,OAAO,EACH,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACxB,MAAM,mBAAmB,CAAC;AAU3B,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EACH,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACxB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,6BAA6B;IACzC,MAAM,QAAQ,GAAG,IAAI,uBAAuB,EAAE,CAAC;IAE/C,aAAa;IACb,QAAQ,CAAC,QAAQ,CAAC,IAAI,gBAAgB,EAAE,CAAC,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,IAAI,iBAAiB,EAAE,CAAC,CAAC;IAC3C,QAAQ,CAAC,QAAQ,CAAC,IAAI,qBAAqB,EAAE,CAAC,CAAC;IAE/C,OAAO,QAAQ,CAAC;AACpB,CAAC"}

package/dist/engine/system/operations/registry.d.ts

@@ -0,0 +1,62 @@
+/**
+ * System Operation Registry
+ *
+ * 管理所有系统级操作的注册和执行。
+ * 系统操作在编译时固定注册，不支持运行时动态注册。
+ *
+ * @module @aotui/runtime/engine/operations
+ */
+import type { ISystemOperation, ISystemOperationRegistry, SystemOperationContext, OperationResult, IDesktopForOperation } from '../../../spi/index.js';
+import type { Tool } from '../../../spi/core/tool-call.js';
+/**
+ * SystemOperationRegistry
+ *
+ * 实现系统操作的注册和分发，替代 Kernel 中的 switch 语句。
+ *
+ * @example
+ * ```typescript
+ * const registry = new SystemOperationRegistry();
+ * registry.register(new OpenAppOperation());
+ * registry.register(new MountViewOperation());
+ *
+ * // 执行操作
+ * const result = await registry.execute('open', ctx, desktop);
+ * ```
+ */
+export declare class SystemOperationRegistry implements ISystemOperationRegistry {
+    private operations;
+    /**
+     * 注册系统操作
+     *
+     * @param operation - 要注册的操作
+     * @throws 如果操作名称已存在则抛出错误
+     */
+    register(operation: ISystemOperation): void;
+    /**
+     * 检查操作是否存在
+     */
+    has(name: string): boolean;
+    /**
+     * 获取操作
+     */
+    get(name: string): ISystemOperation | undefined;
+    /**
+     * 执行系统操作
+     *
+     * @param name - 操作名称或别名
+     * @param ctx - 系统操作上下文
+     * @param desktop - 目标 Desktop
+     * @returns 操作结果
+     */
+    execute(name: string, ctx: SystemOperationContext, desktop: IDesktopForOperation): Promise<OperationResult>;
+    /**
+     * 获取所有已注册的操作名称（用于调试）
+     */
+    getRegisteredNames(): string[];
+    /**
+     * 获取所有系统操作的 Tool Definitions (RFC-009)
+     *
+     * 返回去重后的 Tool 列表（不包含别名重复）
+     */
+    getToolDefinitions(): Tool[];
+}

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

@@ -0,0 +1,101 @@
+/**
+ * System Operation Registry
+ *
+ * 管理所有系统级操作的注册和执行。
+ * 系统操作在编译时固定注册，不支持运行时动态注册。
+ *
+ * @module @aotui/runtime/engine/operations
+ */
+import { AOTUIError, failedResult } from '../../../spi/core/errors.js';
+/**
+ * SystemOperationRegistry
+ *
+ * 实现系统操作的注册和分发，替代 Kernel 中的 switch 语句。
+ *
+ * @example
+ * ```typescript
+ * const registry = new SystemOperationRegistry();
+ * registry.register(new OpenAppOperation());
+ * registry.register(new MountViewOperation());
+ *
+ * // 执行操作
+ * const result = await registry.execute('open', ctx, desktop);
+ * ```
+ */
+export class SystemOperationRegistry {
+    operations = new Map();
+    /**
+     * 注册系统操作
+     *
+     * @param operation - 要注册的操作
+     * @throws 如果操作名称已存在则抛出错误
+     */
+    register(operation) {
+        // 注册主名称
+        if (this.operations.has(operation.name)) {
+            throw new AOTUIError('OPERATION_DUPLICATE', { operationName: operation.name });
+        }
+        this.operations.set(operation.name, operation);
+        // 注册别名
+        if (operation.aliases) {
+            for (const alias of operation.aliases) {
+                if (this.operations.has(alias)) {
+                    throw new AOTUIError('OPERATION_DUPLICATE', { operationName: alias, reason: 'alias conflict' });
+                }
+                this.operations.set(alias, operation);
+            }
+        }
+    }
+    /**
+     * 检查操作是否存在
+     */
+    has(name) {
+        return this.operations.has(name);
+    }
+    /**
+     * 获取操作
+     */
+    get(name) {
+        return this.operations.get(name);
+    }
+    /**
+     * 执行系统操作
+     *
+     * @param name - 操作名称或别名
+     * @param ctx - 系统操作上下文
+     * @param desktop - 目标 Desktop
+     * @returns 操作结果
+     */
+    async execute(name, ctx, desktop) {
+        const operation = this.operations.get(name);
+        if (!operation) {
+            return failedResult('OPERATION_NOT_FOUND', { operationName: name });
+        }
+        try {
+            return await operation.execute(ctx, desktop);
+        }
+        catch (error) {
+            const aotuiError = AOTUIError.is(error) ? error : AOTUIError.fromError(error, 'EXECUTION_FAILED');
+            return {
+                success: false,
+                error: aotuiError.toOperationError()
+            };
+        }
+    }
+    /**
+     * 获取所有已注册的操作名称（用于调试）
+     */
+    getRegisteredNames() {
+        return Array.from(this.operations.keys());
+    }
+    /**
+     * 获取所有系统操作的 Tool Definitions (RFC-009)
+     *
+     * 返回去重后的 Tool 列表（不包含别名重复）
+     */
+    getToolDefinitions() {
+        const uniqueOps = new Set(this.operations.values());
+        return Array.from(uniqueOps).map(op => op.toolDefinition);
+    }
+}
+//# sourceMappingURL=registry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../src/engine/system/operations/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEvE;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,uBAAuB;IACxB,UAAU,GAAG,IAAI,GAAG,EAA4B,CAAC;IAEzD;;;;;OAKG;IACH,QAAQ,CAAC,SAA2B;QAChC,QAAQ;QACR,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,UAAU,CAAC,qBAAqB,EAAE,EAAE,aAAa,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;QACnF,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAE/C,OAAO;QACP,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;YACpB,KAAK,MAAM,KAAK,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;gBACpC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC7B,MAAM,IAAI,UAAU,CAAC,qBAAqB,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;gBACpG,CAAC;gBACD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;YAC1C,CAAC;QACL,CAAC;IACL,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACZ,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACZ,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,OAAO,CACT,IAAY,EACZ,GAA2B,EAC3B,OAA6B;QAE7B,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAE5C,IAAI,CAAC,SAAS,EAAE,CAAC;YACb,OAAO,YAAY,CAAC,qBAAqB,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACxE,CAAC;QAED,IAAI,CAAC;YACD,OAAO,MAAM,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACjD,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACtB,MAAM,UAAU,GAAG,UAAU,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAC;YAClG,OAAO;gBACH,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,UAAU,CAAC,gBAAgB,EAAE;aACvC,CAAC;QACN,CAAC;IACL,CAAC;IAED;;OAEG;IACH,kBAAkB;QACd,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED;;;;OAIG;IACH,kBAAkB;QACd,MAAM,SAAS,GAAG,IAAI,GAAG,CAAmB,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;QACtE,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC;IAC9D,CAAC;CACJ"}

package/dist/engine/system/operations/system/close-app.d.ts

@@ -0,0 +1,13 @@
+/**
+ * CloseAppOperation
+ *
+ * 关闭指定的应用程序。
+ */
+import type { ISystemOperation, SystemOperationContext, OperationResult, IDesktopForOperation } from '../../../../spi/index.js';
+import type { Tool } from '../../../../spi/core/tool-call.js';
+export declare class CloseAppOperation implements ISystemOperation {
+    readonly name = "close";
+    readonly aliases: readonly ["close_app"];
+    readonly toolDefinition: Tool;
+    execute(ctx: SystemOperationContext, desktop: IDesktopForOperation): Promise<OperationResult>;
+}

package/dist/engine/system/operations/system/close-app.js

@@ -0,0 +1,43 @@
+/**
+ * CloseAppOperation
+ *
+ * 关闭指定的应用程序。
+ */
+import { createAppId } from '../../../../spi/index.js';
+export class CloseAppOperation {
+    name = 'close';
+    aliases = ['close_app'];
+    toolDefinition = {
+        type: "function",
+        function: {
+            name: "system-close_app",
+            description: "关闭指定应用,将其从 Agent 视野中移除",
+            parameters: {
+                type: "object",
+                properties: {
+                    app_id: {
+                        type: "string",
+                        description: "应用 ID"
+                    }
+                },
+                required: ["app_id"]
+            }
+        }
+    };
+    async execute(ctx, desktop) {
+        const appId = (ctx.args.app_id ?? ctx.args.application);
+        if (!appId) {
+            return {
+                success: false,
+                error: {
+                    code: 'E_MISSING_ARG',
+                    message: "Missing required argument 'application'",
+                    context: { operation: this.name }
+                }
+            };
+        }
+        await desktop.closeApp(createAppId(appId));
+        return { success: true };
+    }
+}
+//# sourceMappingURL=close-app.js.map

package/dist/engine/system/operations/system/close-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"close-app.js","sourceRoot":"","sources":["../../../../../src/engine/system/operations/system/close-app.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGvD,MAAM,OAAO,iBAAiB;IACjB,IAAI,GAAG,OAAO,CAAC;IACf,OAAO,GAAG,CAAC,WAAW,CAAU,CAAC;IAEjC,cAAc,GAAS;QAC5B,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACN,IAAI,EAAE,kBAAkB;YACxB,WAAW,EAAE,wBAAwB;YACrC,UAAU,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACR,MAAM,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,OAAO;qBACvB;iBACJ;gBACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;aACvB;SACJ;KACJ,CAAC;IAEF,KAAK,CAAC,OAAO,CACT,GAA2B,EAC3B,OAA6B;QAE7B,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,CAAuB,CAAC;QAE9E,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,OAAO;gBACH,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE;oBACH,IAAI,EAAE,eAAe;oBACrB,OAAO,EAAE,yCAAyC;oBAClD,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE;iBACpC;aACJ,CAAC;QACN,CAAC;QAED,MAAM,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC7B,CAAC;CACJ"}

package/dist/engine/system/operations/system/dismount-view.d.ts

@@ -0,0 +1,13 @@
+/**
+ * DismountViewOperation
+ *
+ * 卸载指定的视图。
+ */
+import type { ISystemOperation, SystemOperationContext, OperationResult, IDesktopForOperation } from '../../../../spi/index.js';
+import type { Tool } from '../../../../spi/core/tool-call.js';
+export declare class DismountViewOperation implements ISystemOperation {
+    readonly name = "dismount_view";
+    readonly aliases: readonly ["close_view"];
+    readonly toolDefinition: Tool;
+    execute(ctx: SystemOperationContext, desktop: IDesktopForOperation): Promise<OperationResult>;
+}

package/dist/engine/system/operations/system/dismount-view.js

@@ -0,0 +1,48 @@
+/**
+ * DismountViewOperation
+ *
+ * 卸载指定的视图。
+ */
+import { createViewId, createAppId } from '../../../../spi/index.js';
+export class DismountViewOperation {
+    name = 'dismount_view';
+    aliases = ['close_view'];
+    toolDefinition = {
+        type: "function",
+        function: {
+            name: "system-dismount_view",
+            description: "卸载指定视图，减少界面干扰",
+            parameters: {
+                type: "object",
+                properties: {
+                    app_id: {
+                        type: "string",
+                        description: "应用 ID"
+                    },
+                    view_id: {
+                        type: "string",
+                        description: "视图 ID (如 view_1)"
+                    }
+                },
+                required: ["app_id", "view_id"]
+            }
+        }
+    };
+    async execute(ctx, desktop) {
+        const viewId = (ctx.args.view_id ?? ctx.args.viewId);
+        const appId = (ctx.args.app_id ?? ctx.args.appId);
+        if (!viewId || !appId) {
+            return {
+                success: false,
+                error: {
+                    code: 'E_MISSING_ARG',
+                    message: "Missing required argument 'view_id' or 'app_id'",
+                    context: { operation: this.name }
+                }
+            };
+        }
+        await desktop.dismountView(createAppId(appId), createViewId(viewId));
+        return { success: true };
+    }
+}
+//# sourceMappingURL=dismount-view.js.map

package/dist/engine/system/operations/system/dismount-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dismount-view.js","sourceRoot":"","sources":["../../../../../src/engine/system/operations/system/dismount-view.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGrE,MAAM,OAAO,qBAAqB;IACrB,IAAI,GAAG,eAAe,CAAC;IACvB,OAAO,GAAG,CAAC,YAAY,CAAU,CAAC;IAElC,cAAc,GAAS;QAC5B,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACN,IAAI,EAAE,sBAAsB;YAC5B,WAAW,EAAE,eAAe;YAC5B,UAAU,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACR,MAAM,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,OAAO;qBACvB;oBACD,OAAO,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,kBAAkB;qBAClC;iBACJ;gBACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;aAClC;SACJ;KACJ,CAAC;IAEF,KAAK,CAAC,OAAO,CACT,GAA2B,EAC3B,OAA6B;QAE7B,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAuB,CAAC;QAC3E,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAuB,CAAC;QAExE,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;YACpB,OAAO;gBACH,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE;oBACH,IAAI,EAAE,eAAe;oBACrB,OAAO,EAAE,iDAAiD;oBAC1D,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE;iBACpC;aACJ,CAAC;QACN,CAAC;QAED,MAAM,OAAO,CAAC,YAAY,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;QACrE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC7B,CAAC;CACJ"}

package/dist/engine/system/operations/system/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * System Operations Export
+ */
+export { OpenAppOperation } from './open-app.js';
+export { CloseAppOperation } from './close-app.js';
+export { DismountViewOperation } from './dismount-view.js';

package/dist/engine/system/operations/system/index.js

@@ -0,0 +1,7 @@
+/**
+ * System Operations Export
+ */
+export { OpenAppOperation } from './open-app.js';
+export { CloseAppOperation } from './close-app.js';
+export { DismountViewOperation } from './dismount-view.js';
+//# sourceMappingURL=index.js.map

package/dist/engine/system/operations/system/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/engine/system/operations/system/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/engine/system/operations/system/open-app.d.ts

@@ -0,0 +1,13 @@
+/**
+ * OpenAppOperation
+ *
+ * 打开指定的应用程序。
+ */
+import type { ISystemOperation, SystemOperationContext, OperationResult, IDesktopForOperation } from '../../../../spi/index.js';
+import type { Tool } from '../../../../spi/core/tool-call.js';
+export declare class OpenAppOperation implements ISystemOperation {
+    readonly name = "open";
+    readonly aliases: readonly ["open_app"];
+    readonly toolDefinition: Tool;
+    execute(ctx: SystemOperationContext, desktop: IDesktopForOperation): Promise<OperationResult>;
+}

package/dist/engine/system/operations/system/open-app.js

@@ -0,0 +1,43 @@
+/**
+ * OpenAppOperation
+ *
+ * 打开指定的应用程序。
+ */
+import { createAppId } from '../../../../spi/index.js';
+export class OpenAppOperation {
+    name = 'open';
+    aliases = ['open_app'];
+    toolDefinition = {
+        type: "function",
+        function: {
+            name: "system-open_app",
+            description: "打开指定应用,使其对 Agent 可见",
+            parameters: {
+                type: "object",
+                properties: {
+                    app_id: {
+                        type: "string",
+                        description: "应用 ID,格式为 app_n (如 app_0, app_1)"
+                    }
+                },
+                required: ["app_id"]
+            }
+        }
+    };
+    async execute(ctx, desktop) {
+        const appId = (ctx.args.app_id ?? ctx.args.application);
+        if (!appId) {
+            return {
+                success: false,
+                error: {
+                    code: 'E_MISSING_ARG',
+                    message: "Missing required argument 'application'",
+                    context: { operation: this.name }
+                }
+            };
+        }
+        await desktop.openApp(createAppId(appId));
+        return { success: true };
+    }
+}
+//# sourceMappingURL=open-app.js.map

package/dist/engine/system/operations/system/open-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-app.js","sourceRoot":"","sources":["../../../../../src/engine/system/operations/system/open-app.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGvD,MAAM,OAAO,gBAAgB;IAChB,IAAI,GAAG,MAAM,CAAC;IACd,OAAO,GAAG,CAAC,UAAU,CAAU,CAAC;IAEhC,cAAc,GAAS;QAC5B,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACN,IAAI,EAAE,iBAAiB;YACvB,WAAW,EAAE,qBAAqB;YAClC,UAAU,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACR,MAAM,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,kCAAkC;qBAClD;iBACJ;gBACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;aACvB;SACJ;KACJ,CAAC;IAEF,KAAK,CAAC,OAAO,CACT,GAA2B,EAC3B,OAA6B;QAE7B,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,CAAuB,CAAC;QAE9E,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,OAAO;gBACH,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE;oBACH,IAAI,EAAE,eAAe;oBACrB,OAAO,EAAE,yCAAyC;oBAClD,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE;iBACpC;aACJ,CAAC;QACN,CAAC;QAED,MAAM,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC7B,CAAC;CACJ"}

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

@@ -0,0 +1,36 @@
+import type { SnapshotID, CachedSnapshot, IndexMap, DataPayload, IRegistry, StructuredSnapshot } from '../../spi/index.js';
+interface RegistryConfig {
+    ttl: number;
+}
+export declare class SnapshotRegistry implements IRegistry {
+    private snapshots;
+    private config;
+    constructor(config?: RegistryConfig);
+    /**
+     * Creates a new snapshot and registers it.
+     * Starts with RefCount = 1.
+     *
+     * [RFC-014] Now accepts optional structured parameter.
+     */
+    create(indexMap: IndexMap, markup: string, ttl?: number, structured?: StructuredSnapshot): CachedSnapshot;
+    /**
+     * Increases reference count.
+     */
+    retain(id: SnapshotID): void;
+    /**
+     * Decreases reference count. Destroys if 0.
+     */
+    release(id: SnapshotID): void;
+    /**
+     * Resolves a data path from the snapshot.
+     */
+    resolve(id: SnapshotID, path: string): DataPayload | undefined;
+    /**
+     * Returns snapshot without internal implementation details.
+     * [H1 FIX] No longer exposes internal `timer` field.
+     */
+    getSnapshot(id: SnapshotID): CachedSnapshot | undefined;
+    private destroy;
+    private forceDestroy;
+}
+export {};