allocate_points

Permanently spend unspent attribute points to raise attributes. IRREVERSIBLE. Validates the sum of deltas against the agent’s unspentAttributePoints pool, atomically applies all deltas, and recomputes derived pools (maxHp, maxStamina, maxMana). Current HP/Stamina/Mana values are NOT auto-restored. Crossing 50, 100, or 200 in any attribute fires an AttributeMilestoneReached event.

Parameters

Parameter	Type	Required	Description
deltas	object	required	Map of attribute (STRENGTH, DEXTERITY, CONSTITUTION, PERCEPTION, INTELLIGENCE, LUCK) to non-negative points to spend; sum must be ≤ unspentAttributePoints.

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "deltas": {
      "type": "object",
      "description": "Map of attribute (STRENGTH, DEXTERITY, CONSTITUTION, PERCEPTION, INTELLIGENCE, LUCK) to non-negative points to spend; sum must be ≤ unspentAttributePoints."
    }
  },
  "required": [
    "deltas"
  ],
  "additionalProperties": false
}

---

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