preview_revision · VenueMind Docs

Field	Type	Required	Default	Bounds	Meaning
type	const "preview_revision"	yes	—	—	Stable command discriminator.
goal	string	yes	—	min 1 chars	Measurable Proposal outcome.
actor	human \| agent \| system	no	—	—	Claimed action source; policy verifies it against the principal.
idempotencyKey	string	yes	—	min 1 chars	Unique retry key for this semantic command.
correlationId	string	no	—	min 1 chars	Optional caller correlation identifier.
source	studio \| webmcp \| mcp \| system \| agent-tool	no	—	—	Surface that submitted the command.
sessionId	string	no	—	min 1 chars	Calling session identity.
actorId	string	no	—	min 1 chars	Authenticated or local stable actor identity.

json

{
  "type": "preview_revision",
  "goal": "Improve access while preserving capacity",
  "idempotencyKey": "example-command-001"
}

A non-destructive Proposal revision; accepted Plan truth is unchanged.

Stable ID: proposalId

Stable ID: receipt.id

Stable ID: receipt.resultIds.changeId

Code	Message	Remediation
COMMAND_INVALID	Venue command requires a type.	Send one published Venue command with its required fields.
COMMAND_UNSUPPORTED	Venue command is not supported.	Refresh the command contract and use a published command type.
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.
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.

DOCS

Contract

Field	Type	Required	Default	Bounds	Meaning
type	const "preview_revision"	yes	—	—	Stable command discriminator.
goal	string	yes	—	min 1 chars	Measurable Proposal outcome.
actor	human \| agent \| system	no	—	—	Claimed action source; policy verifies it against the principal.
idempotencyKey	string	yes	—	min 1 chars	Unique retry key for this semantic command.
correlationId	string	no	—	min 1 chars	Optional caller correlation identifier.
source	studio \| webmcp \| mcp \| system \| agent-tool	no	—	—	Surface that submitted the command.
sessionId	string	no	—	min 1 chars	Calling session identity.
actorId	string	no	—	min 1 chars	Authenticated or local stable actor identity.

json

{
  "type": "preview_revision",
  "goal": "Improve access while preserving capacity",
  "idempotencyKey": "example-command-001"
}

A non-destructive Proposal revision; accepted Plan truth is unchanged.

Code	Message	Remediation
COMMAND_INVALID	Venue command requires a type.	Send one published Venue command with its required fields.
COMMAND_UNSUPPORTED	Venue command is not supported.	Refresh the command contract and use a published command type.
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.
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.