Keep deprecated lp/r3 deserializer shims for backward compatibility.

Re-export the moved tracing decoders from their old adapter paths with a
DeprecationWarning so existing imports keep working after the tracing refactor.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: SunnySoldier357

eval_protocol/adapters/lp_deserializer.py

@@ -0,0 +1,41 @@
+"""Deprecated compatibility shim for ``eval_protocol.tracing.logprobs``.
+
+Import from ``eval_protocol.tracing.logprobs`` (or ``decode_payloads`` from
+``eval_protocol.tracing``) instead. This module re-exports the LP/v1 helpers
+that lived here before the tracing package refactor.
+"""
+
+from __future__ import annotations
+
+import warnings
+
+warnings.warn(
+    "eval_protocol.adapters.lp_deserializer is deprecated; "
+    "import from eval_protocol.tracing.logprobs instead.",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
+from eval_protocol.tracing.logprobs import (  # noqa: E402
+    ENTRY_FORMAT,
+    ENTRY_SIZE,
+    HEADER_FORMAT,
+    HEADER_SIZE,
+    HEADER_VERSION,
+    MAGIC,
+    MISSING_TOKEN_ID,
+    decompress_and_parse_lp,
+    parse_logprobs,
+)
+
+__all__ = [
+    "ENTRY_FORMAT",
+    "ENTRY_SIZE",
+    "HEADER_FORMAT",
+    "HEADER_SIZE",
+    "HEADER_VERSION",
+    "MAGIC",
+    "MISSING_TOKEN_ID",
+    "decompress_and_parse_lp",
+    "parse_logprobs",
+]

eval_protocol/adapters/r3_deserializer.py

@@ -0,0 +1,41 @@
+"""Deprecated compatibility shim for ``eval_protocol.tracing.router_replay``.
+
+Import from ``eval_protocol.tracing.router_replay`` (or ``decode_payloads`` from
+``eval_protocol.tracing``) instead. This module re-exports the R3/v1 helpers
+that lived here before the tracing package refactor.
+"""
+
+from __future__ import annotations
+
+import warnings
+
+warnings.warn(
+    "eval_protocol.adapters.r3_deserializer is deprecated; "
+    "import from eval_protocol.tracing.router_replay instead.",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
+from eval_protocol.tracing.router_replay import (  # noqa: E402
+    BITS_PER_BYTE,
+    HEADER_FORMAT,
+    HEADER_SIZE,
+    MAGIC,
+    _RoutingDtype,
+    _SelectorMode,
+    _parse_header,
+    _read_bitmap_positions,
+    decompress_and_parse_r3,
+)
+
+__all__ = [
+    "BITS_PER_BYTE",
+    "HEADER_FORMAT",
+    "HEADER_SIZE",
+    "MAGIC",
+    "_RoutingDtype",
+    "_SelectorMode",
+    "_parse_header",
+    "_read_bitmap_positions",
+    "decompress_and_parse_r3",
+]

tests/adapters/test_deserializer_shims.py

@@ -0,0 +1,38 @@
+"""Backward-compat shims for moved adapter deserializers."""
+
+from __future__ import annotations
+
+import warnings
+
+import pytest
+
+from tests.adapters.test_lp_deserializer import GOLDEN_RAW_HEX
+
+
+def test_lp_deserializer_shim_reexports_and_warns():
+    with warnings.catch_warnings(record=True) as caught:
+        warnings.simplefilter("always", DeprecationWarning)
+        from eval_protocol.adapters import lp_deserializer as shim
+
+    assert any(
+        "eval_protocol.adapters.lp_deserializer is deprecated" in str(w.message)
+        for w in caught
+    )
+    raw = bytes.fromhex(GOLDEN_RAW_HEX)
+    logprobs, token_ids, metadata = shim.parse_logprobs(raw)
+    assert logprobs == [-0.25, -0.5]
+    assert token_ids == [7, 8]
+    assert metadata["completion_token_count"] == 2
+
+
+def test_r3_deserializer_shim_reexports_and_warns():
+    with warnings.catch_warnings(record=True) as caught:
+        warnings.simplefilter("always", DeprecationWarning)
+        from eval_protocol.adapters import r3_deserializer as shim
+
+    assert any(
+        "eval_protocol.adapters.r3_deserializer is deprecated" in str(w.message)
+        for w in caught
+    )
+    assert shim.MAGIC == b"R3V1"
+    assert shim._SelectorMode.ALL == 0