versionhq 1.1.9.1__tar.gz → 1.1.9.3__tar.gz

{versionhq-1.1.9.1 → versionhq-1.1.9.3}/.gitignore

@@ -1,7 +1,9 @@
+deploy.py
+destinations.py
+
 knowledge/
 memory/
 
-# composio.py
 memo.txt
 
 dist/

{versionhq-1.1.9.1 → versionhq-1.1.9.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: versionhq
-Version: 1.1.9.1
+Version: 1.1.9.3
 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,12 +52,15 @@ Requires-Dist: setuptools>=75.6.0
 Requires-Dist: wheel>=0.45.1
 Requires-Dist: python-dotenv>=1.0.0
 Requires-Dist: appdirs>=1.4.4
+Requires-Dist: langchain>=0.3.14
+Requires-Dist: langchain-openai>=0.2.14
+Requires-Dist: composio-langchain>=0.6.12
 
 # 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.9-blue)
+![PyPI](https://img.shields.io/badge/PyPI-v1.1.9.3-blue)
 ![python ver](https://img.shields.io/badge/Python-3.12/3.13-purple)
 ![pyenv ver](https://img.shields.io/badge/pyenv-2.5.0-orange)
 

{versionhq-1.1.9.1 → versionhq-1.1.9.3}/README.md

@@ -2,7 +2,7 @@
 
 ![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.9-blue)
+![PyPI](https://img.shields.io/badge/PyPI-v1.1.9.3-blue)
 ![python ver](https://img.shields.io/badge/Python-3.12/3.13-purple)
 ![pyenv ver](https://img.shields.io/badge/pyenv-2.5.0-orange)
 

{versionhq-1.1.9.1 → versionhq-1.1.9.3}/pyproject.toml

@@ -15,7 +15,7 @@ exclude = ["test*", "__pycache__"]
 
 [project]
 name = "versionhq"
-version = "1.1.9.1"
+version = "1.1.9.3"
 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"
@@ -37,6 +37,9 @@ dependencies = [
   "wheel>=0.45.1",
   "python-dotenv>=1.0.0",
   "appdirs>=1.4.4",
+  "langchain>=0.3.14",
+  "langchain-openai>=0.2.14",
+  "composio-langchain>=0.6.12"
 ]
 classifiers = [
   "Programming Language :: Python",

{versionhq-1.1.9.1 → versionhq-1.1.9.3}/requirements.txt

@@ -5,6 +5,7 @@ aiohappyeyeballs==2.4.4
 aiohttp==3.11.11
     # via
     #   composio-core
+    #   langchain
     #   litellm
 aiosignal==1.3.2
     # via aiohttp
@@ -43,8 +44,12 @@ click==8.1.8
     #   uvicorn
 composio==0.1.0
     # via versionhq (pyproject.toml)
-composio-core==0.6.9
-    # via composio-openai
+composio-core==0.6.11.post1
+    # via
+    #   composio-langchain
+    #   composio-openai
+composio-langchain==0.6.12
+    # via versionhq (pyproject.toml)
 composio-openai==0.6.9
     # via versionhq (pyproject.toml)
 cryptography==44.0.0
@@ -69,6 +74,7 @@ httpcore==1.0.7
     # via httpx
 httpx==0.27.2
     # via
+    #   langsmith
     #   litellm
     #   openai
 huggingface-hub==0.27.0
@@ -91,6 +97,10 @@ jiter==0.8.2
     # via openai
 json-repair==0.35.0
     # via versionhq (pyproject.toml)
+jsonpatch==1.33
+    # via langchain-core
+jsonpointer==3.0.0
+    # via jsonpatch
 jsonref==1.1.0
     # via composio-core
 jsonschema==4.23.0
@@ -99,6 +109,27 @@ jsonschema==4.23.0
     #   litellm
 jsonschema-specifications==2024.10.1
     # via jsonschema
+langchain==0.3.14
+    # via
+    #   versionhq (pyproject.toml)
+    #   composio-langchain
+langchain-core==0.3.29
+    # via
+    #   langchain
+    #   langchain-openai
+    #   langchain-text-splitters
+langchain-openai==0.2.14
+    # via
+    #   versionhq (pyproject.toml)
+    #   composio-langchain
+langchain-text-splitters==0.3.4
+    # via langchain
+langchainhub==0.1.21
+    # via composio-langchain
+langsmith==0.2.10
+    # via
+    #   langchain
+    #   langchain-core
 litellm==1.56.5
     # via versionhq (pyproject.toml)
 markdown-it-py==3.0.0
@@ -113,13 +144,21 @@ multidict==6.1.0
     # via
     #   aiohttp
     #   yarl
+numpy==2.2.1
+    # via langchain
 openai==1.58.1
     # via
     #   versionhq (pyproject.toml)
     #   composio-openai
+    #   langchain-openai
     #   litellm
+orjson==3.10.13
+    # via langsmith
 packaging==24.2
-    # via huggingface-hub
+    # via
+    #   huggingface-hub
+    #   langchain-core
+    #   langchainhub
 paramiko==3.5.0
     # via composio-core
 propcache==0.2.1
@@ -132,7 +171,11 @@ pydantic==2.10.4
     # via
     #   versionhq (pyproject.toml)
     #   composio-core
+    #   composio-langchain
     #   fastapi
+    #   langchain
+    #   langchain-core
+    #   langsmith
     #   litellm
     #   openai
 pydantic-core==2.27.2
@@ -150,7 +193,10 @@ python-dotenv==1.0.1
     #   versionhq (pyproject.toml)
     #   litellm
 pyyaml==6.0.2
-    # via huggingface-hub
+    # via
+    #   huggingface-hub
+    #   langchain
+    #   langchain-core
 referencing==0.35.1
     # via
     #   jsonschema
@@ -164,8 +210,14 @@ requests==2.32.3
     #   versionhq (pyproject.toml)
     #   composio-core
     #   huggingface-hub
+    #   langchain
+    #   langchainhub
+    #   langsmith
     #   pysher
+    #   requests-toolbelt
     #   tiktoken
+requests-toolbelt==1.0.0
+    # via langsmith
 rich==13.9.4
     # via composio-core
 rpds-py==0.22.3
@@ -183,29 +235,42 @@ sniffio==1.3.1
     #   anyio
     #   httpx
     #   openai
+sqlalchemy==2.0.36
+    # via langchain
 starlette==0.41.3
     # via fastapi
+tenacity==9.0.0
+    # via
+    #   langchain
+    #   langchain-core
 tiktoken==0.8.0
-    # via litellm
+    # via
+    #   langchain-openai
+    #   litellm
 tokenizers==0.21.0
     # via litellm
 tqdm==4.67.1
     # via
     #   huggingface-hub
     #   openai
+types-requests==2.32.0.20241016
+    # via langchainhub
 typing==3.10.0.0
     # via versionhq (pyproject.toml)
 typing-extensions==4.12.2
     # via
     #   fastapi
     #   huggingface-hub
+    #   langchain-core
     #   openai
     #   pydantic
     #   pydantic-core
+    #   sqlalchemy
 urllib3==2.3.0
     # via
     #   requests
     #   sentry-sdk
+    #   types-requests
 uvicorn==0.34.0
     # via composio-core
 websocket-client==1.8.0

{versionhq-1.1.9.1 → versionhq-1.1.9.3}/src/versionhq/__init__.py

@@ -15,10 +15,10 @@ from versionhq.llm.model import LLM
 from versionhq.task.model import Task, TaskOutput
 from versionhq.team.model import Team, TeamOutput
 from versionhq.tool.model import Tool
-from versionhq.tool.composio import Composio
+from versionhq.tool.composio_tool import ComposioHandler
 
 
-__version__ = "1.1.9.1"
+__version__ = "1.1.9.3"
 __all__ = [
     "Agent",
     "Customer",
@@ -34,5 +34,5 @@ __all__ = [
     "Team",
     "TeamOutput",
     "Tool",
-    "Composio"
+    "ComposioHandler"
 ]

{versionhq-1.1.9.1 → versionhq-1.1.9.3}/src/versionhq/_utils/logger.py

@@ -10,23 +10,21 @@ class Printer:
             self._print_purple(content)
         elif color == "red":
             self._print_red(content)
-        elif color == "bold_green":
-            self._print_bold_green(content)
-        elif color == "bold_purple":
-            self._print_bold_purple(content)
-        elif color == "bold_blue":
-            self._print_bold_blue(content)
+        elif color == "green":
+            self._print_green(content)
+        elif color == "purple":
+            self._print_purple(content)
+        elif color == "blue":
+            self._print_blue(content)
         elif color == "yellow":
             self._print_yellow(content)
-        elif color == "bold_yellow":
-            self._print_bold_yellow(content)
         else:
             print(content)
 
-    def _print_bold_purple(self, content):
+    def _print_purple(self, content):
         print("\033[1m\033[95m {}\033[00m".format(content))
 
-    def _print_bold_green(self, content):
+    def _print_green(self, content):
         print("\033[1m\033[92m {}\033[00m".format(content))
 
     def _print_purple(self, content):
@@ -35,23 +33,18 @@ class Printer:
     def _print_red(self, content):
         print("\033[91m {}\033[00m".format(content))
 
-    def _print_bold_blue(self, content):
+    def _print_blue(self, content):
         print("\033[1m\033[94m {}\033[00m".format(content))
 
     def _print_yellow(self, content):
-        print("\033[93m {}\033[00m".format(content))
-
-    def _print_bold_yellow(self, content):
         print("\033[1m\033[93m {}\033[00m".format(content))
 
 
 class Logger(BaseModel):
-    verbose: bool = Field(default=False)
+    verbose: bool = Field(default=True)
     _printer: Printer = PrivateAttr(default_factory=Printer)
 
-    def log(self, level, message, color="bold_yellow"):
+    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}][{level.upper()}]: {message}", color=color
-            )
+            self._printer.print(f"\n[{timestamp}][{level.upper()}]: {message}", color=color)

{versionhq-1.1.9.1 → versionhq-1.1.9.3}/src/versionhq/agent/model.py

@@ -6,11 +6,9 @@ from dotenv import load_dotenv
 from pydantic import UUID4, BaseModel, Field, InstanceOf, PrivateAttr, model_validator, field_validator
 from pydantic_core import PydanticCustomError
 
-from versionhq._utils.cache_handler import CacheHandler
 from versionhq._utils.logger import Logger
 from versionhq._utils.rpm_controller import RPMController
 from versionhq._utils.usage_metrics import UsageMetrics
-from versionhq.agent.parser import AgentAction
 from versionhq.llm.llm_vars import LLM_VARS
 from versionhq.llm.model import LLM, DEFAULT_CONTEXT_WINDOW
 from versionhq.task import TaskOutputFormat
@@ -122,10 +120,7 @@ class Agent(BaseModel):
 
     # config, cache, error handling
     config: Optional[Dict[str, Any]] = Field(default=None, exclude=True, description="Configuration for the agent")
-    cache: bool = Field(default=True, description="Whether the agent should use a cache for tool usage.")
-    cache_handler: InstanceOf[CacheHandler] = Field(default=None, description="An instance of the CacheHandler class.")
     formatting_errors: int = Field(default=0, description="Number of formatting errors.")
-    verbose: bool = Field(default=True, description="Verbose mode for the Agent Execution")
     agent_ops_agent_name: str = None
     agent_ops_agent_id: str = None
 

versionhq-1.1.9.3/src/versionhq/clients/customer/__init__.py

@@ -0,0 +1,5 @@
+from enum import Enum
+
+
+class Status(str, Enum):
+    ON_WORKFLOW = "on_workflow"

versionhq-1.1.9.3/src/versionhq/clients/customer/model.py

@@ -0,0 +1,53 @@
+import uuid
+from abc import ABC, abstractmethod
+from typing import Any, Dict, List, Callable, Type, Optional, get_args, get_origin
+from pydantic import UUID4, InstanceOf, BaseModel, ConfigDict, Field, create_model, field_validator, model_validator
+from pydantic_core import PydanticCustomError
+
+from versionhq.clients.product.model import Product, ProductProvider
+from versionhq.clients.customer import Status
+
+
+class BaseCustomer(ABC, BaseModel):
+    """
+    Abstract base class for the base customer
+    """
+
+    id: UUID4 = Field(default_factory=uuid.uuid4, frozen=True)
+    name: Optional[str] = Field(default=None, description="customer's name if any")
+    products: Optional[List[Product]] = Field(default=list, description="store products that the customer is associated with")
+    analysis: str = Field(default=None, description="store the latest analysis results on the customer")
+    status: str = Field(default=Status.ON_WORKFLOW)
+
+
+    @field_validator("id", mode="before")
+    @classmethod
+    def _deny_user_set_id(cls, v: Optional[UUID4]) -> None:
+        if v:
+            raise PydanticCustomError("may_not_set_field", "This field is not to be set by the user.", {})
+
+
+    def customer_to(self) -> List[ProductProvider]:
+        """
+        Return list of ProductProvider if the customer has `product_list`
+        """
+
+        res = []
+        if self.products:
+            for item in self.products:
+                if item.provider not in res:
+                    res.appned(item.provider)
+        return res
+
+
+    @abstractmethod
+    def _deploy(self, *args, **kwargs) -> Any:
+        """Any method to deploy targeting the customer"""
+
+
+class Customer(BaseCustomer):
+    id: UUID4 = Field(default_factory=uuid.uuid4, frozen=True)
+    name: Optional[str] = Field(default=None, description="customer's name if any")
+    products: Optional[List[Product]] = Field(default=list, description="store products that the customer is associated with")
+    analysis: str = Field(default=None, description="store the latest analysis results on the customer")
+    status: str = Field(default=Status.ON_WORKFLOW)

{versionhq-1.1.9.1 → versionhq-1.1.9.3}/src/versionhq/clients/product/model.py

@@ -1,22 +1,23 @@
 import uuid
+from abc import ABC, abstractmethod
 from typing import Any, Dict, List, Callable, Type, Optional, get_args, get_origin
+
 from pydantic import UUID4, InstanceOf, BaseModel, ConfigDict, Field, create_model, field_validator, model_validator
 from pydantic_core import PydanticCustomError
 
+from versionhq.tool import ComposioAppName
+
 
-class ProductProvider(BaseModel):
+class ProductProvider(ABC, BaseModel):
     """
-    Store the minimal client information.
-    `data_pipeline` and `destinations` are for composio plug-in.
-    (!REFINEME) Create an Enum list for the options.
-    (!REFINEME) Create an Enum list for regions.
+    Abstract class for the product provider entity.
     """
 
     id: UUID4 = Field(default_factory=uuid.uuid4, frozen=True)
-    name: Optional[str] = Field(default=None, description="client name")
+    name: Optional[str] = Field(default=None)
     region: Optional[str] = Field(default=None, description="region of client's main business operation")
-    data_pipeline: Optional[List[str]] = Field(default=None, description="store the data pipelines that the client is using")
-    destinations: Optional[List[str]] = Field(default=None,description="store the destination services that the client is using")
+    data_pipelines: Optional[List[ComposioAppName | str]] = Field(default_factory=list)
+    destination_services: Optional[List[ComposioAppName | str]] = Field(default=None)
 
     @field_validator("id", mode="before")
     @classmethod

{versionhq-1.1.9.1 → versionhq-1.1.9.3}/src/versionhq/clients/workflow/model.py

@@ -10,6 +10,7 @@ from versionhq.clients.product.model import Product
 from versionhq.clients.customer.model import Customer
 from versionhq.agent.model import Agent
 from versionhq.team.model import Team
+from versionhq.tool import ComposioAppName
 
 
 class ScoreFormat:
@@ -57,14 +58,12 @@ class Score:
 class MessagingComponent(ABC, BaseModel):
     layer_id: int = Field(default=0, description="add id of the layer: 0, 1, 2")
     message: str = Field(default=None, max_length=1024, description="text message content to be sent")
-    interval: Optional[str] = Field(
-        default=None, description="interval to move on to the next layer. if this is the last layer, set as `None`"
-    )
-    score: float | InstanceOf[Score] = Field(default=None)
-    condition: str = Field(default=None, max_length=128, description="condition to execute the next messaging component")
+    score: InstanceOf[Score] = Field(default=None)
+    condition: str = Field(default=None, max_length=128, description="condition to execute the next component")
+    interval: Optional[str] = Field(default=None, description="ideal interval to set to assess the condition")
 
 
-    def store_scoring_result(self, scoring_subject: str, score_raw: int | Score | ScoreFormat = None) -> Self:
+    def store_scoring_result(self, subject: str, score_raw: int | Score | ScoreFormat = None) -> Self:
         """
         Set up the `score` field
         """
@@ -74,12 +73,12 @@ class MessagingComponent(ABC, BaseModel):
 
         elif isinstance(score_raw, ScoreFormat):
             score_instance = Score()
-            setattr(score_instance, scoring_subject, score_raw)
+            setattr(score_instance, subject, score_raw)
             setattr(self, "score", score_instance)
 
         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(score_instance, "kwargs", { subject: score_format_instance })
             setattr(self, "score", score_instance)
 
         else:
@@ -100,23 +99,17 @@ class MessagingWorkflow(ABC, BaseModel):
     model_config = ConfigDict()
 
     id: UUID4 = Field(default_factory=uuid.uuid4, frozen=True)
-    components: List[MessagingComponent] = Field(default_factory=list, description="store messaging components in the workflow")
+    messaging_components: List[MessagingComponent] = Field(default_factory=list, description="store messaging components in the workflow")
 
     # responsible tean or agents
-    team: Optional[Team] = Field(default=None, description="store `Team` instance responsibile for autopiloting this workflow")
-    agents: Optional[List[Agent]] = Field(
-        default=None, description="store `Agent` instances responsible for autopiloting this workflow. if the team exsits, this field remains as `None`")
+    team: Optional[Team] = Field(default=None, description="store a responsibile team to autopilot the workflow")
+    agents: Optional[List[Agent]] = Field(default=None, description="store responsible agents. None when the team exists")
 
     # metrics
-    destination: Optional[str | None] = Field(default=None, description="destination service to launch this workflow")
+    destination: Optional[ComposioAppName | str] = Field(default=None, description="destination service to launch the workflow")
     product: InstanceOf[Product] = Field(default=None)
     customer: InstanceOf[Customer] = Field(default=None)
-
-    metrics: List[Dict[str, Any]] | List[str] = Field(
-        default=None,
-        max_length=256,
-        description="store metrics that used to predict and track the performance of this workflow."
-    )
+    performance_metrics: List[Dict[str, Any]] | List[str] = Field(default=None, max_length=256, description="performance metrics to track")
 
     @field_validator("id", mode="before")
     @classmethod
@@ -132,11 +125,11 @@ class MessagingWorkflow(ABC, BaseModel):
         Prioritize customer's destination to the product provider's destination list.
         """
         if self.destination is None:
-            if self.customer is not None:
-                self.destination = self.customer.on
+            # if self.customer is not None:
+            #     self.destination = self.customer.on
 
-            elif self.product.provider is not None and self.product.provider.destinations:
-                self.destination = self.product.provider.destinations[0]
+            if self.product.provider is not None and self.product.provider.destination_services:
+                self.destination = self.product.provider.destination_services[0]
 
         return self
 

{versionhq-1.1.9.1 → versionhq-1.1.9.3}/src/versionhq/tool/__init__.py

@@ -40,10 +40,11 @@ composio_app_set = [
     (ComposioAppName.LINKEDIN, ComposioAuthScheme.OAUTH2),
 ]
 
-class COMPOSIO_STATUS(str, Enum):
-    INITIATED = "initiated"
-    ACTIVE = "active"
-    FAILED = "failed"
+class ComposioStatus(str, Enum):
+    INITIATED = "INITIATED"
+    ACTIVE = "ACTIVE"
+    FAILED = "FAILED"
+
 
 
 
@@ -51,3 +52,5 @@ class ComposioAction(str, Enum):
     """
     Enum to store composio's action that can be called via `Actions.xxx`
     """
+    # HUBSPOT_INITIATE_DATA_IMPORT_PROCESS = "hubspot_initate_date_import_process"
+    HUBSPOT_CREATE_PIPELINE_STAGE = "hubspot_create_pipeline_stage"