renderers 0.1.12.dev17__tar.gz → 0.1.12.dev19__tar.gz

{renderers-0.1.12.dev17 → renderers-0.1.12.dev19}/.github/workflows/test.yml

@@ -21,7 +21,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
 
     steps:
       - uses: actions/checkout@v4

{renderers-0.1.12.dev17 → renderers-0.1.12.dev19}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.5
 Name: renderers
-Version: 0.1.12.dev17
+Version: 0.1.12.dev19
 Summary: Chat template renderers — deterministic message-to-token conversion for LLM training
 License-Expression: Apache-2.0
 License-File: LICENSE
-Requires-Python: <3.15,>=3.10
+Requires-Python: <3.15,>=3.11
 Requires-Dist: jinja2
 Requires-Dist: numpy
 Requires-Dist: openai-harmony>=0.0.4
@@ -120,6 +120,8 @@ Hand-coded renderers ship for `qwen3`, `qwen3-vl`, `qwen3.5`, `qwen3.6`, `qwen3.
 
 ```python
 class Renderer(Protocol):
+    @property
+    def is_prefix_stable(self) -> bool: ...
     def render(messages, *, tools=None, add_generation_prompt=False) -> RenderedTokens: ...
     def render_ids(messages, *, tools=None, add_generation_prompt=False) -> list[int]: ...
     def parse_response(token_ids) -> ParsedResponse: ...
@@ -132,6 +134,35 @@ class Renderer(Protocol):
 - `ParsedResponse` is `(content, reasoning_content, tool_calls)`. It scans token ids for special-token boundaries (e.g. id `151657` for `<tool_call>` on Qwen3) — a literal `"<tool_call>"` in user content tokenizes to ordinary text ids and never matches.
 - Round-trip: rendering `[user, assistant(content, reasoning, tool_calls)]`, slicing the assistant completion, and feeding it through `parse_response` returns an equivalent structured message. Tested per-renderer in `tests/test_roundtrip.py`.
 
+### Prefix stability
+
+`renderer.is_prefix_stable` describes the constructed renderer after config and
+`chat_template_kwargs` resolution. A `True` value guarantees that full renders
+of assistant-terminated conversations stay token prefixes when more
+user/tool/assistant messages are appended, with a fixed system/developer
+preamble, tools, and `add_generation_prompt=False`. `False` means this is not
+guaranteed; opaque `DefaultRenderer` templates report `False`.
+
+The flag follows the template's emit rules, independently of the
+`thinking_retention` bridge override. For example, GLM-5 with
+`clear_thinking=False` is stable, while the default strips earlier reasoning.
+Disabling thinking generation alone does not guarantee stability for datasets
+that already contain reasoning. Other causes include GPT-OSS's final-turn
+terminator and Nemotron's moving effort hint. DeepSeek V4 reports `False`
+because its task/continuation message controls can rewrite the prefix; Inkling
+reports `False` because reused tool-call IDs can change earlier tool-response
+names, even though it retains reasoning.
+
+SFT consumers can use this flag to warn that a single full-conversation render
+may omit earlier reasoning. `build_training_sample` still returns one sample
+per conversation, without expanding it into one sample per assistant turn.
+The guarantee assumes unchanged message contents and deterministic tokenization
+and media preprocessing. Stability does not guarantee that the template emits
+every input field (some always omit reasoning), or that rendering reproduces sampled tokens. Continue
+using `bridge_to_next_turn` for sampled trajectories. Custom renderers should
+expose the same property; consumers supporting older/custom implementations
+can conservatively use `getattr(renderer, "is_prefix_stable", False)`.
+
 ### `bridge_to_next_turn` (the core contract)
 
 Given `(prev_prompt_ids, prev_completion_ids)` and new environment messages, return ids for the next turn's prompt such that the result starts with `prev_prompt_ids + prev_completion_ids` byte-for-byte and continues with the new messages plus the next assistant opener. If that cannot be proven safe, return `None` and the caller falls back to a full render.
@@ -276,6 +307,30 @@ uv run pytest
 
 Round-trip parity (render → parse → original) and token-level parity against each model's independent reference encoder are tested per renderer. Most references use `apply_chat_template`; DeepSeek V4 uses its shipped Python encoder, and GPT-OSS uses Harmony.
 
