xpander-sdk 2.0.216__py3-none-any.whl → 2.0.218__py3-none-any.whl

xpander_sdk/models/orchestrations.py

@@ -143,6 +143,19 @@ class OrchestrationClassifierNodeLLMSettings(XPanderSharedModel):
     llm_api_base: Optional[str] = None
     llm_extra_headers: Optional[Dict[str,str]] = {}
 
+class SchemaOverride(XPanderSharedModel):
+    """Schema override for workflow action nodes.
+    
+    Allows setting permanent (fixed) values for tool input properties.
+    Fields with permanentValue will be removed from the schema sent to the LLM
+    and the permanent values will be applied to the payload before execution.
+    
+    Attributes:
+        input: Input schema with permanentValue fields to override LLM-generated values.
+    """
+    input: Optional[Dict] = None
+
+
 class OrchestrationPointerNode(XPanderSharedModel):
     """Node that references an external asset (agent, function, or orchestration).
 
@@ -153,6 +166,7 @@ class OrchestrationPointerNode(XPanderSharedModel):
         output_schema: JSON schema for structured output validation.
         instructions: Optional instructions for the pointer node (Action only).
         ignore_response: Should ignore the node result and proceed with previous result?.
+        schema_override: Optional schema override with permanentValue fields for fixed values.
     """
 
     asset_id: str
@@ -167,6 +181,7 @@ class OrchestrationPointerNode(XPanderSharedModel):
     output_schema: Optional[Dict] = None
     instructions: Optional[str] = None
     ignore_response: Optional[bool] = False
+    schema_override: Optional[SchemaOverride] = None
 
 class ClassificationGroup(XPanderSharedModel):
     """A classification group with evaluation criteria and data extraction settings.
@@ -208,19 +223,25 @@ class OrchestrationClassifierNode(XPanderSharedModel):
 class OrchestrationGuardrailNode(XPanderSharedModel):
     """Node that uses LLM to evaluate input and enforce guardrails.
 
-    This node can stop execution if the guardrail check fails.
+    This node uses group-based classification similar to the Classifier node.
+    It requires exactly 2 groups with IDs "pass" and "fail":
+    - "pass" group: Criteria for when input should pass the guardrail
+    - "fail" group: Criteria for when input should fail the guardrail
+
+    Routing behavior:
+    - If "pass" matches: Routes to downstream nodes connected via "pass" condition
+    - If "fail" matches: Routes to downstream nodes connected via "fail" condition,
+      or falls back to end nodes (end-summarizer/end-classifier) if no fail route exists
 
     Attributes:
-        instructions: Evaluation instructions for the LLM to assess the input.
+        groups: List of 2 ClassificationGroup objects with IDs "pass" and "fail".
         examples: Example inputs/outputs to guide the LLM behavior.
         settings: LLM configuration settings.
-        stop_on_false: Whether to stop execution if the guardrail check fails. Defaults to True.
     """
 
-    instructions: str
+    groups: List[ClassificationGroup]
     examples: Optional[List[str]] = []
     settings: OrchestrationClassifierNodeLLMSettings
-    stop_on_false: Optional[bool] = True
 
 class OrchestrationSummarizerNode(XPanderSharedModel):
     """Node that processes large payloads and answers specific questions.

{xpander_sdk-2.0.216.dist-info → xpander_sdk-2.0.218.dist-info}/METADATA

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

{xpander_sdk-2.0.216.dist-info → xpander_sdk-2.0.218.dist-info}/RECORD

@@ -16,7 +16,7 @@ xpander_sdk/models/events.py,sha256=HnootQSUIIRM4BIdaTbuPUEJ55hLVtA7KDCSsnHeBKw,
 xpander_sdk/models/frameworks.py,sha256=-7W_m5cvgS1qLp0gGAFP4noNWT82IT1ZqtQv5WuOC2k,2939
 xpander_sdk/models/generic.py,sha256=yw5rBRdZ-6ucTI4AwtskenddepOooiFRM--9xx5jrL8,681
 xpander_sdk/models/notifications.py,sha256=ryc0VDXoiuZDEh791LYzW73GC0qH1y2hYl8Fj5Xv0FU,4141
-xpander_sdk/models/orchestrations.py,sha256=WkYKtrnbXJjGR0bLx9rWG4T2tYE5lJgjEAYmCrI5vmc,12461
+xpander_sdk/models/orchestrations.py,sha256=hoL2YBMcMXZ6kXMLiJtpC-g4Ibv9RLovtdFHpVvm-gA,13463
 xpander_sdk/models/shared.py,sha256=gW88kA_UslNinUjtQKpLVF0sHDZnckwLWexRapxPivU,3125
 xpander_sdk/models/user.py,sha256=_FTG0JO6iTrbcvJp-BBJ6nuj281zhyQB5ldQkBCyYDU,749
 xpander_sdk/modules/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -90,8 +90,8 @@ xpander_sdk/utils/generic.py,sha256=XrRj2-L8c0YWpfPdDyXE-pVL-6lKF9VpyZzKHQ4wuCc,
 xpander_sdk/utils/tools.py,sha256=lyFkq2yP7DxBkyXYVlnFRwDhQCvf0fZZMDm5fBycze4,1244
 xpander_sdk/utils/agents/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 xpander_sdk/utils/agents/compactization_agent.py,sha256=S_U1dSmDC7I0JUsp_THUYjfutEI5QMBaMPJEXGp0_Sw,14389
-xpander_sdk-2.0.216.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-xpander_sdk-2.0.216.dist-info/METADATA,sha256=Aj9pWgRY79mINYpJGgi-7o3EktBdo7uyWeNq6vswf-Q,17952
-xpander_sdk-2.0.216.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-xpander_sdk-2.0.216.dist-info/top_level.txt,sha256=UCjnxQpsMy5Zoe7lmRuVDO6DI2V_6PgRFfm4oizRbVs,12
-xpander_sdk-2.0.216.dist-info/RECORD,,
+xpander_sdk-2.0.218.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+xpander_sdk-2.0.218.dist-info/METADATA,sha256=6cp3OHkDp-1UnHS-korSXv2M3ZZyuM4HewIzj7aOunU,17952
+xpander_sdk-2.0.218.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+xpander_sdk-2.0.218.dist-info/top_level.txt,sha256=UCjnxQpsMy5Zoe7lmRuVDO6DI2V_6PgRFfm4oizRbVs,12
+xpander_sdk-2.0.218.dist-info/RECORD,,