unique_toolkit 0.8.44__py3-none-any.whl → 0.8.45__py3-none-any.whl

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/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],

{unique_toolkit-0.8.44.dist-info → unique_toolkit-0.8.45.dist-info}/METADATA

@@ -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.dist-info → unique_toolkit-0.8.45.dist-info}/RECORD

@@ -125,14 +125,14 @@ unique_toolkit/tools/mcp/tool_wrapper.py,sha256=w7Fbo4FSMYvtgSq7Sqt1dmAPvqHjoBQS
 unique_toolkit/tools/schemas.py,sha256=rArQccbfIv7CWcozClAZ-BVlOwAsjpgL8KUab_WeO3k,4817
 unique_toolkit/tools/test/test_mcp_manager.py,sha256=dySiytBUfRjTOzwY_oGKi_jT6BNVgzZuh1du-EvbcJ4,15627
 unique_toolkit/tools/test/test_tool_progress_reporter.py,sha256=GTtmBqOUo0-4fh_q0lRgxDhwKeankc3FHFD5ULZAm4Y,6299
-unique_toolkit/tools/tool.py,sha256=6kw8oadYfFlV0LEPDTHWiz0l5q_8gM-hLpLjmUn_VNs,5943
-unique_toolkit/tools/tool_manager.py,sha256=uW1uf8mYvbnBN_TVa4L79p_8Sf9HyY4V_nXZqrh3fPM,10206
+unique_toolkit/tools/tool.py,sha256=PN3YBmiWebWvuZeT_0voSI8pH_KO0sNoOxdSPNkVrXk,6307
+unique_toolkit/tools/tool_manager.py,sha256=sadEM2bnHAEFfwulVau4cYflL7ThOz7L51aI_w6Fl1k,10512
 unique_toolkit/tools/tool_progress_reporter.py,sha256=ixud9VoHey1vlU1t86cW0-WTvyTwMxNSWBon8I11SUk,7955
 unique_toolkit/tools/utils/execution/execution.py,sha256=vjG2Y6awsGNtlvyQAGCTthQ5thWHYnn-vzZXaYLb3QE,7922
 unique_toolkit/tools/utils/source_handling/schema.py,sha256=vzAyf6ZWNexjMO0OrnB8y2glGkvAilmGGQXd6zcDaKw,870
 unique_toolkit/tools/utils/source_handling/source_formatting.py,sha256=C7uayNbdkNVJdEARA5CENnHtNY1SU6etlaqbgHNyxaQ,9152
 unique_toolkit/tools/utils/source_handling/tests/test_source_formatting.py,sha256=oM5ZxEgzROrnX1229KViCAFjRxl9wCTzWZoinYSHleM,6979
-unique_toolkit-0.8.44.dist-info/LICENSE,sha256=GlN8wHNdh53xwOPg44URnwag6TEolCjoq3YD_KrWgss,193
-unique_toolkit-0.8.44.dist-info/METADATA,sha256=qgsVibZKJU2Colr_5lqRIr2glNjV_48wFO_xqjnskF0,30583
-unique_toolkit-0.8.44.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-unique_toolkit-0.8.44.dist-info/RECORD,,
+unique_toolkit-0.8.45.dist-info/LICENSE,sha256=GlN8wHNdh53xwOPg44URnwag6TEolCjoq3YD_KrWgss,193
+unique_toolkit-0.8.45.dist-info/METADATA,sha256=XvXW7ImDi9kJeLwGGM64V6bg-VayuERtOKLDjFWxhqQ,30687
+unique_toolkit-0.8.45.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+unique_toolkit-0.8.45.dist-info/RECORD,,