venue.create_post_event_deviation_proposal

Contract

Contract version 1.6.0.
Required Agent Grant scope venue:propose.
State-affecting operation.
Input limit 65536 bytes; output limit 262144 bytes.

Input

Field	Type	Required	Default	Bounds	Meaning
proposalId	string	yes	—	min 1 chars; max 160 chars	Stable Proposal ID.
goal	string	yes	—	min 1 chars; max 2000 chars	Measurable Proposal outcome.
deviationIds	string[]	yes	—	min 1 items; max 100 items; unique items	Published contract field.
idempotencyKey	string	yes	—	min 1 chars	Unique retry key for this semantic command.
correlationId	string	no	—	min 1 chars	Optional caller correlation identifier.

json

{
  "proposalId": "proposal-post-event-egress",
  "goal": "Retain the validated event-day egress control",
  "deviationIds": [
    "deviation-east-exit-control"
  ],
  "idempotencyKey": "example-deviation-proposal-001"
}

Output

A standard reviewable Venue Proposal derived from ended revision candidates; accepted Plan truth stays unchanged.

Output field	Meaning
register	Published result field.
proposal	Published result field.
recommendation	Published result field.
receipt	Published result field.
duplicate	Published result field.

Stable ID: register.id
Stable ID: proposal.id
Stable ID: recommendation.id
Stable ID: receipt.id

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.
IDEMPOTENCY_KEY_REQUIRED	Idempotency key is required for mutating commands.	Retry with one stable idempotency key for this semantic action.
IDEMPOTENCY_KEY_CONFLICT	Idempotency key conflict.	Use the original command input or generate a new idempotency key.
DEVIATION_REGISTER_NOT_FOUND	Live Plan Deviation Register is unavailable.	Create the register from the active Event Day Runbook before inspecting or recording deviations.
DEVIATION_NOT_FOUND	Live Plan Deviation is unavailable.	Inspect the register and retry with an existing stable Deviation ID.
DEVIATION_TOOL_UNAVAILABLE	Live Plan Deviation tool Adapter is unavailable.	Open VenueMind Studio or connect an MCP Project session with Live Plan Deviation operations enabled.
DEVIATION_INVALID	Live Plan Deviation input is invalid.	Supply a reason code, disposition, exact affected objects, location, and executable spatial Change.
DEVIATION_LOCATION_INVALID	Live Plan Deviation Location Context is invalid.	Anchor the deviation to one object or in-room coordinate in the frozen accepted Plan.
DEVIATION_REVISION_CONFLICT	Live Plan Deviation revision conflict.	Refresh the deviation projection and retry only if the transition is still required.
DEVIATION_REGISTER_REVISION_CONFLICT	Live Plan Deviation Register revision conflict.	Refresh the active overlay and retry against its current revision.
DEVIATION_LEDGER_INTEGRITY_FAILED	Live Plan Deviation ledger integrity failed.	Restore the last verified register state before inspection, recommendation, or export.
POST_EVENT_REVIEW_NOT_FOUND	Post-event Review is unavailable.	Create or restore the Runbook-bound Post-event Review before issuing this command.
POST_EVENT_TOOL_UNAVAILABLE	Post-event Review tooling is unavailable.	Connect a Post-event Review operation adapter before calling this tool.
POST_EVENT_INVALID	Post-event Review input is invalid.	Supply published metric, scope, evidence, lesson, and Proposal fields with stable identifiers.
POST_EVENT_REVISION_CONFLICT	Post-event Review revision conflict.	Refresh the Post-event Review and retry only if the transition is still required.
POST_EVENT_EVIDENCE_INVALID	Post-event evidence does not match the frozen baseline.	Reference an exact evidence ID and fingerprint frozen into this Post-event Review.
POST_EVENT_OBSERVATION_CONFLICT	An Observation already exists for this predicted outcome.	Use the accepted Observation or create a distinct metric scope before recording another outcome.
POST_EVENT_COMPARISON_NOT_FOUND	Post-event Comparison is unavailable.	Inspect the frozen Predictions and retry with an existing comparison key.
POST_EVENT_LESSON_NOT_FOUND	Post-event Lesson is unavailable.	Inspect the Post-event Review and retry with an existing stable Lesson ID.
POST_EVENT_TEMPLATE_PROPOSAL_NOT_FOUND	Template Improvement Proposal is unavailable.	Inspect the Post-event Review and retry with an existing stable Proposal ID.
POST_EVENT_TEMPLATE_PROPOSAL_INVALID	Template Improvement Proposal is invalid.	Trace every Change through a structured Lesson to an observed event-day outcome and a frozen template binding.
POST_EVENT_LEDGER_INTEGRITY_FAILED	Post-event Review ledger integrity failed.	Restore the last verified Post-event Review before inspection or export.

