unique_toolkit 2026.30.0.dev2__py3-none-any.whl → 2026.30.0.dev4__py3-none-any.whl

unique_toolkit/agentic/tools/config.py

@@ -1,4 +1,5 @@
 import logging
+from collections.abc import Sequence
 from enum import StrEnum
 from typing import Annotated, Any, Generic
 
@@ -98,6 +99,16 @@ class ToolBuildConfig(BaseModel, Generic[T]):
 
     is_enabled: bool = Field(default=True)
 
+    config_error: str | None = Field(
+        default=None,
+        exclude=True,
+        description=(
+            "Set when this tool's stored configuration failed to resolve and was "
+            "demoted to a disabled BaseToolConfig fallback. None for tools that are "
+            "valid, including tools that are deliberately disabled."
+        ),
+    )
+
     @model_validator(mode="before")
     def initialize_config_based_on_tool_name(
         cls,
@@ -115,6 +126,16 @@ class ToolBuildConfig(BaseModel, Generic[T]):
         if not isinstance(value, dict):
             return value
 
+        # config_error must only ever be set by this validator's own demotion
+        # path below. Since this is a plain field on a model with
+        # populate_by_name + a camelCase alias generator, an externally
+        # supplied config_error/configError (e.g. a stray key on a stored
+        # payload) would otherwise pass straight through untouched on every
+        # non-demotion return path and make a perfectly healthy tool look
+        # misconfigured to collect_tool_configuration_errors.
+        value.pop("config_error", None)
+        value.pop("configError", None)
+
         is_mcp_tool = _is_mcp_tool_payload(value)
         mcp_configuration = value.get("configuration", {})
 
@@ -168,8 +189,23 @@ class ToolBuildConfig(BaseModel, Generic[T]):
             )
             value["is_enabled"] = False
             value["isEnabled"] = False
+            value["config_error"] = f"Tool '{tool_name}' has invalid configuration."
             _ensure_base_tool_config(value)
             return value
 
         value["configuration"] = config
         return value
+
+
+def collect_tool_configuration_errors(
+    tools: Sequence["ToolBuildConfig[Any]"],
+) -> list[str]:
+    """Return the config_error message for every tool demoted due to an invalid config.
+
+    `initialize_config_based_on_tool_name` never raises: a tool whose stored
+    configuration is invalid is silently disabled with a BaseToolConfig fallback so
+    that one broken tool cannot take down the whole space. Callers that need to
+    surface these failures instead of ignoring them (e.g. to fail a chat request the
+    way an invalid configuration used to) can use this helper to recover the list.
+    """
+    return [tool.config_error for tool in tools if tool.config_error]

unique_toolkit/experimental/integrations/openai/streaming/event_routing/responses/code_interpreter_event_handler.py

@@ -1,10 +1,16 @@
 """EventHandler for code interpreter call events — pure state accumulator.
 
-The event handler consumes OpenAI Responses code-interpreter events and keeps a
-per-``item_id`` ``(status, text)`` fingerprint to suppress duplicate
-progress updates; each genuine transition is published as an
-:class:`ActivityProgressUpdate` on the event-handler-owned
-:class:`TypedEventBus` (:attr:`activity_bus`).
+The event handler consumes OpenAI Responses code-interpreter lifecycle events
+(``in_progress`` / ``interpreting`` / ``completed``; ``delta`` and ``code.done``
+carry no displayed progress and are ignored) and keeps a per-``correlation_id``
+``(status, text)`` fingerprint to suppress duplicate progress updates; each
+genuine transition is published as an :class:`ActivityProgressUpdate` on the
+event-handler-owned :class:`TypedEventBus` (:attr:`activity_bus`).
+
+Each call surfaces as two correlation ids, mirroring the orchestrator's normal
+tool-call display: a one-shot "Triggered Tool Calls" summary published under
+``{item_id}-triggered`` on the ``in_progress`` event, and the "Code Execution"
+detail published under ``item_id`` on every lifecycle transition.
 
 All SDK I/O (``MessageLog`` create/update, ``Message`` modify) lives in
 subscribers reacting to the outer-bus :class:`ActivityProgress` event
@@ -56,8 +62,12 @@ class ResponsesCodeInterpreterEventHandler:
 
     Publishes :class:`ActivityProgressUpdate` on its own
     :class:`TypedEventBus` (accessible via :attr:`activity_bus`) for
-    every genuine state transition, deduplicated by a per-``item_id``
-    ``(status, text)`` fingerprint.
+    every genuine state transition, deduplicated by a per-``correlation_id``
+    ``(status, text)`` fingerprint. Lifecycle events (``in_progress`` /
+    ``interpreting`` / ``completed``) drive the ``item_id`` detail update;
+    the ``in_progress`` event additionally emits a one-shot "Triggered Tool
+    Calls" summary under ``{item_id}-triggered``. ``delta`` and ``code.done``
+    events are ignored.
     """
 
     def __init__(self) -> None:
