Skip to main content

Function: resolveProviderOrder()

resolveProviderOrder(available, preferences?): string[]

Defined in: packages/agentos/src/io/media/ProviderPreferences.ts:129

Filter and reorder an "available" provider list according to user preferences.

Resolution rules (applied in order):

  1. If preferences is undefined or empty, return available unchanged.
  2. If preferred is set, keep only providers that appear in both available and preferred, preserving the order of preferred.
  3. If blocked is set, remove any provider whose ID appears in blocked.

The result is never longer than available and never contains duplicates.

Parameters​

available​

string[]

Provider IDs currently available in the system.

preferences?​

MediaProviderPreference

Optional preference configuration.

Returns​

string[]

Filtered and reordered provider ID list.

Example​

resolveProviderOrder(['a', 'b', 'c'], { preferred: ['c', 'a'] });
// => ['c', 'a']

resolveProviderOrder(['a', 'b', 'c'], { blocked: ['b'] });
// => ['a', 'c']