kailash 0.8.5__tar.gz → 0.8.6__tar.gz

{kailash-0.8.5/src/kailash.egg-info → kailash-0.8.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kailash
-Version: 0.8.5
+Version: 0.8.6
 Summary: Python SDK for the Kailash container-node architecture
 Home-page: https://github.com/integrum/kailash-python-sdk
 Author: Integrum
@@ -116,18 +116,18 @@ Dynamic: requires-python
 
 ---
 
-## 🔥 Latest Release: v0.8.4 (January 19, 2025)
+## 🔥 Latest Release: v0.8.5 (January 20, 2025)
 
-**A2A Google Protocol Enhancement**
+**Architecture Cleanup & Enterprise Security**
 
-- 🤖 **Advanced Agent Coordination**: A2ACoordinatorNode with Google Protocol best practices
-- 🎯 **Intelligent Task Delegation**: Context-aware task distribution with skill-based matching
-- 🔍 **Hybrid Search Capabilities**: Multi-strategy agent discovery and matching algorithms
-- 🧠 **Semantic Memory System**: Long-term memory management for agent interactions
-- 📊 **Real-time Analytics**: Streaming performance monitoring for A2A workflows
-- ✅ **Backward Compatible**: Seamless integration with existing A2A implementations
+- 🏗️ **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)
 
