Class CostAwareRouter

Cost-aware routing — wraps standard SPARQL routing with budget-biased tier selection.

When budget utilisation is below softLimitRatio: routes normally (all tiers). When at or above softLimitRatio: prefers ECONOMY, excludes PREMIUM.

Routing decisions are emitted as PROV-O activities in the graph for audit trail.

Index

Constructors

Methods

routeByCapability

Constructors

constructor

new CostAwareRouter(
    graph: MeshGraph,
    gatewayConfig: AiGatewayConfig,
    config?: CostAwareRoutingConfig,
): CostAwareRouter
Parameters
- graph: MeshGraph
- gatewayConfig: AiGatewayConfig
- Optionalconfig: CostAwareRoutingConfig
Returns CostAwareRouter
- Defined in packages/core/src/core/routing/cost-aware-router.ts:70

Methods

routeByCapability

routeByCapability(
capability: string,
options?: { budgetId?: string; limit?: number; status?: string },
): Promise<string[]>
Route to the best available agents for a capability, applying cost-tier bias when budget utilisation warrants it.

Resolution order for budget ID: options.budgetId → config.budgetId → no bias (null tier preference)
Parameters
- capability: string
  Required agent capability IRI (validated by instantiateTemplate)
- Optionaloptions: { budgetId?: string; limit?: number; status?: string }
  Per-call overrides for status, limit, and budgetId
Returns Promise<string[]>
Ordered list of agent IRIs (best match first)
- Defined in packages/core/src/core/routing/cost-aware-router.ts:87