# kcode-session-history
`kcode-session-history` is Kennedy's internal Rust library for durable session
history. It owns:
- the `kcode-session-log` dependency and every active session log;
- the opaque per-session `Session` handle used to mutate Chatend history;
- lifecycle checkpoints, ingress state, browser-command journals, and durable
stop requests with same-process listener notification;
- pending session objects; and
- the append-only index of completed Kweb session archives.
Private raw `.session-control` record encoding, integrity, recovery, append,
and replacement mechanics are supplied by `kcode-session-control-journal`;
Session History retains the domain records and compaction policy.
It deliberately has no HTTP framework, routes, multipart parsing, response
types, or KennedyServer dependency. KennedyServer owns those adapters and Kweb
commit policy.
## Boundary
The two primary handles are:
- `SessionHistory`: the long-lived store. Open it once, then use typed methods
to start, register, list, checkpoint, transition, and complete sessions.
- `Session`: an opaque handle to one active session's ordered history,
projections, and pending objects. It is created with a library-assigned ID
or reopened through `SessionHistory`; callers never supply or receive
storage paths.
There is no `SessionLease`. Kennedy already serializes writes where required,
and a second lifetime/locking abstraction would make the boundary larger
without adding an ownership guarantee that the application needs.
The current managed source version is 0.1.4 for Kennedy component dependencies:
```toml
[dependencies]
kcode-session-history = "0.1.4"
```
The source conforms to the `kcode-rust-libs-v2` managed-library contract:
package name and version are literal, generated Cargo state is excluded, and
`Documentation.md` is the root agent-facing API reference.
See [Documentation.md](Documentation.md) for the complete integration API,
[Specification.md](Specification.md) for persistence and lifecycle semantics,
and [DependencyAudit.md](DependencyAudit.md) for the dependency boundary.
## Verify
```sh
cargo test
```