build_tools.syllable_walk_web.services.walker_session_store

Session IPC store for dual-patch walker restore metadata.

This service implements Phase 2 of the Patch A/B IPC session-load plan:

write deterministic session artifacts under runtime-resolved sessions_base
verify session payload IPC integrity and linked run-state references
list and load verified (or diagnosable) sessions for API integration

Attributes

`SESSION_SCHEMA_VERSION`
`SESSION_KIND`
`SESSION_RUN_STATE_RELATIVE_PATH`
`IPC_LIBRARY`

Classes

`SessionPatchReferenceResult`	Outcome of resolving one patch reference for session payload building.
`SessionSaveResult`	Outcome of saving one dual-patch session payload.
`SessionVerificationResult`	Outcome of validating one persisted session artifact.
`SessionLoadResult`	Outcome of loading one persisted session artifact.
`SessionListEntry`	List item representing one persisted session artifact.

Functions

`save_session`(*, state[, label, session_id, ...])	Persist one dual-patch session payload under resolved `sessions_base`.
`verify_session`(*, session_path, output_base)	Verify persisted session payload + linked run-state references.
`load_session`(*, session_id, output_base[, ...])	Load one session by id when verification succeeds.
`list_sessions`(*, output_base[, configured_sessions_base])	List persisted sessions in descending `created_at_utc` order.

Module Contents

build_tools.syllable_walk_web.services.walker_session_store.SESSION_SCHEMA_VERSION = 1

build_tools.syllable_walk_web.services.walker_session_store.SESSION_KIND = 'walker_patch_session'

build_tools.syllable_walk_web.services.walker_session_store.SESSION_RUN_STATE_RELATIVE_PATH = 'ipc/walker_run_state.v1.json'

build_tools.syllable_walk_web.services.walker_session_store.IPC_LIBRARY = 'pipeworks-ipc'

class build_tools.syllable_walk_web.services.walker_session_store.SessionPatchReferenceResult[source]

Outcome of resolving one patch reference for session payload building.

status: str

reason: str

patch_ref: dict[str, Any] | None

class build_tools.syllable_walk_web.services.walker_session_store.SessionSaveResult[source]

Outcome of saving one dual-patch session payload.

status: str

reason: str

session_id: str | None = None

session_path: pathlib.Path | None = None

patch_a_status: str | None = None

patch_a_reason: str | None = None

patch_b_status: str | None = None

patch_b_reason: str | None = None

ipc_input_hash: str | None = None

ipc_output_hash: str | None = None

root_session_id: str | None = None

parent_session_id: str | None = None

revision: int | None = None

class build_tools.syllable_walk_web.services.walker_session_store.SessionVerificationResult[source]

Outcome of validating one persisted session artifact.

status: str

reason: str

session_path: pathlib.Path

session_id: str | None = None

ipc_input_hash: str | None = None

ipc_output_hash: str | None = None

class build_tools.syllable_walk_web.services.walker_session_store.SessionLoadResult[source]

Outcome of loading one persisted session artifact.

status: str

reason: str

session_path: pathlib.Path

session_id: str | None = None

payload: dict[str, Any] | None = None

ipc_input_hash: str | None = None

ipc_output_hash: str | None = None

class build_tools.syllable_walk_web.services.walker_session_store.SessionListEntry[source]

List item representing one persisted session artifact.

session_id: str

created_at_utc: str | None

label: str | None

patch_a_run_id: str | None

patch_b_run_id: str | None

verification_status: str

verification_reason: str

session_path: pathlib.Path

root_session_id: str | None = None

parent_session_id: str | None = None

revision: int | None = None

build_tools.syllable_walk_web.services.walker_session_store.save_session(*, state, label=None, session_id=None, repair_from_session_id=None)[source]

Persist one dual-patch session payload under resolved sessions_base.

build_tools.syllable_walk_web.services.walker_session_store.verify_session(*, session_path, output_base)[source]

Verify persisted session payload + linked run-state references.

build_tools.syllable_walk_web.services.walker_session_store.load_session(*, session_id, output_base, configured_sessions_base=None)[source]

Load one session by id when verification succeeds.

build_tools.syllable_walk_web.services.walker_session_store.list_sessions(*, output_base, configured_sessions_base=None)[source]

List persisted sessions in descending created_at_utc order.