Module provider_platform 

Shared provider platform: identity, registry, factories (JOE-1933 / JOE-1932 / JOE-1936).

Direction-specific execution traits remain in crate::providers (STT) and crate::tts::provider (TTS). This module owns how those implementations are identified, registered, and constructed without flattening STT/TTS semantics. See docs/development/adr-002-provider-registry.md.

Capability discovery and conformance (JOE-1936) route through the registry via capabilities_for and [conformance].

Structs

ConformanceFailure

A single conformance failure (honest, actionable).

LocalSttFactory

LocalTtsFactory

OpenRouterSttFactory

OpenRouterTtsFactory

ProviderBuildContext

Bounded inputs for constructing a single provider instance.

ProviderDescriptor

Immutable description of a registered provider (compile-time / registration-time).

ProviderId

Stable, validated provider identity used at core boundaries.

ProviderList

Versioned list payload for JSON discovery (aurum providers --json later).

ProviderOperations

Operations a provider factory may expose.

ProviderRegistry

Engine-owned registry of compiled provider factories.

ProviderRegistryBuilder

Builder that rejects duplicate operation identities.

ProviderResolveOptions

Optional overrides when resolving a provider through crate::AurumEngine (JOE-1938).

ProviderSummary

One compiled provider as seen through the registry (no secrets).

Enums

NetworkRequirement

Whether a provider implementation may perform network I/O.

ProviderStability

Stability of a registered provider surface.

Constants

MAX_PROVIDER_ID_LEN

Maximum length of a provider id (bytes after normalization).

PROVIDER_LIST_SCHEMA_VERSION

Schema version for provider list JSON (discovery DTO).

Traits

SynthesisProviderFactory

Constructs TTS providers from a bounded build context.

TranscriptionProviderFactory

Constructs STT providers from a bounded build context.

Functions

capabilities_for

Look up capabilities via registered factories.

check_builtin_conformance

Run built-in product conformance: unique ids + network claim samples.

check_descriptor_capabilities

Run the standard static checks for one descriptor + capabilities pair.

check_network_claim

Descriptor network claim must agree with capability requires_network / local_only_ok (no lying about offline suitability).

check_unique_descriptor_identities

Built-in descriptors must have unique (id, direction) identities.

list_provider_summaries

Enumerate compiled providers from a registry (registration order, offline).

merge_provider_summaries

Merge STT/TTS factories that share a provider id into one summary row.

preflight_stt_with_registry

Registry-backed STT preflight: factory must exist; request gates stay fail-closed.

preflight_tts_with_registry

Registry-backed TTS preflight.

provider_list

Versioned list for future CLI JSON output.