Crate lds_session 

Session lifecycle primitives shared across all lds modules.

Every module (git, recipe, sandbox) receives an Arc<Session> that anchors operations to a single project root. Shared concerns — timeout, output truncation, global recipe dirs — live here so modules don’t duplicate configuration.

This crate was split out of lds-core to give downstream consumers (current: lds workspace modules; future: session-mcp / KV primitives) a self-contained session contract independent of the broader core utilities (binary probing, output truncation, config files).

Structs

DoctorCheck

DoctorReport

LdsState

Top-level mutable state for the MCP server.

Session

Immutable session state created by session_start / session_create.

SessionConfig

Configuration passed to Session::new. Optional fields fall back to sensible defaults (60s timeout, 100KB output limit).

SessionEntry

Snapshot of a single session entry, returned by ledger introspection APIs.

Enums

CheckStatus

Per-check verdict returned by LdsState::doctor.

CoreError

Errors that can occur during session construction or access.

SessionError

Errors that can occur during a Session’s post-construction lifecycle.

Constants

DEFAULT_WORKTREES_SUBDIR

Canonical subdirectory name appended to the session root when no override (explicit config field or LDS_WORKTREES_DIR env) is set.