versionhq 1.1.12.2__py3-none-any.whl → 1.1.12.3__py3-none-any.whl

versionhq/__init__.py

@@ -21,9 +21,10 @@ from versionhq.tool.composio_tool import ComposioHandler
 from versionhq.memory.contextual_memory import ContextualMemory
 from versionhq.memory.model import ShortTermMemory,LongTermMemory, UserMemory, MemoryItem
 
+from versionhq.task.formation import form_agent_network
 
 
-__version__ = "1.1.12.2"
+__version__ = "1.1.12.3"
 __all__ = [
     "Agent",
 
@@ -67,5 +68,7 @@ __all__ = [
     "ShortTermMemory",
     "LongTermMemory",
     "UserMemory",
-    "MemoryItem"
+    "MemoryItem",
+
+    "form_agent_network"
 ]

versionhq/task/formation.py

@@ -11,7 +11,7 @@ from versionhq._utils import Logger
 
 
 def form_agent_network(
-        task_overview: str,
+        task: str,
         expected_outcome: str,
         agents: List[Agent] = None,
         context: str = None,
@@ -21,7 +21,7 @@ def form_agent_network(
     Make a formation of agents from the given task description, agents (optional), context (optional), and expected outcome (optional).
     """
 
-    if not task_overview:
+    if not task:
         Logger(verbose=True).log(level="error", message="Missing task description.", color="red")
         return None
 
@@ -40,7 +40,7 @@ def form_agent_network(
         vhq_task = Task(
             description=f"""
     Create a team of specialized agents designed to automate the following task and deliver the expected outcome. Consider the necessary roles for each agent with a clear task description. If you think we neeed a leader to handle the automation, return a leader_agent role as well, but if not, leave the a leader_agent role blank.
-    Task: {str(task_overview)}
+    Task: {str(task)}
     Expected outcome: {str(expected_outcome)}
             """,
             pydantic_output=Outcome
@@ -112,12 +112,3 @@ def form_agent_network(
     except Exception as e:
         Logger(verbose=True).log(level="error", message=f"Failed to create an agent network - return None. You can try with solo agent. Error: {str(e)}", color="red")
         return None
-
-
-
-if __name__ == "__main__":
-    res = form_agent_network(
-        task_overview="Launch an outbound campaign to attract young audience.",
-        expected_outcome="Best media mix of the campaign.",
-        context="We are selling sports wear.",
-    )

versionhq/team/model.py

@@ -387,9 +387,9 @@ class Team(BaseModel):
         return self._create_team_output(task_outputs, lead_task_output)
 
 
-    def kickoff(self, kwargs_before: Optional[Dict[str, str]] = None, kwargs_after: Optional[Dict[str, Any]] = None) -> TeamOutput:
+    def launch(self, kwargs_before: Optional[Dict[str, str]] = None, kwargs_after: Optional[Dict[str, Any]] = None) -> TeamOutput:
         """
-        Kickoff the team:
+        Confirm and launch the formation - execute tasks and record outputs.
         0. Assign an agent to a task - using conditions (manager prioritizes team_tasks) and planning_llm.
         1. Address `before_kickoff_callbacks` if any.
         2. Handle team members' tasks in accordance with the process.

{versionhq-1.1.12.2.dist-info → versionhq-1.1.12.3.dist-info}/METADATA

@@ -1,7 +1,7 @@
 Metadata-Version: 2.2
 Name: versionhq
-Version: 1.1.12.2
-Summary: Agentic orchestration framework for task automation
+Version: 1.1.12.3
+Summary: An agentic orchestration framework for multi-agent system that shares memory, knowledge base, and RAG tools.
 Author-email: Kuriko Iwai <kuriko@versi0n.io>
 License: MIT License
         
@@ -103,9 +103,10 @@ Agentic orchestration framework to deploy agent network and handle complex task
 - [Key Features](#key-features)
   - [Agent formation](#agent-formation)
 - [Quick Start](#quick-start)
-  - [Case 1. Solo Agent:](#case-1-solo-agent)
+  - [Generate agent networks and launch task execution:](#generate-agent-networks-and-launch-task-execution)
+  - [Solo Agent:](#solo-agent)
     - [Return a structured output with a summary in string.](#return-a-structured-output-with-a-summary-in-string)
-  - [Case 2. Supervising:](#case-2-supervising)
+  - [Supervising:](#supervising)
 - [Technologies Used](#technologies-used)
 - [Project Structure](#project-structure)
 - [Setup](#setup)
@@ -123,9 +124,9 @@ Agentic orchestration framework to deploy agent network and handle complex task
 
 ## Key Features
 
-Generate multi-agent systems based on the task complexity, execute tasks, and evaluate output based on the given criteria.
+`versionhq` is a Python framework that can generate agent networks for complex task automation without human interaction.
 
-Agents are model-agnostic, and can handle and share RAG tools, knowledge, memory, and callbacks among other agents. (self-learn)
+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
@@ -153,8 +154,22 @@ You can specify a desired formation or allow the agents to determine it autonomo
 
 (Python 3.11 or higher)
 
+### Generate agent networks and launch task execution:
 
-### Case 1. Solo Agent:
+   ```
+   from versionhq import form_agent_network
+
+   network = form_agent_network(
+      task="YOUR AMAZING TASK OVERVIEW",
+      expected_outcome="YOUR OUTCOME EXPECTATION",
+   )
+   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.
+
+
+### Solo Agent:
 
 #### Return a structured output with a summary in string.
 
@@ -197,7 +212,7 @@ This will return `TaskOutput` instance that stores a response in plane text, JSO
    )
    ```
 
-### Case 2. Supervising:
+### Supervising:
 
    ```
    from versionhq import Agent, Task, ResponseField, Team, TeamMember

{versionhq-1.1.12.2.dist-info → versionhq-1.1.12.3.dist-info}/RECORD

@@ -1,4 +1,4 @@
-versionhq/__init__.py,sha256=1hMfk5eYF9pdzZypJBvtvbqHdhM_2Oi-UWuz7yg5Ikc,2266
+versionhq/__init__.py,sha256=7tNLp19NRK1hbonxLY-MD1XLsbs28PwWCnxX9vaXM9A,2349
 versionhq/_utils/__init__.py,sha256=dzoZr4cBlh-2QZuPzTdehPUCe9lP1dmRtauD7qTjUaA,158
 versionhq/_utils/i18n.py,sha256=TwA_PnYfDLA6VqlUDPuybdV9lgi3Frh_ASsb_X8jJo8,1483
 versionhq/_utils/logger.py,sha256=j9SlQPIefdVUlwpGfJY83E2BUt1ejWgZ2M2I8aMyQ3c,1579
@@ -42,14 +42,14 @@ versionhq/storage/task_output_storage.py,sha256=E1t_Fkt78dPYIOl3MP7LfQ8oGtjlzxBu
 versionhq/storage/utils.py,sha256=ByYXPoEIGJYLUqz-DWjbCAnneNrH1otiYbp12SCILpM,747
 versionhq/task/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 versionhq/task/evaluate.py,sha256=f8S-nuEl2xJ2LnLv7iQixH53-gp0pKx1hFp_sUlN464,3977
-versionhq/task/formation.py,sha256=BBB-Fgc9nmoOIuMIPndt-XO2I6uWCBDgFkSMi_72brk,4986
+versionhq/task/formation.py,sha256=bZytru6I5a_CFq2rtmsBb0hVWIqExpzUxXPXYpd6qnI,4706
 versionhq/task/formatter.py,sha256=N8Kmk9vtrMtBdgJ8J7RmlKNMdZWSmV8O1bDexmCWgU0,643
 versionhq/task/log_handler.py,sha256=KJRrcNZgFSKhlNzvtYFnvtp6xukaF1s7ifX9u4zWrN8,1683
 versionhq/task/model.py,sha256=2p3Fc4iphfAjARaClFL3AXDg_203Kx6VAlMgt2-L29U,29444
 versionhq/task/structured_response.py,sha256=uVqgeUxNOACPe2hdc0RELSbtKd1vrwonfjXMOGTT0TI,4818
 versionhq/task/TEMPLATES/Description.py,sha256=V-4kh8xpQTKOcDMi2xnuP-fcNk6kuoz1_5tYBlDLQWQ,420
 versionhq/team/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-versionhq/team/model.py,sha256=NYKYxyebZrbhbDReqP01M4viHJ-48AXlpPMpxUw4SX4,18836
+versionhq/team/model.py,sha256=WDnaJuvnVMmreztR0CMypnKpqFtGzAb7rrZ-HKa010Y,18886
 versionhq/team/team_planner.py,sha256=l1PwyBXK1F3uOcbF1IvJBWKApJhghZnBF_ErkNcE04s,3745
 versionhq/tool/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 versionhq/tool/cache_handler.py,sha256=iL8FH7X0G-cdT0uhJwzuhLDaadTXOdfybZcDy151-es,1085
@@ -58,8 +58,8 @@ versionhq/tool/composio_tool_vars.py,sha256=FvBuEXsOQUYnN7RTFxT20kAkiEYkxWKkiVtg
 versionhq/tool/decorator.py,sha256=C4ZM7Xi2gwtEMaSeRo-geo_g_MAkY77WkSLkAuY0AyI,1205
 versionhq/tool/model.py,sha256=ILfvRviQR1W1w-u3MtOIz0PrWa-brpgfAiyKWol63mk,12227
 versionhq/tool/tool_handler.py,sha256=2m41K8qo5bGCCbwMFferEjT-XZ-mE9F0mDUOBkgivOI,1416
-versionhq-1.1.12.2.dist-info/LICENSE,sha256=cRoGGdM73IiDs6nDWKqPlgSv7aR4n-qBXYnJlCMHCeE,1082
-versionhq-1.1.12.2.dist-info/METADATA,sha256=8DC3AWye0ks-8k7iv5aZtLlJSxCpVLKojjCCy5FGFAQ,18563
-versionhq-1.1.12.2.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-versionhq-1.1.12.2.dist-info/top_level.txt,sha256=DClQwxDWqIUGeRJkA8vBlgeNsYZs4_nJWMonzFt5Wj0,10
-versionhq-1.1.12.2.dist-info/RECORD,,
+versionhq-1.1.12.3.dist-info/LICENSE,sha256=cRoGGdM73IiDs6nDWKqPlgSv7aR4n-qBXYnJlCMHCeE,1082
+versionhq-1.1.12.3.dist-info/METADATA,sha256=yF8JpWAlDcWmJ9gxaZzZ-Tm3YZlxIzMblGHhBwerqms,19184
+versionhq-1.1.12.3.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+versionhq-1.1.12.3.dist-info/top_level.txt,sha256=DClQwxDWqIUGeRJkA8vBlgeNsYZs4_nJWMonzFt5Wj0,10
+versionhq-1.1.12.3.dist-info/RECORD,,