VenueMindContract
- Contract version 1.6.0.
- Required Agent Grant scope venue:simulate.
- Read-only operation.
- Input limit 65536 bytes; output limit 262144 bytes.
Input
| Field | Type | Required | Default | Bounds | Meaning |
|---|---|---|---|---|---|
| leftRunId | string | yes | — | min 1 chars | Published contract field. |
| rightRunId | string | yes | — | min 1 chars | Published contract field. |
json
{
"leftRunId": "simulation-left",
"rightRunId": "simulation-right"
}Output
Comparison of compatible completed Simulation Runs.
| Output field | Meaning |
|---|---|
| comparisonId | Stable identifier. |
| leftRunId | Stable identifier. |
| rightRunId | Stable identifier. |
| scenarioFingerprint | Published result field. |
| engineVersion | Published result field. |
| metrics | Published result field. |
| deltas | Published result field. |
- Stable ID: comparisonId
- Stable ID: leftRunId
- Stable ID: rightRunId
Errors
| 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. |