-[Full Changelog](CHANGELOG.md) | [PyPI Packages](https://pypi.org/project/kailash/0.8.4/)
+[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/)
 
 ## 🎯 What Makes Kailash Different
 
@@ -344,7 +344,7 @@ results, run_id = runtime.execute(workflow.build())
 
 ## 🚀 Applications Built with Kailash
 
-### 1. DataFlow - Zero-Config Database Platform
+### 1. DataFlow - Zero-Config Database Platform (v0.3.1)
 ```bash
 pip install kailash-dataflow
 ```
@@ -352,8 +352,9 @@ 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
 
-### 2. Nexus - Multi-Channel Platform
+### 2. Nexus - Multi-Channel Platform (v1.0.3)
 ```bash
 pip install kailash-nexus
 ```
@@ -361,6 +362,7 @@ pip install kailash-nexus
 - **Enterprise orchestration** with multi-tenancy
 - **Session management** with cross-channel synchronization
 - **105 tests** with comprehensive validation
+- **Latest**: v1.0.3 - Production-ready release with enhanced stability
 
 ### 3. AI Registry - Advanced RAG Platform
 ```bash
@@ -421,8 +423,8 @@ pytest tests/e2e/ --timeout=10
 
 ### For Users
 - **[SDK Users Guide](sdk-users/)**: Complete workflow development guide
-- **[Node Selection Guide](sdk-users/nodes/node-selection-guide.md)**: Smart node selection with decision trees
-- **[Enterprise Patterns](sdk-users/enterprise/)**: Production deployment patterns
+- **[Node Selection Guide](sdk-users/2-core-concepts/nodes/node-selection-guide.md)**: Smart node selection with decision trees
+- **[Enterprise Patterns](sdk-users/5-enterprise/)**: Production deployment patterns
 - **[API Documentation](https://integrum.github.io/kailash-python-sdk)**: Complete API reference
 
 ### For Contributors
@@ -431,9 +433,9 @@ pytest tests/e2e/ --timeout=10
 - **[Testing Guide](tests/README.md)**: 3-tier testing strategy
 
 ### Quick References
-- **[Cheatsheet](sdk-users/cheatsheet/)**: 53 copy-paste patterns
-- **[Common Mistakes](sdk-users/validation/common-mistakes.md)**: Error patterns and solutions
-- **[Performance Guide](sdk-users/performance/)**: Optimization patterns
+- **[Cheatsheet](sdk-users/2-core-concepts/cheatsheet/)**: 53 copy-paste patterns
+- **[Common Mistakes](sdk-users/2-core-concepts/validation/common-mistakes.md)**: Error patterns and solutions
+- **[Performance Guide](sdk-users/5-enterprise/performance/)**: Optimization patterns
 
 ## 🚢 Production Deployment
 

{kailash-0.8.5 → kailash-0.8.6}/README.md

@@ -22,18 +22,18 @@
 
 ---
 
-## 🔥 Latest Release: v0.8.4 (January 19, 2025)
+## 🔥 Latest Release: v0.8.5 (January 20, 2025)
 
-**A2A Google Protocol Enhancement**
+**Architecture Cleanup & Enterprise Security**
 
-- 🤖 **Advanced Agent Coordination**: A2ACoordinatorNode with Google Protocol best practices
-- 🎯 **Intelligent Task Delegation**: Context-aware task distribution with skill-based matching
-- 🔍 **Hybrid Search Capabilities**: Multi-strategy agent discovery and matching algorithms
-- 🧠 **Semantic Memory System**: Long-term memory management for agent interactions
-- 📊 **Real-time Analytics**: Streaming performance monitoring for A2A workflows
-- ✅ **Backward Compatible**: Seamless integration with existing A2A implementations
+- 🏗️ **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)
 
-[Full Changelog](CHANGELOG.md) | [PyPI Packages](https://pypi.org/project/kailash/0.8.4/)
+[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/)
 
 ## 🎯 What Makes Kailash Different
 
@@ -250,7 +250,7 @@ results, run_id = runtime.execute(workflow.build())
 
 ## 🚀 Applications Built with Kailash
 
-### 1. DataFlow - Zero-Config Database Platform
+### 1. DataFlow - Zero-Config Database Platform (v0.3.1)
 ```bash
 pip install kailash-dataflow
 ```
@@ -258,8 +258,9 @@ 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
 
-### 2. Nexus - Multi-Channel Platform
+### 2. Nexus - Multi-Channel Platform (v1.0.3)
 ```bash
 pip install kailash-nexus
 ```
@@ -267,6 +268,7 @@ pip install kailash-nexus
 - **Enterprise orchestration** with multi-tenancy
 - **Session management** with cross-channel synchronization
 - **105 tests** with comprehensive validation
+- **Latest**: v1.0.3 - Production-ready release with enhanced stability
 
 ### 3. AI Registry - Advanced RAG Platform
 ```bash
@@ -327,8 +329,8 @@ pytest tests/e2e/ --timeout=10
 
 ### For Users
 - **[SDK Users Guide](sdk-users/)**: Complete workflow development guide
-- **[Node Selection Guide](sdk-users/nodes/node-selection-guide.md)**: Smart node selection with decision trees
-- **[Enterprise Patterns](sdk-users/enterprise/)**: Production deployment patterns
+- **[Node Selection Guide](sdk-users/2-core-concepts/nodes/node-selection-guide.md)**: Smart node selection with decision trees
+- **[Enterprise Patterns](sdk-users/5-enterprise/)**: Production deployment patterns
 - **[API Documentation](https://integrum.github.io/kailash-python-sdk)**: Complete API reference
 
 ### For Contributors
@@ -337,9 +339,9 @@ pytest tests/e2e/ --timeout=10
 - **[Testing Guide](tests/README.md)**: 3-tier testing strategy
 
 ### Quick References
-- **[Cheatsheet](sdk-users/cheatsheet/)**: 53 copy-paste patterns
-- **[Common Mistakes](sdk-users/validation/common-mistakes.md)**: Error patterns and solutions
-- **[Performance Guide](sdk-users/performance/)**: Optimization patterns
+- **[Cheatsheet](sdk-users/2-core-concepts/cheatsheet/)**: 53 copy-paste patterns
+- **[Common Mistakes](sdk-users/2-core-concepts/validation/common-mistakes.md)**: Error patterns and solutions
+- **[Performance Guide](sdk-users/5-enterprise/performance/)**: Optimization patterns
 
 ## 🚢 Production Deployment
 

{kailash-0.8.5 → kailash-0.8.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "kailash"
-version = "0.8.5"
+version = "0.8.6"
 description = "Python SDK for the Kailash container-node architecture"
 authors = [
     {name = "Integrum", email = "info@integrum.com"}
@@ -123,7 +123,7 @@ select = ["E", "F"]
 ignore = ["E203", "E501", "E722", "F401", "F841"]
 
 [tool.ruff.lint.per-file-ignores]
-"sdk-users/workflows/by-industry/finance/scripts/*.py" = ["E402"]
+"sdk-users/2-core-concepts/workflows/by-industry/finance/scripts/*.py" = ["E402"]
 "examples/feature_examples/workflows/cyclic/*.py" = ["E722"]
 "examples/feature_examples/workflows/parallel/*.py" = ["E722"]
 "scripts/refactor-pythoncode-to-functions.py" = ["E722"]
@@ -136,7 +136,7 @@ ignore = ["E203", "E501", "E722", "F401", "F841"]
 # Allow late imports in performance test files
 "tests/unit/performance_benchmarks/*.py" = ["E402"]
 # SDK user workflows may have late imports for demos
-"sdk-users/workflows/**/*.py" = ["E402", "F821"]
+"sdk-users/2-core-concepts/workflows/**/*.py" = ["E402", "F821"]
 # Examples may have late imports and mocks
 "examples/**/*.py" = ["E402", "F821"]
 # Scripts may need to modify sys.path before imports

{kailash-0.8.5 → kailash-0.8.6}/setup.py

@@ -51,14 +51,14 @@ setup(
             "pygraphviz>=1.9",
         ],
         "dataflow": [
-            "kailash-dataflow>=0.1.0",
+            "kailash-dataflow>=0.3.1",
         ],
         "nexus": [
-            "kailash-nexus>=1.0.0",
+            "kailash-nexus>=1.0.3",
         ],
         "all": [
-            "kailash-dataflow>=0.1.0",
-            "kailash-nexus>=1.0.0",
+            "kailash-dataflow>=0.3.1",
+            "kailash-nexus>=1.0.3",
         ],
     },
     # Entry points for CLI

{kailash-0.8.5 → kailash-0.8.6}/src/kailash/__init__.py

@@ -3,10 +3,10 @@
 The Kailash SDK provides a comprehensive framework for creating nodes and workflows
 that align with container-node architecture while allowing rapid prototyping.
 
-New in v0.7.0: Complete DataFlow and Nexus application frameworks, infrastructure hardening
-with 100% E2E test pass rate, enhanced AsyncNode event loop handling, 8 new monitoring operations,
-distributed transactions, QueryBuilder/QueryCache with Redis, and real MCP execution by default.
-Previous v0.6.6: AgentUIMiddleware shared workflow fix, execute() method standardization.
+New in v0.8.6: Enhanced parameter validation system with 4 modes (off/warn/strict/debug),
+ParameterDebugger for comprehensive flow tracing (10x faster debugging), production-ready
+performance (<1ms overhead), and complete troubleshooting documentation.
+Previous v0.8.5: Test infrastructure enhancement, application framework improvements.
 """
 
 from kailash.nodes.base import Node, NodeMetadata, NodeParameter
@@ -49,7 +49,7 @@ except ImportError:
 # For backward compatibility
 WorkflowGraph = Workflow
 
-__version__ = "0.8.5"
+__version__ = "0.8.6"
 
 __all__ = [
     # Core workflow components

{kailash-0.8.5 → kailash-0.8.6}/src/kailash/channels/__init__.py

@@ -5,7 +5,7 @@ enabling unified management of API, CLI, and MCP interfaces through a common cha
 """
 
 from .api_channel import APIChannel
-from .base import Channel, ChannelConfig
+from .base import Channel, ChannelConfig, ChannelType
 from .cli_channel import CLIChannel
 from .mcp_channel import MCPChannel
 from .session import CrossChannelSession, SessionManager
@@ -13,6 +13,7 @@ from .session import CrossChannelSession, SessionManager
 __all__ = [
     "Channel",
     "ChannelConfig",
+    "ChannelType",
     "APIChannel",
     "CLIChannel",
     "MCPChannel",

{kailash-0.8.5 → kailash-0.8.6}/src/kailash/channels/mcp_channel.py

@@ -84,6 +84,7 @@ class MCPChannel(Channel):
         # MCP-specific state
         self._clients: Dict[str, Dict[str, Any]] = {}
         self._server_task: Optional[asyncio.Task] = None
+        self._mcp_server_task: Optional[asyncio.Task] = None
 
         logger.info(f"Initialized MCP channel {self.name}")
 
@@ -202,8 +203,15 @@ class MCPChannel(Channel):
             self.status = ChannelStatus.STARTING
             self._setup_event_queue()
 
-            # Start MCP server
-            await self.mcp_server.start()
+            # Start MCP server (Core SDK uses run() method, not start())
+            # For async operation, we need to run it in a separate task
+            if hasattr(self.mcp_server, "run"):
+                # Core SDK MCPServer uses run() method
+                loop = asyncio.get_event_loop()
+                self._mcp_server_task = loop.run_in_executor(None, self.mcp_server.run)
+            else:
+                # Fallback to start() if available
+                await self.mcp_server.start()
 
             # Start server task for handling connections
             self._server_task = asyncio.create_task(self._server_loop())
@@ -261,9 +269,20 @@ class MCPChannel(Channel):
                 except asyncio.CancelledError:
                     pass
 
+            # Stop MCP server task if running
+            if hasattr(self, "_mcp_server_task") and self._mcp_server_task:
+                self._mcp_server_task.cancel()
+                try:
+                    await self._mcp_server_task
+                except asyncio.CancelledError:
+                    pass
+
             # Stop MCP server
-            if self.mcp_server:
-                await self.mcp_server.stop()
+            if self.mcp_server and hasattr(self.mcp_server, "stop"):
+                try:
+                    await self.mcp_server.stop()
+                except Exception as e:
+                    logger.warning(f"Error stopping MCP server: {e}")
 
             await self._cleanup()
             self.status = ChannelStatus.STOPPED

kailash-0.8.6/src/kailash/cli/validate_imports.py

@@ -0,0 +1,202 @@
+#!/usr/bin/env python3
+"""
+Command-line tool for validating import paths for production deployment.
+
+Usage:
+    python -m kailash.cli.validate_imports [path] [options]
+
+Examples:
+    # Validate current directory
+    python -m kailash.cli.validate_imports
+
+    # Validate specific directory
+    python -m kailash.cli.validate_imports src/myapp
+
+    # Fix imports (dry run)
+    python -m kailash.cli.validate_imports src/myapp --fix
+
+    # Fix imports (apply changes)
+    python -m kailash.cli.validate_imports src/myapp --fix --apply
+"""
+
+import argparse
+import sys
+from pathlib import Path
+from typing import List
+
+from kailash.runtime.validation import ImportIssue, ImportPathValidator
+
+
+def main():
+    """Main entry point for import validation CLI."""
+    parser = argparse.ArgumentParser(
+        description="Validate Python imports for production deployment compatibility",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  %(prog)s                    # Validate current directory
+  %(prog)s src/myapp          # Validate specific directory
+  %(prog)s src/myapp --fix    # Show import fixes (dry run)
+  %(prog)s --file module.py   # Validate single file
+  
+For more info, see: sdk-users/7-gold-standards/absolute-imports-gold-standard.md
+        """,
+    )
+
+    parser.add_argument(
+        "path",
+        nargs="?",
+        default=".",
+        help="Path to validate (directory or file, default: current directory)",
+    )
+
+    parser.add_argument(
+        "--file",
+        "-f",
+        action="store_true",
+        help="Treat path as a single file instead of directory",
+    )
+
+    parser.add_argument(
+        "--fix", action="store_true", help="Show suggested fixes for import issues"
+    )
+
+    parser.add_argument(
+        "--apply",
+        action="store_true",
+        help="Apply fixes (use with --fix, CAUTION: modifies files!)",
+    )
+
+    parser.add_argument(
+        "--no-recursive", "-n", action="store_true", help="Do not scan subdirectories"
+    )
+
+    parser.add_argument(
+        "--include-tests", action="store_true", help="Include test files in validation"
+    )
+
+    parser.add_argument("--json", action="store_true", help="Output results as JSON")
+
+    parser.add_argument(
+        "--quiet",
+        "-q",
+        action="store_true",
+        help="Only show errors, no informational output",
+    )
+
+    parser.add_argument(
+        "--verbose", "-v", action="store_true", help="Show detailed output"
+    )
+
+    args = parser.parse_args()
+
+    # Create validator
+    validator = ImportPathValidator()
+
+    # Validate path
+    path = Path(args.path)
+    if not path.exists():
+        print(f"Error: Path '{path}' does not exist", file=sys.stderr)
+        sys.exit(1)
+
+    # Collect issues
+    issues: List[ImportIssue] = []
+
+    if args.file or path.is_file():
+        # Validate single file
+        if args.verbose:
+            print(f"Validating file: {path}")
+        issues = validator.validate_file(str(path))
+    else:
+        # Validate directory
+        if args.verbose:
+            print(f"Validating directory: {path}")
+            print(f"Recursive: {not args.no_recursive}")
+            print(f"Include tests: {args.include_tests}")
+            print()
+
+        # TODO: Add support for include_tests flag in validator
+        issues = validator.validate_directory(
+            str(path), recursive=not args.no_recursive
+        )
+
+    # Handle results
+    if args.json:
+        import json
+
+        # Convert issues to JSON-serializable format
+        issues_data = [
+            {
+                "file": issue.file_path,
+                "line": issue.line_number,
+                "import": issue.import_statement,
+                "type": issue.issue_type.value,
+                "severity": issue.severity,
+                "message": issue.message,
+                "suggestion": issue.suggestion,
+            }
+            for issue in issues
+        ]
+        print(
+            json.dumps(
+                {
+                    "issues": issues_data,
+                    "total": len(issues),
+                    "critical": len([i for i in issues if i.severity == "critical"]),
+                    "warnings": len([i for i in issues if i.severity == "warning"]),
+                },
+                indent=2,
+            )
+        )
+
+    elif args.fix:
+        # Show fixes
+        if not issues:
+            if not args.quiet:
+                print("✅ No import issues found!")
+            sys.exit(0)
+
+        print(f"Found {len(issues)} import issues\n")
+
+        # Group by file
+        files_with_issues = {}
+        for issue in issues:
+            if issue.file_path not in files_with_issues:
+                files_with_issues[issue.file_path] = []
+            files_with_issues[issue.file_path].append(issue)
+
+        for file_path, file_issues in files_with_issues.items():
+            print(f"\n📄 {file_path}")
+            print("-" * 60)
+
+            if args.apply:
+                # Apply fixes
+                fixes = validator.fix_imports_in_file(file_path, dry_run=False)
+                for original, fixed in fixes:
+                    print(f"  ❌ {original}")
+                    print(f"  ✅ {fixed}")
+                print(f"\n  Applied {len(fixes)} fixes to {file_path}")
+            else:
+                # Show proposed fixes
+                for issue in file_issues:
+                    print(f"  Line {issue.line_number}: {issue.import_statement}")
+                    print(f"  Issue: {issue.message}")
+                    print(f"  Fix: {issue.suggestion}")
+                    print()
+
+        if not args.apply:
+            print("\n💡 To apply these fixes, run with --fix --apply")
+            print("⚠️  CAUTION: This will modify your files!")
+
+    else:
+        # Standard report
+        report = validator.generate_report(issues)
+        print(report)
+
+    # Exit code based on critical issues
+    critical_count = len([i for i in issues if i.severity == "critical"])
+    sys.exit(1 if critical_count > 0 else 0)
+
+
+if __name__ == "__main__":
+    main()

{kailash-0.8.5 → kailash-0.8.6}/src/kailash/core/resilience/bulkhead.py

@@ -204,11 +204,21 @@ class BulkheadPartition:
             await self._record_failure(execution_time)
             raise
         finally:
-            # Clean up
-            async with self._lock:
-                if operation_id in self._active_operations:
-                    self._active_operations.remove(operation_id)
-                self.metrics.active_operations = len(self._active_operations)
+            # Clean up - with proper exception handling for event loop issues
+            try:
+                async with self._lock:
+                    if operation_id in self._active_operations:
+                        self._active_operations.remove(operation_id)
+                    self.metrics.active_operations = len(self._active_operations)
+            except (RuntimeError, asyncio.CancelledError):
+                # Handle event loop issues during cleanup - force cleanup without lock
+                try:
+                    if operation_id in self._active_operations:
+                        self._active_operations.remove(operation_id)
+                    self.metrics.active_operations = len(self._active_operations)
+                except:
+                    # Final fallback - ignore cleanup errors during shutdown
+                    pass
 
     async def _execute_isolated(
         self, operation_id: str, func: Callable, args: tuple, kwargs: dict, timeout: int

{kailash-0.8.5 → kailash-0.8.6}/src/kailash/core/resilience/circuit_breaker.py

@@ -467,7 +467,10 @@ class CircuitBreakerManager:
         return self._breakers[name]
 
     def create_circuit_breaker(
-        self, name: str, config: Optional[CircuitBreakerConfig] = None, pattern: Optional[str] = None
+        self,
+        name: str,
+        config: Optional[CircuitBreakerConfig] = None,
+        pattern: Optional[str] = None,
     ) -> ConnectionCircuitBreaker:
         """Create a new circuit breaker with optional pattern-based configuration."""
         if pattern and pattern in self._patterns: