versionhq 1.2.0.3__tar.gz → 1.2.1.0__tar.gz

{versionhq-1.2.0.3 → versionhq-1.2.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: versionhq
-Version: 1.2.0.3
+Version: 1.2.1.0
 Summary: An agentic orchestration framework for building agent networks that handle task automation.
 Author-email: Kuriko Iwai <kuriko@versi0n.io>
 License: MIT License
@@ -64,6 +64,8 @@ Requires-Dist: chromadb>=0.6.3
 Requires-Dist: wheel>=0.45.1
 Requires-Dist: envoy>=0.0.3
 Requires-Dist: composio-core==0.7.0
+Requires-Dist: networkx>=3.4.2
+Requires-Dist: matplotlib>=3.10.0
 Provides-Extra: docling
 Requires-Dist: docling>=2.17.0; extra == "docling"
 Provides-Extra: mem0ai
@@ -76,17 +78,13 @@ Provides-Extra: numpy
 Requires-Dist: numpy>=1.26.4; extra == "numpy"
 Provides-Extra: pygraphviz
 Requires-Dist: pygraphviz>=1.14; extra == "pygraphviz"
-Provides-Extra: networkx
-Requires-Dist: networkx>=3.4.2; extra == "networkx"
-Provides-Extra: matplotlib
-Requires-Dist: matplotlib>=3.10.0; extra == "matplotlib"
 
 # Overview
 
-[![DL](https://img.shields.io/badge/Download-15K+-red)](https://clickpy.clickhouse.com/dashboard/versionhq)
+[![DL](https://img.shields.io/badge/Download-17K+-red)](https://clickpy.clickhouse.com/dashboard/versionhq)
 ![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.0+-blue)
+![PyPI](https://img.shields.io/badge/PyPI-v1.2.1+-blue)
 ![python ver](https://img.shields.io/badge/Python-3.11/3.12-purple)
 ![pyenv ver](https://img.shields.io/badge/pyenv-2.5.0-orange)
 
@@ -108,9 +106,10 @@ A Python framework for agentic orchestration that handles complex task automatio
 <!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
 
 - [Key Features](#key-features)
-  - [Agent formation](#agent-formation)
+  - [Agent Network](#agent-network)
   - [Graph Theory Concept](#graph-theory-concept)
-  - [Agent optimization](#agent-optimization)
+  - [Task Graph](#task-graph)
+  - [Optimization](#optimization)
 - [Quick Start](#quick-start)
   - [Package installation](#package-installation)
   - [Forming a agent network](#forming-a-agent-network)
@@ -141,14 +140,14 @@ A Python framework for agentic orchestration that handles complex task automatio
 Agents are model-agnostic, and will improve task output, while oprimizing token cost and job latency, by sharing their memory, knowledge base, and RAG tools with other agents in the network.
 
 
-###  Agent formation
+###  Agent Network
 
 Agents adapt their formation based on task complexity.
 
 You can specify a desired formation or allow the agents to determine it autonomously (default).
 
 
-|  | **Solo Agent** | **Supervising** | **Network** | **Random** |
+|  | **Solo Agent** | **Supervising** | **Squad** | **Random** |
 | :--- | :--- | :--- | :--- | :--- |
 | **Formation** | <img src="https://res.cloudinary.com/dfeirxlea/image/upload/v1738818211/pj_m_agents/rbgxttfoeqqis1ettlfz.png" alt="solo" width="200"> | <img src="https://res.cloudinary.com/dfeirxlea/image/upload/v1738818211/pj_m_agents/zhungor3elxzer5dum10.png" alt="solo" width="200"> | <img src="https://res.cloudinary.com/dfeirxlea/image/upload/v1738818211/pj_m_agents/dnusl7iy7kiwkxwlpmg8.png" alt="solo" width="200"> | <img src="https://res.cloudinary.com/dfeirxlea/image/upload/v1738818211/pj_m_agents/sndpczatfzbrosxz9ama.png" alt="solo" width="200"> |
 | **Usage** | <ul><li>A single agent with tools, knowledge, and memory.</li><li>When self-learning mode is on - it will turn into **Random** formation.</li></ul> | <ul><li>Leader agent gives directions, while sharing its knowledge and memory.</li><li>Subordinates can be solo agents or networks.</li></ul> | <ul><li>Share tasks, knowledge, and memory among network members.</li></ul> | <ul><li>A single agent handles tasks, asking help from other agents without sharing its memory or knowledge.</li></ul> |
@@ -194,7 +193,19 @@ task_graph.visualize()
 
 <hr />
 
-### Agent optimization
+### Task Graph
+
+A `TaskGraph` represents tasks as `nodes` and their execution dependencies as `edges`, automating rule-based execution.
+
+`Agent Networks` can handle `TaskGraph` objects by optimizing their formations.
+
+The following example demonstrates a simple concept of a `supervising` agent network handling a task graph with three tasks and one critical edge.
+
+<img src="https://res.cloudinary.com/dfeirxlea/image/upload/v1739337639/pj_m_home/zfg4ccw1m1ww1tpnb0pa.png">
+
+<hr />
+
+### Optimization
 
 Agents are model-agnostic and can handle multiple tasks, leveraging their own and their peers' knowledge sources, memories, and tools.
 

{versionhq-1.2.0.3 → versionhq-1.2.1.0}/README.md

@@ -1,9 +1,9 @@
 # Overview
 
-[![DL](https://img.shields.io/badge/Download-15K+-red)](https://clickpy.clickhouse.com/dashboard/versionhq)
+[![DL](https://img.shields.io/badge/Download-17K+-red)](https://clickpy.clickhouse.com/dashboard/versionhq)
 ![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.0+-blue)
+![PyPI](https://img.shields.io/badge/PyPI-v1.2.1+-blue)
 ![python ver](https://img.shields.io/badge/Python-3.11/3.12-purple)
 ![pyenv ver](https://img.shields.io/badge/pyenv-2.5.0-orange)
 
@@ -25,9 +25,10 @@ A Python framework for agentic orchestration that handles complex task automatio
 <!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
 
 - [Key Features](#key-features)
-  - [Agent formation](#agent-formation)
+  - [Agent Network](#agent-network)
   - [Graph Theory Concept](#graph-theory-concept)
-  - [Agent optimization](#agent-optimization)
+  - [Task Graph](#task-graph)
+  - [Optimization](#optimization)
 - [Quick Start](#quick-start)
   - [Package installation](#package-installation)
   - [Forming a agent network](#forming-a-agent-network)
@@ -58,14 +59,14 @@ A Python framework for agentic orchestration that handles complex task automatio
 Agents are model-agnostic, and will improve task output, while oprimizing token cost and job latency, by sharing their memory, knowledge base, and RAG tools with other agents in the network.
 
 
-###  Agent formation
+###  Agent Network
 
 Agents adapt their formation based on task complexity.
 
 You can specify a desired formation or allow the agents to determine it autonomously (default).
 
 
-|  | **Solo Agent** | **Supervising** | **Network** | **Random** |
+|  | **Solo Agent** | **Supervising** | **Squad** | **Random** |
 | :--- | :--- | :--- | :--- | :--- |
 | **Formation** | <img src="https://res.cloudinary.com/dfeirxlea/image/upload/v1738818211/pj_m_agents/rbgxttfoeqqis1ettlfz.png" alt="solo" width="200"> | <img src="https://res.cloudinary.com/dfeirxlea/image/upload/v1738818211/pj_m_agents/zhungor3elxzer5dum10.png" alt="solo" width="200"> | <img src="https://res.cloudinary.com/dfeirxlea/image/upload/v1738818211/pj_m_agents/dnusl7iy7kiwkxwlpmg8.png" alt="solo" width="200"> | <img src="https://res.cloudinary.com/dfeirxlea/image/upload/v1738818211/pj_m_agents/sndpczatfzbrosxz9ama.png" alt="solo" width="200"> |
 | **Usage** | <ul><li>A single agent with tools, knowledge, and memory.</li><li>When self-learning mode is on - it will turn into **Random** formation.</li></ul> | <ul><li>Leader agent gives directions, while sharing its knowledge and memory.</li><li>Subordinates can be solo agents or networks.</li></ul> | <ul><li>Share tasks, knowledge, and memory among network members.</li></ul> | <ul><li>A single agent handles tasks, asking help from other agents without sharing its memory or knowledge.</li></ul> |
@@ -111,7 +112,19 @@ task_graph.visualize()
 
 <hr />
 
-### Agent optimization
+### Task Graph
+
+A `TaskGraph` represents tasks as `nodes` and their execution dependencies as `edges`, automating rule-based execution.
+
+`Agent Networks` can handle `TaskGraph` objects by optimizing their formations.
+
+The following example demonstrates a simple concept of a `supervising` agent network handling a task graph with three tasks and one critical edge.
+
+<img src="https://res.cloudinary.com/dfeirxlea/image/upload/v1739337639/pj_m_home/zfg4ccw1m1ww1tpnb0pa.png">
+
+<hr />
+
+### Optimization
 
 Agents are model-agnostic and can handle multiple tasks, leveraging their own and their peers' knowledge sources, memories, and tools.
 

versionhq-1.2.1.0/docs/core/task/response-field.md

@@ -0,0 +1,211 @@
+---
+tags:
+  - HTML5
+  - JavaScript
+  - CSS
+---
+
+# ResponseField
+
+<class>`class` versionhq.task.model.<bold>ResponseField<bold></class>
+
+A class to store response formats to create JSON response schema.
+
+<hr/>
+
+## Core Usage
+
+`[var]`<bold>`title: str = None`</bold>
+
+`[var]`<bold>`data_type: Type = None`</bold>
+
+Define a response format with field titles and data types.
+
+
+```python
+import versionhq as vhq
+
+response_field = vhq.ResponseField(
+  title="summary",
+  data_type=str,
+  nullable=False, # default = False. Explicitly mentioned.
+)
+
+## Agent output:
+#  "summary": <AGENT_RESPONSE_IN_STRING>
+```
+
+### Object
+
+`[var]`<bold>`properties: List[InstanceOf[ResponseField]] = None`</bold>
+
+To format an object, add `ResponseField` objects to the `properties` fields.
+
+Missing properties for dict will trigger an error.
+
+```python
+import versionhq as vhq
+
+response_field = vhq.ResponseField(
+  title="dict-summary",
+  data_type=dict,
+  nullable=False,
+  properties=[
+    vhq.ResponseField(title="summary-1", data_type=str),
+    vhq.ResponseField(title="summary-2", data_type=int),
+  ]
+)
+
+## Agent output:
+#  dict-summary: {
+#   "summary-1": <AGENT_RESPONSE_1_IN_STRING>,
+#   "summary-2": <AGENT_RESPONSE_2_IN_INTEGER>,
+# }
+```
+
+<hr />
+
+### List
+
+`[var]`<bold>`items: Optional[Type] = None`</bold>
+
+To format a list, add data types of the list items to the `items` field.
+
+Missing items for list will trigger an error.
+
+```python
+import versionhq as vhq
+
+response_field = vhq.ResponseField(
+  title="list-summary",
+  data_type=list,
+  nullable=False,
+  items=str
+)
+
+## Agent output:
+#  list-summary: [
+#     <AGENT_RESPONSE_1_IN_STRING>,
+#     <AGENT_RESPONSE_2_IN_STRING>,
+#     ...
+# ]
+```
+
+<hr />
+
+## Nesting
+
+Agents can handle **one layer** of nested items usign `properties` and `items` fields.
+
+We highly recommend to use `gemini-x` or `gpt-x` to get stable results.
+
+### List with Object
+
+```python
+import versionhq as vhq
+
+list_with_objects = vhq.ResponseField(
+  title="parent",
+  data_type=list,
+  items=dict,
+  properties=[
+    vhq.ResponseField(title="nest-1", data_type=str),
+    vhq.ResponseField(title="nest-2", data_type=float),
+  ]
+)
+
+# Agent output
+# parent: [
+#   { "nest-1": <AGENT_RESOPONSE_IN_STRING>},
+#   { "nest-2": <AGENT_RESOPONSE_IN_NUMBER>},
+# ]
+```
+
+<hr />
+
+### List with List
+
+```python
+import versionhq as vhq
+
+list_with_list = vhq.ResponseField(
+  title="parent",
+  data_type=list,
+  items=list
+)
+
+# Agent output
+# parent: [
+#   [<AGENT_RESOPONSE_IN_STRING>, ...],
+#   [<AGENT_RESOPONSE_IN_STRING>, ...]
+#   ...
+# ]
+```
+
+<hr />
+
+### Object with List
+
+```python
+import versionhq as vhq
+
+dict_with_list = vhq.ResponseField(
+  title="parent",
+  data_type=dict,
+  properties=[
+    vhq.ResponseField(title="nest-1", data_type=list, items=str),
+    vhq.ResponseField(title="nest-2", data_type=list, items=int),
+  ]
+)
+
+# Agent output
+# parent: {
+#   nest-1: [<AGENT_RESOPONSE_IN_STRING>, ...],
+#   nest-2: [<AGENT_RESOPONSE_IN_INTEGER>, ...]
+# }
+```
+
+<hr />
+
+### Object with Object
+
+```python
+import versionhq as vhq
+
+dict_with_dict = vhq.ResponseField(
+  title="parent",
+  data_type=dict,
+  properties=[
+    vhq.ResponseField(title="nest-1", data_type=dict, properties=[
+      vhq.ResponseField(title="nest-1-1", data_type=str)
+    ]),
+    vhq.ResponseField(title="nest-2", data_type=list, items=int),
+  ]
+)
+
+# Agent output
+# parent: {
+#   nest-1: { nest-1-1: <AGENT_RESOPONSE_IN_STRING>, },
+#   nest-2: [<AGENT_RESOPONSE_IN_INTEGER>, ...]
+# }
+```
+
+### Config
+
+`[var]`<bold>`config: Optional[Dict[str, Any]] = {}`</bold>
+
+You can add other configs you want to pass to the LLM.
+
+```python
+import versionhq as vhq
+
+response_field = vhq.ResponseField(
+  title="summary-with-config",
+  data_type=str,
+  nullable=False,
+  config=dict(required=False, )
+)
+
+# Agent output:
+# summary-with-config: <AGENT_RESPONSE_IN_STRING>
+```

{versionhq-1.2.0.3 → versionhq-1.2.1.0}/docs/core/task/task-output.md

@@ -7,7 +7,7 @@ tags:
 
 # TaskOutput
 
-<class>`class` versionhq.tasks.model.<bold>TaskOutput<bold></class>
+<class>`class` versionhq.task.model.<bold>TaskOutput<bold></class>
 
 A class to store and manage output from the `Task` object.
 

versionhq-1.2.1.0/docs/core/task-graph.md

@@ -0,0 +1,83 @@
+---
+tags:
+  - HTML5
+  - JavaScript
+  - CSS
+---
+
+# TaskGraph
+
+<class>`class` versionhq.graph.model.<bold>TaskGraph<bold></class>
+
+A `TaskGraph` represents tasks as `nodes` and their execution dependencies as `edges`, automating rule-based execution.
+
+`Agent Networks` can handle `TaskGraph` objects by optimizing their formations.
+
+The following example demonstrates a simple concept of a `supervising` agent network handling a task graph with three tasks and one critical edge.
+
+<img src="https://res.cloudinary.com/dfeirxlea/image/upload/v1739337639/pj_m_home/zfg4ccw1m1ww1tpnb0pa.png">
+
+
+## Core Usage
+
+`TaskGraph` needs at least two `nodes` and one `edges` to connect the nodes to function.
+
+You can define nodes and edges mannually by creating nodes from tasks, and defining edges.
+
+
+### Generating TaskGraph
+
+```python
+import versionhq as vhq
+
+task_graph = vhq.TaskGraph(directed=False, should_reform=True)
+
+task_a = vhq.Task(description="Research Topic")
+task_b = vhq.Task(description="Outline Post")
+task_c = vhq.Task(description="Write First Draft")
+
+node_a = task_graph.add_task(task=task_a)
+node_b = task_graph.add_task(task=task_b)
+node_c = task_graph.add_task(task=task_c)
+
+task_graph.add_dependency(
+    node_a.identifier, node_b.identifier,
+    type=vhq.DependencyType.FINISH_TO_START, weight=5, description="B depends on A"
+)
+task_graph.add_dependency(
+    node_a.identifier, node_c.identifier,
+    type=vhq.DependencyType.FINISH_TO_FINISH, lag=1, required=False, weight=3
+)
+
+critical_path, duration, paths = task_graph.find_critical_path()
+
+import uuid
+assert isinstance(task_graph, vhq.TaskGraph)
+assert [type(k) == uuid.uuid4 and isinstance(v, vhq.Node) and isinstance(v.task, vhq.Task) for k, v in task_graph.nodes.items()]
+assert [type(k) == uuid.uuid4 and isinstance(v, vhq.Edge) for k, v in task_graph.edges.items()]
+assert critical_path  and duration  and paths
+```
+
+
+### Activating TaskGraph
+
+Calling `.activate()` begins execution of the graph's nodes, respecting dependencies [`dependency-met`] and prioritizing the critical path.
+
+
+**[NOTES]**
+
+- If all nodes are already complete, outputs are returned without further execution.
+
+- If no critical path is found, execution begins with any dependency-met start nodes.
+
+
+```python
+import versionhq as vhq
+
+# Inherting the `task_graph` object in the previous code snippet,
+
+last_task_output, outputs = task_graph.activate()
+
+assert isinstance(last_task_output, vhq.TaskOutput)
+assert [k in task_graph.nodes.keys() and v and isinstance(v, vhq.TaskOutput) for k, v in outputs.items()]
+```

{versionhq-1.2.0.3 → versionhq-1.2.1.0}/docs/core/task.md

@@ -7,7 +7,7 @@ tags:
 
 # Task
 
-<class>`class` versionhq.tasks.model.<bold>Task<bold></class>
+<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 teams, and dependencies via a node-based system that tracks conditions and status.
 
@@ -72,7 +72,7 @@ from pydantic import BaseModel
 from typing import Any
 
 
-# 1. Define Pydantic class using description (optional), annotation and field name.
+# 1. Define Pydantic class with a description (optional), annotations and field names.
 class Demo(BaseModel):
     """
     A demo pydantic class to validate the outcome with various nested data types.
@@ -89,7 +89,7 @@ class Demo(BaseModel):
     demo_nest_4: dict[str, dict[str, Any]]
     # error_1: list[list[dict[str, list[str]]]] # <- Trigger 400 error due to 2+ layers of nested child.
     # error_2: InstanceOf[AnotherPydanticClass] # <- Trigger 400 error due to non-typing annotation.
-    # error_3: list[InstanceOf[AnotherPydanticClass]] # <- Same as above
+    # error_3: list[InstanceOf[AnotherPydanticClass]] # <- Trigger 400 error due to non-typing annotation as a nested child.
 
 # 2. Define a task
 task = vhq.Task(
@@ -132,21 +132,40 @@ import versionhq as vhq
 
 # 1. Define a list of ResponseField objects.
 demo_response_fields = [
+    # no nesting
     vhq.ResponseField(title="demo_1", data_type=int),
     vhq.ResponseField(title="demo_2", data_type=float),
     vhq.ResponseField(title="demo_3", data_type=str),
     vhq.ResponseField(title="demo_4", data_type=bool),
     vhq.ResponseField(title="demo_5", data_type=list, items=str),
-    vhq.ResponseField(title="demo_6", data_type=dict, properties=[vhq.ResponseField(title="demo-item", data_type=str)]),
-    vhq.ResponseField(title="demo_nest_1", data_type=list, items=str, properties=([
-        vhq.ResponseField(title="nest1", data_type=dict, properties=[vhq.ResponseField(title="nest11", data_type=str)])
-    ])), # you can specify field title of nested items
+    vhq.ResponseField(
+        title="demo_6",
+        data_type=dict,
+        properties=[vhq.ResponseField(title="demo-item", data_type=str)]
+    ),
+    # nesting
+    vhq.ResponseField(
+        title="demo_nest_1",
+        data_type=list,
+        items=dict,
+        properties=([
+            vhq.ResponseField(
+                title="nest1",
+                data_type=dict,
+                properties=[vhq.ResponseField(title="nest11", data_type=str)]
+            )
+        ])
+    ),
     vhq.ResponseField(title="demo_nest_2", data_type=list, items=list),
     vhq.ResponseField(title="demo_nest_3", data_type=dict, properties=[
         vhq.ResponseField(title="nest1", data_type=list, items=str)
     ]),
     vhq.ResponseField(title="demo_nest_4", data_type=dict, properties=[
-        vhq.ResponseField(title="nest1", data_type=dict, properties=[vhq.ResponseField(title="nest12", data_type=str)])
+        vhq.ResponseField(
+            title="nest1",
+            data_type=dict,
+            properties=[vhq.ResponseField(title="nest12", data_type=str)]
+        )
     ])
 ]
 
@@ -227,7 +246,7 @@ res = main_task.execute(context=sub_res.raw) # [Optional] Adding sub_task's resp
 assert [item for item in res.callback_output.main1 if isinstance(item, Sub)]
 ```
 
-To skip these manual setups, refer to Node/Graph pages.
+To automate these manual setups, refer to <a href="/core/agent-network">AgentNetwork</a> class.
 
 
 <!-- ### Context
@@ -239,7 +258,6 @@ To skip these manual setups, refer to Node/Graph pages.
 ### Execution rules
 EXECUTION type
     allow_delegation: bool = Field(default=False, description="ask other agents for help and run the task instead")
-
     callback: Optional[Callable] = Field(default=None, description="callback to be executed after the task is completed.")
     callback_kwargs: Optional[Dict[str, Any]] = Field(default_factory=dict, description="kwargs for the callback when the callback is callable")
 

{versionhq-1.2.0.3 → versionhq-1.2.1.0}/docs/index.md

@@ -7,14 +7,13 @@ tags:
 
 # Overview
 
-[![DL](https://img.shields.io/badge/Download-15K+-red)](https://clickpy.clickhouse.com/dashboard/versionhq)
+[![DL](https://img.shields.io/badge/Download-17K+-red)](https://clickpy.clickhouse.com/dashboard/versionhq)
 ![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.0+-blue)
+![PyPI](https://img.shields.io/badge/PyPI-v1.2.1+-blue)
 ![python ver](https://img.shields.io/badge/Python-3.11/3.12-purple)
 ![pyenv ver](https://img.shields.io/badge/pyenv-2.5.0-orange)
 
-
 A Python framework for agentic orchestration that handles complex task automation.
 
 **Visit:**
@@ -36,7 +35,7 @@ A Python framework for agentic orchestration that handles complex task automatio
 Agents are model-agnostic, and will improve task output, while oprimizing token cost and job latency, by sharing their memory, knowledge base, and RAG tools with other agents in the network.
 
 
-###  Agent formation
+###  Agent Network
 
 Agents adapt their formation based on task complexity.
 
@@ -84,12 +83,32 @@ task_graph.add_dependency(
    type=vhq.DependencyType.FINISH_TO_FINISH, lag=1, required=False, weight=3
 )
 
+# To viaualize:
 task_graph.visualize()
+
+# To start to execute nodes
+latest_output, outputs = task_graph.activate()
+
+assert
 ```
 
 <hr />
 
-### Agent optimization
+### Task Graph
+
+A `TaskGraph` represents tasks as `nodes` and their execution dependencies as `edges`, automating rule-based execution.
+
+`Agent Networks` can handle `TaskGraph` objects by optimizing their formations.
+
+The following example demonstrates a simple concept of a `supervising` agent network handling a task graph with three tasks and one critical edge.
+
+<img src="https://res.cloudinary.com/dfeirxlea/image/upload/v1739337639/pj_m_home/zfg4ccw1m1ww1tpnb0pa.png">
+
+* Ref: <a href="/core/task-graph">TaskGraph</a> class
+
+<hr />
+
+### Optimization
 
 Agents are model-agnostic and can handle multiple tasks, leveraging their own and their peers' knowledge sources, memories, and tools.
 

{versionhq-1.2.0.3 → versionhq-1.2.1.0}/mkdocs.yml

@@ -110,6 +110,7 @@ nav:
   - Quick Start: 'quickstart.md'
   - Core Components:
     - Agent: 'core/agent.md'
+    - Task Graph: 'core/task-graph.md'
     - Task:
       - Overview: 'core/task.md'
       - ResponseField: 'core/task/response-field.md'

{versionhq-1.2.0.3 → versionhq-1.2.1.0}/pyproject.toml

@@ -15,7 +15,7 @@ exclude = ["test*", "__pycache__", "*.egg-info"]
 
 [project]
 name = "versionhq"
-version = "1.2.0.3"
+version = "1.2.1.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"
@@ -44,6 +44,8 @@ dependencies = [
   "wheel>=0.45.1",
   "envoy>=0.0.3",
   "composio-core==0.7.0",
+  "networkx>=3.4.2",
+  "matplotlib>=3.10.0",
 ]
 classifiers = [
   "Programming Language :: Python",
@@ -83,12 +85,6 @@ numpy = [
 pygraphviz = [
     "pygraphviz>=1.14",
 ]
-networkx = [
-    "networkx>=3.4.2",
-]
-matplotlib = [
-    "matplotlib>=3.10.0",
-]
 
 [tool.uv]
 dev-dependencies = [

{versionhq-1.2.0.3 → versionhq-1.2.1.0}/src/versionhq/__init__.py

@@ -16,7 +16,7 @@ from versionhq.clients.workflow.model import MessagingWorkflow, MessagingCompone
 from versionhq.knowledge.model import Knowledge, KnowledgeStorage
 from versionhq.knowledge.source import PDFKnowledgeSource, CSVKnowledgeSource, JSONKnowledgeSource, TextFileKnowledgeSource, ExcelKnowledgeSource, StringKnowledgeSource
 from versionhq.knowledge.source_docling import DoclingSource
-from versionhq.network.model import TaskStatus, TaskGraph, Node, Edge, DependencyType
+from versionhq.graph.model import TaskStatus, TaskGraph, Node, Edge, DependencyType
 from versionhq.task.model import Task, TaskOutput, ResponseField, TaskExecutionType
 from versionhq.task.evaluate import Evaluation, EvaluationItem
 from versionhq.team.model import Team, TeamOutput, Formation, Member, TaskHandlingProcess
@@ -30,7 +30,7 @@ from versionhq.memory.model import ShortTermMemory,LongTermMemory, UserMemory, M
 from versionhq.task.formation import form_agent_network
 
 
-__version__ = "1.2.0.3"
+__version__ = "1.2.1.0"
 __all__ = [
     "Agent",
 

{versionhq-1.2.0.3 → versionhq-1.2.1.0}/src/versionhq/_utils/logger.py

@@ -38,7 +38,7 @@ class Printer:
 class Logger(BaseModel):
     """
     Control CLI messages.
-    Color: red = error, yellow = warning, blue = info (from vhq), green = info (from third party)
+    Color: red = error, yellow = warning, blue = info (from vhq), green = info (from third parties)
     """
 
     verbose: bool = Field(default=True)