kailash 0.9.3__py3-none-any.whl → 0.9.4__py3-none-any.whl

kailash/__init__.py

@@ -50,7 +50,7 @@ except ImportError:
 # For backward compatibility
 WorkflowGraph = Workflow
 
-__version__ = "0.9.3"
+__version__ = "0.9.4"
 
 __all__ = [
     # Core workflow components

kailash/runtime/local.py

@@ -72,6 +72,75 @@ from kailash.workflow.cyclic_runner import CyclicWorkflowExecutor
 
 logger = logging.getLogger(__name__)
 
+
+class ContentAwareExecutionError(Exception):
+    """Exception raised when content-aware success detection identifies a failure."""
+
+    pass
+
+
+def detect_success(result):
+    """Detect success or failure from a node execution result."""
+    # Handle None result (backward compatibility)
+    if result is None:
+        return True, None
+
+    # Handle non-dict results (backward compatibility)
+    if not isinstance(result, dict):
+        return True, None
+
+    # Handle empty dict (backward compatibility)
+    if not result:
+        return True, None
+
+    # Check for success field
+    if "success" not in result:
+        # No success field, default to success (backward compatibility)
+        return True, None
+
+    success_value = result["success"]
+
+    # Evaluate success value as boolean
+    is_success = bool(success_value)
+
+    if is_success:
+        # Operation succeeded
+        return True, None
+    else:
+        # Operation failed, extract error information
+        error_info = result.get("error", "Operation failed (no error details provided)")
+        return False, error_info
+
+
+def should_stop_on_content_failure(result, content_aware_mode=True, stop_on_error=True):
+    """Check if execution should stop based on content indicating failure."""
+    if not content_aware_mode or not stop_on_error:
+        return False, None
+
+    # Use detect_success for the actual detection logic
+    is_success, error_info = detect_success(result)
+
+    if is_success:
+        # Operation succeeded, continue execution
+        return False, None
+    else:
+        # Operation failed, stop execution
+        return True, error_info
+
+
+def create_content_aware_error(node_id, result, error_message=None):
+    """Create a ContentAwareExecutionError from node result."""
+    if error_message is None:
+        error_message = result.get("error", "Operation failed")
+
+    error = ContentAwareExecutionError(
+        f"Node '{node_id}' reported failure: {error_message}"
+    )
+    error.node_id = node_id
+    error.failure_data = result
+    return error
+
+
 # Conditional execution imports (lazy-loaded to avoid circular imports)
 _ConditionalBranchAnalyzer = None
 _DynamicExecutionPlanner = None
@@ -129,6 +198,7 @@ class LocalRuntime:
         secret_provider: Optional[Any] = None,
         connection_validation: str = "warn",
         conditional_execution: str = "route_data",
+        content_aware_success_detection: bool = True,
     ):
         """Initialize the unified runtime.
 
@@ -150,6 +220,9 @@ class LocalRuntime:
             conditional_execution: Execution strategy for conditional routing:
                 - "route_data": Current behavior - all nodes execute, data routing only (default)
                 - "skip_branches": New behavior - skip unreachable branches entirely
+            content_aware_success_detection: Whether to enable content-aware success detection:
+                - True: Check return value content for success/failure patterns (default)
+                - False: Only use exception-based failure detection (legacy mode)
         """
         # Validate connection_validation parameter
         valid_conn_modes = {"off", "warn", "strict"}
@@ -179,6 +252,7 @@ class LocalRuntime:
         self.resource_limits = resource_limits or {}
         self.connection_validation = connection_validation
         self.conditional_execution = conditional_execution
+        self.content_aware_success_detection = content_aware_success_detection
         self.logger = logger
 
         # Enterprise feature managers (lazy initialization)
@@ -869,6 +943,43 @@ class LocalRuntime:
                 if self.debug:
                     self.logger.debug(f"Node {node_id} outputs: {outputs}")
 
+                # Content-aware success detection (CRITICAL FIX)
+                if self.content_aware_success_detection:
+                    should_stop, error_message = should_stop_on_content_failure(
+                        result=outputs,
+                        content_aware_mode=True,
+                        stop_on_error=True,  # Always stop on content failures when content-aware mode is enabled
+                    )
+
+                    if should_stop:
+                        # Create detailed error for content-aware failure
+                        error = create_content_aware_error(
+                            node_id=node_id,
+                            result=(
+                                outputs
+                                if isinstance(outputs, dict)
+                                else {"error": error_message}
+                            ),
+                            error_message=error_message,
+                        )
+
+                        # Log the content-aware failure
+                        self.logger.error(
+                            f"Content-aware failure detected in node {node_id}: {error_message}"
+                        )
+
+                        # Update task status to failed if task manager exists
+                        if task and task_manager:
+                            task_manager.update_task_status(
+                                task.task_id,
+                                TaskStatus.FAILED,
+                                error=str(error),
+                                ended_at=datetime.now(UTC),
+                            )
+
+                        # Raise the content-aware execution error
+                        raise error
+
                 # Update task status with enhanced metrics
                 if task and task_manager:
                     # Convert performance metrics to TaskMetrics format
