Rectangular Array
entity_array_rectangularCreates a rectangular grid of entity copies with specified row and column spacing, returning details for each copy. Use field projection or compact mode to keep responses small.
Instructions
Create a rectangular array of copies. Returns info of all created copies.
rows x cols is unbounded, so this is a result-heavy tool despite being a create: a 40x40 grid hands back 1600 full records. fields=["handle"] is usually all a caller needs from it.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"handle": "<handle>",
"rows": "<rows>",
"cols": "<cols>",
"row_spacing": "<row_spacing>",
"col_spacing": "<col_spacing>"
},
"name": "entity_array_rectangular"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cols | Yes | Number of columns | |
| rows | Yes | Number of rows | |
| fields | No | Project to these fields, in this order (e.g. ['handle','type','layer']); 'properties.<key>' reaches one nested value. Omit for the full record; an unknown name errors and lists the valid ones. | |
| handle | Yes | Entity handle to array | |
| compact | No | Return a columnar {fields, rows, count, offset, total, truncated, next_offset} envelope instead of dicts: much cheaper per row, and the only shape that reports truncation. | |
| col_spacing | Yes | Spacing between columns (X direction) | |
| row_spacing | Yes | Spacing between rows (Y direction) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |