versionhq 1.2.2.4__tar.gz → 1.2.2.5__tar.gz

{versionhq-1.2.2.4 → versionhq-1.2.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: versionhq
-Version: 1.2.2.4
+Version: 1.2.2.5
 Summary: An agentic orchestration framework for building agent networks that handle task automation.
 Author-email: Kuriko Iwai <kuriko@versi0n.io>
 License: MIT License
@@ -227,10 +227,7 @@ The following code snippet demonstrates agent customization:
 ```python
 import versionhq as vhq
 
-agent = vhq.Agent(
-   role="Marketing Analyst",
-   goal="my amazing goal"
-) # assuming this agent was created during the network formation
+agent = vhq.Agent(role="Marketing Analyst")
 
 # update the agent
 agent.update(
@@ -321,8 +318,8 @@ To create an agent network with one or more manager agents, designate members us
 ```python
 import versionhq as vhq
 
-agent_a = vhq.Agent(role="agent a", goal="My amazing goals", llm="llm-of-your-choice")
-agent_b = vhq.Agent(role="agent b", goal="My amazing goals", llm="llm-of-your-choice")
+agent_a = vhq.Agent(role="agent a", llm="llm-of-your-choice")
+agent_b = vhq.Agent(role="agent b", llm="llm-of-your-choice")
 
 task_1 = vhq.Task(
    description="Analyze the client's business model.",

{versionhq-1.2.2.4 → versionhq-1.2.2.5}/README.md

@@ -141,10 +141,7 @@ The following code snippet demonstrates agent customization:
 ```python
 import versionhq as vhq
 
-agent = vhq.Agent(
-   role="Marketing Analyst",
-   goal="my amazing goal"
-) # assuming this agent was created during the network formation
+agent = vhq.Agent(role="Marketing Analyst")
 
 # update the agent
 agent.update(
@@ -235,8 +232,8 @@ To create an agent network with one or more manager agents, designate members us
 ```python
 import versionhq as vhq
 
-agent_a = vhq.Agent(role="agent a", goal="My amazing goals", llm="llm-of-your-choice")
-agent_b = vhq.Agent(role="agent b", goal="My amazing goals", llm="llm-of-your-choice")
+agent_a = vhq.Agent(role="agent a", llm="llm-of-your-choice")
+agent_b = vhq.Agent(role="agent b", llm="llm-of-your-choice")
 
 task_1 = vhq.Task(
    description="Analyze the client's business model.",

{versionhq-1.2.2.4 → versionhq-1.2.2.5}/docs/core/agent/index.md

@@ -7,7 +7,7 @@ tags:
 
 <class>`class` versionhq.agent.model.<bold>Agent<bold></class>
 
-A Pydantic class to store `Agent` objects and handle `Task` execution as well as `LLM` configuration.
+A Pydantic class to store an `Agent` object that handles `Task` execution.
 
 
 ## Quick Start

{versionhq-1.2.2.4 → versionhq-1.2.2.5}/docs/index.md

@@ -113,10 +113,7 @@ The following code snippet demonstrates agent customization:
 ```python
 import versionhq as vhq
 
-agent = vhq.Agent(
-   role="Marketing Analyst",
-   goal="my amazing goal"
-) # assuming this agent was created during the network formation
+agent = vhq.Agent(role="Marketing Analyst")
 
 # update the agent
 agent.update(

{versionhq-1.2.2.4 → versionhq-1.2.2.5}/docs/quickstart.md

@@ -48,7 +48,7 @@ def dummy_func(message: str, test1: str, test2: list[str]) -> str:
    return f"""{message}: {test1}, {", ".join(test2)}"""
 
 
-agent = vhq.Agent(role="demo", goal="amazing project goal")
+agent = vhq.Agent(role="demo manager")
 
 task = vhq.Task(
    description="Amazing task",

{versionhq-1.2.2.4 → versionhq-1.2.2.5}/pyproject.toml

@@ -15,7 +15,7 @@ exclude = ["test*", "__pycache__", "*.egg-info"]
 
 [project]
 name = "versionhq"
-version = "1.2.2.4"
+version = "1.2.2.5"
 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.2.4 → versionhq-1.2.2.5}/src/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.4"
+__version__ = "1.2.2.5"
 __all__ = [
     "Agent",
 

{versionhq-1.2.2.4 → versionhq-1.2.2.5}/src/versionhq/agent/inhouse_agents.py

@@ -38,7 +38,7 @@ vhq_formation_planner = Agent(
         "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. ",
+        "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.2.2.4 → versionhq-1.2.2.5}/src/versionhq/agent/model.py

@@ -35,8 +35,8 @@ class Agent(BaseModel):
     config: Optional[Dict[str, Any]] = Field(default=None, exclude=True, description="values to add to the Agent class")
 
     id: UUID4 = Field(default_factory=uuid.uuid4, frozen=True)
-    role: str = Field(description="role of the agent - used in summary and logs")
-    goal: str = Field(description="concise goal of the agent (details are set in the Task instance)")
+    role: str = Field(description="required. agent's role")
+    goal: Optional[str] = Field(default=None)
     backstory: Optional[str] = Field(default=None, description="developer prompt to the llm")
     skillsets: Optional[List[str]] = Field(default_factory=list)
     tools: Optional[List[Any]] = Field(default_factory=list)
@@ -92,7 +92,7 @@ class Agent(BaseModel):
 
     @model_validator(mode="after")
     def validate_required_fields(self) -> Self:
-        required_fields = ["role", "goal"]
+        required_fields = ["role",]
         for field in required_fields:
             if getattr(self, field) is None:
                 raise ValueError(f"{field} must be provided either directly or through config")
@@ -172,7 +172,7 @@ class Agent(BaseModel):
             skills = ", ".join([item for item in self.skillsets]) if self.skillsets else ""
             tools = ", ".join([item.name for item in self.tools if hasattr(item, "name") and item.name is not None]) if self.tools else ""
             role = self.role.lower()
-            goal = self.goal.lower()
+            goal = self.goal.lower() if self.goal else ""
 
             if self.tools or self.skillsets:
                 backstory = BACKSTORY_FULL.format(role=role, goal=goal, skills=skills, tools=tools)
@@ -494,7 +494,7 @@ class Agent(BaseModel):
         Defines and executes a task when it is not given and returns TaskOutput object.
         """
 
-        if not self.goal or not self.role:
+        if not self.role or not self.goal:
             return None
 
         from versionhq.task.model import Task
@@ -595,7 +595,7 @@ class Agent(BaseModel):
 
 
     def __repr__(self):
-        return f"Agent(role={self.role}, goal={self.goal}"
+        return f"Agent(role={self.role}, id={str(self.id)}"
 
     def __str__(self):
         return super().__str__()

{versionhq-1.2.2.4 → versionhq-1.2.2.5}/src/versionhq.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: versionhq
-Version: 1.2.2.4
+Version: 1.2.2.5
 Summary: An agentic orchestration framework for building agent networks that handle task automation.
 Author-email: Kuriko Iwai <kuriko@versi0n.io>
 License: MIT License
@@ -227,10 +227,7 @@ The following code snippet demonstrates agent customization:
 ```python
 import versionhq as vhq
 
-agent = vhq.Agent(
-   role="Marketing Analyst",
-   goal="my amazing goal"
-) # assuming this agent was created during the network formation
+agent = vhq.Agent(role="Marketing Analyst")
 
 # update the agent
 agent.update(
@@ -321,8 +318,8 @@ To create an agent network with one or more manager agents, designate members us
 ```python
 import versionhq as vhq
 
-agent_a = vhq.Agent(role="agent a", goal="My amazing goals", llm="llm-of-your-choice")
-agent_b = vhq.Agent(role="agent b", goal="My amazing goals", llm="llm-of-your-choice")
+agent_a = vhq.Agent(role="agent a", llm="llm-of-your-choice")
+agent_b = vhq.Agent(role="agent b", llm="llm-of-your-choice")
 
 task_1 = vhq.Task(
    description="Analyze the client's business model.",

{versionhq-1.2.2.4 → versionhq-1.2.2.5}/tests/agent/agent_test.py

@@ -13,13 +13,10 @@ LITELLM_API_KEY = os.environ.get("LITELLM_API_KEY")
 
 
 def test_build_agent_with_minimal_input():
-    agent = Agent(
-        role="analyst",
-        goal="analyze the company's website and retrieve the product overview"
-    )
+    agent = Agent(role="analyst")
 
     assert agent.role == "analyst"
-    assert agent.backstory == BACKSTORY_SHORT.format(role=agent.role.lower(), goal=agent.goal.lower())
+    assert agent.backstory == BACKSTORY_SHORT.format(role=agent.role.lower(), goal="")
     assert isinstance(agent.llm, LLM)
     assert agent.llm.model == DEFAULT_MODEL_NAME
     assert agent.llm.api_key == LITELLM_API_KEY

{versionhq-1.2.2.4 → versionhq-1.2.2.5}/tests/doc_test.py

@@ -25,7 +25,7 @@ def test_doc_index_b():
         return f"""{message}: {test1}, {", ".join(test2)}"""
 
 
-    agent = vhq.Agent(role="demo", goal="amazing project goal", maxit=1)
+    agent = vhq.Agent(role="demo", maxit=1)
 
     task = vhq.Task(
         description="Amazing task",
@@ -42,8 +42,8 @@ def test_doc_index_b():
 def test_doc_index_c():
     import versionhq as vhq
 
-    agent_a = vhq.Agent(role="agent a", goal="My amazing goals", llm="llm-of-your-choice")
-    agent_b = vhq.Agent(role="agent b", goal="My amazing goals", llm="llm-of-your-choice")
+    agent_a = vhq.Agent(role="agent a", llm="llm-of-your-choice")
+    agent_b = vhq.Agent(role="agent b", llm="llm-of-your-choice")
 
     task_1 = vhq.Task(
         description="Analyze the client's business model.",

{versionhq-1.2.2.4 → versionhq-1.2.2.5}/tests/usecase_test.py

@@ -31,10 +31,7 @@ def test_demo_agent_customization():
     import pathlib
     current_path = pathlib.Path(__file__).parent.resolve()
 
-    agent = vhq.Agent(
-        role='Demo Manager',
-        goal='run a demo successfully'
-    )
+    agent = vhq.Agent(role='Demo Manager')
 
     agent.update(
         llm='gemini-2.0',

{versionhq-1.2.2.4 → versionhq-1.2.2.5}/uv.lock

@@ -1509,19 +1509,20 @@ wheels = [
 
 [[package]]
 name = "langsmith"
-version = "0.3.10"
+version = "0.3.11"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "httpx" },
     { name = "orjson", marker = "platform_python_implementation != 'PyPy'" },
+    { name = "packaging" },
     { name = "pydantic" },
     { name = "requests" },
     { name = "requests-toolbelt" },
     { name = "zstandard" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/28/08/9d3591a7dfe543afda0451b456c54e0408cd709efbda4b26c7ffff6f5d70/langsmith-0.3.10.tar.gz", hash = "sha256:7c05512d19a7741b348879149f4b7ef6aa4495abd12ad2e9418243664559b521", size = 321698 }
+sdist = { url = "https://files.pythonhosted.org/packages/ea/34/c4c0eddad03e00457cd6be1a88c288cd4419da8d368d8f519a29abe5392c/langsmith-0.3.11.tar.gz", hash = "sha256:ddf29d24352e99de79c9618aaf95679214324e146c5d3d9475a7ddd2870018b1", size = 323815 }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/27/2c/8e48e5c264022b03555fa3c5367c58f424d50f6a562a7efb20a178e1d9e9/langsmith-0.3.10-py3-none-any.whl", hash = "sha256:2f1f9e27c4fc6dd605557c3cdb94465f4f33464ab195c69ce599b6ee44d18275", size = 333021 },
+    { url = "https://files.pythonhosted.org/packages/ff/68/514ffa62860202a5a0a3acbf5c05017ef9df38d4437d2cb44a3cf93d617b/langsmith-0.3.11-py3-none-any.whl", hash = "sha256:0cca22737ef07d3b038a437c141deda37e00add56022582680188b681bec095e", size = 335265 },
 ]
 
 [[package]]
@@ -1547,7 +1548,7 @@ wheels = [
 
 [[package]]
 name = "litellm"
-version = "1.61.15"
+version = "1.61.16"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "aiohttp" },
@@ -1563,9 +1564,9 @@ dependencies = [
     { name = "tokenizers", version = "0.19.1", source = { registry = "https://pypi.org/simple" }, marker = "platform_machine == 'x86_64' and sys_platform == 'darwin'" },
     { name = "tokenizers", version = "0.21.0", source = { registry = "https://pypi.org/simple" }, marker = "platform_machine != 'x86_64' or sys_platform != 'darwin'" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/23/3a/3e299244bb048bbe63e6342a34b5974ab551b24ca0cbafdd5aaf81c0c81d/litellm-1.61.15.tar.gz", hash = "sha256:f10ff155d8bca6cb0e2a1cc8d9aedbe6b390f73b30b9603e9cadb66b11472d44", size = 6561672 }
+sdist = { url = "https://files.pythonhosted.org/packages/3d/a5/0750edce9f4cbdce7f0d852b8e175cec4760d1c687c0079f7fe1b91c7d7f/litellm-1.61.16.tar.gz", hash = "sha256:02df5865f98ea9734a4d27ac7c33aad9a45c4015403d5c0797d3292ade3c5cb5", size = 6562533 }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/ac/b8/2908528ce280a1554162bffaec47514c71a01d76867e0b3fefd096c9cd00/litellm-1.61.15-py3-none-any.whl", hash = "sha256:977fd4e37491dd5adf14ed7c4d55bd099dd5ee7d40b8b8af5eba515d448013bb", size = 6871062 },
+    { url = "https://files.pythonhosted.org/packages/56/49/6af8c25e4e57426d322ee94e312a822162bb8122d24adcbcb913916225e2/litellm-1.61.16-py3-none-any.whl", hash = "sha256:d241436ac0edf64ec57fb5686f8d84a25998a7e52213d9063adf87df8432701f", size = 6871951 },
 ]
 
 [[package]]
@@ -4024,7 +4025,7 @@ wheels = [
 
 [[package]]
 name = "versionhq"
-version = "1.2.2.4"
+version = "1.2.2.5"
 source = { editable = "." }
 dependencies = [
     { name = "appdirs" },