History

Turtle 27ac49e687 docs: define a seam as the (Service, Service provider, Consumer) trio		2026-08-09 17:11:16 +08:00
..
command-compact	docs(i18n): standardize contract terminology	2026-08-09 11:33:14 +08:00
compact	docs: define a seam as the (Service, Service provider, Consumer) trio	2026-08-09 17:11:16 +08:00
compact-basic	docs: replace vague provenance prose with recorded facts	2026-08-09 15:35:02 +08:00
compact-tool-result-prune	docs: replace vague provenance prose with recorded facts	2026-08-09 15:35:02 +08:00
README.i18n.yaml	docs(i18n): standardize contract terminology	2026-08-09 11:33:14 +08:00
README.md	docs: anchor each subsystem page to its package group; make group READMEs thin tables	2026-08-09 01:32:39 +08:00
README.zh.md	docs(i18n): standardize contract terminology	2026-08-09 11:33:14 +08:00

README.md

compact/ — compaction capability family

English | 中文

A compaction capability family (see capability seams): an abstract interface, a summarizing backend, a model-free tool-result pruning companion, and a human command adapter. All product packages.

Package	Role	ctx key
`compact/`	Compaction seam and event vocabulary	`ctx.compact`
`compact-basic/`	Token-pressure and summarization backend	registers `ctx.compact`
`compact-tool-result-prune/`	Optional model-free tool-result pruning	`ctx.toolResultPrune`
`command-compact/`	Human compaction command	registers on `ctx.commands`

The backend, optional pruner, and human command compose through the seam; token measurement remains a separate LLM-family service. The compaction capability-seam Agent Note owns the dependency rationale.

The subsystem reference — the compact/* events, CompactionResult, the service, pruning outcomes — is docs/subsystems/compaction.md; the seam's deliberate dsh-session/dsh-llm dependency is recorded in the compaction capability-seam Agent Note.