BundleModelProvider

Adapter that exposes one or more LoadedBundles through the existing ksl.simulation.ModelProviderIfc contract used by KSLAppSession. This lets callers that today take a ModelProviderIfc (such as the four reference Swing apps) consume bundle-supplied models without any change to the interaction-layer API.

Model identifiers are flattened across all wrapped bundles: each KSLBundledModel.modelId becomes a top-level identifier in this provider. When two bundles ship a model with the same modelId, the first wins and a warning is logged; the global key in the substrate is the pair (bundleId, modelId), but this adapter exposes only the bare modelId because that is what ModelProviderIfc callers know. Hosted consumers that need to disambiguate (a future REST or MCP runtime) should consume bundles directly rather than through this adapter.

The iteration order of modelIdentifiers is deterministic: it follows the constructor's bundle order, then within each bundle the declared models order. Callers may rely on this for stable picker layouts.

In addition to the ModelProviderIfc surface, this class exposes builderFor(modelIdentifier), returning the underlying ksl.simulation.ModelBuilderIfc. This is needed by callers (for example ksl.controls.experiments.ParallelDesignedExperiment) that must construct many models from one builder rather than receive a single built model. The base interface intentionally does not expose a builder, so callers needing one must hold a typed reference to BundleModelProvider.