kailash 0.9.3__tar.gz → 0.9.4__tar.gz

{kailash-0.9.3/src/kailash.egg-info → kailash-0.9.4}/PKG-INFO

@@ -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 → kailash-0.9.4}/README.md

@@ -22,18 +22,28 @@
 
 ---
 
-## 🔥 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
 
@@ -250,7 +260,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
 ```
@@ -258,7 +268,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 → kailash-0.9.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "kailash"
-version = "0.9.3"
+version = "0.9.4"
 description = "Python SDK for the Kailash container-node architecture"
 authors = [
     {name = "Integrum", email = "info@integrum.com"}

{kailash-0.9.3 → kailash-0.9.4}/src/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-0.9.3 → kailash-0.9.4}/src/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 → kailash-0.9.4/src/kailash.egg-info}/PKG-INFO

@@ -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