@@ -922,7 +1033,12 @@ class LocalRuntime:
                             f"Error during node {node_id} cleanup after failure: {cleanup_error}"
                         )
 
-                # Determine if we should continue
+                # Content-aware execution errors should always stop execution
+                if isinstance(e, ContentAwareExecutionError):
+                    error_msg = f"Content-aware failure in node '{node_id}': {e}"
+                    raise WorkflowExecutionError(error_msg) from e
+
+                # Determine if we should continue for other exceptions
                 if self._should_stop_on_error(workflow, node_id):
                     error_msg = f"Node '{node_id}' failed: {e}"
                     if len(failed_nodes) > 1:

{kailash-0.9.3.dist-info → kailash-0.9.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kailash
-Version: 0.9.3
+Version: 0.9.4
 Summary: Python SDK for the Kailash container-node architecture
 Home-page: https://github.com/integrum/kailash-python-sdk
 Author: Integrum
@@ -117,18 +117,28 @@ Dynamic: requires-python
 
 ---
 
-## 🔥 Latest Release: v0.8.5 (January 20, 2025)
+## 🔥 Latest Release: v0.9.4 (July 31, 2025)
 
-**Architecture Cleanup & Enterprise Security**
+**Critical DataFlow Fixes & Runtime Enhancements**
 
-- 🏗️ **Architecture Clarity**: Removed confusing `src/kailash/nexus` module
-- 🔒 **Connection Validation**: Enterprise-grade parameter validation with type safety
-- 🌐 **Edge Computing**: 50+ new nodes for geo-distributed infrastructure
-- 📊 **Advanced Monitoring**: AlertManager with proactive threshold monitoring
-- 🚀 **Performance**: <1ms validation overhead with intelligent caching
-- ✅ **Breaking Changes**: See [migration guide](sdk-users/6-reference/changelogs/releases/v0.8.5-2025-07-20.md)
+### 🛡️ DataFlow Connection String Parsing
+- **Fixed**: Special characters in passwords (`#`, `$`, `@`, `?`) now work automatically
+- **Before**: `invalid literal for int() with base 10` errors with special characters
+- **After**: All passwords work seamlessly without manual URL encoding
+- **Impact**: Major usability improvement for production deployments
 
-[Full Changelog](sdk-users/6-reference/changelogs/releases/v0.8.5-2025-07-20.md) | [PyPI Packages](https://pypi.org/project/kailash/0.8.5/)
+### 🎯 Runtime Content-Aware Success Detection
+- **New**: LocalRuntime detects `{"success": False}` patterns in node responses
+- **Benefit**: Earlier failure detection and better error reporting
+- **Default**: Enabled by default, backward compatible
+- **Config**: `LocalRuntime(content_aware_success_detection=True)`
+
+### 📚 Documentation Updates
+- Updated DataFlow connection examples with special character support
+- Added runtime configuration options documentation
+- Enhanced troubleshooting guide with new diagnosis patterns
+
+[Full Changelog](sdk-users/6-reference/changelogs/releases/v0.9.4-2025-07-31.md) | [Core SDK 0.9.4](https://pypi.org/project/kailash/0.9.4/) | [DataFlow 0.3.3](https://pypi.org/project/kailash-dataflow/0.3.3/)
 
 ## 🎯 What Makes Kailash Different
 
@@ -345,7 +355,7 @@ results, run_id = runtime.execute(workflow.build())
 
 ## 🚀 Applications Built with Kailash
 
-### 1. DataFlow - Zero-Config Database Platform (v0.3.1)
+### 1. DataFlow - Zero-Config Database Platform (v0.3.3)
 ```bash
 pip install kailash-dataflow
 ```
@@ -353,7 +363,7 @@ pip install kailash-dataflow
 - **Redis caching** with enterprise-grade invalidation
 - **Automatic API generation** with OpenAPI documentation
 - **4 production examples** with complete deployment guides
-- **Latest**: v0.3.1 - Enhanced transaction support and schema management
+- **Latest**: v0.3.3 - Critical connection parsing fix for special characters in passwords
 
 ### 2. Nexus - Multi-Channel Platform (v1.0.3)
 ```bash

{kailash-0.9.3.dist-info → kailash-0.9.4.dist-info}/RECORD

@@ -1,4 +1,4 @@
-kailash/__init__.py,sha256=CooqmdEB3NSi14SW4csQHdvDBCmPeVsqGoNbO0_STjk,2771
+kailash/__init__.py,sha256=cYvKipwAgEW7BQ4t7vCdCY9CctztVnWa2il6THIYeW4,2771
 kailash/__main__.py,sha256=vr7TVE5o16V6LsTmRFKG6RDKUXHpIWYdZ6Dok2HkHnI,198
 kailash/access_control.py,sha256=MjKtkoQ2sg1Mgfe7ovGxVwhAbpJKvaepPWr8dxOueMA,26058
 kailash/access_control_abac.py,sha256=FPfa_8PuDP3AxTjdWfiH3ntwWO8NodA0py9W8SE5dno,30263
@@ -324,7 +324,7 @@ kailash/runtime/async_local.py,sha256=sYNggSU0R-oo8cCvU5ayodDBqASzUhxu994ZvZxDSC
 kailash/runtime/compatibility_reporter.py,sha256=TOQD0ODnJdsxEPyNSYOV_zQxu60X_yvHeu26seFOMEA,19807
 kailash/runtime/docker.py,sha256=sZknVl1PCGfAZeyc0-exTuKlllSyjYlFIgJoiB3CRNs,23500
 kailash/runtime/hierarchical_switch_executor.py,sha256=k6aPGbpf6z2m6dTbHrEyuDR8ZCvOqUanBGYp70arQn0,20782
-kailash/runtime/local.py,sha256=K8E6_qsUD4XhBN57Yh6yWxyz3C8OE0NRQzbY0Meuy-Y,142684
+kailash/runtime/local.py,sha256=xDJ7Z9UwqR432rRRUzkOyHJr1ejPE751VB-oW-BuBGE,147155
 kailash/runtime/parallel.py,sha256=-M9VVG36RxnrrmdbcBe9IjQWb58tAEEo76RQQ2uIXaE,21084
 kailash/runtime/parallel_cyclic.py,sha256=yANZHnePjhCPuCFbq3lFQA1K6jbCv5Of5-vIKbCsmZk,19863
 kailash/runtime/parameter_injection.py,sha256=kG4GhmarsRr5t3VDFbc2G1HSbsZJg6UmienHCE2Ru7o,14852
@@ -403,9 +403,9 @@ kailash/workflow/templates.py,sha256=XQMAKZXC2dlxgMMQhSEOWAF3hIbe9JJt9j_THchhAm8
 kailash/workflow/type_inference.py,sha256=i1F7Yd_Z3elTXrthsLpqGbOnQBIVVVEjhRpI0HrIjd0,24492
 kailash/workflow/validation.py,sha256=r2zApGiiG8UEn7p5Ji842l8OR1_KftzDkWc7gg0cac0,44675
 kailash/workflow/visualization.py,sha256=nHBW-Ai8QBMZtn2Nf3EE1_aiMGi9S6Ui_BfpA5KbJPU,23187
-kailash-0.9.3.dist-info/licenses/LICENSE,sha256=Axe6g7bTrJkToK9h9j2SpRUKKNaDZDCo2lQ2zPxCE6s,1065
-kailash-0.9.3.dist-info/METADATA,sha256=tg66RmWbr3bb20VqL5FjuBNExWHWMZMWw1l5s3s-TPA,21733
-kailash-0.9.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-kailash-0.9.3.dist-info/entry_points.txt,sha256=M_q3b8PG5W4XbhSgESzIJjh3_4OBKtZFYFsOdkr2vO4,45
-kailash-0.9.3.dist-info/top_level.txt,sha256=z7GzH2mxl66498pVf5HKwo5wwfPtt9Aq95uZUpH6JV0,8
-kailash-0.9.3.dist-info/RECORD,,
+kailash-0.9.4.dist-info/licenses/LICENSE,sha256=Axe6g7bTrJkToK9h9j2SpRUKKNaDZDCo2lQ2zPxCE6s,1065
+kailash-0.9.4.dist-info/METADATA,sha256=YcBgKrE5E7m1D70nINO6sog67Tn7Wcb8s6eF__zybF4,22203
+kailash-0.9.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+kailash-0.9.4.dist-info/entry_points.txt,sha256=M_q3b8PG5W4XbhSgESzIJjh3_4OBKtZFYFsOdkr2vO4,45
+kailash-0.9.4.dist-info/top_level.txt,sha256=z7GzH2mxl66498pVf5HKwo5wwfPtt9Aq95uZUpH6JV0,8
+kailash-0.9.4.dist-info/RECORD,,