build_tools.syllable_walk_web.api.pipeline
==========================================

.. py:module:: build_tools.syllable_walk_web.api.pipeline

.. autoapi-nested-parse::

   Pipeline API handlers for the web application.

   Handles pipeline start, status, cancel, and run listing.



Functions
---------

.. autoapisummary::

   build_tools.syllable_walk_web.api.pipeline.handle_start
   build_tools.syllable_walk_web.api.pipeline.handle_status
   build_tools.syllable_walk_web.api.pipeline.handle_cancel
   build_tools.syllable_walk_web.api.pipeline.handle_runs


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

.. py:function:: handle_start(body, state)

   Handle POST /api/pipeline/start.

   Starts a new pipeline run in a background thread.

   :param body: Request body with pipeline configuration.
   :param state: Global server state.

   :returns: Immediate response with job ID and status.


.. py:function:: handle_status(state)

   Handle GET /api/pipeline/status.

   Returns current pipeline job status with log lines.

   :param state: Global server state.

   :returns: Job status dict.


.. py:function:: handle_cancel(state)

   Handle POST /api/pipeline/cancel.

   Cancels the running pipeline job.

   :param state: Global server state.

   :returns: Confirmation dict.


.. py:function:: handle_runs(state, patch = None)

   Handle GET /api/pipeline/runs.

   Lists discovered pipeline runs.  When *patch* is ``"a"`` or ``"b"``
   and a per-patch corpus directory is configured, runs are discovered
   from that directory instead of *output_base*.

   :param state: Global server state.
   :param patch: Optional patch key (``"a"`` or ``"b"``).

   :returns: Dict with runs list.