Runtime Capability Catalog

LiteBus runtime capabilities define the compose-time module graph and the in-process messaging engine used by mediator, durable, transport, and hosting axes. Runtime and messaging stay container-neutral and host-neutral by design.

Axis Scope

Module composition contracts (IModule, IModuleRegistry, IModuleConfiguration)
Dependency registration abstraction (IDependencyRegistry)
Shared messaging foundations (MessageModule, message and contract registries)
Core mediation engine (descriptor resolution, strategy execution, scoped dispatch)
Durable metadata mapping and payload handling primitives (serialization, trace metadata, payload encryption hook)

Packages

Package	Dependency role	Purpose
`LiteBus.Runtime.Abstractions`	Platform contracts	Module, registry, dependency, dispatch-scope, and runtime exception contracts
`LiteBus.Runtime`	Core implementation	Default module registry, module configuration, dependency registry, and advanced builder
`LiteBus.Messaging.Abstractions`	Mediation contracts	Messaging contracts, descriptors, and mediation requests
`LiteBus.Messaging`	Core implementation	Message module, mediator engine, registries, serializer, and metadata mapper

Capabilities (18)

ID	Name	Maturity	Package(s)
runtime.modules	Module contract	GA	`LiteBus.Runtime.Abstractions`
runtime.module-registry	Module registry and build order	GA	`LiteBus.Runtime`
runtime.module-dependencies	Module dependency ordering	GA	`LiteBus.Runtime`, `LiteBus.Runtime.Abstractions`
runtime.module-configuration	Module configuration and shared context	GA	`LiteBus.Runtime`
runtime.composite-modules	Composite parent and child modules	GA	`LiteBus.Runtime`, `LiteBus.Runtime.Abstractions`
runtime.litebus-builder	Composition builder surface	GA	`LiteBus.Runtime.Abstractions`, `LiteBus.Runtime`
runtime.dependency-registry	Container-neutral dependency registry	GA	`LiteBus.Runtime`
runtime.message-module	Foundational messaging module	GA	`LiteBus.Messaging`
runtime.message-registry	Message and handler type registry	GA	`LiteBus.Messaging`, `LiteBus.Messaging.Abstractions`
runtime.contract-registry	Message contract registry	GA	`LiteBus.Messaging`, `LiteBus.Messaging.Abstractions`
runtime.message-mediator	Core message mediator	GA	`LiteBus.Messaging`
runtime.mediation-strategies	Pluggable mediation strategies	GA	`LiteBus.Messaging`, `LiteBus.Messaging.Abstractions`
runtime.handler-descriptors	Handler descriptor model	GA	`LiteBus.Messaging.Abstractions`
runtime.message-resolution	Message resolve strategies	GA	`LiteBus.Messaging`
runtime.dispatch-scopes	Per-mediation DI scopes	GA	`LiteBus.Runtime.Abstractions`, runtime DI adapters, `LiteBus.Messaging`
runtime.message-serialization	Message serialization	GA	`LiteBus.Messaging`
runtime.payload-protection	Payload encryption hook	GA	`LiteBus.Messaging`, `LiteBus.Messaging.Abstractions`
runtime.trace-metadata	Trace metadata and propagation	GA	`LiteBus.Messaging.Abstractions`, `LiteBus.Messaging`

Runtime and Messaging Flow

AddLiteBus(...)
  -> modules register in IModuleRegistry
  -> BuildOrder() computes topological order and freezes registry
  -> each module Build(IModuleConfiguration) runs in order
  -> MessageModule creates IMessageRegistry and IMessageContractRegistry contexts
  -> mediator resolves message descriptor and handlers from scoped provider
  -> strategy executes pre/main/post/error pipeline

Test Sources

Area	Primary test projects
Module contracts, registry ordering, dependency registry, builder, module configuration	`LiteBus.Runtime.UnitTests`
Messaging registry, mediator behavior, resolution strategy, open generics, context propagation	`LiteBus.Mediator.UnitTests`

Cross-Axis Links

Runtime module ordering in this axis: runtime.module-registry
Host manifest bridge of the same ordering output: hosting.module-registry
Architecture context: Architecture
Extensibility guidance: Extensibility