versionhq 1.2.2.9__tar.gz → 1.2.3.0__tar.gz

{versionhq-1.2.2.9 → versionhq-1.2.3.0}/.github/workflows/publish.yml

@@ -22,7 +22,7 @@ jobs:
 
       - name: Build release distributions
         run: |
-          uv venv --python 3.12.8
+          uv venv
           source .venv/bin/activate
           uv pip install --upgrade pip twine
           uv pip install -r requirements.txt

{versionhq-1.2.2.9 → versionhq-1.2.3.0}/.github/workflows/publish_testpypi.yml

@@ -22,7 +22,7 @@ jobs:
 
       - name: Build release distributions
         run: |
-          uv venv --python 3.12.8
+          uv venv
           source .venv/bin/activate
           uv pip install --upgrade pip twine
           uv pip install -r requirements.txt

{versionhq-1.2.2.9 → versionhq-1.2.3.0}/.github/workflows/run_tests.yml

@@ -37,7 +37,7 @@ jobs:
 
       - name: Set up the project
         run: |
-          uv venv --python 3.12.8
+          uv venv
           source .venv/bin/activate
           uv lock --upgrade
           uv sync --all-extras --no-extra pygraphviz

{versionhq-1.2.2.9 → versionhq-1.2.3.0}/.gitignore

@@ -1,6 +1,10 @@
 deploy.py
 destinations.py
 
+auth/
+
+refine.py
+
 train.py
 
 _memo

versionhq-1.2.3.0/.python-version

@@ -0,0 +1 @@
+3.13.1

