versionhq 1.2.2.10__py3-none-any.whl → 1.2.3.1__py3-none-any.whl

versionhq/__init__.py

@@ -32,7 +32,7 @@ from versionhq.agent_network.formation import form_agent_network
 from versionhq.task_graph.draft import workflow
 
 
-__version__ = "1.2.2.10"
+__version__ = "1.2.3.1"
 __all__ = [
     "Agent",
 

versionhq/clients/workflow/model.py

@@ -2,92 +2,25 @@ import uuid
 from abc import ABC
 from datetime import datetime
 from typing import Any, Dict, List, Optional
-from typing_extensions import Self
+
 from pydantic import UUID4, InstanceOf, BaseModel, ConfigDict, Field, field_validator, model_validator
 from pydantic_core import PydanticCustomError
 
-from versionhq.clients.product.model import Product
-from versionhq.clients.customer.model import Customer
 from versionhq.agent.model import Agent
 from versionhq.agent_network.model import AgentNetwork
+from versionhq.clients.product.model import Product
+from versionhq.clients.customer.model import Customer
 from versionhq.tool.composio_tool_vars import ComposioAppName
 
 
-class ScoreFormat:
-    def __init__(self, rate: float | int = 0, weight: int = 1):
-        self.rate = rate
-        self.weight = weight
-        self.aggregate = rate * weight
-
-
-class Score:
-    """
-    Evaluate the score on 0 (no performance) to 1 scale.
-    `rate`: Any float from 0.0 to 1.0 given by an agent.
-    `weight`: Importance of each factor to the aggregated score.
-    """
-
-    def __init__(
-        self,
-        brand_tone: ScoreFormat = ScoreFormat(0, 0),
-        audience: ScoreFormat = ScoreFormat(0, 0),
-        track_record: ScoreFormat = ScoreFormat(0, 0),
-        **kwargs: Optional[Dict[str, ScoreFormat]],
-    ):
-        self.brand_tone = brand_tone
-        self.audience = audience
-        self.track_record = track_record
-        self.kwargs = kwargs
-
-
-    def result(self) -> int:
-        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():
-            aggregate_score += v.aggregate
-            denominator += v.weight
-
-        if denominator == 0:
-            return 0
-
-        return round(aggregate_score / denominator, 2)
-
-
-
 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")
-    score: InstanceOf[Score] = Field(default=None)
+    score: Optional[float | int] = Field(default=None)
     condition: str = Field(default=None, description="condition to execute the next component")
     interval: Optional[str] = Field(default=None, description="ideal interval to set to assess the condition")
 
 
-    def store_scoring_result(self, subject: str, score_raw: int | Score | ScoreFormat = None) -> Self:
-        """
-        Set up the `score` field
-        """
-
-        if isinstance(score_raw, Score):
-            setattr(self, "score", score_raw)
-
-        elif isinstance(score_raw, ScoreFormat):
-            score_instance = Score()
-            setattr(score_instance, subject, score_raw)
-            setattr(self, "score", score_instance)
-
-        elif isinstance(score_raw, int) or isinstance(score_raw, float):
-            score_instance, score_format_instance = Score(), ScoreFormat(rate=score_raw, weight=1)
-            setattr(score_instance, "kwargs", { subject: score_format_instance })
-            setattr(self, "score", score_instance)
-
-        else:
-            pass
-
-        return self
-
-
-
 class MessagingWorkflow(ABC, BaseModel):
     """
     Store 3 layers of messaging workflow sent to `customer` on the `product`

versionhq/task/TEMPLATES/Description.py

@@ -1,4 +1,4 @@
-EVALUATE="""Evaluate the provided task output against the given task description, assigning a score between 0 (worst) and 1 (best) based on the specified criteria. Scores should be numerical (integers or decimals). Provide specific suggestions for improvement. Do not assign identical scores to different criteria unless otherwise you have clear reasons to do so:
+EVALUATE="""Evaluate the provided task output against the given task description, assigning a score between 0 (worst) and 1 (best) based on the specified criteria. Scores should be numerical (integers or decimals). Weight should be numerical (integers or decimals) and represents importance of the criteria to the final result. Provide specific suggestions for improvement. Do not assign identical scores to different criteria unless otherwise you have clear reasons to do so:
 Task output: {task_output}
 Task description: {task_description}
 Evaluation criteria: {eval_criteria}

versionhq/task/evaluation.py

@@ -2,63 +2,21 @@ from typing import List, Optional, Dict, Any
 from typing_extensions import Self
 
 from pydantic import BaseModel, model_validator
+import pandas as pd
+from sklearn.preprocessing import MinMaxScaler
 
 from versionhq.memory.model import MemoryMetadata
 
-"""
-Evaluate task output from accuracy, token consumption, and latency perspectives, and mark the score from 0 to 1.
-"""
-
-
-class ScoreFormat:
-    def __init__(self, rate: float | int = 0, weight: int = 1):
-        self.rate = rate
-        self.weight = weight
-        self.aggregate = rate * weight
-
-
-class Score:
-    """
-    Evaluate the score on 0 (no performance) to 1 scale.
-    `rate`: Any float from 0.0 to 1.0 given by an agent.
-    `weight`: Importance of each factor to the aggregated score.
-    """
-
-    def __init__(self, config: Optional[Dict[str, ScoreFormat]] = None):
-        self.config = config
-
-        if self.config:
-            for k, v in self.config.items():
-                if isinstance(v, ScoreFormat):
-                    setattr(self, k, v)
-
-
-    def result(self) -> float:
-        aggregate_score, denominator = 0, 0
-
-        for k, v in self.__dict__.items():
-            aggregate_score += v.aggregate
-            denominator += v.weight
-
-        if denominator == 0:
-            return 0
-
-        return round(aggregate_score / denominator, 3)
-
 
 class EvaluationItem(BaseModel):
     """
     A Pydantic class to store the evaluation result with scoring and suggestion based on the given criteria.
+    This class will be used as a response format for the eval task.
     """
     criteria: str
     suggestion: str
     score: float
-
-    def _format_score(self, weight: int = 1) -> ScoreFormat | None:
-        if self.score and isinstance(self.score, float):
-            return ScoreFormat(rate=self.score, weight=weight)
-
-        else: return None
+    weight: int = 1
 
 
 class Evaluation(BaseModel):
@@ -111,33 +69,43 @@ class Evaluation(BaseModel):
         return shot_prompt
 
 
-    @property
-    def aggregate_score(self) -> float:
+    def _normalize_df(self) -> pd.DataFrame:
         """
-        Calcurate aggregate score from evaluation items.
+        Creates a pandas DataFrame from a list of EvaluationItem objects containing 'weight' and 'score' columns, and normalizes them using MinMaxScaler.
+
+        Args:
+            items: A list of EvaluationItem objects.
+
+        Returns:
+            A pandas DataFrame with normalized 'weight' and 'score' columns, or an empty DataFrame if the input is empty.
         """
         if not self.items:
-            return 0
+            return pd.DataFrame()
 
-        aggregate_score = 0
-        denominator = 0
+        data = { 'weight': [item.weight for item in self.items], 'score': [item.score for item in self.items] }
+        df = pd.DataFrame(data)
 
-        for item in self.items:
-            score_format = item._format_score()
-            aggregate_score += score_format.aggregate if score_format else 0
-            denominator += score_format.weight if score_format else 0
+        scaler = MinMaxScaler(feature_range=(0, 1))
+        df[['weight', 'score']] = scaler.fit_transform(df[['weight', 'score']])
 
-        if denominator == 0:
+        return df
+
+
+    @property
+    def aggregate_score(self) -> int | float:
+        if not self.items:
             return 0
 
-        return round(aggregate_score / denominator, 2)
+        df = self._normalize_df()
+        df['weighted_score'] = df['weight'] * df['score']
+        aggregate_score = round(df['weighted_score'].sum(), 3)
+        return aggregate_score
 
 
     @property
     def suggestion_summary(self) -> str | None:
-        """
-        Returns a summary of the suggestions
-        """
+        """Returns a summary of the suggestions"""
+
         if not self.items:
             return None
 

versionhq/task/model.py

@@ -228,13 +228,21 @@ class TaskOutput(BaseModel):
             self._tokens += task_eval._tokens
 
             if res.pydantic:
-                item = EvaluationItem(score=res.pydantic.score, suggestion=res.pydantic.suggestion, criteria=res.pydantic.criteria)
+                item = EvaluationItem(
+                    score=res.pydantic.score,
+                    weight=res.pydantic.weight,
+                    suggestion=res.pydantic.suggestion,
+                    criteria=res.pydantic.criteria
+                )
                 self.evaluation.items.append(item)
 
             else:
                 try:
                     item = EvaluationItem(
-                        score=float(res.json_dict["score"]), suggestion=res.json_dict["suggestion"], criteria=res.json_dict["criteria"]
+                        score=float(res.json_dict["score"]),
+                        weight=float(res.json_dict["weight"]),
+                        suggestion=res.json_dict["suggestion"],
+                        criteria=res.json_dict["criteria"]
                     )
                     self.evaluation.items.append(item)
                 except Exception as e:
@@ -246,10 +254,7 @@ class TaskOutput(BaseModel):
 
     @property
     def aggregate_score(self) -> float | int:
-        if self.evaluation is None:
-            return 0
-        else:
-            self.evaluation.aggregate_score
+        return self.evaluation.aggregate_score if self.evaluation is not None else 0
 
 
     @property

versionhq/tool/rag_tool.py

@@ -1,6 +1,5 @@
 import re
 import requests
-import html2text
 import gzip
 import http.client
 import urllib.request
@@ -37,6 +36,11 @@ class RagTool(BaseTool):
         if isinstance(source_code, bytes):
             source_code = source_code.decode('utf-8')
 
+        try:
+            import html2text
+        except:
+            Logger().log(message="Dependencies for tools are missing. Add tool packages by running: `uv add versionhq[tool]`.", color="red", level="error")
+
         h = html2text.HTML2Text()
         h.ignore_links = False
         text = h.handle(source_code)

{versionhq-1.2.2.10.dist-info → versionhq-1.2.3.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: versionhq
-Version: 1.2.2.10
+Version: 1.2.3.1
 Summary: An agentic orchestration framework for building agent networks that handle task automation.
 Author-email: Kuriko Iwai <kuriko@versi0n.io>
 License: MIT License
@@ -34,13 +34,14 @@ Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Information Technology
 Classifier: Topic :: Software Development :: Build Tools
-Requires-Python: <3.13,>=3.11
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: regex==2024.11.6
@@ -67,23 +68,24 @@ Requires-Dist: composio-core==0.7.0
 Requires-Dist: networkx>=3.4.2
 Requires-Dist: matplotlib>=3.10.0
 Requires-Dist: boto3>=1.37.1
+Requires-Dist: scikit-learn>=1.6.1
+Requires-Dist: numpy>=1.26.4
+Requires-Dist: pandas>=2.2.3
+Provides-Extra: torch
+Requires-Dist: torch>=2.6.0; extra == "torch"
+Requires-Dist: torchvision>=0.21.0; extra == "torch"
+Requires-Dist: pytorch-triton-xpu>=3.2.0; sys_platform == "linux" and extra == "torch"
 Provides-Extra: docling
-Requires-Dist: docling>=2.17.0; extra == "docling"
+Requires-Dist: docling>=2.25.2; extra == "docling"
 Provides-Extra: mem0ai
 Requires-Dist: mem0ai>=0.1.55; extra == "mem0ai"
 Provides-Extra: pdfplumber
 Requires-Dist: pdfplumber>=0.11.5; extra == "pdfplumber"
-Provides-Extra: pandas
-Requires-Dist: pandas>=2.2.3; extra == "pandas"
-Provides-Extra: numpy
-Requires-Dist: numpy>=1.26.4; extra == "numpy"
 Provides-Extra: pygraphviz
 Requires-Dist: pygraphviz>=1.14; extra == "pygraphviz"
 Provides-Extra: tools
 Requires-Dist: html2text>=2024.2.26; extra == "tools"
 Requires-Dist: sec-api>=1.0.28; extra == "tools"
-Provides-Extra: eval
-Requires-Dist: scikit-learn>=1.6.1; extra == "eval"
 
 # Overview
 
@@ -91,7 +93,7 @@ Requires-Dist: scikit-learn>=1.6.1; extra == "eval"
 ![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.2.2+-blue)
-![python ver](https://img.shields.io/badge/Python-3.11|3.12-purple)
+![python ver](https://img.shields.io/badge/Python-3.11|3.12|3.13-purple)
 ![pyenv ver](https://img.shields.io/badge/pyenv-2.5.0-orange)
 
 
@@ -252,7 +254,7 @@ agent.update(
 pip install versionhq
 ```
 
-(Python 3.11 / 3.12)
+(Python 3.11 | 3.12 | 3.13)
 
 
 ### Launching an agent
@@ -384,7 +386,6 @@ Tasks can be delegated to a manager, peers within the agent network, or a comple
 
 **Deployment**
 
-* **Python**: Primary programming language. v3.12.x 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
@@ -473,8 +474,6 @@ pyproject.toml                # Project config
       uv sync --all-extras --no-extra pygraphviz
       ```
 
-   - `torch`/`Docling` related errors: Set up default Python version either `3.11.x` or `3.12.x` (same as AssertionError)
-
 ### Adding env secrets to .env file
 
 Create `.env` file in the project root and add secret vars following `.env.sample` file.
@@ -580,8 +579,6 @@ Common issues and solutions:
 
 * Memory errors: If processing large contracts, you may need to increase the available memory for the Python process.
 
-* Issues related to the Python version: Docling/Pytorch is not ready for Python 3.13 as of Jan 2025. Use Python 3.12.x as default by running `uv venv --python 3.12.8` and `uv python pin 3.12.8`.
-
 * Issues related to dependencies: `rm -rf uv.lock`, `uv cache clean`, `uv venv`, and run `uv pip install -r requirements.txt -v`.
 
 * Issues related to agents and other systems: Check `.logs` directory located in the root directory for error messages and stack traces.

{versionhq-1.2.2.10.dist-info → versionhq-1.2.3.1.dist-info}/RECORD

@@ -1,4 +1,4 @@
-versionhq/__init__.py,sha256=viaEUAZice5yfALfCU4C_RuVCIfGQ__ybM0o0atPTXc,2981
+versionhq/__init__.py,sha256=LPko4CGE6-EiJZ90ifes3Hg3LSLSOlcZmRZtGcNx-SU,2980
 versionhq/_utils/__init__.py,sha256=d-vYVcORZKG-kkLe_fzE8VbViDpAk9DDOKe2fVK25ew,178
 versionhq/_utils/i18n.py,sha256=TwA_PnYfDLA6VqlUDPuybdV9lgi3Frh_ASsb_X8jJo8,1483
 versionhq/_utils/llm_as_a_judge.py,sha256=RM0oYfoeanuUyUL3Ewl6_8Xn1F5Axd285UMH46kxG1I,2378
@@ -23,7 +23,7 @@ versionhq/clients/customer/model.py,sha256=_AtaVVMm9MgCwrQ-HTRQ2oXUMKrSCEfZwE2Jd
 versionhq/clients/product/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 versionhq/clients/product/model.py,sha256=3w__pug9XRe4LIm9wX8C8WKqi40r081Eb1q2vWk9UaU,3694
 versionhq/clients/workflow/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-versionhq/clients/workflow/model.py,sha256=fqmTx8Y6P6i-sK045ENO88GDbf4WYY4hUA26RfEH8Ek,6011
+versionhq/clients/workflow/model.py,sha256=_yCbmwzexjQqEGli7XX0vFG6yFnAOe9QDoMWQaU_qZE,3920
 versionhq/knowledge/__init__.py,sha256=qW7IgssTA4_bFFV9ziOcYRfGjlq1c8bkb-HnfWknpuQ,567
 versionhq/knowledge/_utils.py,sha256=YWRF8U533cfZes_gZqUvdj-K24MD2ri1R0gjc_aPYyc,402
 versionhq/knowledge/embedding.py,sha256=KfHc__1THxb5jrg1EMrF-v944RDuIr2hE0l-MtM3Bp0,6826
@@ -45,11 +45,11 @@ versionhq/storage/rag_storage.py,sha256=bS2eE874obarYl-4hT6ZWYWTRsqtfuGpKgKzERmM
 versionhq/storage/task_output_storage.py,sha256=M8vInLJ5idGAq17w1juHKXtyPyF-B-rK_P8UcqD-Px8,5357
 versionhq/storage/utils.py,sha256=r5ghA_ktdR2IuzlzKqZYCjsNxztEMzyhWLneA4cFuWY,748
 versionhq/task/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-versionhq/task/evaluation.py,sha256=iRLzppqwKaiGpbsr9gMbf6T7NQe6rxTA6OBcWhmiCKs,4473
+versionhq/task/evaluation.py,sha256=NmSAfyHLxXYQ7GuaFDLprlD3slGK5KuI3iammb0fK_A,3833
 versionhq/task/formatter.py,sha256=N8Kmk9vtrMtBdgJ8J7RmlKNMdZWSmV8O1bDexmCWgU0,643
-versionhq/task/model.py,sha256=rJmyEUM1DnX1mkN_0etYXqBJP_YADXVXZhFR5R-h8ZA,28915
+versionhq/task/model.py,sha256=8HQLzzAfM03gHL5M_7oL7UW-mZvI7rPCJ2Jxsv49VtI,29122
 versionhq/task/structured_response.py,sha256=4q-hQPu7oMMHHXEzh9YW4SJ7N5eCZ7OfZ65juyl_jCI,5000
-versionhq/task/TEMPLATES/Description.py,sha256=EkwJHc65G32MjWyn3rcp0ATmMaVPHuYKaykyByU5r4g,751
+versionhq/task/TEMPLATES/Description.py,sha256=hKhpbz0ztbkUMXz9KiL-P40fis9OB5ICOdL9jCtgAhU,864
 versionhq/task_graph/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 versionhq/task_graph/colors.py,sha256=naJCx4Vho4iuJtbW8USUXb-M5uYvd5ds2p8qbjUfRus,669
 versionhq/task_graph/draft.py,sha256=l18XacRsbDhAv6CvKMnUMI26IDuizA1UNWHbL1q5gn4,5099
@@ -60,10 +60,10 @@ versionhq/tool/composio_tool.py,sha256=IATfsEnF_1RPJyGtPBmAtEJh5XPcgDHpyG3SUR461
 versionhq/tool/composio_tool_vars.py,sha256=FvBuEXsOQUYnN7RTFxT20kAkiEYkxWKkiVtgpqOzKZQ,1843
 versionhq/tool/decorator.py,sha256=C4ZM7Xi2gwtEMaSeRo-geo_g_MAkY77WkSLkAuY0AyI,1205
 versionhq/tool/model.py,sha256=Nc2f9frTK5tH4kh6EeEAk1Fi1w19kEXLOcsBwHCS1a4,12189
-versionhq/tool/rag_tool.py,sha256=l1ZzbZ5Iyn3Dgsdg5v0Y3lZl8y0kt81Vdz675RKnK_Y,3654
+versionhq/tool/rag_tool.py,sha256=dW5o-83V4bMFFJEj3PUm7XjblwrYJGmZVBlCpPj6CeM,3852
 versionhq/tool/tool_handler.py,sha256=2m41K8qo5bGCCbwMFferEjT-XZ-mE9F0mDUOBkgivOI,1416
-versionhq-1.2.2.10.dist-info/LICENSE,sha256=cRoGGdM73IiDs6nDWKqPlgSv7aR4n-qBXYnJlCMHCeE,1082
-versionhq-1.2.2.10.dist-info/METADATA,sha256=w774nWz0LeS-U2LAnxVb_phAtwCvhIe_x8wwqBw5VWs,21657
-versionhq-1.2.2.10.dist-info/WHEEL,sha256=jB7zZ3N9hIM9adW7qlTAyycLYW9npaWKLRzaoVcLKcM,91
-versionhq-1.2.2.10.dist-info/top_level.txt,sha256=DClQwxDWqIUGeRJkA8vBlgeNsYZs4_nJWMonzFt5Wj0,10
-versionhq-1.2.2.10.dist-info/RECORD,,
+versionhq-1.2.3.1.dist-info/LICENSE,sha256=cRoGGdM73IiDs6nDWKqPlgSv7aR4n-qBXYnJlCMHCeE,1082
+versionhq-1.2.3.1.dist-info/METADATA,sha256=Shh9wIIUGHZ8XIHQ2S1hvuZBYaSnkrVvqdFKXaI0Jyk,21415
+versionhq-1.2.3.1.dist-info/WHEEL,sha256=jB7zZ3N9hIM9adW7qlTAyycLYW9npaWKLRzaoVcLKcM,91
+versionhq-1.2.3.1.dist-info/top_level.txt,sha256=DClQwxDWqIUGeRJkA8vBlgeNsYZs4_nJWMonzFt5Wj0,10
+versionhq-1.2.3.1.dist-info/RECORD,,