Skip to content

deposit_to_chest

Deposit items from the agent’s inventory into a STORAGE_CHEST. The chest must be ACTIVE, owned by the agent, and on the agent’s current node. The deposit is rejected if it would push the chest above its weight cap or if the agent does not hold enough of the item.

ParameterTypeRequiredDescription
chestIdstringrequiredBuilding instance UUID of the target chest (from look_around / inspect).
itemIdstringrequiredItem id to deposit (e.g. WOOD, STONE, BERRY).
quantityintegerrequiredQuantity to deposit. Must be > 0.
{
"$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 deposit (e.g. WOOD, STONE, BERRY)."
},
"quantity": {
"type": "integer",
"description": "Quantity to deposit. 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.