using System;
using System.Threading.Tasks;

namespace AI.AgentIntegration
{
    /// <summary>
    /// 定义应用程序控制器的接口
    /// </summary>
    public interface IAppController
    {
        /// <summary>
        /// 当应用程序状态发生变化时触发的事件
        /// </summary>
        event EventHandler<AppState> StateChanged;

        /// <summary>
        /// 获取应用程序的当前状态
        /// </summary>
        /// <returns>当前应用程序状态</returns>
        AppState GetCurrentState();

        /// <summary>
        /// 执行指定的应用程序操作
        /// </summary>
        /// <param name="action">要执行的操作</param>
        /// <returns>操作执行结果</returns>
        Task<AppActionResult> ExecuteAsync(AppAction action);
    }
}