function_table.cpp

Go to the documentation of this file.

/*
    Copyright (C) 2009 - 2023
    by Bartosz Waresiak <dragonking@o2.pl>
    Part of the Battle for Wesnoth Project https://www.wesnoth.org/
 
    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.
    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY.
 
    See the COPYING file for more details.
*/
 
#include <queue>
#include <set>
#include <utility>
#include <vector>
 
#include "ai/formula/ai.hpp"
#include "ai/formula/callable_objects.hpp"
#include "ai/formula/function_table.hpp"
 
#include "ai/default/contexts.hpp"
 
#include "formula/function_gamestate.hpp"
#include "attack_prediction.hpp"
#include "filesystem.hpp"
#include "game_board.hpp"
#include "global.hpp"
#include "display.hpp"
#include "log.hpp"
#include "map/label.hpp"
#include "map/map.hpp"
#include "pathfind/teleport.hpp"
#include "replay.hpp"
#include "resources.hpp"
#include "color.hpp"
#include "terrain/filter.hpp"
#include "units/unit.hpp"
#include "units/types.hpp"
#include "pathfind/pathfind.hpp"
 
static lg::log_domain log_formula_ai("ai/engine/fai");
#define LOG_AI LOG_STREAM(info, log_formula_ai)
#define WRN_AI LOG_STREAM(warn, log_formula_ai)
#define ERR_AI LOG_STREAM(err, log_formula_ai)
 
namespace wfl {
using ai::formula_ai;
 
namespace {
 
/*
 * unit adapters let us treat unit and unit_type the same if we want to get access to attacks or movement cost
 */
class unit_adapter {
    public:
        unit_adapter(const variant& arg) : unit_type_(), unit_() {
            auto unit = arg.try_convert<unit_callable>();
 
            if (unit) {
                unit_ = &unit->get_unit();
            } else {
                unit_type_ = &(arg.convert_to<unit_type_callable>()->get_unit_type());
            }
        }
 
        int damage_from(const attack_type& attack) const {
            if(unit_type_ != nullptr) {
                return unit_type_->movement_type().resistance_against(attack);
            } else {
                return unit_->damage_from(attack, false, map_location());
            }
        }
 
        const_attack_itors attacks() const {
            if(unit_type_ != nullptr) {
                return unit_type_->attacks();
            } else {
                return unit_->attacks();
            }
        }
 
        int movement_cost(const t_translation::terrain_code & terrain) const {
            if(unit_type_ != nullptr) {
                return unit_type_->movement_type().movement_cost(terrain);
            } else {
                return unit_->movement_cost(terrain);
            }
        }
 
    private:
        const unit_type *unit_type_;
        const unit* unit_;
};
 
#define DEFINE_FAI_FUNCTION(name, min_args, max_args)                                                                 \
    class name##_function : public function_expression                                                               \
    {                                                                                                                 \
    public:                                                                                                         \
        explicit name##_function(const args_list& args, const formula_ai& ai)                                         \
            : function_expression(#name, args, min_args, max_args), ai_(ai)                                         \
        {                                                                                                             \
        }                                                                                                             \
                                                                                                                       \
    private:                                                                                                           \
        const formula_ai& ai_;                                                                                       \
        variant execute(const formula_callable& variables, formula_debugger* fdb) const;                               \
    };                                                                                                               \
                                                                                                                       \
    variant name##_function::execute(const formula_callable& variables, formula_debugger* fdb) const
 
DEFINE_FAI_FUNCTION(distance_to_nearest_unowned_village, 1, 1)
{
    const map_location loc = args()[0]->evaluate(variables, add_debug_info(fdb, 0, "distance_to_nearest_unowned_village:location")).convert_to<location_callable>()->loc();
    int best = 1000000;
    const std::vector<map_location>& villages = resources::gameboard->map().villages();
    const std::set<map_location>& my_villages = ai_.current_team().villages();
    for(std::vector<map_location>::const_iterator i = villages.begin(); i != villages.end(); ++i) {
        int distance = distance_between(loc, *i);
        if(distance < best) {
            if(my_villages.count(*i) == 0) {
                best = distance;
            }
        }
    }
 
    return variant(best);
}
 
static unsigned search_counter;
 
namespace {
    struct indexer {
        int w, h;
        indexer(int a, int b) : w(a), h(b) { }
        int operator()(const map_location& loc) const {
            return loc.y * w + loc.x;
        }
    };
 
    struct node {
        int movement_cost_;
        map_location loc_;
 
        /**
         * If equal to search_counter, the node is off the list.
         * If equal to search_counter + 1, the node is on the list.
         * Otherwise it is outdated.
         */
        unsigned in;
 
        node(int moves, const map_location &loc)
            : movement_cost_(moves)
            , loc_(loc)
            , in(0)
        {
        }
 
        node()
            : movement_cost_(0)
            , loc_()
            , in(0)
        {
        }
 
        bool operator<(const node& o) const {
            return movement_cost_ < o.movement_cost_;
        }
    };
 
    struct comp {
        const std::vector<node>& nodes;
        comp(const std::vector<node>& n) : nodes(n) { }
        bool operator()(int l, int r) const {
            return nodes[r] < nodes[l];
        }
    };
 
