kailash 0.9.7__py3-none-any.whl → 0.9.9__py3-none-any.whl

kailash/__init__.py

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

kailash/nodes/ai/iterative_llm_agent.py

@@ -94,41 +94,37 @@ class IterativeLLMAgentNode(LLMAgentNode):
     Key Features:
     - Progressive MCP discovery without pre-configuration
     - 6-phase iterative process (Discovery → Planning → Execution → Reflection → Convergence → Synthesis)
-    - **Real MCP tool execution** - Calls actual MCP tools instead of mock execution
+    - Real MCP tool execution with fallback to LLM capabilities
     - Semantic tool understanding and capability mapping
     - Adaptive strategy based on iteration results
     - Smart convergence criteria and resource management
-    - Configurable execution modes (real MCP vs mock for testing)
 
     Examples:
-        >>> # Basic iterative agent with real MCP execution
+        >>> # Basic iterative agent execution
         >>> agent = IterativeLLMAgentNode()
         >>> result = agent.execute(
         ...     messages=[{"role": "user", "content": "Find and analyze healthcare AI trends"}],
         ...     mcp_servers=["http://localhost:8080"],
-        ...     max_iterations=3,
-        ...     use_real_mcp=True  # Enables real MCP tool execution
+        ...     max_iterations=3
         ... )
 
-        >>> # Advanced iterative agent with custom convergence and real MCP
+        >>> # Advanced iterative agent with custom convergence
         >>> result = agent.execute(
         ...     messages=[{"role": "user", "content": "Research and recommend AI implementation strategy"}],
         ...     mcp_servers=["http://ai-registry:8080", "http://knowledge-base:8081"],
         ...     max_iterations=5,
         ...     discovery_mode="semantic",
-        ...     use_real_mcp=True,  # Use real MCP tools
         ...     convergence_criteria={
         ...         "goal_satisfaction": {"threshold": 0.9},
         ...         "diminishing_returns": {"min_improvement": 0.1}
         ...     }
         ... )
 
-        >>> # Test mode with mock execution for development
+        >>> # Simple execution example
         >>> result = agent.execute(
         ...     messages=[{"role": "user", "content": "Test query"}],
         ...     mcp_servers=["http://localhost:8080"],
-        ...     max_iterations=2,
-        ...     use_real_mcp=False  # Uses mock execution for testing
+        ...     max_iterations=2
         ... )
     """
 
@@ -232,18 +228,16 @@ class IterativeLLMAgentNode(LLMAgentNode):
                 default=300,
                 description="Timeout for each iteration in seconds",
             ),
-            # MCP Execution Control
-            "use_real_mcp": NodeParameter(
-                name="use_real_mcp",
-                type=bool,
-                required=False,
-                default=True,
-                description="Use real MCP tool execution instead of mock execution",
-            ),
         }
 
         # Merge base parameters with iterative parameters
         base_params.update(iterative_params)
+
+        # Remove deprecated mock-related parameters since this node always uses real execution
+        deprecated_params = ["use_real_mcp", "mock_mode"]
+        for param_name in deprecated_params:
+            base_params.pop(param_name, None)
+
         return base_params
 
     def run(self, **kwargs) -> dict[str, Any]:
@@ -582,7 +576,7 @@ class IterativeLLMAgentNode(LLMAgentNode):
         self, server_config: Any, budget: dict[str, Any]
     ) -> list[dict[str, Any]]:
         """Discover resources from a specific MCP server."""
-        # Mock implementation - in real version would use MCP resource discovery
+        # Default implementation - provides basic resource discovery
         try:
             server_id = (
                 server_config
@@ -591,8 +585,8 @@ class IterativeLLMAgentNode(LLMAgentNode):
             )
             max_resources = budget.get("max_resources", 50)
 
-            # Mock discovered resources
-            mock_resources = [
+            # Default discovered resources
+            default_resources = [
                 {
                     "uri": f"{server_id}/resource/data/overview",
                     "name": "Data Overview",
@@ -607,7 +601,7 @@ class IterativeLLMAgentNode(LLMAgentNode):
                 },
             ]
 
-            return mock_resources[:max_resources]
+            return default_resources[:max_resources]
 
         except Exception as e:
             self.logger.debug(f"Resource discovery failed: {e}")
@@ -669,7 +663,7 @@ class IterativeLLMAgentNode(LLMAgentNode):
             domain=domain,
             complexity=complexity,
             dependencies=[],
-            confidence=0.8,  # Mock confidence
+            confidence=0.8,  # Default confidence estimate
             server_source=server_id,
         )
 
@@ -779,9 +773,6 @@ class IterativeLLMAgentNode(LLMAgentNode):
             "errors": [],
         }
 
-        # Check if we should use real MCP tool execution
-        use_real_mcp = kwargs.get("use_real_mcp", True)
-
         # Handle direct LLM response mode
         if plan.get("planning_mode") == "direct_llm":
             try:
@@ -828,21 +819,11 @@ class IterativeLLMAgentNode(LLMAgentNode):
             tools = step.get("tools", [])
 
             try:
-                if use_real_mcp and tools:
+                if tools:
                     # Real MCP tool execution
                     step_result = self._execute_tools_with_mcp(
                         step_num, action, tools, discoveries, kwargs
                     )
-                elif tools:
-                    # Mock tool execution for backward compatibility
-                    step_result = {
-                        "step": step_num,
-                        "action": action,
-                        "tools_used": tools,
-                        "output": f"Mock execution result for {action} using tools: {', '.join(tools)}",
-                        "success": True,
-                        "duration": 1.5,
-                    }
                 else:
                     # No tools available, try direct LLM call for this step
                     self.logger.info(
@@ -1814,7 +1795,7 @@ provide your best analysis of the query directly.""",
             "total_tools_used": total_tools_used,
             "total_api_calls": total_api_calls,
             "average_iteration_time": total_duration / max(len(iterations), 1),