+Prefix-stability audit witnesses live in
+[`tests/fixtures/prefix_stability.json`](tests/fixtures/prefix_stability.json).
+Each case records a renderer/config, a conversation ending in an assistant,
+messages to append, and the reason the original tokens stop being a prefix.
+Shared scenarios keep the corpus small; paired stable settings guard the
+configuration switches. `DefaultRenderer` is treated as unknown, without
+inventing a witness for its opaque template.
+
+This audit is opt-in and is not collected by the regular test suite or CI.
+Run it manually when changing renderer emission rules or the stability
+classification:
+
+```bash
+uv run pytest tests/audit_prefix_stability.py -q
+```
+
+The tests render both inputs and compare the original token IDs with the
+same-length prefix of the extended render. They print the first differing
+tokens and a decoded text diff on failure. These are executable witnesses,
+not snapshots of token IDs that could pass without exercising the renderer.
+Add a named case for each new instability mechanism or configuration branch.
+A witness disproves stability; finite positive controls do not prove stability
+for every possible conversation or third-party tokenizer/processor.
+
 ## License
 
 Licensed under the [Apache License, Version 2.0](LICENSE).

{renderers-0.1.12.dev17 → renderers-0.1.12.dev19}/README.md

@@ -100,6 +100,8 @@ Hand-coded renderers ship for `qwen3`, `qwen3-vl`, `qwen3.5`, `qwen3.6`, `qwen3.
 
 ```python
 class Renderer(Protocol):
+    @property
+    def is_prefix_stable(self) -> bool: ...
     def render(messages, *, tools=None, add_generation_prompt=False) -> RenderedTokens: ...
     def render_ids(messages, *, tools=None, add_generation_prompt=False) -> list[int]: ...
     def parse_response(token_ids) -> ParsedResponse: ...
@@ -112,6 +114,35 @@ class Renderer(Protocol):
 - `ParsedResponse` is `(content, reasoning_content, tool_calls)`. It scans token ids for special-token boundaries (e.g. id `151657` for `<tool_call>` on Qwen3) — a literal `"<tool_call>"` in user content tokenizes to ordinary text ids and never matches.
 - Round-trip: rendering `[user, assistant(content, reasoning, tool_calls)]`, slicing the assistant completion, and feeding it through `parse_response` returns an equivalent structured message. Tested per-renderer in `tests/test_roundtrip.py`.
 
+### Prefix stability
+
+`renderer.is_prefix_stable` describes the constructed renderer after config and
+`chat_template_kwargs` resolution. A `True` value guarantees that full renders
+of assistant-terminated conversations stay token prefixes when more
+user/tool/assistant messages are appended, with a fixed system/developer
+preamble, tools, and `add_generation_prompt=False`. `False` means this is not
+guaranteed; opaque `DefaultRenderer` templates report `False`.
+
+The flag follows the template's emit rules, independently of the
+`thinking_retention` bridge override. For example, GLM-5 with
+`clear_thinking=False` is stable, while the default strips earlier reasoning.
+Disabling thinking generation alone does not guarantee stability for datasets
+that already contain reasoning. Other causes include GPT-OSS's final-turn
+terminator and Nemotron's moving effort hint. DeepSeek V4 reports `False`
+because its task/continuation message controls can rewrite the prefix; Inkling
+reports `False` because reused tool-call IDs can change earlier tool-response
+names, even though it retains reasoning.
+
+SFT consumers can use this flag to warn that a single full-conversation render
+may omit earlier reasoning. `build_training_sample` still returns one sample
+per conversation, without expanding it into one sample per assistant turn.
+The guarantee assumes unchanged message contents and deterministic tokenization
+and media preprocessing. Stability does not guarantee that the template emits
+every input field (some always omit reasoning), or that rendering reproduces sampled tokens. Continue
+using `bridge_to_next_turn` for sampled trajectories. Custom renderers should
+expose the same property; consumers supporting older/custom implementations
+can conservatively use `getattr(renderer, "is_prefix_stable", False)`.
+
 ### `bridge_to_next_turn` (the core contract)
 
 Given `(prev_prompt_ids, prev_completion_ids)` and new environment messages, return ids for the next turn's prompt such that the result starts with `prev_prompt_ids + prev_completion_ids` byte-for-byte and continues with the new messages plus the next assistant opener. If that cannot be proven safe, return `None` and the caller falls back to a full render.
