buildLearnSpend prices the accumulated buckets. Returns nil when nothing priceable was measured — an empty spend card is worse than none.

compressionSavingsUSD is the inferred dollar value of the input tokens that S4 content compression removed before the request reached the provider. It

crSuffix returns the CR a synthesized line needs so it matches the endings the rest of the document uses.

* Create a one-call OTel exporter bound to this Cave's gateway config. * * The exporter ships spans to the gateway's OTLP endpoint * (`POST {

Alias for `export()`, matching common OTel exporter naming.

Zone tagging for the cross-turn prefix fix. Gemini caches repeated prompt prefixes implicitly, so a turn this proxy compressed while it was the live z

gutterLines renders content the way a coding agent's read tool prints a file.

handleArgs dispatches a CLI subcommand against store, writing JSON (or raw recovered bytes) to stdout and diagnostics to stderr, and returns the proce

joinLines is the inverse of splitLines.

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).

normalizeBlock is the internal grouping key (lowercase, digit-run masked, whitespace collapsed) so the same block with trivial numeric/whitespace drif

observeSession extracts every n-gram of tool signatures in the session's call order and books the output tokens the span consumed.

outcomeSink groups scanned sessions by whether a commit overlapped them, and reports what each cohort cost. It emits nothing unless git could actually

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

procedureSinks emits at most a handful of distillation candidates, ranked by how much re-derivation they represent.

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