* 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

synthLine builds a synthesized line (an elision marker) with the document's dominant line ending.

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