AxBalancerStatsStore

Defined in: https://github.com/ax-llm/ax/blob/e4219a44b7581a55a40d9dd62d2c281062ff078d/src/ax/ai/balance_adaptive.ts#L63

Storage contract for adaptive routing state.

observe must update a key atomically. Remote implementations can use axUpdateBalancerRouteStats inside a transaction or server-side script. Store failures are isolated from model requests by AxBalancer.

Methods

get()

get(key: AxBalancerStatsKey): Promise<
  | undefined
  | Readonly<{
  failureEwma: number;
  logLatencyM2: number;
  logLatencyMean: number;
  observations: number;
  successes: number;
  version: 1;
}>>;

Defined in: https://github.com/ax-llm/ax/blob/e4219a44b7581a55a40d9dd62d2c281062ff078d/src/ax/ai/balance_adaptive.ts#L65

Read the latest route state, or return undefined for a cold route.

Parameters

Returns

Promise< | undefined | Readonly<{ failureEwma: number; logLatencyM2: number; logLatencyMean: number; observations: number; successes: number; version: 1; }>>

observe()

observe(key: AxBalancerStatsKey, observation: AxBalancerStatsObservation): Promise<void>;

Defined in: https://github.com/ax-llm/ax/blob/e4219a44b7581a55a40d9dd62d2c281062ff078d/src/ax/ai/balance_adaptive.ts#L67

Atomically reduce one observation into the state stored at key.

Parameters

Returns

Promise<void>