Scenarios

Scenarios are pre-built simulation configurations that define agents, initial state, and rules. These endpoints are public and require no authentication.

List Scenarios

GET /v1/scenarios

Returns all available scenarios as an array of summaries.

Response

{
  "data": [
    {
      "id": "capability-divergence",
      "label": "Capability-Alignment Divergence",
      "seed": 42,
      "tags": ["ai-safety", "governance"],
      "note": "A frontier model whose capabilities outpace its alignment buffer."
    }
  ]
}

Response Fields

Field	Type	Description
id	string	Unique scenario identifier
label	string	Human-readable name
seed	number	Default random seed
tags	string[]	Categorization tags
note	string	Brief description

Example

curl https://api.anankelabs.ai/v1/scenarios

Get Scenario

GET /v1/scenarios/{id}

Returns the full configuration for a single scenario, including agents, initial state, and rules.

Path Parameters

Parameter	Type	Description
id	string	Scenario identifier

Response

{
  "id": "capability-divergence",
  "label": "Capability-Alignment Divergence",
  "seed": 42,
  "tags": ["ai-safety", "governance"],
  "note": "A frontier model whose capabilities outpace its alignment buffer.",
  "initialState": { },
  "agents": [
    {
      "id": "frontier_model",
      "marker": { "x": 200, "y": 75 },
      "policy": { "lambda": 0.5, "gamma": 0.3 },
      "attractorPreferences": { "stability": 0.8 }
    }
  ],
  "nodeLabels": {
    "x": "Capability",
    "y": "Alignment"
  },
  "rules": {
    "zeroSumAttractorCapture": false
  }
}

Response Fields

Field	Type	Description
id	string	Unique scenario identifier
label	string	Human-readable name
seed	number	Default random seed
tags	string[]	Categorization tags
note	string	Brief description
initialState	object	The starting state of the simulation grid
agents	Agent[]	List of agent configurations
agents[].id	string	Agent identifier
agents[].marker	{x, y}	Agent’s initial position
agents[].policy	{lambda?, gamma?}	Agent policy parameters
agents[].attractorPreferences	object	Weighted attractor affinities
nodeLabels	object	Human-readable labels for state axes
rules	object	Simulation rule overrides

Errors

Status	Code	When
404	NOT_FOUND	Scenario ID does not exist

Example

curl https://api.anankelabs.ai/v1/scenarios/capability-divergence