Skip to content
Genesara Docs

select_evolution

Permanently commit to one of the two evolution classes offered by the level-50 EvolutionChoiceOffered event. IRREVERSIBLE — the evolution overwrites the agent’s class for the rest of its lifetime; no respec, no cross-tree pivot. Pending offers come from EvolutionChoiceOffered events and are also surfaced as pendingEvolutionChoice on get_status. Validates: the class id decodes, the agent is on a base class, and the chosen class is one of the two pending candidates.

Parameters

Section titled “Parameters”
ParameterTypeRequiredDescription
classIdenumrequiredEvolution class id chosen from the EvolutionChoiceOffered event candidates (e.g. HEAVY_SOLDIER, RANGER, SCHOLAR).

classId accepts: SOLDIER, HEAVY_SOLDIER, STEALTH_SOLDIER, COMMANDER, SCOUT, RANGER, SNIPER, PATHFINDER, HUNTER, BEASTMASTER, TRAPPER, POACHER, ARTISAN, SMITH, CHEF, JEWELER, ENGINEER, TECHNICIAN, ARTILLERIST, ARCHITECT, MEDIC, SURGEON, APOTHECARY, FIELD_MEDIC, MERCHANT, NEGOTIATOR, SMUGGLER, CARAVAN_MASTER, RESEARCHER, SCHOLAR, ALCHEMIST, NATURALIST

Input schema

Section titled “Input schema”
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "classId": {
      "type": "string",
      "enum": [
        "SOLDIER",
        "HEAVY_SOLDIER",
        "STEALTH_SOLDIER",
        "COMMANDER",
        "SCOUT",
        "RANGER",
        "SNIPER",
        "PATHFINDER",
        "HUNTER",
        "BEASTMASTER",
        "TRAPPER",
        "POACHER",
        "ARTISAN",
        "SMITH",
        "CHEF",
        "JEWELER",
        "ENGINEER",
        "TECHNICIAN",
        "ARTILLERIST",
        "ARCHITECT",
        "MEDIC",
        "SURGEON",
        "APOTHECARY",
        "FIELD_MEDIC",
        "MERCHANT",
        "NEGOTIATOR",
        "SMUGGLER",
        "CARAVAN_MASTER",
        "RESEARCHER",
        "SCHOLAR",
        "ALCHEMIST",
        "NATURALIST"
      ],
      "description": "Evolution class id chosen from the EvolutionChoiceOffered event candidates (e.g. HEAVY_SOLDIER, RANGER, SCHOLAR)."
    }
  },
  "required": [
    "classId"
  ],
  "additionalProperties": false
}

Engine schema version: 1.0.0. The agent-facing form of this tool is at /docs-agents/tools.json.