Tool referencevenue.inspect_layout
Read the active venue plan, stable object IDs, locked objects, constraints, metrics, proposal state, and branch summaries.
Contract 1.6.0Scope venue:read
developers · agent integratorsReviewed for VenueMind 1.0.0
- Contract version 1.6.0.
- Required Agent Grant scope venue:read.
- Read-only operation.
- Input limit 65536 bytes; output limit 1048576 bytes.
The bounded accepted Plan and visible Proposal inspection used to start every planning workflow.
| Output field | Meaning |
|---|
| planId | Stable identifier. |
| planVersion | Published result field. |
| event | Published result field. |
| venue | Published result field. |
| templateBindings | Published result field. |
| inventoryAvailability | Published result field. |
| occupancy | Published result field. |
| staffing | Published result field. |
| productionPolicy | Published result field. |
| cateringPolicy | Published result field. |
| emergencyPlan | Published result field. |
| emergencyReviews | Published result field. |
| spatial | Published result field. |
| spatialObjects[] | Published result field. |
| lockedObjects[] | Published result field. |
| projectLocks[] | Published result field. |
| comments[] | Published result field. |
| scenarios[] | Published result field. |
| scenarioRuns[] | Published result field. |
| constraints[] | Published result field. |
| metrics | Published result field. |
| proposal | Published result field. |
| activeBranchId | Stable identifier. |
| proposalBranches[] | Published result field. |
| commandReceiptCount | Published result field. |
| ledgerIntegrity | Published result field. |
| brief | Published result field. |
- Stable ID: planId
- Stable ID: spatialObjects[].id
- Stable ID: constraints[].id
- Stable ID: proposal.id
- Stable ID: proposal.changes[].id
- Stable ID: activeBranchId
- Stable ID: proposalBranches[].id
| Code | Message | Remediation |
|---|
| TOOL_SCOPE_REQUIRED | Tool authorization scope is required. | Grant the published scope for this tool or use a read-only tool within the current session. |
| AUTHORIZATION_DENIED | The current principal is not authorized for this VenueMind action. | Use an assigned Organization Membership Role or an active Organization- and Project-scoped Agent Grant containing the required permission. |
| AGENT_GRANT_INVALID | Agent Grant is invalid. | Issue a complete Organization- and Project-scoped grant with published scopes and a lifetime of one hour or less. |
| TOOL_PAYLOAD_TOO_LARGE | Tool payload exceeds its published size limit. | Reduce the requested geometry or export payload and retry within the published byte limit. |
| TOOL_CALL_CANCELLED | Tool call was cancelled. | Retry only if the caller still needs the operation, using the same idempotency key for an interrupted mutation. |
| VENUE_INTERNAL_ERROR | VenueMind could not complete the operation. | Retry once; if the error persists, inspect the server log with the correlation ID. |