build_tools.syllable_walk_web.api.walker_session

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

`EnforceActiveLockFn`
`CoerceLockHolderFn`
`LockConflictErrorFn`
`LoadCorpusFn`
`RestorePatchArtifactsFn`
`ReadJsonObjectFn`

Functions

`handle_save_session`(body, state, *, ...)	Handle POST `/api/walker/save-session` with injected lock enforcement.
`handle_sessions`(state)	Handle GET `/api/walker/sessions`.
`read_json_object`(path)	Read one JSON object from `path`.
`restore_patch_artifacts_from_run_state`(*, patch_key, patch)	Restore patch artifacts from verified run-state sidecars.
`is_stale_session_recoverable`(*, status, reason)	Return `True` for mismatch states safe to recover from raw payload.
`handle_load_session`(body, state, *, ...)	Handle POST `/api/walker/load-session` with injected dependencies.

Module Contents

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

build_tools.syllable_walk_web.api.walker_session.handle_save_session(body, state, *, enforce_active_session_lock_fn)[source]

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

build_tools.syllable_walk_web.api.walker_session.handle_sessions(state)[source]

Handle GET /api/walker/sessions.

build_tools.syllable_walk_web.api.walker_session.read_json_object(path)[source]

Read one JSON object from path.

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

build_tools.syllable_walk_web.api.walker_session.restore_patch_artifacts_from_run_state(*, patch_key, patch, read_json_object_fn=read_json_object)[source]

Restore patch artifacts from verified run-state sidecars.

build_tools.syllable_walk_web.api.walker_session.is_stale_session_recoverable(*, status, reason)[source]

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

build_tools.syllable_walk_web.api.walker_session.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)[source]

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