{versionhq-1.2.2.9 → versionhq-1.2.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: versionhq
-Version: 1.2.2.9
+Version: 1.2.3.0
 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,8 +68,12 @@ 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
+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
@@ -91,7 +96,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)
 
 
@@ -100,7 +105,7 @@ Agentic orchestration framework for multi-agent networks and task graphs for com
 **Visit:**
 
 - [Playground](https://versi0n.io/)
-- [Docs](https://docs.versi0n.io)
+- [Documentation](https://docs.versi0n.io)
 - [Github](https://github.com/versionHQ/)
 - [Python SDK](https://pypi.org/project/versionhq/)
 
@@ -252,7 +257,7 @@ agent.update(
 pip install versionhq
 ```
 
-(Python 3.11 / 3.12)
+(Python 3.11 | 3.12 | 3.13)
 
 
 ### Launching an agent
@@ -384,7 +389,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 +477,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 +582,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.9 → versionhq-1.2.3.0}/README.md

@@ -4,7 +4,7 @@
 ![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)
 
 
@@ -13,7 +13,7 @@ Agentic orchestration framework for multi-agent networks and task graphs for com
 **Visit:**
 
 - [Playground](https://versi0n.io/)
-- [Docs](https://docs.versi0n.io)
+- [Documentation](https://docs.versi0n.io)
 - [Github](https://github.com/versionHQ/)
 - [Python SDK](https://pypi.org/project/versionhq/)
 
@@ -165,7 +165,7 @@ agent.update(
 pip install versionhq
 ```
 
-(Python 3.11 / 3.12)
+(Python 3.11 | 3.12 | 3.13)
 
 
 ### Launching an agent
@@ -297,7 +297,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
@@ -386,8 +385,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.
@@ -493,8 +490,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.3.0/docs/core/knowledge.md

@@ -0,0 +1,11 @@
+---
+tags:
+  - Utilities
+---
+
+
+# Knowledge
+
+<class>`class` versionhq.knowledge.model.<bold>Knowledge<bold></class>
+
+A Pydantic class to store `Knowledge` of the agent.

{versionhq-1.2.2.9 → versionhq-1.2.3.0}/docs/core/llm/index.md

@@ -16,9 +16,10 @@ You can specify a model and integration platform from the list. Else, we'll use
 
 ```python
 "openai": [
-    "gpt-4",
+    "gpt-4.5-preview-2025-02-27",
     "gpt-4o",
     "gpt-4o-mini",
+    "gpt-4",
     "o1-mini",
     "o1-preview",
 ],

versionhq-1.2.3.0/docs/core/memory.md

@@ -0,0 +1,11 @@
+---
+tags:
+  - Utilities
+---
+
+
+# Memory
+
+<class>`class` versionhq.memory.model.<bold>Memory<bold></class>
+
+A Pydantic class to store `Memory` of the agent.

versionhq-1.2.3.0/docs/core/rag-tool.md

@@ -0,0 +1,85 @@
+---
+tags:
+  - Utilities
+---
+
+
+# RAG Tool
+
+<class>`class` versionhq.tool.rag_tool.<bold>RagTool<bold></class>
+
+A Pydantic class to store RAG tools that the agent will use when it executes the task.
+
+
+## Quick Start
+
+Similar to the `Tool` class, you can run the RAG tool using `url` and `query` variables.
+
+```python
+import versionhq as vhq
+
+rt = vhq.RagTool(
+    url="https://github.com/chroma-core/chroma/issues/3233",
+    query="What is the next action plan?"
+)
+res = rt.run()
+
+assert rt.text is not None # text source from the url
+assert res is not None
+```
+
+
+<hr>
+
+## Using with Agents
+
+You can call a specific agent when you run a RAG tool.
+
+```python
+import versionhq as vhq
+
+rt = vhq.RagTool(url="https://github.com/chroma-core/chroma/issues/3233", query="What is the next action plan?")
+
+agent = vhq.Agent(role="RAG Tool Tester")
+res = rt.run(agent=agent)
+
+assert agent.knowledge_sources is not None
+assert rt.text is not None
+assert res is not None
+```
+
+
+Agents can own RAG tools.
+
+```python
+import versionhq as vhq
+
+rt = vhq.RagTool(url="https://github.com/chroma-core/chroma/issues/3233", query="What is the next action plan?")
+
+agent = vhq.Agent(role="RAG Tool Tester", tools=[rt]) # adding RAG tool/s
+task = vhq.Task(description="return a simple response", can_use_agent_tools=True, tool_res_as_final=True)
+res = task.execute(agent=agent)
+
+assert res.raw is not None
+assert res.tool_output is not None
+```
+
+
+### Variables
+
+| <div style="width:160px">**Variable**</div> | **Data Type** | **Default** | **Nullable** | **Description** |
+| :---               | :---  | :--- | :--- | :--- |
+| **`api_key_name`** | Optional[str]   | None | True | API key name in .env file. |
+| **`api_endpoint`**       | Optional[str]   | None | True |API endpoint. |
+| **`url`** | Optional[str] | None | True | URLs to extract the text source. |
+| **`headers`** | Optional[Dict[str, Any]]  | dict() | - | Request headers |
+| **`query`** |  Optional[str] | None | True | Query. |
+| **`text`** |  Optional[str] | None | True | Text sources extracted from the URL or API call |
+
+
+### Class Methods
+
+| <div style="width:120px">**Method**</div> |  <div style="width:300px">**Params**</div> | **Returns** | **Description** |
+| :---               | :---  | :--- | :--- |
+| **`store_data`**  | <p>agent: Optional["vhq.Agent"] = Non</p> | None | Stores the retrieved data in the storage. |
+| **`run`**  | *args, **kwargs | Any | Execute the tool. |

versionhq-1.2.3.0/docs/core/task/evaluation.md

@@ -0,0 +1,77 @@
+---
+tags:
+  - Task Graph
+---
+
+# Evaluation
+
+<class>`class` versionhq.task.evaluate.<bold>Evaluation<bold></class>
+
+A Pydantic class to store conditions and results of the evaluation.
+
+
+### Variables
+
+| <div style="width:120px">**Variable**</div> | **Data Type** | **Default** | **Nullable** | **Description** |
+| :---            | :---  | :--- | :--- | :--- |
+| **`items`**     | List[InstanceOf[EvaluationItem]]  | list() | - | Stores evaluation items. |
+| **`eval_by`**   | Any   | None | True | Stores an agent evaluated the output. |
+
+
+### Property
+
+| <div style="width:120px">**Property**</div> | **Returns** | **Description** |
+| :---               | :---  | :--- |
+| **`aggregate_score`**   | float | Calucurates weighted average eval scores of the task output. |
+| **`suggestion_summary`**  | str   | Returns summary of the suggestions. |
+
+
+
+<hr>
+
+## EvaluationItem
+
+<class>`class` versionhq.task.evaluate.<bold>EvaluationItem<bold></class>
+
+### Variables
+
+| <div style="width:120px">**Variable**</div> | **Data Type** | **Default** | **Nullable** | **Description** |
+| :---            | :---  | :--- | :--- | :--- |
+| **`criteria`**     | str  | None | False | Stores evaluation criteria given by the client. |
+| **`suggestion`**   | str   | None | True | Stores suggestion on improvement from the evaluator agent. |
+| **`score`**   | float   | None | True | Stores the score on a 0 to 1 scale. |
+
+
+<hr>
+
+## Usage
+
+Evaluator agents will evaluate the task output based on the given criteria, and store the results in the `TaskOutput` object.
+
+
+```python
+import versionhq as vhq
+from pydantic import BaseModel
+
+class CustomOutput(BaseModel):
+    test1: str
+    test2: list[str]
+
+task = vhq.Task(
+    description="Research a topic to teach a kid aged 6 about math.",
+    pydantic_output=CustomOutput,
+    should_evaluate=True, # triggers evaluation
+    eval_criteria=["uniquness", "audience fit",],
+
+)
+res = task.execute()
+
+assert isinstance(res.evaluation, vhq.Evaluation)
+assert [item for item in res.evaluation.items if item.criteria == "uniquness" or item.criteria == "audience fit"]
+assert res.evaluation.aggregate_score is not None
+assert res.evaluation.suggestion_summary is not None
+```
+
+An `Evaluation` object provides scores for the given criteria.
+
+For example, it might indicate a `uniqueness` score of 0.56, an `audience fit` score of 0.70, and an `aggregate score` of 0.63.

{versionhq-1.2.2.9 → versionhq-1.2.3.0}/docs/core/task/index.md

@@ -7,7 +7,7 @@ tags:
 
 <class>`class` versionhq.task.model.<bold>Task<bold></class>
 
-A class to store and manage information for individual tasks, including their assignment to agents or agent networks, and dependencies via a node-based system that tracks conditions and status.
+A Pydantic class to store and manage information for individual tasks, including their assignment to agents or agent networks, and dependencies via a node-based system that tracks conditions and status.
 
 Ref. Node / Edge / <a href="/core/task-graph">TaskGraph</a> class
 

versionhq-1.2.3.0/docs/core/task/reference.md

@@ -0,0 +1,105 @@
+## `Task`
+
+### Variables
+
+| <div style="width:160px">**Variable**</div> | **Data Type** | **Default** | **Nullable** | **Description** |
+| :---               | :---  | :--- | :--- | :--- |
+| **`id`**   | UUID  | uuid.uuid4() | False | Stores task `id` as an identifier. |
+| **`name`**       | Optional[str]   | None | True | Stores a task name (Inherited as `node` identifier if the task is dependent) |
+| **`description`**       | str   | None | False | Required field to store a concise task description |
+| **`pydantic_output`** | Optional[Type[BaseModel]] | None | True | Stores pydantic custom output class for structured response |
+| **`response_fields`** | Optional[List[ResponseField]]  | list() | True | Stores JSON formats for stuructured response |
+| **`tools`** |  Optional[List[ToolSet | Tool | Any]] | None | True | Stores tools to be called when the agent executes the task. |
+| **`can_use_agent_tools`** |  bool | True | - | Whether to use the agent tools |
+| **`tool_res_as_final`** |  bool | False | - | Whether to make the tool response a final response from the agent |
+| **`execution_type`** | TaskExecutionType  | TaskExecutionType.SYNC | - | Sync or async execution |
+| **`allow_delegation`** | bool  | False | - | Whether to allow the agent to delegate the task to another agent |
+| **`callback`** | Optional[Callable] | None | True | Callback function to be executed after LLM calling |
+| **`callback_kwargs`** | Optional[Dict[str, Any]] | dict() | True | Args for the callback function (if any)|
+| **`should_evaluate`** | bool | False | - | Whether to evaluate the task output using eval criteria |
+| **`eval_criteria`** | Optional[List[str]] | list() | True | Evaluation criteria given by the human client |
+| **`fsls`** | Optional[List[str]] | None | True | Examples of excellent and weak responses |
+| **`processed_agents`** | Set[str] | set() | True | [Ops] Stores roles of the agents executed the task |
+| **`tool_errors`** | int | 0 | True | [Ops] Stores number of tool errors |
+| **`delegation`** | int | 0 | True | [Ops] Stores number of agent delegations |
+| **`output`** | Optional[TaskOutput] | None | True | [Ops] Stores `TaskOutput` object after the execution |
+
+
+### Class Methods
+
+| <div style="width:120px">**Method**</div> |  <div style="width:300px">**Params**</div> | **Returns** | **Description** |
+| :---               | :---  | :--- | :--- |
+| **`execute`**  | <p>type: TaskExecutionType = None<br>agent: Optional["vhq.Agent"] = None<br>context: Optional[Any] = None</p> | InstanceOf[`TaskOutput`] or None (error) |  A main method to handle task execution. Auto-build an agent when the agent is not given. |
+
+
+### Properties
+
+| <div style="width:120px">**Property**</div> | **Returns** | **Description** |
+| :---               | :---  | :--- |
+| **`key`**   | str | Returns task key based on its description and output format. |
+| **`summary`**  | str   | Returns a summary of the task based on its id, description and tools. |
+
+<hr>
+
+## `TaskOutput`
+
+### Variables
+
+| <div style="width:120px">**Variable**</div> | **Data Type** | **Default** | **Nullable** | **Description** |
+| :---               | :---  | :--- | :--- | :--- |
+| **`task_id`**   | UUID  | uuid.uuid4() | False | Stores task `id` as an identifier. |
+| **`raw`**       | str   | None | False | Stores response in plane text format. `None` or `""` when the model returned errors.|
+| **`json_dict`** | Dict[str, Any] | None | False | Stores response in JSON serializable dictionary. When the system failed formatting or executing tasks without response_fields, `{ output: <res.raw> }` will be returned. |
+| **`pydantic`** | Type[`BaseModel`]  | None | True | Populates and stores Pydantic class object defined in the `pydantic_output` field. `None` if `pydantic_output` is NOT given. |
+| **`tool_output`** |  Optional[Any] | None | True | Stores results from the tools of the task or agents ONLY when `tool_res_as_final` set as `True`. |
+| **`callback_output`** |  Optional[Any] | None | True | Stores results from callback functions if any. |
+| **`latency`** |  Optional[float] | None | True | Stores job latency in milseconds. |
+| **`evaluation`** |  Optional[InstanceOf[`Evaluation`]] | None | True | Stores overall evaluations and usage of the task output. |
+
+
+### Class Methods
+
+| <div style="width:120px">**Method**</div> | **Params** | **Returns** | **Description** |
+| :---               | :---  | :--- | :--- |
+| **`evaluate`**   | task: InstanceOf[`Task`]  | InstanceOf[`Evaluation`]  | Evaluates task output based on the criteria |
+
+
+### Property
+
+| <div style="width:120px">**Property**</div> | **Returns** | **Description** |
+| :---               | :---  | :--- |
+| **`aggregate_score`**   | float | Calucurates weighted average eval scores of the task output. |
+| **`json_string`**       | str   | Returns `json_dict` in string format. |
+
+
+<hr>
+
+## `Evaluation`
+
+### Variables
+
+| <div style="width:120px">**Variable**</div> | **Data Type** | **Default** | **Nullable** | **Description** |
+| :---            | :---  | :--- | :--- | :--- |
+| **`items`**     | List[InstanceOf[EvaluationItem]]  | list() | - | Stores evaluation items. |
+| **`eval_by`**   | Any   | None | True | Stores an agent evaluated the output. |
+
+
+### Property
+
+| <div style="width:120px">**Property**</div> | **Returns** | **Description** |
+| :---               | :---  | :--- |
+| **`aggregate_score`**   | float | Calucurates weighted average eval scores of the task output. |
+| **`suggestion_summary`**  | str   | Returns summary of the suggestions. |
+
+
+<hr>
+
+## `EvaluationItem`
+
+### Variables
+
+| <div style="width:120px">**Variable**</div> | **Data Type** | **Default** | **Nullable** | **Description** |
+| :---            | :---  | :--- | :--- | :--- |
+| **`criteria`**     | str  | None | False | Stores evaluation criteria given by the client. |
+| **`suggestion`**   | str   | None | True | Stores suggestion on improvement from the evaluator agent. |
+| **`score`**   | float   | None | True | Stores the score on a 0 to 1 scale. |

{versionhq-1.2.2.9 → versionhq-1.2.3.0}/docs/core/task/task-output.md

@@ -7,7 +7,7 @@ tags:
 
 <class>`class` versionhq.task.model.<bold>TaskOutput<bold></class>
 
-A Pydantic class to store and manage response from the `Task` object.
+A Pydantic class to store and manage results of `Task`.
 
 <hr />
 
@@ -18,9 +18,10 @@ A Pydantic class to store and manage response from the `Task` object.
 | **`task_id`**   | UUID  | uuid.uuid4() | False | Stores task `id` as an identifier. |
 | **`raw`**       | str   | None | False | Stores response in plane text format. `None` or `""` when the model returned errors.|
 | **`json_dict`** | Dict[str, Any] | None | False | Stores response in JSON serializable dictionary. When the system failed formatting or executing tasks without response_fields, `{ output: <res.raw> }` will be returned. |
-| **`pydantic`** | Type[`BaseModel`]  | None | True | Populates and stores Pydantic class defined in the `pydantic_output` field. `None` if `pydantic_output` is NOT given. |
+| **`pydantic`** | Type[`BaseModel`]  | None | True | Populates and stores Pydantic class object defined in the `pydantic_output` field. `None` if `pydantic_output` is NOT given. |
 | **`tool_output`** |  Optional[Any] | None | True | Stores results from the tools of the task or agents ONLY when `tool_res_as_final` set as `True`. |
 | **`callback_output`** |  Optional[Any] | None | True | Stores results from callback functions if any. |
+| **`latency`** |  Optional[float] | None | True | Stores job latency in milseconds. |
 | **`evaluation`** |  Optional[InstanceOf[`Evaluation`]] | None | True | Stores overall evaluations and usage of the task output. |
 
 

{versionhq-1.2.2.9 → versionhq-1.2.3.0}/docs/core/task/task-strc-response.md

@@ -12,7 +12,7 @@ But you can choose to generate Pydantic class or specifig JSON object as respons
 
 `[var]`<bold>`pydantic_output: Optional[Type[BaseModel]] = None`</bold>
 
-Create and add a `custom Pydantic class` as a structured response format to the `pydantic_output` field.
+Add a `custom Pydantic class` as a structured response format to the `pydantic_output` field.
 
 The custom class can accept **one layer of a nested child** as you can see in the following code snippet:
 

{versionhq-1.2.2.9 → versionhq-1.2.3.0}/docs/core/tool.md

@@ -7,7 +7,8 @@ tags:
 
 <class>`class` versionhq.tool.model.<bold>Tool<bold></class>
 
-Tool is an unique function that the agent can utilize when they execute the task with or without LLM.
+A Pydantic class to store the tool object.
+
 
 ## Quick Start
 

{versionhq-1.2.2.9 → versionhq-1.2.3.0}/docs/index.md

@@ -4,7 +4,7 @@
 ![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)
 
 A Python framework for agentic orchestration that handles complex task automation.
@@ -175,8 +175,6 @@ agent.update(
       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)
-
 **Setting up a local env file**
 
 Create `.env` file at the root of the project directry and add your keys following `.env.sample`.
@@ -221,8 +219,6 @@ Create `.env` file at the root of the project directry and add your keys followi
 
 **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
@@ -241,8 +237,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 detailed error messages and stack traces.

{versionhq-1.2.2.9 → versionhq-1.2.3.0}/docs/quickstart.md

@@ -6,7 +6,7 @@
 pip install versionhq
 ```
 
-(Python 3.11, 3.12)
+(Python 3.11 | 3.12 | 3.13)
 
 <hr />
 

{versionhq-1.2.2.9 → versionhq-1.2.3.0}/mkdocs.yml

@@ -131,9 +131,12 @@ nav:
       - Executing: 'core/task/task-execution.md'
       - Outputs: 'core/task/task-output.md'
       - Evaluating: 'core/task/evaluation.md'
-      - Reference: 'core/task/task-ref.md'
+      - Reference: 'core/task/reference.md'
   - Components:
     - Tool: 'core/tool.md'
+    - RAG Tool: core/rag-tool.md
+    - Memory: core/memory.md
+    - Knowledge: core/knowledge.md
   - Archive: 'tags.md'
   - Cases:
     - Playground: https://versi0n.io/playground

{versionhq-1.2.2.9 → versionhq-1.2.3.0}/pyproject.toml

@@ -15,11 +15,11 @@ exclude = ["test*", "__pycache__", "*.egg-info"]
 
 [project]
 name = "versionhq"
-version = "1.2.2.9"
+version = "1.2.3.0"
 authors = [{ name = "Kuriko Iwai", email = "kuriko@versi0n.io" }]
 description = "An agentic orchestration framework for building agent networks that handle task automation."
 readme = "README.md"
-requires-python = ">=3.11,<3.13"
+requires-python = ">=3.11"
 license = { file = "LICENSE" }
 keywords = ["orchestration framework", "orchestration", "ai agent", "multi-agent system", "RAG", "agent", "agentic orchestration", "llm"]
 dependencies = [
@@ -53,6 +53,7 @@ classifiers = [
   "Programming Language :: Python :: 3",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
   "License :: OSI Approved :: MIT License",
   "Operating System :: OS Independent",
   "Development Status :: 3 - Alpha",
@@ -68,8 +69,13 @@ Repository = "https://github.com/versionHQ/multi-agent-system"
 Issues = "https://github.com/versionHQ/multi-agent-system/issues"
 
 [project.optional-dependencies]
+torch = [
+    "torch>=2.6.0",
+    "torchvision>=0.21.0",
+    "pytorch-triton-xpu>=3.2.0 ; sys_platform == 'linux'",
+]
 docling = [
-    "docling>=2.17.0",
+    "docling>=2.25.2",
 ]
 mem0ai = [
     "mem0ai>=0.1.55",
@@ -110,6 +116,22 @@ dev-dependencies = [
   "pillow>=10.4.0",
 ]
 
+[tool.uv.sources]
+torch = [
+  { index = "pytorch-xpu", marker = "sys_platform == 'win32' or sys_platform == 'linux'" },
+]
+torchvision = [
+  { index = "pytorch-xpu", marker = "sys_platform == 'win32' or sys_platform == 'linux'" },
+]
+pytorch-triton-xpu = [
+  { index = "pytorch-xpu", marker = "sys_platform == 'linux'" },
+]
+
+[[tool.uv.index]]
+name = "pytorch-xpu"
+url = "https://download.pytorch.org/whl/xpu"
+explicit = true
+
 [tool.uv.workspace]
 members = ["Kuriko", "krik8235", "Kuriko IWAI"]