versionhq 1.2.1.0__tar.gz → 1.2.1.1__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: versionhq
-Version: 1.2.1.0
+Version: 1.2.1.1
 Summary: An agentic orchestration framework for building agent networks that handle task automation.
 Author-email: Kuriko Iwai <kuriko@versi0n.io>
 License: MIT License
@@ -115,6 +115,7 @@ 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)
@@ -305,42 +306,50 @@ This will return a `TaskOutput` object that stores response in plane text, JSON,
 
 ### Supervising
 
-   ```python
-   import versionhq as vhq
+## Supervising
 
-   agent_a = vhq.Agent(role="agent a", goal="My amazing goals", llm="llm-of-your-choice")
-   agent_b = vhq.Agent(role="agent b", goal="My amazing goals", llm="llm-of-your-choice")
+To create an agent network with one or more manager agents, designate members using the `is_manager` tag.
 
-   task_1 = vhq.Task(
-      description="Analyze the client's business model.",
-      response_fields=[vhq.ResponseField(title="test1", data_type=str, required=True),],
-      allow_delegation=True
-   )
+```python
+import versionhq as vhq
 
-    task_2 = vhq.Task(
-      description="Define the cohort.",
-      response_fields=[ResponseField(title="test1", data_type=int, required=True),],
-      allow_delegation=False
-   )
+agent_a = vhq.Agent(role="agent a", goal="My amazing goals", llm="llm-of-your-choice")
+agent_b = vhq.Agent(role="agent b", goal="My amazing goals", llm="llm-of-your-choice")
 
-   team = vhq.Team(
-      members=[
-         vhq.Member(agent=agent_a, is_manager=False, task=task_1),
-         vhq.Member(agent=agent_b, is_manager=True, task=task_2),
-      ],
-   )
-   res = team.launch()
-   ```
+task_1 = vhq.Task(
+   description="Analyze the client's business model.",
+   response_fields=[vhq.ResponseField(title="test1", data_type=str, required=True),],
+   allow_delegation=True
+)
+
+task_2 = vhq.Task(
+   description="Define a cohort.",
+   response_fields=[vhq.ResponseField(title="test1", data_type=int, required=True),],
+   allow_delegation=False
+)
+
+network =vhq.AgentNetwork(
+   members=[
+      vhq.Member(agent=agent_a, is_manager=False, tasks=[task_1]),
+      vhq.Member(agent=agent_b, is_manager=True, tasks=[task_2]), # Agent B as a manager
+   ],
+)
+res = network.launch()
+
+assert isinstance(res, vhq.NetworkOutput)
+assert not [item for item in task_1.processed_agents if "vhq-Delegated-Agent" == item]
+assert [item for item in task_1.processed_agents if "agent b" == item]
+```
 
 This will return a list with dictionaries with keys defined in the `ResponseField` of each task.
 
-Tasks can be delegated to a team manager, peers in the team, or completely new agent.
+Tasks can be delegated to a manager, peers within the agent network, or a completely new agent.
 
 <hr />
 
 ## Technologies Used
 
