Skip to content

API Reference

Auto-generated from the source of latence-core (the framework spine) and a representative Provider package. The core carries only the contract / serialization / IO / CLI spine and near-zero dependencies (ADR-0016), so this is the stable surface a Provider author and an embedding integrator program against.

Module What it defines
Stage contracts (generated) The generated per-Capability replacement contract — what every Stage receives and must emit, plus the exact steps to swap any Provider without breaking the flow. Machine-readable twin: stage-contracts.json.
Data contracts The Pydantic record schema shared by every Stage — Provenance, Classification, the per-Stage Record types.
Capability protocols The typed Protocols a Provider implements, plus the ProviderRegistry.
Pipeline The declarative DAG of Stages.
Local Runner The built-in files-on-Storage execution adapter.
Storage seam The fsspec-backed cloud-agnostic IO layer.
Provider base & profile AdapterBase and ProviderProfile — the optional adapter helpers and the enterprise-readiness descriptor.
Errors & tracing The typed error taxonomy and the thin tracing seam.
Example provider parser.pdfplumber — the reference Wave-1 adapter template.

Docstring style

Source docstrings use Sphinx/RST cross-references (:class:`...`). Names render as written; follow the module links above for the parsed, structured API.