versionhq 1.1.11.8__tar.gz → 1.1.12.2__tar.gz

{versionhq-1.1.11.8 → versionhq-1.1.12.2}/.github/workflows/run_tests.yml

@@ -6,15 +6,16 @@ permissions:
   contents: write
 
 env:
+  DEFAULT_MODEL_NAME:  ${{ secrets.DEFAULT_MODEL_NAME }}
+  DEFAULT_MODEL_PROVIDER_NAME:  ${{ secrets.DEFAULT_MODEL_PROVIDER_NAME }}
   LITELLM_API_KEY: ${{ secrets.LITELLM_API_KEY }}
   OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
-  DEFAULT_REDIRECT_URL:  ${{ secrets.DEFAULT_REDIRECT_URL }}
-  DEFAULT_USER_ID:  ${{ secrets.DEFAULT_USER_ID }}
-  COMPOSIO_API_KEY: ${{ secrets.COMPOSIO_API_KEY }}
-  DEFAULT_MODEL_NAME:  ${{ secrets.DEFAULT_MODEL_NAME }}
   GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}
   ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
-  ANTHROPIC_API_BASE: ${{ secrets.ANTHROPIC_API_BASE }}
+  OPENROUTER_API_KEY: ${{ secrets.OPENROUTER_API_KEY }}
+  COMPOSIO_API_KEY: ${{ secrets.COMPOSIO_API_KEY }}
+  DEFAULT_REDIRECT_URL:  ${{ secrets.DEFAULT_REDIRECT_URL }}
+  DEFAULT_USER_ID:  ${{ secrets.DEFAULT_USER_ID }}
   MEM0_API_KEY: ${{ secrets.MEM0_API_KEY }}
 
 jobs:

{versionhq-1.1.11.8 → versionhq-1.1.12.2}/.gitignore

@@ -3,8 +3,6 @@ destinations.py
 
 entity_memory.py
 
-llm_connection_test.py
-
 train.py
 
 dist/

{versionhq-1.1.11.8 → versionhq-1.1.12.2}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 Version IO Sdn. Bhd.
+Copyright (c) 2024-2025 Version IO Sdn. Bhd.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{versionhq-1.1.11.8 → versionhq-1.1.12.2}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.2
 Name: versionhq
-Version: 1.1.11.8
-Summary: LLM orchestration frameworks for model-agnostic AI agents that handle complex outbound workflows
+Version: 1.1.12.2
+Summary: Agentic orchestration framework for task automation
 Author-email: Kuriko Iwai <kuriko@versi0n.io>
 License: MIT License
         
-        Copyright (c) 2024 Version IO Sdn. Bhd.
+        Copyright (c) 2024-2025 Version IO Sdn. Bhd.
         
         Permission is hereby granted, free of charge, to any person obtaining a copy
         of this software and associated documentation files (the "Software"), to deal
@@ -29,7 +29,7 @@ Project-URL: Homepage, https://versi0n.io
 Project-URL: Documentation, https://chief-oxygen-8a2.notion.site/Documentation-17e923685cf98001a5fad5c4b2acd79b?pvs=73
 Project-URL: Repository, https://github.com/versionHQ/multi-agent-system
 Project-URL: Issues, https://github.com/versionHQ/multi-agent-system/issues
-Keywords: orchestration framework,orchestration,ai agent,multi-agent system,RAG,agent
+Keywords: orchestration framework,orchestration,ai agent,multi-agent system,RAG,agent,agentic orchestration,llm
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.11
@@ -63,6 +63,7 @@ Requires-Dist: composio-langchain>=0.6.12
 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
 Provides-Extra: docling
 Requires-Dist: docling>=2.17.0; extra == "docling"
 Provides-Extra: mem0ai
@@ -78,12 +79,12 @@ Requires-Dist: numpy>=1.26.4; extra == "numpy"
 
 ![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.11.4-blue)
