versionhq 1.1.7.4__tar.gz → 1.1.7.5__tar.gz

{versionhq-1.1.7.4 → versionhq-1.1.7.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: versionhq
-Version: 1.1.7.4
+Version: 1.1.7.5
 Summary: LLM orchestration frameworks for model-agnostic AI agents that handle complex outbound workflows
 Author-email: Kuriko Iwai <kuriko@versi0n.io>
 License: MIT License
@@ -52,7 +52,11 @@ Requires-Dist: wheel>=0.45.1
 
 # Overview
 
-![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.1.7.3-blue) ![python ver](https://img.shields.io/badge/Python-3.12/3.13-purple) ![pyenv ver](https://img.shields.io/badge/pyenv-2.4.23-orange)
+![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.1.7.5-blue)
+![python ver](https://img.shields.io/badge/Python-3.12/3.13-purple)
+![pyenv ver](https://img.shields.io/badge/pyenv-2.4.23-orange)
 
 
 An LLM orchestration frameworks for multi-agent systems with RAG to autopilot outbound workflows.
@@ -64,10 +68,11 @@ Messaging workflows are created at individual level, and will be deployed on thi
 
 **Visit:**
 
-- [Landing page](https://home.versi0n.io)
-- [Client app](https://versi0n.io/)
-- [Orchestration frameworks](https://github.com/versionHQ/multi-agent-system)
-- [Test client app](https://github.com/versionHQ/test-client-app)
+- [PyPI](https://pypi.org/project/versionhq/)
+- [Github (LLM orchestration)](https://github.com/versionHQ/multi-agent-system)
+- [Github (Test client app)](https://github.com/versionHQ/test-client-app)
+- [Use case](https://versi0n.io/) - client app (alpha)
+
 
 <hr />
 
@@ -87,6 +92,8 @@ LLM-powered `agent`s and `team`s use `tool`s and their own knowledge to complete
 
 - [Key Features](#key-features)
 - [Usage](#usage)
+  - [Case 1. Build an AI agent on LLM of your choice and execute a task:](#case-1-build-an-ai-agent-on-llm-of-your-choice-and-execute-a-task)
+  - [Case 2. Form a team to handle multiple tasks:](#case-2-form-a-team-to-handle-multiple-tasks)
 - [Technologies Used](#technologies-used)
 - [Project Structure](#project-structure)
 - [Setup](#setup)
@@ -132,7 +139,8 @@ Multiple `agents` can form a `team` to complete complex tasks together.
 
 2. You can use the `versionhq` module in your Python app.
 
-   - **i.e.,** Make LLM-based agent execute the task and return JSON dict.
+
+### Case 1. Build an AI agent on LLM of your choice and execute a task:
 
    ```
    from versionhq.agent.model import Agent
@@ -142,6 +150,7 @@ Multiple `agents` can form a `team` to complete complex tasks together.
       role="demo",
       goal="amazing project goal",
       skillsets=["skill_1", "skill_2", ],
+      tools=["amazing RAG tool",]
       llm="llm-of-your-choice"
    )
 
@@ -165,7 +174,41 @@ This will return a dictionary with keys defined in the `ResponseField`.
    { test1: "answer1", "test2": ["answer2-1", "answer2-2", "answer2-3",] }
    ```
 
-For more info: [PyPI package](https://pypi.org/project/versionhq/)
+### Case 2. Form a team to handle multiple tasks:
+
+   ```
+   from versionhq.agent.model import Agent
+   from versionhq.task.model import Task, ResponseField
+   from versionhq.team.model import Team, TeamMember
+
+   agent_a = Agent(role="agent a", goal="My amazing goals", llm="llm-of-your-choice")
+   agent_b = Agent(role="agent b", goal="My amazing goals", llm="llm-of-your-choice")
+
+   task_1 = Task(
+      description="Analyze the client's business model.",
+      output_field_list=[ResponseField(title="test1", type=str, required=True),],
+      allow_delegation=True
+   )
+
+    task_2 = Task(
+      description="Define the cohort.",
+      output_field_list=[ResponseField(title="test1", type=int, required=True),],
+      allow_delegation=False
+   )
+
+   team = Team(
+      members=[
+         TeamMember(agent=agent_a, is_manager=False, task=task_1),
+         TeamMember(agent=agent_b, is_manager=True, task=task_2),
+      ],
+   )
+   res = team.kickoff()
+   ```
+
+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.
+
 
 <hr />
 

{versionhq-1.1.7.4 → versionhq-1.1.7.5}/README.md

@@ -1,6 +1,10 @@
 # Overview
 
-![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.1.7.3-blue) ![python ver](https://img.shields.io/badge/Python-3.12/3.13-purple) ![pyenv ver](https://img.shields.io/badge/pyenv-2.4.23-orange)
+![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.1.7.5-blue)
+![python ver](https://img.shields.io/badge/Python-3.12/3.13-purple)
+![pyenv ver](https://img.shields.io/badge/pyenv-2.4.23-orange)
 
 
 An LLM orchestration frameworks for multi-agent systems with RAG to autopilot outbound workflows.
@@ -12,10 +16,11 @@ Messaging workflows are created at individual level, and will be deployed on thi
 
 **Visit:**
 
-- [Landing page](https://home.versi0n.io)
-- [Client app](https://versi0n.io/)
-- [Orchestration frameworks](https://github.com/versionHQ/multi-agent-system)
-- [Test client app](https://github.com/versionHQ/test-client-app)
+- [PyPI](https://pypi.org/project/versionhq/)
+- [Github (LLM orchestration)](https://github.com/versionHQ/multi-agent-system)
+- [Github (Test client app)](https://github.com/versionHQ/test-client-app)
+- [Use case](https://versi0n.io/) - client app (alpha)
+
 
 <hr />
 
@@ -35,6 +40,8 @@ LLM-powered `agent`s and `team`s use `tool`s and their own knowledge to complete
 
 - [Key Features](#key-features)
 - [Usage](#usage)
+  - [Case 1. Build an AI agent on LLM of your choice and execute a task:](#case-1-build-an-ai-agent-on-llm-of-your-choice-and-execute-a-task)
+  - [Case 2. Form a team to handle multiple tasks:](#case-2-form-a-team-to-handle-multiple-tasks)
 - [Technologies Used](#technologies-used)
 - [Project Structure](#project-structure)
 - [Setup](#setup)
@@ -80,7 +87,8 @@ Multiple `agents` can form a `team` to complete complex tasks together.
 
 2. You can use the `versionhq` module in your Python app.
 
-   - **i.e.,** Make LLM-based agent execute the task and return JSON dict.
+
+### Case 1. Build an AI agent on LLM of your choice and execute a task:
 
    ```
    from versionhq.agent.model import Agent
@@ -90,6 +98,7 @@ Multiple `agents` can form a `team` to complete complex tasks together.
       role="demo",
       goal="amazing project goal",
       skillsets=["skill_1", "skill_2", ],
+      tools=["amazing RAG tool",]
       llm="llm-of-your-choice"
    )
 
@@ -113,7 +122,41 @@ This will return a dictionary with keys defined in the `ResponseField`.
    { test1: "answer1", "test2": ["answer2-1", "answer2-2", "answer2-3",] }
    ```
 
-For more info: [PyPI package](https://pypi.org/project/versionhq/)
+### Case 2. Form a team to handle multiple tasks:
+
+   ```
+   from versionhq.agent.model import Agent
+   from versionhq.task.model import Task, ResponseField
+   from versionhq.team.model import Team, TeamMember
+
+   agent_a = Agent(role="agent a", goal="My amazing goals", llm="llm-of-your-choice")
+   agent_b = Agent(role="agent b", goal="My amazing goals", llm="llm-of-your-choice")
+
+   task_1 = Task(
+      description="Analyze the client's business model.",
+      output_field_list=[ResponseField(title="test1", type=str, required=True),],
+      allow_delegation=True
+   )
+
+    task_2 = Task(
+      description="Define the cohort.",
+      output_field_list=[ResponseField(title="test1", type=int, required=True),],
+      allow_delegation=False
+   )
+
+   team = Team(
+      members=[
+         TeamMember(agent=agent_a, is_manager=False, task=task_1),
+         TeamMember(agent=agent_b, is_manager=True, task=task_2),
+      ],
+   )
+   res = team.kickoff()
+   ```
+
+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.
+
 
 <hr />
 

{versionhq-1.1.7.4 → versionhq-1.1.7.5}/pyproject.toml

@@ -15,7 +15,7 @@ exclude = ["test*", "__pycache__"]
 
 [project]
 name = "versionhq"
-version = "1.1.7.4"
+version = "1.1.7.5"
 authors = [{ name = "Kuriko Iwai", email = "kuriko@versi0n.io" }]
 description = "LLM orchestration frameworks for model-agnostic AI agents that handle complex outbound workflows"
 readme = "README.md"

{versionhq-1.1.7.4 → versionhq-1.1.7.5}/src/versionhq/__init__.py

@@ -17,7 +17,7 @@ from versionhq.team.model import Team, TeamOutput
 from versionhq.tool.model import Tool
 
 
-__version__ = "1.1.7.4"
+__version__ = "1.1.7.5"
 __all__ = [
     "Agent",
     "Customer",

{versionhq-1.1.7.4 → versionhq-1.1.7.5}/src/versionhq/clients/workflow/model.py

@@ -61,21 +61,21 @@ class MessagingComponent(ABC, BaseModel):
     score: Union[float, InstanceOf[Score]] = Field(default=None)
 
 
-    def store_scoring_result(self, scoring_subject: str, score: Union[int, Score, ScoreFormat] = None):
+    def store_scoring_result(self, scoring_subject: str, score_raw: Union[int, Score, ScoreFormat] = None):
         """
         Set up the `score` field
         """
 
-        if isinstance(score, Score):
-            setattr(self, "score", score)
+        if isinstance(score_raw, Score):
+            setattr(self, "score", score_raw)
 
-        elif isinstance(score, ScoreFormat):
+        elif isinstance(score_raw, ScoreFormat):
             score_instance = Score()
-            setattr(score_instance, scoring_subject, score)
+            setattr(score_instance, scoring_subject, score_raw)
             setattr(self, "score", score_instance)
 
-        elif isinstance(score, int) or isinstance(score, float):
-            score_instance, score_format_instance = Score(), ScoreFormat(rate=score, weight=1)
+        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", { scoring_subject: score_format_instance })
             setattr(self, "score", score_instance)
 

{versionhq-1.1.7.4 → versionhq-1.1.7.5}/src/versionhq/task/model.py

@@ -436,9 +436,14 @@ Your outputs MUST adhere to the following format and should NOT include any irre
             agent = agent_to_delegate
             self.delegations += 1
 
-        output_raw = agent.execute_task(task=self, context=context)
-        output_json_dict = self.create_json_output(raw_result=output_raw) if self.expected_output_json is True else None
-        output_pydantic = self.create_pydantic_output(output_json_dict=output_json_dict) if self.expected_output_pydantic else None
+        output_raw, output_json_dict, output_pydantic = agent.execute_task(task=self, context=context), None, None
+
+        if self.expected_output_json:
+            output_json_dict = self.create_json_output(raw_result=output_raw)
+
+        if self.expected_output_pydantic:
+            output_pydantic = self.create_pydantic_output(output_json_dict=output_json_dict)
+
         task_output = TaskOutput(
             task_id=self.id,
             raw=output_raw,
@@ -451,10 +456,7 @@ Your outputs MUST adhere to the following format and should NOT include any irre
         # self._set_end_execution_time(start_time)
 
         if self.callback:
-            if isinstance(self.callback, Callable):
-                self.callback(**self.callback_kwargs)
-            else:
-                self.callback(self.output)
+            self.callback({ **self.callback_kwargs, **self.output.__dict__ })
 
         # if self._execution_span:
         #     # self._telemetry.task_ended(self._execution_span, self, agent.team)

{versionhq-1.1.7.4 → versionhq-1.1.7.5}/src/versionhq.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: versionhq
-Version: 1.1.7.4
+Version: 1.1.7.5
 Summary: LLM orchestration frameworks for model-agnostic AI agents that handle complex outbound workflows
 Author-email: Kuriko Iwai <kuriko@versi0n.io>
 License: MIT License
@@ -52,7 +52,11 @@ Requires-Dist: wheel>=0.45.1
 
 # Overview
 
-![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.1.7.3-blue) ![python ver](https://img.shields.io/badge/Python-3.12/3.13-purple) ![pyenv ver](https://img.shields.io/badge/pyenv-2.4.23-orange)
+![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.1.7.5-blue)
+![python ver](https://img.shields.io/badge/Python-3.12/3.13-purple)
+![pyenv ver](https://img.shields.io/badge/pyenv-2.4.23-orange)
 
 
 An LLM orchestration frameworks for multi-agent systems with RAG to autopilot outbound workflows.
@@ -64,10 +68,11 @@ Messaging workflows are created at individual level, and will be deployed on thi
 
 **Visit:**
 
-- [Landing page](https://home.versi0n.io)
-- [Client app](https://versi0n.io/)
-- [Orchestration frameworks](https://github.com/versionHQ/multi-agent-system)
-- [Test client app](https://github.com/versionHQ/test-client-app)
+- [PyPI](https://pypi.org/project/versionhq/)
+- [Github (LLM orchestration)](https://github.com/versionHQ/multi-agent-system)
+- [Github (Test client app)](https://github.com/versionHQ/test-client-app)
+- [Use case](https://versi0n.io/) - client app (alpha)
+
 
 <hr />
 
@@ -87,6 +92,8 @@ LLM-powered `agent`s and `team`s use `tool`s and their own knowledge to complete
 
 - [Key Features](#key-features)
 - [Usage](#usage)
+  - [Case 1. Build an AI agent on LLM of your choice and execute a task:](#case-1-build-an-ai-agent-on-llm-of-your-choice-and-execute-a-task)
+  - [Case 2. Form a team to handle multiple tasks:](#case-2-form-a-team-to-handle-multiple-tasks)
 - [Technologies Used](#technologies-used)
 - [Project Structure](#project-structure)
 - [Setup](#setup)
@@ -132,7 +139,8 @@ Multiple `agents` can form a `team` to complete complex tasks together.
 
 2. You can use the `versionhq` module in your Python app.
 
-   - **i.e.,** Make LLM-based agent execute the task and return JSON dict.
+
+### Case 1. Build an AI agent on LLM of your choice and execute a task:
 
    ```
    from versionhq.agent.model import Agent
@@ -142,6 +150,7 @@ Multiple `agents` can form a `team` to complete complex tasks together.
       role="demo",
       goal="amazing project goal",
       skillsets=["skill_1", "skill_2", ],
+      tools=["amazing RAG tool",]
       llm="llm-of-your-choice"
    )
 
@@ -165,7 +174,41 @@ This will return a dictionary with keys defined in the `ResponseField`.
    { test1: "answer1", "test2": ["answer2-1", "answer2-2", "answer2-3",] }
    ```
 
-For more info: [PyPI package](https://pypi.org/project/versionhq/)
+### Case 2. Form a team to handle multiple tasks:
+
+   ```
+   from versionhq.agent.model import Agent
+   from versionhq.task.model import Task, ResponseField
+   from versionhq.team.model import Team, TeamMember
+
+   agent_a = Agent(role="agent a", goal="My amazing goals", llm="llm-of-your-choice")
+   agent_b = Agent(role="agent b", goal="My amazing goals", llm="llm-of-your-choice")
+
+   task_1 = Task(
+      description="Analyze the client's business model.",
+      output_field_list=[ResponseField(title="test1", type=str, required=True),],
+      allow_delegation=True
+   )
+
+    task_2 = Task(
+      description="Define the cohort.",
+      output_field_list=[ResponseField(title="test1", type=int, required=True),],
+      allow_delegation=False
+   )
+
+   team = Team(
+      members=[
+         TeamMember(agent=agent_a, is_manager=False, task=task_1),
+         TeamMember(agent=agent_b, is_manager=True, task=task_2),
+      ],
+   )
+   res = team.kickoff()
+   ```
+
+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.
+
 
 <hr />
 

{versionhq-1.1.7.4 → versionhq-1.1.7.5}/tests/clients/workflow_test.py

@@ -15,7 +15,7 @@ def test_store_scores():
 
     messaging_component = MessagingComponent(message="demo")
     score_raw = 15
-    messaging_component.store_scoring_result("demo", score=score_raw)
+    messaging_component.store_scoring_result("demo", score_raw=score_raw)
 
     assert messaging_component.score is not None
     assert messaging_component.score.result() is not None

{versionhq-1.1.7.4 → versionhq-1.1.7.5}/tests/task/task_test.py

@@ -1,7 +1,7 @@
 import os
 import pytest
 from unittest.mock import patch
-from typing import Union
+from typing import Union, Dict, Any
 from versionhq.agent.model import Agent
 from versionhq.task.model import Task, ResponseField, TaskOutput, AgentOutput
 
@@ -27,8 +27,6 @@ def test_sync_execute_task():
             ResponseField(title="test1", type=str, required=True),
             ResponseField(title="test2", type=list, required=True),
         ],
-        context=None,
-        callback=None,
     )
     res = task.execute_sync(agent=agent)
 
@@ -202,14 +200,14 @@ def test_callback():
     See if the callback function is executed well with kwargs.
     """
 
-    def callback_func(item: str = None):
-        return f"I am callback with {item}."
-
-    agent = Agent(
-        role="demo agent 5",
-        goal="My amazing goals",
-    )
+    def callback_func(kwargs: Dict[str, Any]):
+        task_id = kwargs.get("task_id", None)
+        added_condition = kwargs.get("added_condition", None)
+        assert task_id is not None
+        assert added_condition is not None
+        return f"Result: {task_id}, condition added: {added_condition}"
 
+    agent = Agent(role="demo agent 5", goal="My amazing goals")
     task = Task(
         description="Analyze the client's business model and define the optimal cohort timeframe.",
         expected_output_json=True,
@@ -218,23 +216,26 @@ def test_callback():
             ResponseField(title="test1", type=str, required=True),
         ],
         callback=callback_func,
-        callback_kwargs={"item": "demo for pytest"}
+        callback_kwargs=dict(added_condition="demo for pytest")
     )
 
-    with patch.object(Agent, "execute_task", return_value="ok") as execute:
-        execution = task.execute_async(agent=agent)
-        result = execution.result()
-        assert result.raw == "ok"
-        execute.assert_called_once_with(task=task, context=None)
+    res = task.execute_sync(agent=agent)
 
+    assert res is not None
+    assert isinstance(res, TaskOutput)
+    assert res.task_id is task.id
+    assert res.raw is not None
+
+    # with patch.object(Agent, "execute_task", return_value="ok") as execute:
+    #     execution = task.execute_async(agent=agent)
+    #     result = execution.result()
+    #     assert result.raw == "ok"
+    #     execute.assert_called_once_with(task=task, context=None)
 
 
-def test_delegate():
-    agent = Agent(
-        role="demo agent 6",
-        goal="My amazing goals",
-    )
 
+def test_delegate():
+    agent = Agent(role="demo agent 6", goal="My amazing goals")
     task = Task(
         description="Analyze the client's business model and define the optimal cohort timeframe.",
         expected_output_json=True,
@@ -255,5 +256,4 @@ def test_delegate():
 # def test_conditional_task():
 
 
-
 # tools, CONDITIONAL, token usage

{versionhq-1.1.7.4 → versionhq-1.1.7.5}/uv.lock

@@ -1647,7 +1647,7 @@ wheels = [
 
 [[package]]
 name = "versionhq"
-version = "1.1.7.4"
+version = "1.1.7.5"
 source = { editable = "." }
 dependencies = [
     { name = "composio" },