History

imccyu 8cbdd5b9d0 refactor(session): route construction through Session.create		2026-08-05 11:56:14 +08:00
..
session-checkpoint-policy	fix(packages): omit source publication payloads	2026-08-05 01:15:19 +08:00
session-persistence	refactor(session): route construction through Session.create	2026-08-05 11:56:14 +08:00
session-persistence-jsonl	Merge origin/master into xjt/proofreading-active-docs-2-apply	2026-08-05 10:57:53 +08:00
session-persistence-sqlite	fix(packages): omit source publication payloads	2026-08-05 01:15:19 +08:00
README.i18n.yaml	docs(i18n): proofread active Chinese documentation	2026-08-04 17:36:14 +08:00
README.md	docs: translate remaining READMEs	2026-07-26 05:06:39 +08:00
README.zh.md	docs(i18n): proofread active Chinese documentation	2026-08-04 17:36:14 +08:00

README.md

session-persistence/ — persistence capability family

English | 中文

The durable session-persistence seam and its storage backends. The interface package owns the abstract SessionPersistence service and the shared write coordinator; the backends are concrete implementations that register on ctx.sessionPersistence. All product packages.

Package	Role	ctx key
`session-persistence/`	Persistence seam + shared write coordinator	`ctx.sessionPersistence`
`session-checkpoint-policy/`	Semantic durability barriers for agent requests and tool execution	(wraps `ctx.llm` / `ctx.tools`, listens on agent events)
`session-persistence-jsonl/`	JSONL-sidecar persistence backend	(registers `ctx.sessionPersistence`)
`session-persistence-sqlite/`	SQLite persistence backend	(registers `ctx.sessionPersistence`)

The interface lives at session-persistence/session-persistence/; backends are flat siblings. A new storage backend joins here and registers on ctx.sessionPersistence. See session persistence.