Skip to content

Use Claude Code, Codex, VSCode, Pi, and OpenCode (and 6 other harnesses) for free (1.3B+ free tokens) from your terminal, app, IDE, or phone, and now from the browser with native browser sessions (multi-harness + multi-model) like OpenClaw (voice supported + ToS friendly)

Python

patch: Defer disabled debug payload construction (#1951)

Ali Khokharac270ca3a1c1
diff --git a/src/free_claude_code/api/handlers/messages.py b/src/free_claude_code/api/handlers/messages.py
index 505a2565..e5eec9f8 100644
--- a/src/free_claude_code/api/handlers/messages.py
+++ b/src/free_claude_code/api/handlers/messages.py
@@ -121,7 +121,7 @@ class MessagesHandler:
result = _MessagesStreamResult(
self._provider_executor.stream_messages(
routed,
- raw_log_payload=routed.request.model_dump(),
+ raw_log_payload=routed.request.model_dump,
request_id=request_id,
)
)
diff --git a/src/free_claude_code/api/handlers/responses.py b/src/free_claude_code/api/handlers/responses.py
index 8c10f100..f0d231bb 100644
--- a/src/free_claude_code/api/handlers/responses.py
+++ b/src/free_claude_code/api/handlers/responses.py
@@ -62,7 +62,6 @@ class ResponsesHandler:
) -> object:
"""Create a streaming OpenAI Responses-compatible response."""
request_id = request_id or new_request_id()
- request_payload = request_data.model_dump(mode="json", exclude_none=True)
if request_data.stream is False:
raise InvalidRequestError(
"FCC /v1/responses supports streaming only; omit stream or set stream=true."
@@ -84,7 +83,9 @@ class ResponsesHandler:
)
streamed = self._provider_executor.stream_responses(
routed,
- raw_log_payload=request_payload,
+ raw_log_payload=lambda: request_data.model_dump(
+ mode="json", exclude_none=True
+ ),
request_id=request_id,
)
return await openai_responses_sse_streaming_response(
diff --git a/src/free_claude_code/api/handlers/token_count.py b/src/free_claude_code/api/handlers/token_count.py
index f2bea621..d9bc638d 100644
--- a/src/free_claude_code/api/handlers/token_count.py
+++ b/src/free_claude_code/api/handlers/token_count.py
@@ -60,16 +60,19 @@ class TokenCountHandler:
provider_model_ref=routed.resolved.primary.provider_model_ref,
gateway_model=routed.resolved.original_model,
)
- request_snapshot = anthropic_request_snapshot(routed.request)
- request_snapshot["model"] = routed.resolved.original_model
trace_event(
+ lambda: {
+ "snapshot": {
+ **anthropic_request_snapshot(routed.request),
+ "model": routed.resolved.original_model,
+ }
+ },
stage="ingress",
event="free_claude_code.api.count_tokens.completed",
source="api",
request_id=request_id,
message_count=len(routed.request.messages),
input_tokens=tokens,
- snapshot=request_snapshot,
)
return TokenCountResponse(input_tokens=tokens)
except ApplicationError:
diff --git a/src/free_claude_code/application/execution.py b/src/free_claude_code/application/execution.py
index 03c9582b..1796f201 100644
--- a/src/free_claude_code/application/execution.py
+++ b/src/free_claude_code/application/execution.py
@@ -167,7 +167,7 @@ class ProviderExecutor:
self,
routed: RoutedMessagesRequest,
*,
- raw_log_payload: object,
+ raw_log_payload: Callable[[], object],
request_id: str,
) -> AsyncIterator[str]:
"""Execute one Anthropic Messages request."""
@@ -210,7 +210,7 @@ class ProviderExecutor:
wire_api="messages",
raw_log_label="FULL_PAYLOAD",
raw_log_payload=raw_log_payload,
- request_snapshot=anthropic_request_snapshot(routed.request),
+ request_snapshot=lambda: anthropic_request_snapshot(routed.request),
ingress_count_name="message_count",
ingress_count=len(routed.request.messages),
request_id=request_id,
@@ -221,7 +221,7 @@ class ProviderExecutor:
self,
routed: RoutedResponsesRequest,
*,
- raw_log_payload: object,
+ raw_log_payload: Callable[[], object],
request_id: str,
) -> AsyncIterator[str]:
"""Execute one native OpenAI Responses request."""
@@ -266,7 +266,7 @@ class ProviderExecutor:
wire_api="responses",
raw_log_label="FULL_RESPONSES_PAYLOAD",
raw_log_payload=raw_log_payload,
- request_snapshot={
+ request_snapshot=lambda: {
"model": routed.request.model,
"input_item_count": input_item_count,
"tool_count": len(routed.request.tools or ()),
@@ -284,8 +284,8 @@ class ProviderExecutor:
reasoning: ReasoningPolicy,
wire_api: WireApi,
raw_log_label: str,
- raw_log_payload: object,
- request_snapshot: dict[str, object],
+ raw_log_payload: Callable[[], object],
+ request_snapshot: Callable[[], dict[str, object]],
ingress_count_name: str,
ingress_count: int,
request_id: str,
@@ -318,7 +318,6 @@ class ProviderExecutor:
route_trace["generation_id"] = self._generation_id
trace_event(**route_trace)
- request_snapshot["model"] = gateway_model
ingress_trace: dict[str, object] = {
"stage": "ingress",
"event": (
@@ -327,16 +326,18 @@ class ProviderExecutor:
else "free_claude_code.api.request.received"
),
"source": "api",
- "snapshot": request_snapshot,
"request_id": request_id,
ingress_count_name: ingress_count,
}
trace_event(
+ lambda: {"snapshot": {**request_snapshot(), "model": gateway_model}},
**ingress_trace,
)
if self._log_raw_payloads:
- logger.debug(f"{raw_log_label} [{{}}]: {{}}", request_id, raw_log_payload)
+ logger.opt(lazy=True).debug(
+ f"{raw_log_label} [{{}}]: {{}}", lambda: request_id, raw_log_payload
+ )
async def provider_body() -> AsyncIterator[str]:
loop = asyncio.get_running_loop()
diff --git a/src/free_claude_code/application/web_tools/service.py b/src/free_claude_code/application/web_tools/service.py
index 2897757e..7b7924f9 100644
--- a/src/free_claude_code/application/web_tools/service.py
+++ b/src/free_claude_code/application/web_tools/service.py
@@ -138,7 +138,7 @@ class WebToolService:
)
provider_stream = self._executor.stream_messages(
translated,
- raw_log_payload=plan.request.model_dump(),
+ raw_log_payload=plan.request.model_dump,
request_id=request_id,
)
chunks: list[str] = []
diff --git a/src/free_claude_code/core/trace.py b/src/free_claude_code/core/trace.py
index 26e322e5..6f0cf0bb 100644
--- a/src/free_claude_code/core/trace.py
+++ b/src/free_claude_code/core/trace.py
@@ -8,7 +8,7 @@ INFO log level excludes these detailed request traces.
import asyncio
import sys
-from collections.abc import AsyncGenerator, AsyncIterator, Mapping
+from collections.abc import AsyncGenerator, AsyncIterator, Callable, Mapping
from typing import Any
from loguru import logger
@@ -49,17 +49,29 @@ def sanitize_trace_value(obj: Any) -> Any:
return obj
-def trace_event(*, stage: str, event: str, source: str, **fields: Any) -> None:
- """Emit a DEBUG record with a structured payload bound to its extra fields."""
- payload = sanitize_trace_value(
- {
- "stage": stage,
- "event": event,
- "source": source,
- **fields,
- },
+def trace_event(
+ lazy_fields: Callable[[], Mapping[str, Any]] | None = None,
+ /,
+ *,
+ stage: str,
+ event: str,
+ source: str,
+ **fields: Any,
+) -> None:
+ """Defer sanitization and the optional field factory until DEBUG is enabled."""
+ logger.opt(lazy=True).debug(
+ "TRACE {}",
+ lambda: event,
+ trace_payload=lambda: sanitize_trace_value(
+ {
+ "stage": stage,
+ "event": event,
+ "source": source,
+ **fields,
+ **(lazy_fields() if lazy_fields is not None else {}),
+ }
+ ),
)
- logger.bind(trace_payload=payload).debug("TRACE {}", event)
async def close_stream_input(
diff --git a/src/free_claude_code/providers/openai_chat/transport.py b/src/free_claude_code/providers/openai_chat/transport.py
index db7f2715..e2154d85 100644
--- a/src/free_claude_code/providers/openai_chat/transport.py
+++ b/src/free_claude_code/providers/openai_chat/transport.py
@@ -934,6 +934,7 @@ class _OpenAIChatStreamRunner:
output_reasoning = self._reasoning.output_enabled
corrections = RequestCorrections("chat", self._reasoning_correction)
trace_event(
+ lambda: {"body": provider_chat_body_snapshot(body)},
stage="provider",
event="provider.request.sent",
source="provider",
@@ -944,7 +945,6 @@ class _OpenAIChatStreamRunner:
downstream_model=body.get("model"),
message_count=len(body.get("messages", [])),
tool_count=len(body.get("tools", [])),
- body=provider_chat_body_snapshot(body),
)
while True:
diff --git a/tests/api/test_safe_logging.py b/tests/api/test_safe_logging.py
index 73eb6cfc..8b70f2ea 100644
--- a/tests/api/test_safe_logging.py
+++ b/tests/api/test_safe_logging.py
@@ -1,5 +1,6 @@
"""Tests that API and SSE logging avoid raw sensitive payloads by default."""
+import logging
from unittest.mock import AsyncMock, MagicMock, patch
import pytest
@@ -8,7 +9,6 @@ from fastapi.responses import JSONResponse
from free_claude_code.api import request_errors
from free_claude_code.api.handlers import MessagesHandler, TokenCountHandler
-from free_claude_code.application import execution
from free_claude_code.config.settings import Settings
from free_claude_code.core.anthropic import AnthropicStreamLedger
from free_claude_code.core.anthropic.models import Message, MessagesRequest
@@ -16,7 +16,7 @@ from tests.web_tools_support import StubWebToolsClient
@pytest.mark.asyncio
-async def test_create_message_skips_full_payload_debug_log_by_default():
+async def test_create_message_skips_full_payload_debug_log_by_default(caplog):
settings = Settings()
assert settings.log_raw_api_payloads is False
mock_provider = MagicMock()
@@ -37,19 +37,16 @@ async def test_create_message_skips_full_payload_debug_log_by_default():
messages=[Message(role="user", content="secret-user-text")],
)
- with patch.object(execution.logger, "debug") as mock_debug:
+ with caplog.at_level(logging.DEBUG):
await service.create(request)
- full_payload_calls = [
- c
- for c in mock_debug.call_args_list
- if c.args and str(c.args[0]) == "FULL_PAYLOAD [{}]: {}"
- ]
- assert not full_payload_calls
+ assert not any(
+ record.message.startswith("FULL_PAYLOAD [") for record in caplog.records
+ )
@pytest.mark.asyncio
-async def test_create_message_logs_full_payload_when_opt_in():
+async def test_create_message_logs_full_payload_when_opt_in(caplog):
settings = Settings()
settings.log_raw_api_payloads = True
mock_provider = MagicMock()
@@ -69,11 +66,16 @@ async def test_create_message_logs_full_payload_when_opt_in():
messages=[Message(role="user", content="visible")],
)
- with patch.object(execution.logger, "debug") as mock_debug:
+ with caplog.at_level(logging.DEBUG):
await service.create(request)
- keys = [c.args[0] for c in mock_debug.call_args_list if c.args]
- assert any(k == "FULL_PAYLOAD [{}]: {}" for k in keys)
+ payloads = [
+ record.message
+ for record in caplog.records
+ if record.message.startswith("FULL_PAYLOAD [")
+ ]
+ assert len(payloads) == 1
+ assert "visible" in payloads[0]
def test_stream_ledger_default_debug_has_no_serialized_json_content():
diff --git a/tests/application/test_execution.py b/tests/application/test_execution.py
index 0063426e..bfadbac2 100644
--- a/tests/application/test_execution.py
+++ b/tests/application/test_execution.py
@@ -389,7 +389,7 @@ async def test_fallback_receives_its_own_cached_capability_in_stream(
event
async for event in getattr(executor, f"stream_{ingress}")(
route(_target("fallback", "fallback-model")),
- raw_log_payload={},
+ raw_log_payload=dict,
request_id="capability-fallback",
)
]
@@ -433,7 +433,7 @@ def _executor_stream(
)
return executor.stream_messages(
_routed_request(),
- raw_log_payload={},
+ raw_log_payload=dict,
request_id=request_id,
)
@@ -451,7 +451,7 @@ async def test_executor_routes_native_responses_without_messages_conversion() ->
stream = executor.stream_responses(
routed,
- raw_log_payload=request.model_dump(mode="json"),
+ raw_log_payload=lambda: request.model_dump(mode="json"),
request_id="req_responses_application",
)
@@ -486,7 +486,7 @@ async def test_executor_uses_structural_provider_port_and_defers_stream_startup(
stream = executor.stream_messages(
routed,
- raw_log_payload=request.model_dump(),
+ raw_log_payload=request.model_dump,
request_id="req_application",
)
@@ -530,7 +530,7 @@ async def test_primary_success_never_resolves_fallback() -> None:
executor = ProviderExecutor(resolve, progress_timeout_seconds=60.0)
stream = executor.stream_messages(
_routed_request(_target("fallback", "fallback-model")),
- raw_log_payload={},
+ raw_log_payload=dict,
request_id="req_primary_success",
)
@@ -566,7 +566,7 @@ async def test_retryable_preframe_failure_selects_fallback_after_closing_primary
chunk
async for chunk in executor.stream_messages(
routed,
- raw_log_payload={},
+ raw_log_payload=dict,
request_id="req_fallback",
)
]
@@ -629,7 +629,7 @@ async def test_fallback_chain_preserves_exact_last_failure() -> None:
)
stream = executor.stream_messages(
_routed_request(_target("second", "model")),
- raw_log_payload={},
+ raw_log_payload=dict,
request_id="req_exhausted",
)
@@ -659,7 +659,7 @@ async def test_multiple_retryable_failures_walk_fallbacks_in_order() -> None:
_target("second", "second-model"),
_target("third", "third-model"),
),
- raw_log_payload={},
+ raw_log_payload=dict,
request_id="req_ordered_fallbacks",
)
@@ -681,7 +681,7 @@ async def test_empty_primary_completion_does_not_select_fallback() -> None:
executor = ProviderExecutor(resolve, progress_timeout_seconds=60.0)
stream = executor.stream_messages(
_routed_request(_target("fallback", "model")),
- raw_log_payload={},
+ raw_log_payload=dict,
request_id="req_empty_primary",
)
@@ -703,7 +703,7 @@ async def test_unexpected_primary_failure_does_not_select_fallback() -> None:
executor = ProviderExecutor(resolve, progress_timeout_seconds=60.0)
stream = executor.stream_messages(
_routed_request(_target("fallback", "model")),
- raw_log_payload={},
+ raw_log_payload=dict,
request_id="req_unexpected_primary",
)
@@ -728,7 +728,7 @@ async def test_invalid_none_stream_remains_terminal() -> None:
with patch.object(primary, "stream_messages", return_value=None):
stream = executor.stream_messages(
_routed_request(_target("fallback", "model")),
- raw_log_payload={},
+ raw_log_payload=dict,
request_id="req_invalid_stream",
)
with pytest.raises(TypeError):
@@ -760,7 +760,7 @@ async def test_nonretryable_provider_failure_selects_fallback_before_first_frame
executor = ProviderExecutor(resolve, progress_timeout_seconds=60.0)
stream = executor.stream_messages(
_routed_request(_target("fallback", "model")),
- raw_log_payload={},
+ raw_log_payload=dict,
request_id="req_rejected",
)
@@ -796,7 +796,7 @@ async def test_primary_canonical_startup_failure_selects_fallback() -> None:
stream = executor.stream_messages(
_routed_request(_target("fallback", "fallback-model")),
- raw_log_payload={},
+ raw_log_payload=dict,
request_id="req_startup_fallback",
)
@@ -824,7 +824,7 @@ async def test_nonretryable_stream_construction_failure_selects_fallback() -> No
)
stream = executor.stream_messages(
_routed_request(_target("fallback", "model")),
- raw_log_payload={},
+ raw_log_payload=dict,
request_id="req_construction_failure",
)
@@ -846,7 +846,7 @@ async def test_failure_after_first_frame_never_selects_fallback() -> None:
executor = ProviderExecutor(resolve, progress_timeout_seconds=60.0)
stream = executor.stream_messages(
_routed_request(_target("fallback", "model")),
- raw_log_payload={},
+ raw_log_payload=dict,
request_id="req_committed",
)
@@ -870,7 +870,7 @@ async def test_lazy_fallback_startup_application_error_stops_unchanged() -> None
)
stream = executor.stream_messages(
_routed_request(_target("fallback", "model")),
- raw_log_payload={},
+ raw_log_payload=dict,
request_id="req_startup",
)
@@ -919,7 +919,7 @@ async def test_candidate_requests_are_isolated_from_provider_mutation() -> None:
chunk
async for chunk in executor.stream_messages(
routed,
- raw_log_payload={},
+ raw_log_payload=dict,
request_id="req_isolated",
)
]
@@ -940,7 +940,7 @@ async def test_closing_executor_stream_closes_provider_stream_once() -> None:
)
stream = executor.stream_messages(
routed,
- raw_log_payload={},
+ raw_log_payload=dict,
request_id="req_early_close",
)
@@ -969,7 +969,7 @@ async def test_stream_construction_failure_remains_deferred_to_iteration() -> No
stream = executor.stream_messages(
_routed_request(_target("fallback", "model")),
- raw_log_payload={},
+ raw_log_payload=dict,
request_id="req_deferred_construction",
)
@@ -991,7 +991,7 @@ async def test_executor_validation_is_deferred_until_iteration() -> None:
stream = executor.stream_messages(
_routed_request(),
- raw_log_payload={},
+ raw_log_payload=dict,
request_id="req_application",
)
token_counter.assert_called_once()
@@ -1067,7 +1067,7 @@ async def test_application_progress_timeout_never_resolves_fallback() -> None:
executor = ProviderExecutor(resolve, progress_timeout_seconds=0.02)
stream = executor.stream_messages(
_routed_request(_target("fallback", "model")),
- raw_log_payload={},
+ raw_log_payload=dict,
request_id="req_terminal_progress_timeout",
)
@@ -1098,7 +1098,7 @@ async def test_provider_cleanup_cannot_delay_fallback_past_progress_deadline() -
executor = ProviderExecutor(resolve, progress_timeout_seconds=0.02)
stream = executor.stream_messages(
_routed_request(_target("fallback", "model")),
- raw_log_payload={},
+ raw_log_payload=dict,
request_id="req_cleanup_timeout",
)
@@ -1199,7 +1199,7 @@ async def test_fallback_transition_does_not_reset_shared_progress_deadline() ->
)
stream = executor.stream_messages(
_routed_request(_target("fallback", "model")),
- raw_log_payload={},
+ raw_log_payload=dict,
request_id="req_shared_deadline",
)
deadlines: list[float | None] = []
@@ -1277,7 +1277,7 @@ async def test_cancelling_progress_wait_remains_cancellation() -> None:
)
stream = executor.stream_messages(
_routed_request(_target("fallback", "model")),
- raw_log_payload={},
+ raw_log_payload=dict,
request_id="req_cancelled_progress",
)
task = asyncio.ensure_future(anext(stream))
diff --git a/tests/application/test_request_conversion.py b/tests/application/test_request_conversion.py
index 49508eb4..2446d56c 100644
--- a/tests/application/test_request_conversion.py
+++ b/tests/application/test_request_conversion.py
@@ -71,7 +71,7 @@ async def test_executor_converts_chat_request_once(wire):
provider._chat, builder_name, wraps=getattr(provider._chat, builder_name)
) as build:
stream = getattr(executor, f"stream_{wire}")(
- routed, raw_log_payload={}, request_id="conversion-once"
+ routed, raw_log_payload=dict, request_id="conversion-once"
)
output = "".join([event async for event in stream])
assert "hello" in output
@@ -106,7 +106,7 @@ async def test_executor_converts_selected_opencode_route_once(wire, egress, warm
AsyncMock(side_effect=lambda _: provider), progress_timeout_seconds=60
)
stream = getattr(executor, f"stream_{wire}")(
- routed, raw_log_payload={}, request_id="opencode-conversion-once"
+ routed, raw_log_payload=dict, request_id="opencode-conversion-once"
)
assert f"{egress}-ok" in "".join([event async for event in stream])
assert build.call_count == 1
@@ -145,7 +145,7 @@ async def test_executor_converts_subscription_request_once(wire):
AsyncMock(side_effect=lambda _: provider), progress_timeout_seconds=60
)
stream = getattr(executor, f"stream_{wire}")(
- routed, raw_log_payload={}, request_id="subscription-conversion-once"
+ routed, raw_log_payload=dict, request_id="subscription-conversion-once"
)
assert auth.access_calls == 0
assert "hello" in "".join([event async for event in stream])
diff --git a/tests/core/test_lazy_debug_logging.py b/tests/core/test_lazy_debug_logging.py
new file mode 100644
index 00000000..e4bf6e1e
--- /dev/null
+++ b/tests/core/test_lazy_debug_logging.py
@@ -0,0 +1,177 @@
+"""Check logging levels in a subprocess without changing pytest's global sinks."""
+
+import json
+import subprocess
+import sys
+from unittest.mock import AsyncMock, Mock, patch
+
+import httpx2
+import pytest
+from loguru import logger
+from openai import AsyncOpenAI
+
+from free_claude_code.api.handlers import token_count
+from free_claude_code.application import execution
+from free_claude_code.config.settings import Settings
+from free_claude_code.core import trace
+from free_claude_code.core.anthropic import TokenCountRequest
+from free_claude_code.providers.openai_chat import transport as chat_transport
+from tests.application.test_execution import (
+ FakeProvider,
+ ResponsesFakeProvider,
+ _routed_request,
+ _routed_responses_request,
+)
+from tests.providers.test_openai_chat_transport import _consume, _success, _transport
+
+
+async def _probe(level: str, raw: bool) -> None:
+ logger.remove()
+ rows = []
+ if level != "NONE":
+ logger.add(
+ lambda message: rows.append(json.loads(message)),
+ level=level,
+ serialize=True,
+ )
+ expected = int(level == "DEBUG")
+ fields = Mock(return_value={"snapshot": {"text": "visible", "api_key": "hidden"}})
+ raw_payload = Mock(return_value={"text": "raw conversation"})
+ with (
+ patch.object(
+ trace, "sanitize_trace_value", wraps=trace.sanitize_trace_value
+ ) as sanitize,
+ patch.object(
+ execution,
+ "anthropic_request_snapshot",
+ wraps=execution.anthropic_request_snapshot,
+ ) as ingress,
+ patch.object(
+ token_count,
+ "anthropic_request_snapshot",
+ wraps=token_count.anthropic_request_snapshot,
+ ) as counted,
+ patch.object(
+ chat_transport,
+ "provider_chat_body_snapshot",
+ wraps=chat_transport.provider_chat_body_snapshot,
+ ) as provider_snapshot,
+ logger.contextualize(request_id="req_lazy", instance_id="instance_lazy"),
+ ):
+ trace.trace_event(fields, stage="unit", event="lazy.probe", source="test")
+ for wire, routed, provider in (
+ ("messages", _routed_request(), FakeProvider()),
+ ("responses", _routed_responses_request(), ResponsesFakeProvider()),
+ ):
+ executor = execution.ProviderExecutor(
+ AsyncMock(return_value=provider),
+ progress_timeout_seconds=60,
+ token_counter=lambda *args: 1,
+ responses_token_counter=lambda request: 1,
+ log_raw_payloads=raw,
+ )
+ output = [
+ chunk
+ async for chunk in getattr(executor, f"stream_{wire}")(
+ routed, raw_log_payload=raw_payload, request_id="req_lazy"
+ )
+ ]
+ assert output
+ routed = _routed_request()
+ handler = token_count.TokenCountHandler(
+ Settings(),
+ model_router=Mock(resolve_token_count_request=Mock(return_value=routed)),
+ token_counter=lambda *args: 7,
+ )
+ assert (
+ handler.count(
+ TokenCountRequest(
+ model=routed.request.model, messages=routed.request.messages
+ )
+ ).input_tokens
+ == 7
+ )
+ async with AsyncOpenAI(
+ api_key="test",
+ base_url="https://provider.invalid/v1",
+ http_client=httpx2.AsyncClient(
+ transport=httpx2.MockTransport(lambda request: _success())
+ ),
+ ) as client:
+ assert "hello" in await _consume(_transport(client), "messages")
+ assert fields.call_count == expected
+ assert (
+ ingress.call_count
+ == counted.call_count
+ == provider_snapshot.call_count
+ == expected
+ )
+ assert raw_payload.call_count == 2 * expected * raw
+ assert bool(sanitize.call_count) == bool(expected)
+ if expected:
+ payloads = [
+ row["record"]["extra"]["trace_payload"]
+ for row in rows
+ if "trace_payload" in row["record"]["extra"]
+ ]
+ probe = next(
+ payload for payload in payloads if payload["event"] == "lazy.probe"
+ )
+ assert probe == {
+ "stage": "unit",
+ "event": "lazy.probe",
+ "source": "test",
+ "snapshot": {"text": "visible", "api_key": "<redacted>"},
+ }
+ ingress_payload = next(
+ payload
+ for payload in payloads
+ if payload["event"] == "free_claude_code.api.request.received"
+ )
+ assert ingress_payload["snapshot"]["model"] == "gateway-model"
+ assert (
+ ingress_payload["snapshot"]["messages"]
+ == routed.request.model_dump()["messages"]
+ )
+ assert rows[0]["record"]["extra"]["request_id"] == "req_lazy"
+ assert rows[0]["record"]["extra"]["instance_id"] == "instance_lazy"
+ else:
+ assert all(row["record"]["level"]["no"] >= 20 for row in rows)
+ assert all("trace_payload" not in row["record"]["extra"] for row in rows)
+ assert (
+ sum(row["record"]["message"].startswith("FULL_") for row in rows)
+ == 2 * expected * raw
+ )
+
+ # Adding/removing DEBUG sinks must take effect immediately, with one build per event.
+ logger.remove()
+ logger.add(lambda message: None, level="INFO")
+ fields.reset_mock()
+ trace.trace_event(fields, stage="unit", event="levels", source="test")
+ assert fields.call_count == 0
+ sinks = [logger.add(lambda message: None, level="DEBUG") for _ in range(2)]
+ trace.trace_event(fields, stage="unit", event="levels", source="test")
+ assert fields.call_count == 1
+ for sink in sinks:
+ logger.remove(sink)
+ trace.trace_event(fields, stage="unit", event="levels", source="test")
+ assert fields.call_count == 1
+
+
[email protected]("level", ["INFO", "DEBUG", "NONE"])
[email protected]("raw", [False, True])
+def test_debug_payloads_are_built_only_when_enabled(level, raw):
+ result = subprocess.run(
+ [
+ sys.executable,
+ "-c",
+ "import asyncio, sys; from tests.core.test_lazy_debug_logging import _probe; asyncio.run(_probe(sys.argv[1], sys.argv[2] == 'True'))",
+ level,
+ str(raw),
+ ],
+ capture_output=True,
+ text=True,
+ encoding="utf-8",
+ timeout=30,
+ )
+ assert result.returncode == 0, result.stdout + result.stderr
diff --git a/tests/providers/test_history_transports.py b/tests/providers/test_history_transports.py
index cb6997d0..10e32b31 100644
--- a/tests/providers/test_history_transports.py
+++ b/tests/providers/test_history_transports.py
@@ -462,7 +462,7 @@ async def test_successful_fallback_stamps_its_own_origin_and_gets_unmodified_inp
try:
saved = await _saved_reply(
executor.stream_messages(
- routed, raw_log_payload={}, request_id="actual-fallback"
+ routed, raw_log_payload=dict, request_id="actual-fallback"
),
"messages",
)
diff --git a/tests/providers/test_lmstudio.py b/tests/providers/test_lmstudio.py
index 6d9de49f..cbdf16ce 100644
--- a/tests/providers/test_lmstudio.py
+++ b/tests/providers/test_lmstudio.py
@@ -403,7 +403,7 @@ async def test_primary_context_validation_counts_toward_progress_timeout(
route = _routed_request if wire == "messages" else _routed_responses_request
routed = route(_target("fallback", "fallback-model"))
stream = getattr(executor, f"stream_{wire}")(
- routed, raw_log_payload={}, request_id="context-timeout"
+ routed, raw_log_payload=dict, request_id="context-timeout"
)
async with asyncio.timeout(2):
with pytest.raises(ExecutionFailure) as error:
@@ -805,7 +805,7 @@ async def test_request_timeout_while_waiting_for_cache_leaves_refresh_running(wi
_routed_request() if wire == "messages" else _routed_responses_request()
)
stream = getattr(executor, f"stream_{wire}")(
- routed, raw_log_payload={}, request_id="cache-wait-timeout"
+ routed, raw_log_payload=dict, request_id="cache-wait-timeout"
)
async with asyncio.timeout(2):
with pytest.raises(ExecutionFailure) as error:
@@ -878,7 +878,7 @@ async def test_context_rejection_before_first_event_allows_fallback(wire):
route = _routed_request if wire == "messages" else _routed_responses_request
stream = getattr(executor, f"stream_{wire}")(
route(_target("fallback", "fallback-model")),
- raw_log_payload={},
+ raw_log_payload=dict,
request_id="context-fallback",
)
output = [event async for event in stream]
diff --git a/tests/providers/test_opencode.py b/tests/providers/test_opencode.py
index aea6338c..a6dae670 100644
--- a/tests/providers/test_opencode.py
+++ b/tests/providers/test_opencode.py
@@ -1107,7 +1107,7 @@ async def test_candidate_fallback_resolves_each_opencode_transport(
resolved=resolved,
reasoning=DEFAULT_REASONING_POLICY,
),
- raw_log_payload={},
+ raw_log_payload=dict,
request_id="req_opencode_cross_transport_responses",
)
else:
@@ -1117,7 +1117,7 @@ async def test_candidate_fallback_resolves_each_opencode_transport(
resolved=resolved,
reasoning=DEFAULT_REASONING_POLICY,
),
- raw_log_payload={},
+ raw_log_payload=dict,
request_id="req_opencode_cross_transport_messages",
)
body = "".join([chunk async for chunk in stream])