versionhq 1.1.9.14__tar.gz → 1.1.10.3__tar.gz

{versionhq-1.1.9.14 → versionhq-1.1.10.3}/.github/workflows/security_check.yml

@@ -25,4 +25,3 @@ jobs:
 
       - name: Run Bandit
         run: uv run bandit -c pyproject.toml -r src/ -ll
-  

{versionhq-1.1.9.14 → versionhq-1.1.10.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: versionhq
-Version: 1.1.9.14
+Version: 1.1.10.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
@@ -26,6 +26,7 @@ License: MIT License
         SOFTWARE.
         
 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
@@ -60,7 +61,7 @@ Requires-Dist: composio-langchain>=0.6.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.9-blue)
+![PyPI](https://img.shields.io/badge/PyPI->=v1.1.10-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)
 
@@ -76,8 +77,9 @@ Messaging workflows are created at individual level, and will be deployed on thi
 
 - [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)
+- [Doc](https://chief-oxygen-8a2.notion.site/Documentation-17e923685cf98001a5fad5c4b2acd79b?pvs=4)
+<!-- - [Github (Test client app)](https://github.com/versionHQ/test-client-app) -->
+- [Use case](https://versi0n.io/): Client web app for the outbound messaging automation
 
 
 <hr />
@@ -152,6 +154,9 @@ Multiple `agents` can form a `team` to complete complex tasks together.
    from versionhq.agent.model import Agent
    from versionhq.task.model import Task, ResponseField
 
+   def my_callback_func():
+      """callback func"""
+
    agent = Agent(
       role="demo",
       goal="amazing project goal",
@@ -162,13 +167,11 @@ Multiple `agents` can form a `team` to complete complex tasks together.
 
    task = Task(
       description="Amazing task",
-      expected_output_json=True,
-      expected_output_pydantic=False,
-      output_field_list=[
-         ResponseField(title="test1", type=str, required=True),
-         ResponseField(title="test2", type=list, required=True),
+      response_fields=[
+         ResponseField(title="test1", data_type=str, required=True),
+         ResponseField(title="test2", data_type=list, items=str, required=True),
       ],
-      callback=None,
+      callbacks=[my_callback_func]
    )
    res = task.execute_sync(agent=agent, context="amazing context to consider.")
    return res.to_dict()
@@ -192,13 +195,13 @@ This will return a dictionary with keys defined in the `ResponseField`.
 
    task_1 = Task(
       description="Analyze the client's business model.",
-      output_field_list=[ResponseField(title="test1", type=str, required=True),],
+      response_fields=[ResponseField(title="test1", data_type=str, required=True),],
       allow_delegation=True
    )
 
     task_2 = Task(
       description="Define the cohort.",
-      output_field_list=[ResponseField(title="test1", type=int, required=True),],
+      response_fields=[ResponseField(title="test1", data_type=int, required=True),],
       allow_delegation=False
    )
 
@@ -234,7 +237,7 @@ Tasks can be delegated to a team manager, peers in the team, or completely new a
    - [Composio](https://composio.dev/): Conect RAG agents with external tools, Apps, and APIs to perform actions and receive triggers. We use [tools](https://composio.dev/tools) and [RAG tools](https://app.composio.dev/app/ragtool) from Composio toolset.
 
 **Deployment**
-   - Python: Primary programming language. We use 3.12 in this project
+   - Python: Primary programming language. v3.13 is recommended.
    - [uv](https://docs.astral.sh/uv/): Python package installer and resolver
    - [pre-commit](https://pre-commit.com/): Manage and maintain pre-commit hooks
    - [setuptools](https://pypi.org/project/setuptools/): Build python modules
@@ -306,19 +309,17 @@ src/
 
 ## Contributing
 
-1. Fork the repository
-
-2. Create your feature branch (`git checkout -b feature/your-amazing-feature`)
+1. Create your feature branch (`git checkout -b feature/your-amazing-feature`)
 
-3. Create amazing features
+2. Create amazing features
 
-4. Test the features using the `tests` directory.
+3. Test the features using the `tests` directory.
 
    - Add a test function to respective components in the `tests` directory.
-   - Add your `LITELLM_API_KEY`, `OPENAI_API_KEY`, `COMPOSIO_API_KEY`, `DEFAULT_USER_ID` to the Github `repository secrets` @ settings > secrets & variables > Actions.
+   - Add your `LITELLM_API_KEY`, `OPENAI_API_KEY`, `COMPOSIO_API_KEY`, `DEFAULT_USER_ID` to the Github `repository secrets` located at settings > secrets & variables > Actions.
    - Run a test.
       ```
-      uv run pytest tests -vv
+      uv run pytest tests -vv --cache-clear
       ```
 
    **pytest**
@@ -326,10 +327,10 @@ src/
    * When adding a new file to `tests`, name the file ended with `_test.py`.
    * When adding a new feature to the file, name the feature started with `test_`.
 
-5. Pull the latest version of source code from the main branch (`git pull origin main`) *Address conflicts if any.
-6. Commit your changes (`git add .` / `git commit -m 'Add your-amazing-feature'`)
-7. Push to the branch (`git push origin feature/your-amazing-feature`)
-8. Open a pull request
+4. Pull the latest version of source code from the main branch (`git pull origin main`) *Address conflicts if any.
+5. Commit your changes (`git add .` / `git commit -m 'Add your-amazing-feature'`)
+6. Push to the branch (`git push origin feature/your-amazing-feature`)
+7. Open a pull request
 
 
 **Optional**
@@ -342,7 +343,7 @@ src/
    ```
    The frontend will be available at `http://localhost:3000`.
 
-* `production` is available at `https://versi0n.io`. Currently, we are running alpha test.
+* `production` use case is available at `https://versi0n.io`. Currently, we are running alpha test.
 
 
 

{versionhq-1.1.9.14 → versionhq-1.1.10.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.9-blue)
+![PyPI](https://img.shields.io/badge/PyPI->=v1.1.10-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)
 
@@ -18,8 +18,9 @@ Messaging workflows are created at individual level, and will be deployed on thi
 
 - [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)
+- [Doc](https://chief-oxygen-8a2.notion.site/Documentation-17e923685cf98001a5fad5c4b2acd79b?pvs=4)
+<!-- - [Github (Test client app)](https://github.com/versionHQ/test-client-app) -->
+- [Use case](https://versi0n.io/): Client web app for the outbound messaging automation
 
 
 <hr />
@@ -94,6 +95,9 @@ Multiple `agents` can form a `team` to complete complex tasks together.
    from versionhq.agent.model import Agent
    from versionhq.task.model import Task, ResponseField
 
+   def my_callback_func():
+      """callback func"""
+
    agent = Agent(
       role="demo",
       goal="amazing project goal",
@@ -104,13 +108,11 @@ Multiple `agents` can form a `team` to complete complex tasks together.
 
    task = Task(
       description="Amazing task",
-      expected_output_json=True,
-      expected_output_pydantic=False,
-      output_field_list=[
-         ResponseField(title="test1", type=str, required=True),
-         ResponseField(title="test2", type=list, required=True),
+      response_fields=[
+         ResponseField(title="test1", data_type=str, required=True),
+         ResponseField(title="test2", data_type=list, items=str, required=True),
       ],
-      callback=None,
+      callbacks=[my_callback_func]
    )
    res = task.execute_sync(agent=agent, context="amazing context to consider.")
    return res.to_dict()
@@ -134,13 +136,13 @@ This will return a dictionary with keys defined in the `ResponseField`.
 
    task_1 = Task(
       description="Analyze the client's business model.",
-      output_field_list=[ResponseField(title="test1", type=str, required=True),],
+      response_fields=[ResponseField(title="test1", data_type=str, required=True),],
       allow_delegation=True
    )
 
     task_2 = Task(
       description="Define the cohort.",
-      output_field_list=[ResponseField(title="test1", type=int, required=True),],
+      response_fields=[ResponseField(title="test1", data_type=int, required=True),],
       allow_delegation=False
    )
 
@@ -176,7 +178,7 @@ Tasks can be delegated to a team manager, peers in the team, or completely new a
    - [Composio](https://composio.dev/): Conect RAG agents with external tools, Apps, and APIs to perform actions and receive triggers. We use [tools](https://composio.dev/tools) and [RAG tools](https://app.composio.dev/app/ragtool) from Composio toolset.
 
 **Deployment**
-   - Python: Primary programming language. We use 3.12 in this project
+   - Python: Primary programming language. v3.13 is recommended.
    - [uv](https://docs.astral.sh/uv/): Python package installer and resolver
    - [pre-commit](https://pre-commit.com/): Manage and maintain pre-commit hooks
    - [setuptools](https://pypi.org/project/setuptools/): Build python modules
@@ -248,19 +250,17 @@ src/
 
 ## Contributing
 
-1. Fork the repository
-
-2. Create your feature branch (`git checkout -b feature/your-amazing-feature`)
+1. Create your feature branch (`git checkout -b feature/your-amazing-feature`)
 
-3. Create amazing features
+2. Create amazing features
 
-4. Test the features using the `tests` directory.
+3. Test the features using the `tests` directory.
 
    - Add a test function to respective components in the `tests` directory.
-   - Add your `LITELLM_API_KEY`, `OPENAI_API_KEY`, `COMPOSIO_API_KEY`, `DEFAULT_USER_ID` to the Github `repository secrets` @ settings > secrets & variables > Actions.
+   - Add your `LITELLM_API_KEY`, `OPENAI_API_KEY`, `COMPOSIO_API_KEY`, `DEFAULT_USER_ID` to the Github `repository secrets` located at settings > secrets & variables > Actions.
    - Run a test.
       ```
-      uv run pytest tests -vv
+      uv run pytest tests -vv --cache-clear
       ```
 
    **pytest**
@@ -268,10 +268,10 @@ src/
    * When adding a new file to `tests`, name the file ended with `_test.py`.
    * When adding a new feature to the file, name the feature started with `test_`.
 
-5. Pull the latest version of source code from the main branch (`git pull origin main`) *Address conflicts if any.
-6. Commit your changes (`git add .` / `git commit -m 'Add your-amazing-feature'`)
-7. Push to the branch (`git push origin feature/your-amazing-feature`)
-8. Open a pull request
+4. Pull the latest version of source code from the main branch (`git pull origin main`) *Address conflicts if any.
+5. Commit your changes (`git add .` / `git commit -m 'Add your-amazing-feature'`)
+6. Push to the branch (`git push origin feature/your-amazing-feature`)
+7. Open a pull request
 
 
 **Optional**
@@ -284,7 +284,7 @@ src/
    ```
    The frontend will be available at `http://localhost:3000`.
 
-* `production` is available at `https://versi0n.io`. Currently, we are running alpha test.
+* `production` use case is available at `https://versi0n.io`. Currently, we are running alpha test.
 
 
 

{versionhq-1.1.9.14 → versionhq-1.1.10.3}/SECURITY.md

@@ -1,3 +1,13 @@
+<!-- START doctoc generated TOC please keep comment here to allow auto update -->
+<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
+**Table of Contents**  *generated with [DocToc](https://github.com/thlorenz/doctoc)*
+
+- [Security Policy](#security-policy)
+  - [Supported Versions](#supported-versions)
+  - [Reporting a Vulnerability](#reporting-a-vulnerability)
+
+<!-- END doctoc generated TOC please keep comment here to allow auto update -->
+
 # Security Policy
 
 ## Supported Versions

{versionhq-1.1.9.14 → versionhq-1.1.10.3}/pyproject.toml

@@ -15,7 +15,7 @@ exclude = ["test*", "__pycache__"]
 
 [project]
 name = "versionhq"
-version = "1.1.9.14"
+version = "1.1.10.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"
@@ -52,6 +52,7 @@ classifiers = [
 
 [project.urls]
 Homepage = "https://versi0n.io"
+Documentation = "https://chief-oxygen-8a2.notion.site/Documentation-17e923685cf98001a5fad5c4b2acd79b?pvs=73"
 Repository = "https://github.com/versionHQ/multi-agent-system"
 Issues = "https://github.com/versionHQ/multi-agent-system/issues"
 

{versionhq-1.1.9.14 → versionhq-1.1.10.3}/src/versionhq/__init__.py

@@ -18,7 +18,7 @@ from versionhq.tool.model import Tool
 from versionhq.tool.composio_tool import ComposioHandler
 
 
-__version__ = "1.1.9.14"
+__version__ = "1.1.10.3"
 __all__ = [
     "Agent",
     "Customer",

{versionhq-1.1.9.14 → versionhq-1.1.10.3}/src/versionhq/_utils/logger.py

@@ -12,8 +12,6 @@ class Printer:
             self._print_red(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":
@@ -27,9 +25,6 @@ class Printer:
     def _print_green(self, content):
         print("\033[1m\033[92m {}\033[00m".format(content))
 
-    def _print_purple(self, content):
-        print("\033[95m {}\033[00m".format(content))
-
     def _print_red(self, content):
         print("\033[91m {}\033[00m".format(content))
 
@@ -47,4 +42,4 @@ class Logger(BaseModel):
     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} - versionHQ - {level.upper()}: {message}", color=color)

versionhq-1.1.10.3/src/versionhq/_utils/process_config.py

@@ -0,0 +1,23 @@
+from typing import Any, Dict, Type
+from pydantic import BaseModel
+
+
+def process_config(values_to_update: Dict[str, Any], model_class: Type[BaseModel]) -> Dict[str, Any]:
+    """
+    Process the config dictionary and update the values accordingly.
+    Refer to the Pydantic model class for field validation.
+    """
+
+    config = values_to_update.pop("config", {})
+
+    if config:
+        for k, v in config.items():
+            if k not in model_class.model_fields or values_to_update.get(k) is not None:
+                continue
+
+            if isinstance(v, dict) and isinstance(values_to_update.get(k), dict):
+                values_to_update[k].update(v)
+            else:
+                values_to_update[k] = v
+
+    return values_to_update

versionhq-1.1.10.3/src/versionhq/agent/TEMPLATES/Backstory.py

@@ -0,0 +1,4 @@
+BACKSTORY_FULL="""You are an expert {role} with deep understanding of {knowledge} and highly skilled in {skillsets}. You have abilities to call the RAG tools that can {rag_tool_overview}. Your primary goal is to identify competitive solutions by leveraging your knowledge and skillsets to achieve the following goal: {goal}."""
+
+
+BACKSTORY_SHORT="""You are an expert {role} with the right skillsets and knowledge. Your primary goal is to identify competitive solutions by leveraging your knowledge and skillsets to achieve the following goal: {goal}."""