@@ -70,35 +80,49 @@ class ResponsesCodeInterpreterEventHandler:
         return self._activity_bus
 
     async def on_code_interpreter_event(self, event: CodeInterpreterCallEvent) -> None:
-        """Map one OpenAI CI event to an optional progress update publish."""
-        status: ActivityStatus
-        if isinstance(event, ResponseCodeInterpreterCallCodeDoneEvent):
-            text_update = "Code interpreter call completed"
-            status = "COMPLETED"
-        elif isinstance(event, ResponseCodeInterpreterCallCompletedEvent):
-            text_update = "Code interpreter call completed"
-            status = "COMPLETED"
-        elif isinstance(event, ResponseCodeInterpreterCallCodeDeltaEvent):
-            text_update = "Code interpreter call in progress"
-            status = "RUNNING"
-        elif isinstance(event, ResponseCodeInterpreterCallInProgressEvent):
-            text_update = "Code interpreter call in progress"
-            status = "RUNNING"
-        else:  # ResponseCodeInterpreterCallInterpretingEvent
-            text_update = "Code interpreter call interpreting"
-            status = "RUNNING"
-
-        item_id = event.item_id
-        fingerprint = (status, text_update)
-        if self._last_by_item.get(item_id) == fingerprint:
+        """Map one OpenAI CI event to its progress update publishes."""
+        progress = self._progress_for_event(event)
+        if progress is None:
             return
-        self._last_by_item[item_id] = fingerprint
+        status, text_update = progress
 
+        if event.type == "response.code_interpreter_call.in_progress":
+            await self._publish_if_changed(
+                f"{event.item_id}-triggered",
+                "COMPLETED",
+                "**Triggered Tool Calls:**\n - Code Execution",
+            )
+        await self._publish_if_changed(event.item_id, status, text_update)
+
+    @staticmethod
+    def _build_code_execution_message(message: str) -> str:
+        return f"**Code Execution**\n {message}".strip()
+
+    def _progress_for_event(
+        self, event: CodeInterpreterCallEvent
+    ) -> tuple[ActivityStatus, str] | None:
+        """Decode a CI event into its ``(status, text)``, or ``None`` to ignore it."""
+        if event.type == "response.code_interpreter_call.completed":
+            return "COMPLETED", self._build_code_execution_message("")
+        if event.type == "response.code_interpreter_call.in_progress":
+            return "RUNNING", self._build_code_execution_message("Writing Code")
+        if event.type == "response.code_interpreter_call.interpreting":
+            return "RUNNING", self._build_code_execution_message("Executing Code")
+        return None
+
+    async def _publish_if_changed(
+        self, correlation_id: str, status: ActivityStatus, text: str
+    ) -> None:
+        """Publish a progress update unless its ``(status, text)`` is unchanged."""
+        fingerprint = (status, text)
+        if self._last_by_item.get(correlation_id) == fingerprint:
+            return
+        self._last_by_item[correlation_id] = fingerprint
         await self._activity_bus.publish_and_wait_async(
             ActivityProgressUpdate(
-                correlation_id=item_id,
+                correlation_id=correlation_id,
                 status=status,
-                text=text_update,
+                text=text,
             )
         )
 

