AxBalancerStatsStore

Defined in: https://github.com/ax-llm/ax/blob/3d5aa8dac28a2637e4150f022dcd02e6fc3309f0/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<
  | Readonly<{
  failureEwma: number;
  logLatencyM2: number;
  logLatencyMean: number;
  observations: number;
  successes: number;
  version: 1;
}>
| undefined>;

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

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

Parameters

Returns

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

observe()

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

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

Atomically reduce one observation into the state stored at key.

Parameters

Returns

Promise<void>