versionhq 1.2.1.12__tar.gz → 1.2.1.13__tar.gz

{versionhq-1.2.1.12 → versionhq-1.2.1.13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: versionhq
-Version: 1.2.1.12
+Version: 1.2.1.13
 Summary: An agentic orchestration framework for building agent networks that handle task automation.
 Author-email: Kuriko Iwai <kuriko@versi0n.io>
 License: MIT License

{versionhq-1.2.1.12 → versionhq-1.2.1.13}/docs/core/agent/index.md

@@ -25,6 +25,16 @@ agent = vhq.Agent(
 )
 ```
 
+To start the agent and receive a `TaskOutput` object based on its goal, call the `.start()` method.
+
+```python
+# ...Inherited from the previous code
+
+res = agent.start(context="Planning a new campaign promotion starting this summer")
+
+assert isinstance(res, vhq.TaskOutput)
+```
+
 <hr />
 
 ## Customizing

{versionhq-1.2.1.12 → versionhq-1.2.1.13}/pyproject.toml

@@ -15,7 +15,7 @@ exclude = ["test*", "__pycache__", "*.egg-info"]
 
 [project]
 name = "versionhq"
-version = "1.2.1.12"
+version = "1.2.1.13"
 authors = [{ name = "Kuriko Iwai", email = "kuriko@versi0n.io" }]
 description = "An agentic orchestration framework for building agent networks that handle task automation."
 readme = "README.md"

{versionhq-1.2.1.12 → versionhq-1.2.1.13}/src/versionhq/__init__.py

@@ -30,8 +30,10 @@ from versionhq.memory.model import ShortTermMemory,LongTermMemory, UserMemory, M
 from versionhq.task.formation import form_agent_network
 from versionhq.task_graph.draft import workflow
 
+# from versionhq._utils.logger import Logger
 
-__version__ = "1.2.1.12"
+
+__version__ = "1.2.1.13"
 __all__ = [
     "Agent",
 
@@ -91,4 +93,6 @@ __all__ = [
 
     "form_agent_network",
     "workflow",
+
+    # "Logger",
 ]

{versionhq-1.2.1.12 → versionhq-1.2.1.13}/src/versionhq/agent/model.py

@@ -3,7 +3,6 @@ import uuid
 from typing import Any, Dict, List, Optional, TypeVar, Callable, Type
 from typing_extensions import Self
 from dotenv import load_dotenv
-import litellm
 
 from pydantic import UUID4, BaseModel, Field, InstanceOf, PrivateAttr, model_validator, field_validator
 from pydantic_core import PydanticCustomError
@@ -57,9 +56,7 @@ class TokenProcess:
 # @track_agent()
 class Agent(BaseModel):
     """
-    A class to store agent information.
-    Agents must have `role`, `goal`, and `llm` = DEFAULT_MODEL_NAME as default.
-    Then run validation on `backstory`, `llm`, `tools`, `rpm` (request per min), `knowledge`, and `memory`.
+    A Pydantic class to store an agent object. Agents must have `role` and `goal` to start.
     """
 
     __hash__ = object.__hash__
@@ -453,7 +450,6 @@ class Agent(BaseModel):
         return self
 
 
-
     def invoke(
         self,
         prompts: str,
@@ -515,8 +511,6 @@ class Agent(BaseModel):
                 raise ValueError("Invalid response from LLM call - None or empty.")
 
 
-
-
     def execute_task(self, task, context: Optional[Any] = None, task_tools: Optional[List[Tool | ToolSet]] = list()) -> str:
         """
         Format a task prompt, adding context from knowledge and memory (if given), and invoke LLM.
@@ -582,5 +576,27 @@ class Agent(BaseModel):
         return raw_response
 
 
+    def start(self, context: Any = None) -> Any | None:
+        """
+        Defines and executes a task when it is not given and returns TaskOutput object.
+        """
+
+        if not self.goal or not self.role:
+            return None
+
+        from versionhq.task.model import Task, ResponseField
+
+        class Output(BaseModel):
+            steps: list[str]
+            conclution: str
+
+        task = Task(
+            description=f"List up first 3 steps that need to achieve {self.goal} in concise manner, then lead the conclusion in a sentence.",
+            pydantic_output=Output
+        )
+        res = task.execute(agent=self, context=context)
+        return res
+
+
     def __repr__(self):
         return f"Agent(role={self.role}, goal={self.goal}"

{versionhq-1.2.1.12 → versionhq-1.2.1.13}/src/versionhq/task/model.py

@@ -363,7 +363,7 @@ Response format: {response_format}
 Ref. Output image: {output_formats_to_follow}
 """
         else:
-            output_prompt = "Return your response as a valid JSON serializable string, enclosed in double quotes. Do not use single quotes, trailing commas, or other non-standard JSON syntax."
+            output_prompt = "You MUST Return your response as a valid JSON serializable string, enclosed in double quotes. Do not use single quotes, trailing commas, or other non-standard JSON syntax."
 
         return dedent(output_prompt)
 

{versionhq-1.2.1.12 → versionhq-1.2.1.13}/src/versionhq/task_graph/draft.py

@@ -1,6 +1,6 @@
 import sys
 from typing import Type, Any
-from pydantic import BaseModel, create_model
+from pydantic import BaseModel
 from pydantic._internal._model_construction import ModelMetaclass
 from textwrap import dedent
 if 'pydantic.main' not in sys.modules:
@@ -10,11 +10,11 @@ sys.modules['pydantic.main'].ModelMetaclass = ModelMetaclass
 
 from versionhq.agent.model import Agent
 from versionhq.task.model import ResponseField
-from versionhq.task_graph.model import TaskGraph, Task, DependencyType, Node, TaskStatus
+from versionhq.task_graph.model import TaskGraph, Task, DependencyType, Node
 from versionhq._utils.logger import Logger
 
 
-def workflow(final_output: Type[BaseModel], context: Any = None, human: bool = True) -> TaskGraph | None:
+def workflow(final_output: Type[BaseModel], context: Any = None, human: bool = False) -> TaskGraph | None:
     """
     Generate a TaskGraph object to generate the givne final_output most resource-efficiently.
     """
@@ -52,13 +52,12 @@ def workflow(final_output: Type[BaseModel], context: Any = None, human: bool = T
         description=dedent(f"Design a resource-efficient workflow to achieve the following goal: {final_output_prompt}. The workflow should consist of a list of detailed tasks that represent decision making points, each with the following information:\nname: A concise name of the task\ndescription: A concise description of the task.\nconnections: A list of target tasks that this task connects to.\ndependency_types: The type of dependency between this task and each of its connected task. \noutput: key output from the task in a word.\n\nUse the following dependency types: {dep_type_prompt}.\n\nPrioritize minimizing resource consumption (computation, memory, and data transfer) when defining tasks, connections, and dependencies.  Consider how data is passed between tasks and aim to reduce unnecessary data duplication or transfer. Explain any design choices made to optimize resource usage."),
         response_fields=[
             ResponseField(title="tasks", data_type=list, items=dict, properties=[
-                    ResponseField(title="name", data_type=str),
-                    ResponseField(title="description", data_type=str),
-                    ResponseField(title="output", data_type=str),
-                    ResponseField(title="connections", data_type=list, items=str),
-                    ResponseField(title="dependency_types", data_type=list, items=str),
-                ]
-            )
+                ResponseField(title="name", data_type=str),
+                ResponseField(title="description", data_type=str),
+                ResponseField(title="output", data_type=str),
+                ResponseField(title="connections", data_type=list, items=str),
+                ResponseField(title="dependency_types", data_type=list, items=str),
+            ])
         ]
     )
     res = task.execute(agent=graph_expert, context=[context_prompt, context])

{versionhq-1.2.1.12 → versionhq-1.2.1.13}/src/versionhq.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: versionhq
-Version: 1.2.1.12
+Version: 1.2.1.13
 Summary: An agentic orchestration framework for building agent networks that handle task automation.
 Author-email: Kuriko Iwai <kuriko@versi0n.io>
 License: MIT License

{versionhq-1.2.1.12 → versionhq-1.2.1.13}/tests/agent/doc_test.py

@@ -1,14 +1,16 @@
 """Test use cases in docs/core/agents.md"""
 
 def test_docs_core_agent_a():
-    from versionhq import Agent
-    agent = Agent(
+    import versionhq as vhq
+    agent = vhq.Agent(
         role="Marketing Analyst",
-        goal="Coping with price competition in saturated markets"
+        goal="Coping with price competition in saturated markets",
     )
 
     assert agent.id and agent.role == "Marketing Analyst" and agent.goal == "Coping with price competition in saturated markets" and agent.backstory is not None
 
+    res = agent.start(context="Planning a new campaign promotion starting this summer")
+    assert isinstance(res, vhq.TaskOutput)
 
 def test_docs_core_agent_b1():
     from versionhq import Agent

{versionhq-1.2.1.12 → versionhq-1.2.1.13}/uv.lock

@@ -3980,7 +3980,7 @@ wheels = [
 
 [[package]]
 name = "versionhq"
-version = "1.2.1.10"
+version = "1.2.1.13"
 source = { editable = "." }
 dependencies = [
     { name = "appdirs" },