install abstract method

Future<void> install(ModelSource source, { CancelToken? cancelToken, String? targetFilename, })

Installs the model from the given source

This method performs the actual installation:

• NetworkSource: downloads from URL
• AssetSource: copies from Flutter assets
• BundledSource: accesses native resources
• FileSource: registers external file path

Parameters:

• source: The model source to install from
• cancelToken: Optional token for cancelling the installation
• targetFilename: Optional override for the installed file's identity (write-target basename, ModelInfo.id, and — on web — the registration/cache key). Defaults to null, which reproduces today's behavior: the basename is derived from source (URL path segment / asset path / bundled resource name / file path). Passed by the four *InstallationBuilders so a companion file's on-disk identity can be namespaced by its owning model (see docs/superpowers/specs/2026-08-02-install-identity-namespacing-design.md).

Throws:

• UnsupportedError if this handler doesn't support the source type
• ArgumentError if the source is invalid
• DownloadCancelledException if cancelled via cancelToken
• Platform-specific exceptions for download/file errors

Implementation

Future<void> install(
  ModelSource source, {
  CancelToken? cancelToken,
  String? targetFilename,
});