namespace WIDESEAWCS_Tasks.Workflow.Abstractions
{
    /// <summary>
    /// 机器人简单命令处理器接口
    /// </summary>
    /// <remarks>
    /// 简单命令是指不需要额外参数的状态更新命令，如运行状态、模式切换等。
    /// 与前缀命令（需要解析位置参数）相对。
    /// </remarks>
    public interface IRobotSimpleCommandHandler
    {
        /// <summary>
        /// 处理简单命令
        /// </summary>
        /// <param name="message">消息内容（小写形式）</param>
        /// <param name="state">机器人当前状态（会被修改）</param>
        /// <returns>是否成功处理；无法识别的命令返回 false</returns>
        Task<bool> HandleAsync(string message, RobotSocketState state);
    }
}