Interface EffectStats

Lightweight per-effect counters scoped to one runner.

These counters are intended for tests, diagnostics, and basic observability. They are not persisted and are not shared across runners.

interface EffectStats {
    cacheHits: number;
    cacheWrites: number;
    calls: number;
    dedupHits: number;
    errors: number;
    invalidations: number;
    memoHits: number;
}

Properties

cacheHits: number

Persistent cache reads that produced valid output.

cacheWrites: number

Persistent cache writes.

calls: number

Handler executions. Cache and memo hits do not increment this counter.

dedupHits: number

Calls that reused an in-flight same-input promise.

errors: number

Calls rejected because validation, cache, or handler execution failed.

invalidations: number

Persistent cache entries removed because output validation failed.

memoHits: number

Calls served from runner-local memory.