Jido.AI.Quota.Store (Jido AI v2.2.0)

In-process quota counters backed by ETS.

Summary

usage()

Adds usage to the rolling quota counter for a scope.

ensure_table!()

Ensures the quota ETS table exists.

get(scope)

Returns current usage snapshot for a scope.

reset(scope)

Resets quota counters for a scope.

Returns quota status including limits, usage, and remaining budget.

@type usage() :: %{
  window_started_at_ms: non_neg_integer(),
  requests: non_neg_integer(),
  total_tokens: non_neg_integer()
}

@spec add_usage(String.t(), non_neg_integer(), non_neg_integer()) :: usage()

Adds usage to the rolling quota counter for a scope.

@spec ensure_table!() :: :ok

Ensures the quota ETS table exists.

@spec get(String.t()) :: usage()

Returns current usage snapshot for a scope.

@spec reset(String.t()) :: :ok

Resets quota counters for a scope.

@spec status(String.t(), map(), non_neg_integer()) :: map()

Returns quota status including limits, usage, and remaining budget.