Skip to content

registry

diapason.core.registry

Decorator-based registry for runtime discovery of pluggable components.

Adapted from IPW's src/ipw/core/registry.py. Each typed subclass gets its own isolated storage so registrations in one registry never leak into another.

AgentRegistry

Bases: RegistryBase[Type['BaseAgent']]

Registry for agent implementations.

BenchmarkRegistry

Bases: RegistryBase[Any]

Registry for benchmark implementations.

ChannelRegistry

Bases: RegistryBase[Any]

Registry for channel implementations.

CompressionRegistry

Bases: RegistryBase[Any]

Registry for context compression strategies.

ConnectorRegistry

Bases: RegistryBase[Any]

Registry for data source connectors (Gmail, Slack, etc.).

EngineRegistry

Bases: RegistryBase[Type['InferenceEngine']]

Registry for inference engine backends.

FactStoreRegistry

Bases: RegistryBase[Type['FactStore']]

Registry for automatic-memory fact store backends.

LearningRegistry

Bases: RegistryBase[Any]

Registry for learning policies.

MemoryRegistry

Bases: RegistryBase[Type['MemoryBackend']]

Registry for memory / retrieval backends.

MinerRegistry

Bases: RegistryBase[Any]

Registry for Pearl mining provider implementations.

Each provider implements the MiningProvider ABC defined in diapason.mining._stubs. Registry keys are short lowercase strings such as "vllm-pearl" (CUDA + Hopper) and (future) "mlx-pearl", "llamacpp-pearl-metal", "ollama-pearl".

ModelRegistry

Bases: RegistryBase[Any]

Registry for ModelSpec objects.

RegistryBase

Bases: Generic[T]

Generic registry base class with class-specific entry isolation.

clear() classmethod

Remove all entries (useful in tests).

contains(key) classmethod

Check whether key is registered.

Résout une entrée paresseuse : répondre « oui » puis échouer à la créer serait pire que de payer l'import ici. L'appelant qui pose la question sur cette clé précise est justement celui qui va s'en servir.

create(key, *args, **kwargs) classmethod

Look up key and instantiate it with the given arguments.

get(key) classmethod

Retrieve the entry for key, raising KeyError if missing.

items() classmethod

Return all (key, entry) pairs as a tuple.

keys() classmethod

Return all registered keys as a tuple.

register(key) classmethod

Decorator that registers entry under key.

register_lazy(key, module) classmethod

Déclarer key sans charger son module.

Importer un moteur « pour déclencher son enregistrement » fait payer ses dépendances à TOUT LE MONDE, y compris à qui ne s'en servira jamais. MESURÉ : charger colbert_backend ou faiss_backend tirait torch et numpy — puis échouait sur une dépendance absente, et l'échec était avalé. Le coût restait, pas le moteur. Or un numpy cassé fait alors tomber diapason serve au démarrage, pour un moteur que personne n'a demandé.

Le module n'est donc chargé qu'à la première question portant sur cette clé.

register_value(key, value) classmethod

Imperatively register a value under key.

RouterPolicyRegistry

Bases: RegistryBase[Any]

Registry for router policy implementations.

SkillRegistry

Bases: RegistryBase[Any]

Registry for skill manifests.

SpeechRegistry

Bases: RegistryBase[Any]

Registry for speech backend implementations.

TTSRegistry

Bases: RegistryBase[Any]

Registry for text-to-speech backend implementations.

ToolRegistry

Bases: RegistryBase[Any]

Registry for tool specifications.