venue.run_scenario · VenueMind Docs

Input

Field	Type	Required	Default	Bounds	Meaning
scenario	object	yes	—	—	Published contract field.
branchId	string	no	—	min 1 chars	Stable Proposal Branch ID.
idempotencyKey	string	yes	—	min 1 chars	Unique retry key for this semantic command.
correlationId	string	no	—	min 1 chars	Optional caller correlation identifier.

json

{
  "scenario": {
    "id": "scenario-example",
    "name": "Arrival peak",
    "seed": 42,
    "horizonSeconds": 1800,
    "sampleCount": 32,
    "inputs": {
      "population": 400,
      "arrivalRatePerMinute": 30,
      "serviceRatePerMinute": 10,
      "servers": 3
    }
  },
  "branchId": "branch-balanced",
  "idempotencyKey": "example-scenario-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

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.

DOCS

Contract

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

Input

Field	Type	Required	Default	Bounds	Meaning
scenario	object	yes	—	—	Published contract field.
branchId	string	no	—	min 1 chars	Stable Proposal Branch ID.
idempotencyKey	string	yes	—	min 1 chars	Unique retry key for this semantic command.
correlationId	string	no	—	min 1 chars	Optional caller correlation identifier.

json

{
  "scenario": {
    "id": "scenario-example",
    "name": "Arrival peak",
    "seed": 42,
    "horizonSeconds": 1800,
    "sampleCount": 32,
    "inputs": {
      "population": 400,
      "arrivalRatePerMinute": 30,
      "serviceRatePerMinute": 10,
      "servers": 3
    }
  },
  "branchId": "branch-balanced",
  "idempotencyKey": "example-scenario-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

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.

Surfaces

WebMCP runtime Standalone MCP Complete error catalog