Tool referencevenue.replay_history
Verify the Activity Ledger hash chain and replay accepted Plan transitions against the current Plan fingerprint.
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 262144 bytes.
Replay verification from accepted transitions to current Plan and Event Brief truth.
| Output field | Meaning |
|---|
| status | Published result field. |
| transitions[] | Published result field. |
| briefTransitions[] | Published result field. |
| currentPlanVersion | Published result field. |
| replayedFingerprint | Published result field. |
| currentFingerprint | Published result field. |
| replayedBriefFingerprint | Published result field. |
| currentBriefFingerprint | Published result field. |
| ledgerHeadHash | Published result field. |
| lockedObjectViolations[] | Published result field. |
| truthFingerprintViolations[] | Published result field. |
- Stable ID: transitions[].ledgerEntryId
- Stable ID: transitions[].planVersion
- Stable ID: briefTransitions[].ledgerEntryId
- Stable ID: lockedObjectViolations[].objectId
- Stable ID: truthFingerprintViolations[].ledgerEntryId
| 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. |