ReplayTransportFunc adapts a function to ReplayTransport.

ReplayVerifierFunc adapts a function to ReplayVerifier.

DriverFunc adapts a function to Driver.

Class-invariant elision summaries. keepNonRedundant (redundancy.go) keeps one representative of every resemblance class and lets the rest elide again

Input contract for the client-pure cache-optimal request assembler.

One author-declared request fragment for :meth:`Cave.assemble`.

Detects and interrupts a repeated identical tool-call loop. Call :meth:`record` (or :meth:`guard`) before each tool invocation with the tool

A tool descriptor for inclusion in the tool catalog.

What the agent should run for one task, decided locally. ``decision`` is ``"execute"`` (the policy's execute workflow), ``"fallback"`` (the p

One caller-owned context fragment considered by ``cave.context.pack``.

Budget and scoring options for connected-only context packing.

DensityLevel selects how aggressively the pixel renderer packs text into a page. Unknown/invalid values fail closed to conservative.

codeCompressor keeps imports, signatures, and type/class declarations and elides function/method bodies using a tree-sitter parse, so the structural o

sessionSource isolates provider transcript formats from learn detectors. Sources stream normalized events; detector logic below stays provider-blind.

Result of a :meth:`Cave.compress` call — the Engine's compression report. ``basis`` is always ``"inferred"``: the SDK never emits ``verified`` (t

Selected caller-owned context plus inferred token accounting.

Counter estimates the token length of a payload. Implementations must be deterministic: the same bytes always yield the same count.

One-call OTel exporter that ships spans to the gateway OTLP endpoint. Build with :meth:`Cave.exporter`. Record spans with :meth:`record_span`

The outcome of one :meth:`RuntimePolicyClient.refresh`.

The single human-editable object controlling cave-auto routing for a workflow (spec R14). Field names are the snake_case wire names — identical to

Result from :meth:`Cave.assemble`; every token figure is inferred.

Stable/session content changed inside its declared lifetime.

Class is a position on the engine's safety ladder.

Reserved async-job surface that fails locally before network I/O.

Mode controls whether the engine transforms bytes.

A single span buffered by :class:`OTelExporter`. Mirrors OTLP/JSON span shape gateway ingests at ``POST /v1/traces``. GenAI semantic-conventi

Raised by :class:`RetryLoopBreaker` when an identical tool-call repeats more times than the configured threshold. The breaker is a structural

Local runtime-policy client: fetch rarely, decide locally, never block. :meth:`refresh` pulls the project's published policy bundle over the

A snapshot of what the client currently holds.

Result from a server-side tool-search call.

Mirror of the TS ``trace.artifacts`` namespace. ``page(value, options)`` delegates to :meth:`Trace.page_artifact` so the two SDKs expose the

Provider request carrying local-only Caveman assembly metadata.

Connected-only context selector over caller-owned items. ``pack`` decides what enters the model window. Cache-optimal assembly decides where

Prompt-snippet helpers. Mirrors the TS ``cave.prompts`` namespace.

Session-keyed multi-agent shared context: one agent ``put``s the full handoff context under a session key (``POST /sdk/v1/shared-context``); a pee

A tool-catalog handle returned by :meth:`Cave.tools`. Holds the catalog + the computed ``initial`` subset and exposes :meth:`search`, which c

canonicalJSONNumber is an already-validated JSON number representation used only while recursively rebuilding the decoded value. MarshalJSON writes th

Action is the chosen image transform.

Adapter embeds the shared Base and preserves the retired Gemini explicit-cache entry point as an unconditional byte-identical pass-through.

Adapter is the AWS Bedrock gateway adapter. It embeds the shared Base and adds Bedrock API-key/IAM authentication, a region/model allowlist, and Bedro

Adapter embeds the shared Base and overrides ApplyProviderNativeTransforms for explicit breakpoints and the separate experimental automatic-cache mark

Adapter embeds the shared Base and overrides ApplyProviderNativeTransforms to inject a stable OpenAI prompt_cache_key on the request's cacheable prefi

Adapter embeds Base and adds Azure-specific request validation. Legacy paths must name a deployment and use the configured dated api-version allowlist

Adapter is the Google Vertex AI gateway adapter. Like Bedrock, Vertex fronts multiple model families behind one cloud endpoint: Google Gemini (publish

AgentCorpus is validated retained corpus plus content digest.

AgentEvidence is one content-blind provider request joined to a strict local Cave Build. It exposes hashes and usage only; request/response bodies nev

AnswerGrader grades one model answer. LocalGrader is the offline fallback; gateway/authoritative runs can inject the canonical optimizer grader servic

AnswerKeyModel is an explicit offline smoke runner. It never calls a provider; it returns the fixture's expected answer and labels usage as local.

App holds the parsed App identity and the SSRF-guarded HTTP client.

AppliedFixRecord is Caveman-owned outcome-ledger state. BeforeEvidence is retained internally as locator/measurement metadata; it never contains a rec

Delayed job execution is unavailable and no job was submitted.