mud_server.api.routes.lab
=========================

.. py:module:: mud_server.api.routes.lab

.. autoapi-nested-parse::

   Lab endpoints for the Axis Descriptor Lab research tool.

   These endpoints expose the world's OOC→IC translation pipeline directly via
   a JSON API, bypassing the game engine's character DB lookup.  They are
   intended exclusively for use by the Axis Descriptor Lab — a single-user
   research tool for testing IC prompt behaviour against deterministic axis
   payloads.

   Auth
   ----
   Session-based — same mechanism as all other server endpoints.  Admin or
   superuser role is required.  The lab logs in interactively via its UI; no
   credentials are stored anywhere on disk.

   Endpoints
   ---------
   GET  /api/lab/worlds
       List all active worlds with a flag indicating whether the translation
       layer is enabled.  Used to populate the lab's world-selector dropdown.

   GET  /api/lab/world-config/{world_id}
       Return the translation layer configuration for a specific world (model,
       active_axes, strict_mode, etc.).  Used by the lab UI to reflect what the
       server will actually apply to a translation request.

   GET  /api/lab/world-image-policy-bundle/{world_id}
       Return the DB-resolved image policy bundle (composition order, runtime
       input requirements, and manifest-derived reference metadata).

   POST /api/lab/compile-image-prompt
       Compile a deterministic image prompt from DB-resolved policy assets
       and runtime inputs (species, gender, axes, optional context signals).

   POST /api/lab/translate
       Translate an OOC message to IC dialogue using the world's canonical
       pipeline.  Accepts raw axis values — no character DB lookup is
       performed.  Returns the IC text, outcome status, the server-formatted
       profile_summary, and the fully-rendered system prompt sent to Ollama.



Attributes
----------

.. autoapisummary::

   mud_server.api.routes.lab.logger


Functions
---------

.. autoapisummary::

   mud_server.api.routes.lab.router


Module Contents
---------------

.. py:data:: logger

.. py:function:: router(engine)

   Build and return the lab API router.

   :param engine: The live ``GameEngine`` instance, used to access the world
                  registry and translation services.

   :returns: Configured ``APIRouter`` with all lab endpoints registered.