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

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

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

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

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

BuildLearnPlanFilteredWithRetro applies a repository substring before turn events reach behavioral detectors. Config scanning intentionally remains ro

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