packages/compact/README.md

# compact/ — compaction capability family

English | [中文](README.zh.md)

A compaction capability family (see [capability seams](../../.agents/notes/implemented/architecture/2026-06-13-capability-seams.md)): 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/`](compact/README.md) | Compaction seam and event vocabulary | `ctx.compact` |
| [`compact-basic/`](compact-basic/README.md) | Token-pressure and summarization backend | registers `ctx.compact` |
| [`compact-tool-result-prune/`](compact-tool-result-prune/README.md) | Optional model-free tool-result pruning | `ctx.toolResultPrune` |
| [`command-compact/`](command-compact/README.md) | 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](../../.agents/notes/implemented/feature/2026-06-18-compaction-capability-seam.md) owns the dependency rationale.
docs(compact): add the compact group/service to package and architecture docs 2026-06-23 16:40:24 +08:00			`# compact/ — compaction capability family`

docs: translate remaining READMEs 2026-07-26 05:03:53 +08:00			`English \| [中文](README.zh.md)`

round 1: implement bracket-first manual compaction 2026-07-30 17:40:25 +08:00			`A compaction capability family (see [capability seams](../../.agents/notes/implemented/architecture/2026-06-13-capability-seams.md)): an abstract interface, a summarizing backend, a model-free tool-result pruning companion, and a human command adapter. All product packages.`
docs(compact): add the compact group/service to package and architecture docs 2026-06-23 16:40:24 +08:00
			`\| Package \| Role \| ctx key \|`
			`\|---\|---\|---\|`
docs: apply hierarchy across the corpus 2026-08-04 00:54:19 +08:00			\| [`compact/`](compact/README.md) \| Compaction seam and event vocabulary \| `ctx.compact` \|
			\| [`compact-basic/`](compact-basic/README.md) \| Token-pressure and summarization backend \| registers `ctx.compact` \|
			\| [`compact-tool-result-prune/`](compact-tool-result-prune/README.md) \| Optional model-free tool-result pruning \| `ctx.toolResultPrune` \|
			\| [`command-compact/`](command-compact/README.md) \| Human compaction command \| registers on `ctx.commands` \|
docs(compact): add the compact group/service to package and architecture docs 2026-06-23 16:40:24 +08:00
docs: apply hierarchy across the corpus 2026-08-04 00:54:19 +08:00			`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](../../.agents/notes/implemented/feature/2026-06-18-compaction-capability-seam.md) owns the dependency rationale.`