build_tools.syllable_walk_web.api.walker_session
================================================

.. py:module:: build_tools.syllable_walk_web.api.walker_session

.. autoapi-nested-parse::

   Session-focused walker API helpers and handlers.

   This module isolates session save/list/load behavior from ``api/walker.py``.
   The extraction is mechanical: endpoint behavior and payload contracts are
   preserved, while dependencies are passed as callables where needed so the
   legacy wrapper functions in ``walker.py`` remain the patch/test authority.



Attributes
----------

.. autoapisummary::

   build_tools.syllable_walk_web.api.walker_session.EnforceActiveLockFn
   build_tools.syllable_walk_web.api.walker_session.CoerceLockHolderFn
   build_tools.syllable_walk_web.api.walker_session.LockConflictErrorFn
   build_tools.syllable_walk_web.api.walker_session.LoadCorpusFn
   build_tools.syllable_walk_web.api.walker_session.RestorePatchArtifactsFn
   build_tools.syllable_walk_web.api.walker_session.ReadJsonObjectFn


Functions
---------

.. autoapisummary::

   build_tools.syllable_walk_web.api.walker_session.handle_save_session
   build_tools.syllable_walk_web.api.walker_session.handle_sessions
   build_tools.syllable_walk_web.api.walker_session.read_json_object
   build_tools.syllable_walk_web.api.walker_session.restore_patch_artifacts_from_run_state
   build_tools.syllable_walk_web.api.walker_session.is_stale_session_recoverable
   build_tools.syllable_walk_web.api.walker_session.handle_load_session


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

.. py:data:: EnforceActiveLockFn

.. py:data:: CoerceLockHolderFn

.. py:data:: LockConflictErrorFn

.. py:data:: LoadCorpusFn

.. py:data:: RestorePatchArtifactsFn

.. py:data:: ReadJsonObjectFn

.. py:function:: handle_save_session(body, state, *, enforce_active_session_lock_fn)

   Handle POST ``/api/walker/save-session`` with injected lock enforcement.


.. py:function:: handle_sessions(state)

   Handle GET ``/api/walker/sessions``.


.. py:function:: read_json_object(path)

   Read one JSON object from ``path``.

   Returns ``None`` on IO, decode, parse, or type failures.


.. py:function:: restore_patch_artifacts_from_run_state(*, patch_key, patch, read_json_object_fn = read_json_object)

   Restore patch artifacts from verified run-state sidecars.


.. py:function:: is_stale_session_recoverable(*, status, reason)

   Return ``True`` for mismatch states safe to recover from raw payload.


.. py:function:: handle_load_session(body, state, *, coerce_lock_holder_id_fn, lock_conflict_error_fn, handle_load_corpus_fn, restore_patch_artifacts_from_run_state_fn, read_json_object_fn)

   Handle POST ``/api/walker/load-session`` with injected dependencies.