Surfaces

WebMCP runtime Standalone MCP Complete error catalog

Input

Field	Type	Required	Default	Bounds	Meaning
proposalId	string	yes	—	min 1 chars; max 160 chars	Stable Proposal ID.
goal	string	yes	—	min 1 chars; max 2000 chars	Measurable Proposal outcome.
deviationIds	string[]	yes	—	min 1 items; max 100 items; unique items	Published contract field.
idempotencyKey	string	yes	—	min 1 chars	Unique retry key for this semantic command.
correlationId	string	no	—	min 1 chars	Optional caller correlation identifier.

json

{
  "proposalId": "proposal-post-event-egress",
  "goal": "Retain the validated event-day egress control",
  "deviationIds": [
    "deviation-east-exit-control"
  ],
  "idempotencyKey": "example-deviation-proposal-001"
}

Output

A standard reviewable Venue Proposal derived from ended revision candidates; accepted Plan truth stays unchanged.

Output field	Meaning
register	Published result field.
proposal	Published result field.
recommendation	Published result field.
receipt	Published result field.
duplicate	Published result field.

Stable ID: register.id

Stable ID: proposal.id

Stable ID: recommendation.id

Stable ID: receipt.id

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.
IDEMPOTENCY_KEY_REQUIRED	Idempotency key is required for mutating commands.	Retry with one stable idempotency key for this semantic action.
IDEMPOTENCY_KEY_CONFLICT	Idempotency key conflict.	Use the original command input or generate a new idempotency key.
DEVIATION_REGISTER_NOT_FOUND	Live Plan Deviation Register is unavailable.	Create the register from the active Event Day Runbook before inspecting or recording deviations.
DEVIATION_NOT_FOUND	Live Plan Deviation is unavailable.	Inspect the register and retry with an existing stable Deviation ID.
DEVIATION_TOOL_UNAVAILABLE	Live Plan Deviation tool Adapter is unavailable.	Open VenueMind Studio or connect an MCP Project session with Live Plan Deviation operations enabled.
DEVIATION_INVALID	Live Plan Deviation input is invalid.	Supply a reason code, disposition, exact affected objects, location, and executable spatial Change.
DEVIATION_LOCATION_INVALID	Live Plan Deviation Location Context is invalid.	Anchor the deviation to one object or in-room coordinate in the frozen accepted Plan.
DEVIATION_REVISION_CONFLICT	Live Plan Deviation revision conflict.	Refresh the deviation projection and retry only if the transition is still required.
DEVIATION_REGISTER_REVISION_CONFLICT	Live Plan Deviation Register revision conflict.	Refresh the active overlay and retry against its current revision.
DEVIATION_LEDGER_INTEGRITY_FAILED	Live Plan Deviation ledger integrity failed.	Restore the last verified register state before inspection, recommendation, or export.
POST_EVENT_REVIEW_NOT_FOUND	Post-event Review is unavailable.	Create or restore the Runbook-bound Post-event Review before issuing this command.
POST_EVENT_TOOL_UNAVAILABLE	Post-event Review tooling is unavailable.	Connect a Post-event Review operation adapter before calling this tool.
POST_EVENT_INVALID	Post-event Review input is invalid.	Supply published metric, scope, evidence, lesson, and Proposal fields with stable identifiers.
POST_EVENT_REVISION_CONFLICT	Post-event Review revision conflict.	Refresh the Post-event Review and retry only if the transition is still required.
POST_EVENT_EVIDENCE_INVALID	Post-event evidence does not match the frozen baseline.	Reference an exact evidence ID and fingerprint frozen into this Post-event Review.
POST_EVENT_OBSERVATION_CONFLICT	An Observation already exists for this predicted outcome.	Use the accepted Observation or create a distinct metric scope before recording another outcome.
POST_EVENT_COMPARISON_NOT_FOUND	Post-event Comparison is unavailable.	Inspect the frozen Predictions and retry with an existing comparison key.
POST_EVENT_LESSON_NOT_FOUND	Post-event Lesson is unavailable.	Inspect the Post-event Review and retry with an existing stable Lesson ID.
POST_EVENT_TEMPLATE_PROPOSAL_NOT_FOUND	Template Improvement Proposal is unavailable.	Inspect the Post-event Review and retry with an existing stable Proposal ID.
POST_EVENT_TEMPLATE_PROPOSAL_INVALID	Template Improvement Proposal is invalid.	Trace every Change through a structured Lesson to an observed event-day outcome and a frozen template binding.
POST_EVENT_LEDGER_INTEGRITY_FAILED	Post-event Review ledger integrity failed.	Restore the last verified Post-event Review before inspection or export.