-**Graph Theory (Analysis and Visualization)**
+**Task Graph**
 
 * [NetworkX](https://networkx.org/documentation/stable/reference/introduction.html): A Python package to analyze, create, and manipulate complex graph networks.
 * [Matplotlib](https://matplotlib.org/stable/index.html): Visualization library

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

@@ -34,6 +34,7 @@ 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)
@@ -224,42 +225,50 @@ This will return a `TaskOutput` object that stores response in plane text, JSON,
 
 ### Supervising
 
-   ```python
-   import versionhq as vhq
+## Supervising
 
-   agent_a = vhq.Agent(role="agent a", goal="My amazing goals", llm="llm-of-your-choice")
-   agent_b = vhq.Agent(role="agent b", goal="My amazing goals", llm="llm-of-your-choice")
+To create an agent network with one or more manager agents, designate members using the `is_manager` tag.
 
-   task_1 = vhq.Task(
-      description="Analyze the client's business model.",
-      response_fields=[vhq.ResponseField(title="test1", data_type=str, required=True),],
-      allow_delegation=True
-   )
+```python
+import versionhq as vhq
 
-    task_2 = vhq.Task(
-      description="Define the cohort.",
-      response_fields=[ResponseField(title="test1", data_type=int, required=True),],
-      allow_delegation=False
-   )
+agent_a = vhq.Agent(role="agent a", goal="My amazing goals", llm="llm-of-your-choice")
+agent_b = vhq.Agent(role="agent b", goal="My amazing goals", llm="llm-of-your-choice")
 
-   team = vhq.Team(
-      members=[
-         vhq.Member(agent=agent_a, is_manager=False, task=task_1),
-         vhq.Member(agent=agent_b, is_manager=True, task=task_2),
-      ],
-   )
-   res = team.launch()
-   ```
+task_1 = vhq.Task(
+   description="Analyze the client's business model.",
+   response_fields=[vhq.ResponseField(title="test1", data_type=str, required=True),],
+   allow_delegation=True
+)
+
+task_2 = vhq.Task(
+   description="Define a cohort.",
+   response_fields=[vhq.ResponseField(title="test1", data_type=int, required=True),],
+   allow_delegation=False
+)
+
+network =vhq.AgentNetwork(
+   members=[
+      vhq.Member(agent=agent_a, is_manager=False, tasks=[task_1]),
+      vhq.Member(agent=agent_b, is_manager=True, tasks=[task_2]), # Agent B as a manager
+   ],
+)
+res = network.launch()
+
+assert isinstance(res, vhq.NetworkOutput)
+assert not [item for item in task_1.processed_agents if "vhq-Delegated-Agent" == item]
+assert [item for item in task_1.processed_agents if "agent b" == item]
+```
 
 This will return a list with dictionaries with keys defined in the `ResponseField` of each task.
 
-Tasks can be delegated to a team manager, peers in the team, or completely new agent.
+Tasks can be delegated to a manager, peers within the agent network, or a completely new agent.
 
 <hr />
 
 ## Technologies Used
 
-**Graph Theory (Analysis and Visualization)**
+**Task Graph**
 
 * [NetworkX](https://networkx.org/documentation/stable/reference/introduction.html): A Python package to analyze, create, and manipulate complex graph networks.
 * [Matplotlib](https://matplotlib.org/stable/index.html): Visualization library

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

@@ -9,7 +9,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 teams, and dependencies via a node-based system that tracks conditions and status.
+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.
 
 Ref. Node / Edge / TaskGraph class
 

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

@@ -35,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 Network
+### Agent Network
 
 Agents adapt their formation based on task complexity.
 
@@ -139,7 +139,7 @@ agent.update(
 
 ## Project Set Up
 
-### 1. Package manager
+**Installing package manager**
 
    For MacOS:
 
@@ -152,7 +152,7 @@ agent.update(
    sudo apt-get install uv
    ```
 
-### 2. Dependencies
+**Installing dependencies**
 
    ```
    uv venv
@@ -186,7 +186,7 @@ agent.update(
 
    - `torch`/`Docling` related errors: Set up default Python version either `3.11.x` or `3.12.x` (same as AssertionError)
 
-### 3. Local .env
+**Setting up a local env file**
 
 Create `.env` file in the project root and add following:
 

{versionhq-1.2.1.0 → versionhq-1.2.1.1}/docs/quickstart.md

@@ -84,33 +84,39 @@ This will return a `TaskOutput` object that stores response in plane text, JSON,
 
 ## Supervising
 
-   ```python
-   import versionhq as vhq
-
-   agent_a = vhq.Agent(role="agent a", goal="My amazing goals", llm="llm-of-your-choice")
-   agent_b = vhq.Agent(role="agent b", goal="My amazing goals", llm="llm-of-your-choice")
-
-   task_1 = vhq.Task(
-      description="Analyze the client's business model.",
-      response_fields=[vhq.ResponseField(title="test1", data_type=str, required=True),],
-      allow_delegation=True
-   )
-
-    task_2 = vhq.Task(
-      description="Define the cohort.",
-      response_fields=[vhq.ResponseField(title="test1", data_type=int, required=True),],
-      allow_delegation=False
-   )
-
-   team =vhq.Team(
-      members=[
-         vhq.Member(agent=agent_a, is_manager=False, task=task_1),
-         vhq.Member(agent=agent_b, is_manager=True, task=task_2),
-      ],
-   )
-   res = team.launch()
-   ```
+To create an agent network with one or more manager agents, designate members using the `is_manager` tag.
+
+```python
+import versionhq as vhq
+
+agent_a = vhq.Agent(role="agent a", goal="My amazing goals", llm="llm-of-your-choice")
+agent_b = vhq.Agent(role="agent b", goal="My amazing goals", llm="llm-of-your-choice")
+
+task_1 = vhq.Task(
+   description="Analyze the client's business model.",
+   response_fields=[vhq.ResponseField(title="test1", data_type=str, required=True),],
+   allow_delegation=True
+)
+
+task_2 = vhq.Task(
+   description="Define a cohort.",
+   response_fields=[vhq.ResponseField(title="test1", data_type=int, required=True),],
+   allow_delegation=False
+)
+
+network =vhq.AgentNetwork(
+   members=[
+      vhq.Member(agent=agent_a, is_manager=False, tasks=[task_1]),
+      vhq.Member(agent=agent_b, is_manager=True, tasks=[task_2]), # Agent B as a manager
+   ],
+)
+res = network.launch()
+
+assert isinstance(res, vhq.NetworkOutput)
+assert not [item for item in task_1.processed_agents if "vhq-Delegated-Agent" == item]
+assert [item for item in task_1.processed_agents if "agent b" == item]
+```
 
 This will return a list with dictionaries with keys defined in the `ResponseField` of each task.
 
-Tasks can be delegated to a team manager, peers in the team, or completely new agent.
+Tasks can be delegated to a manager, peers within the agent network, or a completely new agent.

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

@@ -15,7 +15,7 @@ exclude = ["test*", "__pycache__", "*.egg-info"]
 
 [project]
 name = "versionhq"
-version = "1.2.1.0"
+version = "1.2.1.1"
 authors = [{ name = "Kuriko Iwai", email = "kuriko@versi0n.io" }]
 description = "An agentic orchestration framework for building agent networks that handle task automation."
 readme = "README.md"

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

@@ -8,6 +8,7 @@ from dotenv import load_dotenv
 load_dotenv(override=True)
 
 from versionhq.agent.model import Agent
+from versionhq.agent_network.model import AgentNetwork, NetworkOutput, Formation, Member, TaskHandlingProcess
 from versionhq.llm.model import LLM
 from versionhq.llm.llm_vars import LLM_CONTEXT_WINDOW_SIZES, PARAMS, PROVIDERS, MODELS
 from versionhq.clients.customer.model import Customer
@@ -16,10 +17,9 @@ 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.graph.model import TaskStatus, TaskGraph, Node, Edge, DependencyType
+from versionhq.task_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
 from versionhq.tool.model import Tool, ToolSet
 from versionhq.tool.cache_handler import CacheHandler
 from versionhq.tool.tool_handler import ToolHandler
@@ -30,10 +30,16 @@ from versionhq.memory.model import ShortTermMemory,LongTermMemory, UserMemory, M
 from versionhq.task.formation import form_agent_network
 
 
-__version__ = "1.2.1.0"
+__version__ = "1.2.1.1"
 __all__ = [
     "Agent",
 
+    "AgentNetwork",
+    "NetworkOutput",
+    "Formation",
+    "Member",
+    "TaskHandlingProcess",
+
     "LLM",
     "LLM_CONTEXT_WINDOW_SIZES",
     "PARAMS",
@@ -70,12 +76,6 @@ __all__ = [
     "Evaluation",
     "EvaluationItem",
 
-    "Team",
-    "TeamOutput",
-    "Formation",
-    "Member",
-    "TaskHandlingProcess",
-
     "Tool",
     "ToolSet",
     "CacheHandler",

{versionhq-1.2.1.0 → versionhq-1.2.1.1}/src/versionhq/agent/inhouse_agents.py

@@ -39,3 +39,10 @@ vhq_formation_planner = Agent(
         "Random is a formation where a single agent handles tasks, asking help from other agents without sharing its memory or knowledge. Typical usecase is that an email agent drafts promo message for the given audience, asking insights on tones from other email agents which oversee other customer clusters, or an agent calls the external, third party agent to deploy the campaign. ",
     ]
 )
+
+
+vhq_agent_creator = Agent(
+    role="vhq-Agent Creator",
+    goal="build an agent that can handle the given task",
+    llm="gemini/gemini-2.0-flash-exp",
+)

{versionhq-1.2.1.0 → versionhq-1.2.1.1}/src/versionhq/agent/model.py

@@ -95,7 +95,7 @@ class Agent(BaseModel):
     user_prompt_template: Optional[str] = Field(default=None, description="user prompt template")
 
     # task execution rules
-    team: Optional[List[Any]] = Field(default=None, description="Team to which the agent belongs")
+    network: Optional[List[Any]] = Field(default=None, description="store a list of agent networks that the agent belong as a member")
     allow_delegation: bool = Field(default=False,description="if the agent can delegate the task to another agent or ask some help")
     max_retry_limit: int = Field(default=2 ,description="max. number of retry for the task execution when an error occurs")
     maxit: Optional[int] = Field(default=25,description="max. number of total optimization loops conducted when an error occurs")
@@ -553,7 +553,7 @@ class Agent(BaseModel):
 
 
         ## comment out for now
-        # if self.team and self.team._train:
+        # if self.network and self.network._train:
         #     task_prompt = self._training_handler(task_prompt=task_prompt)
         # else:
         #     task_prompt = self._use_trained_data(task_prompt=task_prompt)