Skip to main content

Function: setGlobalLlmObserver()

setGlobalLlmObserver(observer): void

Defined in: packages/agentos/src/api/observers.ts:109

Register (or clear) the process-wide LLM usage observer.

Hosts typically call this once at app boot:

setGlobalLlmObserver((event) => {
  recordFoundationUsageEvent({
    meterKey: event.source ?? 'llm.call',
    providerKey: event.provider,
    modelKey: event.model,
    quantity: event.usage.costUSD ?? 0,
    unit: 'usd',
  });
});

Passing null clears the observer (useful in tests).

Parameters​

observer​

The observer callback, or null to clear.

LlmUsageObserver | null

Returns​

void