75 lines
1.5 KiB
ReStructuredText
75 lines
1.5 KiB
ReStructuredText
Live and Replay API
|
|
===================
|
|
|
|
GOD's browser UI uses a small set of backend API families.
|
|
|
|
Live experiment control
|
|
-----------------------
|
|
|
|
Base prefix:
|
|
|
|
.. code-block:: text
|
|
|
|
/live-experiments/{hypothesis_id}/{experiment_id}
|
|
|
|
Important actions:
|
|
|
|
.. list-table::
|
|
:header-rows: 1
|
|
|
|
* - Method
|
|
- Path
|
|
- Purpose
|
|
* - ``POST``
|
|
- ``/start``
|
|
- Start or attach a live experiment.
|
|
* - ``GET``
|
|
- ``/status``
|
|
- Read live status.
|
|
* - ``POST``
|
|
- ``/run-step``
|
|
- Advance one step.
|
|
* - ``POST``
|
|
- ``/intervene``
|
|
- Inject instructions into the next step.
|
|
* - ``POST``
|
|
- ``/ask``
|
|
- Ask one target, a group, or the whole town.
|
|
* - ``POST``
|
|
- ``/auto``
|
|
- Toggle auto-run.
|
|
* - ``POST``
|
|
- ``/pause``
|
|
- Pause auto-run.
|
|
* - ``POST``
|
|
- ``/stop``
|
|
- Stop live execution.
|
|
|
|
Replay data
|
|
-----------
|
|
|
|
Base prefix:
|
|
|
|
.. code-block:: text
|
|
|
|
/replay/{hypothesis_id}/{experiment_id}
|
|
|
|
Common reads:
|
|
|
|
- ``/info``
|
|
- ``/datasets``
|
|
- ``/map``
|
|
- ``/map/tiled``
|
|
- ``/map/assets/{tileset_index}``
|
|
- ``/map/preview``
|
|
- ``/map/characters/{character_name}``
|
|
- ``/map/location-assets/{location_id}``
|
|
- ``/timeline``
|
|
|
|
Setup and configuration
|
|
-----------------------
|
|
|
|
- ``/api/v1/god/setup/*`` owns setup wizard model config, draft generation, Agent Studio generation, publish, and start-request flow.
|
|
- ``/api/v1/experiment-configs/*`` owns experiment config read/write and agent import/apply flows.
|
|
- ``/api/v1/god/map-studio/*`` owns map draft generation, upload, validation, and publish.
|