Coder/deepseek-harness
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(session-persistence): abstract seam + JSONL backend + wiring

Browse Source 
Add the durable session-persistence capability seam (ADR 0016): an
abstract SessionPersistence service (dsh-session-persistence,
ctx.sessionPersistence) defining create/append/load/list/has/delete/
update over the existing SessionEvent — no parallel persisted type — and
a first implementation (dsh-session-persistence-jsonl): an append-only
JSONL log per session with crash-safe atomic writes, truncation-repair
of a never-committed crash tail, and a read/replay path. SessionMeta
(format version, cwd, lineage) travels out-of-log via session.header.

A shared runPersistenceContract suite holds every backend to the same
append-only / contiguous-seq / lazy-materialization / serializability
semantics.

Config-driven create() now uses a per-run ${id}-session-<uuid> session
id so a fixed name no longer collides with an on-disk log once a durable
backend is loaded; each run is a new session (a demo simplification). The
examples drop their hand-rolled session-jsonl.ts and load the JSONL
backend via cordis.yml; CI smoke-loads it too.

The agent-facing create/resume factory that consumes load() is a
separate seam, deferred to a follow-up; this change stops at the load
primitive and does not reach into the loop.
This commit is contained in:
Tianyi Cui
2026-06-15 21:05:46 +08:00
parent b0bc0b5792
commit df4b7d3d9a
33 changed files with 2959 additions and 89 deletions
Download Patch File Download Diff File Expand all files Collapse all files

28
yarn.lock
View File

@@ -561,6 +561,7 @@ __metadata:
"@deepseek-ai/dsh-invariants": "npm:^0.0.1"
"@deepseek-ai/dsh-llm": "npm:^0.0.1"
"@deepseek-ai/dsh-session": "npm:^0.0.1"
"@deepseek-ai/dsh-session-persistence-jsonl": "npm:^0.0.1"
"@deepseek-ai/dsh-system-prompt": "npm:^0.0.1"
"@deepseek-ai/dsh-tools": "npm:^0.0.1"
cordis: "npm:^4.0.0-rc.6"
@@ -688,6 +689,33 @@ __metadata:
languageName: unknown
linkType: soft
"@deepseek-ai/dsh-session-persistence-jsonl@npm:^0.0.1, @deepseek-ai/dsh-session-persistence-jsonl@workspace:packages/session-persistence-jsonl":
version: 0.0.0-use.local
resolution: "@deepseek-ai/dsh-session-persistence-jsonl@workspace:packages/session-persistence-jsonl"
dependencies:
"@deepseek-ai/dsh-session": "npm:^0.0.1"
"@deepseek-ai/dsh-session-persistence": "npm:^0.0.1"
cordis: "npm:^4.0.0-rc.6"
schemastery: "npm:^3.18.0"
peerDependencies:
"@deepseek-ai/dsh-session": ^0.0.1
"@deepseek-ai/dsh-session-persistence": ^0.0.1
cordis: ^4.0.0-rc.6
languageName: unknown
linkType: soft
"@deepseek-ai/dsh-session-persistence@npm:^0.0.1, @deepseek-ai/dsh-session-persistence@workspace:packages/session-persistence":
version: 0.0.0-use.local
resolution: "@deepseek-ai/dsh-session-persistence@workspace:packages/session-persistence"
dependencies:
"@deepseek-ai/dsh-session": "npm:^0.0.1"
cordis: "npm:^4.0.0-rc.6"
peerDependencies:
"@deepseek-ai/dsh-session": ^0.0.1
cordis: ^4.0.0-rc.6
languageName: unknown
linkType: soft
"@deepseek-ai/dsh-session@npm:^0.0.1, @deepseek-ai/dsh-session@workspace:packages/session":
version: 0.0.0-use.local
resolution: "@deepseek-ai/dsh-session@workspace:packages/session"