Examples

One‑time structural interpretation. The engine returns nodes, dependencies, events, primary blockage, origin and trace.

Request:

{
  "mode": "analyze",
  "payload": {
    "nodes": [
      { "id": "A", "load": 10 },
      { "id": "B", "load": 0 }
    ],
    "dependencies": [
      { "from": "A", "to": "B" }
    ]
  }
}

Response:

{
  "mode": "analyze",
  "engine": {
    "nodes": [...],
    "dependencies": [...],
    "primaryBlockage": null,
    "events": [],
    "origin": null,
    "trace": []
  }
}

Executes a single engine step and returns the first snapshot.

Request:

{
  "mode": "tick",
  "nodes": [
    { "id": "A", "load": 5 },
    { "id": "B", "load": 0 }
  ],
  "dependencies": [
    { "from": "A", "to": "B" }
  ]
}

Response:

{
  "mode": "tick",
  "snapshot": {
    "nodes": [...],
    "dependencies": [...],
    "events": [...],
    "primaryBlockage": null
  }
}

Executes multiple steps and returns a full timeline of snapshots.

Request:

{
  "mode": "ticks",
  "ticks": 3,
  "payload": {
    "nodes": [
      { "id": "X", "load": 8 },
      { "id": "Y", "load": 0 }
    ],
    "dependencies": [
      { "from": "X", "to": "Y" }
    ]
  }
}

Response:

{
  "mode": "ticks",
  "ticks": 3,
  "snapshots": [
    { ... },
    { ... },
    { ... }
  ]
}

The API also accepts the following keys instead of payload:

• • system
• • record
• • data
• • graph