Tool referencevenue.get_scenario_result
Read one stable Scenario Run and its completed or partial result, with density frames omitted unless explicitly requested.
Contract 1.6.0Scope venue:simulate
developers · agent integratorsReviewed for VenueMind 1.0.0
- Contract version 1.6.0.
- Required Agent Grant scope venue:simulate.
- Read-only operation.
- Input limit 65536 bytes; output limit 1048576 bytes.
One Simulation Result bound to exact Scenario and geometry fingerprints.
| Output field | Meaning |
|---|
| schemaVersion | Published result field. |
| kind | Published result field. |
| model | Published result field. |
| engineVersion | Published result field. |
| inputFingerprint | Published result field. |
| scenarioFingerprint | Published result field. |
| scenarioId | Stable identifier. |
| branchId | Stable identifier. |
| planVersion | Published result field. |
| proposalId | Stable identifier. |
| status | Published result field. |
| parameters | Published result field. |
| progress | Published result field. |
| partial | Published result field. |
| result | Published result field. |
| confidence | Published result field. |
| startedAt | Published result field. |
| completedAt | Published result field. |
- Stable ID: scenarioId
- Stable ID: branchId
- Stable ID: proposalId
- Stable ID: result.runId
| 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. |
| SCENARIO_RUN_NOT_FOUND | Scenario Run not found. | List Scenario Runs and retry with an existing stable Run ID. |