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

Delegate to an existing native LLM. Model-only calls are recovery-free. Public provider methods retain native serialization, retries, callbacks,

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

Budget and scoring options for connected-only context packing.

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

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

One weak native callback per invocation, with no per-chunk callback list.

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.

Append after the application's authorization and original-content guards.

Delegate every native call; model-only use is recovery-free.

Wrap a native CrewAI LLM; assign a separate trusted Scope per context. Use ``with_caveman_agent`` to register the matching recovery BaseTool.

Native Agno Model delegate. Model-only use has no recovery executor. Agno's Model.response methods retain orchestration. Only invoke/ainvoke and

Public native model delegate. A model wrapper alone is recovery-free.

Native Model delegate; direct model-only use has no recovery executor.

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.

The native MCP definition and the callable registered in the host loop.

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

One prepared native operation and its observed physical HTTP attempts.

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

Returned by server-side auth, never deserialized from caller input. recovery is a binding registered with the host's actual native tool loop.

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

Stable/session content changed inside its declared lifetime.

Final native-call decision; no source text or provider credentials.

Place inside authentication and original-content guard middleware. resolve_context may decline by returning None; existing application routing

Add scoped recovery and wrap each selected native model invocation. Other capabilities and the native Agent own authorization, history, tools,

Native model and tools for an application-owned loop; no scheduler.

Native per-model middleware. Register recovery_tool in the host tool list. with_caveman_agent() performs collision-safe model/tool registration t

Native client and immutable dispatch map for an application-owned loop. Call the selected native Chat Completions or Responses API with ``tools``

Executed by CrewAI's existing native tool scheduler.

Add scoped recovery to a real workbench without changing its tool results. AutoGen 0.7.5 selects streaming tools by this public base class. Deleg

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

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

Raised when another process holds the compress lock past LOCK_WAIT_SECONDS.

Raised when another process holds the compress lock past LOCK_WAIT_SECONDS.

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.

ToolResult is an MCP tools/call result: a content list plus an error flag.

Result from a server-side tool-search call.

Executor registration for a caller-owned loop of native LLM calls.

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.