xpander-sdk 2.0.217__py3-none-any.whl → 2.0.219__py3-none-any.whl

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
@@ -52,11 +52,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 +88,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.
@@ -223,19 +244,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.217.dist-info → xpander_sdk-2.0.219.dist-info}/METADATA

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

{xpander_sdk-2.0.217.dist-info → xpander_sdk-2.0.219.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=uqKXATnBYCah6KJD20IV6_6-Etlke9RSrbRUfEm2M0U,13087
+xpander_sdk/models/orchestrations.py,sha256=WcYBfQacrXYKkj0e_D8a1crV8gz2bDgto6IuC6lPlyE,14651
 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.217.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-xpander_sdk-2.0.217.dist-info/METADATA,sha256=kseDOPzpZzUIgqe-KAc9rCHT72L8wrb0QdXC-K9DuD8,17952
-xpander_sdk-2.0.217.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-xpander_sdk-2.0.217.dist-info/top_level.txt,sha256=UCjnxQpsMy5Zoe7lmRuVDO6DI2V_6PgRFfm4oizRbVs,12
-xpander_sdk-2.0.217.dist-info/RECORD,,
+xpander_sdk-2.0.219.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+xpander_sdk-2.0.219.dist-info/METADATA,sha256=1gDUCBW8-Ud35DixRLJFfczu9oTtldT_aiHrqkfO7O8,17952
+xpander_sdk-2.0.219.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+xpander_sdk-2.0.219.dist-info/top_level.txt,sha256=UCjnxQpsMy5Zoe7lmRuVDO6DI2V_6PgRFfm4oizRbVs,12
+xpander_sdk-2.0.219.dist-info/RECORD,,