@@ -305,6 +305,60 @@ async def _empty_chat_stream() -> AsyncIterator[ChatCompletionChunk]:
305305 )
306306
307307
308+ @pytest .mark .allow_call_model_methods
309+ @pytest .mark .asyncio
310+ @pytest .mark .parametrize (
311+ ("counts" , "expected" ),
312+ [
313+ ((None , 5 , 12 ), (0 , 5 , 12 )),
314+ ((7 , None , 12 ), (7 , 0 , 12 )),
315+ ((7 , 5 , None ), (7 , 5 , 0 )),
316+ ((None , None , None ), (0 , 0 , 0 )),
317+ ((7 , 5 , 12 ), (7 , 5 , 12 )),
318+ (None , (0 , 0 , 0 )),
319+ ],
320+ ids = ["null-input" , "null-output" , "null-total" , "all-null" , "valid" , "no-usage" ],
321+ )
322+ async def test_any_llm_runner_normalizes_nullable_chat_usage (
323+ monkeypatch : pytest .MonkeyPatch ,
324+ counts : tuple [int | None , int | None , int | None ] | None ,
325+ expected : tuple [int , int , int ],
326+ ) -> None :
327+ usage = (
328+ {
329+ "prompt_tokens" : counts [0 ],
330+ "completion_tokens" : counts [1 ],
331+ "total_tokens" : counts [2 ],
332+ "prompt_tokens_details" : {"cached_tokens" : 3 },
333+ "completion_tokens_details" : {"reasoning_tokens" : 2 },
334+ }
335+ if counts is not None
336+ else None
337+ )
338+ chat = _chat_completion ("Hello" )
339+ # Provider SDK parsing can construct typed responses without validating null counts.
340+ chat .usage = CompletionUsage .model_construct (** usage ) if usage is not None else None
341+ if chat .usage is not None :
342+ chat .usage .prompt_tokens_details = PromptTokensDetails (cached_tokens = 3 )
343+ chat .usage .completion_tokens_details = CompletionTokensDetails (reasoning_tokens = 2 )
344+ provider = FakeAnyLLMProvider (supports_responses = False , chat_response = chat )
345+ module , _ = _import_any_llm_module (monkeypatch , provider )
346+ agent = Agent (
347+ name = "test" ,
348+ model = module .AnyLLMModel (model = "openai/fake" , api = "chat_completions" ),
349+ model_settings = ModelSettings (preserve_raw_usage = True ),
350+ )
351+ result = await Runner .run (agent , "hi" )
352+
353+ assert result .final_output == "Hello"
354+ normalized = result .context_wrapper .usage
355+ assert normalized .requests == 1
356+ assert (normalized .input_tokens , normalized .output_tokens , normalized .total_tokens ) == expected
357+ assert normalized .input_tokens_details .cached_tokens == (3 if counts is not None else 0 )
358+ assert normalized .output_tokens_details .reasoning_tokens == (2 if counts is not None else 0 )
359+ assert result .raw_responses [0 ].raw_usage == usage
360+
361+
308362@pytest .mark .allow_call_model_methods
309363@pytest .mark .asyncio
310364@pytest .mark .parametrize ("override_ua" , [None , "test_user_agent" ])
0 commit comments