versionhq 1.2.1.1__py3-none-any.whl → 1.2.1.2__py3-none-any.whl

versionhq/__init__.py

@@ -30,7 +30,7 @@ from versionhq.memory.model import ShortTermMemory,LongTermMemory, UserMemory, M
 from versionhq.task.formation import form_agent_network
 
 
-__version__ = "1.2.1.1"
+__version__ = "1.2.1.2"
 __all__ = [
     "Agent",
 

versionhq/_utils/logger.py

@@ -1,3 +1,4 @@
+import logging
 from datetime import datetime
 from typing import Optional
 
@@ -42,9 +43,55 @@ class Logger(BaseModel):
     """
 
     verbose: bool = Field(default=True)
+    info_file_save: bool = Field(default=False, description="whether to save INFO logs")
     _printer: Printer = PrivateAttr(default_factory=Printer)
 
-    def log(self, level, message, color="yellow"):
+
+    def log(self, level: str, message: str, color="yellow"):
         if self.verbose:
             timestamp = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
             self._printer.print(f"\n{timestamp} - versionHQ [{level.upper()}]: {message}", color=color)
+
+        self._save(level=level, message=message)
+
+
+    def _save(self, level: str, message: str, filename: str = None):
+        import os
+        from pathlib import Path
+
+        if level.lower() == "info" and self.info_file_save == False:
+            return
+
+        logging_level = logging.INFO
+        match level:
+            case "warning":
+                logging_level = logging.WARNING
+            case "error":
+                logging_level = logging.ERROR
+            case _:
+                pass
+
+        cwd = Path.cwd()
+        log_file_dir = f"{cwd}/_logs"
+        os.makedirs(log_file_dir, exist_ok=True)
+        filename = filename if filename else datetime.now().strftime('%H_%M_%S_%d_%m_%Y')
+        abs_dir = f"{log_file_dir}/{filename}.log"
+
+        logging.basicConfig(filename=abs_dir, filemode='w', level=logging_level)
+        logger = logging.getLogger(__name__)
+        file_handler = logging.FileHandler(filename=abs_dir)
+        formatter = logging.Formatter('%(asctime)s : %(levelname)s : %(name)s : %(message)s')
+        file_handler.setFormatter(formatter)
+
+        for handler in logging.root.handlers[:]:
+            logging.root.removeHandler(handler)
+
+        logger.addHandler(file_handler)
+
+        match logging_level:
+            case logging.WARNING:
+                logger.warning(message)
+            case logging.ERROR:
+                logger.error(message)
+            case _:
+               logger.info(message)

versionhq/task/model.py

@@ -617,6 +617,7 @@ Ref. Output image: {output_formats_to_follow}
 
         self.prompt_context = context
         task_output: InstanceOf[TaskOutput] = None
+        raw_output: str = None
         tool_output: str | list = None
         task_tools: List[List[InstanceOf[Tool]| InstanceOf[ToolSet] | Type[Tool]]] = []
         started_at, ended_at = datetime.datetime.now(), datetime.datetime.now()
@@ -673,7 +674,7 @@ Ref. Output image: {output_formats_to_follow}
         self.output = task_output
         self.processed_agents.add(agent.role)
 
-        if self.should_evaluate:
+        if self.should_evaluate and raw_output: # eval only when raw output exsits
             task_output.evaluate(task=self)
 
         self._create_short_and_long_term_memories(agent=agent, task_output=task_output)

{versionhq-1.2.1.1.dist-info → versionhq-1.2.1.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: versionhq
-Version: 1.2.1.1
+Version: 1.2.1.2
 Summary: An agentic orchestration framework for building agent networks that handle task automation.
 Author-email: Kuriko Iwai <kuriko@versi0n.io>
 License: MIT License
@@ -115,13 +115,12 @@ A Python framework for agentic orchestration that handles complex task automatio
   - [Forming a agent network](#forming-a-agent-network)
   - [Executing tasks](#executing-tasks)
   - [Supervising](#supervising)
-- [Supervising](#supervising-1)
 - [Technologies Used](#technologies-used)
 - [Project Structure](#project-structure)
-- [Setting Up a Project](#setting-up-a-project)
-  - [1. Installing package manager](#1-installing-package-manager)
-  - [2. Installing dependencies](#2-installing-dependencies)
-  - [3. Adding env secrets to .env file](#3-adding-env-secrets-to-env-file)
+- [Setting Up Your Project](#setting-up-your-project)
+  - [Installing package manager](#installing-package-manager)
+  - [Installing dependencies](#installing-dependencies)
+  - [Adding env secrets to .env file](#adding-env-secrets-to-env-file)
 - [Contributing](#contributing)
   - [Steps](#steps)
   - [Package Management with uv](#package-management-with-uv)
@@ -257,7 +256,7 @@ agent.update(
    res = network.launch()
    ```
 
-   This will form a network with multiple agents on `Formation` and return `TaskOutput` object with output in JSON, plane text, Pydantic model format with evaluation.
+This will form a network with multiple agents on `Formation` and return `TaskOutput` object with output in JSON, plane text, Pydantic model format with evaluation.
 
 
 ### Executing tasks
@@ -267,47 +266,45 @@ You can simply build an agent using `Agent` model and execute the task using `Ta
 By default, agents prioritize JSON over plane text outputs.
 
 
-   ```python
-   import versionhq as vhq
-   from pydantic import BaseModel
+```python
+import versionhq as vhq
+from pydantic import BaseModel
 
-   class CustomOutput(BaseModel):
-      test1: str
-      test2: list[str]
+class CustomOutput(BaseModel):
+   test1: str
+   test2: list[str]
 
-   def dummy_func(message: str, test1: str, test2: list[str]) -> str:
-      return f"""{message}: {test1}, {", ".join(test2)}"""
+def dummy_func(message: str, test1: str, test2: list[str]) -> str:
+   return f"""{message}: {test1}, {", ".join(test2)}"""
 
-   task = vhq.Task(
-      description="Amazing task",
-      pydantic_output=CustomOutput,
-      callback=dummy_func,
-      callback_kwargs=dict(message="Hi! Here is the result: ")
-   )
+task = vhq.Task(
+   description="Amazing task",
+   pydantic_output=CustomOutput,
+   callback=dummy_func,
+   callback_kwargs=dict(message="Hi! Here is the result: ")
+)
 
-   res = task.execute(context="amazing context to consider.")
-   print(res)
-   ```
+res = task.execute(context="amazing context to consider.")
+print(res)
+```
 
 
 This will return a `TaskOutput` object that stores response in plane text, JSON, and Pydantic model: `CustomOutput` formats with a callback result, tool output (if given), and evaluation results (if given).
 
-   ```python
-   res == TaskOutput(
-      task_id=UUID('<TASK UUID>'),
-      raw='{\"test1\":\"random str\", \"test2\":[\"str item 1\", \"str item 2\", \"str item 3\"]}',
-      json_dict={'test1': 'random str', 'test2': ['str item 1', 'str item 2', 'str item 3']},
-      pydantic=<class '__main__.CustomOutput'>,
-      tool_output=None,
-      callback_output='Hi! Here is the result: random str, str item 1, str item 2, str item 3', # returned a plain text summary
-      evaluation=None
-   )
-   ```
+```python
+res == TaskOutput(
+   task_id=UUID('<TASK UUID>'),
+   raw='{\"test1\":\"random str\", \"test2\":[\"str item 1\", \"str item 2\", \"str item 3\"]}',
+   json_dict={'test1': 'random str', 'test2': ['str item 1', 'str item 2', 'str item 3']},
+   pydantic=<class '__main__.CustomOutput'>,
+   tool_output=None,
+   callback_output='Hi! Here is the result: random str, str item 1, str item 2, str item 3', # returned a plain text summary
+   evaluation=None
+)
+```
 
 ### Supervising
 
-## Supervising
-
 To create an agent network with one or more manager agents, designate members using the `is_manager` tag.
 
 ```python
@@ -410,16 +407,19 @@ src/
 │     └── ...
 │
 └── uploads/  [.gitignore]    # Local directory to store uploaded files such as graphviz diagrams generatd by `Network` class
-|
+│
+└── _logs/    [.gitignore]    # Local directory to store error/warning logs for debugging
+│
+│
 pyproject.toml                # Project config
 
 ```
 
 <hr />
 
-## Setting Up a Project
+## Setting Up Your Project
 
-### 1. Installing package manager
+### Installing package manager
 
    For MacOS:
 
@@ -433,7 +433,7 @@ pyproject.toml                # Project config
    ```
 
 
-### 2. Installing dependencies
+### Installing dependencies
 
    ```
    uv venv
@@ -466,7 +466,7 @@ pyproject.toml                # Project config
 
    - `torch`/`Docling` related errors: Set up default Python version either `3.11.x` or `3.12.x` (same as AssertionError)
 
-### 3. Adding env secrets to .env file
+### Adding env secrets to .env file
 
 Create `.env` file in the project root and add following:
 
@@ -479,6 +479,7 @@ Create `.env` file in the project root and add following:
    [OTHER_LLM_INTERFACE_PROVIDER_OF_YOUR_CHOICE]_API_KEY=your-api-key
    ```
 
+
 <hr />
 
 ## Contributing
@@ -583,7 +584,7 @@ Common issues and solutions:
 
 * 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 the AI agents or RAG system: Check the `output.log` file for detailed error messages and stack traces.
+* Issues related to agents and other systems: Check `_logs` directory for detailed error messages and stack traces.
 
 * Issues related to `Python quit unexpectedly`: Check [this stackoverflow article](https://stackoverflow.com/questions/59888499/macos-catalina-python-quit-unexpectedly-error).
 

{versionhq-1.2.1.1.dist-info → versionhq-1.2.1.2.dist-info}/RECORD

@@ -1,7 +1,7 @@
-versionhq/__init__.py,sha256=Ct-oSIm8Mw2K2UH9CNTtuKaLgwUTIcUa3ogDAFQYHZo,2817
+versionhq/__init__.py,sha256=nv3StURywg_U4o7_lKbqPuby1xjSphOkY9B6Ra5ORHA,2817
 versionhq/_utils/__init__.py,sha256=dzoZr4cBlh-2QZuPzTdehPUCe9lP1dmRtauD7qTjUaA,158
 versionhq/_utils/i18n.py,sha256=TwA_PnYfDLA6VqlUDPuybdV9lgi3Frh_ASsb_X8jJo8,1483
-versionhq/_utils/logger.py,sha256=2qkODR6y8ApOoMjQZVecTboXvCLrMy2v_mTSOnNMKFY,1581
+versionhq/_utils/logger.py,sha256=IxSlr2Vi7AXaxj5Fuy8LRzEovaIFVwcbWTgJnASsHN8,3155
 versionhq/_utils/process_config.py,sha256=jbPGXK2Kb4iyCugJ3FwRJuU0wL5Trq2x4xFQz2uOyFY,746
 versionhq/_utils/usage_metrics.py,sha256=NXF18dn5NNvGK7EsQ4AAghpR8ppYOjMx6ABenLLHnmM,1066
 versionhq/_utils/vars.py,sha256=bZ5Dx_bFKlt3hi4-NNGXqdk7B23If_WaTIju2fiTyPQ,57
@@ -47,7 +47,7 @@ versionhq/task/evaluate.py,sha256=WdUgjbZL62XrxyWe5MTz29scfzwmuAHGxJ7GvAB8Fmk,39
 versionhq/task/formation.py,sha256=gBrFmMHvoyqdK9wEa9aBkZImEQV3GMDDX6-RDpw0pEo,6421
 versionhq/task/formatter.py,sha256=N8Kmk9vtrMtBdgJ8J7RmlKNMdZWSmV8O1bDexmCWgU0,643
 versionhq/task/log_handler.py,sha256=LT7YnO7gcPR9IZS7eRvMjnHh8crMBFtqduxd8dxIbkk,1680
-versionhq/task/model.py,sha256=oPnShLU6huN2cfuEiHVO8Zl9_w44G9ZsWEWMBjpHfK4,30675
+versionhq/task/model.py,sha256=H7ZYZpp_1mrw_MlKjLr6gMJztqyhPkdeoolIzZSF68Y,30756
 versionhq/task/structured_response.py,sha256=4q-hQPu7oMMHHXEzh9YW4SJ7N5eCZ7OfZ65juyl_jCI,5000
 versionhq/task/TEMPLATES/Description.py,sha256=V-4kh8xpQTKOcDMi2xnuP-fcNk6kuoz1_5tYBlDLQWQ,420
 versionhq/task_graph/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -59,8 +59,8 @@ versionhq/tool/composio_tool_vars.py,sha256=FvBuEXsOQUYnN7RTFxT20kAkiEYkxWKkiVtg
 versionhq/tool/decorator.py,sha256=C4ZM7Xi2gwtEMaSeRo-geo_g_MAkY77WkSLkAuY0AyI,1205
 versionhq/tool/model.py,sha256=PO4zNWBZcJhYVur381YL1dy6zqurio2jWjtbxOxZMGI,12194
 versionhq/tool/tool_handler.py,sha256=2m41K8qo5bGCCbwMFferEjT-XZ-mE9F0mDUOBkgivOI,1416
-versionhq-1.2.1.1.dist-info/LICENSE,sha256=cRoGGdM73IiDs6nDWKqPlgSv7aR4n-qBXYnJlCMHCeE,1082
-versionhq-1.2.1.1.dist-info/METADATA,sha256=cjE8Ov1BpANLgfAZAbHO0XmorFk9nAR-rVyJg1AczVc,22166
-versionhq-1.2.1.1.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-versionhq-1.2.1.1.dist-info/top_level.txt,sha256=DClQwxDWqIUGeRJkA8vBlgeNsYZs4_nJWMonzFt5Wj0,10
-versionhq-1.2.1.1.dist-info/RECORD,,
+versionhq-1.2.1.2.dist-info/LICENSE,sha256=cRoGGdM73IiDs6nDWKqPlgSv7aR4n-qBXYnJlCMHCeE,1082
+versionhq-1.2.1.2.dist-info/METADATA,sha256=SjmFRj8FztRldIYEtsObQlY5XTk6mWL-zmr6sCaSWAY,22116
+versionhq-1.2.1.2.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+versionhq-1.2.1.2.dist-info/top_level.txt,sha256=DClQwxDWqIUGeRJkA8vBlgeNsYZs4_nJWMonzFt5Wj0,10
+versionhq-1.2.1.2.dist-info/RECORD,,