Class EngineBuilder
Namespace: Cephalon.Engine.Composition
Assembly: Cephalon.Engine.dll
Builds a Cephalon runtime by composing the application model, module set, and policy inputs
into a single
public sealed class EngineBuilderInheritance
Section titled “Inheritance”Inherited Members
Section titled “Inherited Members”object.Equals(object?), object.Equals(object?, object?), object.GetHashCode(), object.GetType(), object.ReferenceEquals(object?, object?), object.ToString()
Extension Methods
Section titled “Extension Methods”AgenticEngineBuilderExtensions.AddAgentics(EngineBuilder, Action<AgenticRuntimeOptions>?), AuditEngineBuilderExtensions.AddAudit(EngineBuilder, Action<AuditRuntimeOptions>?), BehaviorEventingEngineBuilderExtensions.AddBehaviorEventingBridge(EngineBuilder), BehaviorEngineBuilderExtensions.AddBehaviors(EngineBuilder, Action<IBehaviorCollectionBuilder>?), BehaviorEngineBuilderExtensions.AddBehaviors(EngineBuilder, Action<BehaviorOptions>?, Action<IBehaviorCollectionBuilder>?), ClickHouseDataEngineBuilderExtensions.AddClickHouseData(EngineBuilder, string, string, Action<ClickHouseDataOptions>?), DataEngineBuilderExtensions.AddData(EngineBuilder, Action<DataRuntimeOptions>?), DebeziumDataEngineBuilderExtensions.AddDebeziumData(EngineBuilder, Action<DebeziumDataOptions>), EdgeEngineBuilderExtensions.AddEdge(EngineBuilder, Action<EdgeRuntimeOptions>?), ElasticsearchDataEngineBuilderExtensions.AddElasticsearchData(EngineBuilder, string, Action<ElasticsearchDataOptions>?), ElasticsearchDataEngineBuilderExtensions.AddElasticsearchData(EngineBuilder, Action<ElasticsearchDataOptions>), EntityFrameworkAuditHistoryEngineBuilderExtensions.AddEntityFrameworkAuditHistory<TDbContext>(EngineBuilder, Action<DbContextOptionsBuilder>, Action<EntityFrameworkAuditHistoryOptions>?), EntityFrameworkAuditHistoryEngineBuilderExtensions.AddEntityFrameworkAuditHistory<TDbContext>(EngineBuilder, Action<EntityFrameworkDatabaseRoleContext, DbContextOptionsBuilder>, Action<EntityFrameworkAuditHistoryOptions>?), EntityFrameworkDataEngineBuilderExtensions.AddEntityFrameworkData<TDbContext>(EngineBuilder, Action<DbContextOptionsBuilder>, Action<EntityFrameworkDataOptions>?), EntityFrameworkDataEngineBuilderExtensions.AddEntityFrameworkData<TDbContext>(EngineBuilder, Action<EntityFrameworkDatabaseRoleContext, DbContextOptionsBuilder>, Action<EntityFrameworkDataOptions>?), EntityFrameworkDataEngineBuilderExtensions.AddEntityFrameworkData<TReadDbContext, TWriteDbContext>(EngineBuilder, Action<DbContextOptionsBuilder>, Action<DbContextOptionsBuilder>, Action<EntityFrameworkDataOptions>?), EntityFrameworkDataEngineBuilderExtensions.AddEntityFrameworkData<TReadDbContext, TWriteDbContext>(EngineBuilder, Action<EntityFrameworkDatabaseRoleContext, DbContextOptionsBuilder>, Action<EntityFrameworkDataOptions>?), EntityFrameworkEventSourcingEngineBuilderExtensions.AddEntityFrameworkEventSourcing<TContext>(EngineBuilder), EventSourcingEngineBuilderExtensions.AddEventSourcing(EngineBuilder, Action<EventSourcingOptions>?), EventingEngineBuilderExtensions.AddEventing(EngineBuilder, Action<EventingOptions>?), IdentityEngineBuilderExtensions.AddIdentityAccess(EngineBuilder, Action<IdentityRuntimeOptions>?), KubernetesGatewayEngineBuilderExtensions.AddKubernetesGatewayTrafficMaterializer(EngineBuilder, Action<KubernetesGatewayTrafficMaterializerOptions>?), MongoDbDataEngineBuilderExtensions.AddMongoDbData(EngineBuilder, string, string, Action<MongoDbDataOptions>?), MongoDbDataEngineBuilderExtensions.AddMongoDbData(EngineBuilder, Action<MongoDbDataOptions>), MultiTenancyEngineBuilderExtensions.AddMultiTenancy(EngineBuilder, Action<MultiTenancyRuntimeOptions>?), MultiTenancyGovernanceEngineBuilderExtensions.AddMultiTenancyGovernance(EngineBuilder, Action<MultiTenancyGovernanceOptions>?), NatsDataEngineBuilderExtensions.AddNatsData(EngineBuilder, string, Action<NatsDataOptions>?), NatsDataEngineBuilderExtensions.AddNatsData(EngineBuilder, Action<NatsDataOptions>), Neo4jDataEngineBuilderExtensions.AddNeo4jData(EngineBuilder, string, string, string, Action<Neo4jDataOptions>?), Neo4jDataEngineBuilderExtensions.AddNeo4jData(EngineBuilder, Action<Neo4jDataOptions>), OpenSearchDataEngineBuilderExtensions.AddOpenSearchData(EngineBuilder, string, Action<OpenSearchDataOptions>?), OpenSearchDataEngineBuilderExtensions.AddOpenSearchData(EngineBuilder, Action<OpenSearchDataOptions>), PostgresDataEngineBuilderExtensions.AddPostgresData(EngineBuilder, string, string, Action<PostgresDataOptions>?), PostgresDataEngineBuilderExtensions.AddPostgresData(EngineBuilder, Action<PostgresDataOptions>), QdrantDataEngineBuilderExtensions.AddQdrantData(EngineBuilder, string, int, Action<QdrantDataOptions>?), RedisDataEngineBuilderExtensions.AddRedisData(EngineBuilder, string, Action<RedisDataOptions>?), RedisDataEngineBuilderExtensions.AddRedisData(EngineBuilder, Action<RedisDataOptions>), RetrievalEngineBuilderExtensions.AddRetrieval(EngineBuilder, Action<RetrievalOptions>?), SfidEngineBuilderExtensions.AddSfidIds(EngineBuilder, Action<SfidIdOptions>?), TraefikEngineBuilderExtensions.AddTraefikTrafficMaterializer(EngineBuilder, Action<TraefikTrafficMaterializerOptions>?), WolverineEventingEngineBuilderExtensions.AddWolverineEventing(EngineBuilder, Action<WolverineEventingOptions>?)
Remarks
Section titled “Remarks”
At build time the builder resolves discovery inputs, package loading, application profile selection, localization, trust policy, failure policy, and capability filtering into a deterministic runtime snapshot.
Constructors
Section titled “Constructors”EngineBuilder(IServiceCollection)
Section titled “ EngineBuilder(IServiceCollection)”Creates a new builder over the supplied service collection.
public EngineBuilder(IServiceCollection services)Parameters
Section titled “Parameters”services IServiceCollection
The service collection that receives runtime services, catalogs, policies, and module- or technology-provided registrations.
Properties
Section titled “Properties”Services
Section titled “ Services”Gets the service collection that the builder mutates while composing the engine.
public IServiceCollection Services { get; }Property Value
Section titled “Property Value”Methods
Section titled “Methods”AddBackendForFrontendClientBinding(BackendForFrontendClientBindingDescriptor)
Section titled “ AddBackendForFrontendClientBinding(BackendForFrontendClientBindingDescriptor)”Adds a backend-for-frontend client binding to the current runtime composition.
public EngineBuilder AddBackendForFrontendClientBinding(BackendForFrontendClientBindingDescriptor binding)Parameters
Section titled “Parameters”binding BackendForFrontendClientBindingDescriptor
The client binding descriptor to add.
Returns
Section titled “Returns”The same builder instance.
AddBackendForFrontendClientBindings(IEnumerable<BackendForFrontendClientBindingDescriptor>)
Section titled “ AddBackendForFrontendClientBindings(IEnumerable<BackendForFrontendClientBindingDescriptor>)”Adds multiple backend-for-frontend client bindings to the current runtime composition.
public EngineBuilder AddBackendForFrontendClientBindings(IEnumerable<BackendForFrontendClientBindingDescriptor> bindings)Parameters
Section titled “Parameters”bindings IEnumerable<BackendForFrontendClientBindingDescriptor>
The client binding descriptors to add.
Returns
Section titled “Returns”The same builder instance.
AddCdcCapture(CdcCaptureDescriptor)
Section titled “ AddCdcCapture(CdcCaptureDescriptor)”Adds a CDC capture to the current runtime composition.
public EngineBuilder AddCdcCapture(CdcCaptureDescriptor cdcCapture)Parameters
Section titled “Parameters”cdcCapture CdcCaptureDescriptor
The CDC capture descriptor to add.
Returns
Section titled “Returns”The same builder instance.
AddCdcCaptures(IEnumerable<CdcCaptureDescriptor>)
Section titled “ AddCdcCaptures(IEnumerable<CdcCaptureDescriptor>)”Adds multiple CDC captures to the current runtime composition.
public EngineBuilder AddCdcCaptures(IEnumerable<CdcCaptureDescriptor> cdcCaptures)Parameters
Section titled “Parameters”cdcCaptures IEnumerable<CdcCaptureDescriptor>
The CDC capture descriptors to add.
Returns
Section titled “Returns”The same builder instance.
AddCellBoundaries(IEnumerable<CellBoundaryDescriptor>)
Section titled “ AddCellBoundaries(IEnumerable<CellBoundaryDescriptor>)”Adds multiple cell boundaries to the current runtime composition.
public EngineBuilder AddCellBoundaries(IEnumerable<CellBoundaryDescriptor> cellBoundaries)Parameters
Section titled “Parameters”cellBoundaries IEnumerable<CellBoundaryDescriptor>
The cell-boundary descriptors to add.
Returns
Section titled “Returns”The same builder instance.
AddCellBoundary(CellBoundaryDescriptor)
Section titled “ AddCellBoundary(CellBoundaryDescriptor)”Adds a cell boundary to the current runtime composition.
public EngineBuilder AddCellBoundary(CellBoundaryDescriptor cellBoundary)Parameters
Section titled “Parameters”cellBoundary CellBoundaryDescriptor
The cell-boundary descriptor to add.
Returns
Section titled “Returns”The same builder instance.
AddCellHealthIsolation(CellHealthIsolationDescriptor)
Section titled “ AddCellHealthIsolation(CellHealthIsolationDescriptor)”Adds a cell health-isolation answer to the current runtime composition.
public EngineBuilder AddCellHealthIsolation(CellHealthIsolationDescriptor healthIsolation)Parameters
Section titled “Parameters”healthIsolation CellHealthIsolationDescriptor
The cell health-isolation descriptor to add.
Returns
Section titled “Returns”The same builder instance.
AddCellHealthIsolations(IEnumerable<CellHealthIsolationDescriptor>)
Section titled “ AddCellHealthIsolations(IEnumerable<CellHealthIsolationDescriptor>)”Adds multiple cell health-isolation answers to the current runtime composition.
public EngineBuilder AddCellHealthIsolations(IEnumerable<CellHealthIsolationDescriptor> healthIsolations)Parameters
Section titled “Parameters”healthIsolations IEnumerable<CellHealthIsolationDescriptor>
The cell health-isolation descriptors to add.
Returns
Section titled “Returns”The same builder instance.
AddCellRoute(CellRouteDescriptor)
Section titled “ AddCellRoute(CellRouteDescriptor)”Adds a cell route to the current runtime composition.
public EngineBuilder AddCellRoute(CellRouteDescriptor cellRoute)Parameters
Section titled “Parameters”cellRoute CellRouteDescriptor
The cell-route descriptor to add.
Returns
Section titled “Returns”The same builder instance.
AddCellRoutes(IEnumerable<CellRouteDescriptor>)
Section titled “ AddCellRoutes(IEnumerable<CellRouteDescriptor>)”Adds multiple cell routes to the current runtime composition.
public EngineBuilder AddCellRoutes(IEnumerable<CellRouteDescriptor> cellRoutes)Parameters
Section titled “Parameters”cellRoutes IEnumerable<CellRouteDescriptor>
The cell-route descriptors to add.
Returns
Section titled “Returns”The same builder instance.
AddFeatureFlag(FeatureFlagDescriptor)
Section titled “ AddFeatureFlag(FeatureFlagDescriptor)”Adds a feature flag to the current runtime composition.
public EngineBuilder AddFeatureFlag(FeatureFlagDescriptor featureFlag)Parameters
Section titled “Parameters”featureFlag FeatureFlagDescriptor
The feature-flag descriptor to add.
Returns
Section titled “Returns”The same builder instance.
AddFeatureFlagProvider<TProvider>()
Section titled “ AddFeatureFlagProvider<TProvider>()”Registers one feature-flag provider in the engine service collection.
public EngineBuilder AddFeatureFlagProvider<TProvider>() where TProvider : class, IFeatureFlagProviderReturns
Section titled “Returns”The same builder instance.
Type Parameters
Section titled “Type Parameters”TProvider
The provider implementation type.
AddFeatureFlagProvider(IFeatureFlagProvider)
Section titled “ AddFeatureFlagProvider(IFeatureFlagProvider)”Registers one feature-flag provider instance in the engine service collection.
public EngineBuilder AddFeatureFlagProvider(IFeatureFlagProvider provider)Parameters
Section titled “Parameters”provider IFeatureFlagProvider
The provider instance to register.
Returns
Section titled “Returns”The same builder instance.
AddFeatureFlagProviders(IEnumerable<IFeatureFlagProvider>)
Section titled “ AddFeatureFlagProviders(IEnumerable<IFeatureFlagProvider>)”Registers multiple feature-flag provider instances in the engine service collection.
public EngineBuilder AddFeatureFlagProviders(IEnumerable<IFeatureFlagProvider> providers)Parameters
Section titled “Parameters”providers IEnumerable<IFeatureFlagProvider>
The provider instances to register.
Returns
Section titled “Returns”The same builder instance.
AddFeatureFlags(IEnumerable<FeatureFlagDescriptor>)
Section titled “ AddFeatureFlags(IEnumerable<FeatureFlagDescriptor>)”Adds multiple feature flags to the current runtime composition.
public EngineBuilder AddFeatureFlags(IEnumerable<FeatureFlagDescriptor> featureFlags)Parameters
Section titled “Parameters”featureFlags IEnumerable<FeatureFlagDescriptor>
The feature-flag descriptors to add.
Returns
Section titled “Returns”The same builder instance.
AddLanguageResources(string, IReadOnlyDictionary<string, string>)
Section titled “ AddLanguageResources(string, IReadOnlyDictionary<string, string>)”Adds resource overrides for a specific culture without replacing the existing localization contract.
public EngineBuilder AddLanguageResources(string culture, IReadOnlyDictionary<string, string> resources)Parameters
Section titled “Parameters”culture string
The culture name to extend, such as en or th-TH.
resources IReadOnlyDictionary<string, string>
The key/value resource set to merge for that culture.
Returns
Section titled “Returns”The same builder instance.
Remarks
Section titled “Remarks”This method is typically used by hosts that want to layer project-owned localization on top of engine defaults and any package-provided language packs.
AddModule<TModule>()
Section titled “ AddModule<TModule>()”Adds a module by type using its parameterless constructor.
public EngineBuilder AddModule<TModule>() where TModule : class, IModule, new()Returns
Section titled “Returns”The same builder instance.
Type Parameters
Section titled “Type Parameters”TModule
The concrete module type to instantiate and register.
AddModule(IModule)
Section titled “ AddModule(IModule)”Adds a concrete module instance to the runtime composition graph.
public EngineBuilder AddModule(IModule module)Parameters
Section titled “Parameters”module IModule
The module instance to register.
Returns
Section titled “Returns”The same builder instance.
AddModulesFromAssemblies(IEnumerable<Assembly>, Func<Type, bool>?)
Section titled “ AddModulesFromAssemblies(IEnumerable<Assembly>, Func<Type, bool>?)”Discovers and adds modules from a sequence of assemblies.
public EngineBuilder AddModulesFromAssemblies(IEnumerable<Assembly> assemblies, Func<Type, bool>? filter = null)Parameters
Section titled “Parameters”assemblies IEnumerable<Assembly>
The assemblies to scan for modules.
An optional predicate that can opt specific candidate types in or out before they are instantiated.
Returns
Section titled “Returns”The same builder instance.
AddModulesFromAssembly(Assembly, Func<Type, bool>?)
Section titled “ AddModulesFromAssembly(Assembly, Func<Type, bool>?)”Discovers and adds modules from an assembly.
public EngineBuilder AddModulesFromAssembly(Assembly assembly, Func<Type, bool>? filter = null)Parameters
Section titled “Parameters”assembly Assembly
The assembly to scan.
An optional predicate that can opt specific candidate types in or out before they are instantiated.
Returns
Section titled “Returns”The same builder instance.
AddModulesFromAssemblyContaining<TMarker>(Func<Type, bool>?)
Section titled “ AddModulesFromAssemblyContaining<TMarker>(Func<Type, bool>?)”Discovers and adds modules from the assembly that contains TMarker.
public EngineBuilder AddModulesFromAssemblyContaining<TMarker>(Func<Type, bool>? filter = null)Parameters
Section titled “Parameters”An optional predicate that can opt specific candidate types in or out before they are instantiated.
Returns
Section titled “Returns”The same builder instance.
Type Parameters
Section titled “Type Parameters”TMarker
A type used only to identify the source assembly.
AddPackage(ModulePackageReference)
Section titled “ AddPackage(ModulePackageReference)”Adds an explicit package reference to the builder.
public EngineBuilder AddPackage(ModulePackageReference package)Parameters
Section titled “Parameters”package ModulePackageReference
The package reference to register.
Returns
Section titled “Returns”The same builder instance.
AddPackageAssembly(string, string?)
Section titled “ AddPackageAssembly(string, string?)”Adds a package reference that points directly to a module assembly.
public EngineBuilder AddPackageAssembly(string path, string? id = null)Parameters
Section titled “Parameters”path string
The path to the package assembly.
id string?
An optional stable package identifier. When omitted, the identifier is derived from the reference.
Returns
Section titled “Returns”The same builder instance.
AddPackageDirectories(IEnumerable<ModulePackageDirectory>)
Section titled “ AddPackageDirectories(IEnumerable<ModulePackageDirectory>)”Adds multiple package-directory discovery rules.
public EngineBuilder AddPackageDirectories(IEnumerable<ModulePackageDirectory> directories)Parameters
Section titled “Parameters”directories IEnumerable<ModulePackageDirectory>
The package directories to register.
Returns
Section titled “Returns”The same builder instance.
AddPackageDirectory(string, string?, bool)
Section titled “ AddPackageDirectory(string, string?, bool)”Adds a directory that should be scanned for package manifests.
public EngineBuilder AddPackageDirectory(string path, string? manifestFileName = null, bool includeSubdirectories = true)Parameters
Section titled “Parameters”path string
The directory path to scan.
manifestFileName string?
The manifest file name to search for. When omitted, the engine uses the default package manifest name.
includeSubdirectories bool
true to recurse into child directories; otherwise only the top-level directory is scanned.
Returns
Section titled “Returns”The same builder instance.
AddPackageDirectory(ModulePackageDirectory)
Section titled “ AddPackageDirectory(ModulePackageDirectory)”Adds a package-directory discovery rule to the builder.
public EngineBuilder AddPackageDirectory(ModulePackageDirectory directory)Parameters
Section titled “Parameters”directory ModulePackageDirectory
The directory discovery descriptor to register.
Returns
Section titled “Returns”The same builder instance.
AddPackageManifest(string, string?)
Section titled “ AddPackageManifest(string, string?)”Adds a package by its cephalon.package.json manifest file.
public EngineBuilder AddPackageManifest(string manifestPath, string? id = null)Parameters
Section titled “Parameters”manifestPath string
The path to the package manifest file.
id string?
An optional stable package identifier. When omitted, the identifier is resolved from the manifest.
Returns
Section titled “Returns”The same builder instance.
AddPackages(IEnumerable<ModulePackageReference>)
Section titled “ AddPackages(IEnumerable<ModulePackageReference>)”Adds multiple explicit package references.
public EngineBuilder AddPackages(IEnumerable<ModulePackageReference> packages)Parameters
Section titled “Parameters”packages IEnumerable<ModulePackageReference>
The package references to register.
Returns
Section titled “Returns”The same builder instance.
AddPattern(PatternDescriptor)
Section titled “ AddPattern(PatternDescriptor)”Adds an application or design pattern to the current app profile.
public EngineBuilder AddPattern(PatternDescriptor pattern)Parameters
Section titled “Parameters”pattern PatternDescriptor
The pattern descriptor to add.
Returns
Section titled “Returns”The same builder instance.
AddStranglerFigRoute(StranglerFigRouteDescriptor)
Section titled “ AddStranglerFigRoute(StranglerFigRouteDescriptor)”Adds a strangler-fig route to the current runtime composition.
public EngineBuilder AddStranglerFigRoute(StranglerFigRouteDescriptor route)Parameters
Section titled “Parameters”route StranglerFigRouteDescriptor
The route descriptor to add.
Returns
Section titled “Returns”The same builder instance.
AddStranglerFigRoutes(IEnumerable<StranglerFigRouteDescriptor>)
Section titled “ AddStranglerFigRoutes(IEnumerable<StranglerFigRouteDescriptor>)”Adds multiple strangler-fig routes to the current runtime composition.
public EngineBuilder AddStranglerFigRoutes(IEnumerable<StranglerFigRouteDescriptor> routes)Parameters
Section titled “Parameters”routes IEnumerable<StranglerFigRouteDescriptor>
The route descriptors to add.
Returns
Section titled “Returns”The same builder instance.
AddTechnology(TechnologyDescriptor)
Section titled “ AddTechnology(TechnologyDescriptor)”Selects a technology profile for the current app profile.
public EngineBuilder AddTechnology(TechnologyDescriptor technology)Parameters
Section titled “Parameters”technology TechnologyDescriptor
The technology descriptor to activate.
Returns
Section titled “Returns”The same builder instance.
AddTransport(TransportDescriptor)
Section titled “ AddTransport(TransportDescriptor)”Adds a transport to the current app profile selection.
public EngineBuilder AddTransport(TransportDescriptor transport)Parameters
Section titled “Parameters”transport TransportDescriptor
The transport descriptor to add.
Returns
Section titled “Returns”The same builder instance.
Build()
Section titled “ Build()”Materializes the configured engine into a runnable
public EngineRuntime Build()Returns
Section titled “Returns”The fully built runtime.
Remarks
Section titled “Remarks”Build is the point where Cephalon becomes deterministic. The builder validates duplicate modules, resolves package-loaded assemblies, orders modules by dependency, applies capability and trust policy, creates the runtime manifest, and registers the runtime-facing catalogs used by hosts and tooling.
Exceptions
Section titled “Exceptions”Thrown when the configured module graph, package inputs, trust policy, transport selection, or technology selection is invalid.
RegisterTechnology(TechnologyDescriptor)
Section titled “ RegisterTechnology(TechnologyDescriptor)”Registers a technology descriptor in the available catalog without implicitly selecting it.
public EngineBuilder RegisterTechnology(TechnologyDescriptor technology)Parameters
Section titled “Parameters”technology TechnologyDescriptor
The technology descriptor to register.
Returns
Section titled “Returns”The same builder instance.
Remarks
Section titled “Remarks”This is useful when a project wants to extend the catalog and let configuration decide whether the technology is active.
UseBackendForFrontendSettings(BackendForFrontendSettings)
Section titled “ UseBackendForFrontendSettings(BackendForFrontendSettings)”Replaces the backend-for-frontend settings used by the runtime client-binding catalog.
public EngineBuilder UseBackendForFrontendSettings(BackendForFrontendSettings settings)Parameters
Section titled “Parameters”settings BackendForFrontendSettings
The backend-for-frontend settings to apply.
Returns
Section titled “Returns”The same builder instance.
UseBlueprint(AppBlueprint)
Section titled “ UseBlueprint(AppBlueprint)”Selects the base application blueprint that should shape the runtime.
public EngineBuilder UseBlueprint(AppBlueprint blueprint)Parameters
Section titled “Parameters”blueprint AppBlueprint
The blueprint descriptor to activate.
Returns
Section titled “Returns”The same builder instance.
UseCellSettings(CellSettings)
Section titled “ UseCellSettings(CellSettings)”Replaces the cell-based architecture settings used by the runtime cell catalogs.
public EngineBuilder UseCellSettings(CellSettings settings)Parameters
Section titled “Parameters”settings CellSettings
The cell settings to apply.
Returns
Section titled “Returns”The same builder instance.
UseConfiguration(IConfiguration, string)
Section titled “ UseConfiguration(IConfiguration, string)”Reads engine settings from configuration and merges them into the current builder state.
public EngineBuilder UseConfiguration(IConfiguration configuration, string sectionPath = "Engine")Parameters
Section titled “Parameters”configuration IConfiguration
The root configuration that contains the engine section.
sectionPath string
The configuration path that should be interpreted as the engine settings section.
The default value is
Returns
Section titled “Returns”The same builder instance.
Remarks
Section titled “Remarks”This method is the preferred entry point when a host should stay configuration-driven. It binds the selected blueprint, transports, technologies, options, localization, trust policy, failure policy, and discovery settings before any code-level overrides are applied.
UseFailurePolicy(FailurePolicy)
Section titled “ UseFailurePolicy(FailurePolicy)”Replaces the failure policy used by the runtime lifecycle state machine.
public EngineBuilder UseFailurePolicy(FailurePolicy policy)Parameters
Section titled “Parameters”policy FailurePolicy
The lifecycle failure policy to apply.
Returns
Section titled “Returns”The same builder instance.
UseFeatureSettings(FeatureSettings)
Section titled “ UseFeatureSettings(FeatureSettings)”Merges feature-flag settings into the current builder state.
public EngineBuilder UseFeatureSettings(FeatureSettings settings)Parameters
Section titled “Parameters”settings FeatureSettings
The feature-flag settings to merge.
Returns
Section titled “Returns”The same builder instance.
UseLocalization(LocalizationSettings)
Section titled “ UseLocalization(LocalizationSettings)”Merges localization settings into the current builder state.
public EngineBuilder UseLocalization(LocalizationSettings settings)Parameters
Section titled “Parameters”settings LocalizationSettings
The localization settings to merge, including default culture, supported cultures, and per-culture resource overrides.
Returns
Section titled “Returns”The same builder instance.
UseMigrationSettings(MigrationSettings)
Section titled “ UseMigrationSettings(MigrationSettings)”Replaces the migration-policy settings used by the runtime migration catalogs.
public EngineBuilder UseMigrationSettings(MigrationSettings migration)Parameters
Section titled “Parameters”migration MigrationSettings
The migration settings to apply.
Returns
Section titled “Returns”The same builder instance.
UseOptions(EngineOptions)
Section titled “ UseOptions(EngineOptions)”Merges engine option overrides such as module enablement and capability toggles.
public EngineBuilder UseOptions(EngineOptions options)Parameters
Section titled “Parameters”options EngineOptions
The option overrides to merge.
Returns
Section titled “Returns”The same builder instance.
UsePackagePolicy(PackagePolicy)
Section titled “ UsePackagePolicy(PackagePolicy)”Replaces the package-governance policy used when loading independently shipped module packages.
public EngineBuilder UsePackagePolicy(PackagePolicy policy)Parameters
Section titled “Parameters”policy PackagePolicy
The package policy to apply.
Returns
Section titled “Returns”The same builder instance.
UseSettings(EngineSettings)
Section titled “ UseSettings(EngineSettings)”Applies a preconstructed
public EngineBuilder UseSettings(EngineSettings settings)Parameters
Section titled “Parameters”settings EngineSettings
The settings object to merge into the current builder state.
Returns
Section titled “Returns”The same builder instance.
Remarks
Section titled “Remarks”Discovery settings are resolved eagerly, which means referenced assemblies or package manifests are validated before the runtime is built.
UseTrustPolicy(TrustPolicy)
Section titled “ UseTrustPolicy(TrustPolicy)”Merges trust and capability-governance settings into the builder.
public EngineBuilder UseTrustPolicy(TrustPolicy policy)Parameters
Section titled “Parameters”policy TrustPolicy
The trust policy to apply.
Returns
Section titled “Returns”The same builder instance.