keepQueryRelevant adds the highest-scoring BM25 documents to keep. Existing force-keeps are never removed. Selection is deterministic: score descendin

maskDecision runs a tool output through afterTool exactly as the hook does and reports whether the output was replaced by a pointer.

Mask what cannot be summarized in place; elide what can. These pin the boundary between the two mechanisms. Before it existed they collided: the ship

newCodeWith constructs the code compressor with explicit options (used by callers/tests that want comment or docstring removal).

pageRows is the row count that fills the profile's canvas height.

parseFlexInt coerces a JSON value (number or numeric string) to a non-negative uint64. Negative or unparseable values become 0.

The breakpoint planner places Anthropic prompt-cache metadata on the upstream request. cache_control is not model-visible, so this is byte-safe under

Record a tool call. Raises :class:`RetryLoopError` once an identical call has repeated past the threshold. A different call resets the streak.

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

renderStyle builds the RenderStyle that draws this profile. Cell advance is expressed through CellWBonus (advance − glyph width); pitch and zebra are

retrieveTool returns the exact original for a handle; an unknown handle is a fail-closed tool error carrying a cave_snake_code (PRD §11.4). session ma

retroExpectedCut measures the same segments the retro pass would, through the same engine call, so the assertion is an oracle rather than a magic numb

roundUSD preserves the ClickHouse money columns' Decimal128(10) precision. Rounding each request to micro-dollars loses real spend for low-cost models

serveLines drives the server with raw request lines and returns the raw non-empty output lines (a JSON-RPC batch response is a single array line, so t

skipValue returns the offset just past the JSON value at i without inspecting it. The input is pre-validated, so container nesting is tracked by depth

tmpStore returns a WithStorePath option pointing at a fresh per-test database file, so tests never write to the shared ~/.caveman/ccr.db.

unresolvedInternalRefs resolves each local JSON Pointer from the schema resource that contains it: an embedded tool schema or the nearest subschema ca

AnalyzeTrial runs local-only replay checks against captured payloads, stores the resulting moves, then returns the public TrialPlan. Local never verif

AppJWT builds a short-lived (10-minute) RS256 App JWT signed with the App private key. iat is backdated 60s to tolerate clock skew (GitHub's guidance)

BM25 scores each document against the query using the same deterministic Okapi BM25 the context packer uses (k1=1.5, b=0.75) — no embeddings, no netwo

ClassifyResolvedAuthMode includes the credential resolver's final BYOK/config key. Header-only classification labeled a configured subscription/OAuth

Compress encodes data with the named codec. "none" returns data unchanged.

ConfidenceScore is a CHEAP, PURE heuristic that scores how confident a cascade rung's answer text looks, in [0,1]. Lower = less confident = should esc

DecompressLimit reverses Compress while refusing to produce more than maxBytes of plaintext. The limit is applied while decoding gzip and through zstd

DefaultCorpusLimits returns conservative local-import bounds.

Exists reports whether key is present.

ExtractCompressible is exported so Azure OpenAI and OpenAI-compatible adapters can reuse the identical wire grammar without changing provider identity

ExtractProviderUsage extracts cache counters and total input tokens from one complete, non-streaming provider response. Duplicate keys, missing totals

Forget deletes a memory by id and atomically repairs neighboring lineage pointers. Expired predecessors stay expired: deleting a current version means

FromEnv builds a Store from the S3_* environment variables. It returns (nil, nil) when S3_ENDPOINT is unset outside production. Production requires ob

FrozenLevers returns this session's frozen levers in a stable order, for the x-caveman-tripwire disclosure header.

List returns all keys under prefix (used by retention + ZDR assertions).

New constructs the Vertex adapter. baseURL is the aiplatform endpoint; in production it is a Vertex host (e.g. https://us-central1-aiplatform.googleap

New parses the private key, validates the base URL, and builds the App. It returns an error (not a half-built App) on any misconfiguration, so callers

NewChecked validates configuration at construction time. New preserves its original one-result API but stores the same configuration error and makes a

NewQueryClient returns an *http.Client bounded for ClickHouse queries/DDL.