kailash 0.9.13__tar.gz → 0.9.15__tar.gz

{kailash-0.9.13/src/kailash.egg-info → kailash-0.9.15}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kailash
-Version: 0.9.13
+Version: 0.9.15
 Summary: Python SDK for the Kailash container-node architecture
 Home-page: https://github.com/integrum/kailash-python-sdk
 Author: Integrum

{kailash-0.9.13 → kailash-0.9.15}/pyproject.toml

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

{kailash-0.9.13 → kailash-0.9.15}/setup.py

@@ -13,7 +13,7 @@ with open(os.path.join(this_directory, "README.md"), encoding="utf-8") as f:
 # Package configuration
 setup(
     name="kailash",
-    version="0.9.2",
+    version="0.9.14",
     author="Integrum",
     author_email="info@integrum.com",
     description="Python SDK for the Kailash container-node architecture",
@@ -51,14 +51,14 @@ setup(
             "pygraphviz>=1.9",
         ],
         "dataflow": [
-            "kailash-dataflow>=0.3.1",
+            "kailash-dataflow>=0.4.6",
         ],
         "nexus": [
             "kailash-nexus>=1.0.3",
         ],
         "all": [
-            "kailash-dataflow>=0.3.1",
-            "kailash-nexus>=1.0.3",
+            "kailash-dataflow>=0.4.6",
+            "kailash-nexus>=1.0.6",
         ],
     },
     # Entry points for CLI

{kailash-0.9.13 → kailash-0.9.15}/src/kailash/__init__.py

@@ -3,11 +3,13 @@
 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.9.2: WebSocket Transport Support with Enterprise Connection Pooling.
+New in v0.9.14: Code quality improvements and updated dependencies for DataFlow v0.4.6 compatibility.
+Applied black formatting fixes and ensured CI stability. Updated dependency references to latest framework versions.
+Previous v0.9.13: Fixed WorkflowBuilder parameter validation false positives (Bug 010).
+Enhanced validation.py to recognize auto_map_from parameters, eliminating spurious warnings.
+Previous v0.9.12: SQLite Compatibility & Code Quality improvements.
+Previous v0.9.2: WebSocket Transport Support with Enterprise Connection Pooling.
 Fixed "Unsupported transport: websocket" error. Added 73% performance improvement with connection pooling.
-Previous v0.9.1: DataFlow PostgreSQL parameter conversion verification and comprehensive testing infrastructure.
-Complete validation of parameter conversion chain from DataFlow to AsyncSQLDatabaseNode to PostgreSQL.
-Previous v0.9.0: Complete migration from cycle=True to modern CycleBuilder API.
 """
 
 from kailash.nodes.base import Node, NodeMetadata, NodeParameter
@@ -50,7 +52,7 @@ except ImportError:
 # For backward compatibility
 WorkflowGraph = Workflow
 
-__version__ = "0.9.13"
+__version__ = "0.9.14"
 
 __all__ = [
     # Core workflow components

{kailash-0.9.13 → kailash-0.9.15}/src/kailash/cli/validate_imports.py

@@ -38,7 +38,7 @@ Examples:
   %(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
         """,
     )

{kailash-0.9.13 → kailash-0.9.15}/src/kailash/core/ml/query_patterns.py

@@ -59,8 +59,8 @@ class QueryPatternTracker:
     """Tracks and analyzes query execution patterns."""
 
     def __init__(
-        self, retention_hours: int = 168, min_pattern_frequency: int = 5  # 7 days
-    ):
+        self, retention_hours: int = 168, min_pattern_frequency: int = 5
+    ):  # 7 days
         self.retention_hours = retention_hours
         self.min_pattern_frequency = min_pattern_frequency
 

{kailash-0.9.13 → kailash-0.9.15}/src/kailash/edge/resource/platform_integration.py

@@ -14,10 +14,7 @@ from .cloud_integration import (
     InstanceState,
 )
 from .cost_optimizer import CloudProvider as CostCloudProvider
