deepseek-harness/docs/core-data-structures
Tianyi Cui a7b569850b session: the request header becomes logged state — request/header events + fold/diff/apply
Every conversation request's non-content half (system prompt, tool
schemas, call config — the EpochHeader) is now recorded in the session
log: a 'request/header' full snapshot (reason 'initial' | 'resume' |
'fallback') anchors the fold at conversation birth and process
boundaries, and 'request/header-delta' events (system line-trim,
name-keyed tools delta, whole config) encode mid-run changes. The pure
trio — foldRequestHeader / diffHeader / applyHeaderDelta — reconstructs
the header any request was built under from the log alone; the writer
contract round-trip-verifies every delta with a 'fallback' snapshot
when the encoding cannot express a change (pure tool reordering), so a
well-formed log always folds cleanly. Canonical absence: empty system
and empty tools normalize to absent fields, matching request builds.

Persistence and cordis catalogs regenerated; SessionEventMap paste and
EpochHeader added to the core-data-structures session page.
2026-07-06 02:42:51 +08:00
..
bash.md docs(bash): reframe stdin/env — the scrub is the security control, not a trust boundary 2026-07-02 04:08:24 +08:00
compaction.md compact: summarize is a direct one-shot llm/stream call, not a loop step 2026-07-06 02:16:11 +08:00
core.md session: the request header becomes logged state — request/header events + fold/diff/apply 2026-07-06 02:42:51 +08:00
filesystem.md Split the cordis catalog into separate events and services documents 2026-07-05 00:45:06 +08:00
llm-streaming.md docs: make the service map the front door of architecture.md 2026-07-05 01:22:17 +08:00
persistence.md Add generated persistence log event catalog with freshness + completeness gates 2026-07-04 22:58:28 +08:00
session.md session: the request header becomes logged state — request/header events + fold/diff/apply 2026-07-06 02:42:51 +08:00
subagent.md Merge origin/master: adopt the DeepSeek Harness SDK product name 2026-07-05 20:54:48 +08:00
tools.md Merge branch 'worktree-hooks-b-bash-seam' into worktree-hooks-c-interception 2026-07-04 02:44:26 +08:00
web.md Merge remote-tracking branch 'origin/master' into simpl-c-web-observation 2026-07-04 20:54:42 +08:00