{unique_toolkit-2026.30.0.dev2.dist-info → unique_toolkit-2026.30.0.dev4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: unique-toolkit
-Version: 2026.30.0.dev2
+Version: 2026.30.0.dev4
 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>

{unique_toolkit-2026.30.0.dev2.dist-info → unique_toolkit-2026.30.0.dev4.dist-info}/RECORD

@@ -176,7 +176,7 @@ unique_toolkit/agentic/tools/a2a/tool/config.py,sha256=v4rZQU42RjUTC5Md-Cye1rUIW
 unique_toolkit/agentic/tools/a2a/tool/service.py,sha256=5jOtXSU9oggG1dVUd7PAb3hd_-MLyGnSR5_lUQvYPfA,22160
 unique_toolkit/agentic/tools/a2a/tool/test/test_service_utils.py,sha256=x4leRxnGgqD-XyXPkW2z1ekv4Ja7EStXd-24LGadPZA,24858
 unique_toolkit/agentic/tools/agent_chunks_hanlder.py,sha256=eO0g46wZOQlmWqYYVGiszRVe8K2LX-9qW30ZCdGg5eE,1943
-unique_toolkit/agentic/tools/config.py,sha256=g_NKV94pq6cZ8nH-C69_BNScyQ-tjRjzYE8IKKqqDag,5726
+unique_toolkit/agentic/tools/config.py,sha256=AOtBn2tL1rIoPPzl1csAHLD5aetYqPL-jAqkIoSBxyE,7468
 unique_toolkit/agentic/tools/experimental/__init__.py,sha256=ArEcXHGPtMRNsDnsyo9v1fev0EZWdJ6D7NWdPEFLQKM,956
 unique_toolkit/agentic/tools/experimental/ask_user_tool/__init__.py,sha256=B8srRVw4vMLa4dZE5yoF1Bqpjlv8moh_m-dP2BVRjDc,375
 unique_toolkit/agentic/tools/experimental/ask_user_tool/config.py,sha256=z95ZaxkMvsmjVaUYWWZrvpD21-Us1KNUrMgXzpF4uo4,5923
@@ -329,7 +329,7 @@ unique_toolkit/experimental/integrations/openai/streaming/event_routing/protocol
 unique_toolkit/experimental/integrations/openai/streaming/event_routing/protocols/chat_completions.py,sha256=BZogC4EO6BFP-enXOJ535gUB8-US9mshRhXNDCfrs_E,1522
 unique_toolkit/experimental/integrations/openai/streaming/event_routing/protocols/responses.py,sha256=bM5qSZjJOTWQyPDUPyMasMwZ-Wu7LQKR64OcKVpUY5E,3294
 unique_toolkit/experimental/integrations/openai/streaming/event_routing/responses/__init__.py,sha256=-8Ey_srOpxX4B_HJhh27h4nZaNC6Y4mk5o8wSLelPwA,847
-unique_toolkit/experimental/integrations/openai/streaming/event_routing/responses/code_interpreter_event_handler.py,sha256=zGR8kZbwE8owrw_hSqfK0ZFBgKBXzDHY2Bk3ihnvwo8,4666
+unique_toolkit/experimental/integrations/openai/streaming/event_routing/responses/code_interpreter_event_handler.py,sha256=3WFT-zuVCrTP01riJY9uuu5U8-tmFUD-XYTZYDrGx4w,6013
 unique_toolkit/experimental/integrations/openai/streaming/event_routing/responses/complete_with_references.py,sha256=rVcIY7CLPJUVWJrtZDZR5RLd3MnuXbsyL-FdpXoVcjQ,26126
 unique_toolkit/experimental/integrations/openai/streaming/event_routing/responses/completed_event_handler.py,sha256=N_ZO79XbKSHvUqQFxWsEvCc6w5kglcP4oTq-uRz5w34,1475
 unique_toolkit/experimental/integrations/openai/streaming/event_routing/responses/stream_event_router.py,sha256=hvQHDPmfYD-ZDRR5W079TFYEgQ-vhIGMNRyagiG6RzM,8280
@@ -406,6 +406,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.30.0.dev2.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
-unique_toolkit-2026.30.0.dev2.dist-info/METADATA,sha256=5dzAWd8OVSASrP4GIyR8e1NDX86GpCYYE8tzzZC4W3s,7426
-unique_toolkit-2026.30.0.dev2.dist-info/RECORD,,
+unique_toolkit-2026.30.0.dev4.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
+unique_toolkit-2026.30.0.dev4.dist-info/METADATA,sha256=4iN85BIBq_wHZenyR9KfKIvdQ9JF699LsQ_PVG3HMFY,7426
+unique_toolkit-2026.30.0.dev4.dist-info/RECORD,,