consume

Consume one unit of a held item to refill the linked survival gauge. Queues a ConsumeItem command; the ItemConsumed event arrives on the event stream once the tick lands. Rejected if the agent doesn’t own the item or the item isn’t consumable.

Parameters

Parameter	Type	Required	Description
itemId	string	required	Item id to consume from inventory (e.g. BERRY, HERB).

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "itemId": {
      "type": "string",
      "description": "Item id to consume from inventory (e.g. BERRY, HERB)."
    }
  },
  "required": [
    "itemId"
  ],
  "additionalProperties": false
}

---

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