versionhq 1.1.7.5__tar.gz → 1.1.7.8__tar.gz

{versionhq-1.1.7.5 → versionhq-1.1.7.8}/.gitignore

@@ -1,4 +1,5 @@
 knowledge/
+memory/
 
 composio.py
 memo.txt
@@ -8,6 +9,7 @@ build/
 .pypirc
 uploads/
 sample_dataset/
+chroma.sqlite3
 *egg-info/
 
 __pycache__/

{versionhq-1.1.7.5 → versionhq-1.1.7.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: versionhq
-Version: 1.1.7.5
+Version: 1.1.7.8
 Summary: LLM orchestration frameworks for model-agnostic AI agents that handle complex outbound workflows
 Author-email: Kuriko Iwai <kuriko@versi0n.io>
 License: MIT License
@@ -32,6 +32,9 @@ Keywords: orchestration framework,orchestration,ai agent,multi-agent system,RAG,
 Classifier: Programming Language :: Python
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Build Tools
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
@@ -43,12 +46,12 @@ Requires-Dist: typing
 Requires-Dist: json-repair>=0.31.0
 Requires-Dist: litellm>=1.55.8
 Requires-Dist: openai>=1.57.0
-Requires-Dist: composio-openai>=0.6.0
-Requires-Dist: pre-commit>=4.0.1
-Requires-Dist: gunicorn>=23.0.0
+Requires-Dist: composio-openai>=0.6.9
 Requires-Dist: composio>=0.1.0
 Requires-Dist: setuptools>=75.6.0
 Requires-Dist: wheel>=0.45.1
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: appdirs>=1.4.4
 
 # Overview
 
@@ -56,7 +59,7 @@ Requires-Dist: wheel>=0.45.1
 [![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.7.5-blue)
 ![python ver](https://img.shields.io/badge/Python-3.12/3.13-purple)
-![pyenv ver](https://img.shields.io/badge/pyenv-2.4.23-orange)
+![pyenv ver](https://img.shields.io/badge/pyenv-2.5.0-orange)
 
 
 An LLM orchestration frameworks for multi-agent systems with RAG to autopilot outbound workflows.
@@ -276,8 +279,7 @@ src/
    ```
    uv venv
    source .venv/bin/activate
-
-   uv pip install -r requirements.txt -v
+   uv pip sync
    ```
 
 * In case of AssertionError/module mismatch, run Python version control using `.pyenv`

{versionhq-1.1.7.5 → versionhq-1.1.7.8}/README.md

@@ -4,7 +4,7 @@
 [![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.7.5-blue)
 ![python ver](https://img.shields.io/badge/Python-3.12/3.13-purple)
-![pyenv ver](https://img.shields.io/badge/pyenv-2.4.23-orange)
+![pyenv ver](https://img.shields.io/badge/pyenv-2.5.0-orange)
 
 
 An LLM orchestration frameworks for multi-agent systems with RAG to autopilot outbound workflows.
@@ -224,8 +224,7 @@ src/
    ```
    uv venv
    source .venv/bin/activate
-
-   uv pip install -r requirements.txt -v
+   uv pip sync
    ```
 
 * In case of AssertionError/module mismatch, run Python version control using `.pyenv`

{versionhq-1.1.7.5 → versionhq-1.1.7.8}/pyproject.toml

@@ -15,7 +15,7 @@ exclude = ["test*", "__pycache__"]
 
 [project]
 name = "versionhq"
-version = "1.1.7.5"
+version = "1.1.7.8"
 authors = [{ name = "Kuriko Iwai", email = "kuriko@versi0n.io" }]
 description = "LLM orchestration frameworks for model-agnostic AI agents that handle complex outbound workflows"
 readme = "README.md"
@@ -31,17 +31,20 @@ dependencies = [
   "json-repair>=0.31.0",
   "litellm>=1.55.8",
   "openai>=1.57.0",
-  "composio-openai>=0.6.0",
-  "pre-commit>=4.0.1",
-  "gunicorn>=23.0.0",
+  "composio-openai>=0.6.9",
   "composio>=0.1.0",
   "setuptools>=75.6.0",
   "wheel>=0.45.1",
+  "python-dotenv>=1.0.0",
+  "appdirs>=1.4.4",
 ]
 classifiers = [
   "Programming Language :: Python",
   "License :: OSI Approved :: MIT License",
   "Operating System :: OS Independent",
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "Topic :: Software Development :: Build Tools",
 ]
 
 [project.urls]
@@ -52,10 +55,9 @@ Issues = "https://github.com/versionHQ/multi-agent-system/issues"
 [tool.uv]
 dev-dependencies = [
   "mypy>=1.10.0",
-  "pre-commit>=3.6.0",
+  "pre-commit>=4.0.1",
   "pytest>=8.0.0",
   "pytest-vcr>=1.0.2",
-  "python-dotenv>=1.0.0",
   "black",
   "bandit",
   "twine",

versionhq-1.1.7.8/requirements-dev.txt

@@ -0,0 +1,9 @@
+mypy>=1.10.0
+pre-commit>=4.0.1
+pytest>=8.0.0
+pytest-vcr>=1.0.2
+python-dotenv>=1.0.0
+black
+bandit
+twine
+pytest>=8.3.4

versionhq-1.1.7.8/requirements.txt

@@ -0,0 +1,220 @@
+# This file was autogenerated by uv via the following command:
+#    uv pip compile pyproject.toml -o requirements.txt
+aiohappyeyeballs==2.4.4
+    # via aiohttp
+aiohttp==3.11.11
+    # via
+    #   composio-core
+    #   litellm
+aiosignal==1.3.2
+    # via aiohttp
+annotated-types==0.7.0
+    # via pydantic
+anyio==4.7.0
+    # via
+    #   httpx
+    #   openai
+    #   starlette
+appdirs==1.4.4
+    # via versionhq (pyproject.toml)
+attrs==24.3.0
+    # via
+    #   aiohttp
+    #   jsonschema
+    #   referencing
+bcrypt==4.2.1
+    # via paramiko
+certifi==2024.12.14
+    # via
+    #   httpcore
+    #   httpx
+    #   requests
+    #   sentry-sdk
+cffi==1.17.1
+    # via
+    #   cryptography
+    #   pynacl
+charset-normalizer==3.4.1
+    # via requests
+click==8.1.8
+    # via
+    #   composio-core
+    #   litellm
+    #   uvicorn
+composio==0.1.0
+    # via versionhq (pyproject.toml)
+composio-core==0.6.9
+    # via composio-openai
+composio-openai==0.6.9
+    # via versionhq (pyproject.toml)
+cryptography==44.0.0
+    # via paramiko
+distro==1.9.0
+    # via openai
+fastapi==0.115.6
+    # via composio-core
+filelock==3.16.1
+    # via huggingface-hub
+frozenlist==1.5.0
+    # via
+    #   aiohttp
+    #   aiosignal
+fsspec==2024.12.0
+    # via huggingface-hub
+h11==0.14.0
+    # via
+    #   httpcore
+    #   uvicorn
+httpcore==1.0.7
+    # via httpx
+httpx==0.27.2
+    # via
+    #   litellm
+    #   openai
+huggingface-hub==0.27.0
+    # via tokenizers
+idna==3.10
+    # via
+    #   anyio
+    #   httpx
+    #   requests
+    #   yarl
+importlib-metadata==8.5.0
+    # via
+    #   composio-core
+    #   litellm
+inflection==0.5.1
+    # via composio-core
+jinja2==3.1.5
+    # via litellm
+jiter==0.8.2
+    # via openai
+json-repair==0.35.0
+    # via versionhq (pyproject.toml)
+jsonref==1.1.0
+    # via composio-core
+jsonschema==4.23.0
+    # via
+    #   composio-core
+    #   litellm
+jsonschema-specifications==2024.10.1
+    # via jsonschema
+litellm==1.56.5
+    # via versionhq (pyproject.toml)
+markdown-it-py==3.0.0
+    # via rich
+markupsafe==3.0.2
+    # via
+    #   jinja2
+    #   werkzeug
+mdurl==0.1.2
+    # via markdown-it-py
+multidict==6.1.0
+    # via
+    #   aiohttp
+    #   yarl
+openai==1.58.1
+    # via
+    #   versionhq (pyproject.toml)
+    #   composio-openai
+    #   litellm
+packaging==24.2
+    # via huggingface-hub
+paramiko==3.5.0
+    # via composio-core
+propcache==0.2.1
+    # via
+    #   aiohttp
+    #   yarl
+pycparser==2.22
+    # via cffi
+pydantic==2.10.4
+    # via
+    #   versionhq (pyproject.toml)
+    #   composio-core
+    #   fastapi
+    #   litellm
+    #   openai
+pydantic-core==2.27.2
+    # via pydantic
+pygments==2.18.0
+    # via rich
+pynacl==1.5.0
+    # via paramiko
+pyperclip==1.9.0
+    # via composio-core
+pysher==1.0.8
+    # via composio-core
+python-dotenv==1.0.1
+    # via
+    #   versionhq (pyproject.toml)
+    #   litellm
+pyyaml==6.0.2
+    # via huggingface-hub
+referencing==0.35.1
+    # via
+    #   jsonschema
+    #   jsonschema-specifications
+regex==2024.11.6
+    # via
+    #   versionhq (pyproject.toml)
+    #   tiktoken
+requests==2.32.3
+    # via
+    #   versionhq (pyproject.toml)
+    #   composio-core
+    #   huggingface-hub
+    #   pysher
+    #   tiktoken
+rich==13.9.4
+    # via composio-core
+rpds-py==0.22.3
+    # via
+    #   jsonschema
+    #   referencing
+semver==3.0.2
+    # via composio-core
+sentry-sdk==2.19.2
+    # via composio-core
+setuptools==75.6.0
+    # via versionhq (pyproject.toml)
+sniffio==1.3.1
+    # via
+    #   anyio
+    #   httpx
+    #   openai
+starlette==0.41.3
+    # via fastapi
+tiktoken==0.8.0
+    # via litellm
+tokenizers==0.21.0
+    # via litellm
+tqdm==4.67.1
+    # via
+    #   huggingface-hub
+    #   openai
+typing==3.10.0.0
+    # via versionhq (pyproject.toml)
+typing-extensions==4.12.2
+    # via
+    #   fastapi
+    #   huggingface-hub
+    #   openai
+    #   pydantic
+    #   pydantic-core
+urllib3==2.3.0
+    # via
+    #   requests
+    #   sentry-sdk
+uvicorn==0.34.0
+    # via composio-core
+websocket-client==1.8.0
+    # via pysher
+werkzeug==3.1.3
+    # via versionhq (pyproject.toml)
+wheel==0.45.1
+    # via versionhq (pyproject.toml)
+yarl==1.18.3
+    # via aiohttp
+zipp==3.21.0
+    # via importlib-metadata

{versionhq-1.1.7.5 → versionhq-1.1.7.8}/src/versionhq/__init__.py

@@ -17,7 +17,7 @@ from versionhq.team.model import Team, TeamOutput
 from versionhq.tool.model import Tool
 
 
-__version__ = "1.1.7.5"
+__version__ = "1.1.7.8"
 __all__ = [
     "Agent",
     "Customer",

{versionhq-1.1.7.5 → versionhq-1.1.7.8}/src/versionhq/_utils/process_config.py

@@ -2,9 +2,7 @@ from typing import Any, Dict, Type
 from pydantic import BaseModel
 
 
-def process_config(
-    values_to_update: Dict[str, Any], model_class: Type[BaseModel]
-) -> Dict[str, Any]:
+def process_config(values_to_update: Dict[str, Any], model_class: Type[BaseModel]) -> Dict[str, Any]:
     """
     Process the config dictionary and update the values accordingly.
     Refer to the Pydantic model class for field validation.
@@ -15,7 +13,7 @@ def process_config(
     else:
         return values_to_update
 
-    # copy values from config to the model's attributes if the attribute isn't already set.
+
     for key, value in config.items():
         if key not in model_class.model_fields or values_to_update.get(key) is not None:
             continue

{versionhq-1.1.7.5 → versionhq-1.1.7.8}/src/versionhq/agent/model.py

@@ -1,7 +1,7 @@
 import os
 import uuid
 from abc import ABC
-from typing import Any, Dict, List, Optional, TypeVar, Union
+from typing import Any, Dict, List, Optional, TypeVar
 from dotenv import load_dotenv
 from pydantic import UUID4, BaseModel, Field, InstanceOf, PrivateAttr, model_validator, field_validator
 from pydantic_core import PydanticCustomError
@@ -22,7 +22,7 @@ load_dotenv(override=True)
 T = TypeVar("T", bound="Agent")
 
 
-# def _format_answer(agent, answer: str) -> Union[AgentAction, AgentFinish]:
+# def _format_answer(agent, answer: str) -> AgentAction | AgentFinish:
 #     return AgentParser(agent=agent).parse(answer)
 
 # def mock_agent_ops_provider():
@@ -85,7 +85,7 @@ class Agent(ABC, BaseModel):
     """
 
     __hash__ = object.__hash__
-    _logger: Logger = PrivateAttr(default_factory=lambda: Logger(verbose=False))
+    _logger: Logger = PrivateAttr(default_factory=lambda: Logger(verbose=True))
     _rpm_controller: Optional[RPMController] = PrivateAttr(default=None)
     _request_within_rpm_limit: Any = PrivateAttr(default=None)
     _token_process: TokenProcess = PrivateAttr(default_factory=TokenProcess)
@@ -111,8 +111,8 @@ class Agent(ABC, BaseModel):
     step_callback: Optional[Any] = Field(default=None,description="Callback to be executed after each step of the agent execution")
 
     # llm settings cascaded to the LLM model
-    llm: Union[str, InstanceOf[LLM], Any] = Field(default=None)
-    function_calling_llm: Union[str, InstanceOf[LLM], Any] = Field(default=None)
+    llm: str | InstanceOf[LLM] | Any = Field(default=None)
+    function_calling_llm: str | InstanceOf[LLM] | Any = Field(default=None)
     respect_context_window: bool = Field(default=True,description="Keep messages under the context window size by summarizing content")
     max_tokens: Optional[int] = Field(default=None, description="max. number of tokens for the agent's execution")
     max_execution_time: Optional[int] = Field(default=None, description="max. execution time for an agent to execute a task")
@@ -327,7 +327,7 @@ class Agent(ABC, BaseModel):
         messages = []
         messages.append({"role": "user", "content": prompts})  #! REFINEME
         messages.append({"role": "assistant", "content": self.backstory})
-        print("Messages sent to the model:", messages)
+        self._logger.log(level="info", message=f"Messages sent to the model: {messages}", color="blue")
 
         callbacks = kwargs.get("callbacks", None)
 
@@ -338,7 +338,7 @@ class Agent(ABC, BaseModel):
             callbacks=callbacks,
         )
         task_execution_counter += 1
-        print("Agent's #1 res: ", response)
+        self._logger.log(level="info", message=f"Agent's first response: {response}", color="blue")
 
         if (response is None or response == "") and task_execution_counter < self.max_retry_limit:
             while task_execution_counter <= self.max_retry_limit:
@@ -349,10 +349,10 @@ class Agent(ABC, BaseModel):
                     callbacks=callbacks,
                 )
                 task_execution_counter += 1
-                print(f"Agent's #{task_execution_counter} res: ", response)
+                self._logger.log(level="info", message=f"Agent's next response: {response}", color="blue")
 
         elif response is None or response == "":
-            print("Received None or empty response from LLM call.")
+            self._logger.log(level="error", message="Received None or empty response from the model", color="red")
             raise ValueError("Invalid response from LLM call - None or empty.")
 
         return {"output": response.output if hasattr(response, "output") else response}

{versionhq-1.1.7.5 → versionhq-1.1.7.8}/src/versionhq/agent/parser.py

@@ -1,5 +1,5 @@
 import re
-from typing import Any, Union
+from typing import Any
 from json_repair import repair_json
 
 from versionhq._utils.i18n import I18N
@@ -70,7 +70,7 @@ class AgentParser:
     def __init__(self, agent: Any):
         self.agent = agent
 
-    def parse(self, text: str) -> Union[AgentAction, AgentFinish]:
+    def parse(self, text: str) -> AgentAction | AgentFinish:
         thought = self._extract_thought(text)
         includes_answer = FINAL_ANSWER_ACTION in text
         regex = (

{versionhq-1.1.7.5 → versionhq-1.1.7.8}/src/versionhq/clients/workflow/model.py

@@ -1,8 +1,8 @@
 import uuid
 from abc import ABC
 from datetime import date, datetime, time, timedelta
-from typing import Any, Dict, List, Union, Callable, Type, Optional, get_args, get_origin
-from pydantic import UUID4, InstanceOf, BaseModel, ConfigDict, Field, create_model, field_validator, model_validator
+from typing import Any, Dict, List, Callable, Type, Optional, get_args, get_origin
+from pydantic import UUID4, InstanceOf, BaseModel, ConfigDict, Field, field_validator, model_validator
 from pydantic_core import PydanticCustomError
 
 from versionhq.clients.product.model import Product
@@ -12,7 +12,7 @@ from versionhq.team.model import Team
 
 
 class ScoreFormat:
-    def __init__(self, rate: Union[float, int] = 0, weight: int = 1):
+    def __init__(self, rate: float | int = 0, weight: int = 1):
         self.rate = rate
         self.weight = weight
         self.aggregate = rate * weight
@@ -39,7 +39,7 @@ class Score:
 
 
     def result(self) -> int:
-        aggregate_score = self.brand_tone.aggregate + self.audience.aggregate + self.track_record.aggregate
+        aggregate_score = int(self.brand_tone.aggregate) + int(self.audience.aggregate) + int(self.track_record.aggregate)
         denominator = self.brand_tone.weight + self.audience.weight + self.track_record.weight
 
         for k, v in self.kwargs.items():
@@ -57,11 +57,12 @@ class MessagingComponent(ABC, BaseModel):
     layer_id: int = Field(default=0, description="add id of the layer: 0, 1, 2")
     message: str = Field(default=None, max_length=1024, description="text message content to be sent")
     interval: Optional[str] = Field(
-        default=None,description="interval to move on to the next layer. if this is the last layer, set as `None`")
-    score: Union[float, InstanceOf[Score]] = Field(default=None)
+        default=None, description="interval to move on to the next layer. if this is the last layer, set as `None`"
+    )
+    score: float | InstanceOf[Score] = Field(default=None)
 
 
-    def store_scoring_result(self, scoring_subject: str, score_raw: Union[int, Score, ScoreFormat] = None):
+    def store_scoring_result(self, scoring_subject: str, score_raw: int | Score | ScoreFormat = None):
         """
         Set up the `score` field
         """
@@ -109,8 +110,11 @@ class MessagingWorkflow(ABC, BaseModel):
     product: InstanceOf[Product] = Field(default=None)
     customer: InstanceOf[Customer] = Field(default=None)
 
-    metrics: Union[List[Dict[str, Any]], List[str]] = Field(
-        default=None, max_length=256, description="store metrics that used to predict and track the performance of this workflow.")
+    metrics: List[Dict[str, Any]] | List[str] = Field(
+        default=None,
+        max_length=256,
+        description="store metrics that used to predict and track the performance of this workflow."
+    )
 
 
     @property

{versionhq-1.1.7.5 → versionhq-1.1.7.8}/src/versionhq/llm/model.py

@@ -7,7 +7,7 @@ import litellm
 from dotenv import load_dotenv
 from litellm import get_supported_openai_params
 from contextlib import contextmanager
-from typing import Any, Dict, List, Optional, Union
+from typing import Any, Dict, List, Optional
 
 from versionhq.llm.llm_vars import LLM_CONTEXT_WINDOW_SIZES
 from versionhq.task import TaskOutputFormat
@@ -103,7 +103,7 @@ class LLM:
     def __init__(
         self,
         model: str,
-        timeout: Optional[Union[float, int]] = None,
+        timeout: Optional[float | int] = None,
         max_tokens: Optional[int] = None,
         max_completion_tokens: Optional[int] = None,
         context_window_size: Optional[int] = DEFAULT_CONTEXT_WINDOW,
@@ -111,7 +111,7 @@ class LLM:
         temperature: Optional[float] = None,
         top_p: Optional[float] = None,
         n: Optional[int] = None,
-        stop: Optional[Union[str, List[str]]] = None,
+        stop: Optional[str | List[str]] = None,
         presence_penalty: Optional[float] = None,
         frequency_penalty: Optional[float] = None,
         logit_bias: Optional[Dict[int, float]] = None,