-from .cost_optimizer import (
-    CostOptimizer,
-    OptimizationStrategy,
-)
+from .cost_optimizer import CostOptimizer, OptimizationStrategy
 from .docker_integration import (
     ContainerSpec,
     ContainerState,

{kailash-0.9.13 → kailash-0.9.15}/src/kailash/integrations/dataflow_edge.py

@@ -227,7 +227,7 @@ class SensitiveData:
     user_id: int
     personal_info: dict
     location: str
-    
+
     __dataflow__ = {
         'multi_tenant': True,
         'soft_delete': True,
@@ -247,7 +247,7 @@ class SensitiveData:
 
 # When using generated nodes in workflows:
 workflow = WorkflowBuilder(edge_config=DataFlowEdgeIntegration.create_edge_workflow_config(
-    'SensitiveData', 
+    'SensitiveData',
     SensitiveData.__dataflow__['edge_config']
 ))
 

{kailash-0.9.13 → kailash-0.9.15}/src/kailash/middleware/database/base_models.py

@@ -8,13 +8,7 @@ import uuid
 from datetime import datetime, timezone
 from typing import Any, Dict, List, Optional
 
-from sqlalchemy import (
-    JSON,
-    Boolean,
-    CheckConstraint,
-    Column,
-    DateTime,
-)
+from sqlalchemy import JSON, Boolean, CheckConstraint, Column, DateTime
 from sqlalchemy import Enum as SQLEnum
 from sqlalchemy import (
     Float,

{kailash-0.9.13 → kailash-0.9.15}/src/kailash/monitoring/alerts.py

@@ -260,12 +260,12 @@ class EmailNotificationChannel(NotificationChannel):
         <p><strong>Status:</strong> {alert.status.value}</p>
         <p><strong>Description:</strong> {alert.description}</p>
         <p><strong>Created:</strong> {alert.created_at.isoformat()}</p>
-        
+
         <h3>Labels:</h3>
         <ul>
         {"".join(f"<li><strong>{k}:</strong> {v}</li>" for k, v in alert.labels.items())}
         </ul>
-        
+
         <h3>Context:</h3>
         <ul>
         {"".join(f"<li><strong>{k}:</strong> {v}</li>" for k, v in context.items())}

kailash-0.9.15/src/kailash/nodes/__init__.py

@@ -0,0 +1,229 @@
+"""
+Kailash SDK Nodes Module - Safe Lazy Loading Implementation
+
+This implementation provides lazy loading with circular dependency protection
+and maintains full backward compatibility.
+"""
+
+import importlib
+import sys
+import warnings
+from typing import Any, Dict, Optional, Set
+
+# Core imports that are always needed
+from .base import Node, NodeParameter, NodeRegistry
+
+# Track loading state to detect circular dependencies
+_LOADING_STACK: Set[str] = set()
+_LOADED_MODULES: Dict[str, Optional[Any]] = {}
+
+# Define available node categories for lazy loading
+_NODE_CATEGORIES = [
+    "ai",
+    "alerts",
+    "api",
+    "auth",
+    "cache",
+    "code",
+    "compliance",
+    "data",
+    "edge",
+    "enterprise",
+    "logic",
+    "mixins",
+    "monitoring",
+    "rag",
+    "security",
+    "testing",
+    "transaction",
+    "transform",
+]
+
+# Initialize lazy module cache
+_LAZY_MODULES: Dict[str, Optional[Any]] = {
+    category: None for category in _NODE_CATEGORIES
+}
+
+
+def _safe_lazy_import(name: str) -> Any:
+    """
+    Safely import a module with circular dependency detection.
+
+    Args:
+        name: The module name to import
+
+    Returns:
+        The imported module
+
+    Raises:
+        ImportError: If a circular dependency is detected
+    """
+    full_module_name = f"kailash.nodes.{name}"
+
+    # Check if already loaded
+    if name in _LOADED_MODULES:
+        return _LOADED_MODULES[name]
+
+    # Check for circular dependency
+    if full_module_name in _LOADING_STACK:
+        cycle_modules = list(_LOADING_STACK) + [full_module_name]
+        warnings.warn(
+            f"Circular dependency detected: {' -> '.join(cycle_modules)}. "
+            f"Using partial import to break the cycle.",
+            ImportWarning,
+            stacklevel=3,
+        )
+        # Return a placeholder that will be populated after loading
+        module = sys.modules.get(full_module_name)
+        if module:
+            return module
+        # Create empty module as placeholder
+        module = type(sys)("placeholder")
+        sys.modules[full_module_name] = module
+        return module
+
+    # Add to loading stack
+    _LOADING_STACK.add(full_module_name)
+
+    try:
+        # Perform the actual import
+        module = importlib.import_module(f".{name}", package="kailash.nodes")
+        _LOADED_MODULES[name] = module
+        return module
+    finally:
+        # Remove from loading stack
+        _LOADING_STACK.discard(full_module_name)
+
+
+def __getattr__(name: str) -> Any:
+    """
+    Lazy loading of node category modules with circular dependency protection.
+
+    This function is called when accessing an attribute that doesn't exist
+    in the module's namespace. It enables lazy loading of node categories
+    while detecting and handling circular dependencies.
+
+    Args:
+        name: The attribute name being accessed
+
+    Returns:
+        The requested module or attribute
+
+    Raises:
+        AttributeError: If the attribute doesn't exist
+    """
+    # Check if it's a known node category
+    if name in _LAZY_MODULES:
+        if _LAZY_MODULES[name] is None:
+            try:
+                # Use safe import with circular dependency detection
+                _LAZY_MODULES[name] = _safe_lazy_import(name)
+            except ImportError as e:
+                # Log the error and re-raise
+                import logging
+
+                logging.error(f"Failed to import kailash.nodes.{name}: {e}")
+                raise
+        return _LAZY_MODULES[name]
+
+    # Handle special attributes
+    if name == "__all__":
+        return ["Node", "NodeParameter", "NodeRegistry"] + _NODE_CATEGORIES
+
+    # Attribute not found
+    raise AttributeError(f"module 'kailash.nodes' has no attribute '{name}'")
+
+
+def __dir__():
+    """Return the list of available attributes for tab completion."""
+    return ["Node", "NodeParameter", "NodeRegistry"] + _NODE_CATEGORIES
+
+
+def check_circular_dependencies() -> Dict[str, Any]:
+    """
+    Check for circular dependencies in the nodes module.
+
+    Returns:
+        A dictionary containing:
+        - has_circular_deps: Boolean indicating if circular deps exist
+        - circular_chains: List of circular dependency chains found
+        - warnings: List of warning messages
+    """
+    from pathlib import Path
+
+    from ..utils.circular_dependency_detector import CircularDependencyDetector
+
+    # Get the SDK root directory
+    sdk_root = Path(__file__).parent.parent.parent
+
+    detector = CircularDependencyDetector(sdk_root)
+    detector.build_import_graph("src/kailash/nodes")
+    cycles = detector.detect_cycles()
+
+    result = {
+        "has_circular_deps": bool(cycles),
+        "circular_chains": cycles,
+        "warnings": [],
+    }
+
+    if cycles:
+        for cycle in cycles:
+            result["warnings"].append(
+                f"Circular dependency detected: {' -> '.join(cycle)} -> {cycle[0]}"
+            )
+
+    return result
+
+
+def preload_all_categories():
+    """
+    Preload all node categories (useful for testing or warming up).
+
+    This function loads all node categories immediately rather than lazily.
+    It's useful for:
+    - Testing that all imports work correctly
+    - Warming up the import cache
+    - Detecting circular dependencies early
+    """
+    failed_imports = []
+
+    for category in _NODE_CATEGORIES:
+        try:
+            _safe_lazy_import(category)
+        except ImportError as e:
+            failed_imports.append((category, str(e)))
+
+    if failed_imports:
+        warnings.warn(
+            f"Failed to import some categories: {failed_imports}", ImportWarning
+        )
+
+    return {
+        "loaded": [cat for cat in _NODE_CATEGORIES if cat in _LOADED_MODULES],
+        "failed": failed_imports,
+    }
+
+
+# Performance monitoring
+def get_import_stats() -> Dict[str, Any]:
+    """
+    Get statistics about module imports.
+
+    Returns:
+        Dictionary containing import statistics
+    """
+    return {
+        "loaded_modules": list(_LOADED_MODULES.keys()),
+        "pending_modules": [
+            cat for cat in _NODE_CATEGORIES if cat not in _LOADED_MODULES
+        ],
+        "total_categories": len(_NODE_CATEGORIES),
+        "loaded_count": len(_LOADED_MODULES),
+        "currently_loading": list(_LOADING_STACK),
+    }
+
+
+# Backward compatibility - ensure all existing imports work
+__all__ = ["Node", "NodeParameter", "NodeRegistry"] + _NODE_CATEGORIES
+
+# Export core components directly

{kailash-0.9.13 → kailash-0.9.15}/src/kailash/nodes/ai/iterative_llm_agent.py

@@ -1666,7 +1666,7 @@ class IterativeLLMAgentNode(LLMAgentNode):
         synthesis_messages = [
             {
                 "role": "system",
-                "content": """You are an AI assistant synthesizing results from an iterative analysis process. 
+                "content": """You are an AI assistant synthesizing results from an iterative analysis process.
                 Create a comprehensive, helpful response based on the findings from multiple iterations of analysis.""",
             },
             {
@@ -1679,7 +1679,7 @@ Results from {len(iterations)} iterations:
 Insights achieved:
 {chr(10).join(all_insights[:5]) if all_insights else "No specific insights achieved"}
 
-Please provide a comprehensive response to the original query based on these findings. If the findings are limited, 
+Please provide a comprehensive response to the original query based on these findings. If the findings are limited,
 provide your best analysis of the query directly.""",
             },
         ]