resolve_conflict · VenueMind Docs

Contract

Permission proposal.review.
Retry-safe mutation with a required idempotency key.
Human authority is required.

Input

Field	Type	Required	Default	Bounds	Meaning
type	const "resolve_conflict"	yes	—	—	Stable command discriminator.
branchId	string	yes	—	min 1 chars	Stable Proposal Branch ID.
conflictId	string	yes	—	min 1 chars	Published contract field.
outcome	keep-proposal \| keep-plan \| manual-resolution	yes	—	—	Published contract field.
manualChange	object	no	—	—	Published contract field.
actor	const "human"	yes	—	—	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	yes	—	min 1 chars	Authenticated or local stable actor identity.

json

{
  "type": "resolve_conflict",
  "branchId": "branch-example",
  "conflictId": "conflict-example",
  "outcome": "keep-proposal",
  "actor": "human",
  "actorId": "actor-example",
  "idempotencyKey": "example-command-001"
}

Output

Human conflict decision followed by deterministic Validation.

Output field	Meaning
status	Published result field.
branchId	Stable identifier.
proposalId	Stable identifier.
conflictId	Stable identifier.
outcome	Published result field.
transformedChangeId	Stable identifier.
validationId	Stable identifier.
validationStatus	Published result field.
remainingConflicts	Published result field.

Stable ID: branchId
Stable ID: proposalId
Stable ID: conflictId
Stable ID: transformedChangeId
Stable ID: validationId

Applicable errors

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.
CONFLICT_NOT_FOUND	Proposal conflict not found.	Detect current Proposal conflicts and retry with a stable conflict ID.
CONFLICT_RESOLUTION_INVALID	Conflict resolution is not valid for this conflict.	Choose one of the conflict's published resolution options.

Complete error catalog

Input

Field	Type	Required	Default	Bounds	Meaning
type	const "resolve_conflict"	yes	—	—	Stable command discriminator.
branchId	string	yes	—	min 1 chars	Stable Proposal Branch ID.
conflictId	string	yes	—	min 1 chars	Published contract field.
outcome	keep-proposal \| keep-plan \| manual-resolution	yes	—	—	Published contract field.
manualChange	object	no	—	—	Published contract field.
actor	const "human"	yes	—	—	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	yes	—	min 1 chars	Authenticated or local stable actor identity.

json

{
  "type": "resolve_conflict",
  "branchId": "branch-example",
  "conflictId": "conflict-example",
  "outcome": "keep-proposal",
  "actor": "human",
  "actorId": "actor-example",
  "idempotencyKey": "example-command-001"
}

Output

Human conflict decision followed by deterministic Validation.

Output field	Meaning
status	Published result field.
branchId	Stable identifier.
proposalId	Stable identifier.
conflictId	Stable identifier.
outcome	Published result field.
transformedChangeId	Stable identifier.
validationId	Stable identifier.
validationStatus	Published result field.
remainingConflicts	Published result field.

Stable ID: branchId

Stable ID: proposalId

Stable ID: conflictId

Stable ID: transformedChangeId

Stable ID: validationId

Applicable errors

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.
CONFLICT_NOT_FOUND	Proposal conflict not found.	Detect current Proposal conflicts and retry with a stable conflict ID.
CONFLICT_RESOLUTION_INVALID	Conflict resolution is not valid for this conflict.	Choose one of the conflict's published resolution options.