unique_toolkit 0.8.44__tar.gz → 0.8.45__tar.gz

{unique_toolkit-0.8.44 → unique_toolkit-0.8.45}/CHANGELOG.md

@@ -5,6 +5,9 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), 
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.8.45] - 2025-09-04
+- Introduce handoff capability to tools. with the `takes_control()` function.
+
 ## [0.8.44] - 2025-09-03
 - Refine `EndpointClass` and create `EndpointRequestor`
 

{unique_toolkit-0.8.44 → unique_toolkit-0.8.45}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: unique_toolkit
-Version: 0.8.44
+Version: 0.8.45
 Summary: 
 License: Proprietary
 Author: Cedric Klinkert
@@ -117,6 +117,9 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), 
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.8.45] - 2025-09-04
+- Introduce handoff capability to tools. with the `takes_control()` function.
+
 ## [0.8.44] - 2025-09-03
 - Refine `EndpointClass` and create `EndpointRequestor`
 

{unique_toolkit-0.8.44 → unique_toolkit-0.8.45}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "unique_toolkit"
-version = "0.8.44"
+version = "0.8.45"
 description = ""
 authors = [
     "Cedric Klinkert <cedric.klinkert@unique.ch>",

{unique_toolkit-0.8.44 → unique_toolkit-0.8.45}/unique_toolkit/tools/tool.py

@@ -49,6 +49,14 @@ class Tool(ABC, Generic[ConfigType]):
         """Whether the tool is enabled or not."""
         return self.settings.is_enabled
 
+    def takes_control(self):
+        """
+        Some tools require to take control of the conversation with the user and do not want the orchestrator to intervene.
+        this function indicates whether the tool takes control or not. It yanks the control away from the orchestrator.
+        A typical use-case is deep-research.
+        """
+        return False
+
     @abstractmethod
     def tool_description(self) -> LanguageModelToolDescription:
         raise NotImplementedError

{unique_toolkit-0.8.44 → unique_toolkit-0.8.45}/unique_toolkit/tools/tool_manager.py

@@ -164,6 +164,13 @@ class ToolManager:
     def get_tool_prompts(self) -> list[ToolPrompts]:
         return [tool.get_tool_prompts() for tool in self._tools]
 
+    def does_a_tool_take_control(self, tool_calls: list[LanguageModelFunction]) -> bool:
+        for tool_call in tool_calls:
+            tool_instance = self.get_tool_by_name(tool_call.name)
+            if tool_instance and tool_instance.takes_control():
+                return True
+        return False
+
     async def execute_selected_tools(
         self,
         tool_calls: list[LanguageModelFunction],