run_scenario · VenueMind Docs

Input

Field	Type	Required	Default	Bounds	Meaning
type	const "run_scenario"	yes	—	—	Stable command discriminator.
scenario	object	yes	—	—	Published contract field.
branchId	string	no	—	min 1 chars	Stable Proposal Branch ID.
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": "run_scenario",
  "scenario": {
    "id": "example-id",
    "seed": 1,
    "horizonSeconds": 1,
    "inputs": {
      "population": 1,
      "arrivalRatePerMinute": 1,
      "serviceRatePerMinute": 1,
      "servers": 1
    }
  },
  "idempotencyKey": "example-command-001"
}

Output

A deterministic-seed Simulation Run; it never becomes Constraint Validation.

Output field	Meaning
status	Published result field.
runId	Stable identifier.
scenarioId	Stable identifier.
branchId	Stable identifier.
inputFingerprint	Published result field.
cacheHit	Published result field.
result	Published result field.
receipt	Published result field.

Stable ID: runId

Stable ID: scenarioId

Stable ID: branchId

Stable ID: receipt.id

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.
SCENARIO_RUN_NOT_FOUND	Scenario Run not found.	List Scenario Runs and retry with an existing stable Run ID.

DOCS

Contract

Permission simulation.run.
Retry-safe mutation with a required idempotency key.
Authority is evaluated at the service boundary.

Input

Field	Type	Required	Default	Bounds	Meaning
type	const "run_scenario"	yes	—	—	Stable command discriminator.
scenario	object	yes	—	—	Published contract field.
branchId	string	no	—	min 1 chars	Stable Proposal Branch ID.
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": "run_scenario",
  "scenario": {
    "id": "example-id",
    "seed": 1,
    "horizonSeconds": 1,
    "inputs": {
      "population": 1,
      "arrivalRatePerMinute": 1,
      "serviceRatePerMinute": 1,
      "servers": 1
    }
  },
  "idempotencyKey": "example-command-001"
}

Output

A deterministic-seed Simulation Run; it never becomes Constraint Validation.

Output field	Meaning
status	Published result field.
runId	Stable identifier.
scenarioId	Stable identifier.
branchId	Stable identifier.
inputFingerprint	Published result field.
cacheHit	Published result field.
result	Published result field.
receipt	Published result field.

Stable ID: runId
Stable ID: scenarioId
Stable ID: branchId
Stable ID: receipt.id

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.
SCENARIO_RUN_NOT_FOUND	Scenario Run not found.	List Scenario Runs and retry with an existing stable Run ID.

Complete error catalog