xpander-sdk 2.0.218__tar.gz → 2.0.220__tar.gz

{xpander_sdk-2.0.218 → xpander_sdk-2.0.220}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: xpander-sdk
-Version: 2.0.218
+Version: 2.0.220
 Summary: xpander.ai Backend-as-a-service for AI Agents - SDK
 Home-page: https://www.xpander.ai
 Author: xpanderAI

{xpander_sdk-2.0.218 → xpander_sdk-2.0.220}/setup.py

@@ -5,7 +5,7 @@ with open("README.md", "r", encoding="utf-8") as fh:
 
 setup(
     name="xpander-sdk",
-    version="2.0.218",
+    version="2.0.220",
     author="xpanderAI",
     author_email="dev@xpander.ai",
     description="xpander.ai Backend-as-a-service for AI Agents - SDK",

{xpander_sdk-2.0.218 → xpander_sdk-2.0.220}/src/xpander_sdk/models/orchestrations.py

@@ -5,7 +5,7 @@ including various node types, execution strategies, and control flow conditions.
 """
 
 from enum import Enum
-from typing import Dict, List, Literal, Optional, Union
+from typing import Any, Dict, List, Literal, Optional, Union
 from uuid import uuid4
 
 from pydantic import Field
@@ -45,6 +45,17 @@ class OrchestrationNodeType(str, Enum):
     Summarizer = "summarizer"
     SendToEnd = "send_to_end"
 
+class OrchestrationPointerNodeInstructionsMode(str, Enum):
+    """Modes for instruction usage in pointer node.
+
+    Attributes:
+        Replace: Replaces the traget asset instructions.
+        Append: Appends to the traget asset instructions.
+    """
+
+    Replace = "replace"
+    Append = "append"
+
 class OrchestrationConditionType(str, Enum):
     """Types of conditions for orchestration control flow.
 
@@ -52,11 +63,26 @@ class OrchestrationConditionType(str, Enum):
         Regex: Condition based on regular expression matching.
         Contains: Condition based on substring containment.
         Else: Fallback condition that always matches (executed when no other conditions match).
+        Equal: Condition based on equality comparison (path == value).
+        NotEqual: Condition based on inequality comparison (path != value).
+        GreaterThan: Condition based on greater than comparison (path > value).
+        LessThan: Condition based on less than comparison (path < value).
+        GreaterThanOrEqual: Condition based on greater than or equal comparison (path >= value).
+        LessThanOrEqual: Condition based on less than or equal comparison (path <= value).
+        NotEmpty: Condition that checks if a path value is not empty/null.
     """
 
     Regex = "regex"
     Contains = "contains"
     Else = "else"
+    # Classic comparison operators
+    Equal = "equal"
+    NotEqual = "not_equal"
+    GreaterThan = "gt"
+    LessThan = "lt"
+    GreaterThanOrEqual = "gte"
+    LessThanOrEqual = "lte"
+    NotEmpty = "not_empty"
 
 class OrchestrationWaitNodeType(str, Enum):
     """Types of wait nodes in orchestration workflows.
@@ -73,15 +99,21 @@ class OrchestrationCondition(XPanderSharedModel):
     """Condition for controlling orchestration flow.
 
     Attributes:
-        type: Type of condition (regex, contains, or else).
-        term: The pattern or string to match against. Optional for 'else' type.
+        type: Type of condition (regex, contains, else, or comparison operators).
+        term: The pattern or string to match against. Used for 'regex' and 'contains' types.
         group_id: Optional group ID for group-based classifier routing.
                  When set, routing matches by group ID instead of term matching.
+        path: Path to extract value from input data (e.g., "input.client_id" or "client_id").
+              Used for comparison operators (equal, not_equal, gt, lt, gte, lte, not_empty).
+        value: Value to compare against. Used with comparison operators.
+               Not required for 'not_empty' type.
     """
 
     type: OrchestrationConditionType
     term: Optional[str] = None
     group_id: Optional[str] = None
+    path: Optional[str] = None
+    value: Optional[Any] = None
 
 class OrchestrationRetryStrategy(XPanderSharedModel):
     """Strategy for retrying failed orchestration nodes.
@@ -165,6 +197,7 @@ class OrchestrationPointerNode(XPanderSharedModel):
         output_type: Expected output format. Defaults to Text.
         output_schema: JSON schema for structured output validation.
         instructions: Optional instructions for the pointer node (Action only).
+        instructions_mode: Mode to use for pointer node, specifically for agent nodes.
         ignore_response: Should ignore the node result and proceed with previous result?.
         schema_override: Optional schema override with permanentValue fields for fixed values.
     """
@@ -180,6 +213,7 @@ class OrchestrationPointerNode(XPanderSharedModel):
     output_type: Optional[OutputFormat] = OutputFormat.Text
     output_schema: Optional[Dict] = None
     instructions: Optional[str] = None
+    instructions_mode: Optional[OrchestrationPointerNodeInstructionsMode] = OrchestrationPointerNodeInstructionsMode.Append
     ignore_response: Optional[bool] = False
     schema_override: Optional[SchemaOverride] = None
 

{xpander_sdk-2.0.218 → xpander_sdk-2.0.220}/src/xpander_sdk/modules/agents/sub_modules/agent.py

@@ -413,6 +413,7 @@ class Agent(XPanderSharedModel):
         output_schema: Optional[Dict] = None,
         events_streaming: Optional[bool] = False,
         additional_context: Optional[str] = None,
+        additional_instructions: Optional[str] = None,
         expected_output: Optional[str] = None,
         mcp_servers: Optional[List[MCPServerDetails]] = [],
         triggering_agent_id: Optional[str] = None,
@@ -438,6 +439,7 @@ class Agent(XPanderSharedModel):
             output_schema (Optional[Dict]): Schema defining structure of output.
             events_streaming (Optional[bool]): Flag idicating for events are required for this task.
             additional_context (Optional[str]): Additional context to be passed to the agent.
+            additional_instructions (Optional[str]): Additional instructions to be appended to the agent's system prompt.
             expected_output (Optional[str]): Expected output of the execution.
             mcp_servers (Optional[List[MCPServerDetails]]): Optional list of mcp servers to use.
             triggering_agent_id (Optional[str]): Optional triggering agent id.
@@ -473,6 +475,7 @@ class Agent(XPanderSharedModel):
                     "run_locally": run_locally,
                     "events_streaming": events_streaming,
                     "additional_context": additional_context,
+                    "additional_instructions": additional_instructions,
                     "expected_output": expected_output,
                     "mcp_servers": [server.model_dump() for server in mcp_servers],
                     "triggering_agent_id": triggering_agent_id,

{xpander_sdk-2.0.218 → xpander_sdk-2.0.220}/src/xpander_sdk/modules/backend/frameworks/agno.py

@@ -130,7 +130,7 @@ async def build_agent_args(
             "name": xpander_agent.name,
             "model": model,
             "description": xpander_agent.instructions.description,
-            "instructions": xpander_agent.instructions.instructions,
+            "instructions": xpander_agent.instructions.instructions + (f"\n<additional_overriding_instructions>{task.additional_instructions}</additional_overriding_instructions>" if task.additional_instructions else ""),
             "expected_output": (
                 task.expected_output
                 if task and task.expected_output

{xpander_sdk-2.0.218 → xpander_sdk-2.0.220}/src/xpander_sdk/modules/tasks/sub_modules/task.py

@@ -132,6 +132,7 @@ class Task(XPanderSharedModel):
         output_schema (Optional[Dict]): Schema for the task's output.
         events_streaming (Optional[bool]): Flag indicating if the task has events streaming.
         additional_context (Optional[str]): Additional context to be passed to the agent.
+        additional_instructions (Optional[str]): Additional instructions to be appended to the agent's system prompt.
         expected_output (Optional[str]): Expected output of the execution.
         mcp_servers (Optional[List[MCPServerDetails]]): Optional list of mcp servers to use.
         triggering_agent_id (Optional[str]): Optional triggering agent id.
@@ -180,6 +181,7 @@ class Task(XPanderSharedModel):
     events_streaming: Optional[bool] = False
     is_orchestration: Optional[bool] = False
     additional_context: Optional[str] = None
+    additional_instructions: Optional[str] = None
     expected_output: Optional[str] = (None,)
     mcp_servers: Optional[List[MCPServerDetails]] = ([],)
     triggering_agent_id: Optional[str] = (None,)

{xpander_sdk-2.0.218 → xpander_sdk-2.0.220}/src/xpander_sdk/modules/tasks/tasks_module.py

@@ -234,6 +234,7 @@ class Tasks(ModuleBase):
         output_schema: Optional[Dict] = None,
         events_streaming: Optional[bool] = False,
         additional_context: Optional[str] = None,
+        additional_instructions: Optional[str] = None,
         expected_output: Optional[str] = None,
         mcp_servers: Optional[List[MCPServerDetails]] = [],
         triggering_agent_id: Optional[str] = None,
@@ -263,6 +264,7 @@ class Tasks(ModuleBase):
             output_schema (Optional[Dict]): Schema defining the expected output structure.
             events_streaming (Optional[bool]): Flag idicating for events are required for this task.
             additional_context (Optional[str]): Additional context to be passed to the agent.
+            additional_instructions (Optional[str]): Additional instructions to be appended to the agent's system prompt.
             expected_output (Optional[str]): Expected output of the execution.
             mcp_servers (Optional[List[MCPServerDetails]]): Optional list of mcp servers to use.
             triggering_agent_id (Optional[str]): Optional triggering agent id.
@@ -309,6 +311,7 @@ class Tasks(ModuleBase):
                     "run_locally": run_locally,
                     "events_streaming": events_streaming,
                     "additional_context": additional_context,
+                    "additional_instructions": additional_instructions,
                     "expected_output": expected_output,
                     "mcp_servers": [server.model_dump() for server in mcp_servers],
                     "triggering_agent_id": triggering_agent_id,

{xpander_sdk-2.0.218 → xpander_sdk-2.0.220}/src/xpander_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: xpander-sdk
-Version: 2.0.218
+Version: 2.0.220
 Summary: xpander.ai Backend-as-a-service for AI Agents - SDK
 Home-page: https://www.xpander.ai
 Author: xpanderAI