versionhq 1.2.2.6__py3-none-any.whl → 1.2.2.8__py3-none-any.whl

versionhq/__init__.py

@@ -32,7 +32,7 @@ from versionhq.agent_network.formation import form_agent_network
 from versionhq.task_graph.draft import workflow
 
 
-__version__ = "1.2.2.6"
+__version__ = "1.2.2.8"
 __all__ = [
     "Agent",
 

versionhq/llm/llm_vars.py

@@ -32,39 +32,30 @@ MODELS = {
     ],
     "anthropic": [
         "claude-3-7-sonnet-latest",
-        "claude-3-5-sonnet-20241022",
-        "claude-3-5-sonnet-20240620",
-        "claude-3-haiku-2024030",
-        "claude-3-opus-20240229",
-        "claude-3-haiku-20240307",
+        "claude-3-5-haiku-latest",
+        "claude-3-5-sonnet-latest",
+        "claude-3-opus-latest",
     ],
     "openrouter": [
         "openrouter/deepseek/deepseek-r1",
-
         "openrouter/qwen/qwen-2.5-72b-instruct",
-
-        "openrouter/google/gemini-2.0-flash-thinking-exp:free",
-        "openrouter/google/gemini-2.0-flash-thinking-exp-1219:free",
         "openrouter/google/gemini-2.0-flash-001",
-
-        "openrouter/meta-llama/llama-3.3-70b-instruct",
-        "openrouter/mistralai/mistral-large-2411",
+        "openrouter/mistralai/mistral-large",
         "openrouter/cohere/command-r-plus",
+        "openrouter/databricks/dbrx-instruct",
     ],
     "bedrock": [
         "bedrock/converse/us.meta.llama3-3-70b-instruct-v1:0",
         "bedrock/us.meta.llama3-2-1b-instruct-v1:0",
         "bedrock/us.meta.llama3-2-3b-instruct-v1:0",
         "bedrock/us.meta.llama3-2-11b-instruct-v1:0",
-
+        "bedrock/us.meta.llama3-2-90b-instruct-v1:0",
         "bedrock/mistral.mistral-7b-instruct-v0:2",
         "bedrock/mistral.mixtral-8x7b-instruct-v0:1",
         "bedrock/mistral.mistral-large-2407-v1:0",
-
         "bedrock/amazon.titan-text-lite-v1",
         "bedrock/amazon.titan-text-express-v1",
         "bedrock/amazon.titan-text-premier-v1:0",
-
         "bedrock/cohere.command-r-plus-v1:0",
         "bedrock/cohere.command-r-v1:0",
         "bedrock/cohere.command-text-v14",
@@ -93,39 +84,40 @@ LLM_CONTEXT_WINDOW_SIZES = {
     "gpt-4": 8192,
     "gpt-4o": 128000,
     "gpt-4o-mini": 128000,
-    "gpt-4-turbo": 128000,
     "o1-preview": 128000,
     "o1-mini": 128000,
 
     "gemini/gemini-1.5-flash": 1048576,
     "gemini/gemini-1.5-pro": 2097152,
     "gemini/gemini-2.0-flash-exp": 1048576,
-    "gemini/gemini-gemma-2-9b-it": 8192,
-    "gemini/gemini-gemma-2-27b-it": 8192,
-
-    "claude-3-5-sonnet-20241022": 200000,
-    "claude-3-5-sonnet-20240620": 200000,
-    "claude-3-sonnet-20240229": 200000,
-    "claude-3-opus-20240229": 200000,
-    "claude-3-haiku-20240307": 200000,
-    "claude-3-5-sonnet-2024102": 200000,
-
-    "deepseek-chat": 128000,
-    "deepseek/deepseek-reasoner": 8192,
-
-    "gemma2-9b-it": 8192,
-    "gemma-7b-it": 8192,
-    "llama3-groq-70b-8192-tool-use-preview": 8192,
-    "llama3-groq-8b-8192-tool-use-preview": 8192,
-    "llama-3.1-70b-versatile": 131072,
-    "llama-3.1-8b-instant": 131072,
-    "llama-3.2-1b-preview": 8192,
-    "llama-3.2-3b-preview": 8192,
-    "llama-3.2-11b-text-preview": 8192,
-    "llama-3.2-90b-text-preview": 8192,
-    "llama3-70b-8192": 8192,
-    "llama3-8b-8192": 8192,
-    "mixtral-8x7b-32768": 32768,
+
+    "claude-3-7-sonnet-latest": 200000,
+    "claude-3-5-haiku-latest": 200000,
+    "claude-3-5-sonnet-latest": 200000,
+    "claude-3-opus-latest": 200000,
+
+    "openrouter/deepseek/deepseek-r1" :65336,
+    "openrouter/qwen/qwen-2.5-72b-instruct": 33792,
+    "openrouter/google/gemini-2.0-flash-001": 1048576,
+    "openrouter/mistralai/mistral-large": 32000,
+    "openrouter/cohere/command-r-plus": 128000,
+    "openrouter/databricks/dbrx-instruct": 32768,
+
+    "bedrock/converse/us.meta.llama3-3-70b-instruct-v1:0": 8192,
+    "bedrock/us.meta.llama3-2-1b-instruct-v1:0": 128000,
+    "bedrock/us.meta.llama3-2-3b-instruct-v1:0": 128000,
+    "bedrock/us.meta.llama3-2-11b-instruct-v1:0": 128000,
+    "bedrock/us.meta.llama3-2-90b-instruct-v1:0": 128000,
+    "bedrock/mistral.mistral-7b-instruct-v0:2": 8191,
+    "bedrock/mistral.mixtral-8x7b-instruct-v0:1": 8191,
+    "bedrock/mistral.mistral-large-2407-v1:0": 8191,
+    "bedrock/amazon.titan-text-lite-v1": 4000,
+    "bedrock/amazon.titan-text-express-v1": 8000,
+    "bedrock/amazon.titan-text-premier-v1:0": 32000,
+    "bedrock/cohere.command-r-plus-v1:0": 4096,
+    "bedrock/cohere.command-r-v1:0": 4096,
+    "bedrock/cohere.command-text-v14": 4096,
+    "bedrock/cohere.command-light-text-v14": 4096,
 }
 
 
@@ -142,6 +134,7 @@ PARAMS = {
         "context_window_fallback_dict",
         "fallbacks",
         "metadata",
+        "api_key",
     ],
     "common": [
         "model",
@@ -156,7 +149,6 @@ PARAMS = {
         "n",
         "stop",
         # "base_url",
-        # "api_key",
     ],
     "openai": [
         "timeout",

versionhq/llm/model.py

@@ -69,7 +69,6 @@ class LLM(BaseModel):
 
     _logger: Logger = PrivateAttr(default_factory=lambda: Logger(verbose=True))
     _init_model_name: str = PrivateAttr(default=None)
-    # _init_config: Optional[Dict[str, Any]] = PrivateAttr(default_factory=dict) # stores llm config passed by client or agent
     _tokens: int = PrivateAttr(default=0) # aggregate number of tokens consumed
 
     model: str = Field(default=None)

{versionhq-1.2.2.6.dist-info → versionhq-1.2.2.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: versionhq
-Version: 1.2.2.6
+Version: 1.2.2.8
 Summary: An agentic orchestration framework for building agent networks that handle task automation.
 Author-email: Kuriko Iwai <kuriko@versi0n.io>
 License: MIT License
@@ -91,7 +91,7 @@ Requires-Dist: scikit-learn>=1.6.1; extra == "eval"
 ![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.2.2+-blue)
-![python ver](https://img.shields.io/badge/Python-3.11/3.12-purple)
+![python ver](https://img.shields.io/badge/Python-3.11|3.12-purple)
 ![pyenv ver](https://img.shields.io/badge/pyenv-2.5.0-orange)
 
 
@@ -99,10 +99,10 @@ Agentic orchestration framework for multi-agent networks and task graphs for com
 
 **Visit:**
 
-- [Playground](https://versi0n.io/playground)
+- [Playground](https://versi0n.io/)
 - [Docs](https://docs.versi0n.io)
-- [Github Repository](https://github.com/versionHQ/multi-agent-system)
-- [PyPI](https://pypi.org/project/versionhq/)
+- [Github](https://github.com/versionHQ/)
+- [Python SDK](https://pypi.org/project/versionhq/)
 
 <hr />
 
@@ -117,9 +117,10 @@ Agentic orchestration framework for multi-agent networks and task graphs for com
   - [Optimization](#optimization)
 - [Quick Start](#quick-start)
   - [Package installation](#package-installation)
-  - [Forming a agent network](#forming-a-agent-network)
-  - [Executing tasks](#executing-tasks)
-  - [Supervising](#supervising)
+  - [Launching an agent](#launching-an-agent)
+  - [Automating workflows](#automating-workflows)
+  - [Executing a single task](#executing-a-single-task)
+  - [Supervising agents](#supervising-agents)
 - [Technologies Used](#technologies-used)
 - [Project Structure](#project-structure)
 - [Setting Up Your Project](#setting-up-your-project)
@@ -247,33 +248,45 @@ agent.update(
 
 ### Package installation
 
-   ```
-   pip install versionhq
-   ```
+```
+pip install versionhq
+```
 
 (Python 3.11 / 3.12)
 
-### Forming a agent network
 
-   ```python
-   import versionhq as vhq
+### Launching an agent
 
-   network = work(
-      task="YOUR AMAZING TASK OVERVIEW",
-      expected_outcome="YOUR OUTCOME EXPECTATION",
-   )
-   res, tg = network.launch()
-   ```
 
-This will form a agent network with multiple agents on `Formation` and return response in `TaskOutput` object and `TaskGraph` that connects multiple tasks as nodes.
+```python
+import versionhq as vhq
 
+agent = vhq.Agent(role="Marketer")
+res = agent.start()
+
+assert isinstance(res, vhq.TaskOutput) # contains agent's response in text, JSON, Pydantic formats with usage recordes and eval scores.
+```
 
-### Executing tasks
 
-You can simply build an agent using `Agent` model and execute the task using `Task` class.
+### Automating workflows
 
-By default, agents prioritize JSON over plane text outputs.
+```python
+import versionhq as vhq
 
+network = vhq.form_agent_network(
+   task="draft a promo plan",
+   expected_outcome="marketing plan, budget, KPI targets",
+)
+res, tg = network.launch()
+
+assert isinstance(res, vhq.TaskOutput) # the latest output from the workflow
+assert isinstance(tg, vhq.TaskGraph) # contains task nodes and edges that connect the nodes with dep-met conditions
+```
+
+
+### Executing a single task
+
+You can simply build and execute a task using `Task` class.
 
 ```python
 import versionhq as vhq
@@ -293,34 +306,20 @@ task = vhq.Task(
    callback_kwargs=dict(message="Hi! Here is the result: ")
 )
 
-res = task.execute(context="context to consider")
-
+res = task.execute(context="testing a task function")
 assert isinstance(res, vhq.TaskOutput)
 ```
 
-This will return a `TaskOutput` object that stores response in plane text, JSON, and Pydantic model: `CustomOutput` formats with a callback result, tool output (if given), and evaluation results (if given).
 
-```python
-res == vhq.TaskOutput(
-   task_id=UUID('<TASK UUID>'),
-   raw='{\"test1\":\"random str\", \"test2\":[\"str item 1\", \"str item 2\", \"str item 3\"]}',
-   json_dict={'test1': 'random str', 'test2': ['str item 1', 'str item 2', 'str item 3']},
-   pydantic=<class '__main__.CustomOutput'>,
-   tool_output=None,
-   callback_output='Hi! Here is the result: random str, str item 1, str item 2, str item 3', # returned a plain text summary
-   evaluation=None
-)
-```
-
-### Supervising
+### Supervising agents
 
 To create an agent network with one or more manager agents, designate members using the `is_manager` tag.
 
 ```python
 import versionhq as vhq
 
-agent_a = vhq.Agent(role="agent a", llm="llm-of-your-choice")
-agent_b = vhq.Agent(role="agent b", llm="llm-of-your-choice")
+agent_a = vhq.Agent(role="Member", llm="gpt-4o")
+agent_b = vhq.Agent(role="Leader", llm="gemini-2.0")
 
 task_1 = vhq.Task(
    description="Analyze the client's business model.",
@@ -342,11 +341,9 @@ network =vhq.AgentNetwork(
 )
 res, tg = network.launch()
 
-assert isinstance(res, vhq.TaskOutput)
-assert agent_b.key in task_1.processed_agents
-assert agent_b.key in task_2.processed_agents
-
-assert isinstance(tg, vhq.TaskGraph)
+assert isinstance(res, vhq.NetworkOutput)
+assert not [item for item in task_1.processed_agents if "vhq-Delegated-Agent" == item]
+assert [item for item in task_1.processed_agents if "agent b" == item]
 ```
 
 This will return a list with dictionaries with keys defined in the `ResponseField` of each task.
@@ -510,7 +507,7 @@ Create `.env` file in the project root and add secret vars following `.env.sampl
 
    * Test functions within the files must begin with `test_`.
 
-   * Pytest priorities are `1. playground demo > 2. docs use cases > 3. other features`
+   * Pytest priorities are `1. playground > 2. docs use cases > 3. other features`
 
 
 4. Update `docs` accordingly.
@@ -598,4 +595,4 @@ Common issues and solutions:
 ## Frequently Asked Questions (FAQ)
 **Q. Where can I see if the agent is working?**
 
-A. Visit [playground](https://versi0n.io/playground).
+A. Visit [playground](https://versi0n.io).

{versionhq-1.2.2.6.dist-info → versionhq-1.2.2.8.dist-info}/RECORD

@@ -1,4 +1,4 @@
-versionhq/__init__.py,sha256=LPGLlfGPZ6saKcuLrozmgUNP89Po4H5uML4Iw62OjkE,2980
+versionhq/__init__.py,sha256=0feG_kS9Ofzgiw_dNfLuCVjdcLJNdkt0JHVrUcEbgG8,2980
 versionhq/_utils/__init__.py,sha256=d-vYVcORZKG-kkLe_fzE8VbViDpAk9DDOKe2fVK25ew,178
 versionhq/_utils/i18n.py,sha256=TwA_PnYfDLA6VqlUDPuybdV9lgi3Frh_ASsb_X8jJo8,1483
 versionhq/_utils/llm_as_a_judge.py,sha256=RM0oYfoeanuUyUL3Ewl6_8Xn1F5Axd285UMH46kxG1I,2378
@@ -32,8 +32,8 @@ versionhq/knowledge/source.py,sha256=-hEUPtJUHHMx4rUKtiHl19J8xAMw-WVBw34zwa2jZ08
 versionhq/knowledge/source_docling.py,sha256=dcu1ITqPXwWZ_lK-6tykEKhhC82eNRTMoWRpxK9Kzls,5441
 versionhq/knowledge/storage.py,sha256=Kd-4r6aWM5EDaoXrzKXbgi1hY6tysSQARPGXM95qMmU,8266
 versionhq/llm/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-versionhq/llm/llm_vars.py,sha256=nqnSyuPgIwXnL4JVgC0DFkAe-mV2n3eUd7mtFkfGfds,5426
-versionhq/llm/model.py,sha256=PZm4gvQNJTW_ZwJE4MEF9JC05zbxS8RfSFQ8pFcNW-A,17146
+versionhq/llm/llm_vars.py,sha256=87IAPfWpyONf4QZoLNcdV3iL-ZFth5Xverl0eQti8i4,5613
+versionhq/llm/model.py,sha256=_P5Hm_hkncy9LvRySAqWhtOQXaFTEY-px97vjOc3Baw,17019
 versionhq/memory/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 versionhq/memory/contextual_memory.py,sha256=QEMVvHuEXxY7M6-12S8HhyFKf108KfX8Zzt7paPW048,3882
 versionhq/memory/model.py,sha256=VQR1229t7GQPMItlGAHLtJrb6LrZfSoRA1DRW4z0SOU,8234
@@ -62,8 +62,8 @@ versionhq/tool/decorator.py,sha256=C4ZM7Xi2gwtEMaSeRo-geo_g_MAkY77WkSLkAuY0AyI,1
 versionhq/tool/model.py,sha256=Nc2f9frTK5tH4kh6EeEAk1Fi1w19kEXLOcsBwHCS1a4,12189
 versionhq/tool/rag_tool.py,sha256=qm_nDWs-WyDvrxZeZAL2AkswfUWGPZS4zybz0o6wOFI,3653
 versionhq/tool/tool_handler.py,sha256=2m41K8qo5bGCCbwMFferEjT-XZ-mE9F0mDUOBkgivOI,1416
-versionhq-1.2.2.6.dist-info/LICENSE,sha256=cRoGGdM73IiDs6nDWKqPlgSv7aR4n-qBXYnJlCMHCeE,1082
-versionhq-1.2.2.6.dist-info/METADATA,sha256=OwLIKXnR7HIZiJc1ZeuK9zu_65eXSMgObNOzuAg0o4c,22097
-versionhq-1.2.2.6.dist-info/WHEEL,sha256=jB7zZ3N9hIM9adW7qlTAyycLYW9npaWKLRzaoVcLKcM,91
-versionhq-1.2.2.6.dist-info/top_level.txt,sha256=DClQwxDWqIUGeRJkA8vBlgeNsYZs4_nJWMonzFt5Wj0,10
-versionhq-1.2.2.6.dist-info/RECORD,,
+versionhq-1.2.2.8.dist-info/LICENSE,sha256=cRoGGdM73IiDs6nDWKqPlgSv7aR4n-qBXYnJlCMHCeE,1082
+versionhq-1.2.2.8.dist-info/METADATA,sha256=J_bqJJyNxyPtePhrFah9mArdCHUT1HCfbKhWEBOxi00,21647
+versionhq-1.2.2.8.dist-info/WHEEL,sha256=jB7zZ3N9hIM9adW7qlTAyycLYW9npaWKLRzaoVcLKcM,91
+versionhq-1.2.2.8.dist-info/top_level.txt,sha256=DClQwxDWqIUGeRJkA8vBlgeNsYZs4_nJWMonzFt5Wj0,10
+versionhq-1.2.2.8.dist-info/RECORD,,