    void find_movemap(const unit_adapter& u, const map_location& loc,
        std::vector<int>& scores, bool allow_teleport, const formula_ai& ai_)
    {
        const std::set<map_location>& teleports = allow_teleport ? ai_.current_team().villages() : std::set<map_location>();
 
        const gamemap& map = resources::gameboard->map();
 
        std::vector<map_location> locs(6 + teleports.size());
        std::copy(teleports.begin(), teleports.end(), locs.begin() + 6);
 
        search_counter += 2;
        if (search_counter == 0) search_counter = 2;
 
        static std::vector<node> nodes;
        nodes.resize(map.w() * map.h());
 
        indexer index(map.w(), map.h());
        comp node_comp(nodes);
 
        nodes[index(loc)] = node(0, loc);
        std::vector<int> pq;
        pq.push_back(index(loc));
        while (!pq.empty()) {
            node& n = nodes[pq.front()];
            std::pop_heap(pq.begin(), pq.end(), node_comp);
            pq.pop_back();
            n.in = search_counter;
 
            get_adjacent_tiles(n.loc_, locs.data());
            for (int i = teleports.count(n.loc_) ? locs.size() : 6; i-- > 0;) {
                if (!locs[i].valid(map.w(), map.h())) continue;
 
                node& next = nodes[index(locs[i])];
                bool next_visited = next.in - search_counter <= 1u;
 
                // test if the current path to locs[i] is better than this one could possibly be.
                // we do this a couple more times below
                if (next_visited &&  !(n < next)) continue;
                const int move_cost = u.movement_cost(map[locs[i]]);
 
                node t = node(n.movement_cost_ + move_cost, locs[i]);
 
                if (next_visited &&  !(t < next)) continue;
 
                bool in_list = next.in == search_counter + 1;
                t.in = search_counter + 1;
                next = t;
 
                // if already in the priority queue then we just update it, else push it.
                if (in_list) {
                    std::push_heap(pq.begin(), std::find(pq.begin(), pq.end(), index(locs[i])) + 1, node_comp);
                }
                else {
                    pq.push_back(index(locs[i]));
                    std::push_heap(pq.begin(), pq.end(), node_comp);
                }
            }
        }
 
        for (int x = 0; x < map.w(); ++x) {
            for (int y = 0; y < map.h(); ++y)
            {
                int i = y * map.w() + x;
                const node &n = nodes[i];
                scores[i] = scores[i] + n.movement_cost_;
                //std::cout << x << "," << y << ":" << n.movement_cost << std::endl;
            }
        }
    }
}
 
DEFINE_FAI_FUNCTION(calculate_map_ownership, 2, 5)
{
    int w = resources::gameboard->map().w();
    int h = resources::gameboard->map().h();
 
    const variant units_input = args()[0]->evaluate(variables,fdb);
    const variant leaders_input = args()[1]->evaluate(variables,fdb);
 
    int enemy_tolerance = 3;
    if( args().size() > 2 )
        enemy_tolerance = args()[2]->evaluate(variables,fdb).as_int();
 
    int enemy_border_tolerance = 5;
    if( args().size() > 3 )
        enemy_border_tolerance = args()[3]->evaluate(variables,fdb).as_int();
 
    int ally_tolerance = 3;
    if( args().size() > 4 )
        ally_tolerance = args()[4]->evaluate(variables,fdb).as_int();
 
    if( !units_input.is_list() )
        return variant();
 
    std::size_t number_of_teams = units_input.num_elements();
 
    std::vector< std::vector<int>> scores( number_of_teams );
 
    for( std::size_t i = 0; i< number_of_teams; ++i)
        scores[i].resize(w*h);
 
    /* // TODO: Do we need this?
    for(unit_map::const_iterator i = resources::gameboard->units().begin(); i != resources::gameboard->units().end(); ++i) {
        unit_counter[i->second.side()-1]++;
        unit_adapter unit(i->second);
        find_movemap( resources::gameboard->map(), resources::gameboard->units(), unit, i->first, scores[i->second.side()-1], ai_.resources::gameboard->teams() , true );
    }
    */
 
    for(std::size_t side = 0 ; side < units_input.num_elements() ; ++side) {
        if( leaders_input[side].is_empty() )
            continue;
 
        const map_location loc = leaders_input[side][0].convert_to<location_callable>()->loc();
        const variant units_of_side = units_input[side];
 
        for(std::size_t unit_it = 0 ; unit_it < units_of_side.num_elements() ; ++unit_it) {
            unit_adapter unit(units_of_side[unit_it]);
            find_movemap( unit, loc, scores[side], true, ai_ );
        }
    }
 
    std::size_t index = 0;
    for( std::vector< std::vector<int>>::iterator i = scores.begin() ; i != scores.end() ; ++i) {
        for( std::vector<int>::iterator j = i->begin() ; j != i->end() ; ++j ) {
            if(units_input[index].num_elements() != 0) {
                *j /= units_input[index].num_elements();
            } else {
                *j = 0;
            }
        }
 
        ++index;
    }
    //std::vector<variant> res;
    std::map<variant, variant> res;
 
    std::size_t current_side = ai_.get_side() - 1 ;
 
    std::vector<int> enemies;
    std::vector<int> allies;
 
    for(std::size_t side = 0 ; side < units_input.num_elements() ; ++side) {
        if( side == current_side)
            continue;
 
        if( ai_.current_team().is_enemy(side+1) ) {
            if( !leaders_input[side].is_empty() )
                enemies.push_back(side);
        } else {
            if( !leaders_input[side].is_empty() )
                allies.push_back(side);
        }
    }
 
    //calculate_map_ownership( recruits_of_side, map(units_of_side, 'units', map( filter(units, leader), loc) ) )
    //map(, debug_label(key,value))
    for (int x = 0; x < w; ++x) {
        for (int y = 0; y < h; ++y)
        {
            int i = y * w + x;
            bool valid = true;
            bool enemy_border = false;
 
            if( scores[current_side][i] > 98 )
                continue;
 
            for (int side : enemies) {
                int diff = scores[current_side][i] - scores[side][i];
                if ( diff > enemy_tolerance) {
                    valid = false;
                    break;
                } else if( std::abs(diff) < enemy_border_tolerance )
                    enemy_border = true;
            }
 
            if( valid ) {
                for (int side : allies) {
                    if ( scores[current_side][i] - scores[side][i] > ally_tolerance ) {
                        valid = false;
                        break;
                    }
                }
            }
 
            if( valid ) {
                if( enemy_border )
                    res.emplace(variant(std::make_shared<location_callable>(map_location(x, y))), variant(scores[0][i] + 10000));
                else
                    res.emplace(variant(std::make_shared<location_callable>(map_location(x, y))), variant(scores[0][i]));
            }
        }
    }
    return variant(res);
}
 
DEFINE_WFL_FUNCTION(nearest_loc, 2, 2)
{
    const map_location loc = args()[0]->evaluate(variables, add_debug_info(fdb, 0, "nearest_loc:location")).convert_to<location_callable>()->loc();
    variant items = args()[1]->evaluate(variables,add_debug_info(fdb,1,"nearest_loc:locations"));
    int best = 1000000;
    int best_i = -1;
 
    for(std::size_t i = 0; i < items.num_elements(); ++i) {
 
        const map_location move_loc = items[i].convert_to<location_callable>()->loc();
        int distance = distance_between(loc, move_loc);
 
        if(distance < best) {
                best = distance;
                best_i = i;
        }
    }
 
    if( best_i != -1)
        return variant(std::make_shared<location_callable>(items[best_i].convert_to<location_callable>()->loc()));
    else
        return variant();
}
 
/** FormulaAI function to run fai script from file. Usable from in-game console.
*   arguments[0] - required file name, follows the usual wml convention
*/
DEFINE_FAI_FUNCTION(run_file, 1, 1)
{
    const args_list& arguments = args();
    const variant var0 = arguments[0]->evaluate(variables,add_debug_info(fdb,0,"run_file:file"));
    const std::string filename = var0.string_cast();
 
    //NOTE: get_wml_location also filters file path to ensure it doesn't contain things like "../../top/secret"
    std::string path = filesystem::get_wml_location(filename);
    if(path.empty()) {
        ERR_AI << "run_file : not found [" << filename <<"]";
        return variant(); //no suitable file
    }
 
    std::string formula_string = filesystem::read_file(path);
    //need to get function_table from somewhere or delegate to someone who has access to it
    formula_ptr parsed_formula = ai_.create_optional_formula(formula_string);
    if(parsed_formula == formula_ptr()) {
        ERR_AI << "run_file : unable to create formula";
        return variant(); //was unable to create a formula from file
    }
    return parsed_formula->evaluate(variables,add_debug_info(fdb,-1,"run_file:formula_from_file"));
}
 
DEFINE_WFL_FUNCTION(castle_locs, 1, 1)
{
    const map_location starting_loc = args()[0]->evaluate(variables, add_debug_info(fdb, 0, "castle_locs:location")).convert_to<location_callable>()->loc();
 
    //looks like reimplementing a generic graph search algorithm to me
            std::set< map_location > visited_locs;
            std::queue< map_location > queued_locs;
 
            queued_locs.push(starting_loc);
 
            while( !queued_locs.empty() ) {
                const map_location loc = queued_locs.front();
                queued_locs.pop();
 
                if ( visited_locs.find( loc ) != visited_locs.end() )
                    continue;
 
                visited_locs.insert(loc);
 
                for(const map_location& adj : get_adjacent_tiles(loc)) {
                    if (resources::gameboard->map().on_board(adj) && visited_locs.find( adj ) == visited_locs.end() ) {
                        if (resources::gameboard->map().get_terrain_info(adj).is_keep() ||
                                resources::gameboard->map().get_terrain_info(adj).is_castle() ) {
                            queued_locs.push(adj);
                        }
                    }
                }
            }
 
            if ( !resources::gameboard->map().get_terrain_info(starting_loc).is_keep() &&
                    !resources::gameboard->map().get_terrain_info(starting_loc).is_castle() )
                visited_locs.erase(starting_loc);
 
            std::vector<variant> res;
            for (const map_location& ml : visited_locs) {
                res.emplace_back(std::make_shared<location_callable>( ml ));
            }
 
    return variant(res);
}
 
/**
 * timeofday_modifer formula function. Returns combat modifier, taking
 * alignment, illuminate, time of day and fearless trait into account.
 * 'leadership' and 'slowed' are not taken into account.
 * arguments[0] - unit
 * arguments[1] - location (optional, defaults to unit's current location.
 */
DEFINE_WFL_FUNCTION(timeofday_modifier, 1, 2)
{
    variant u = args()[0]->evaluate(variables,add_debug_info(fdb,0,"timeofday_modifier:unit"));
 
    if( u.is_null() ) {
        return variant();
    }
 
    auto u_call = u.try_convert<unit_callable>();
 
    if(!u_call) {
        return variant();
    }
 
    const unit& un = u_call->get_unit();
 
    map_location loc;
 
    if(args().size()==2) {
        loc = args()[1]->evaluate(variables, add_debug_info(fdb, 1, "timeofday_modifier:location")).convert_to<location_callable>()->loc();
    }
 
    if(!loc.valid()) {
        loc = u_call->get_location();
    }
 
    return variant(combat_modifier(resources::gameboard->units(), resources::gameboard->map(), loc, un.alignment(), un.is_fearless()));
}
 
DEFINE_FAI_FUNCTION(nearest_keep, 1, 1)
{
    const map_location loc = args()[0]->evaluate(variables, add_debug_info(fdb, 0, "nearest_keep:location")).convert_to<location_callable>()->loc();
    int best = 1000000;
    int best_i = -1;
 
    ai_.get_keeps();
    int size = ai_.get_keeps_cache().num_elements();
 
    for( int i = 0 ; i < size; ++i) {
        int distance = distance_between(loc, ai_.get_keeps_cache()[i].convert_to<location_callable>()->loc() );
        if(distance < best)
        {
                best = distance;
                best_i = i;
        }
    }
 
    if( best_i != -1)
        return variant(std::make_shared<location_callable>(ai_.get_keeps_cache()[best_i].convert_to<location_callable>()->loc()));
    else
        return variant();
}
 
/**
* Find suitable keep for unit at location
* arguments[0] - location for unit on which the suitable keep is to be found
*/
DEFINE_FAI_FUNCTION(suitable_keep, 1, 1)
{
    const map_location loc = args()[0]->evaluate(variables, add_debug_info(fdb, 0, "suitable_keep:location")).convert_to<location_callable>()->loc();
    const unit_map& units = resources::gameboard->units();
    const unit_map::const_iterator u = units.find(loc);
    if (u == units.end()){
        return variant();
    }
    const pathfind::paths unit_paths(*u, false, true, ai_.current_team());
    return variant(std::make_shared<location_callable>(ai_.suitable_keep(loc,unit_paths)));
}
 
DEFINE_FAI_FUNCTION(find_shroud, 0, 1)
{
    std::vector<variant> vars;
    int w,h;
 
    if(args().size()==1) {
        const gamemap& m = args()[0]->evaluate(variables, add_debug_info(fdb, 0, "find_shroud:gamemap")).convert_to<gamemap_callable>()->get_gamemap();
        w = m.w();
        h = m.h();
    } else {
        w = resources::gameboard->map().w();
        h = resources::gameboard->map().h();
    }
 
    for(int i = 0; i < w; ++i)
        for(int j = 0; j < h; ++j) {
            if(ai_.current_team().shrouded(map_location(i,j)))
                vars.emplace_back(std::make_shared<location_callable>(map_location(i, j)));
        }
 
    return variant(vars);
}
 
DEFINE_FAI_FUNCTION(close_enemies, 2, 2)
{
    std::vector<variant> vars;
    const map_location loc = args()[0]->evaluate(variables, add_debug_info(fdb, 0, "close_enemies:location")).convert_to<location_callable>()->loc();
    int range_s = args()[1]->evaluate(variables,add_debug_info(fdb,1,"close_enemies:distance")).as_int();
    if (range_s < 0) {
        WRN_AI << "close_enemies_function: range is negative (" << range_s << ")";
        range_s = 0;
    }
    std::size_t range = static_cast<std::size_t>(range_s);
    unit_map::const_iterator un = resources::gameboard->units().begin();
    unit_map::const_iterator end = resources::gameboard->units().end();
    while (un != end) {
        if (distance_between(loc, un->get_location()) <= range) {
            if (un->side() != ai_.get_side()) {//fixme: ignores allied units
                vars.emplace_back(std::make_shared<unit_callable>(*un));
            }
        }
        ++un;
    }
    return variant(vars);
}
 
DEFINE_WFL_FUNCTION(calculate_outcome, 3, 4)
{
    std::vector<variant> vars;
    int weapon;
    if (args().size() > 3) weapon = args()[3]->evaluate(variables,add_debug_info(fdb,3,"calculate_outcome:weapon")).as_int();
    else weapon = -1;
 
    const unit_map& units = resources::gameboard->units();
    map_location attacker_location =
        args()[0]->evaluate(variables, add_debug_info(fdb, 0, "calculate_outcome:attacker_current_location")).convert_to<location_callable>()->loc();
    if(units.count(attacker_location) == 0) {
        ERR_AI << "Performing calculate_outcome() with non-existent attacker at (" <<
            attacker_location.wml_x() << "," << attacker_location.wml_y() << ")";
        return variant();
    }
 
    map_location defender_location =
        args()[2]->evaluate(variables,add_debug_info(fdb, 2, "calculate_outcome:defender_location")).convert_to<location_callable>()->loc();
    if(units.count(defender_location) == 0) {
        ERR_AI << "Performing calculate_outcome() with non-existent defender at (" <<
            defender_location.wml_x() << "," << defender_location.wml_y() << ")";
        return variant();
    }
 
    battle_context bc(units, args()[1]->evaluate(variables, add_debug_info(fdb, 1, "calculate_outcome:attacker_attack_location")).convert_to<location_callable>()->loc(),
        defender_location, weapon, -1, 1.0, nullptr, units.find(attacker_location).get_shared_ptr());
    std::vector<double> hp_dist = bc.get_attacker_combatant().hp_dist;
    std::vector<double>::iterator it = hp_dist.begin();
    int i = 0;
    std::vector<variant> hitLeft;
    std::vector<variant> prob;
    while (it != hp_dist.end()) {
        if (*it != 0) {
            hitLeft.emplace_back(i);
            prob.emplace_back(static_cast<int>(*it*10000));
        }
        ++it;
        ++i;
    }
    std::vector<variant> status;
    if (bc.get_attacker_combatant().poisoned != 0)
        status.emplace_back("Poisoned");
    if (bc.get_attacker_combatant().slowed != 0)
        status.emplace_back("Slowed");
    if (bc.get_defender_stats().petrifies && static_cast<unsigned int>(hitLeft[0].as_int()) != bc.get_attacker_stats().hp)
        status.emplace_back("Stoned");
    if (bc.get_defender_stats().plagues && hitLeft[0].as_int() == 0)
        status.emplace_back("Zombiefied");
    vars.emplace_back(std::make_shared<outcome_callable>(hitLeft, prob, status));
    hitLeft.clear();
    prob.clear();
    status.clear();
    hp_dist = bc.get_defender_combatant().hp_dist;
    it = hp_dist.begin();
    i = 0;
    while (it != hp_dist.end()) {
        if (*it != 0) {
            hitLeft.emplace_back(i);
            prob.emplace_back(static_cast<int>(*it*10000));
        }
        ++it;
        ++i;
    }
    if (bc.get_defender_combatant().poisoned != 0)
        status.emplace_back("Poisoned");
    if (bc.get_defender_combatant().slowed != 0)
        status.emplace_back("Slowed");
    if (bc.get_attacker_stats().petrifies && static_cast<unsigned int>(hitLeft[0].as_int()) != bc.get_defender_stats().hp)
        status.emplace_back("Stoned");
    if (bc.get_attacker_stats().plagues && hitLeft[0].as_int() == 0)
        status.emplace_back("Zombiefied");
    vars.emplace_back(std::make_shared<outcome_callable>(hitLeft, prob, status));
    return variant(vars);
}
 
DEFINE_WFL_FUNCTION(outcomes, 1, 1)
{
    variant attack = args()[0]->evaluate(variables,add_debug_info(fdb,0,"outcomes:attack"));
    auto analysis = attack.convert_to<ai::attack_analysis>();
    //unit_map units_with_moves(resources::gameboard->units());
    //typedef std::pair<map_location, map_location> mv;
    //for(const mv &m : analysis->movements) {
    //  units_with_moves.move(m.first, m.second);
    //}
 
    std::vector<variant> vars;
    if(analysis->chance_to_kill > 0.0) {
        //unit_map units(units_with_moves);
        //units.erase(analysis->target);
        vars.emplace_back(std::make_shared<position_callable>(/*&units,*/ static_cast<int>(analysis->chance_to_kill*100)));
 
    }
 
    if(analysis->chance_to_kill < 1.0) {
        //unit_map units(units_with_moves);
        vars.emplace_back(std::make_shared<position_callable>(/*&units,*/ static_cast<int>(100 - analysis->chance_to_kill*100)));
    }
 
    return variant(vars);
}
 
DEFINE_FAI_FUNCTION(rate_action, 1, 1)
{
    variant act = args()[0]->evaluate(variables,add_debug_info(fdb,0,"rate_action:action"));
    auto analysis = act.convert_to<ai::attack_analysis>();
 
    return variant(analysis->rating(ai_.get_aggression(),ai_)*1000,variant::DECIMAL_VARIANT);
}
 
DEFINE_WFL_FUNCTION(recall, 1, 2)
{
    const std::string id = args()[0]->evaluate(variables,add_debug_info(fdb,0,"recall:id")).as_string();
    map_location loc;
    if(args().size() >= 2) {
        loc = args()[1]->evaluate(variables, add_debug_info(fdb, 1, "recall:location")).convert_to<location_callable>()->loc();
    }
 
    return variant(std::make_shared<recall_callable>(loc, id));
}
 
DEFINE_WFL_FUNCTION(recruit, 1, 2)
{
    const std::string type = args()[0]->evaluate(variables,add_debug_info(fdb,0,"recruit:type")).as_string();
    map_location loc;
    if(args().size() >= 2) {
        loc = args()[1]->evaluate(variables, add_debug_info(fdb, 1, "recruit:location")).convert_to<location_callable>()->loc();
    }
 
    return variant(std::make_shared<recruit_callable>(loc, type));
}
 
DEFINE_FAI_FUNCTION(shortest_path, 2, 3)
{
 
    std::vector<variant> locations;
 
    const map_location src = args()[0]->evaluate(variables, add_debug_info(fdb, 0, "shortest_path:src")).convert_to<location_callable>()->loc();
    const map_location dst = args()[1]->evaluate(variables, add_debug_info(fdb, 1, "shortest_path:dst")).convert_to<location_callable>()->loc();
    map_location unit_loc;
 
    if( src == dst )
        return variant(locations);
 
    if(args().size() > 2)
        unit_loc = args()[2]->evaluate(variables,add_debug_info(fdb,2,"shortest_path:unit_location")).convert_to<location_callable>()->loc();
    else
        unit_loc = src;
 
    unit_map::iterator unit_it = resources::gameboard->units().find(unit_loc);
 
    if( unit_it == resources::gameboard->units().end() ) {
        std::ostringstream str;
        str << "shortest_path function: expected unit at location (" << (unit_loc.wml_x()) << "," << (unit_loc.wml_y()) << ")";
        throw formula_error( str.str(), "", "", 0);
    }
 
    pathfind::teleport_map allowed_teleports = ai_.get_allowed_teleports(unit_it);
 
    pathfind::plain_route route = ai_.shortest_path_calculator( src, dst, unit_it, allowed_teleports );
 
    if( route.steps.size() < 2 ) {
        return variant(locations);
    }
 
    for (std::vector<map_location>::const_iterator loc_iter = route.steps.begin() + 1 ; loc_iter !=route.steps.end(); ++loc_iter) {
        locations.emplace_back(std::make_shared<location_callable>(*loc_iter));
    }
 
    return variant(locations);
}
 
DEFINE_FAI_FUNCTION(simplest_path, 2, 3)
{
    std::vector<variant> locations;
 
    const map_location src = args()[0]->evaluate(variables, add_debug_info(fdb, 0, "simplest_path:src")).convert_to<location_callable>()->loc();
    const map_location dst = args()[1]->evaluate(variables, add_debug_info(fdb, 1, "simplest_path:dst")).convert_to<location_callable>()->loc();
    map_location unit_loc;
 
    if( src == dst )
        return variant(locations);
 
    if(args().size() > 2)
        unit_loc = args()[2]->evaluate(variables, add_debug_info(fdb, 2, "simplest_path:unit_location")).convert_to<location_callable>()->loc();
    else
        unit_loc = src;
 
    unit_map::iterator unit_it = resources::gameboard->units().find(unit_loc);
 
    if( unit_it == resources::gameboard->units().end() ) {
        std::ostringstream str;
        str << "simplest_path function: expected unit at location (" << (unit_loc.wml_x()) << "," << (unit_loc.wml_y()) << ")";
        throw formula_error( str.str(), "", "", 0);
    }
 
    pathfind::teleport_map allowed_teleports = ai_.get_allowed_teleports(unit_it);
 
    pathfind::emergency_path_calculator em_calc(*unit_it, resources::gameboard->map());
 
    pathfind::plain_route route = pathfind::a_star_search(src, dst, 1000.0, em_calc, resources::gameboard->map().w(), resources::gameboard->map().h(), &allowed_teleports);
 
    if( route.steps.size() < 2 ) {
        return variant(locations);
    }
 
    for (std::vector<map_location>::const_iterator loc_iter = route.steps.begin() + 1 ; loc_iter !=route.steps.end(); ++loc_iter) {
        if(unit_it->movement_cost(static_cast<const game_board*>(resources::gameboard)->map()[*loc_iter]) < movetype::UNREACHABLE) {
            locations.emplace_back(std::make_shared<location_callable>(*loc_iter));
        } else {
            break;
        }
    }
 
    return variant(locations);
}
 
DEFINE_FAI_FUNCTION(next_hop, 2, 3)
{
 
    const map_location src = args()[0]->evaluate(variables, add_debug_info(fdb, 0, "next_hop:src")).convert_to<location_callable>()->loc();
    const map_location dst = args()[1]->evaluate(variables, add_debug_info(fdb, 1, "next_hop:dst")).convert_to<location_callable>()->loc();
            map_location unit_loc;
 
            if( src == dst )
        return variant();
 
            if(args().size() > 2)
        unit_loc = args()[2]->evaluate(variables, add_debug_info(fdb, 2, "next_hop:unit_location")).convert_to<location_callable>()->loc();
            else
                unit_loc = src;
 
            unit_map::iterator unit_it = resources::gameboard->units().find(unit_loc);
 
    if( unit_it == resources::gameboard->units().end() ) {
        std::ostringstream str;
        str << "next_hop function: expected unit at location (" << (unit_loc.wml_x()) << "," << (unit_loc.wml_y()) << ")";
        throw formula_error( str.str(), "", "", 0);
    }
 
    pathfind::teleport_map allowed_teleports = ai_.get_allowed_teleports(unit_it);
 
    pathfind::plain_route route = ai_.shortest_path_calculator( src, dst, unit_it, allowed_teleports );
 
            if( route.steps.size() < 2 ) {
        return variant();
            }
 
    map_location loc = map_location::null_location();
    const ai::moves_map &possible_moves = ai_.get_possible_moves();
    const ai::moves_map::const_iterator& p_it = possible_moves.find(unit_loc);
    if (p_it==possible_moves.end() ) {
        return variant();
    }
 
            for (std::vector<map_location>::const_iterator loc_iter = route.steps.begin() + 1 ; loc_iter !=route.steps.end(); ++loc_iter) {
 
        if (p_it->second.destinations.find(*loc_iter) != p_it->second.destinations.end() ) {
            loc = *loc_iter;
        } else {
            break;
        }
            }
    if (loc==map_location::null_location()) {
        return variant();
    }
    return variant(std::make_shared<location_callable>(loc));
}
 
DEFINE_WFL_FUNCTION(move, 2, 2)
{
    const map_location src = args()[0]->evaluate(variables, add_debug_info(fdb, 0, "move:src")).convert_to<location_callable>()->loc();
    const map_location dst = args()[1]->evaluate(variables, add_debug_info(fdb, 1, "move:dst")).convert_to<location_callable>()->loc();
    LOG_AI << "move(): " << src << ", " << dst << ")";
    return variant(std::make_shared<move_callable>(src, dst));
}
 
DEFINE_WFL_FUNCTION(move_partial, 2, 2)
{
    const map_location src = args()[0]->evaluate(variables, add_debug_info(fdb, 0, "move_partial:src")).convert_to<location_callable>()->loc();
    const map_location dst = args()[1]->evaluate(variables, add_debug_info(fdb, 1, "move_partial:dst")).convert_to<location_callable>()->loc();
    LOG_AI << "move_partial(): " << src << ", " << dst << ")";
    return variant(std::make_shared<move_partial_callable>(src, dst));
}
 
DEFINE_WFL_FUNCTION(set_unit_var, 3, 3)
{
    return variant(std::make_shared<set_unit_var_callable>(args()[0]->evaluate(variables,add_debug_info(fdb,0,"set_unit_var:key")).as_string(), args()[1]->evaluate(variables,add_debug_info(fdb,1,"set_unit_var:value")), args()[2]->evaluate(variables,add_debug_info(fdb,2,"set_unit_var:unit_location")).convert_to<location_callable>()->loc()));
}
 
DEFINE_WFL_FUNCTION(fallback, 0, 1)
{
    UNUSED(fdb);
    // The parameter is not used, but is accepted for legacy compatibility
    if(args().size() == 1 && args()[0]->evaluate(variables).as_string() != "human")
        return variant();
    return variant(std::make_shared<fallback_callable>());
}
 
DEFINE_WFL_FUNCTION(attack, 3, 4)
{
    const map_location move_from = args()[0]->evaluate(variables, add_debug_info(fdb, 0, "attack:move_from")).convert_to<location_callable>()->loc();
    const map_location src = args()[1]->evaluate(variables, add_debug_info(fdb, 1, "attack:src")).convert_to<location_callable>()->loc();
    const map_location dst = args()[2]->evaluate(variables, add_debug_info(fdb, 2, "attack:dst")).convert_to<location_callable>()->loc();
    const int weapon = args().size() == 4 ? args()[3]->evaluate(variables,add_debug_info(fdb,3,"attack:weapon")).as_int() : -1;
    if(resources::gameboard->units().count(move_from) == 0 || resources::gameboard->units().count(dst) == 0) {
        ERR_AI << "AI ERROR: Formula produced illegal attack: " << move_from << " -> " << src << " -> " << dst;
        return variant();
    }
    return variant(std::make_shared<attack_callable>(move_from, src, dst, weapon));
}
 
DEFINE_FAI_FUNCTION(debug_label, 2, 2)
{
    const args_list& arguments = args();
    const variant var0 = arguments[0]->evaluate(variables,fdb);
    const variant var1 = arguments[1]->evaluate(variables,fdb);
 
    const map_location location = var0.convert_to<location_callable>()->loc();
    std::string text;
    if( var1.is_string() )
        text = var1.as_string();
    else
        text = var1.to_debug_string();
 
    display* gui = display::get_singleton();
    std::string team_name;
 
    color_t color = team::get_side_color(ai_.get_side());
 
    const terrain_label *res;
    res = gui->labels().set_label(location, text, ai_.get_side() - 1, team_name, color);
    if (res && resources::recorder)
        resources::recorder->add_label(res);
 
    std::vector<variant> result;
    result.push_back(var0);
    result.push_back(var1);
    return variant(result);
}
 
DEFINE_WFL_FUNCTION(is_village, 2, 3)
{
    const gamemap& m = args()[0]->evaluate(variables, add_debug_info(fdb, 0, "is_village:map")).convert_to<gamemap_callable>()->get_gamemap();
 
    map_location loc;
    if(args().size() == 2) {
        loc = args()[1]->evaluate(variables, add_debug_info(fdb, 1, "is_village:location")).convert_to<location_callable>()->loc();
    } else {
        loc = map_location( args()[1]->evaluate(variables,add_debug_info(fdb,1,"is_village:x")).as_int(),
                    args()[2]->evaluate(variables,add_debug_info(fdb,2,"is_village:y")).as_int(), wml_loc());
    }
    return variant(m.is_village(loc));
}
 
DEFINE_FAI_FUNCTION(is_unowned_village, 2, 3)
{
 
    const gamemap& m = args()[0]->evaluate(variables, add_debug_info(fdb, 0, "is_unowned_village:map")).convert_to<gamemap_callable>()->get_gamemap();
    const std::set<map_location>& my_villages = ai_.current_team().villages();
 
    map_location loc;
    if(args().size() == 2) {
        loc = args()[1]->evaluate(variables, add_debug_info(fdb, 1, "is_unowned_village:location")).convert_to<location_callable>()->loc();
    } else {
        loc = map_location( args()[1]->evaluate(variables,add_debug_info(fdb,1,"is_unowned_village:x")).as_int(),
                    args()[2]->evaluate(variables,add_debug_info(fdb,2,"is_unowned_village:y")).as_int(), wml_loc());
    }
 
    if(m.is_village(loc) && (my_villages.count(loc)==0) ) {
        return variant(true);
    } else {
        return variant(false);
    }
}
 
DEFINE_FAI_FUNCTION(unit_moves, 1, 1)
{
    variant res = args()[0]->evaluate(variables,add_debug_info(fdb,0,"unit_moves:unit_location"));
    std::vector<variant> vars;
    if(res.is_null()) {
        return variant(vars);
    }
 
    const map_location& loc = res.convert_to<location_callable>()->loc();
    const ai::move_map& srcdst = ai_.get_srcdst();
    typedef ai::move_map::const_iterator Itor;
    std::pair<Itor,Itor> range = srcdst.equal_range(loc);
 
    for(Itor i = range.first; i != range.second; ++i) {
        vars.emplace_back(std::make_shared<location_callable>(i->second));
    }
 
    return variant(vars);
}
 
DEFINE_WFL_FUNCTION(units_can_reach, 2, 2)
{
    std::vector<variant> vars;
    variant dstsrc_var = args()[0]->evaluate(variables,add_debug_info(fdb,0,"units_can_reach:possible_move_list"));
    const ai::move_map& dstsrc = dstsrc_var.convert_to<move_map_callable>()->dstsrc();
    std::pair<ai::move_map::const_iterator,ai::move_map::const_iterator> range =
        dstsrc.equal_range(args()[1]->evaluate(variables, add_debug_info(fdb, 1, "units_can_reach:possible_move_list")).convert_to<location_callable>()->loc());
    while(range.first != range.second) {
        unit_map::const_iterator un = resources::gameboard->units().find(range.first->second);
        assert(un != resources::gameboard->units().end());
        vars.emplace_back(std::make_shared<unit_callable>(*un));
        ++range.first;
    }
 
    return variant(vars);
}
 
DEFINE_FAI_FUNCTION(is_avoided_location, 1, 1)
{
    variant res = args()[0]->evaluate(variables,add_debug_info(fdb,0,"is_avoided_location:location"));
    if(res.is_null()) {
        return variant();
    }
    const map_location& loc = res.convert_to<location_callable>()->loc();
    return variant(ai_.get_avoid().match(loc));
}
 
DEFINE_WFL_FUNCTION(max_possible_damage, 2, 2)
{
    variant u1 = args()[0]->evaluate(variables,add_debug_info(fdb,0,"max_possible_damage:unit1"));
    variant u2 = args()[1]->evaluate(variables,add_debug_info(fdb,1,"max_possible_damage:unit2"));
    if(u1.is_null() || u2.is_null()) {
        return variant();
    }
 
    unit_adapter u_attacker(u1), u_defender(u2);
    int best = 0;
    for(const attack_type& atk : u_attacker.attacks()) {
        const int dmg = round_damage(atk.damage(), u_defender.damage_from(atk), 100) * atk.num_attacks();
        if(dmg > best)
            best = dmg;
    }
    return variant(best);
}
 
namespace {
    std::pair<int, int> best_melee_and_ranged_attacks(unit_adapter attacker, unit_adapter defender) {
        int highest_melee_damage = 0;
        int highest_ranged_damage = 0;
 
        for (const attack_type &attack : attacker.attacks()) {
            const int dmg = round_damage(attack.damage(), defender.damage_from(attack), 100) * attack.num_attacks();
            if (attack.range() == "melee") {
                highest_melee_damage = std::max(highest_melee_damage, dmg);
            } else {
                highest_ranged_damage = std::max(highest_ranged_damage, dmg);
            }
        }
 
        return std::pair(highest_melee_damage, highest_ranged_damage);
    }
}
 
DEFINE_WFL_FUNCTION(max_possible_damage_with_retaliation, 2, 2)
{
    variant u1 = args()[0]->evaluate(variables,add_debug_info(fdb,0,"max_possible_damage_with_retaliation:unit1"));
    variant u2 = args()[1]->evaluate(variables,add_debug_info(fdb,1,"max_possible_damage_with_retaliation:unit2"));
 
    if(u1.is_null() || u2.is_null()) {
        return variant();
    }
 
    unit_adapter attacker(u1);
    unit_adapter defender(u2);
 
    // find max damage inflicted by attacker and by defender to the attacker
    std::pair<int, int> best_attacker_attacks = best_melee_and_ranged_attacks(attacker, defender);
    std::pair<int, int> best_defender_attacks = best_melee_and_ranged_attacks(defender, attacker);
 
    std::vector<variant> vars;
    vars.emplace_back(best_attacker_attacks.first);
    vars.emplace_back(best_attacker_attacks.second);
    vars.emplace_back(best_defender_attacks.first);
    vars.emplace_back(best_defender_attacks.second);
 
    return variant(vars);
}
 
template<typename T>
class ai_formula_function : public formula_function {
protected:
    formula_ai& ai_;
public:
    ai_formula_function(const std::string& name, ai::formula_ai& ai) : formula_function(name), ai_(ai) {}
    function_expression_ptr generate_function_expression(const std::vector<expression_ptr>& args) const {
        return std::make_shared<T>(args, ai_);
    }
};
 
}
 
// This macro is for functions taking an additional formula_ai argument.
// Functions using the other macro could potentially be made core.
#define DECLARE_FAI_FUNCTION(name) \
    add_function(#name, std::make_shared<ai_formula_function<name##_function>>(#name, ai))
 
ai_function_symbol_table::ai_function_symbol_table(ai::formula_ai& ai)
    : function_symbol_table(std::make_shared<gamestate_function_symbol_table>(std::make_shared<action_function_symbol_table>()))
{
    function_symbol_table& functions_table = *this;
    DECLARE_WFL_FUNCTION(outcomes);
    //DECLARE_FAI_FUNCTION(evaluate_for_position);
    DECLARE_WFL_FUNCTION(move);
    DECLARE_WFL_FUNCTION(move_partial);
    DECLARE_WFL_FUNCTION(attack);
    DECLARE_FAI_FUNCTION(rate_action);
    DECLARE_WFL_FUNCTION(recall);
    DECLARE_WFL_FUNCTION(recruit);
    DECLARE_FAI_FUNCTION(is_avoided_location);
    DECLARE_WFL_FUNCTION(is_village);
    DECLARE_FAI_FUNCTION(is_unowned_village);
    DECLARE_FAI_FUNCTION(unit_moves);
    DECLARE_WFL_FUNCTION(set_unit_var);
    DECLARE_WFL_FUNCTION(fallback);
    DECLARE_WFL_FUNCTION(units_can_reach);
    DECLARE_FAI_FUNCTION(debug_label);
    DECLARE_WFL_FUNCTION(max_possible_damage);
    DECLARE_WFL_FUNCTION(max_possible_damage_with_retaliation);
    DECLARE_FAI_FUNCTION(next_hop);
    DECLARE_WFL_FUNCTION(castle_locs);
    DECLARE_WFL_FUNCTION(timeofday_modifier);
    DECLARE_FAI_FUNCTION(distance_to_nearest_unowned_village);
    DECLARE_FAI_FUNCTION(shortest_path);
    DECLARE_FAI_FUNCTION(simplest_path);
    DECLARE_FAI_FUNCTION(nearest_keep);
    DECLARE_FAI_FUNCTION(suitable_keep);
    DECLARE_WFL_FUNCTION(nearest_loc);
    DECLARE_FAI_FUNCTION(find_shroud);
    DECLARE_FAI_FUNCTION(close_enemies);
    DECLARE_WFL_FUNCTION(calculate_outcome);
    DECLARE_FAI_FUNCTION(run_file);
    DECLARE_FAI_FUNCTION(calculate_map_ownership);
}
#undef DECLARE_WFL_FUNCTION
 
}