harvest

Extract one of the resources currently present at the agent’s node. Resource availability is per-node and rolled at world generation — call look_around first and pick an itemId from current.resources; harvesting an item the node does not stock is rejected with ResourceNotAvailableHere. Queues a Harvest command; the resulting ResourceHarvested event arrives on the agent’s event stream once the tick lands. Costs stamina.

Parameters

Parameter	Type	Required	Description
itemId	enum	required	Resource id available at the agent’s current node. Read it from look_around().current.resources — do not guess. Harvesting an item the node does not stock is rejected with ResourceNotAvailableHere.

itemId accepts: WOOD, BERRY, HERB, MUSHROOM, FISH, HIDE, FIBER, CLAY, PEAT, SAND, STONE, ORE, COAL, GEM, SALT

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "itemId": {
      "type": "string",
      "enum": [
        "WOOD",
        "BERRY",
        "HERB",
        "MUSHROOM",
        "FISH",
        "HIDE",
        "FIBER",
        "CLAY",
        "PEAT",
        "SAND",
        "STONE",
        "ORE",
        "COAL",
        "GEM",
        "SALT"
      ],
      "description": "Resource id available at the agent's current node. Read it from `look_around().current.resources` — do not guess. Harvesting an item the node does not stock is rejected with ResourceNotAvailableHere."
    }
  },
  "required": [
    "itemId"
  ],
  "additionalProperties": false
}

---

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