withdraw_from_chest

Withdraw items from a STORAGE_CHEST back into the agent’s inventory. The chest must be ACTIVE, owned by the agent, and on the agent’s current node. Rejected if the chest holds fewer than the requested quantity of the item.

Parameters

Parameter	Type	Required	Description
chestId	string	required	Building instance UUID of the target chest (from look_around / inspect).
itemId	string	required	Item id to withdraw (e.g. WOOD, STONE, BERRY).
quantity	integer	required	Quantity to withdraw. Must be > 0.

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "chestId": {
      "type": "string",
      "description": "Building instance UUID of the target chest (from look_around / inspect)."
    },
    "itemId": {
      "type": "string",
      "description": "Item id to withdraw (e.g. WOOD, STONE, BERRY)."
    },
    "quantity": {
      "type": "integer",
      "description": "Quantity to withdraw. Must be > 0."
    }
  },
  "required": [
    "chestId",
    "itemId",
    "quantity"
  ],
  "additionalProperties": false
}

---

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