unique_toolkit 2026.40.0.dev1__py3-none-any.whl → 2026.40.0.dev3__py3-none-any.whl

unique_toolkit/agentic/evaluation/hallucination/utils.py

@@ -203,7 +203,8 @@ def _compose_msgs(
     )
     system_msg = LanguageModelSystemMessage(content=system_msg_content)
 
-    # Render user message
+    # Render user message. Pass history text only when history exists so the
+    # template can omit an empty conversation section.
     user_msg_content = render_template(
         user_template,
         input_text=input.input_text,
@@ -211,7 +212,7 @@ def _compose_msgs(
         if has_context
         else None,
         history_messages_text=input.get_joined_history_texts(tag_name="conversation")
-        if has_context
+        if has_context and input.history_messages
         else None,
         output_text=input.output_text,
     )

unique_toolkit/agentic/evaluation/tests/test_hallucination_utils.py

@@ -1224,3 +1224,67 @@ def test_get_msgs__ignores_context_images__when_model_lacks_vision() -> None:
     # Assert
     assert result.root[0].content == no_context_result.root[0].content
     assert isinstance(result.root[1].content, str)
+
+
+@pytest.mark.unit
+def test_compose_msgs__omits_conversation_section__when_history_is_empty():
+    """A single-turn evaluation must not be shown an empty conversation.
+
+    The template guards the section with `{% if history_messages_text %}`,
+    and the getter returns a truthy placeholder when there is no history, so
+    the guard used to never fire: every caller evaluating one turn shipped a
+    `Conversation:` section whose body said there was no conversation, while
+    the system prompt announced one.
+    """
+    msgs = _compose_msgs(
+        EvaluationMetricInput(
+            input_text="What is the policy rate?",
+            context_texts=["The policy rate is 0.25%."],
+            history_messages=[],
+            output_text="0.25%.",
+        ),
+        HallucinationConfig(),
+        has_context=True,
+    )
+
+    user_content = msgs.root[-1].content
+    assert isinstance(user_content, str)
+    assert "Conversation:" not in user_content
+    assert "<No conversation texts provided>" not in user_content
+    # The references the model does have must still be there.
+    assert "The policy rate is 0.25%." in user_content
+
+
+@pytest.mark.unit
+def test_compose_msgs__keeps_conversation_section__when_history_is_present():
+    msgs = _compose_msgs(
+        EvaluationMetricInput(
+            input_text="And in March?",
+            context_texts=["The March rate was 0.50%."],
+            history_messages=[
+                ChatMessage(
+                    id="msg_1",
+                    chat_id="chat_1",
+                    previous_message_id=None,
+                    role=LanguageModelMessageRole.USER,
+                    text="What is the policy rate?",
+                ),
+                ChatMessage(
+                    id="msg_2",
+                    chat_id="chat_1",
+                    previous_message_id="msg_1",
+                    role=LanguageModelMessageRole.ASSISTANT,
+                    text="0.25%.",
+                ),
+            ],
+            output_text="0.50%.",
+        ),
+        HallucinationConfig(),
+        has_context=True,
+    )
+
+    user_content = msgs.root[-1].content
+    assert isinstance(user_content, str)
+    assert "Conversation:" in user_content
+    assert "What is the policy rate?" in user_content
+    assert "<No conversation texts provided>" not in user_content

unique_toolkit/chat/functions.py

@@ -188,6 +188,46 @@ async def modify_message_async(
         raise e
 
 
+async def mark_turn_system_interrupted_async(
+    user_id: str,
+    company_id: str,
+    chat_id: str,
+    user_message_id: str,
+) -> ChatMessage:
+    """Marks the turn anchored on *user_message_id* as system-interrupted.
+
+    Persists ``turnInterruptionReason = SYSTEM_INTERRUPTED`` on the originating
+    USER message via a dedicated service-authenticated node-chat endpoint. The
+    server guarantees idempotency and never overwrites ``userAbortedAt`` (a
+    user-initiated stop wins if both race).
+
+    Args:
+        user_id (str): The user ID.
+        company_id (str): The company ID.
+        chat_id (str): The chat ID.
+        user_message_id (str): The originating USER message of the turn.
+
+    Returns:
+        ChatMessage: The USER message after the update (unchanged if the call
+            was a no-op due to idempotency or a racing user stop).
+
+    Raises:
+        Exception: If the request fails.
+
+    """
+    try:
+        message = await unique_sdk.Message.mark_turn_system_interrupted_async(
+            user_id=user_id,
+            company_id=company_id,
+            id=user_message_id,
+            chatId=chat_id,
+        )
+        return ChatMessage(**message)
+    except Exception as e:
+        _LOGGER.error(f"Failed to mark turn as system-interrupted: {e}")
+        raise e
+
+
 def map_references(references: list[ContentReference]) -> list[dict[str, Any]]:
     return [
         {

unique_toolkit/chat/schemas.py

@@ -192,6 +192,12 @@ class MessageLogStatus(StrEnum):
     RUNNING = "RUNNING"
     COMPLETED = "COMPLETED"
     FAILED = "FAILED"
+    CANCELLED = "CANCELLED"
+    """The user pressed Stop while this thinking/tool step was in flight.
+
+    Use ``FAILED`` for system-side interruption (timeout, truncation, terminal
+    backend failure), not for user-initiated cancellation.
+    """
 
 
 class MessageExecutionStatus(StrEnum):

unique_toolkit/services/chat_service.py

@@ -49,6 +49,7 @@ from unique_toolkit.chat.functions import (
     get_message_tools,
     get_message_tools_async,
     get_selection_from_history,
+    mark_turn_system_interrupted_async,
     modify_message,
     modify_message_assessment,
     modify_message_assessment_async,
@@ -383,6 +384,36 @@ class ChatService(ChatServiceDeprecated):
             set_completed_at=set_completed_at or False,
         )
 
+    async def mark_turn_system_interrupted_async(self) -> ChatMessage:
+        """Marks the current turn as system-interrupted.
+
+        Persists ``turnInterruptionReason = SYSTEM_INTERRUPTED`` on the current
+        chat context's originating USER message via a dedicated
+        service-authenticated node-chat endpoint.
+
+        Call this only for system-side unexpected endings: timeout, truncation,
+        terminal backend failure, and equivalents. Do not call it for
+        user-initiated cancellation or normal completion.
+
+        The operation is idempotent and never overwrites ``userAbortedAt``: if
+        the user pressed Stop and the system interruption race, the user stop
+        wins and this call is a server-side no-op.
+
+        Returns:
+            ChatMessage: The USER message anchoring the turn.
+
+        Raises:
+            Exception: If the request fails. Callers invoking this from
+                failure-handling paths should treat it as best-effort.
+
+        """
+        return await mark_turn_system_interrupted_async(
+            user_id=self._user_id,
+            company_id=self._company_id,
+            chat_id=self._chat_id,
+            user_message_id=self._user_message_id,
+        )
+
     def modify_assistant_message(
         self,
         content: str | None = None,

{unique_toolkit-2026.40.0.dev1.dist-info → unique_toolkit-2026.40.0.dev3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: unique-toolkit
-Version: 2026.40.0.dev1
+Version: 2026.40.0.dev3
 Summary: 
 Author: Cedric Klinkert, Martin Fadler, Sadique Sheik, Fabian Schläpfer, Pascal Hauri, Ejiroghene Oki-Peter, Rami Azouz, Ricardo Visini, Sanzio Monti
 Author-email: Cedric Klinkert <cedric.klinkert@unique.ch>, Martin Fadler <martin.fadler@unique.ch>, Sadique Sheik <sadique@unique.ch>, Fabian Schläpfer <fabian@unique.ch>, Pascal Hauri <pascal@unique.ch>, Ejiroghene Oki-Peter <oki-peter.ejiroghene@unique.ai>, Rami Azouz <rami.ext@unique.ch>, Ricardo Visini <ricardo.visini@unique.ch>, Sanzio Monti <sanzio.monti@unique.ai>
@@ -16,7 +16,7 @@ Requires-Dist: sseclient>=0.0.27,<0.0.28
 Requires-Dist: openai>=1.105.0,<3
 Requires-Dist: platformdirs>=4.0.0,<5
 Requires-Dist: pillow>=12.1.1
-Requires-Dist: unique-sdk>=2026.40.0.dev0,<2026.40.0rc0
+Requires-Dist: unique-sdk>=2026.40.0.dev3,<2026.40.0rc0
 Requires-Dist: jambo>=0.1.2,<0.2
 Requires-Dist: jinja2>=3.1.6,<4
 Requires-Dist: docxtpl>=0.20.1,<0.21

{unique_toolkit-2026.40.0.dev1.dist-info → unique_toolkit-2026.40.0.dev3.dist-info}/RECORD

@@ -99,7 +99,7 @@ unique_toolkit/agentic/evaluation/hallucination/prompts/__init__.py,sha256=4KFYM
 unique_toolkit/agentic/evaluation/hallucination/prompts/system_prompt.j2,sha256=sDUX6G645Ba40D_qKu4cUI8g-sJOfG8JpZreTNFgf7M,2616
 unique_toolkit/agentic/evaluation/hallucination/prompts/user_prompt.j2,sha256=mD_qE9fOkyc1XXrebFt097ddx8bTlA6lbY04hKSQmWs,273
 unique_toolkit/agentic/evaluation/hallucination/service.py,sha256=QSPsRxx2H-YpSR2Jn7zJKtwZfZ7elTPAFQiYvM3gYfs,2618
-unique_toolkit/agentic/evaluation/hallucination/utils.py,sha256=QVXO0hFrsGxvbgTwC40RSfrLhE_1of1oBrrfcafk10Y,15531
+unique_toolkit/agentic/evaluation/hallucination/utils.py,sha256=maiMxlUjT9_U0GAH9HvemMIUE-47MCGtwm2XMwDAShQ,15664
 unique_toolkit/agentic/evaluation/output_parser.py,sha256=0FDo8YY_Dc4qlTNeYyQkznzIFj9aX9wMrLOTbhhTl6g,1418
 unique_toolkit/agentic/evaluation/schemas.py,sha256=RT0O-AXSOf1zV3fDbUfn7V6bOIA01pkzui02Uad9E3Y,3815
 unique_toolkit/agentic/evaluation/tests/fixtures.py,sha256=Q-ughTfDiAdsMKbBVGzFiBucFdAx-FXgJ9iqp5xMyPs,2801
@@ -107,7 +107,7 @@ unique_toolkit/agentic/evaluation/tests/test_config.py,sha256=p7xFQ7KE_yU8jGpqYA
 unique_toolkit/agentic/evaluation/tests/test_context_relevancy_service.py,sha256=-GRxH70vzvrZG6Hz0igH6i2CqM7Z9jjKt3396xWDh84,12011
 unique_toolkit/agentic/evaluation/tests/test_hallucination_constants.py,sha256=A77nRcniI7hUf640f1sTvCAibQbJE30ikbz1RX4fltw,20478
 unique_toolkit/agentic/evaluation/tests/test_hallucination_external_context.py,sha256=3JR9WfBWazX7a1h3uq77Q6kSKm8Mt-aAW8KUYxJUw14,4303
-unique_toolkit/agentic/evaluation/tests/test_hallucination_utils.py,sha256=JzFXSH3k1qnSDbZEQy5ftKiVnVL_jS1PTpp3H3DjewI,39218
+unique_toolkit/agentic/evaluation/tests/test_hallucination_utils.py,sha256=TJcJf9SZcH1dsSq38NkvSBM0VZfBRkan49Una3UPQB0,41546
 unique_toolkit/agentic/evaluation/tests/test_output_parser.py,sha256=KfltytmvqnPWLhmZpBXqcRmnlYorw_USwM5rkLVv8so,5179
 unique_toolkit/agentic/evaluation/tests/test_prompt_loaders.py,sha256=zBREdlKf5tdDyB8XSaNgpQv3-tuZJoYteeJrp6WMWDM,11897
 unique_toolkit/agentic/evaluation/utils.py,sha256=HmyPaDV8wdW-_gOjjW-wDaMKgdrsP5-SHP7OqTmGI_A,264
@@ -260,10 +260,10 @@ unique_toolkit/chat/cancellation.py,sha256=k5HMjpeBmofIiInwq5TjOR_5k91oq1bWG00lJ
 unique_toolkit/chat/constants.py,sha256=05kq6zjqUVB2d6_P7s-90nbljpB3ryxwCI-CAz0r2O4,83
 unique_toolkit/chat/deprecated/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 unique_toolkit/chat/deprecated/service.py,sha256=8_XoopUWHT396Z_5gwMmsI6v4NGVgQirSJCYUW4Gx8c,9339
-unique_toolkit/chat/functions.py,sha256=1xpiRMTbl9XSz7fzzbUYYtsAa178bhZ0zIOAAzjDqQw,55773
+unique_toolkit/chat/functions.py,sha256=fb4x_y4d5QwT1WUjVEP-opFpJ9CV8WaiLAOR1ktTmy0,57073
 unique_toolkit/chat/rendering.py,sha256=c8YiV9oADRrJQ5A_QBJ4_UFc0NZ-2vVaa7tupoMusso,880
 unique_toolkit/chat/responses_api.py,sha256=Swp6wi10vCPkBiSSj8NN58gpjTgYVkqRlwdOJRQHVjo,21135
-unique_toolkit/chat/schemas.py,sha256=DJ3-J2a-FK45UU_H2NaDOh-H0UEsPgmM_5eGfwN3HfI,8123
+unique_toolkit/chat/schemas.py,sha256=tRU8vcT1SQWtktkHQmDO26CNbOgSynFHfFB9FR6D4OQ,8372
 unique_toolkit/chat/service.py,sha256=6D00OL4QrGafbOhTaC5zNXaNgg7gS5W_2ePVa4LhqpE,4439
 unique_toolkit/chat/state.py,sha256=Cjgwv_2vhDFbV69xxsn7SefhaoIAEqLx3ferdVFCnOg,1445
 unique_toolkit/chat/utils.py,sha256=CsD9IER2gA1IOV0fmUOl-N0LmKvA7JP9dGrOqeOY0Gg,1173
@@ -412,7 +412,7 @@ unique_toolkit/monitoring/registry.py,sha256=De2Bx5QBBRJQY2MM3xtntiJ2JU2FoKkVT7r
 unique_toolkit/monitoring/tracing.py,sha256=0lmLuQjyyC3iFpNTw8rOyCpEZ6PTvp16nVbzcO9d2sQ,10043
 unique_toolkit/protocols/support.py,sha256=x5edzbBmKAUuvm3oLFh52gkgQsqR5LU7M0t8RHK0DZk,5161
 unique_toolkit/services/__init__.py,sha256=b9Wl7Wvz1JmZDbDexIZzBoXZ0wscXuczGAH8LoL-Qak,572
-unique_toolkit/services/chat_service.py,sha256=8BncFKNJK0zR8QM3oFzUNdiPq5I4OLYbmQWJ06rIFTg,98932
+unique_toolkit/services/chat_service.py,sha256=umPHKDn0FX7vG7y7Tw-88iMultPpw_r0fYlhQlqvLYY,100196
 unique_toolkit/services/factory.py,sha256=7gNeanyHkgX23Iz7RMCQTCkE9gI5asCI11nXxM0jjx4,9832
 unique_toolkit/services/knowledge_base.py,sha256=6dM4abcXR9y2VYoR6SK79gwjrzb83Wm8jMPPIt5z95o,43461
 unique_toolkit/short_term_memory/__init__.py,sha256=2mI3AUrffgH7Yt-xS57EGqnHf7jnn6xquoKEhJqk3Wg,185
@@ -423,6 +423,6 @@ unique_toolkit/short_term_memory/service.py,sha256=2JMBEBn6GoyK-a0xvdcWpPft-3C74
 unique_toolkit/smart_rules/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 unique_toolkit/smart_rules/compile.py,sha256=vRe0aMJWuVIK-VsqomgxQImzke7MDmwgSxxJfYCa7zw,1386
 unique_toolkit/test_utilities/events.py,sha256=FLrhMh0A_mQutAUjoD0FdMcVQ4Gq31r35OVGzRjvLro,6760
-unique_toolkit-2026.40.0.dev1.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
-unique_toolkit-2026.40.0.dev1.dist-info/METADATA,sha256=BfWkREvwGUnak2qn1etchW2-YJZloIknxqqA_bOd-jA,7821
-unique_toolkit-2026.40.0.dev1.dist-info/RECORD,,
+unique_toolkit-2026.40.0.dev3.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
+unique_toolkit-2026.40.0.dev3.dist-info/METADATA,sha256=5lKBF9LaItGW_BMKf--Pm1cu_WyBA_yMPHpWd9XPrHs,7821
+unique_toolkit-2026.40.0.dev3.dist-info/RECORD,,