fast-compaction-dsh

Configuration

All fields are optional and stack in two layers:

1. The settings.yaml user layer (the fast-compaction: section of ~/.dsh/settings.yaml) — wins per field and applies live to subsequent compactions: the engine watches the settings service's hot-publish and rebuilds the Jev transport in place when apiKey/model/baseUrl change, so no restart is needed. The friendly editor is this package's own Web settings card (web/, the fast-compaction-dsh/client entry) on the Plugins page (apiKey rides as a secret role field — only a set/unset flag ever crosses the wire).
2. The preset patch config: (composition layer) — the per-preset base values; changes require a DSH restart.

Per-field precedence: settings.yaml user layer > preset config: > environment (apiKey only, via TYPESAFE_API_KEY) > code defaults. Unlisted fields pass through to compaction-basic (thresholdRatio, retainRatio, retainTokens, summarizationProvider, summarizationModel, maxTokens, compactionRetries, maxOverflowRetries, modelPolicies, auto).

Note: a settings section whose values fail the schema (e.g. a string in keepThreshold) disables the whole settings layer and falls back to the composition layer, with a warning in the log; the layer retries on the next process start.

Field	Default	Meaning
apiKey	TYPESAFE_API_KEY	TypeSafe API key
model	jev-latest	Jev model name
baseUrl	https://api.typesafe.ai/v1/systemone	System One endpoint
keepThreshold	0.5	Minimum keep probability for a call or result to stay
preserveRecentMessages	6	Newest messages never touched (the first is always kept)
maxStateTokens	25000	Estimated token ceiling for the state
maxRequestTokens	30000	Estimated ceiling for state plus one batch of questions
truncateHeadChars	300	Characters of a dropped tool result retained before its note
minReduction	0.25	Fall back to the built-in summary below this reduction ratio
disabled	false	Use only the built-in summarizer