@@ -256,6 +287,30 @@ uv run pytest
 
 Round-trip parity (render → parse → original) and token-level parity against each model's independent reference encoder are tested per renderer. Most references use `apply_chat_template`; DeepSeek V4 uses its shipped Python encoder, and GPT-OSS uses Harmony.
 
+Prefix-stability audit witnesses live in
+[`tests/fixtures/prefix_stability.json`](tests/fixtures/prefix_stability.json).
+Each case records a renderer/config, a conversation ending in an assistant,
+messages to append, and the reason the original tokens stop being a prefix.
+Shared scenarios keep the corpus small; paired stable settings guard the
+configuration switches. `DefaultRenderer` is treated as unknown, without
+inventing a witness for its opaque template.
+
+This audit is opt-in and is not collected by the regular test suite or CI.
+Run it manually when changing renderer emission rules or the stability
+classification:
+
+```bash
+uv run pytest tests/audit_prefix_stability.py -q
+```
+
+The tests render both inputs and compare the original token IDs with the
+same-length prefix of the extended render. They print the first differing
+tokens and a decoded text diff on failure. These are executable witnesses,
+not snapshots of token IDs that could pass without exercising the renderer.
+Add a named case for each new instability mechanism or configuration branch.
+A witness disproves stability; finite positive controls do not prove stability
+for every possible conversation or third-party tokenizer/processor.
+
 ## License
 
 Licensed under the [Apache License, Version 2.0](LICENSE).

{renderers-0.1.12.dev17 → renderers-0.1.12.dev19}/examples/sglang/multiturn_generate_sglang.py

@@ -1,6 +1,6 @@
 #!/usr/bin/env -S uv run --script
 # /// script
-# requires-python = ">=3.10,<3.14"
+# requires-python = ">=3.11,<3.14"
 # dependencies = [
 #   "renderers>=0.1.6",
 #   "sglang==0.5.10.post1",

{renderers-0.1.12.dev17 → renderers-0.1.12.dev19}/examples/sglang/online_multiturn_sglang.py

@@ -1,6 +1,6 @@
 #!/usr/bin/env -S uv run --script
 # /// script
-# requires-python = ">=3.10,<3.14"
+# requires-python = ">=3.11,<3.14"
 # dependencies = [
 #   "renderers>=0.1.6",
 #   "transformers>=5.3.0",

{renderers-0.1.12.dev17 → renderers-0.1.12.dev19}/examples/transformers/multiturn_generate_transformers.py

@@ -1,6 +1,6 @@
 #!/usr/bin/env -S uv run --script
 # /// script
-# requires-python = ">=3.10,<3.14"
+# requires-python = ">=3.11,<3.14"
 # dependencies = [
 #   "renderers>=0.1.6",
 #   "transformers>=4.50.0",

{renderers-0.1.12.dev17 → renderers-0.1.12.dev19}/examples/vllm/multiturn_generate_vllm.py

@@ -1,6 +1,6 @@
 #!/usr/bin/env -S uv run --script
 # /// script
-# requires-python = ">=3.10,<3.14"
+# requires-python = ">=3.11,<3.14"
 # dependencies = [
 #   "renderers>=0.1.6",
 #   "vllm>=0.20",

{renderers-0.1.12.dev17 → renderers-0.1.12.dev19}/pyproject.toml

@@ -13,7 +13,7 @@ description = "Chat template renderers — deterministic message-to-token conver
 readme = "README.md"
 license = "Apache-2.0"
 license-files = ["LICENSE"]
