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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: xpander-sdk
-Version: 2.0.219
+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.219 → 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.219",
+    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.219 → xpander_sdk-2.0.220}/src/xpander_sdk/models/orchestrations.py

@@ -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.
 
@@ -186,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.
     """
@@ -201,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.219 → 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.219 → 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.219 → 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.219 → 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.219 → 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.219
+Version: 2.0.220
 Summary: xpander.ai Backend-as-a-service for AI Agents - SDK
 Home-page: https://www.xpander.ai
 Author: xpanderAI