ResidualRisk reports which residual-risk classes a body still exhibits AFTER a Payload pass. An empty result means the body cleared the screen; it doe

all loads every memory.

What the client holds right now.

NewLog returns the default log/build-output compressor.

Put writes body at key, overwriting any existing object.

CandidateActionID is a delimiter-safe, stable identity for the complete provider/model/effort tuple. Sixteen digest bytes are enough for compact telem

Load reads caveman.yaml from path, applying defaults. A missing file yields the default config (record mode on 127.0.0.1:8787) rather than an error: a

Plan selects profitable stable-prefix cache boundaries without editing wire bytes.

EstimateUSD prices already-classified billable token buckets. Token counts must be disjoint: InputTokens is uncached input; CachedInputTokens is cache

accept returns the reject reason, or "" when the rewrite may be used. Check order is: shape, then saving, then fidelity. The saving check runs before

Detect classifies a payload into a content type. It is deterministic and fail-open: anything it is not confident about is "text", which routes to a co

NewJSON returns the default JSON/tool-output compressor.

NewToolSchema returns the tool-schema / tool-catalog compressor. It is selected by forcing the "toolschema" content type (engine.Options.Type); Detect

Recall returns the memories most relevant to query, ranked by BM25, filtered by the threshold, and compressed for injection. It fails toward no recall

SanitizeAndMapHeaders maps the inbound headers to the upstream header set and applies any provider auth/signing. upstream is the ALREADY-RESOLVED forw

Simulate runs the same detect → route → compress → count pipeline as Compress but stores NOTHING (no CCR Put) and makes no network call: a pure dry-ru

ToolError is a fail-closed tool error: isError=true with a cave_snake_code, so a host never mistakes it for a successful payload.

Buffer a span, mapping GenAI fields to ``gen_ai.*`` attributes. Returns the :class:`OTelSpan` (with generated ids) so callers can chain

DefaultProviders returns built-in Anthropic, OpenAI, Bedrock, and Gemini lanes.

New assembles a standalone gateway server from a config and a telemetry sink.

PassedThrough reports whether the call returned the input unchanged.

ResolveDensity maps a reader model and requested level to a render profile. Fail-closed rules: an unrecognised model resolves to conservative geometry

expectedReplacement is the exact JSON-encoded string the splice must produce for a block this compressor shrank: compressed bytes, newline, CCR marker

CompressQuery is Compress with an additional relevance query. An empty query must behave exactly like Compress.

EngineTools returns the five Caveman compression tools bound to eng. log may be nil. This is the tool set the caveman-mcp binary serves.

Payload scrubs a captured request or response body and returns the redacted bytes plus the evidence of what was removed. On ANY error it returns a ni

A client holding the fixture bundle (signature verified against the pin).

narrowToQuery splits stored content into whole units, BM25-ranks them against the query, and returns the relevant ones in their original order, markin

newPAYGPrefixServer builds the PAYG compress session the probe used: a BYOK key (so the request classifies payg), MCP recovery (so the marker-only pat

writeRetroClaudeSessions lays down `sessions` transcripts, each with `usageTurns` provider-counted assistant turns, one unique tool result, and `repea

writeRetroTranscript writes one transcript from raw JSONL lines.

AppendObjectFields inserts fields immediately before an object's closing brace. Existing bytes, whitespace, key order, and escapes remain untouched. C

CountTokensRequest projects the ORIGINAL request. ok=false means no baseline call may be issued.