-requires-python = ">=3.10,<3.15"
+requires-python = ">=3.11,<3.15"
 dependencies = [
     "numpy",
     "openai>=1.108.1",

{renderers-0.1.12.dev17 → renderers-0.1.12.dev19}/renderers/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.1.12.dev17'
-__version_tuple__ = version_tuple = (0, 1, 12, 'dev17')
+__version__ = version = '0.1.12.dev19'
+__version_tuple__ = version_tuple = (0, 1, 12, 'dev19')
 
 __commit_id__ = commit_id = None

{renderers-0.1.12.dev17 → renderers-0.1.12.dev19}/renderers/base.py

@@ -1,15 +1,14 @@
-from __future__ import annotations
-
-import enum
 import logging
 from collections.abc import Mapping
 from dataclasses import dataclass, field
+from enum import StrEnum
 from typing import (
     TYPE_CHECKING,
     Any,
     Callable,
     Literal,
     Protocol,
+    Required,
     TypedDict,
     cast,
     runtime_checkable,
@@ -110,8 +109,8 @@ class Message(TypedDict, total=False):
     Optional keys mirror the OpenAI chat format for tool calling.
     """
 
-    role: str
-    content: Content
+    role: Required[str]
+    content: Required[Content]
     tool_calls: list[ToolCall]
     tool_call_id: str
     name: str
@@ -562,7 +561,7 @@ class RenderedTokens:
         return mask
 
 
-class ToolCallParseStatus(str, enum.Enum):
+class ToolCallParseStatus(StrEnum):
     """Per-attempt outcome of parsing a single ``<tool_call>`` block.
 
     The renderer parser's job is JSON-syntax → ``dict`` (the parser-level
@@ -723,6 +722,26 @@ class ChatTemplateTokenizer(Tokenizer, Protocol):
 class Renderer(Protocol):
     """Owns message ↔ token conversion for a specific model family."""
 
+    @property
+    def is_prefix_stable(self) -> bool:
+        """Whether extending a conversation preserves its rendered token prefix.
+
+        For valid conversations ending in an assistant message, ``True`` means
+        that appending user/tool/assistant messages leaves the existing token
+        IDs unchanged when both renders use ``add_generation_prompt=False``.
+        The system/developer preamble, tools, and renderer configuration must
+        stay fixed. This describes full renders, not sampled completions or
+        the ability to bridge them; keep using ``bridge_to_next_turn`` for that.
+
+        The declaration is conservative over message contents (including
+        supplied reasoning even when thinking generation is disabled) and
+        tools. ``False`` means stability is not guaranteed, including opaque
+        templates. It does not mean every conversation changes. Conversely,
+        ``True`` does not promise to emit fields the template always ignores.
+        Custom renderers should declare this property from their emit rules.
+        """
+        ...
+
     def render(
         self,
         messages: list[Message],
@@ -1310,15 +1329,19 @@ def load_tokenizer(model_name_or_path: str):
     the requested Meta ID so auto-resolution still selects ``Llama3Renderer``.
     Requires the ``renderers[transformers]`` extra.
     """
-    _require_transformers("Loading a tokenizer")
-    load_name_or_path = _tokenizer_source_for(model_name_or_path)
-    kwargs = _tokenizer_load_kwargs(load_name_or_path)
-    tok = _load_tokenizer_via_auto(load_name_or_path, **kwargs)
-    return _preserve_requested_tokenizer_name(
-        tok,
-        requested_name_or_path=model_name_or_path,
-        loaded_name_or_path=load_name_or_path,
-    )
+    try:
+        _require_transformers("Loading a tokenizer")
+        load_name_or_path = _tokenizer_source_for(model_name_or_path)
+        kwargs = _tokenizer_load_kwargs(load_name_or_path)
+        tok = _load_tokenizer_via_auto(load_name_or_path, **kwargs)
+        return _preserve_requested_tokenizer_name(
+            tok,
+            requested_name_or_path=model_name_or_path,
+            loaded_name_or_path=load_name_or_path,
+        )
+    except Exception as exc:
+        exc.add_note(f"While loading tokenizer {model_name_or_path!r}.")
+        raise
 
 
 def _populate_registry():
@@ -1393,7 +1416,7 @@ def _populate_registry():
 
 def create_renderer(
     tokenizer,
-    config: RendererConfig | None = None,
+    config: "RendererConfig | None" = None,
     *,
     chat_template_kwargs: Mapping[str, Any] | None = None,
 ) -> Renderer:
@@ -1425,26 +1448,34 @@ def create_renderer(
     """
     _populate_registry()
 
-    config = _resolve_renderer_config(
-        tokenizer,
-        config,
-        chat_template_kwargs=chat_template_kwargs,
-    )
-    from renderers.configs import CustomRendererConfig
-    from renderers.custom import custom_renderer_config, load_custom_renderer
-
-    if isinstance(config, CustomRendererConfig):
-        renderer_cls = load_custom_renderer(config.import_path)
-        return renderer_cls(tokenizer, custom_renderer_config(config))
-    cls = RENDERER_REGISTRY.get(config.name)
-    if cls is None:
-        raise ValueError(
-            f"Unknown renderer {config.name!r}. Available: {', '.join(sorted(RENDERER_REGISTRY))}"
+    try:
+        config = _resolve_renderer_config(
+            tokenizer,
+            config,
+            chat_template_kwargs=chat_template_kwargs,
+        )
+        from renderers.configs import CustomRendererConfig
+        from renderers.custom import custom_renderer_config, load_custom_renderer
+
+        if isinstance(config, CustomRendererConfig):
+            renderer_cls = load_custom_renderer(config.import_path)
+            return renderer_cls(tokenizer, custom_renderer_config(config))
+        cls = RENDERER_REGISTRY.get(config.name)
+        if cls is None:
+            raise ValueError(
+                f"Unknown renderer {config.name!r}. Available: {', '.join(sorted(RENDERER_REGISTRY))}"
+            )
+        return cls(tokenizer, config)
+    except Exception as exc:
+        model_name = getattr(tokenizer, "name_or_path", "<unnamed tokenizer>")
+        renderer_name = config.name if config is not None else "auto"
+        exc.add_note(
+            f"While creating renderer {renderer_name!r} for tokenizer {model_name!r}."
         )
-    return cls(tokenizer, config)
+        raise
 
 
-def template_field_names(config: RendererConfig) -> frozenset[str]:
+def template_field_names(config: "RendererConfig") -> frozenset[str]:
     """Chat-template kwargs that ``config``'s renderer accepts, custom renderers included."""
     from renderers.configs import CustomRendererConfig
     from renderers.custom import load_custom_renderer
@@ -1457,9 +1488,9 @@ def template_field_names(config: RendererConfig) -> frozenset[str]:
 
 
 def merge_chat_template_kwargs(
-    config: RendererConfig,
+    config: "RendererConfig",
     chat_template_kwargs: Mapping[str, Any] | None,
-) -> RendererConfig:
+) -> "RendererConfig":
     """Return ``config`` with the template kwargs applied, validated against its allowlist."""
     if not chat_template_kwargs:
         return config
@@ -1504,10 +1535,10 @@ def merge_chat_template_kwargs(
 
 def _resolve_renderer_config(
     tokenizer,
-    config: RendererConfig | None,
+    config: "RendererConfig | None",
     *,
     chat_template_kwargs: Mapping[str, Any] | None = None,
-) -> RendererConfig:
+) -> "RendererConfig":
     """Resolve auto/default config and merge chat-template kwargs."""
     from renderers.configs import AutoRendererConfig
 
@@ -1526,10 +1557,10 @@ def _resolve_renderer_config(
 
 def _resolve_auto_config(
     tokenizer,
-    auto: AutoRendererConfig,
+    auto: "AutoRendererConfig",
     *,
     chat_template_kwargs: Mapping[str, Any] | None = None,
-) -> RendererConfig:
+) -> "RendererConfig":
     """Map ``AutoRendererConfig`` → concrete typed config via the
     tokenizer's ``name_or_path``.
 
@@ -2117,8 +2148,8 @@ def introduces_user_query(
 
 def resolve_thinking_retention(
     config: Any,
-    implied: ResolvedThinkingRetention,
-) -> ResolvedThinkingRetention:
+    implied: "ResolvedThinkingRetention",
+) -> "ResolvedThinkingRetention":
     """Resolve the effective bridge policy for a renderer instance.
 
     ``config.thinking_retention is None`` means "derive from template knobs";
@@ -2132,7 +2163,7 @@ def resolve_thinking_retention(
 
 
 def should_rerender_for_thinking_retention(
-    thinking_retention: ResolvedThinkingRetention,
+    thinking_retention: "ResolvedThinkingRetention",
     new_messages: list[Message],
     *,
     is_user_query: Callable[[Message], bool] = _is_user_message,

{renderers-0.1.12.dev17 → renderers-0.1.12.dev19}/renderers/configs.py

@@ -21,7 +21,7 @@ keys its tokenizer's template will honour, so it can't enumerate them.
 
 from __future__ import annotations
 
-from typing import Annotated, ClassVar, Literal, Union
+from typing import Annotated, ClassVar, Literal, Self, Union
 
 from pydantic import ConfigDict, Field, model_validator
 from pydantic_config import BaseConfig
@@ -159,7 +159,7 @@ class DefaultRendererConfig(BaseRendererConfig):
     _allow_opaque_template_kwargs = True
 
     @model_validator(mode="after")
-    def _reject_legacy_preserve_flags(self):
+    def _reject_legacy_preserve_flags(self) -> Self:
         # ``extra="allow"`` would otherwise swallow the removed ``preserve_*``
         # bools into ``model_extra`` and forward them to apply_chat_template,
         # silently dropping the user's intent (DefaultRenderer can't
@@ -261,7 +261,7 @@ class Qwen36RendererConfig(BaseRendererConfig):
     _internal_fields = frozenset({"image_cache_max"})
 
     @model_validator(mode="after")
-    def _check_thinking_retention(self):
+    def _check_thinking_retention(self) -> Self:
         _reject_thinking_retention_conflict(
             self,
             "preserve_thinking",
@@ -307,7 +307,7 @@ class Qwen38RendererConfig(BaseRendererConfig):
     _internal_fields = frozenset({"image_cache_max"})
 
     @model_validator(mode="after")
-    def _check_thinking_retention(self):
+    def _check_thinking_retention(self) -> Self:
         _reject_thinking_retention_conflict(
             self,
             "preserve_thinking",
@@ -350,7 +350,7 @@ class Gemma4RendererConfig(BaseRendererConfig):
     _internal_fields = frozenset({"image_cache_max"})
 
     @model_validator(mode="after")
-    def _check_thinking_retention(self):
+    def _check_thinking_retention(self) -> Self:
         _reject_thinking_retention_conflict(
             self,
             "preserve_thinking",
@@ -377,7 +377,7 @@ class GLM5RendererConfig(BaseRendererConfig):
     to ``"all"``."""
 
     @model_validator(mode="after")
-    def _check_thinking_retention(self):
+    def _check_thinking_retention(self) -> Self:
         _reject_thinking_retention_conflict(
             self,
             "clear_thinking",
@@ -401,7 +401,7 @@ class GLM51RendererConfig(BaseRendererConfig):
     """See :class:`GLM5RendererConfig.clear_thinking`."""
 
     @model_validator(mode="after")
-    def _check_thinking_retention(self):
+    def _check_thinking_retention(self) -> Self:
         _reject_thinking_retention_conflict(
             self,
             "clear_thinking",
@@ -424,7 +424,7 @@ class GLM53RendererConfig(BaseRendererConfig):
     """Reasoning-effort system preamble emitted by the canonical template."""
 
     @model_validator(mode="after")
-    def _check_thinking_retention(self):
+    def _check_thinking_retention(self) -> Self:
         _reject_thinking_retention_conflict(
             self,
             "clear_thinking",
@@ -506,7 +506,7 @@ class Hy3RendererConfig(BaseRendererConfig):
     and suppresses the generation prompt (``add_generation_prompt=False``)."""
 
     @model_validator(mode="after")
-    def _check_thinking_retention(self):
+    def _check_thinking_retention(self) -> Self:
         if self.preserved_thinking is not None and self.thinking_retention is not None:
             implied = "all" if self.preserved_thinking else "tool_cycle"
             if self.thinking_retention != implied:
@@ -566,7 +566,7 @@ class InklingRendererConfig(BaseRendererConfig):
     _internal_fields = frozenset({"image_cache_max", "audio_cache_max"})
 
     @model_validator(mode="after")
-    def _check_reasoning_effort(self):
+    def _check_reasoning_effort(self) -> Self:
         eff = self.reasoning_effort
         if isinstance(eff, str):
             if eff.strip() not in INKLING_EFFORT_MAP:
@@ -631,7 +631,7 @@ class GptOssRendererConfig(BaseRendererConfig):
     )
 
     @model_validator(mode="after")
-    def _check_thinking_retention(self):
+    def _check_thinking_retention(self) -> Self:
         _reject_thinking_retention_conflict(
             self,
             "auto_drop_analysis",
@@ -836,7 +836,7 @@ class Nemotron3RendererConfig(BaseRendererConfig):
     policy to ``"all"``."""
 
     @model_validator(mode="after")
-    def _check_thinking_retention(self):
+    def _check_thinking_retention(self) -> Self:
         _reject_thinking_retention_conflict(
             self,
             "truncate_history_thinking",
@@ -877,7 +877,7 @@ class Nemotron3UltraRendererConfig(BaseRendererConfig):
     """See :class:`Nemotron3RendererConfig.truncate_history_thinking`."""
 
     @model_validator(mode="after")
-    def _check_thinking_retention(self):
+    def _check_thinking_retention(self) -> Self:
         _reject_thinking_retention_conflict(
             self,
             "truncate_history_thinking",
@@ -913,7 +913,7 @@ class Nemotron35RendererConfig(BaseRendererConfig):
     """See :class:`Nemotron3RendererConfig.truncate_history_thinking`."""
 
     @model_validator(mode="after")
-    def _check_thinking_retention(self):
+    def _check_thinking_retention(self) -> Self:
         _reject_thinking_retention_conflict(
             self,
             "truncate_history_thinking",
@@ -984,7 +984,7 @@ class DeepSeekV4RendererConfig(BaseRendererConfig):
     """
 
     @model_validator(mode="after")
-    def _check_thinking_retention(self):
+    def _check_thinking_retention(self) -> Self:
         _reject_thinking_retention_conflict(
             self,
             "drop_thinking",
@@ -1019,7 +1019,7 @@ class CustomRendererConfig(BaseRendererConfig):
     _internal_fields = frozenset({"import_path"})
 
     @model_validator(mode="after")
-    def _validate_renderer_fields(self):
+    def _validate_renderer_fields(self) -> Self:
         # Fail at config load, not at the first render: the import path must
         # resolve and the renderer's config must accept the other fields.
         from renderers.custom import custom_renderer_config

{renderers-0.1.12.dev17 → renderers-0.1.12.dev19}/renderers/deepseek_v3.py

@@ -56,6 +56,11 @@ class DeepSeekV3Renderer:
     stored for protocol uniformity.
     """
 
+    @property
+    def is_prefix_stable(self) -> bool:
+        """Whether full renders preserve completed conversation prefixes."""
+        return True
+
     #: Default typed config; the R1 subclass overrides this.
     _config_cls: type = DeepSeekV3RendererConfig
     _implied_thinking_retention = "all"

{renderers-0.1.12.dev17 → renderers-0.1.12.dev19}/renderers/deepseek_v4.py

@@ -294,6 +294,12 @@ def _prepare_messages(messages: list[Message]) -> list[_LogicalMessage]:
 class DeepSeekV4Renderer:
     """Renderer for ``deepseek-ai/DeepSeek-V4-Flash-0731``."""
 
+    @property
+    def is_prefix_stable(self) -> bool:
+        """Whether full renders preserve completed conversation prefixes."""
+        # Task transitions and unterminated assistant continuations can rewrite the prefix.
+        return False
+
     _implied_thinking_retention = "tool_cycle"
 
     def __init__(

{renderers-0.1.12.dev17 → renderers-0.1.12.dev19}/renderers/default.py

@@ -97,6 +97,12 @@ class DefaultRenderer:
     :class:`renderers.DefaultRendererConfig`).
     """
 
+    @property
+    def is_prefix_stable(self) -> bool:
+        """Whether full renders preserve completed conversation prefixes."""
+        # An opaque Jinja template cannot promise prefix stability.
+        return False
+
     def __init__(
         self,
         tokenizer: ChatTemplateTokenizer,

{renderers-0.1.12.dev17 → renderers-0.1.12.dev19}/renderers/gemma4.py

@@ -431,6 +431,12 @@ class _ArgumentParser:
 class Gemma4Renderer:
     """Deterministic renderer for the canonical Gemma 4 instruction models."""
 
+    @property
+    def is_prefix_stable(self) -> bool:
+        """Whether full renders preserve completed conversation prefixes."""
+        # preserve_thinking only retains tool-call reasoning, not final answers.
+        return False
+
     _config_cls = Gemma4RendererConfig
 
     def __init__(

{renderers-0.1.12.dev17 → renderers-0.1.12.dev19}/renderers/glm45.py

@@ -55,6 +55,12 @@ _TOOLS_FOOTER = (
 class GLM45Renderer:
     """Deterministic message → token renderer for GLM-4.5 Air models."""
 
+    @property
+    def is_prefix_stable(self) -> bool:
+        """Whether full renders preserve completed conversation prefixes."""
+        # Historical reasoning is stripped regardless of bridge policy.
+        return False
+
     def __init__(
         self,
         tokenizer: Tokenizer,