versionhq 1.1.9.13__py3-none-any.whl → 1.1.10.2__py3-none-any.whl

versionhq/tool/tool_handler.py

@@ -1,8 +1,8 @@
 from typing import Optional, Any
 from pydantic import InstanceOf
 
-from versionhq.tool.model import ToolSet, InstructorToolSet
-from versionhq._utils.cache_handler import CacheHandler
+from versionhq.tool.model import ToolSet
+from versionhq.tool.cache_handler import CacheHandler, CacheTool
 
 
 class ToolHandler:
@@ -10,34 +10,26 @@ class ToolHandler:
     Record the tool usage by ToolSet instance with cache and error recording.
     """
 
-    last_used_tool: InstanceOf[ToolSet] | InstanceOf[InstructorToolSet]
-    cache: Optional[CacheHandler]
+    last_used_tool: InstanceOf[ToolSet]
+    cache: InstanceOf[CacheHandler] = CacheHandler()
     error: Optional[str]
     should_cache: bool
 
-    def __init__(
-        self,
-        last_used_tool: InstanceOf[ToolSet] | InstanceOf[InstructorToolSet] = None,
-        cache_handler: Optional[CacheHandler] = None,
-        should_cache: bool = True
-    ):
-        self.cache = cache_handler
+    def __init__(self, last_used_tool: InstanceOf[ToolSet] = None, cache_handler: InstanceOf[CacheHandler] = None, should_cache: bool = True):
         self.last_used_tool = last_used_tool
+        self.cache = cache_handler if cache_handler else CacheHandler()
         self.should_cache = should_cache
 
 
-    def record_last_tool_used(
-        self, last_used_tool: InstanceOf[ToolSet] | InstanceOf[InstructorToolSet], output: str, should_cache: bool = True
-    ) -> Any:
-        from versionhq.tool.model import CacheTool
-
+    def record_last_tool_used(self, last_used_tool: InstanceOf[ToolSet], output: str, should_cache: bool = True) -> None:
         self.last_used_tool = last_used_tool
 
-        if self.cache and should_cache and last_used_tool.tool.name != CacheTool().name:
-            self.cache.add(tool=last_used_tool.tool.name, input=last_used_tool.kwargs, output=output)
+        if should_cache:
+            self.cache = CacheHandler()
+            self.cache.add(tool_name=last_used_tool.tool.name, input=str(last_used_tool.kwargs), output=output)
 
 
-    def has_called_before(self, tool_set: ToolSet = None) -> bool:
+    def has_called_before(self, tool_set: InstanceOf[ToolSet] = None) -> bool:
         if tool_set is None or not self.last_used_tool:
             return False
 

{versionhq-1.1.9.13.dist-info → versionhq-1.1.10.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: versionhq
-Version: 1.1.9.13
+Version: 1.1.10.2
 Summary: LLM orchestration frameworks for model-agnostic AI agents that handle complex outbound workflows
 Author-email: Kuriko Iwai <kuriko@versi0n.io>
 License: MIT License
@@ -26,6 +26,7 @@ License: MIT License
         SOFTWARE.
         
 Project-URL: Homepage, https://versi0n.io
+Project-URL: Documentation, https://chief-oxygen-8a2.notion.site/Documentation-17e923685cf98001a5fad5c4b2acd79b?pvs=73
 Project-URL: Repository, https://github.com/versionHQ/multi-agent-system
 Project-URL: Issues, https://github.com/versionHQ/multi-agent-system/issues
 Keywords: orchestration framework,orchestration,ai agent,multi-agent system,RAG,agent
@@ -60,7 +61,7 @@ Requires-Dist: composio-langchain>=0.6.12
 
 ![MIT license](https://img.shields.io/badge/License-MIT-green)
 [![Publisher](https://github.com/versionHQ/multi-agent-system/actions/workflows/publish.yml/badge.svg)](https://github.com/versionHQ/multi-agent-system/actions/workflows/publish.yml)
-![PyPI](https://img.shields.io/badge/PyPI-v1.1.9.3-blue)
+![PyPI](https://img.shields.io/badge/PyPI->=v1.1.10-blue)
 ![python ver](https://img.shields.io/badge/Python-3.12/3.13-purple)
 ![pyenv ver](https://img.shields.io/badge/pyenv-2.5.0-orange)
 
@@ -76,8 +77,9 @@ Messaging workflows are created at individual level, and will be deployed on thi
 
 - [PyPI](https://pypi.org/project/versionhq/)
 - [Github (LLM orchestration)](https://github.com/versionHQ/multi-agent-system)
-- [Github (Test client app)](https://github.com/versionHQ/test-client-app)
-- [Use case](https://versi0n.io/) - client app (alpha)
+- [Doc](https://chief-oxygen-8a2.notion.site/Documentation-17e923685cf98001a5fad5c4b2acd79b?pvs=4)
+<!-- - [Github (Test client app)](https://github.com/versionHQ/test-client-app) -->
+- [Use case](https://versi0n.io/): Client web app for the outbound messaging automation
 
 
 <hr />
@@ -152,6 +154,9 @@ Multiple `agents` can form a `team` to complete complex tasks together.
    from versionhq.agent.model import Agent
    from versionhq.task.model import Task, ResponseField
 
+   def my_callback_func():
+      """callback func"""
+
    agent = Agent(
       role="demo",
       goal="amazing project goal",
@@ -162,13 +167,11 @@ Multiple `agents` can form a `team` to complete complex tasks together.
 
    task = Task(
       description="Amazing task",
-      expected_output_json=True,
-      expected_output_pydantic=False,
-      output_field_list=[
-         ResponseField(title="test1", type=str, required=True),
-         ResponseField(title="test2", type=list, required=True),
+      response_fields=[
+         ResponseField(title="test1", data_type=str, required=True),
+         ResponseField(title="test2", data_type=list, items=str, required=True),
       ],
-      callback=None,
+      callbacks=[my_callback_func]
    )
    res = task.execute_sync(agent=agent, context="amazing context to consider.")
    return res.to_dict()
@@ -192,13 +195,13 @@ This will return a dictionary with keys defined in the `ResponseField`.
 
    task_1 = Task(
       description="Analyze the client's business model.",
-      output_field_list=[ResponseField(title="test1", type=str, required=True),],
+      response_fields=[ResponseField(title="test1", data_type=str, required=True),],
       allow_delegation=True
    )
 
     task_2 = Task(
       description="Define the cohort.",
-      output_field_list=[ResponseField(title="test1", type=int, required=True),],
+      response_fields=[ResponseField(title="test1", data_type=int, required=True),],
       allow_delegation=False
    )
 
@@ -234,7 +237,7 @@ Tasks can be delegated to a team manager, peers in the team, or completely new a
    - [Composio](https://composio.dev/): Conect RAG agents with external tools, Apps, and APIs to perform actions and receive triggers. We use [tools](https://composio.dev/tools) and [RAG tools](https://app.composio.dev/app/ragtool) from Composio toolset.
 
 **Deployment**
-   - Python: Primary programming language. We use 3.12 in this project
+   - Python: Primary programming language. v3.13 is recommended.
    - [uv](https://docs.astral.sh/uv/): Python package installer and resolver
    - [pre-commit](https://pre-commit.com/): Manage and maintain pre-commit hooks
    - [setuptools](https://pypi.org/project/setuptools/): Build python modules
@@ -306,19 +309,17 @@ src/
 
 ## Contributing
 
-1. Fork the repository
-
-2. Create your feature branch (`git checkout -b feature/your-amazing-feature`)
+1. Create your feature branch (`git checkout -b feature/your-amazing-feature`)
 
-3. Create amazing features
+2. Create amazing features
 
-4. Test the features using the `tests` directory.
+3. Test the features using the `tests` directory.
 
    - Add a test function to respective components in the `tests` directory.
-   - Add your `LITELLM_API_KEY`, `OPENAI_API_KEY`, `COMPOSIO_API_KEY`, `DEFAULT_USER_ID` to the Github `repository secrets` @ settings > secrets & variables > Actions.
+   - Add your `LITELLM_API_KEY`, `OPENAI_API_KEY`, `COMPOSIO_API_KEY`, `DEFAULT_USER_ID` to the Github `repository secrets` located at settings > secrets & variables > Actions.
    - Run a test.
       ```
-      uv run pytest tests -vv
+      uv run pytest tests -vv --cache-clear
       ```
 
    **pytest**
@@ -326,10 +327,10 @@ src/
    * When adding a new file to `tests`, name the file ended with `_test.py`.
    * When adding a new feature to the file, name the feature started with `test_`.
 
-5. Pull the latest version of source code from the main branch (`git pull origin main`) *Address conflicts if any.
-6. Commit your changes (`git add .` / `git commit -m 'Add your-amazing-feature'`)
-7. Push to the branch (`git push origin feature/your-amazing-feature`)
-8. Open a pull request
+4. Pull the latest version of source code from the main branch (`git pull origin main`) *Address conflicts if any.
+5. Commit your changes (`git add .` / `git commit -m 'Add your-amazing-feature'`)
+6. Push to the branch (`git push origin feature/your-amazing-feature`)
+7. Open a pull request
 
 
 **Optional**
@@ -342,7 +343,7 @@ src/
    ```
    The frontend will be available at `http://localhost:3000`.
 
-* `production` is available at `https://versi0n.io`. Currently, we are running alpha test.
+* `production` use case is available at `https://versi0n.io`. Currently, we are running alpha test.
 
 
 

versionhq-1.1.10.2.dist-info/RECORD

@@ -0,0 +1,44 @@
+versionhq/__init__.py,sha256=GkGY1ob5I6BdJjds_hdxOYWJ8n3EIWjTAQ48v1UheoQ,951
+versionhq/_utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+versionhq/_utils/i18n.py,sha256=TwA_PnYfDLA6VqlUDPuybdV9lgi3Frh_ASsb_X8jJo8,1483
+versionhq/_utils/logger.py,sha256=U-MpeGueA6YS8Ptfy0VnU_ePsZP-8Pvkvi0tZ4s_UMg,1438
+versionhq/_utils/process_config.py,sha256=jbPGXK2Kb4iyCugJ3FwRJuU0wL5Trq2x4xFQz2uOyFY,746
+versionhq/_utils/rpm_controller.py,sha256=dUgFd6JtdjiLLTRmrjsBHdTaLn73XFuKpLbJh7thf2A,2289
+versionhq/_utils/usage_metrics.py,sha256=hhq1OCW8Z4V93vwW2O2j528EyjOlF8wlTsX5IL-7asA,1106
+versionhq/agent/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+versionhq/agent/model.py,sha256=g8S8d0uHORrpq2mAUzo1Tx1hZmtYKk8HT55iOICSte8,20344
+versionhq/agent/parser.py,sha256=Z_swUPO3piJQuYU8oVYwXWeR2zjmNb4PxbXZeR-GlIg,4694
+versionhq/agent/TEMPLATES/Backstory.py,sha256=Gub3SUbdrNAwV0ITLYdZFJ4VFZRDfDRPdBZrtlknrds,554
+versionhq/agent/TEMPLATES/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+versionhq/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+versionhq/clients/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+versionhq/clients/customer/__init__.py,sha256=-YXh1FQfvpfLacK8SUC7bD7Wx_eIEi4yrkCC_cUasFg,217
+versionhq/clients/customer/model.py,sha256=_AtaVVMm9MgCwrQ-HTRQ2oXUMKrSCEfZwE2JdRz3xTw,2508
+versionhq/clients/product/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+versionhq/clients/product/model.py,sha256=hLTvvQsatNuq0DtyTqpP_gRKgnv6N4uRjavnGfk7b6Y,3695
+versionhq/clients/workflow/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+versionhq/clients/workflow/model.py,sha256=FNftenLLoha0bkivrjId32awLHAkBwIT8iNljdic_bw,6003
+versionhq/llm/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+versionhq/llm/llm_vars.py,sha256=SSrkrph1Nf6nvwsqf48vMovs2byxbL33CI8kcoakHK0,8759
+versionhq/llm/model.py,sha256=2waDxP_pISqqF2MTTdvzARi0hS9xna_d7YoGMwf8RGM,13020
+versionhq/storage/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+versionhq/storage/task_output_storage.py,sha256=xoBJHeqUyQt6iJoR1WQTghP-fyxXL66qslpX1QC2-4o,4827
+versionhq/task/__init__.py,sha256=l2r_g01i91JAGlOoHZP_Gh2WCk6mo9D19lcqt7sKMpQ,186
+versionhq/task/formatter.py,sha256=N8Kmk9vtrMtBdgJ8J7RmlKNMdZWSmV8O1bDexmCWgU0,643
+versionhq/task/log_handler.py,sha256=KJRrcNZgFSKhlNzvtYFnvtp6xukaF1s7ifX9u4zWrN8,1683
+versionhq/task/model.py,sha256=Kj_a67TitiQsy9uZST7yDdi3mXcQqRhbdOF3DZ_fwjA,26207
+versionhq/team/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+versionhq/team/model.py,sha256=NzcRXWwP0adWL9vsnsmI-A5dOcE3199FGmGgemUB2VA,20043
+versionhq/team/team_planner.py,sha256=XkM93ItI59cuEzMN1s1jJ-B4LyalSZnAlYBY5SUCbVs,3603
+versionhq/tool/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+versionhq/tool/cache_handler.py,sha256=iL8FH7X0G-cdT0uhJwzuhLDaadTXOdfybZcDy151-es,1085
+versionhq/tool/composio_tool.py,sha256=38mEiVvTkuw1BLD233Bl1Gwxbpss1yfQiZLTWwX6BdA,8648
+versionhq/tool/composio_tool_vars.py,sha256=FvBuEXsOQUYnN7RTFxT20kAkiEYkxWKkiVtgpqOzKZQ,1843
+versionhq/tool/decorator.py,sha256=C4ZM7Xi2gwtEMaSeRo-geo_g_MAkY77WkSLkAuY0AyI,1205
+versionhq/tool/model.py,sha256=5qG-OH7zohvepPDOjdjDulhEqmNUM4osiyk5LaxmSiU,12333
+versionhq/tool/tool_handler.py,sha256=2m41K8qo5bGCCbwMFferEjT-XZ-mE9F0mDUOBkgivOI,1416
+versionhq-1.1.10.2.dist-info/LICENSE,sha256=7CCXuMrAjPVsUvZrsBq9DsxI2rLDUSYXR_qj4yO_ZII,1077
+versionhq-1.1.10.2.dist-info/METADATA,sha256=UJJNvaPJqRsEQepGITgpHi6rcGmpXPO-zS_tuNVJpiY,16356
+versionhq-1.1.10.2.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+versionhq-1.1.10.2.dist-info/top_level.txt,sha256=DClQwxDWqIUGeRJkA8vBlgeNsYZs4_nJWMonzFt5Wj0,10
+versionhq-1.1.10.2.dist-info/RECORD,,

versionhq/_utils/cache_handler.py

@@ -1,13 +0,0 @@
-from typing import Any, Dict, Optional
-
-from pydantic import BaseModel, PrivateAttr
-
-
-class CacheHandler(BaseModel):
-    _cache: Dict[str, Any] = PrivateAttr(default_factory=dict)
-
-    def add(self, tool: str, input: str, output: Any) -> None:
-        self._cache[f"{tool}-{input}"] = output
-
-    def read(self, tool: str, input: str) -> Optional[str]:
-        return self._cache.get(f"{tool}-{input}")

versionhq-1.1.9.13.dist-info/RECORD

@@ -1,43 +0,0 @@
-versionhq/__init__.py,sha256=3nslg_kJtwGMpYO4ZHQnrpnjxr0-n_xe5MeeQKwja0U,951
-versionhq/_utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-versionhq/_utils/cache_handler.py,sha256=3-lw_5ZMWC8hnPAkSQULJ2V1FvZZ-wg9mQaUJGSOjI8,403
-versionhq/_utils/i18n.py,sha256=TwA_PnYfDLA6VqlUDPuybdV9lgi3Frh_ASsb_X8jJo8,1483
-versionhq/_utils/logger.py,sha256=cPxDz1YrMH4ZsLzLc11XrKBfQbLWNNXRUEVUgjAeeOE,1591
-versionhq/_utils/process_config.py,sha256=UqoWD5IR4VLxEDGxIyVUylw_ppXwk8Wx1ynVuD-pUSg,822
-versionhq/_utils/rpm_controller.py,sha256=dUgFd6JtdjiLLTRmrjsBHdTaLn73XFuKpLbJh7thf2A,2289
-versionhq/_utils/usage_metrics.py,sha256=hhq1OCW8Z4V93vwW2O2j528EyjOlF8wlTsX5IL-7asA,1106
-versionhq/agent/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-versionhq/agent/model.py,sha256=LFkD00zIeIfntwvebomYX6zTqIMQVkQYFEKjxOtTaPQ,18598
-versionhq/agent/parser.py,sha256=Z_swUPO3piJQuYU8oVYwXWeR2zjmNb4PxbXZeR-GlIg,4694
-versionhq/agent/TEMPLATES/Backstory.py,sha256=cdngBx1GEv7nroR46FEhnysnBJ9mEVL763_9np6Skkc,395
-versionhq/agent/TEMPLATES/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-versionhq/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-versionhq/clients/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-versionhq/clients/customer/__init__.py,sha256=-YXh1FQfvpfLacK8SUC7bD7Wx_eIEi4yrkCC_cUasFg,217
-versionhq/clients/customer/model.py,sha256=_AtaVVMm9MgCwrQ-HTRQ2oXUMKrSCEfZwE2JdRz3xTw,2508
-versionhq/clients/product/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-versionhq/clients/product/model.py,sha256=c_watpIg-FzpJ2tMml6M1EbAckgGZOqTSc_GZ3Kb_r4,3676
-versionhq/clients/workflow/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-versionhq/clients/workflow/model.py,sha256=Onu3O4y_wroOnEPf7QZkeZp_WPHfk2DVQGdtoXfZvbc,5984
-versionhq/llm/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-versionhq/llm/llm_vars.py,sha256=YZoXqFBW7XpclUZ14_AAz7WOjoyCXnGcI959GSpX2q0,5343
-versionhq/llm/model.py,sha256=mXzSuf1s6MebGT7_yqgNppde0NIlAF8bjIXAp2MZ9Uw,8247
-versionhq/storage/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-versionhq/storage/task_output_storage.py,sha256=xoBJHeqUyQt6iJoR1WQTghP-fyxXL66qslpX1QC2-4o,4827
-versionhq/task/__init__.py,sha256=g4mCATnn1mUXxsfQ5p6IpPawr8O421wVIT8kMKEcxQw,180
-versionhq/task/formatter.py,sha256=N8Kmk9vtrMtBdgJ8J7RmlKNMdZWSmV8O1bDexmCWgU0,643
-versionhq/task/log_handler.py,sha256=KJRrcNZgFSKhlNzvtYFnvtp6xukaF1s7ifX9u4zWrN8,1683
-versionhq/task/model.py,sha256=e4baXfxFSrV_rEntD7CQFq7J86qTa5E5xleZKGoFZxE,19705
-versionhq/team/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-versionhq/team/model.py,sha256=E52OUVzUtvR--51SFRJos3JdYKri1t2jbvvzoOvShQc,20181
-versionhq/team/team_planner.py,sha256=uzX2yed7A7gNSs6qH5jIq2zXMVF5BwQQ4HPATsB9DSQ,3675
-versionhq/tool/__init__.py,sha256=FvBuEXsOQUYnN7RTFxT20kAkiEYkxWKkiVtgpqOzKZQ,1843
-versionhq/tool/composio_tool.py,sha256=BJqaA1NhV0BT9AdY7OLCGpsAI3VEuCKnOS6D9vuU4zQ,8630
-versionhq/tool/decorator.py,sha256=W_WjzZy8y43AoiFjHLPUQfNipmpOPe-wQknCWloPwmY,1195
-versionhq/tool/model.py,sha256=yrvog9wh-cuIXRngwXOzPlHwBO3UhUFxCH3vQ5qRKBA,6823
-versionhq/tool/tool_handler.py,sha256=A3zUkZkx4JEpFHI2uBkHDpzWfADw-bCYUQhgm6rpITM,1569
-versionhq-1.1.9.13.dist-info/LICENSE,sha256=7CCXuMrAjPVsUvZrsBq9DsxI2rLDUSYXR_qj4yO_ZII,1077
-versionhq-1.1.9.13.dist-info/METADATA,sha256=bVbnGqU2iPjmCO4lmAdjal6PzY7FWYARt_hM3j7rSIo,16071
-versionhq-1.1.9.13.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-versionhq-1.1.9.13.dist-info/top_level.txt,sha256=DClQwxDWqIUGeRJkA8vBlgeNsYZs4_nJWMonzFt5Wj0,10
-versionhq-1.1.9.13.dist-info/RECORD,,