-            "estimated_cost_usd": total_api_calls * 0.01,  # Mock cost calculation
+            "estimated_cost_usd": total_api_calls * 0.01,  # Simple cost estimation
         }
 
     def _phase_convergence_with_mode(

kailash/nodes/base.py

@@ -216,17 +216,58 @@ class Node(ABC):
             )
             self.logger = logging.getLogger(f"kailash.nodes.{self.id}")
 
-            # Filter out internal fields from config
-            internal_fields = {
+            # Filter out internal fields from config with comprehensive parameter handling
+            # Get parameter definitions once and cache for both filtering and validation
+            try:
+                if not hasattr(self, "_temp_param_definitions"):
+                    self._temp_param_definitions = self.get_parameters()
+                defined_params = set(self._temp_param_definitions.keys())
+            except Exception as e:
+                # If get_parameters() fails, log but continue with safe defaults
+                self.logger.debug(
+                    f"Could not get parameter definitions during init: {e}"
+                )
+                defined_params = set()
+                self._temp_param_definitions = {}
+
+            # Comprehensive parameter filtering: handle ALL potential conflicts
+            # Fields that are always internal (never user parameters)
+            always_internal = {"metadata"}
+
+            # Fields that can be either internal or user parameters
+            potentially_user_params = {
                 "id",
                 "name",
                 "description",
                 "version",
                 "author",
                 "tags",
-                "metadata",
             }
-            self.config = {k: v for k, v in kwargs.items() if k not in internal_fields}
+
+            # Build dynamic filter list based on user-defined parameters
+            internal_fields = always_internal.copy()
+            for field in potentially_user_params:
+                if field not in defined_params:
+                    # Field is not user-defined, so treat as internal field
+                    internal_fields.add(field)
+                # If field IS user-defined, don't add to internal_fields (preserve it)
+
+            # Also filter any field that starts with metadata prefix or other internal patterns
+            # This handles cases like 'metadata_name', 'metadata_*', etc.
+            def is_internal_field(field_name: str) -> bool:
+                # Check if it's in our explicit internal fields list
+                if field_name in internal_fields:
+                    return True
+                # Check for metadata-related field patterns
+                if field_name.startswith("metadata_"):
+                    return True
+                # Check for other internal patterns
+                if field_name.startswith("_"):  # Private fields
+                    return True
+                return False
+
+            # Apply comprehensive filtering
+            self.config = {k: v for k, v in kwargs.items() if not is_internal_field(k)}
 
             # Parameter resolution cache - initialize before validation
             cache_size = int(
@@ -554,11 +595,23 @@ class Node(ABC):
         return bool(re.match(r"^\$\{[^}]+\}$", value))
 
     def _get_cached_parameters(self) -> dict[str, NodeParameter]:
-        """Get cached parameter definitions.
+        """Get cached parameter definitions with optimal performance.
+
+        Uses parameters cached during initialization to avoid duplicate get_parameters() calls.
 
         Returns:
             Dictionary of parameter definitions, cached for performance
         """
+        # First check if we have parameters cached from initialization
+        if hasattr(self, "_temp_param_definitions") and self._temp_param_definitions:
+            # Use cached parameters from init and clean up temporary cache
+            if self._cached_params is None:
+                self._cached_params = self._temp_param_definitions
+                # Clean up temporary cache to free memory
+                delattr(self, "_temp_param_definitions")
+            return self._cached_params
+
+        # Fallback to original behavior if no cached parameters from init
         if self._cached_params is None:
             try:
                 self._cached_params = self.get_parameters()

{kailash-0.9.7.dist-info → kailash-0.9.9.dist-info}/METADATA

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

{kailash-0.9.7.dist-info → kailash-0.9.9.dist-info}/RECORD

@@ -1,4 +1,4 @@
-kailash/__init__.py,sha256=E3eRrjccUAH1875857yUosDh9qAHt-Inu_Q383PARDA,2771
+kailash/__init__.py,sha256=FUBzXZ35fF3M-aPSgCf_FFdhXfG8KWO_ymwnSP78xgI,2771
 kailash/__main__.py,sha256=vr7TVE5o16V6LsTmRFKG6RDKUXHpIWYdZ6Dok2HkHnI,198
 kailash/access_control.py,sha256=MjKtkoQ2sg1Mgfe7ovGxVwhAbpJKvaepPWr8dxOueMA,26058
 kailash/access_control_abac.py,sha256=FPfa_8PuDP3AxTjdWfiH3ntwWO8NodA0py9W8SE5dno,30263
@@ -140,7 +140,7 @@ kailash/monitoring/__init__.py,sha256=C5WmkNpk_mmAScqMWiCfkUbjhM5W16dsnRnc3Ial-U
 kailash/monitoring/alerts.py,sha256=eKX4ooPw1EicumPuswlR_nU18UgRETWvFg8FzCW5pVU,21416
 kailash/monitoring/metrics.py,sha256=SiAnL3o6K0QaJHgfAuWBa-0pTkW5zymhuPEsj4bgOgM,22022
 kailash/nodes/__init__.py,sha256=p2KSo0dyUBCLClU123qpQ0tyv5S_36PTxosNyW58nyY,1031
-kailash/nodes/base.py,sha256=3KPCp2PDLCPGm4VHSHt8QSONLTX9y3UhQ-3ldQf4oUg,82623
+kailash/nodes/base.py,sha256=GR2E1fWf8j1yMvJic7m2NAih7kjY1NtoDi47hHwoZ40,85437
 kailash/nodes/base_async.py,sha256=whxepCiVplrltfzEQuabmnGCpEV5WgfqwgxbLdCyiDk,8864
 kailash/nodes/base_cycle_aware.py,sha256=Xpze9xZzLepWeLpi9Y3tMn1dm2LVv-omr5TSQuGTtWo,13377
 kailash/nodes/base_with_acl.py,sha256=ZfrkLPgrEBcNbG0LKvtq6glDxyOYOMRw3VXX4vWX6bI,11852
@@ -166,7 +166,7 @@ kailash/nodes/ai/ai_providers.py,sha256=egfiOZzPmZ10d3wBCJ6ST4tRFrrtq0kt1VyCqxVp
 kailash/nodes/ai/embedding_generator.py,sha256=akGCzz7zLRSziqEQCiPwL2qWhRWxuM_1RQh-YtVEddw,31879
 kailash/nodes/ai/hybrid_search.py,sha256=k26uDDP_bwrIpv7Yl7PBCPvWSyQEmTlBjI1IpbgDsO4,35446
 kailash/nodes/ai/intelligent_agent_orchestrator.py,sha256=LvBqMKc64zSxFWVCjbLKKel2QwEzoTeJAEgna7rZw00,83097
-kailash/nodes/ai/iterative_llm_agent.py,sha256=G6pQnvSJcMBxloBvLBletFdiIRZGntNaMaVx2no0igY,101273
+kailash/nodes/ai/iterative_llm_agent.py,sha256=Q_letP5mHtO225LBX0Tq5GlPkXkk-yWf3oFEOJTP6Z0,100289
 kailash/nodes/ai/llm_agent.py,sha256=NeNJZbV_VOUbULug2LASwyzLyoUO5wi58Bc9sXTubuc,90181
 kailash/nodes/ai/models.py,sha256=wsEeUTuegy87mnLtKgSTg7ggCXvC1n3MsL-iZ4qujHs,16393
 kailash/nodes/ai/self_organizing.py,sha256=B7NwKaBW8OHQBf5b0F9bSs8Wm-5BDJ9IjIkxS9h00mg,62885
@@ -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.7.dist-info/licenses/LICENSE,sha256=Axe6g7bTrJkToK9h9j2SpRUKKNaDZDCo2lQ2zPxCE6s,1065
-kailash-0.9.7.dist-info/METADATA,sha256=yo7vzKt8ikuCZCQBcsJeDPMm8VRW421kg8-U64whL0w,22298
-kailash-0.9.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-kailash-0.9.7.dist-info/entry_points.txt,sha256=M_q3b8PG5W4XbhSgESzIJjh3_4OBKtZFYFsOdkr2vO4,45
-kailash-0.9.7.dist-info/top_level.txt,sha256=z7GzH2mxl66498pVf5HKwo5wwfPtt9Aq95uZUpH6JV0,8
-kailash-0.9.7.dist-info/RECORD,,
+kailash-0.9.9.dist-info/licenses/LICENSE,sha256=Axe6g7bTrJkToK9h9j2SpRUKKNaDZDCo2lQ2zPxCE6s,1065
+kailash-0.9.9.dist-info/METADATA,sha256=MR4Ore7NAIr_V4yKTpwxqL4EVyoFMjO2hlYZRReAigQ,22298
+kailash-0.9.9.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+kailash-0.9.9.dist-info/entry_points.txt,sha256=M_q3b8PG5W4XbhSgESzIJjh3_4OBKtZFYFsOdkr2vO4,45
+kailash-0.9.9.dist-info/top_level.txt,sha256=z7GzH2mxl66498pVf5HKwo5wwfPtt9Aq95uZUpH6JV0,8
+kailash-0.9.9.dist-info/RECORD,,