Skip to main content

Class: PolicyAwareImageRouter

Defined in: packages/agentos/src/io/media/images/PolicyAwareImageRouter.ts:59

Policy-aware image provider router. Selects the preferred image generation provider and model based on the session's content policy tier.

Constructors​

Constructor​

new PolicyAwareImageRouter(catalog): PolicyAwareImageRouter

Defined in: packages/agentos/src/io/media/images/PolicyAwareImageRouter.ts:65

Parameters​

catalog​

UncensoredModelCatalog

Uncensored model catalog for mature/private-adult lookup.

Returns​

PolicyAwareImageRouter

Methods​

getPreferredProvider()​

getPreferredProvider(policyTier, capabilities?): ImageProviderPreference | null

Defined in: packages/agentos/src/io/media/images/PolicyAwareImageRouter.ts:76

Get the preferred image provider and model for a given policy tier.

Parameters​

policyTier​

PolicyTier

Content policy tier.

capabilities?​

string[]

Optional required capabilities (e.g. ['face-consistency']).

Returns​

ImageProviderPreference | null

Provider preference, or null for safe/standard tiers.


getProviderChain()​

getProviderChain(policyTier, capabilities?): string[]

Defined in: packages/agentos/src/io/media/images/PolicyAwareImageRouter.ts:113

Get the ordered provider chain for a given policy tier, optionally filtered by required capabilities.

Safe/standard returns the default chain (OpenAI-first). Mature/private-adult returns the uncensored chain (Replicate-first).

When capabilities is provided, only providers supporting ALL listed capabilities are included. Known capabilities:

  • 'character-consistency' — Replicate (Pulid, IP-Adapter), Fal (IP-Adapter), SD-Local (ControlNet)
  • 'controlnet' — Replicate (Canny, Depth), SD-Local (ControlNet extensions)
  • 'style-transfer' — Replicate and Fal (FLUX.2), Stability (its style-transfer endpoint), OpenAI (two-image edits): the providers whose transferStyle sends both images

Parameters​

policyTier​

PolicyTier

Content policy tier.

capabilities?​

string[]

Optional required capabilities to filter the chain.

Returns​

string[]

Ordered array of provider IDs to try in sequence.