-![python ver](https://img.shields.io/badge/Python->=3.12-purple)
+![PyPI](https://img.shields.io/badge/PyPI-v1.1.12+-blue)
+![python ver](https://img.shields.io/badge/Python-3.11+-purple)
 ![pyenv ver](https://img.shields.io/badge/pyenv-2.5.0-orange)
 
 
-LLM orchestration frameworks to deploy multi-agent systems with task-based formation.
+Agentic orchestration framework to deploy agent network and handle complex task automation.
 
 **Visit:**
 
@@ -122,15 +123,16 @@ LLM orchestration frameworks to deploy multi-agent systems with task-based forma
 
 ## Key Features
 
-Generate mulit-agent systems depending on the complexity of the task, and execute the task with agents of choice.
+Generate multi-agent systems based on the task complexity, execute tasks, and evaluate output based on the given criteria.
 
-Model-agnostic agents can handle RAG tools, tools, callbacks, and knowledge sharing among other agents.
+Agents are model-agnostic, and can handle and share RAG tools, knowledge, memory, and callbacks among other agents. (self-learn)
 
 
 ###  Agent formation
-Depending on the task complexity, agents can make a different formation.
 
-You can specify which formation you want them to generate, or let the agent decide if you don’t have a clear plan.
+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** |
@@ -158,8 +160,7 @@ You can specify which formation you want them to generate, or let the agent deci
 
    ```
    from pydantic import BaseModel
-   from versionhq.agent.model import Agent
-   from versionhq.task.model import Task
+   from versionhq import Agent, Task
 
    class CustomOutput(BaseModel):
       test1: str
@@ -199,9 +200,7 @@ This will return `TaskOutput` instance that stores a response in plane text, JSO
 ### Case 2. Supervising:
 
    ```
-   from versionhq.agent.model import Agent
-   from versionhq.task.model import Task, ResponseField
-   from versionhq.team.model import Team, TeamMember
+   from versionhq import Agent, Task, ResponseField, 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")

{versionhq-1.1.11.8 → versionhq-1.1.12.2}/README.md

@@ -2,12 +2,12 @@
 
 ![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.11.4-blue)
-![python ver](https://img.shields.io/badge/Python->=3.12-purple)
+![PyPI](https://img.shields.io/badge/PyPI-v1.1.12+-blue)
+![python ver](https://img.shields.io/badge/Python-3.11+-purple)
 ![pyenv ver](https://img.shields.io/badge/pyenv-2.5.0-orange)
 
 
-LLM orchestration frameworks to deploy multi-agent systems with task-based formation.
+Agentic orchestration framework to deploy agent network and handle complex task automation.
 
 **Visit:**
 
@@ -46,15 +46,16 @@ LLM orchestration frameworks to deploy multi-agent systems with task-based forma
 
 ## Key Features
 
-Generate mulit-agent systems depending on the complexity of the task, and execute the task with agents of choice.
+Generate multi-agent systems based on the task complexity, execute tasks, and evaluate output based on the given criteria.
 
-Model-agnostic agents can handle RAG tools, tools, callbacks, and knowledge sharing among other agents.
+Agents are model-agnostic, and can handle and share RAG tools, knowledge, memory, and callbacks among other agents. (self-learn)
 
 
 ###  Agent formation
-Depending on the task complexity, agents can make a different formation.
 
-You can specify which formation you want them to generate, or let the agent decide if you don’t have a clear plan.
+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** |
@@ -82,8 +83,7 @@ You can specify which formation you want them to generate, or let the agent deci
 
    ```
    from pydantic import BaseModel
-   from versionhq.agent.model import Agent
-   from versionhq.task.model import Task
+   from versionhq import Agent, Task
 
    class CustomOutput(BaseModel):
       test1: str
@@ -123,9 +123,7 @@ This will return `TaskOutput` instance that stores a response in plane text, JSO
 ### Case 2. Supervising:
 
    ```
-   from versionhq.agent.model import Agent
-   from versionhq.task.model import Task, ResponseField
-   from versionhq.team.model import Team, TeamMember
+   from versionhq import Agent, Task, ResponseField, 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")

{versionhq-1.1.11.8 → versionhq-1.1.12.2}/pyproject.toml

@@ -15,13 +15,13 @@ exclude = ["test*", "__pycache__", "*.egg-info"]
 
 [project]
 name = "versionhq"
-version = "1.1.11.8"
+version = "1.1.12.2"
 authors = [{ name = "Kuriko Iwai", email = "kuriko@versi0n.io" }]
-description = "LLM orchestration frameworks for model-agnostic AI agents that handle complex outbound workflows"
+description = "Agentic orchestration framework for task automation"
 readme = "README.md"
 requires-python = ">=3.11"
 license = { file = "LICENSE" }
-keywords = ["orchestration framework", "orchestration", "ai agent", "multi-agent system", "RAG", "agent"]
+keywords = ["orchestration framework", "orchestration", "ai agent", "multi-agent system", "RAG", "agent", "agentic orchestration", "llm"]
 dependencies = [
   "regex==2024.11.6",
   "requests>=2.32.3",
@@ -43,6 +43,7 @@ dependencies = [
   "chromadb>=0.6.3",
   "wheel>=0.45.1",
   "envoy>=0.0.3",
+  "composio-core==0.7.0",
 ]
 classifiers = [
   "Programming Language :: Python",

versionhq-1.1.12.2/src/versionhq/__init__.py

@@ -0,0 +1,71 @@
+# silence some warnings
+import warnings
+warnings.filterwarnings(action="ignore", message="Pydantic serializer warnings:", category=UserWarning, module="pydantic.main")
+warnings.filterwarnings(action="ignore", category=UserWarning, module="pydantic._internal")
+warnings.filterwarnings(action="ignore", module="LiteLLM:utils")
+
+from versionhq.agent.model import Agent
+from versionhq.clients.customer.model import Customer
+from versionhq.clients.product.model import Product, ProductProvider
+from versionhq.clients.workflow.model import MessagingWorkflow, MessagingComponent
+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.task.model import Task, TaskOutput, ConditionalTask, ResponseField
+from versionhq.task.evaluate import Evaluation, EvaluationItem
+from versionhq.team.model import Team, TeamOutput, Formation, TeamMember, TaskHandlingProcess
+from versionhq.tool.model import Tool, ToolSet
+from versionhq.tool.cache_handler import CacheHandler
+from versionhq.tool.tool_handler import ToolHandler
+from versionhq.tool.composio_tool import ComposioHandler
+from versionhq.memory.contextual_memory import ContextualMemory
+from versionhq.memory.model import ShortTermMemory,LongTermMemory, UserMemory, MemoryItem
+
+
+
+__version__ = "1.1.12.2"
+__all__ = [
+    "Agent",
+
+    "Customer",
+    "Product",
+    "ProductProvider",
+    "MessagingWorkflow",
+    "MessagingComponent",
+
+    "Knowledge",
+    "KnowledgeStorage",
+    "PDFKnowledgeSource",
+    "CSVKnowledgeSource",
+    "JSONKnowledgeSource",
+    "TextFileKnowledgeSource",
+    "ExcelKnowledgeSource",
+    "StringKnowledgeSource",
+    "DoclingSource",
+
+    "Task",
+    "TaskOutput",
+    "ConditionalTask",
+    "ResponseField",
+
+    "Evaluation",
+    "EvaluationItem",
+
+    "Team",
+    "TeamOutput",
+    "Formation",
+    "TeamMember",
+    "TaskHandlingProcess",
+
+    "Tool",
+    "ToolSet",
+    "CacheHandler",
+    "ToolHandler",
+    "ComposioHandler",
+
+    "ContextualMemory",
+    "ShortTermMemory",
+    "LongTermMemory",
+    "UserMemory",
+    "MemoryItem"
+]

versionhq-1.1.12.2/src/versionhq/_utils/__init__.py

@@ -0,0 +1,3 @@
+from versionhq._utils.logger import Logger
+from versionhq._utils.process_config import process_config
+from versionhq._utils.usage_metrics import UsageMetrics

{versionhq-1.1.11.8 → versionhq-1.1.12.2}/src/versionhq/_utils/logger.py

@@ -36,10 +36,15 @@ class Printer:
 
 
 class Logger(BaseModel):
+    """
+    Control CLI messages.
+    Color: red = error, yellow = warning, blue = info (from vhq), green = info (from third party)
+    """
+
     verbose: bool = Field(default=True)
     _printer: Printer = PrivateAttr(default_factory=Printer)
 
     def log(self, level, message, color="yellow"):
         if self.verbose:
             timestamp = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
-            self._printer.print(f"\n{timestamp} - versionHQ - {level.upper()}: {message}", color=color)
+            self._printer.print(f"\n{timestamp} - versionHQ [{level.upper()}]: {message}", color=color)

versionhq-1.1.12.2/src/versionhq/agent/inhouse_agents.py

@@ -0,0 +1,41 @@
+from versionhq.agent.model import Agent
+from versionhq.llm.model import DEFAULT_MODEL_NAME
+
+"""
+In-house agents to be called across the project.
+[Rules] In house agents have names and roles that start with `vhq_`. No customization allowed by client.
+"""
+
+vhq_client_manager = Agent(
+    role="vhq-Client Manager",
+    goal="Efficiently communicate with the client on the task progress",
+    llm=DEFAULT_MODEL_NAME,
+    use_memory=True,
+)
+
+
+vhq_task_evaluator = Agent(
+    role="vhq-Task Evaluator",
+    goal="score the output according to the given evaluation criteria.",
+    llm=DEFAULT_MODEL_NAME,
+    llm_config=dict(top_p=0.8, top_k=30, max_tokens=5000, temperature=0.9),
+    maxit=1,
+    max_retry_limit=1,
+    use_memory=True # refer past eval records of similar tasks
+)
+
+
+vhq_formation_planner = Agent(
+    role="vhq-Formation Planner",
+    goal="Plan a formation of agents based on the given task descirption.",
+    llm="gemini/gemini-2.0-flash-exp",
+    llm_config=dict(top_p=0.8, top_k=30, temperature=0.9),
+    maxit=1,
+    max_retry_limit=1,
+    knowledge_sources=[
+        "Solo is a formation where a single agent with tools, knowledge, and memory handles tasks indivudually. When self-learning mode is on - it will turn into Random formation. Typical usecase is an email agent drafts promo message for the given audience using their own knowledge.",
+        "Supervising is a formation where the leader agent gives directions, while sharing its knowledge and memory with subbordinates.Subordinates can be solo agents or networks. Typical usecase is that the leader agent strategizes an outbound campaign plan and assigns components such as media mix or message creation to subordinate agents.",
+        "Network is a formation where multple agents can share tasks, knowledge, and memory among network members without hierarchy. Typical usecase is that an email agent and social media agent share the product knowledge and deploy multi-channel outbound campaign. ",
+        "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. ",
+    ]
+)

{versionhq-1.1.11.8 → versionhq-1.1.12.2}/src/versionhq/agent/model.py

@@ -1,6 +1,5 @@
 import os
 import uuid
-import datetime
 from typing import Any, Dict, List, Optional, TypeVar, Callable, Type
 from typing_extensions import Self
 from dotenv import load_dotenv
@@ -165,13 +164,16 @@ class Agent(BaseModel):
         Set up `llm` and `function_calling_llm` as valid LLM objects using the given values.
         """
         self.agent_ops_agent_name = self.role
-        self.llm = self._set_llm(llm=self.llm)
+        self.llm = self._convert_to_llm_class(llm=self.llm)
+
         function_calling_llm = self.function_calling_llm if self.function_calling_llm else self.llm if self.llm else None
-        self.function_calling_llm = self._set_llm(llm=function_calling_llm)
+        function_calling_llm = self._convert_to_llm_class(llm=function_calling_llm)
+        if function_calling_llm._supports_function_calling():
+            self.function_calling_llm = function_calling_llm
         return self
 
 
-    def _set_llm(self, llm: Any | None) -> LLM:
+    def _convert_to_llm_class(self, llm: Any | None) -> LLM:
         llm = llm if llm is not None else DEFAULT_MODEL_NAME
 
         match llm:
@@ -350,7 +352,7 @@ class Agent(BaseModel):
     @model_validator(mode="after")
     def set_up_memory(self) -> Self:
         """
-        Set up memories: stm, um
+        Set up memories: stm, ltm, and um
         """
 
         if self.use_memory == True:
@@ -413,7 +415,7 @@ class Agent(BaseModel):
                 task.tokens = self.llm._tokens
 
             task_execution_counter += 1
-            self._logger.log(level="info", message=f"Agent response: {raw_response}", color="blue")
+            self._logger.log(level="info", message=f"Agent response: {raw_response}", color="green")
             return raw_response
 
         except Exception as e:
@@ -429,7 +431,7 @@ class Agent(BaseModel):
                     iterations += 1
 
                 task_execution_counter += 1
-                self._logger.log(level="info", message=f"Agent #{task_execution_counter} response: {raw_response}", color="blue")
+                self._logger.log(level="info", message=f"Agent #{task_execution_counter} response: {raw_response}", color="green")
                 return raw_response
 
             if not raw_response:
@@ -474,6 +476,7 @@ class Agent(BaseModel):
                 task_prompt += memory.strip()
 
 
+        ## comment out for now
         # if self.team and self.team._train:
         #     task_prompt = self._training_handler(task_prompt=task_prompt)
         # else:

{versionhq-1.1.11.8 → versionhq-1.1.12.2}/src/versionhq/agent/rpm_controller.py

@@ -5,7 +5,7 @@ from typing_extensions import Self
 
 from pydantic import BaseModel, Field, PrivateAttr, model_validator
 
-from versionhq._utils.logger import Logger
+from versionhq._utils import Logger
 
 
 class RPMController(BaseModel):

{versionhq-1.1.11.8 → versionhq-1.1.12.2}/src/versionhq/clients/product/model.py

@@ -56,7 +56,6 @@ class ProductProvider(ABC, BaseModel):
         return self
 
 
-
 class Product(BaseModel):
     """
     A class to store product information used to create outbound

versionhq-1.1.12.2/src/versionhq/knowledge/__init__.py

@@ -0,0 +1,22 @@
+from versionhq.knowledge.model import Knowledge, KnowledgeStorage
+from versionhq.knowledge.source import (
+    CSVKnowledgeSource,
+    ExcelKnowledgeSource,
+    PDFKnowledgeSource,
+    TextFileKnowledgeSource,
+    JSONKnowledgeSource,
+    StringKnowledgeSource
+)
+from versionhq.knowledge.source_docling import DoclingSource
+
+__all__ = [
+    "Knowledge",
+    "KnowledgeStorage",
+    "DoclingSource",
+    "CSVKnowledgeSource",
+    "ExcelKnowledgeSource",
+    "PDFKnowledgeSource",
+    "TextFileKnowledgeSource",
+    "JSONKnowledgeSource",
+    "StringKnowledgeSource"
+]

{versionhq-1.1.11.8 → versionhq-1.1.12.2}/src/versionhq/knowledge/model.py

@@ -1,5 +1,3 @@
-import os
-from abc import ABC, abstractmethod
 from typing import Any, Dict, List, Optional
 from pydantic import BaseModel, ConfigDict, Field
 

{versionhq-1.1.11.8 → versionhq-1.1.12.2}/src/versionhq/knowledge/source.py

@@ -280,7 +280,6 @@ class PDFKnowledgeSource(BaseFileKnowledgeSource):
 
 
 
-
 class CSVKnowledgeSource(BaseFileKnowledgeSource):
     """
     A knowledge source class that stores and queries CSV file content using embeddings.