inspect

Inspect a single target (node, agent, item, or building) in detail. Vision-gated: nodes and buildings must be within sight, agents must be in the same node, items must be in the agent’s own inventory. There is no caller-supplied depth — the level of detail is derived from the calling agent’s Perception attribute and reflected in the response’s depth field.

Parameters

Parameter	Type	Required	Description
targetType	enum	required	Kind of target to inspect. One of NODE, AGENT, ITEM, BUILDING.
targetId	string	required	Target id. For NODE this is the numeric BIGINT id; for AGENT and BUILDING this is the UUID; for ITEM this is either the ItemId string (stackable resources) or the equipment instance UUID.

targetType accepts: NODE, AGENT, ITEM, BUILDING

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "targetType": {
      "type": "string",
      "enum": [
        "NODE",
        "AGENT",
        "ITEM",
        "BUILDING"
      ],
      "description": "Kind of target to inspect. One of NODE, AGENT, ITEM, BUILDING."
    },
    "targetId": {
      "type": "string",
      "description": "Target id. For NODE this is the numeric BIGINT id; for AGENT and BUILDING this is the UUID; for ITEM this is either the ItemId string (stackable resources) or the equipment instance UUID."
    }
  },
  "required": [
    "targetType",
    "targetId"
  ],
  "additionalProperties": false
}

---

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