OpenRAG is a comprehensive, single package Retrieval-Augmented Generation platform built on Langflow, Docling, and Opensearch.
Python
fix: pass parameters as global variable headers to MCP server on agent flow (#1479)
Lucas Oliveirab2b4de38f7ca
diff --git a/flows/openrag_agent.json b/flows/openrag_agent.jsonindex c5d9b7b66..d5c5689c5 100644--- a/flows/openrag_agent.json+++ b/flows/openrag_agent.json@@ -1,34 +1,6 @@{"data": {"edges": [- {- "animated": false,- "className": "",- "data": {- "sourceHandle": {- "dataType": "MCP",- "id": "MCP-7EY21",- "name": "component_as_tool",- "output_types": [- "Tool"- ]- },- "targetHandle": {- "fieldName": "tools",- "id": "Agent-Nfw7u",- "inputTypes": [- "Tool"- ],- "type": "other"- }- },- "id": "xy-edge__MCP-7EY21{œdataTypeœ:œMCPœ,œidœ:œMCP-7EY21œ,œnameœ:œcomponent_as_toolœ,œoutput_typesœ:[œToolœ]}-Agent-Nfw7u{œfieldNameœ:œtoolsœ,œidœ:œAgent-Nfw7uœ,œinputTypesœ:[œToolœ],œtypeœ:œotherœ}",- "selected": false,- "source": "MCP-7EY21",- "sourceHandle": "{œdataTypeœ:œMCPœ,œidœ:œMCP-7EY21œ,œnameœ:œcomponent_as_toolœ,œoutput_typesœ:[œToolœ]}",- "target": "Agent-Nfw7u",- "targetHandle": "{œfieldNameœ:œtoolsœ,œidœ:œAgent-Nfw7uœ,œinputTypesœ:[œToolœ],œtypeœ:œotherœ}"- },{"animated": false,"className": "",@@ -312,88 +284,128 @@"sourceHandle": "{œdataTypeœ:œOpenSearchVectorStoreComponentMultimodalMultiEmbeddingœ,œidœ:œOpenSearchVectorStoreComponentMultimodalMultiEmbedding-TyvvEœ,œnameœ:œcomponent_as_toolœ,œoutput_typesœ:[œToolœ]}","target": "Agent-Nfw7u","targetHandle": "{œfieldNameœ:œtoolsœ,œidœ:œAgent-Nfw7uœ,œinputTypesœ:[œToolœ],œtypeœ:œotherœ}"+ },+ {+ "data": {+ "sourceHandle": {+ "dataType": "MCPTools",+ "id": "MCPTools-uu7m3",+ "name": "component_as_tool",+ "output_types": [+ "Tool"+ ]+ },+ "targetHandle": {+ "fieldName": "tools",+ "id": "Agent-Nfw7u",+ "inputTypes": [+ "Tool"+ ],+ "type": "other"+ }+ },+ "id": "xy-edge__MCPTools-uu7m3{œdataTypeœ:œMCPToolsœ,œidœ:œMCPTools-uu7m3œ,œnameœ:œcomponent_as_toolœ,œoutput_typesœ:[œToolœ]}-Agent-Nfw7u{œfieldNameœ:œtoolsœ,œidœ:œAgent-Nfw7uœ,œinputTypesœ:[œToolœ],œtypeœ:œotherœ}",+ "source": "MCPTools-uu7m3",+ "sourceHandle": "{œdataTypeœ:œMCPToolsœ,œidœ:œMCPTools-uu7m3œ,œnameœ:œcomponent_as_toolœ,œoutput_typesœ:[œToolœ]}",+ "target": "Agent-Nfw7u",+ "targetHandle": "{œfieldNameœ:œtoolsœ,œidœ:œAgent-Nfw7uœ,œinputTypesœ:[œToolœ],œtypeœ:œotherœ}"}],"nodes": [{"data": {- "id": "MCP-7EY21",+ "id": "note-Wg9xF",+ "node": {+ "description": "## README\n\nThis flow generates answers for OpenRAG's chat, informed by the context stored in OpenSearch.\nIn this flow, the [**Langflow Agent** component](https://docs.langflow.org/agents) uses the connected [**Language Model** component](https://docs.langflow.org/components-models) to select the correct tool to complete requests.\n* If the Agent determines your request requires external knowledge, it will embed your query with the [**Embedding Model** component](https://docs.langflow.org/components-embedding-models) and query your [OpenSearch knowledge](https://docs.openr.ag/knowledge).\n\n* If the Agent determines your request requires a web search, it selects the [**MCP Tools** component](https://docs.langflow.org/mcp-client#mcp-tools-parameters) to fetch web content with the [OpenSearch URL ingestion flow](https://docs.openr.ag/ingestion#url-flow).\n\nUsing the retrieved data, the Agent generates a response with the connected [**Language Model** component](https://docs.langflow.org/components-models) and sends it to the [**Chat Output** component](https://docs.langflow.org/components-io).\n\nFor more information, see the [OpenRAG docs](https://docs.openr.ag/agents).",+ "display_name": "",+ "documentation": "",+ "template": {+ "backgroundColor": "amber"+ }+ },+ "type": "note"+ },+ "dragging": false,+ "height": 469,+ "id": "note-Wg9xF",+ "measured": {+ "height": 469,+ "width": 644+ },+ "position": {+ "x": 226.5754607766575,+ "y": 730.679898631438+ },+ "resizing": false,+ "selected": false,+ "type": "noteNode",+ "width": 644+ },+ {+ "data": {+ "description": "Get chat inputs from the Playground.",+ "display_name": "Chat Input",+ "id": "ChatInput-ci8VE","node": {"base_classes": [- "DataFrame"+ "Message"],"beta": false,- "category": "MCP","conditional_paths": [],"custom_fields": {},- "description": "Connect to an MCP server to use its tools.",- "display_name": "MCP Tools",- "documentation": "https://docs.langflow.org/mcp-client",+ "description": "Get chat inputs from the Playground.",+ "display_name": "Chat Input",+ "documentation": "https://docs.langflow.org/chat-input-and-output","edited": false,"field_order": [- "mcp_server",- "use_cache",- "tool",- "tool_placeholder"+ "input_value",+ "should_store_message",+ "sender",+ "sender_name",+ "session_id",+ "context_id",+ "files"],"frozen": false,- "icon": "Mcp",- "key": "mcp_lf-starter_project",- "last_updated": "2026-04-17T22:36:46.312Z",+ "icon": "MessagesSquare","legacy": false,"lf_version": "1.9.0",- "mcpServerName": "lf-starter_project","metadata": {- "code_hash": "756d1e10d0ca",+ "code_hash": "7a26c54d89ed","dependencies": {"dependencies": [- {- "name": "langchain_core",- "version": "0.3.77"- },{"name": "lfx","version": null- },- {- "name": "langflow",- "version": null}],- "total_dependencies": 3+ "total_dependencies": 1},- "module": "lfx.components.agents.mcp_component.MCPToolsComponent"+ "module": "custom_components.chat_input"},- "minimized": false,+ "minimized": true,"output_types": [],"outputs": [{"allows_loop": false,"cache": true,- "display_name": "Toolset",+ "display_name": "Chat Message","group_outputs": false,- "hidden": null,"loop_types": null,- "method": "to_toolkit",- "name": "component_as_tool",+ "method": "message_response",+ "name": "message","options": null,"required_inputs": null,- "selected": "Tool",+ "selected": "Message","tool_mode": true,"types": [- "Tool"+ "Message"],"value": "__UNDEFINED__"}],"pinned": false,"template": {- "_frontend_node_flow_id": {- "value": "1098eea1-6649-4e1d-aed1-b77249fb8dd0"- },- "_frontend_node_folder_id": {- "value": "79f95013-41e9-4a4f-af49-f07ec1fac77a"- },"_type": "Component","code": {"advanced": true,@@ -411,195 +423,227 @@"show": true,"title_case": false,"type": "code",- "value": "from __future__ import annotations\n\nimport asyncio\nimport uuid\nfrom typing import Any\n\nfrom langchain_core.tools import StructuredTool # noqa: TC002\n\nfrom lfx.base.agents.utils import maybe_unflatten_dict, safe_cache_get, safe_cache_set\nfrom lfx.base.mcp.util import MCPSseClient, MCPStdioClient, create_input_schema_from_json_schema, update_tools\nfrom lfx.custom.custom_component.component_with_cache import ComponentWithCache\nfrom lfx.inputs.inputs import InputTypes # noqa: TC001\nfrom lfx.io import BoolInput, DropdownInput, McpInput, MessageTextInput, Output\nfrom lfx.io.schema import flatten_schema, schema_to_langflow_inputs\nfrom lfx.log.logger import logger\nfrom lfx.schema.dataframe import DataFrame\nfrom lfx.schema.message import Message\nfrom lfx.services.deps import get_settings_service, get_storage_service, session_scope\n\n\nclass MCPToolsComponent(ComponentWithCache):\n schema_inputs: list = []\n tools: list[StructuredTool] = []\n _not_load_actions: bool = False\n _tool_cache: dict = {}\n _last_selected_server: str | None = None # Cache for the last selected server\n\n def __init__(self, **data) -> None:\n super().__init__(**data)\n # Initialize cache keys to avoid CacheMiss when accessing them\n self._ensure_cache_structure()\n\n # Initialize clients with access to the component cache\n self.stdio_client: MCPStdioClient = MCPStdioClient(component_cache=self._shared_component_cache)\n self.sse_client: MCPSseClient = MCPSseClient(component_cache=self._shared_component_cache)\n\n def _ensure_cache_structure(self):\n \"\"\"Ensure the cache has the required structure.\"\"\"\n # Check if servers key exists and is not CacheMiss\n servers_value = safe_cache_get(self._shared_component_cache, \"servers\")\n if servers_value is None:\n safe_cache_set(self._shared_component_cache, \"servers\", {})\n\n # Check if last_selected_server key exists and is not CacheMiss\n last_server_value = safe_cache_get(self._shared_component_cache, \"last_selected_server\")\n if last_server_value is None:\n safe_cache_set(self._shared_component_cache, \"last_selected_server\", \"\")\n\n default_keys: list[str] = [\n \"code\",\n \"_type\",\n \"tool_mode\",\n \"tool_placeholder\",\n \"mcp_server\",\n \"tool\",\n \"use_cache\",\n ]\n\n display_name = \"MCP Tools\"\n description = \"Connect to an MCP server to use its tools.\"\n documentation: str = \"https://docs.langflow.org/mcp-client\"\n icon = \"Mcp\"\n name = \"MCPTools\"\n\n inputs = [\n McpInput(\n name=\"mcp_server\",\n display_name=\"MCP Server\",\n info=\"Select the MCP Server that will be used by this component\",\n real_time_refresh=True,\n ),\n BoolInput(\n name=\"use_cache\",\n display_name=\"Use Cached Server\",\n info=(\n \"Enable caching of MCP Server and tools to improve performance. \"\n \"Disable to always fetch fresh tools and server updates.\"\n ),\n value=False,\n advanced=True,\n ),\n DropdownInput(\n name=\"tool\",\n display_name=\"Tool\",\n options=[],\n value=\"\",\n info=\"Select the tool to execute\",\n show=False,\n required=True,\n real_time_refresh=True,\n ),\n MessageTextInput(\n name=\"tool_placeholder\",\n display_name=\"Tool Placeholder\",\n info=\"Placeholder for the tool\",\n value=\"\",\n show=False,\n tool_mode=False,\n ),\n ]\n\n outputs = [\n Output(display_name=\"Response\", name=\"response\", method=\"build_output\"),\n ]\n\n async def _validate_schema_inputs(self, tool_obj) -> list[InputTypes]:\n \"\"\"Validate and process schema inputs for a tool.\"\"\"\n try:\n if not tool_obj or not hasattr(tool_obj, \"args_schema\"):\n msg = \"Invalid tool object or missing input schema\"\n raise ValueError(msg)\n\n flat_schema = flatten_schema(tool_obj.args_schema.schema())\n input_schema = create_input_schema_from_json_schema(flat_schema)\n if not input_schema:\n msg = f\"Empty input schema for tool '{tool_obj.name}'\"\n raise ValueError(msg)\n\n schema_inputs = schema_to_langflow_inputs(input_schema)\n if not schema_inputs:\n msg = f\"No input parameters defined for tool '{tool_obj.name}'\"\n await logger.awarning(msg)\n return []\n\n except Exception as e:\n msg = f\"Error validating schema inputs: {e!s}\"\n await logger.aexception(msg)\n raise ValueError(msg) from e\n else:\n return schema_inputs\n\n async def update_tool_list(self, mcp_server_value=None):\n # Accepts mcp_server_value as dict {name, config} or uses self.mcp_server\n mcp_server = mcp_server_value if mcp_server_value is not None else getattr(self, \"mcp_server\", None)\n server_name = None\n server_config_from_value = None\n if isinstance(mcp_server, dict):\n server_name = mcp_server.get(\"name\")\n server_config_from_value = mcp_server.get(\"config\")\n else:\n server_name = mcp_server\n if not server_name:\n self.tools = []\n return [], {\"name\": server_name, \"config\": server_config_from_value}\n\n # Check if caching is enabled, default to False\n use_cache = getattr(self, \"use_cache\", False)\n\n # Use shared cache if available and caching is enabled\n cached = None\n if use_cache:\n servers_cache = safe_cache_get(self._shared_component_cache, \"servers\", {})\n cached = servers_cache.get(server_name) if isinstance(servers_cache, dict) else None\n\n if cached is not None:\n try:\n self.tools = cached[\"tools\"]\n self.tool_names = cached[\"tool_names\"]\n self._tool_cache = cached[\"tool_cache\"]\n server_config_from_value = cached[\"config\"]\n except (TypeError, KeyError, AttributeError) as e:\n # Handle corrupted cache data by clearing it and continuing to fetch fresh tools\n msg = f\"Unable to use cached data for MCP Server{server_name}: {e}\"\n await logger.awarning(msg)\n # Clear the corrupted cache entry\n current_servers_cache = safe_cache_get(self._shared_component_cache, \"servers\", {})\n if isinstance(current_servers_cache, dict) and server_name in current_servers_cache:\n current_servers_cache.pop(server_name)\n safe_cache_set(self._shared_component_cache, \"servers\", current_servers_cache)\n else:\n return self.tools, {\"name\": server_name, \"config\": server_config_from_value}\n\n try:\n try:\n from langflow.api.v2.mcp import get_server\n from langflow.services.database.models.user.crud import get_user_by_id\n except ImportError as e:\n msg = (\n \"Langflow MCP server functionality is not available. \"\n \"This feature requires the full Langflow installation.\"\n )\n raise ImportError(msg) from e\n async with session_scope() as db:\n if not self.user_id:\n msg = \"User ID is required for fetching MCP tools.\"\n raise ValueError(msg)\n current_user = await get_user_by_id(db, self.user_id)\n\n # Try to get server config from DB/API\n server_config = await get_server(\n server_name,\n current_user,\n db,\n storage_service=get_storage_service(),\n settings_service=get_settings_service(),\n )\n\n # If get_server returns empty but we have a config, use it\n if not server_config and server_config_from_value:\n server_config = server_config_from_value\n\n if not server_config:\n self.tools = []\n return [], {\"name\": server_name, \"config\": server_config}\n\n _, tool_list, tool_cache = await update_tools(\n server_name=server_name,\n server_config=server_config,\n mcp_stdio_client=self.stdio_client,\n mcp_sse_client=self.sse_client,\n )\n\n self.tool_names = [tool.name for tool in tool_list if hasattr(tool, \"name\")]\n self._tool_cache = tool_cache\n self.tools = tool_list\n\n # Cache the result only if caching is enabled\n if use_cache:\n cache_data = {\n \"tools\": tool_list,\n \"tool_names\": self.tool_names,\n \"tool_cache\": tool_cache,\n \"config\": server_config,\n }\n\n # Safely update the servers cache\n current_servers_cache = safe_cache_get(self._shared_component_cache, \"servers\", {})\n if isinstance(current_servers_cache, dict):\n current_servers_cache[server_name] = cache_data\n safe_cache_set(self._shared_component_cache, \"servers\", current_servers_cache)\n\n except (TimeoutError, asyncio.TimeoutError) as e:\n msg = f\"Timeout updating tool list: {e!s}\"\n await logger.aexception(msg)\n raise TimeoutError(msg) from e\n except Exception as e:\n msg = f\"Error updating tool list: {e!s}\"\n await logger.aexception(msg)\n raise ValueError(msg) from e\n else:\n return tool_list, {\"name\": server_name, \"config\": server_config}\n\n async def update_build_config(self, build_config: dict, field_value: str, field_name: str | None = None) -> dict:\n \"\"\"Toggle the visibility of connection-specific fields based on the selected mode.\"\"\"\n try:\n if field_name == \"tool\":\n try:\n if len(self.tools) == 0:\n try:\n self.tools, build_config[\"mcp_server\"][\"value\"] = await self.update_tool_list()\n build_config[\"tool\"][\"options\"] = [tool.name for tool in self.tools]\n build_config[\"tool\"][\"placeholder\"] = \"Select a tool\"\n except (TimeoutError, asyncio.TimeoutError) as e:\n msg = f\"Timeout updating tool list: {e!s}\"\n await logger.aexception(msg)\n if not build_config[\"tools_metadata\"][\"show\"]:\n build_config[\"tool\"][\"show\"] = True\n build_config[\"tool\"][\"options\"] = []\n build_config[\"tool\"][\"value\"] = \"\"\n build_config[\"tool\"][\"placeholder\"] = \"Timeout on MCP server\"\n else:\n build_config[\"tool\"][\"show\"] = False\n except ValueError:\n if not build_config[\"tools_metadata\"][\"show\"]:\n build_config[\"tool\"][\"show\"] = True\n build_config[\"tool\"][\"options\"] = []\n build_config[\"tool\"][\"value\"] = \"\"\n build_config[\"tool\"][\"placeholder\"] = \"Error on MCP Server\"\n else:\n build_config[\"tool\"][\"show\"] = False\n\n if field_value == \"\":\n return build_config\n tool_obj = None\n for tool in self.tools:\n if tool.name == field_value:\n tool_obj = tool\n break\n if tool_obj is None:\n msg = f\"Tool {field_value} not found in available tools: {self.tools}\"\n await logger.awarning(msg)\n return build_config\n await self._update_tool_config(build_config, field_value)\n except Exception as e:\n build_config[\"tool\"][\"options\"] = []\n msg = f\"Failed to update tools: {e!s}\"\n raise ValueError(msg) from e\n else:\n return build_config\n elif field_name == \"mcp_server\":\n if not field_value:\n build_config[\"tool\"][\"show\"] = False\n build_config[\"tool\"][\"options\"] = []\n build_config[\"tool\"][\"value\"] = \"\"\n build_config[\"tool\"][\"placeholder\"] = \"\"\n build_config[\"tool_placeholder\"][\"tool_mode\"] = False\n self.remove_non_default_keys(build_config)\n return build_config\n\n build_config[\"tool_placeholder\"][\"tool_mode\"] = True\n\n current_server_name = field_value.get(\"name\") if isinstance(field_value, dict) else field_value\n _last_selected_server = safe_cache_get(self._shared_component_cache, \"last_selected_server\", \"\")\n\n # To avoid unnecessary updates, only proceed if the server has actually changed\n if (_last_selected_server in (current_server_name, \"\")) and build_config[\"tool\"][\"show\"]:\n if current_server_name:\n servers_cache = safe_cache_get(self._shared_component_cache, \"servers\", {})\n if isinstance(servers_cache, dict):\n cached = servers_cache.get(current_server_name)\n if cached is not None and cached.get(\"tool_names\"):\n cached_tools = cached[\"tool_names\"]\n current_tools = build_config[\"tool\"][\"options\"]\n if current_tools == cached_tools:\n return build_config\n else:\n return build_config\n\n # Determine if \"Tool Mode\" is active by checking if the tool dropdown is hidden.\n is_in_tool_mode = build_config[\"tools_metadata\"][\"show\"]\n safe_cache_set(self._shared_component_cache, \"last_selected_server\", current_server_name)\n\n # Check if tools are already cached for this server before clearing\n cached_tools = None\n if current_server_name:\n use_cache = getattr(self, \"use_cache\", True)\n if use_cache:\n servers_cache = safe_cache_get(self._shared_component_cache, \"servers\", {})\n if isinstance(servers_cache, dict):\n cached = servers_cache.get(current_server_name)\n if cached is not None:\n try:\n cached_tools = cached[\"tools\"]\n self.tools = cached_tools\n self.tool_names = cached[\"tool_names\"]\n self._tool_cache = cached[\"tool_cache\"]\n except (TypeError, KeyError, AttributeError) as e:\n # Handle corrupted cache data by ignoring it\n msg = f\"Unable to use cached data for MCP Server,{current_server_name}: {e}\"\n await logger.awarning(msg)\n cached_tools = None\n\n # Only clear tools if we don't have cached tools for the current server\n if not cached_tools:\n self.tools = [] # Clear previous tools only if no cache\n\n self.remove_non_default_keys(build_config) # Clear previous tool inputs\n\n # Only show the tool dropdown if not in tool_mode\n if not is_in_tool_mode:\n build_config[\"tool\"][\"show\"] = True\n if cached_tools:\n # Use cached tools to populate options immediately\n build_config[\"tool\"][\"options\"] = [tool.name for tool in cached_tools]\n build_config[\"tool\"][\"placeholder\"] = \"Select a tool\"\n else:\n # Show loading state only when we need to fetch tools\n build_config[\"tool\"][\"placeholder\"] = \"Loading tools...\"\n build_config[\"tool\"][\"options\"] = []\n build_config[\"tool\"][\"value\"] = uuid.uuid4()\n else:\n # Keep the tool dropdown hidden if in tool_mode\n self._not_load_actions = True\n build_config[\"tool\"][\"show\"] = False\n\n elif field_name == \"tool_mode\":\n build_config[\"tool\"][\"placeholder\"] = \"\"\n build_config[\"tool\"][\"show\"] = not bool(field_value) and bool(build_config[\"mcp_server\"])\n self.remove_non_default_keys(build_config)\n self.tool = build_config[\"tool\"][\"value\"]\n if field_value:\n self._not_load_actions = True\n else:\n build_config[\"tool\"][\"value\"] = uuid.uuid4()\n build_config[\"tool\"][\"options\"] = []\n build_config[\"tool\"][\"show\"] = True\n build_config[\"tool\"][\"placeholder\"] = \"Loading tools...\"\n elif field_name == \"tools_metadata\":\n self._not_load_actions = False\n\n except Exception as e:\n msg = f\"Error in update_build_config: {e!s}\"\n await logger.aexception(msg)\n raise ValueError(msg) from e\n else:\n return build_config\n\n def get_inputs_for_all_tools(self, tools: list) -> dict:\n \"\"\"Get input schemas for all tools.\"\"\"\n inputs = {}\n for tool in tools:\n if not tool or not hasattr(tool, \"name\"):\n continue\n try:\n flat_schema = flatten_schema(tool.args_schema.schema())\n input_schema = create_input_schema_from_json_schema(flat_schema)\n langflow_inputs = schema_to_langflow_inputs(input_schema)\n inputs[tool.name] = langflow_inputs\n except (AttributeError, ValueError, TypeError, KeyError) as e:\n msg = f\"Error getting inputs for tool {getattr(tool, 'name', 'unknown')}: {e!s}\"\n logger.exception(msg)\n continue\n return inputs\n\n def remove_input_schema_from_build_config(\n self, build_config: dict, tool_name: str, input_schema: dict[list[InputTypes], Any]\n ):\n \"\"\"Remove the input schema for the tool from the build config.\"\"\"\n # Keep only schemas that don't belong to the current tool\n input_schema = {k: v for k, v in input_schema.items() if k != tool_name}\n # Remove all inputs from other tools\n for value in input_schema.values():\n for _input in value:\n if _input.name in build_config:\n build_config.pop(_input.name)\n\n def remove_non_default_keys(self, build_config: dict) -> None:\n \"\"\"Remove non-default keys from the build config.\"\"\"\n for key in list(build_config.keys()):\n if key not in self.default_keys:\n build_config.pop(key)\n\n async def _update_tool_config(self, build_config: dict, tool_name: str) -> None:\n \"\"\"Update tool configuration with proper error handling.\"\"\"\n if not self.tools:\n self.tools, build_config[\"mcp_server\"][\"value\"] = await self.update_tool_list()\n\n if not tool_name:\n return\n\n tool_obj = next((tool for tool in self.tools if tool.name == tool_name), None)\n if not tool_obj:\n msg = f\"Tool {tool_name} not found in available tools: {self.tools}\"\n self.remove_non_default_keys(build_config)\n build_config[\"tool\"][\"value\"] = \"\"\n await logger.awarning(msg)\n return\n\n try:\n # Store current values before removing inputs\n current_values = {}\n for key, value in build_config.items():\n if key not in self.default_keys and isinstance(value, dict) and \"value\" in value:\n current_values[key] = value[\"value\"]\n\n # Get all tool inputs and remove old ones\n input_schema_for_all_tools = self.get_inputs_for_all_tools(self.tools)\n self.remove_input_schema_from_build_config(build_config, tool_name, input_schema_for_all_tools)\n\n # Get and validate new inputs\n self.schema_inputs = await self._validate_schema_inputs(tool_obj)\n if not self.schema_inputs:\n msg = f\"No input parameters to configure for tool '{tool_name}'\"\n await logger.ainfo(msg)\n return\n\n # Add new inputs to build config\n for schema_input in self.schema_inputs:\n if not schema_input or not hasattr(schema_input, \"name\"):\n msg = \"Invalid schema input detected, skipping\"\n await logger.awarning(msg)\n continue\n\n try:\n name = schema_input.name\n input_dict = schema_input.to_dict()\n input_dict.setdefault(\"value\", None)\n input_dict.setdefault(\"required\", True)\n\n build_config[name] = input_dict\n\n # Preserve existing value if the parameter name exists in current_values\n if name in current_values:\n build_config[name][\"value\"] = current_values[name]\n\n except (AttributeError, KeyError, TypeError) as e:\n msg = f\"Error processing schema input {schema_input}: {e!s}\"\n await logger.aexception(msg)\n continue\n except ValueError as e:\n msg = f\"Schema validation error for tool {tool_name}: {e!s}\"\n await logger.aexception(msg)\n self.schema_inputs = []\n return\n except (AttributeError, KeyError, TypeError) as e:\n msg = f\"Error updating tool config: {e!s}\"\n await logger.aexception(msg)\n raise ValueError(msg) from e\n\n async def build_output(self) -> DataFrame:\n \"\"\"Build output with improved error handling and validation.\"\"\"\n try:\n self.tools, _ = await self.update_tool_list()\n if self.tool != \"\":\n # Set session context for persistent MCP sessions using Langflow session ID\n session_context = self._get_session_context()\n if session_context:\n self.stdio_client.set_session_context(session_context)\n self.sse_client.set_session_context(session_context)\n\n exec_tool = self._tool_cache[self.tool]\n tool_args = self.get_inputs_for_all_tools(self.tools)[self.tool]\n kwargs = {}\n for arg in tool_args:\n value = getattr(self, arg.name, None)\n if value is not None:\n if isinstance(value, Message):\n kwargs[arg.name] = value.text\n else:\n kwargs[arg.name] = value\n\n unflattened_kwargs = maybe_unflatten_dict(kwargs)\n\n output = await exec_tool.coroutine(**unflattened_kwargs)\n\n tool_content = []\n for item in output.content:\n item_dict = item.model_dump()\n tool_content.append(item_dict)\n return DataFrame(data=tool_content)\n return DataFrame(data=[{\"error\": \"You must select a tool\"}])\n except Exception as e:\n msg = f\"Error in build_output: {e!s}\"\n await logger.aexception(msg)\n raise ValueError(msg) from e\n\n def _get_session_context(self) -> str | None:\n \"\"\"Get the Langflow session ID for MCP session caching.\"\"\"\n # Try to get session ID from the component's execution context\n if hasattr(self, \"graph\") and hasattr(self.graph, \"session_id\"):\n session_id = self.graph.session_id\n # Include server name to ensure different servers get different sessions\n server_name = \"\"\n mcp_server = getattr(self, \"mcp_server\", None)\n if isinstance(mcp_server, dict):\n server_name = mcp_server.get(\"name\", \"\")\n elif mcp_server:\n server_name = str(mcp_server)\n return f\"{session_id}_{server_name}\" if session_id else None\n return None\n\n async def _get_tools(self):\n \"\"\"Get cached tools or update if necessary.\"\"\"\n mcp_server = getattr(self, \"mcp_server\", None)\n if not self._not_load_actions:\n tools, _ = await self.update_tool_list(mcp_server)\n return tools\n return []\n"+ "value": "from lfx.base.data.utils import IMG_FILE_TYPES, TEXT_FILE_TYPES\nfrom lfx.base.io.chat import ChatComponent\nfrom lfx.inputs.inputs import BoolInput\nfrom lfx.io import (\n DropdownInput,\n FileInput,\n MessageTextInput,\n MultilineInput,\n Output,\n)\nfrom lfx.schema.message import Message\nfrom lfx.utils.constants import (\n MESSAGE_SENDER_AI,\n MESSAGE_SENDER_NAME_USER,\n MESSAGE_SENDER_USER,\n)\n\n\nclass ChatInput(ChatComponent):\n display_name = \"Chat Input\"\n description = \"Get chat inputs from the Playground.\"\n documentation: str = \"https://docs.langflow.org/chat-input-and-output\"\n icon = \"MessagesSquare\"\n name = \"ChatInput\"\n minimized = True\n\n inputs = [\n MultilineInput(\n name=\"input_value\",\n display_name=\"Input Text\",\n value=\"\",\n info=\"Message to be passed as input.\",\n input_types=[],\n ),\n BoolInput(\n name=\"should_store_message\",\n display_name=\"Store Messages\",\n info=\"Store the message in the history.\",\n value=True,\n advanced=True,\n ),\n DropdownInput(\n name=\"sender\",\n display_name=\"Sender Type\",\n options=[MESSAGE_SENDER_AI, MESSAGE_SENDER_USER],\n value=MESSAGE_SENDER_USER,\n info=\"Type of sender.\",\n advanced=True,\n ),\n MessageTextInput(\n name=\"sender_name\",\n display_name=\"Sender Name\",\n info=\"Name of the sender.\",\n value=MESSAGE_SENDER_NAME_USER,\n advanced=True,\n ),\n MessageTextInput(\n name=\"session_id\",\n display_name=\"Session ID\",\n info=\"The session ID of the chat. If empty, the current session ID parameter will be used.\",\n advanced=True,\n ),\n MessageTextInput(\n name=\"context_id\",\n display_name=\"Context ID\",\n info=\"The context ID of the chat. Adds an extra layer to the local memory.\",\n value=\"\",\n advanced=True,\n ),\n FileInput(\n name=\"files\",\n display_name=\"Files\",\n file_types=TEXT_FILE_TYPES + IMG_FILE_TYPES,\n info=\"Files to be sent with the message.\",\n advanced=True,\n is_list=True,\n temp_file=True,\n ),\n ]\n outputs = [\n Output(display_name=\"Chat Message\", name=\"message\", method=\"message_response\"),\n ]\n\n async def message_response(self) -> Message:\n # Ensure files is a list and filter out empty/None values\n files = self.files if self.files else []\n if files and not isinstance(files, list):\n files = [files]\n # Filter out None/empty values\n files = [f for f in files if f is not None and f != \"\"]\n\n session_id = self.session_id or self.graph.session_id or \"\"\n message = await Message.create(\n text=self.input_value,\n sender=self.sender,\n sender_name=self.sender_name,\n session_id=session_id,\n context_id=self.context_id,\n files=files,\n )\n if session_id and isinstance(message, Message) and self.should_store_message:\n stored_message = await self.send_message(\n message,\n )\n self.message.value = stored_message\n message = stored_message\n\n self.status = message\n return message\n"},- "is_refresh": false,- "mcp_server": {- "_input_type": "McpInput",- "advanced": false,- "display_name": "MCP Server",+ "context_id": {+ "_input_type": "MessageTextInput",+ "advanced": true,+ "display_name": "Context ID","dynamic": false,- "info": "Select the MCP Server that will be used by this component",- "name": "mcp_server",+ "info": "The context ID of the chat. Adds an extra layer to the local memory.",+ "input_types": [+ "Message"+ ],+ "list": false,+ "list_add_label": "Add More",+ "load_from_db": false,+ "name": "context_id",+ "override_skip": false,"placeholder": "",- "real_time_refresh": true,"required": false,"show": true,"title_case": false,+ "tool_mode": false,+ "trace_as_input": true,"trace_as_metadata": true,- "type": "mcp",- "value": {- "config": {},- "name": "lf-starter_project"- }+ "track_in_telemetry": false,+ "type": "str",+ "value": ""},- "tool": {- "_input_type": "DropdownInput",- "advanced": false,- "combobox": false,- "dialog_inputs": {},- "display_name": "Tool",+ "files": {+ "_input_type": "FileInput",+ "advanced": true,+ "display_name": "Files","dynamic": false,- "external_options": {},- "info": "Select the tool to execute",- "name": "tool",- "options": [- "opensearch_url_ingestion_flow"+ "fileTypes": [+ "csv",+ "json",+ "pdf",+ "txt",+ "md",+ "mdx",+ "yaml",+ "yml",+ "xml",+ "html",+ "htm",+ "docx",+ "py",+ "sh",+ "sql",+ "js",+ "ts",+ "tsx",+ "jpg",+ "jpeg",+ "png",+ "bmp",+ "image"],- "options_metadata": [],+ "file_path": "",+ "info": "Files to be sent with the message.",+ "list": true,+ "list_add_label": "Add More",+ "name": "files",+ "override_skip": false,"placeholder": "",- "real_time_refresh": true,- "required": true,- "show": false,+ "required": false,+ "show": true,+ "temp_file": true,"title_case": false,- "toggle": false,"tool_mode": false,"trace_as_metadata": true,- "type": "str",+ "track_in_telemetry": false,+ "type": "file","value": ""},- "tool_placeholder": {- "_input_type": "MessageTextInput",+ "input_value": {+ "_input_type": "MultilineInput","advanced": false,- "display_name": "Tool Placeholder",+ "ai_enabled": false,+ "copy_field": false,+ "display_name": "Input Text","dynamic": false,- "info": "Placeholder for the tool",- "input_types": [- "Message"- ],+ "info": "Message to be passed as input.",+ "input_types": [],"list": false,"list_add_label": "Add More","load_from_db": false,- "name": "tool_placeholder",+ "multiline": true,+ "name": "input_value",+ "override_skip": false,"placeholder": "","required": false,- "show": false,+ "show": true,"title_case": false,- "tool_mode": true,+ "tool_mode": false,"trace_as_input": true,"trace_as_metadata": true,+ "track_in_telemetry": false,"type": "str","value": ""},- "tools_metadata": {- "_input_type": "ToolsInput",- "advanced": false,- "display_name": "Actions",+ "sender": {+ "_input_type": "DropdownInput",+ "advanced": true,+ "combobox": false,+ "dialog_inputs": {},+ "display_name": "Sender Type","dynamic": false,- "info": "Modify tool names and descriptions to help agents understand when to use each tool.",- "is_list": true,- "list_add_label": "Add More",- "name": "tools_metadata",+ "external_options": {},+ "info": "Type of sender.",+ "name": "sender",+ "options": [+ "Machine",+ "User"+ ],+ "options_metadata": [],"override_skip": false,"placeholder": "",- "real_time_refresh": true,"required": false,"show": true,"title_case": false,+ "toggle": false,"tool_mode": false,"trace_as_metadata": true,+ "track_in_telemetry": true,+ "type": "str",+ "value": "User"+ },+ "sender_name": {+ "_input_type": "MessageTextInput",+ "advanced": true,+ "display_name": "Sender Name",+ "dynamic": false,+ "info": "Name of the sender.",+ "input_types": [+ "Message"+ ],+ "list": false,+ "list_add_label": "Add More",+ "load_from_db": false,+ "name": "sender_name",+ "override_skip": false,+ "placeholder": "",+ "required": false,+ "show": true,+ "title_case": false,+ "tool_mode": false,+ "trace_as_input": true,+ "trace_as_metadata": true,"track_in_telemetry": false,- "type": "tools",- "value": [- {- "args": {- "input_value": {- "anyOf": [- {- "type": "string"- },- {- "type": "null"- }- ],- "default": null,- "description": "Text to be passed as input.",- "title": "Input Value"- }- },- "description": "This flow is to ingest the URL to open search.",- "display_description": "This flow is to ingest the URL to open search.",- "display_name": "opensearch_url_ingestion_flow",- "name": "opensearch_url_ingestion_flow",- "readonly": false,- "status": true,- "tags": [- "opensearch_url_ingestion_flow"- ]- }- ]+ "type": "str",+ "value": "User"},- "use_cache": {+ "session_id": {+ "_input_type": "MessageTextInput",+ "advanced": true,+ "display_name": "Session ID",+ "dynamic": false,+ "info": "The session ID of the chat. If empty, the current session ID parameter will be used.",+ "input_types": [+ "Message"+ ],+ "list": false,+ "list_add_label": "Add More",+ "load_from_db": false,+ "name": "session_id",+ "override_skip": false,+ "placeholder": "",+ "required": false,+ "show": true,+ "title_case": false,+ "tool_mode": false,+ "trace_as_input": true,+ "trace_as_metadata": true,+ "track_in_telemetry": false,+ "type": "str",+ "value": ""+ },+ "should_store_message": {"_input_type": "BoolInput","advanced": true,- "display_name": "Use Cached Server",+ "display_name": "Store Messages","dynamic": false,- "info": "Enable caching of MCP Server and tools to improve performance. Disable to always fetch fresh tools and server updates.",+ "info": "Store the message in the history.","list": false,"list_add_label": "Add More",- "name": "use_cache",+ "name": "should_store_message",+ "override_skip": false,"placeholder": "","required": false,"show": true,"title_case": false,"tool_mode": false,"trace_as_metadata": true,+ "track_in_telemetry": true,"type": "bool",- "value": false+ "value": true}},- "tool_mode": true+ "tool_mode": false},- "showNode": true,- "type": "MCP"+ "showNode": false,+ "type": "ChatInput"},"dragging": false,- "id": "MCP-7EY21",+ "id": "ChatInput-ci8VE","measured": {- "height": 287,- "width": 320+ "height": 52,+ "width": 192},"position": {- "x": 1497.4887425692002,- "y": 1384.557089807625+ "x": 1136.2811923974275,+ "y": 2503.9876597481666},"selected": false,"type": "genericNode"},{"data": {- "id": "note-Wg9xF",- "node": {- "description": "## README\n\nThis flow generates answers for OpenRAG's chat, informed by the context stored in OpenSearch.\nIn this flow, the [**Langflow Agent** component](https://docs.langflow.org/agents) uses the connected [**Language Model** component](https://docs.langflow.org/components-models) to select the correct tool to complete requests.\n* If the Agent determines your request requires external knowledge, it will embed your query with the [**Embedding Model** component](https://docs.langflow.org/components-embedding-models) and query your [OpenSearch knowledge](https://docs.openr.ag/knowledge).\n\n* If the Agent determines your request requires a web search, it selects the [**MCP Tools** component](https://docs.langflow.org/mcp-client#mcp-tools-parameters) to fetch web content with the [OpenSearch URL ingestion flow](https://docs.openr.ag/ingestion#url-flow).\n\nUsing the retrieved data, the Agent generates a response with the connected [**Language Model** component](https://docs.langflow.org/components-models) and sends it to the [**Chat Output** component](https://docs.langflow.org/components-io).\n\nFor more information, see the [OpenRAG docs](https://docs.openr.ag/agents).",- "display_name": "",- "documentation": "",- "template": {- "backgroundColor": "amber"- }- },- "type": "note"- },- "dragging": false,- "height": 469,- "id": "note-Wg9xF",- "measured": {- "height": 469,- "width": 644- },- "position": {- "x": 998.5503708467761,- "y": 897.7285248967648- },- "resizing": false,- "selected": false,- "type": "noteNode",- "width": 644- },- {- "data": {- "description": "Get chat inputs from the Playground.",- "display_name": "Chat Input",- "id": "ChatInput-ci8VE",+ "description": "Display a chat message in the Playground.",+ "display_name": "Chat Output",+ "id": "ChatOutput-gWl8E","node": {"base_classes": ["Message"@@ -607,8 +651,8 @@"beta": false,"conditional_paths": [],"custom_fields": {},- "description": "Get chat inputs from the Playground.",- "display_name": "Chat Input",+ "description": "Display a chat message in the Playground.",+ "display_name": "Chat Output","documentation": "https://docs.langflow.org/chat-input-and-output","edited": false,"field_order": [@@ -618,24 +662,33 @@"sender_name","session_id","context_id",- "files"+ "data_template",+ "clean_data"],"frozen": false,"icon": "MessagesSquare","legacy": false,"lf_version": "1.9.0","metadata": {- "code_hash": "7a26c54d89ed",+ "code_hash": "84009527d08c","dependencies": {"dependencies": [+ {+ "name": "orjson",+ "version": "3.11.8"+ },+ {+ "name": "fastapi",+ "version": "0.135.1"+ },{"name": "lfx","version": null}],- "total_dependencies": 1+ "total_dependencies": 3},- "module": "custom_components.chat_input"+ "module": "custom_components.chat_output"},"minimized": true,"output_types": [],@@ -643,7 +696,7 @@{"allows_loop": false,"cache": true,- "display_name": "Chat Message",+ "display_name": "Output Message","group_outputs": false,"loop_types": null,"method": "message_response",@@ -661,6 +714,26 @@"pinned": false,"template": {"_type": "Component",+ "clean_data": {+ "_input_type": "BoolInput",+ "advanced": true,+ "display_name": "Basic Clean Data",+ "dynamic": false,+ "info": "Whether to clean data before converting to string.",+ "list": false,+ "list_add_label": "Add More",+ "name": "clean_data",+ "override_skip": false,+ "placeholder": "",+ "required": false,+ "show": true,+ "title_case": false,+ "tool_mode": false,+ "trace_as_metadata": true,+ "track_in_telemetry": true,+ "type": "bool",+ "value": true+ },"code": {"advanced": true,"dynamic": true,@@ -677,7 +750,7 @@"show": true,"title_case": false,"type": "code",- "value": "from lfx.base.data.utils import IMG_FILE_TYPES, TEXT_FILE_TYPES\nfrom lfx.base.io.chat import ChatComponent\nfrom lfx.inputs.inputs import BoolInput\nfrom lfx.io import (\n DropdownInput,\n FileInput,\n MessageTextInput,\n MultilineInput,\n Output,\n)\nfrom lfx.schema.message import Message\nfrom lfx.utils.constants import (\n MESSAGE_SENDER_AI,\n MESSAGE_SENDER_NAME_USER,\n MESSAGE_SENDER_USER,\n)\n\n\nclass ChatInput(ChatComponent):\n display_name = \"Chat Input\"\n description = \"Get chat inputs from the Playground.\"\n documentation: str = \"https://docs.langflow.org/chat-input-and-output\"\n icon = \"MessagesSquare\"\n name = \"ChatInput\"\n minimized = True\n\n inputs = [\n MultilineInput(\n name=\"input_value\",\n display_name=\"Input Text\",\n value=\"\",\n info=\"Message to be passed as input.\",\n input_types=[],\n ),\n BoolInput(\n name=\"should_store_message\",\n display_name=\"Store Messages\",\n info=\"Store the message in the history.\",\n value=True,\n advanced=True,\n ),\n DropdownInput(\n name=\"sender\",\n display_name=\"Sender Type\",\n options=[MESSAGE_SENDER_AI, MESSAGE_SENDER_USER],\n value=MESSAGE_SENDER_USER,\n info=\"Type of sender.\",\n advanced=True,\n ),\n MessageTextInput(\n name=\"sender_name\",\n display_name=\"Sender Name\",\n info=\"Name of the sender.\",\n value=MESSAGE_SENDER_NAME_USER,\n advanced=True,\n ),\n MessageTextInput(\n name=\"session_id\",\n display_name=\"Session ID\",\n info=\"The session ID of the chat. If empty, the current session ID parameter will be used.\",\n advanced=True,\n ),\n MessageTextInput(\n name=\"context_id\",\n display_name=\"Context ID\",\n info=\"The context ID of the chat. Adds an extra layer to the local memory.\",\n value=\"\",\n advanced=True,\n ),\n FileInput(\n name=\"files\",\n display_name=\"Files\",\n file_types=TEXT_FILE_TYPES + IMG_FILE_TYPES,\n info=\"Files to be sent with the message.\",\n advanced=True,\n is_list=True,\n temp_file=True,\n ),\n ]\n outputs = [\n Output(display_name=\"Chat Message\", name=\"message\", method=\"message_response\"),\n ]\n\n async def message_response(self) -> Message:\n # Ensure files is a list and filter out empty/None values\n files = self.files if self.files else []\n if files and not isinstance(files, list):\n files = [files]\n # Filter out None/empty values\n files = [f for f in files if f is not None and f != \"\"]\n\n session_id = self.session_id or self.graph.session_id or \"\"\n message = await Message.create(\n text=self.input_value,\n sender=self.sender,\n sender_name=self.sender_name,\n session_id=session_id,\n context_id=self.context_id,\n files=files,\n )\n if session_id and isinstance(message, Message) and self.should_store_message:\n stored_message = await self.send_message(\n message,\n )\n self.message.value = stored_message\n message = stored_message\n\n self.status = message\n return message\n"+ "value": "from collections.abc import Generator\nfrom typing import Any\n\nimport orjson\nfrom fastapi.encoders import jsonable_encoder\n\nfrom lfx.base.io.chat import ChatComponent\nfrom lfx.helpers.data import safe_convert\nfrom lfx.inputs.inputs import BoolInput, DropdownInput, HandleInput, MessageTextInput\nfrom lfx.schema.data import Data\nfrom lfx.schema.dataframe import DataFrame\nfrom lfx.schema.message import Message\nfrom lfx.schema.properties import Source\nfrom lfx.template.field.base import Output\nfrom lfx.utils.constants import (\n MESSAGE_SENDER_AI,\n MESSAGE_SENDER_NAME_AI,\n MESSAGE_SENDER_USER,\n)\n\n\nclass ChatOutput(ChatComponent):\n display_name = \"Chat Output\"\n description = \"Display a chat message in the Playground.\"\n documentation: str = \"https://docs.langflow.org/chat-input-and-output\"\n icon = \"MessagesSquare\"\n name = \"ChatOutput\"\n minimized = True\n\n inputs = [\n HandleInput(\n name=\"input_value\",\n display_name=\"Inputs\",\n info=\"Message to be passed as output.\",\n input_types=[\"Data\", \"JSON\", \"DataFrame\", \"Table\", \"Message\"],\n required=True,\n ),\n BoolInput(\n name=\"should_store_message\",\n display_name=\"Store Messages\",\n info=\"Store the message in the history.\",\n value=True,\n advanced=True,\n ),\n DropdownInput(\n name=\"sender\",\n display_name=\"Sender Type\",\n options=[MESSAGE_SENDER_AI, MESSAGE_SENDER_USER],\n value=MESSAGE_SENDER_AI,\n advanced=True,\n info=\"Type of sender.\",\n ),\n MessageTextInput(\n name=\"sender_name\",\n display_name=\"Sender Name\",\n info=\"Name of the sender.\",\n value=MESSAGE_SENDER_NAME_AI,\n advanced=True,\n ),\n MessageTextInput(\n name=\"session_id\",\n display_name=\"Session ID\",\n info=\"The session ID of the chat. If empty, the current session ID parameter will be used.\",\n advanced=True,\n ),\n MessageTextInput(\n name=\"context_id\",\n display_name=\"Context ID\",\n info=\"The context ID of the chat. Adds an extra layer to the local memory.\",\n value=\"\",\n advanced=True,\n ),\n MessageTextInput(\n name=\"data_template\",\n display_name=\"Data Template\",\n value=\"{text}\",\n advanced=True,\n info=\"Template to convert Data to Text. If left empty, it will be dynamically set to the Data's text key.\",\n ),\n BoolInput(\n name=\"clean_data\",\n display_name=\"Basic Clean Data\",\n value=True,\n advanced=True,\n info=\"Whether to clean data before converting to string.\",\n ),\n ]\n outputs = [\n Output(\n display_name=\"Output Message\",\n name=\"message\",\n method=\"message_response\",\n ),\n ]\n\n def _build_source(self, id_: str | None, display_name: str | None, source: str | None) -> Source:\n source_dict = {}\n if id_:\n source_dict[\"id\"] = id_\n if display_name:\n source_dict[\"display_name\"] = display_name\n if source:\n # Handle case where source is a ChatOpenAI object\n if hasattr(source, \"model_name\"):\n source_dict[\"source\"] = source.model_name\n elif hasattr(source, \"model\"):\n source_dict[\"source\"] = str(source.model)\n else:\n source_dict[\"source\"] = str(source)\n return Source(**source_dict)\n\n async def message_response(self) -> Message:\n # First convert the input to string if needed\n text = self.convert_to_string()\n\n # Get source properties\n source, _, display_name, source_id = self.get_properties_from_source_component()\n\n # Create or use existing Message object\n if isinstance(self.input_value, Message) and not self.is_connected_to_chat_input():\n message = self.input_value\n # Update message properties\n message.text = text\n # Preserve existing session_id from the incoming message if it exists\n existing_session_id = message.session_id\n else:\n message = Message(text=text)\n existing_session_id = None\n\n # Set message properties\n message.sender = self.sender\n message.sender_name = self.sender_name\n # Preserve session_id from incoming message, or use component/graph session_id\n message.session_id = (\n self.session_id or existing_session_id or (self.graph.session_id if hasattr(self, \"graph\") else None) or \"\"\n )\n message.context_id = self.context_id\n message.flow_id = self.graph.flow_id if hasattr(self, \"graph\") else None\n message.properties.source = self._build_source(source_id, display_name, source)\n\n # Store message if needed\n if message.session_id and self.should_store_message:\n stored_message = await self.send_message(message)\n self.message.value = stored_message\n message = stored_message\n\n # Set accumulated token usage from all upstream LLM vertices.\n # This must happen AFTER send_message() because streaming captures\n # usage from chunks and would overwrite accumulated totals.\n if hasattr(self, \"_vertex\") and self._vertex is not None:\n accumulated_usage = self._vertex._accumulate_upstream_token_usage() # noqa: SLF001\n if accumulated_usage:\n message.properties.usage = accumulated_usage\n if self.should_store_message and message.get_id():\n message = await self._update_stored_message(message)\n await self._send_message_event(message, id_=message.get_id())\n\n self.status = message\n return message\n\n def _serialize_data(self, data: Data) -> str:\n \"\"\"Serialize Data object to JSON string.\"\"\"\n # Convert data.data to JSON-serializable format\n serializable_data = jsonable_encoder(data.data)\n # Serialize with orjson, enabling pretty printing with indentation\n json_bytes = orjson.dumps(serializable_data, option=orjson.OPT_INDENT_2)\n # Convert bytes to string and wrap in Markdown code blocks\n return \"```json\\n\" + json_bytes.decode(\"utf-8\") + \"\\n```\"\n\n def _validate_input(self) -> None:\n \"\"\"Validate the input data and raise ValueError if invalid.\"\"\"\n if self.input_value is None:\n msg = \"Input data cannot be None\"\n raise ValueError(msg)\n if isinstance(self.input_value, list) and not all(\n isinstance(item, Message | Data | DataFrame | str) for item in self.input_value\n ):\n invalid_types = [\n type(item).__name__\n for item in self.input_value\n if not isinstance(item, Message | Data | DataFrame | str)\n ]\n msg = f\"Expected Data or DataFrame or Message or str, got {invalid_types}\"\n raise TypeError(msg)\n if not isinstance(\n self.input_value,\n Message | Data | DataFrame | str | list | Generator | type(None),\n ):\n type_name = type(self.input_value).__name__\n msg = f\"Expected Data or DataFrame or Message or str, Generator or None, got {type_name}\"\n raise TypeError(msg)\n\n def convert_to_string(self) -> str | Generator[Any, None, None]:\n \"\"\"Convert input data to string with proper error handling.\"\"\"\n self._validate_input()\n if isinstance(self.input_value, list):\n clean_data: bool = getattr(self, \"clean_data\", False)\n return \"\\n\".join([safe_convert(item, clean_data=clean_data) for item in self.input_value])\n if isinstance(self.input_value, Generator):\n return self.input_value\n return safe_convert(self.input_value)\n"},"context_id": {"_input_type": "MessageTextInput",@@ -704,77 +777,55 @@"type": "str","value": ""},- "files": {- "_input_type": "FileInput",+ "data_template": {+ "_input_type": "MessageTextInput","advanced": true,- "display_name": "Files",+ "display_name": "Data Template","dynamic": false,- "fileTypes": [- "csv",- "json",- "pdf",- "txt",- "md",- "mdx",- "yaml",- "yml",- "xml",- "html",- "htm",- "docx",- "py",- "sh",- "sql",- "js",- "ts",- "tsx",- "jpg",- "jpeg",- "png",- "bmp",- "image"+ "info": "Template to convert Data to Text. If left empty, it will be dynamically set to the Data's text key.",+ "input_types": [+ "Message"],- "file_path": "",- "info": "Files to be sent with the message.",- "list": true,+ "list": false,"list_add_label": "Add More",- "name": "files",+ "load_from_db": false,+ "name": "data_template","override_skip": false,"placeholder": "","required": false,"show": true,- "temp_file": true,"title_case": false,"tool_mode": false,+ "trace_as_input": true,"trace_as_metadata": true,"track_in_telemetry": false,- "type": "file",- "value": ""+ "type": "str",+ "value": "{text}"},"input_value": {- "_input_type": "MultilineInput",+ "_input_type": "HandleInput","advanced": false,- "ai_enabled": false,- "copy_field": false,- "display_name": "Input Text",+ "display_name": "Inputs","dynamic": false,- "info": "Message to be passed as input.",- "input_types": [],+ "info": "Message to be passed as output.",+ "input_types": [+ "Data",+ "JSON",+ "DataFrame",+ "Table",+ "Message"+ ],"list": false,"list_add_label": "Add More",- "load_from_db": false,- "multiline": true,"name": "input_value","override_skip": false,"placeholder": "",- "required": false,+ "required": true,"show": true,"title_case": false,- "tool_mode": false,- "trace_as_input": true,"trace_as_metadata": true,"track_in_telemetry": false,- "type": "str",+ "type": "other","value": ""},"sender": {@@ -802,7 +853,7 @@"trace_as_metadata": true,"track_in_telemetry": true,"type": "str",- "value": "User"+ "value": "Machine"},"sender_name": {"_input_type": "MessageTextInput",@@ -827,7 +878,7 @@"trace_as_metadata": true,"track_in_telemetry": false,"type": "str",- "value": "User"+ "value": "AI"},"session_id": {"_input_type": "MessageTextInput",@@ -878,26 +929,26 @@"tool_mode": false},"showNode": false,- "type": "ChatInput"+ "type": "ChatOutput"},"dragging": false,- "id": "ChatInput-ci8VE",+ "id": "ChatOutput-gWl8E","measured": {"height": 52,"width": 192},"position": {- "x": 1136.2811923974275,- "y": 2503.9876597481666+ "x": 2458.4563028144366,+ "y": 2074.662957908784},"selected": false,"type": "genericNode"},{"data": {- "description": "Display a chat message in the Playground.",- "display_name": "Chat Output",- "id": "ChatOutput-gWl8E",+ "description": "Define the agent's instructions, then enter a task to complete using tools.",+ "display_name": "Agent",+ "id": "Agent-Nfw7u","node": {"base_classes": ["Message"@@ -905,56 +956,66 @@"beta": false,"conditional_paths": [],"custom_fields": {},- "description": "Display a chat message in the Playground.",- "display_name": "Chat Output",- "documentation": "https://docs.langflow.org/chat-input-and-output",+ "description": "Define the agent's instructions, then enter a task to complete using tools.",+ "display_name": "Agent",+ "documentation": "https://docs.langflow.org/agents","edited": false,"field_order": [- "input_value",- "should_store_message",- "sender",- "sender_name",- "session_id",+ "model",+ "api_key",+ "base_url_ibm_watsonx",+ "project_id",+ "system_prompt","context_id",- "data_template",- "clean_data"+ "n_messages",+ "max_tokens",+ "format_instructions",+ "output_schema",+ "tools",+ "input_value",+ "handle_parsing_errors",+ "verbose",+ "max_iterations",+ "agent_description",+ "add_current_date_tool"],"frozen": false,- "icon": "MessagesSquare",+ "icon": "bot",+ "last_updated": "2026-04-17T22:36:44.494Z","legacy": false,- "lf_version": "1.9.0","metadata": {- "code_hash": "84009527d08c",+ "code_hash": "154c71cf7441","dependencies": {"dependencies": [{- "name": "orjson",- "version": "3.11.8"+ "name": "pydantic",+ "version": "2.12.5"},{- "name": "fastapi",- "version": "0.135.1"+ "name": "lfx",+ "version": "0.4.0"},{- "name": "lfx",- "version": null+ "name": "langchain_core",+ "version": "1.2.29"}],"total_dependencies": 3},- "module": "custom_components.chat_output"+ "module": "custom_components.agent"},- "minimized": true,+ "minimized": false,"output_types": [],"outputs": [{"allows_loop": false,"cache": true,- "display_name": "Output Message",+ "display_name": "Response","group_outputs": false,+ "hidden": null,"loop_types": null,"method": "message_response",- "name": "message",+ "name": "response","options": null,"required_inputs": null,"selected": "Message",@@ -967,16 +1028,25 @@],"pinned": false,"template": {+ "_frontend_node_flow_id": {+ "input_types": [],+ "value": "1098eea1-6649-4e1d-aed1-b77249fb8dd0"+ },+ "_frontend_node_folder_id": {+ "input_types": [],+ "value": "3b7ac23f-e74d-4fa3-ae00-a54b24a27f93"+ },"_type": "Component",- "clean_data": {+ "add_current_date_tool": {"_input_type": "BoolInput","advanced": true,- "display_name": "Basic Clean Data",+ "display_name": "Current Date","dynamic": false,- "info": "Whether to clean data before converting to string.",+ "info": "If true, will add a tool to the agent that returns the current date.",+ "input_types": [],"list": false,"list_add_label": "Add More",- "name": "clean_data",+ "name": "add_current_date_tool","override_skip": false,"placeholder": "","required": false,@@ -988,38 +1058,24 @@"type": "bool","value": true},- "code": {- "advanced": true,- "dynamic": true,- "fileTypes": [],- "file_path": "",- "info": "",- "list": false,- "load_from_db": false,- "multiline": true,- "name": "code",- "password": false,- "placeholder": "",- "required": true,- "show": true,- "title_case": false,- "type": "code",- "value": "from collections.abc import Generator\nfrom typing import Any\n\nimport orjson\nfrom fastapi.encoders import jsonable_encoder\n\nfrom lfx.base.io.chat import ChatComponent\nfrom lfx.helpers.data import safe_convert\nfrom lfx.inputs.inputs import BoolInput, DropdownInput, HandleInput, MessageTextInput\nfrom lfx.schema.data import Data\nfrom lfx.schema.dataframe import DataFrame\nfrom lfx.schema.message import Message\nfrom lfx.schema.properties import Source\nfrom lfx.template.field.base import Output\nfrom lfx.utils.constants import (\n MESSAGE_SENDER_AI,\n MESSAGE_SENDER_NAME_AI,\n MESSAGE_SENDER_USER,\n)\n\n\nclass ChatOutput(ChatComponent):\n display_name = \"Chat Output\"\n description = \"Display a chat message in the Playground.\"\n documentation: str = \"https://docs.langflow.org/chat-input-and-output\"\n icon = \"MessagesSquare\"\n name = \"ChatOutput\"\n minimized = True\n\n inputs = [\n HandleInput(\n name=\"input_value\",\n display_name=\"Inputs\",\n info=\"Message to be passed as output.\",\n input_types=[\"Data\", \"JSON\", \"DataFrame\", \"Table\", \"Message\"],\n required=True,\n ),\n BoolInput(\n name=\"should_store_message\",\n display_name=\"Store Messages\",\n info=\"Store the message in the history.\",\n value=True,\n advanced=True,\n ),\n DropdownInput(\n name=\"sender\",\n display_name=\"Sender Type\",\n options=[MESSAGE_SENDER_AI, MESSAGE_SENDER_USER],\n value=MESSAGE_SENDER_AI,\n advanced=True,\n info=\"Type of sender.\",\n ),\n MessageTextInput(\n name=\"sender_name\",\n display_name=\"Sender Name\",\n info=\"Name of the sender.\",\n value=MESSAGE_SENDER_NAME_AI,\n advanced=True,\n ),\n MessageTextInput(\n name=\"session_id\",\n display_name=\"Session ID\",\n info=\"The session ID of the chat. If empty, the current session ID parameter will be used.\",\n advanced=True,\n ),\n MessageTextInput(\n name=\"context_id\",\n display_name=\"Context ID\",\n info=\"The context ID of the chat. Adds an extra layer to the local memory.\",\n value=\"\",\n advanced=True,\n ),\n MessageTextInput(\n name=\"data_template\",\n display_name=\"Data Template\",\n value=\"{text}\",\n advanced=True,\n info=\"Template to convert Data to Text. If left empty, it will be dynamically set to the Data's text key.\",\n ),\n BoolInput(\n name=\"clean_data\",\n display_name=\"Basic Clean Data\",\n value=True,\n advanced=True,\n info=\"Whether to clean data before converting to string.\",\n ),\n ]\n outputs = [\n Output(\n display_name=\"Output Message\",\n name=\"message\",\n method=\"message_response\",\n ),\n ]\n\n def _build_source(self, id_: str | None, display_name: str | None, source: str | None) -> Source:\n source_dict = {}\n if id_:\n source_dict[\"id\"] = id_\n if display_name:\n source_dict[\"display_name\"] = display_name\n if source:\n # Handle case where source is a ChatOpenAI object\n if hasattr(source, \"model_name\"):\n source_dict[\"source\"] = source.model_name\n elif hasattr(source, \"model\"):\n source_dict[\"source\"] = str(source.model)\n else:\n source_dict[\"source\"] = str(source)\n return Source(**source_dict)\n\n async def message_response(self) -> Message:\n # First convert the input to string if needed\n text = self.convert_to_string()\n\n # Get source properties\n source, _, display_name, source_id = self.get_properties_from_source_component()\n\n # Create or use existing Message object\n if isinstance(self.input_value, Message) and not self.is_connected_to_chat_input():\n message = self.input_value\n # Update message properties\n message.text = text\n # Preserve existing session_id from the incoming message if it exists\n existing_session_id = message.session_id\n else:\n message = Message(text=text)\n existing_session_id = None\n\n # Set message properties\n message.sender = self.sender\n message.sender_name = self.sender_name\n # Preserve session_id from incoming message, or use component/graph session_id\n message.session_id = (\n self.session_id or existing_session_id or (self.graph.session_id if hasattr(self, \"graph\") else None) or \"\"\n )\n message.context_id = self.context_id\n message.flow_id = self.graph.flow_id if hasattr(self, \"graph\") else None\n message.properties.source = self._build_source(source_id, display_name, source)\n\n # Store message if needed\n if message.session_id and self.should_store_message:\n stored_message = await self.send_message(message)\n self.message.value = stored_message\n message = stored_message\n\n # Set accumulated token usage from all upstream LLM vertices.\n # This must happen AFTER send_message() because streaming captures\n # usage from chunks and would overwrite accumulated totals.\n if hasattr(self, \"_vertex\") and self._vertex is not None:\n accumulated_usage = self._vertex._accumulate_upstream_token_usage() # noqa: SLF001\n if accumulated_usage:\n message.properties.usage = accumulated_usage\n if self.should_store_message and message.get_id():\n message = await self._update_stored_message(message)\n await self._send_message_event(message, id_=message.get_id())\n\n self.status = message\n return message\n\n def _serialize_data(self, data: Data) -> str:\n \"\"\"Serialize Data object to JSON string.\"\"\"\n # Convert data.data to JSON-serializable format\n serializable_data = jsonable_encoder(data.data)\n # Serialize with orjson, enabling pretty printing with indentation\n json_bytes = orjson.dumps(serializable_data, option=orjson.OPT_INDENT_2)\n # Convert bytes to string and wrap in Markdown code blocks\n return \"```json\\n\" + json_bytes.decode(\"utf-8\") + \"\\n```\"\n\n def _validate_input(self) -> None:\n \"\"\"Validate the input data and raise ValueError if invalid.\"\"\"\n if self.input_value is None:\n msg = \"Input data cannot be None\"\n raise ValueError(msg)\n if isinstance(self.input_value, list) and not all(\n isinstance(item, Message | Data | DataFrame | str) for item in self.input_value\n ):\n invalid_types = [\n type(item).__name__\n for item in self.input_value\n if not isinstance(item, Message | Data | DataFrame | str)\n ]\n msg = f\"Expected Data or DataFrame or Message or str, got {invalid_types}\"\n raise TypeError(msg)\n if not isinstance(\n self.input_value,\n Message | Data | DataFrame | str | list | Generator | type(None),\n ):\n type_name = type(self.input_value).__name__\n msg = f\"Expected Data or DataFrame or Message or str, Generator or None, got {type_name}\"\n raise TypeError(msg)\n\n def convert_to_string(self) -> str | Generator[Any, None, None]:\n \"\"\"Convert input data to string with proper error handling.\"\"\"\n self._validate_input()\n if isinstance(self.input_value, list):\n clean_data: bool = getattr(self, \"clean_data\", False)\n return \"\\n\".join([safe_convert(item, clean_data=clean_data) for item in self.input_value])\n if isinstance(self.input_value, Generator):\n return self.input_value\n return safe_convert(self.input_value)\n"- },- "context_id": {- "_input_type": "MessageTextInput",+ "agent_description": {+ "_input_type": "MultilineInput","advanced": true,- "display_name": "Context ID",+ "ai_enabled": false,+ "copy_field": false,+ "display_name": "Agent Description [Deprecated]","dynamic": false,- "info": "The context ID of the chat. Adds an extra layer to the local memory.",+ "info": "The description of the agent. This is only used when in Tool Mode. Defaults to 'A helpful assistant with access to the following tools:' and tools are added dynamically. This feature is deprecated and will be removed in future versions.","input_types": ["Message"],"list": false,"list_add_label": "Add More","load_from_db": false,- "name": "context_id",+ "multiline": true,+ "name": "agent_description","override_skip": false,+ "password": false,"placeholder": "","required": false,"show": true,@@ -1029,99 +1085,94 @@"trace_as_metadata": true,"track_in_telemetry": false,"type": "str",- "value": ""+ "value": "A helpful assistant with access to the following tools:"},- "data_template": {- "_input_type": "MessageTextInput",+ "api_key": {+ "_input_type": "SecretStrInput","advanced": true,- "display_name": "Data Template",+ "display_name": "API Key","dynamic": false,- "info": "Template to convert Data to Text. If left empty, it will be dynamically set to the Data's text key.",- "input_types": [- "Message"- ],- "list": false,- "list_add_label": "Add More",- "load_from_db": false,- "name": "data_template",+ "info": "Falls back to OPENAI_API_KEY environment variable",+ "input_types": [],+ "load_from_db": true,+ "name": "api_key","override_skip": false,+ "password": true,"placeholder": "",+ "real_time_refresh": true,"required": false,"show": true,"title_case": false,- "tool_mode": false,- "trace_as_input": true,- "trace_as_metadata": true,"track_in_telemetry": false,"type": "str",- "value": "{text}"- },- "input_value": {- "_input_type": "HandleInput",- "advanced": false,- "display_name": "Inputs",- "dynamic": false,- "info": "Message to be passed as output.",- "input_types": [- "Data",- "JSON",- "DataFrame",- "Table",- "Message"- ],- "list": false,- "list_add_label": "Add More",- "name": "input_value",- "override_skip": false,- "placeholder": "",- "required": true,- "show": true,- "title_case": false,- "trace_as_metadata": true,- "track_in_telemetry": false,- "type": "other",- "value": ""+ "value": "OPENAI_API_KEY"},- "sender": {+ "base_url_ibm_watsonx": {"_input_type": "DropdownInput",- "advanced": true,- "combobox": false,+ "advanced": false,+ "combobox": true,"dialog_inputs": {},- "display_name": "Sender Type",+ "display_name": "watsonx API Endpoint","dynamic": false,"external_options": {},- "info": "Type of sender.",- "name": "sender",+ "info": "The base URL of the API (IBM watsonx.ai only)",+ "input_types": [],+ "load_from_db": false,+ "name": "base_url_ibm_watsonx","options": [- "Machine",- "User"+ "https://us-south.ml.cloud.ibm.com",+ "https://eu-de.ml.cloud.ibm.com",+ "https://eu-gb.ml.cloud.ibm.com",+ "https://au-syd.ml.cloud.ibm.com",+ "https://jp-tok.ml.cloud.ibm.com",+ "https://ca-tor.ml.cloud.ibm.com"],"options_metadata": [],"override_skip": false,"placeholder": "",+ "real_time_refresh": true,"required": false,- "show": true,+ "show": false,"title_case": false,"toggle": false,"tool_mode": false,"trace_as_metadata": true,"track_in_telemetry": true,"type": "str",- "value": "Machine"+ "value": ""},- "sender_name": {+ "code": {+ "advanced": true,+ "dynamic": true,+ "fileTypes": [],+ "file_path": "",+ "info": "",+ "input_types": [],+ "list": false,+ "load_from_db": false,+ "multiline": true,+ "name": "code",+ "password": false,+ "placeholder": "",+ "required": true,+ "show": true,+ "title_case": false,+ "type": "code",+ "value": "from __future__ import annotations\n\nimport json\nimport re\nfrom typing import TYPE_CHECKING\n\nfrom pydantic import ValidationError\n\nfrom lfx.components.models_and_agents.memory import MemoryComponent\n\nif TYPE_CHECKING:\n from langchain_core.tools import Tool\n\nfrom lfx.base.agents.agent import LCToolsAgentComponent\nfrom lfx.base.agents.events import ExceptionWithMessageError\nfrom lfx.base.models.unified_models import (\n get_language_model_options,\n get_llm,\n handle_model_input_update,\n)\nfrom lfx.base.models.watsonx_constants import IBM_WATSONX_URLS\nfrom lfx.components.agentics.helpers.model_config import validate_model_selection\nfrom lfx.components.helpers import CurrentDateComponent\nfrom lfx.components.langchain_utilities.tool_calling import ToolCallingAgentComponent\nfrom lfx.custom.custom_component.component import get_component_toolkit\nfrom lfx.field_typing.range_spec import RangeSpec\nfrom lfx.helpers.base_model import build_model_from_schema\nfrom lfx.inputs.inputs import BoolInput, DropdownInput, ModelInput, StrInput\nfrom lfx.io import IntInput, MessageTextInput, MultilineInput, Output, SecretStrInput, TableInput\nfrom lfx.log.logger import logger\nfrom lfx.schema.data import Data\nfrom lfx.schema.dotdict import dotdict\nfrom lfx.schema.message import Message\nfrom lfx.schema.table import EditMode\n\n\ndef set_advanced_true(component_input):\n component_input.advanced = True\n return component_input\n\n\nclass AgentComponent(ToolCallingAgentComponent):\n display_name: str = \"Agent\"\n description: str = \"Define the agent's instructions, then enter a task to complete using tools.\"\n documentation: str = \"https://docs.langflow.org/agents\"\n icon = \"bot\"\n beta = False\n name = \"Agent\"\n\n memory_inputs = [set_advanced_true(component_input) for component_input in MemoryComponent().inputs]\n\n inputs = [\n ModelInput(\n name=\"model\",\n display_name=\"Language Model\",\n info=\"Select your model provider\",\n real_time_refresh=True,\n required=True,\n ),\n SecretStrInput(\n name=\"api_key\",\n display_name=\"API Key\",\n info=\"Overrides global provider settings. Leave blank to use your pre-configured API Key.\",\n real_time_refresh=True,\n advanced=True,\n ),\n DropdownInput(\n name=\"base_url_ibm_watsonx\",\n display_name=\"watsonx API Endpoint\",\n info=\"The base URL of the API (IBM watsonx.ai only)\",\n options=IBM_WATSONX_URLS,\n value=IBM_WATSONX_URLS[0],\n combobox=True,\n show=False,\n real_time_refresh=True,\n ),\n StrInput(\n name=\"project_id\",\n display_name=\"watsonx Project ID\",\n info=\"The project ID associated with the foundation model (IBM watsonx.ai only)\",\n show=False,\n required=False,\n ),\n MultilineInput(\n name=\"system_prompt\",\n display_name=\"Agent Instructions\",\n info=\"System Prompt: Initial instructions and context provided to guide the agent's behavior.\",\n value=\"You are a helpful assistant that can use tools to answer questions and perform tasks.\",\n advanced=False,\n ),\n MessageTextInput(\n name=\"context_id\",\n display_name=\"Context ID\",\n info=\"The context ID of the chat. Adds an extra layer to the local memory.\",\n value=\"\",\n advanced=True,\n ),\n IntInput(\n name=\"n_messages\",\n display_name=\"Number of Chat History Messages\",\n value=100,\n info=\"Number of chat history messages to retrieve.\",\n advanced=True,\n show=True,\n ),\n IntInput(\n name=\"max_tokens\",\n display_name=\"Max Tokens\",\n info=\"Maximum number of tokens to generate. Field name varies by provider.\",\n advanced=True,\n range_spec=RangeSpec(min=1, max=128000, step=1, step_type=\"int\"),\n ),\n MultilineInput(\n name=\"format_instructions\",\n display_name=\"Output Format Instructions\",\n info=\"Generic Template for structured output formatting. Valid only with Structured response.\",\n value=(\n \"You are an AI that extracts structured JSON objects from unstructured text. \"\n \"Use a predefined schema with expected types (str, int, float, bool, dict). \"\n \"Extract ALL relevant instances that match the schema - if multiple patterns exist, capture them all. \"\n \"Fill missing or ambiguous values with defaults: null for missing values. \"\n \"Remove exact duplicates but keep variations that have different field values. \"\n \"Always return valid JSON in the expected format, never throw errors. \"\n \"If multiple objects can be extracted, return them all in the structured format.\"\n ),\n advanced=True,\n ),\n TableInput(\n name=\"output_schema\",\n display_name=\"Output Schema\",\n info=(\n \"Schema Validation: Define the structure and data types for structured output. \"\n \"No validation if no output schema.\"\n ),\n advanced=True,\n required=False,\n value=[],\n table_schema=[\n {\n \"name\": \"name\",\n \"display_name\": \"Name\",\n \"type\": \"str\",\n \"description\": \"Specify the name of the output field.\",\n \"default\": \"field\",\n \"edit_mode\": EditMode.INLINE,\n },\n {\n \"name\": \"description\",\n \"display_name\": \"Description\",\n \"type\": \"str\",\n \"description\": \"Describe the purpose of the output field.\",\n \"default\": \"description of field\",\n \"edit_mode\": EditMode.POPOVER,\n },\n {\n \"name\": \"type\",\n \"display_name\": \"Type\",\n \"type\": \"str\",\n \"edit_mode\": EditMode.INLINE,\n \"description\": (\"Indicate the data type of the output field (e.g., str, int, float, bool, dict).\"),\n \"options\": [\"str\", \"int\", \"float\", \"bool\", \"dict\"],\n \"default\": \"str\",\n },\n {\n \"name\": \"multiple\",\n \"display_name\": \"As List\",\n \"type\": \"boolean\",\n \"description\": \"Set to True if this output field should be a list of the specified type.\",\n \"default\": \"False\",\n \"edit_mode\": EditMode.INLINE,\n },\n ],\n ),\n *LCToolsAgentComponent.get_base_inputs(),\n # removed memory inputs from agent component\n # *memory_inputs,\n BoolInput(\n name=\"add_current_date_tool\",\n display_name=\"Current Date\",\n advanced=True,\n info=\"If true, will add a tool to the agent that returns the current date.\",\n value=True,\n ),\n ]\n outputs = [\n Output(name=\"response\", display_name=\"Response\", method=\"message_response\"),\n ]\n\n def _resolve_selected_model(self):\n \"\"\"Resolve the selected model, including legacy agent_llm/model_name inputs.\"\"\"\n try:\n from langchain_core.language_models import BaseLanguageModel\n\n if isinstance(self.model, BaseLanguageModel):\n return self.model\n except ImportError:\n pass\n\n if isinstance(self.model, list) and self.model:\n return self.model\n\n legacy_provider = getattr(self, \"agent_llm\", None)\n legacy_model_name = getattr(self, \"model_name\", None)\n if not legacy_provider or not legacy_model_name:\n return self.model\n\n options = get_language_model_options(user_id=self.user_id)\n for option in options:\n if option.get(\"provider\") == legacy_provider and option.get(\"name\") == legacy_model_name:\n return [option]\n\n return [\n {\n \"name\": legacy_model_name,\n \"provider\": legacy_provider,\n \"metadata\": {},\n }\n ]\n\n def _get_max_tokens_value(self):\n \"\"\"Return the user-supplied max_tokens or None when unset/zero.\"\"\"\n val = getattr(self, \"max_tokens\", None)\n if val in {\"\", 0}:\n return None\n return val\n\n def _get_llm(self):\n \"\"\"Override parent to include max_tokens from the Agent's input field.\"\"\"\n return get_llm(\n model=self.model,\n user_id=self.user_id,\n api_key=getattr(self, \"api_key\", None),\n max_tokens=self._get_max_tokens_value(),\n watsonx_url=getattr(self, \"base_url_ibm_watsonx\", None),\n watsonx_project_id=getattr(self, \"project_id\", None),\n )\n\n async def get_agent_requirements(self):\n \"\"\"Get the agent requirements for the agent.\"\"\"\n from langchain_core.tools import StructuredTool\n\n selected_model = self._resolve_selected_model()\n try:\n from langchain_core.language_models import BaseLanguageModel\n\n is_connected_model = isinstance(selected_model, BaseLanguageModel)\n except ImportError:\n is_connected_model = False\n\n if not is_connected_model:\n validate_model_selection(selected_model)\n\n # Ensure _get_llm() uses the resolved model (e.g. from legacy agent_llm/model_name)\n self.model = selected_model\n llm_model = self._get_llm()\n if llm_model is None:\n msg = \"No language model selected. Please choose a model to proceed.\"\n raise ValueError(msg)\n\n # Get memory data\n self.chat_history = await self.get_memory_data()\n await logger.adebug(f\"Retrieved {len(self.chat_history)} chat history messages\")\n if isinstance(self.chat_history, Message):\n self.chat_history = [self.chat_history]\n\n # Add current date tool if enabled\n if self.add_current_date_tool:\n if not isinstance(self.tools, list): # type: ignore[has-type]\n self.tools = []\n current_date_tool = (await CurrentDateComponent(**self.get_base_args()).to_toolkit()).pop(0)\n\n if not isinstance(current_date_tool, StructuredTool):\n msg = \"CurrentDateComponent must be converted to a StructuredTool\"\n raise TypeError(msg)\n self.tools.append(current_date_tool)\n\n # Set shared callbacks for tracing the tools used by the agent\n self.set_tools_callbacks(self.tools, self._get_shared_callbacks())\n\n return llm_model, self.chat_history, self.tools\n\n async def message_response(self) -> Message:\n try:\n llm_model, self.chat_history, self.tools = await self.get_agent_requirements()\n # Set up and run agent\n self.set(\n llm=llm_model,\n tools=self.tools or [],\n chat_history=self.chat_history,\n input_value=self.input_value,\n system_prompt=self.system_prompt,\n )\n agent = self.create_agent_runnable()\n result = await self.run_agent(agent)\n\n # Store result for potential JSON output\n self._agent_result = result\n\n except (ValueError, TypeError, KeyError) as e:\n await logger.aerror(f\"{type(e).__name__}: {e!s}\")\n raise\n except ExceptionWithMessageError as e:\n await logger.aerror(f\"ExceptionWithMessageError occurred: {e}\")\n raise\n # Avoid catching blind Exception; let truly unexpected exceptions propagate\n except Exception as e:\n await logger.aerror(f\"Unexpected error: {e!s}\")\n raise\n else:\n return result\n\n def _preprocess_schema(self, schema):\n \"\"\"Preprocess schema to ensure correct data types for build_model_from_schema.\"\"\"\n processed_schema = []\n for field in schema:\n processed_field = {\n \"name\": str(field.get(\"name\", \"field\")),\n \"type\": str(field.get(\"type\", \"str\")),\n \"description\": str(field.get(\"description\", \"\")),\n \"multiple\": field.get(\"multiple\", False),\n }\n # Ensure multiple is handled correctly\n if isinstance(processed_field[\"multiple\"], str):\n processed_field[\"multiple\"] = processed_field[\"multiple\"].lower() in [\n \"true\",\n \"1\",\n \"t\",\n \"y\",\n \"yes\",\n ]\n processed_schema.append(processed_field)\n return processed_schema\n\n async def build_structured_output_base(self, content: str):\n \"\"\"Build structured output with optional BaseModel validation.\"\"\"\n json_pattern = r\"\\{.*\\}\"\n schema_error_msg = \"Try setting an output schema\"\n\n # Try to parse content as JSON first\n json_data = None\n try:\n json_data = json.loads(content)\n except json.JSONDecodeError:\n json_match = re.search(json_pattern, content, re.DOTALL)\n if json_match:\n try:\n json_data = json.loads(json_match.group())\n except json.JSONDecodeError:\n return {\"content\": content, \"error\": schema_error_msg}\n else:\n return {\"content\": content, \"error\": schema_error_msg}\n\n # If no output schema provided, return parsed JSON without validation\n if not hasattr(self, \"output_schema\") or not self.output_schema or len(self.output_schema) == 0:\n return json_data\n\n # Use BaseModel validation with schema\n try:\n processed_schema = self._preprocess_schema(self.output_schema)\n output_model = build_model_from_schema(processed_schema)\n\n # Validate against the schema\n if isinstance(json_data, list):\n # Multiple objects\n validated_objects = []\n for item in json_data:\n try:\n validated_obj = output_model.model_validate(item)\n validated_objects.append(validated_obj.model_dump())\n except ValidationError as e:\n await logger.aerror(f\"Validation error for item: {e}\")\n # Include invalid items with error info\n validated_objects.append({\"data\": item, \"validation_error\": str(e)})\n return validated_objects\n\n # Single object\n try:\n validated_obj = output_model.model_validate(json_data)\n return [validated_obj.model_dump()] # Return as list for consistency\n except ValidationError as e:\n await logger.aerror(f\"Validation error: {e}\")\n return [{\"data\": json_data, \"validation_error\": str(e)}]\n\n except (TypeError, ValueError) as e:\n await logger.aerror(f\"Error building structured output: {e}\")\n # Fallback to parsed JSON without validation\n return json_data\n\n async def json_response(self) -> Data:\n \"\"\"Convert agent response to structured JSON Data output with schema validation.\"\"\"\n # Always use structured chat agent for JSON response mode for better JSON formatting\n try:\n system_components = []\n\n # 1. Agent Instructions (system_prompt)\n agent_instructions = getattr(self, \"system_prompt\", \"\") or \"\"\n if agent_instructions:\n system_components.append(f\"{agent_instructions}\")\n\n # 2. Format Instructions\n format_instructions = getattr(self, \"format_instructions\", \"\") or \"\"\n if format_instructions:\n system_components.append(f\"Format instructions: {format_instructions}\")\n\n # 3. Schema Information from BaseModel\n if hasattr(self, \"output_schema\") and self.output_schema and len(self.output_schema) > 0:\n try:\n processed_schema = self._preprocess_schema(self.output_schema)\n output_model = build_model_from_schema(processed_schema)\n schema_dict = output_model.model_json_schema()\n schema_info = (\n \"You are given some text that may include format instructions, \"\n \"explanations, or other content alongside a JSON schema.\\n\\n\"\n \"Your task:\\n\"\n \"- Extract only the JSON schema.\\n\"\n \"- Return it as valid JSON.\\n\"\n \"- Do not include format instructions, explanations, or extra text.\\n\\n\"\n \"Input:\\n\"\n f\"{json.dumps(schema_dict, indent=2)}\\n\\n\"\n \"Output (only JSON schema):\"\n )\n system_components.append(schema_info)\n except (ValidationError, ValueError, TypeError, KeyError) as e:\n await logger.aerror(f\"Could not build schema for prompt: {e}\", exc_info=True)\n\n # Combine all components\n combined_instructions = \"\\n\\n\".join(system_components) if system_components else \"\"\n llm_model, self.chat_history, self.tools = await self.get_agent_requirements()\n self.set(\n llm=llm_model,\n tools=self.tools or [],\n chat_history=self.chat_history,\n input_value=self.input_value,\n system_prompt=combined_instructions,\n )\n\n # Create and run structured chat agent\n try:\n structured_agent = self.create_agent_runnable()\n except (NotImplementedError, ValueError, TypeError) as e:\n await logger.aerror(f\"Error with structured chat agent: {e}\")\n raise\n try:\n result = await self.run_agent(structured_agent)\n except (\n ExceptionWithMessageError,\n ValueError,\n TypeError,\n RuntimeError,\n ) as e:\n await logger.aerror(f\"Error with structured agent result: {e}\")\n raise\n # Extract content from structured agent result\n if hasattr(result, \"content\"):\n content = result.content\n elif hasattr(result, \"text\"):\n content = result.text\n else:\n content = str(result)\n\n except (\n ExceptionWithMessageError,\n ValueError,\n TypeError,\n NotImplementedError,\n AttributeError,\n ) as e:\n await logger.aerror(f\"Error with structured chat agent: {e}\")\n # Fallback to regular agent\n content_str = \"No content returned from agent\"\n return Data(data={\"content\": content_str, \"error\": str(e)})\n\n # Process with structured output validation\n try:\n structured_output = await self.build_structured_output_base(content)\n\n # Handle different output formats\n if isinstance(structured_output, list) and structured_output:\n if len(structured_output) == 1:\n return Data(data=structured_output[0])\n return Data(data={\"results\": structured_output})\n if isinstance(structured_output, dict):\n return Data(data=structured_output)\n return Data(data={\"content\": content})\n\n except (ValueError, TypeError) as e:\n await logger.aerror(f\"Error in structured output processing: {e}\")\n return Data(data={\"content\": content, \"error\": str(e)})\n\n async def get_memory_data(self):\n # TODO: This is a temporary fix to avoid message duplication. We should develop a function for this.\n messages = (\n await MemoryComponent(**self.get_base_args())\n .set(\n session_id=self.graph.session_id,\n context_id=self.context_id,\n order=\"Ascending\",\n n_messages=self.n_messages,\n )\n .retrieve_messages()\n )\n return [\n message for message in messages if getattr(message, \"id\", None) != getattr(self.input_value, \"id\", None)\n ]\n\n def update_input_types(self, build_config: dotdict) -> dotdict:\n \"\"\"Update input types for all fields in build_config.\"\"\"\n for key, value in build_config.items():\n if isinstance(value, dict):\n if value.get(\"input_types\") is None:\n build_config[key][\"input_types\"] = []\n elif hasattr(value, \"input_types\") and value.input_types is None:\n value.input_types = []\n return build_config\n\n async def update_build_config(\n self,\n build_config: dotdict,\n field_value: list[dict],\n field_name: str | None = None,\n ) -> dotdict:\n # Update model options with caching (for all field changes)\n # Agents require tool calling, so filter for only tool-calling capable models\n build_config = handle_model_input_update(\n component=self,\n build_config=dict(build_config),\n field_value=field_value,\n field_name=field_name,\n cache_key_prefix=\"language_model_options_tool_calling\",\n get_options_func=lambda user_id=None: get_language_model_options(user_id=user_id, tool_calling=True),\n )\n build_config = dotdict(build_config)\n\n if field_name == \"model\":\n build_config = self.update_input_types(build_config)\n\n # Validate required keys\n default_keys = [\n \"code\",\n \"_type\",\n \"model\",\n \"tools\",\n \"input_value\",\n \"add_current_date_tool\",\n \"system_prompt\",\n \"agent_description\",\n \"max_iterations\",\n \"handle_parsing_errors\",\n \"verbose\",\n ]\n missing_keys = [key for key in default_keys if key not in build_config]\n if missing_keys:\n msg = f\"Missing required keys in build_config: {missing_keys}\"\n raise ValueError(msg)\n return dotdict({k: v.to_dict() if hasattr(v, \"to_dict\") else v for k, v in build_config.items()})\n\n async def _get_tools(self) -> list[Tool]:\n component_toolkit = get_component_toolkit()\n tools_names = self._build_tools_names()\n agent_description = self.get_tool_description()\n # TODO: Agent Description Depreciated Feature to be removed\n description = f\"{agent_description}{tools_names}\"\n\n tools = component_toolkit(component=self).get_tools(\n tool_name=\"Call_Agent\",\n tool_description=description,\n # here we do not use the shared callbacks as we are exposing the agent as a tool\n callbacks=self.get_langchain_callbacks(),\n )\n if hasattr(self, \"tools_metadata\"):\n tools = component_toolkit(component=self, metadata=self.tools_metadata).update_tools_metadata(tools=tools)\n\n return tools\n"+ },+ "context_id": {"_input_type": "MessageTextInput","advanced": true,- "display_name": "Sender Name",+ "display_name": "Context ID","dynamic": false,- "info": "Name of the sender.",+ "info": "The context ID of the chat. Adds an extra layer to the local memory.","input_types": ["Message"],"list": false,"list_add_label": "Add More","load_from_db": false,- "name": "sender_name",+ "name": "context_id","override_skip": false,"placeholder": "","required": false,@@ -1132,22 +1183,26 @@"trace_as_metadata": true,"track_in_telemetry": false,"type": "str",- "value": "AI"+ "value": ""},- "session_id": {- "_input_type": "MessageTextInput",+ "format_instructions": {+ "_input_type": "MultilineInput","advanced": true,- "display_name": "Session ID",+ "ai_enabled": false,+ "copy_field": false,+ "display_name": "Output Format Instructions","dynamic": false,- "info": "The session ID of the chat. If empty, the current session ID parameter will be used.",+ "info": "Generic Template for structured output formatting. Valid only with Structured response.","input_types": ["Message"],"list": false,"list_add_label": "Add More","load_from_db": false,- "name": "session_id",+ "multiline": true,+ "name": "format_instructions","override_skip": false,+ "password": false,"placeholder": "","required": false,"show": true,@@ -1157,327 +1212,18 @@"trace_as_metadata": true,"track_in_telemetry": false,"type": "str",- "value": ""+ "value": "You are an AI that extracts structured JSON objects from unstructured text. Use a predefined schema with expected types (str, int, float, bool, dict). Extract ALL relevant instances that match the schema - if multiple patterns exist, capture them all. Fill missing or ambiguous values with defaults: null for missing values. Remove exact duplicates but keep variations that have different field values. Always return valid JSON in the expected format, never throw errors. If multiple objects can be extracted, return them all in the structured format."},- "should_store_message": {+ "handle_parsing_errors": {"_input_type": "BoolInput","advanced": true,- "display_name": "Store Messages",+ "display_name": "Handle Parse Errors","dynamic": false,- "info": "Store the message in the history.",+ "info": "Should the Agent fix errors when reading user input for better processing?",+ "input_types": [],"list": false,"list_add_label": "Add More",- "name": "should_store_message",- "override_skip": false,- "placeholder": "",- "required": false,- "show": true,- "title_case": false,- "tool_mode": false,- "trace_as_metadata": true,- "track_in_telemetry": true,- "type": "bool",- "value": true- }- },- "tool_mode": false- },- "showNode": false,- "type": "ChatOutput"- },- "dragging": false,- "id": "ChatOutput-gWl8E",- "measured": {- "height": 52,- "width": 192- },- "position": {- "x": 2570.5017746875496,- "y": 1673.3586604488528- },- "selected": false,- "type": "genericNode"- },- {- "data": {- "description": "Define the agent's instructions, then enter a task to complete using tools.",- "display_name": "Agent",- "id": "Agent-Nfw7u",- "node": {- "base_classes": [- "Message"- ],- "beta": false,- "conditional_paths": [],- "custom_fields": {},- "description": "Define the agent's instructions, then enter a task to complete using tools.",- "display_name": "Agent",- "documentation": "https://docs.langflow.org/agents",- "edited": false,- "field_order": [- "model",- "api_key",- "base_url_ibm_watsonx",- "project_id",- "system_prompt",- "context_id",- "n_messages",- "max_tokens",- "format_instructions",- "output_schema",- "tools",- "input_value",- "handle_parsing_errors",- "verbose",- "max_iterations",- "agent_description",- "add_current_date_tool"- ],- "frozen": false,- "icon": "bot",- "last_updated": "2026-04-17T22:36:44.494Z",- "legacy": false,- "metadata": {- "code_hash": "154c71cf7441",- "dependencies": {- "dependencies": [- {- "name": "pydantic",- "version": "2.12.5"- },- {- "name": "lfx",- "version": "0.4.0"- },- {- "name": "langchain_core",- "version": "1.2.29"- }- ],- "total_dependencies": 3- },- "module": "custom_components.agent"- },- "minimized": false,- "output_types": [],- "outputs": [- {- "allows_loop": false,- "cache": true,- "display_name": "Response",- "group_outputs": false,- "hidden": null,- "loop_types": null,- "method": "message_response",- "name": "response",- "options": null,- "required_inputs": null,- "selected": "Message",- "tool_mode": true,- "types": [- "Message"- ],- "value": "__UNDEFINED__"- }- ],- "pinned": false,- "template": {- "_frontend_node_flow_id": {- "input_types": [],- "value": "1098eea1-6649-4e1d-aed1-b77249fb8dd0"- },- "_frontend_node_folder_id": {- "input_types": [],- "value": "79f95013-41e9-4a4f-af49-f07ec1fac77a"- },- "_type": "Component",- "add_current_date_tool": {- "_input_type": "BoolInput",- "advanced": true,- "display_name": "Current Date",- "dynamic": false,- "info": "If true, will add a tool to the agent that returns the current date.",- "input_types": [],- "list": false,- "list_add_label": "Add More",- "name": "add_current_date_tool",- "override_skip": false,- "placeholder": "",- "required": false,- "show": true,- "title_case": false,- "tool_mode": false,- "trace_as_metadata": true,- "track_in_telemetry": true,- "type": "bool",- "value": true- },- "agent_description": {- "_input_type": "MultilineInput",- "advanced": true,- "ai_enabled": false,- "copy_field": false,- "display_name": "Agent Description [Deprecated]",- "dynamic": false,- "info": "The description of the agent. This is only used when in Tool Mode. Defaults to 'A helpful assistant with access to the following tools:' and tools are added dynamically. This feature is deprecated and will be removed in future versions.",- "input_types": [- "Message"- ],- "list": false,- "list_add_label": "Add More",- "load_from_db": false,- "multiline": true,- "name": "agent_description",- "override_skip": false,- "password": false,- "placeholder": "",- "required": false,- "show": true,- "title_case": false,- "tool_mode": false,- "trace_as_input": true,- "trace_as_metadata": true,- "track_in_telemetry": false,- "type": "str",- "value": "A helpful assistant with access to the following tools:"- },- "api_key": {- "_input_type": "SecretStrInput",- "advanced": true,- "display_name": "API Key",- "dynamic": false,- "info": "Falls back to OPENAI_API_KEY environment variable",- "input_types": [],- "load_from_db": true,- "name": "api_key",- "override_skip": false,- "password": true,- "placeholder": "",- "real_time_refresh": true,- "required": false,- "show": true,- "title_case": false,- "track_in_telemetry": false,- "type": "str",- "value": "OPENAI_API_KEY"- },- "base_url_ibm_watsonx": {- "_input_type": "DropdownInput",- "advanced": false,- "combobox": true,- "dialog_inputs": {},- "display_name": "watsonx API Endpoint",- "dynamic": false,- "external_options": {},- "info": "The base URL of the API (IBM watsonx.ai only)",- "input_types": [],- "load_from_db": false,- "name": "base_url_ibm_watsonx",- "options": [- "https://us-south.ml.cloud.ibm.com",- "https://eu-de.ml.cloud.ibm.com",- "https://eu-gb.ml.cloud.ibm.com",- "https://au-syd.ml.cloud.ibm.com",- "https://jp-tok.ml.cloud.ibm.com",- "https://ca-tor.ml.cloud.ibm.com"- ],- "options_metadata": [],- "override_skip": false,- "placeholder": "",- "real_time_refresh": true,- "required": false,- "show": false,- "title_case": false,- "toggle": false,- "tool_mode": false,- "trace_as_metadata": true,- "track_in_telemetry": true,- "type": "str",- "value": ""- },- "code": {- "advanced": true,- "dynamic": true,- "fileTypes": [],- "file_path": "",- "info": "",- "input_types": [],- "list": false,- "load_from_db": false,- "multiline": true,- "name": "code",- "password": false,- "placeholder": "",- "required": true,- "show": true,- "title_case": false,- "type": "code",- "value": "from __future__ import annotations\n\nimport json\nimport re\nfrom typing import TYPE_CHECKING\n\nfrom pydantic import ValidationError\n\nfrom lfx.components.models_and_agents.memory import MemoryComponent\n\nif TYPE_CHECKING:\n from langchain_core.tools import Tool\n\nfrom lfx.base.agents.agent import LCToolsAgentComponent\nfrom lfx.base.agents.events import ExceptionWithMessageError\nfrom lfx.base.models.unified_models import (\n get_language_model_options,\n get_llm,\n handle_model_input_update,\n)\nfrom lfx.base.models.watsonx_constants import IBM_WATSONX_URLS\nfrom lfx.components.agentics.helpers.model_config import validate_model_selection\nfrom lfx.components.helpers import CurrentDateComponent\nfrom lfx.components.langchain_utilities.tool_calling import ToolCallingAgentComponent\nfrom lfx.custom.custom_component.component import get_component_toolkit\nfrom lfx.field_typing.range_spec import RangeSpec\nfrom lfx.helpers.base_model import build_model_from_schema\nfrom lfx.inputs.inputs import BoolInput, DropdownInput, ModelInput, StrInput\nfrom lfx.io import IntInput, MessageTextInput, MultilineInput, Output, SecretStrInput, TableInput\nfrom lfx.log.logger import logger\nfrom lfx.schema.data import Data\nfrom lfx.schema.dotdict import dotdict\nfrom lfx.schema.message import Message\nfrom lfx.schema.table import EditMode\n\n\ndef set_advanced_true(component_input):\n component_input.advanced = True\n return component_input\n\n\nclass AgentComponent(ToolCallingAgentComponent):\n display_name: str = \"Agent\"\n description: str = \"Define the agent's instructions, then enter a task to complete using tools.\"\n documentation: str = \"https://docs.langflow.org/agents\"\n icon = \"bot\"\n beta = False\n name = \"Agent\"\n\n memory_inputs = [set_advanced_true(component_input) for component_input in MemoryComponent().inputs]\n\n inputs = [\n ModelInput(\n name=\"model\",\n display_name=\"Language Model\",\n info=\"Select your model provider\",\n real_time_refresh=True,\n required=True,\n ),\n SecretStrInput(\n name=\"api_key\",\n display_name=\"API Key\",\n info=\"Overrides global provider settings. Leave blank to use your pre-configured API Key.\",\n real_time_refresh=True,\n advanced=True,\n ),\n DropdownInput(\n name=\"base_url_ibm_watsonx\",\n display_name=\"watsonx API Endpoint\",\n info=\"The base URL of the API (IBM watsonx.ai only)\",\n options=IBM_WATSONX_URLS,\n value=IBM_WATSONX_URLS[0],\n combobox=True,\n show=False,\n real_time_refresh=True,\n ),\n StrInput(\n name=\"project_id\",\n display_name=\"watsonx Project ID\",\n info=\"The project ID associated with the foundation model (IBM watsonx.ai only)\",\n show=False,\n required=False,\n ),\n MultilineInput(\n name=\"system_prompt\",\n display_name=\"Agent Instructions\",\n info=\"System Prompt: Initial instructions and context provided to guide the agent's behavior.\",\n value=\"You are a helpful assistant that can use tools to answer questions and perform tasks.\",\n advanced=False,\n ),\n MessageTextInput(\n name=\"context_id\",\n display_name=\"Context ID\",\n info=\"The context ID of the chat. Adds an extra layer to the local memory.\",\n value=\"\",\n advanced=True,\n ),\n IntInput(\n name=\"n_messages\",\n display_name=\"Number of Chat History Messages\",\n value=100,\n info=\"Number of chat history messages to retrieve.\",\n advanced=True,\n show=True,\n ),\n IntInput(\n name=\"max_tokens\",\n display_name=\"Max Tokens\",\n info=\"Maximum number of tokens to generate. Field name varies by provider.\",\n advanced=True,\n range_spec=RangeSpec(min=1, max=128000, step=1, step_type=\"int\"),\n ),\n MultilineInput(\n name=\"format_instructions\",\n display_name=\"Output Format Instructions\",\n info=\"Generic Template for structured output formatting. Valid only with Structured response.\",\n value=(\n \"You are an AI that extracts structured JSON objects from unstructured text. \"\n \"Use a predefined schema with expected types (str, int, float, bool, dict). \"\n \"Extract ALL relevant instances that match the schema - if multiple patterns exist, capture them all. \"\n \"Fill missing or ambiguous values with defaults: null for missing values. \"\n \"Remove exact duplicates but keep variations that have different field values. \"\n \"Always return valid JSON in the expected format, never throw errors. \"\n \"If multiple objects can be extracted, return them all in the structured format.\"\n ),\n advanced=True,\n ),\n TableInput(\n name=\"output_schema\",\n display_name=\"Output Schema\",\n info=(\n \"Schema Validation: Define the structure and data types for structured output. \"\n \"No validation if no output schema.\"\n ),\n advanced=True,\n required=False,\n value=[],\n table_schema=[\n {\n \"name\": \"name\",\n \"display_name\": \"Name\",\n \"type\": \"str\",\n \"description\": \"Specify the name of the output field.\",\n \"default\": \"field\",\n \"edit_mode\": EditMode.INLINE,\n },\n {\n \"name\": \"description\",\n \"display_name\": \"Description\",\n \"type\": \"str\",\n \"description\": \"Describe the purpose of the output field.\",\n \"default\": \"description of field\",\n \"edit_mode\": EditMode.POPOVER,\n },\n {\n \"name\": \"type\",\n \"display_name\": \"Type\",\n \"type\": \"str\",\n \"edit_mode\": EditMode.INLINE,\n \"description\": (\"Indicate the data type of the output field (e.g., str, int, float, bool, dict).\"),\n \"options\": [\"str\", \"int\", \"float\", \"bool\", \"dict\"],\n \"default\": \"str\",\n },\n {\n \"name\": \"multiple\",\n \"display_name\": \"As List\",\n \"type\": \"boolean\",\n \"description\": \"Set to True if this output field should be a list of the specified type.\",\n \"default\": \"False\",\n \"edit_mode\": EditMode.INLINE,\n },\n ],\n ),\n *LCToolsAgentComponent.get_base_inputs(),\n # removed memory inputs from agent component\n # *memory_inputs,\n BoolInput(\n name=\"add_current_date_tool\",\n display_name=\"Current Date\",\n advanced=True,\n info=\"If true, will add a tool to the agent that returns the current date.\",\n value=True,\n ),\n ]\n outputs = [\n Output(name=\"response\", display_name=\"Response\", method=\"message_response\"),\n ]\n\n def _resolve_selected_model(self):\n \"\"\"Resolve the selected model, including legacy agent_llm/model_name inputs.\"\"\"\n try:\n from langchain_core.language_models import BaseLanguageModel\n\n if isinstance(self.model, BaseLanguageModel):\n return self.model\n except ImportError:\n pass\n\n if isinstance(self.model, list) and self.model:\n return self.model\n\n legacy_provider = getattr(self, \"agent_llm\", None)\n legacy_model_name = getattr(self, \"model_name\", None)\n if not legacy_provider or not legacy_model_name:\n return self.model\n\n options = get_language_model_options(user_id=self.user_id)\n for option in options:\n if option.get(\"provider\") == legacy_provider and option.get(\"name\") == legacy_model_name:\n return [option]\n\n return [\n {\n \"name\": legacy_model_name,\n \"provider\": legacy_provider,\n \"metadata\": {},\n }\n ]\n\n def _get_max_tokens_value(self):\n \"\"\"Return the user-supplied max_tokens or None when unset/zero.\"\"\"\n val = getattr(self, \"max_tokens\", None)\n if val in {\"\", 0}:\n return None\n return val\n\n def _get_llm(self):\n \"\"\"Override parent to include max_tokens from the Agent's input field.\"\"\"\n return get_llm(\n model=self.model,\n user_id=self.user_id,\n api_key=getattr(self, \"api_key\", None),\n max_tokens=self._get_max_tokens_value(),\n watsonx_url=getattr(self, \"base_url_ibm_watsonx\", None),\n watsonx_project_id=getattr(self, \"project_id\", None),\n )\n\n async def get_agent_requirements(self):\n \"\"\"Get the agent requirements for the agent.\"\"\"\n from langchain_core.tools import StructuredTool\n\n selected_model = self._resolve_selected_model()\n try:\n from langchain_core.language_models import BaseLanguageModel\n\n is_connected_model = isinstance(selected_model, BaseLanguageModel)\n except ImportError:\n is_connected_model = False\n\n if not is_connected_model:\n validate_model_selection(selected_model)\n\n # Ensure _get_llm() uses the resolved model (e.g. from legacy agent_llm/model_name)\n self.model = selected_model\n llm_model = self._get_llm()\n if llm_model is None:\n msg = \"No language model selected. Please choose a model to proceed.\"\n raise ValueError(msg)\n\n # Get memory data\n self.chat_history = await self.get_memory_data()\n await logger.adebug(f\"Retrieved {len(self.chat_history)} chat history messages\")\n if isinstance(self.chat_history, Message):\n self.chat_history = [self.chat_history]\n\n # Add current date tool if enabled\n if self.add_current_date_tool:\n if not isinstance(self.tools, list): # type: ignore[has-type]\n self.tools = []\n current_date_tool = (await CurrentDateComponent(**self.get_base_args()).to_toolkit()).pop(0)\n\n if not isinstance(current_date_tool, StructuredTool):\n msg = \"CurrentDateComponent must be converted to a StructuredTool\"\n raise TypeError(msg)\n self.tools.append(current_date_tool)\n\n # Set shared callbacks for tracing the tools used by the agent\n self.set_tools_callbacks(self.tools, self._get_shared_callbacks())\n\n return llm_model, self.chat_history, self.tools\n\n async def message_response(self) -> Message:\n try:\n llm_model, self.chat_history, self.tools = await self.get_agent_requirements()\n # Set up and run agent\n self.set(\n llm=llm_model,\n tools=self.tools or [],\n chat_history=self.chat_history,\n input_value=self.input_value,\n system_prompt=self.system_prompt,\n )\n agent = self.create_agent_runnable()\n result = await self.run_agent(agent)\n\n # Store result for potential JSON output\n self._agent_result = result\n\n except (ValueError, TypeError, KeyError) as e:\n await logger.aerror(f\"{type(e).__name__}: {e!s}\")\n raise\n except ExceptionWithMessageError as e:\n await logger.aerror(f\"ExceptionWithMessageError occurred: {e}\")\n raise\n # Avoid catching blind Exception; let truly unexpected exceptions propagate\n except Exception as e:\n await logger.aerror(f\"Unexpected error: {e!s}\")\n raise\n else:\n return result\n\n def _preprocess_schema(self, schema):\n \"\"\"Preprocess schema to ensure correct data types for build_model_from_schema.\"\"\"\n processed_schema = []\n for field in schema:\n processed_field = {\n \"name\": str(field.get(\"name\", \"field\")),\n \"type\": str(field.get(\"type\", \"str\")),\n \"description\": str(field.get(\"description\", \"\")),\n \"multiple\": field.get(\"multiple\", False),\n }\n # Ensure multiple is handled correctly\n if isinstance(processed_field[\"multiple\"], str):\n processed_field[\"multiple\"] = processed_field[\"multiple\"].lower() in [\n \"true\",\n \"1\",\n \"t\",\n \"y\",\n \"yes\",\n ]\n processed_schema.append(processed_field)\n return processed_schema\n\n async def build_structured_output_base(self, content: str):\n \"\"\"Build structured output with optional BaseModel validation.\"\"\"\n json_pattern = r\"\\{.*\\}\"\n schema_error_msg = \"Try setting an output schema\"\n\n # Try to parse content as JSON first\n json_data = None\n try:\n json_data = json.loads(content)\n except json.JSONDecodeError:\n json_match = re.search(json_pattern, content, re.DOTALL)\n if json_match:\n try:\n json_data = json.loads(json_match.group())\n except json.JSONDecodeError:\n return {\"content\": content, \"error\": schema_error_msg}\n else:\n return {\"content\": content, \"error\": schema_error_msg}\n\n # If no output schema provided, return parsed JSON without validation\n if not hasattr(self, \"output_schema\") or not self.output_schema or len(self.output_schema) == 0:\n return json_data\n\n # Use BaseModel validation with schema\n try:\n processed_schema = self._preprocess_schema(self.output_schema)\n output_model = build_model_from_schema(processed_schema)\n\n # Validate against the schema\n if isinstance(json_data, list):\n # Multiple objects\n validated_objects = []\n for item in json_data:\n try:\n validated_obj = output_model.model_validate(item)\n validated_objects.append(validated_obj.model_dump())\n except ValidationError as e:\n await logger.aerror(f\"Validation error for item: {e}\")\n # Include invalid items with error info\n validated_objects.append({\"data\": item, \"validation_error\": str(e)})\n return validated_objects\n\n # Single object\n try:\n validated_obj = output_model.model_validate(json_data)\n return [validated_obj.model_dump()] # Return as list for consistency\n except ValidationError as e:\n await logger.aerror(f\"Validation error: {e}\")\n return [{\"data\": json_data, \"validation_error\": str(e)}]\n\n except (TypeError, ValueError) as e:\n await logger.aerror(f\"Error building structured output: {e}\")\n # Fallback to parsed JSON without validation\n return json_data\n\n async def json_response(self) -> Data:\n \"\"\"Convert agent response to structured JSON Data output with schema validation.\"\"\"\n # Always use structured chat agent for JSON response mode for better JSON formatting\n try:\n system_components = []\n\n # 1. Agent Instructions (system_prompt)\n agent_instructions = getattr(self, \"system_prompt\", \"\") or \"\"\n if agent_instructions:\n system_components.append(f\"{agent_instructions}\")\n\n # 2. Format Instructions\n format_instructions = getattr(self, \"format_instructions\", \"\") or \"\"\n if format_instructions:\n system_components.append(f\"Format instructions: {format_instructions}\")\n\n # 3. Schema Information from BaseModel\n if hasattr(self, \"output_schema\") and self.output_schema and len(self.output_schema) > 0:\n try:\n processed_schema = self._preprocess_schema(self.output_schema)\n output_model = build_model_from_schema(processed_schema)\n schema_dict = output_model.model_json_schema()\n schema_info = (\n \"You are given some text that may include format instructions, \"\n \"explanations, or other content alongside a JSON schema.\\n\\n\"\n \"Your task:\\n\"\n \"- Extract only the JSON schema.\\n\"\n \"- Return it as valid JSON.\\n\"\n \"- Do not include format instructions, explanations, or extra text.\\n\\n\"\n \"Input:\\n\"\n f\"{json.dumps(schema_dict, indent=2)}\\n\\n\"\n \"Output (only JSON schema):\"\n )\n system_components.append(schema_info)\n except (ValidationError, ValueError, TypeError, KeyError) as e:\n await logger.aerror(f\"Could not build schema for prompt: {e}\", exc_info=True)\n\n # Combine all components\n combined_instructions = \"\\n\\n\".join(system_components) if system_components else \"\"\n llm_model, self.chat_history, self.tools = await self.get_agent_requirements()\n self.set(\n llm=llm_model,\n tools=self.tools or [],\n chat_history=self.chat_history,\n input_value=self.input_value,\n system_prompt=combined_instructions,\n )\n\n # Create and run structured chat agent\n try:\n structured_agent = self.create_agent_runnable()\n except (NotImplementedError, ValueError, TypeError) as e:\n await logger.aerror(f\"Error with structured chat agent: {e}\")\n raise\n try:\n result = await self.run_agent(structured_agent)\n except (\n ExceptionWithMessageError,\n ValueError,\n TypeError,\n RuntimeError,\n ) as e:\n await logger.aerror(f\"Error with structured agent result: {e}\")\n raise\n # Extract content from structured agent result\n if hasattr(result, \"content\"):\n content = result.content\n elif hasattr(result, \"text\"):\n content = result.text\n else:\n content = str(result)\n\n except (\n ExceptionWithMessageError,\n ValueError,\n TypeError,\n NotImplementedError,\n AttributeError,\n ) as e:\n await logger.aerror(f\"Error with structured chat agent: {e}\")\n # Fallback to regular agent\n content_str = \"No content returned from agent\"\n return Data(data={\"content\": content_str, \"error\": str(e)})\n\n # Process with structured output validation\n try:\n structured_output = await self.build_structured_output_base(content)\n\n # Handle different output formats\n if isinstance(structured_output, list) and structured_output:\n if len(structured_output) == 1:\n return Data(data=structured_output[0])\n return Data(data={\"results\": structured_output})\n if isinstance(structured_output, dict):\n return Data(data=structured_output)\n return Data(data={\"content\": content})\n\n except (ValueError, TypeError) as e:\n await logger.aerror(f\"Error in structured output processing: {e}\")\n return Data(data={\"content\": content, \"error\": str(e)})\n\n async def get_memory_data(self):\n # TODO: This is a temporary fix to avoid message duplication. We should develop a function for this.\n messages = (\n await MemoryComponent(**self.get_base_args())\n .set(\n session_id=self.graph.session_id,\n context_id=self.context_id,\n order=\"Ascending\",\n n_messages=self.n_messages,\n )\n .retrieve_messages()\n )\n return [\n message for message in messages if getattr(message, \"id\", None) != getattr(self.input_value, \"id\", None)\n ]\n\n def update_input_types(self, build_config: dotdict) -> dotdict:\n \"\"\"Update input types for all fields in build_config.\"\"\"\n for key, value in build_config.items():\n if isinstance(value, dict):\n if value.get(\"input_types\") is None:\n build_config[key][\"input_types\"] = []\n elif hasattr(value, \"input_types\") and value.input_types is None:\n value.input_types = []\n return build_config\n\n async def update_build_config(\n self,\n build_config: dotdict,\n field_value: list[dict],\n field_name: str | None = None,\n ) -> dotdict:\n # Update model options with caching (for all field changes)\n # Agents require tool calling, so filter for only tool-calling capable models\n build_config = handle_model_input_update(\n component=self,\n build_config=dict(build_config),\n field_value=field_value,\n field_name=field_name,\n cache_key_prefix=\"language_model_options_tool_calling\",\n get_options_func=lambda user_id=None: get_language_model_options(user_id=user_id, tool_calling=True),\n )\n build_config = dotdict(build_config)\n\n if field_name == \"model\":\n build_config = self.update_input_types(build_config)\n\n # Validate required keys\n default_keys = [\n \"code\",\n \"_type\",\n \"model\",\n \"tools\",\n \"input_value\",\n \"add_current_date_tool\",\n \"system_prompt\",\n \"agent_description\",\n \"max_iterations\",\n \"handle_parsing_errors\",\n \"verbose\",\n ]\n missing_keys = [key for key in default_keys if key not in build_config]\n if missing_keys:\n msg = f\"Missing required keys in build_config: {missing_keys}\"\n raise ValueError(msg)\n return dotdict({k: v.to_dict() if hasattr(v, \"to_dict\") else v for k, v in build_config.items()})\n\n async def _get_tools(self) -> list[Tool]:\n component_toolkit = get_component_toolkit()\n tools_names = self._build_tools_names()\n agent_description = self.get_tool_description()\n # TODO: Agent Description Depreciated Feature to be removed\n description = f\"{agent_description}{tools_names}\"\n\n tools = component_toolkit(component=self).get_tools(\n tool_name=\"Call_Agent\",\n tool_description=description,\n # here we do not use the shared callbacks as we are exposing the agent as a tool\n callbacks=self.get_langchain_callbacks(),\n )\n if hasattr(self, \"tools_metadata\"):\n tools = component_toolkit(component=self, metadata=self.tools_metadata).update_tools_metadata(tools=tools)\n\n return tools\n"- },- "context_id": {- "_input_type": "MessageTextInput",- "advanced": true,- "display_name": "Context ID",- "dynamic": false,- "info": "The context ID of the chat. Adds an extra layer to the local memory.",- "input_types": [- "Message"- ],- "list": false,- "list_add_label": "Add More",- "load_from_db": false,- "name": "context_id",- "override_skip": false,- "placeholder": "",- "required": false,- "show": true,- "title_case": false,- "tool_mode": false,- "trace_as_input": true,- "trace_as_metadata": true,- "track_in_telemetry": false,- "type": "str",- "value": ""- },- "format_instructions": {- "_input_type": "MultilineInput",- "advanced": true,- "ai_enabled": false,- "copy_field": false,- "display_name": "Output Format Instructions",- "dynamic": false,- "info": "Generic Template for structured output formatting. Valid only with Structured response.",- "input_types": [- "Message"- ],- "list": false,- "list_add_label": "Add More",- "load_from_db": false,- "multiline": true,- "name": "format_instructions",- "override_skip": false,- "password": false,- "placeholder": "",- "required": false,- "show": true,- "title_case": false,- "tool_mode": false,- "trace_as_input": true,- "trace_as_metadata": true,- "track_in_telemetry": false,- "type": "str",- "value": "You are an AI that extracts structured JSON objects from unstructured text. Use a predefined schema with expected types (str, int, float, bool, dict). Extract ALL relevant instances that match the schema - if multiple patterns exist, capture them all. Fill missing or ambiguous values with defaults: null for missing values. Remove exact duplicates but keep variations that have different field values. Always return valid JSON in the expected format, never throw errors. If multiple objects can be extracted, return them all in the structured format."- },- "handle_parsing_errors": {- "_input_type": "BoolInput",- "advanced": true,- "display_name": "Handle Parse Errors",- "dynamic": false,- "info": "Should the Agent fix errors when reading user input for better processing?",- "input_types": [],- "list": false,- "list_add_label": "Add More",- "name": "handle_parsing_errors",+ "name": "handle_parsing_errors","override_skip": false,"placeholder": "","required": false,@@ -1670,6 +1416,47 @@"name": "gpt-5.2","provider": "OpenAI"},+ {+ "category": "OpenAI",+ "icon": "OpenAI",+ "metadata": {+ "api_key_param": "api_key",+ "context_length": 128000,+ "max_tokens_field_name": "max_tokens",+ "model_class": "ChatOpenAI",+ "model_name_param": "model"+ },+ "name": "gpt-4o",+ "provider": "OpenAI"+ },+ {+ "category": "Ollama",+ "icon": "Ollama",+ "metadata": {+ "api_key_param": "api_key",+ "base_url_param": "base_url",+ "context_length": 128000,+ "max_tokens_field_name": "max_tokens",+ "model_class": "ChatOllama",+ "model_name_param": "model"+ },+ "name": "gpt-oss:20b",+ "provider": "Ollama"+ },+ {+ "category": "Ollama",+ "icon": "Ollama",+ "metadata": {+ "api_key_param": "api_key",+ "base_url_param": "base_url",+ "context_length": 128000,+ "max_tokens_field_name": "max_tokens",+ "model_class": "ChatOllama",+ "model_name_param": "model"+ },+ "name": "qwen3:8b",+ "provider": "Ollama"+ },{"category": "IBM WatsonX","icon": "WatsonxAI",@@ -1744,20 +1531,6 @@},"name": "meta-llama/llama-3-3-70b-instruct","provider": "IBM WatsonX"- },- {- "category": "OpenAI",- "icon": "OpenAI",- "metadata": {- "api_key_param": "api_key",- "context_length": 128000,- "max_tokens_field_name": "max_tokens",- "model_class": "ChatOpenAI",- "model_name_param": "model",- "not_enabled_locally": true- },- "name": "gpt-4o",- "provider": "OpenAI"}],"override_skip": false,@@ -1983,8 +1756,8 @@"width": 320},"position": {- "x": 2063.120880097103,- "y": 1543.154271545972+ "x": 2064.9341782775937,+ "y": 1693.5833129555906},"selected": false,"type": "genericNode"@@ -2010,7 +1783,7 @@],"frozen": false,"icon": "calculator",- "last_updated": "2026-04-17T22:36:44.495Z",+ "last_updated": "2026-04-28T13:28:59.343Z","legacy": false,"lf_version": "1.9.0","metadata": {@@ -2054,7 +1827,7 @@"value": "1098eea1-6649-4e1d-aed1-b77249fb8dd0"},"_frontend_node_folder_id": {- "value": "79f95013-41e9-4a4f-af49-f07ec1fac77a"+ "value": "3b7ac23f-e74d-4fa3-ae00-a54b24a27f93"},"_type": "Component","code": {@@ -2239,7 +2012,7 @@"value": "1098eea1-6649-4e1d-aed1-b77249fb8dd0"},"_frontend_node_folder_id": {- "value": "79f95013-41e9-4a4f-af49-f07ec1fac77a"+ "value": "3b7ac23f-e74d-4fa3-ae00-a54b24a27f93"},"_type": "Component","api_base": {@@ -2289,13 +2062,13 @@},"base_url_ibm_watsonx": {"_input_type": "DropdownInput",- "advanced": false,+ "advanced": true,"combobox": true,"dialog_inputs": {},"display_name": "watsonx API Endpoint","dynamic": false,"external_options": {},- "info": "The base URL of the API (IBM watsonx.ai only)",+ "info": "Falls back to WATSONX_URL environment variable","load_from_db": false,"name": "base_url_ibm_watsonx","options": [@@ -2399,7 +2172,7 @@"type": "bool","value": true},- "is_refresh": false,+ "is_refresh": true,"max_retries": {"_input_type": "IntInput","advanced": true,@@ -2509,6 +2282,23 @@"name": "text-embedding-ada-002","provider": "OpenAI"},+ {+ "category": "Ollama",+ "icon": "Ollama",+ "metadata": {+ "embedding_class": "OllamaEmbeddings",+ "model_type": "embeddings",+ "param_mapping": {+ "base_url": "base_url",+ "model": "model",+ "model_kwargs": "model_kwargs",+ "num_ctx": "num_ctx",+ "request_timeout": "request_timeout"+ }+ },+ "name": "nomic-embed-text:latest",+ "provider": "Ollama"+ },{"category": "IBM WatsonX","icon": "WatsonxAI",@@ -2613,6 +2403,7 @@"type": "model","value": [{+ "category": "OpenAI","icon": "OpenAI","metadata": {"embedding_class": "OpenAIEmbeddings",@@ -2678,10 +2469,10 @@},"project_id": {"_input_type": "MessageTextInput",- "advanced": false,+ "advanced": true,"display_name": "Project ID","dynamic": false,- "info": "IBM watsonx.ai Project ID (required for IBM watsonx.ai)",+ "info": "Falls back to WATSONX_PROJECT_ID environment variable","input_types": ["Message"],@@ -2777,7 +2568,7 @@"x": 485.72511430199586,"y": 1766.776625779543},- "selected": true,+ "selected": false,"type": "genericNode"},{@@ -2828,7 +2619,7 @@],"frozen": false,"icon": "OpenSearch",- "last_updated": "2026-04-17T22:36:44.499Z",+ "last_updated": "2026-04-28T13:28:59.343Z","legacy": false,"lf_version": "1.9.0","metadata": {@@ -2880,7 +2671,7 @@"value": "1098eea1-6649-4e1d-aed1-b77249fb8dd0"},"_frontend_node_folder_id": {- "value": "79f95013-41e9-4a4f-af49-f07ec1fac77a"+ "value": "3b7ac23f-e74d-4fa3-ae00-a54b24a27f93"},"_type": "Component","auth_mode": {@@ -3635,7 +3426,7 @@],"frozen": false,"icon": "binary",- "last_updated": "2026-04-17T22:36:54.422Z",+ "last_updated": "2026-04-27T15:20:57.737Z","legacy": false,"metadata": {"code_hash": "59c007553b38",@@ -3678,7 +3469,7 @@"value": "1098eea1-6649-4e1d-aed1-b77249fb8dd0"},"_frontend_node_folder_id": {- "value": "79f95013-41e9-4a4f-af49-f07ec1fac77a"+ "value": "3b7ac23f-e74d-4fa3-ae00-a54b24a27f93"},"_type": "Component","api_base": {@@ -3728,13 +3519,13 @@},"base_url_ibm_watsonx": {"_input_type": "DropdownInput",- "advanced": false,+ "advanced": true,"combobox": true,"dialog_inputs": {},"display_name": "watsonx API Endpoint","dynamic": false,"external_options": {},- "info": "The base URL of the API (IBM watsonx.ai only)",+ "info": "Falls back to WATSONX_URL environment variable","load_from_db": false,"name": "base_url_ibm_watsonx","options": [@@ -3838,7 +3629,7 @@"type": "bool","value": true},- "is_refresh": false,+ "is_refresh": true,"max_retries": {"_input_type": "IntInput","advanced": true,@@ -3948,6 +3739,23 @@"name": "text-embedding-ada-002","provider": "OpenAI"},+ {+ "category": "Ollama",+ "icon": "Ollama",+ "metadata": {+ "embedding_class": "OllamaEmbeddings",+ "model_type": "embeddings",+ "param_mapping": {+ "base_url": "base_url",+ "model": "model",+ "model_kwargs": "model_kwargs",+ "num_ctx": "num_ctx",+ "request_timeout": "request_timeout"+ }+ },+ "name": "nomic-embed-text:latest",+ "provider": "Ollama"+ },{"category": "IBM WatsonX","icon": "WatsonxAI",@@ -4052,6 +3860,7 @@"type": "model","value": [{+ "category": "OpenAI","icon": "OpenAI","metadata": {"embedding_class": "OpenAIEmbeddings",@@ -4117,10 +3926,10 @@},"project_id": {"_input_type": "MessageTextInput",- "advanced": false,+ "advanced": true,"display_name": "Project ID","dynamic": false,- "info": "IBM watsonx.ai Project ID (required for IBM watsonx.ai)",+ "info": "Falls back to WATSONX_PROJECT_ID environment variable","input_types": ["Message"],@@ -4297,7 +4106,7 @@"value": "1098eea1-6649-4e1d-aed1-b77249fb8dd0"},"_frontend_node_folder_id": {- "value": "79f95013-41e9-4a4f-af49-f07ec1fac77a"+ "value": "3b7ac23f-e74d-4fa3-ae00-a54b24a27f93"},"_type": "Component","api_base": {@@ -4347,13 +4156,13 @@},"base_url_ibm_watsonx": {"_input_type": "DropdownInput",- "advanced": false,+ "advanced": true,"combobox": true,"dialog_inputs": {},"display_name": "watsonx API Endpoint","dynamic": false,"external_options": {},- "info": "The base URL of the API (IBM watsonx.ai only)",+ "info": "Falls back to WATSONX_URL environment variable","load_from_db": false,"name": "base_url_ibm_watsonx","options": [@@ -4457,7 +4266,7 @@"type": "bool","value": true},- "is_refresh": false,+ "is_refresh": true,"max_retries": {"_input_type": "IntInput","advanced": true,@@ -4567,6 +4376,23 @@"name": "text-embedding-ada-002","provider": "OpenAI"},+ {+ "category": "Ollama",+ "icon": "Ollama",+ "metadata": {+ "embedding_class": "OllamaEmbeddings",+ "model_type": "embeddings",+ "param_mapping": {+ "base_url": "base_url",+ "model": "model",+ "model_kwargs": "model_kwargs",+ "num_ctx": "num_ctx",+ "request_timeout": "request_timeout"+ }+ },+ "name": "nomic-embed-text:latest",+ "provider": "Ollama"+ },{"category": "IBM WatsonX","icon": "WatsonxAI",@@ -4671,6 +4497,7 @@"type": "model","value": [{+ "category": "OpenAI","icon": "OpenAI","metadata": {"embedding_class": "OpenAIEmbeddings",@@ -4736,10 +4563,10 @@},"project_id": {"_input_type": "MessageTextInput",- "advanced": false,+ "advanced": true,"display_name": "Project ID","dynamic": false,- "info": "IBM watsonx.ai Project ID (required for IBM watsonx.ai)",+ "info": "Falls back to WATSONX_PROJECT_ID environment variable","input_types": ["Message"],@@ -5068,26 +4895,191 @@"documentation": "https://docs.langflow.org/text-input-and-output","edited": false,"field_order": [- "input_value",- "use_global_variable"+ "input_value",+ "use_global_variable"+ ],+ "frozen": false,+ "icon": "type",+ "last_updated": "2026-02-27T18:42:16.883Z",+ "legacy": false,+ "lf_version": "1.9.0",+ "metadata": {+ "code_hash": "518f16485886",+ "dependencies": {+ "dependencies": [+ {+ "name": "lfx",+ "version": null+ }+ ],+ "total_dependencies": 1+ },+ "module": "lfx.components.input_output.text.TextInputComponent"+ },+ "minimized": false,+ "output_types": [],+ "outputs": [+ {+ "allows_loop": false,+ "cache": true,+ "display_name": "Output Text",+ "group_outputs": false,+ "loop_types": null,+ "method": "text_response",+ "name": "text",+ "options": null,+ "required_inputs": null,+ "selected": "Message",+ "tool_mode": true,+ "types": [+ "Message"+ ],+ "value": "__UNDEFINED__"+ }+ ],+ "pinned": false,+ "template": {+ "_frontend_node_flow_id": {+ "value": "1098eea1-6649-4e1d-aed1-b77249fb8dd0"+ },+ "_frontend_node_folder_id": {+ "value": "2bef1fdd-4d60-4bb6-8fd2-c0a3eae09d1e"+ },+ "_type": "Component",+ "code": {+ "advanced": true,+ "dynamic": true,+ "fileTypes": [],+ "file_path": "",+ "info": "",+ "list": false,+ "load_from_db": false,+ "multiline": true,+ "name": "code",+ "password": false,+ "placeholder": "",+ "required": true,+ "show": true,+ "title_case": false,+ "type": "code",+ "value": "from typing import Any\n\nfrom lfx.base.io.text import TextComponent\nfrom lfx.io import BoolInput, MultilineInput, Output\nfrom lfx.schema.message import Message\n\n\nclass TextInputComponent(TextComponent):\n display_name = \"Text Input\"\n description = \"Get user text inputs.\"\n documentation: str = \"https://docs.langflow.org/text-input-and-output\"\n icon = \"type\"\n name = \"TextInput\"\n\n inputs = [\n MultilineInput(\n name=\"input_value\",\n display_name=\"Text\",\n info=\"Text to be passed as input.\",\n ),\n BoolInput(\n name=\"use_global_variable\",\n display_name=\"Use Global Variable\",\n info=\"Enable to select from global variables (shows globe icon). Disables multiline editing.\",\n value=False,\n advanced=True,\n real_time_refresh=True,\n ),\n ]\n outputs = [\n Output(display_name=\"Output Text\", name=\"text\", method=\"text_response\"),\n ]\n\n def update_build_config(self, build_config: dict, field_value: Any, field_name: str | None = None) -> dict:\n if field_name == \"use_global_variable\":\n if field_value:\n # Enable global variable mode: single-line with password masking and globe dropdown\n build_config[\"input_value\"][\"multiline\"] = False\n build_config[\"input_value\"][\"password\"] = True\n else:\n # Default mode: multiline text editing\n build_config[\"input_value\"][\"multiline\"] = True\n build_config[\"input_value\"][\"password\"] = False\n return build_config\n\n def text_response(self) -> Message:\n return Message(\n text=self.input_value,\n )\n"+ },+ "input_value": {+ "_input_type": "MultilineInput",+ "advanced": false,+ "ai_enabled": false,+ "copy_field": false,+ "display_name": "Text",+ "dynamic": false,+ "info": "Text to be passed as input.",+ "input_types": [+ "Message"+ ],+ "list": false,+ "list_add_label": "Add More",+ "load_from_db": true,+ "multiline": false,+ "name": "input_value",+ "override_skip": false,+ "password": true,+ "placeholder": "",+ "required": false,+ "show": true,+ "title_case": false,+ "tool_mode": false,+ "trace_as_input": true,+ "trace_as_metadata": true,+ "track_in_telemetry": false,+ "type": "str",+ "value": "OPENRAG-QUERY-FILTER"+ },+ "is_refresh": false,+ "use_global_variable": {+ "_input_type": "BoolInput",+ "advanced": true,+ "display_name": "Use Global Variable",+ "dynamic": false,+ "info": "Enable to select from global variables (shows globe icon). Disables multiline editing.",+ "list": false,+ "list_add_label": "Add More",+ "name": "use_global_variable",+ "override_skip": false,+ "placeholder": "",+ "real_time_refresh": true,+ "required": false,+ "show": true,+ "title_case": false,+ "tool_mode": false,+ "trace_as_metadata": true,+ "track_in_telemetry": true,+ "type": "bool",+ "value": true+ }+ },+ "tool_mode": false+ },+ "showNode": true,+ "type": "TextInput"+ },+ "dragging": false,+ "id": "TextInput-i0a3P",+ "measured": {+ "height": 207,+ "width": 320+ },+ "position": {+ "x": 471.417983121568,+ "y": 2170.275430066397+ },+ "selected": false,+ "type": "genericNode"+ },+ {+ "data": {+ "id": "MCPTools-uu7m3",+ "node": {+ "base_classes": [+ "Table"+ ],+ "beta": false,+ "conditional_paths": [],+ "custom_fields": {},+ "description": "Connect to an MCP server to use its tools.",+ "display_name": "MCP Tools",+ "documentation": "https://docs.langflow.org/mcp-tools",+ "edited": true,+ "field_order": [+ "mcp_server",+ "use_cache",+ "verify_ssl",+ "headers",+ "tool",+ "tool_placeholder"],"frozen": false,- "icon": "type",- "last_updated": "2026-02-27T18:42:16.883Z",+ "icon": "Mcp",+ "last_updated": "2026-04-28T13:55:00.662Z","legacy": false,- "lf_version": "1.9.0","metadata": {- "code_hash": "518f16485886",+ "code_hash": "ccd98ac0a0fb","dependencies": {"dependencies": [+ {+ "name": "langchain_core",+ "version": "1.2.29"+ },{"name": "lfx",- "version": null+ "version": "0.4.0"+ },+ {+ "name": "langflow",+ "version": "1.9.0"}],- "total_dependencies": 1+ "total_dependencies": 3},- "module": "lfx.components.input_output.text.TextInputComponent"+ "module": "custom_components.mcp_tools"},"minimized": false,"output_types": [],@@ -5095,17 +5087,18 @@{"allows_loop": false,"cache": true,- "display_name": "Output Text",+ "display_name": "Toolset","group_outputs": false,+ "hidden": null,"loop_types": null,- "method": "text_response",- "name": "text",+ "method": "to_toolkit",+ "name": "component_as_tool","options": null,"required_inputs": null,- "selected": "Message",+ "selected": "Tool","tool_mode": true,"types": [- "Message"+ "Tool"],"value": "__UNDEFINED__"}@@ -5116,7 +5109,7 @@"value": "1098eea1-6649-4e1d-aed1-b77249fb8dd0"},"_frontend_node_folder_id": {- "value": "2bef1fdd-4d60-4bb6-8fd2-c0a3eae09d1e"+ "value": "3b7ac23f-e74d-4fa3-ae00-a54b24a27f93"},"_type": "Component","code": {@@ -5135,50 +5128,254 @@"show": true,"title_case": false,"type": "code",- "value": "from typing import Any\n\nfrom lfx.base.io.text import TextComponent\nfrom lfx.io import BoolInput, MultilineInput, Output\nfrom lfx.schema.message import Message\n\n\nclass TextInputComponent(TextComponent):\n display_name = \"Text Input\"\n description = \"Get user text inputs.\"\n documentation: str = \"https://docs.langflow.org/text-input-and-output\"\n icon = \"type\"\n name = \"TextInput\"\n\n inputs = [\n MultilineInput(\n name=\"input_value\",\n display_name=\"Text\",\n info=\"Text to be passed as input.\",\n ),\n BoolInput(\n name=\"use_global_variable\",\n display_name=\"Use Global Variable\",\n info=\"Enable to select from global variables (shows globe icon). Disables multiline editing.\",\n value=False,\n advanced=True,\n real_time_refresh=True,\n ),\n ]\n outputs = [\n Output(display_name=\"Output Text\", name=\"text\", method=\"text_response\"),\n ]\n\n def update_build_config(self, build_config: dict, field_value: Any, field_name: str | None = None) -> dict:\n if field_name == \"use_global_variable\":\n if field_value:\n # Enable global variable mode: single-line with password masking and globe dropdown\n build_config[\"input_value\"][\"multiline\"] = False\n build_config[\"input_value\"][\"password\"] = True\n else:\n # Default mode: multiline text editing\n build_config[\"input_value\"][\"multiline\"] = True\n build_config[\"input_value\"][\"password\"] = False\n return build_config\n\n def text_response(self) -> Message:\n return Message(\n text=self.input_value,\n )\n"+ "value": "from __future__ import annotations\n\nimport asyncio\nimport json\nimport uuid\n\nfrom langchain_core.tools import StructuredTool # noqa: TC002\n\nfrom lfx.base.agents.utils import maybe_unflatten_dict, safe_cache_get, safe_cache_set\nfrom lfx.base.mcp.util import (\n MCPStdioClient,\n MCPStreamableHttpClient,\n create_input_schema_from_json_schema,\n update_tools,\n)\nfrom lfx.custom.custom_component.component_with_cache import ComponentWithCache\nfrom lfx.inputs.inputs import InputTypes # noqa: TC001\nfrom lfx.io import BoolInput, DictInput, DropdownInput, McpInput, MessageTextInput, Output, TableInput\nfrom lfx.io.schema import flatten_schema, schema_to_langflow_inputs\nfrom lfx.log.logger import logger\nfrom lfx.schema.dataframe import DataFrame\nfrom lfx.schema.message import Message\nfrom lfx.services.deps import get_storage_service, session_scope\n\n\ndef resolve_mcp_config(\n server_name: str, # noqa: ARG001\n server_config_from_value: dict | None,\n server_config_from_db: dict | None,\n) -> dict | None:\n \"\"\"Resolve MCP server config with proper precedence.\n\n Resolves the configuration for an MCP server with the following precedence:\n 1. Database config (takes priority) - ensures edits are reflected\n 2. Config from value/tweaks (fallback) - allows REST API to provide config for new servers\n\n Args:\n server_name: Name of the MCP server\n server_config_from_value: Config provided via value/tweaks (optional)\n server_config_from_db: Config from database (optional)\n\n Returns:\n Final config to use (DB takes priority, falls back to value)\n Returns None if no config found in either location\n \"\"\"\n if server_config_from_db:\n return server_config_from_db\n return server_config_from_value\n\n\nclass MCPToolsComponent(ComponentWithCache):\n schema_inputs: list = []\n tools: list[StructuredTool] = []\n _not_load_actions: bool = False\n _tool_cache: dict = {}\n _last_selected_server: str | None = None # Cache for the last selected server\n\n def __init__(self, **data) -> None:\n super().__init__(**data)\n # Initialize cache keys to avoid CacheMiss when accessing them\n self._ensure_cache_structure()\n\n # Initialize clients with access to the component cache\n self.stdio_client: MCPStdioClient = MCPStdioClient(component_cache=self._shared_component_cache)\n self.streamable_http_client: MCPStreamableHttpClient = MCPStreamableHttpClient(\n component_cache=self._shared_component_cache\n )\n\n def _ensure_cache_structure(self):\n \"\"\"Ensure the cache has the required structure.\"\"\"\n # Check if servers key exists and is not CacheMiss\n servers_value = safe_cache_get(self._shared_component_cache, \"servers\")\n if servers_value is None:\n safe_cache_set(self._shared_component_cache, \"servers\", {})\n\n # Check if last_selected_server key exists and is not CacheMiss\n last_server_value = safe_cache_get(self._shared_component_cache, \"last_selected_server\")\n if last_server_value is None:\n safe_cache_set(self._shared_component_cache, \"last_selected_server\", \"\")\n\n default_keys: list[str] = [\n \"code\",\n \"_type\",\n \"tool_mode\",\n \"tool_placeholder\",\n \"mcp_server\",\n \"tool\",\n \"use_cache\",\n \"verify_ssl\",\n \"headers\",\n ]\n\n display_name = \"MCP Tools\"\n description = \"Connect to an MCP server to use its tools.\"\n documentation: str = \"https://docs.langflow.org/mcp-tools\"\n icon = \"Mcp\"\n name = \"MCPTools\"\n\n inputs = [\n McpInput(\n name=\"mcp_server\",\n display_name=\"MCP Server\",\n info=\"Select the MCP Server that will be used by this component\",\n real_time_refresh=True,\n ),\n BoolInput(\n name=\"use_cache\",\n display_name=\"Use Cached Server\",\n info=(\n \"Enable caching of MCP Server and tools to improve performance. \"\n \"Disable to always fetch fresh tools and server updates.\"\n ),\n value=False,\n advanced=True,\n ),\n BoolInput(\n name=\"verify_ssl\",\n display_name=\"Verify SSL Certificate\",\n info=(\n \"Enable SSL certificate verification for HTTPS connections. \"\n \"Disable only for development/testing with self-signed certificates.\"\n ),\n value=True,\n advanced=True,\n ),\n TableInput(\n name=\"headers\",\n display_name=\"Headers\",\n info=(\n \"HTTP headers to include with MCP server requests. \"\n \"Useful for authentication (e.g., Authorization header). \"\n \"These headers override any headers configured in the MCP server settings.\"\n ),\n advanced=True,\n table_schema=[\n {\n \"name\": \"key\",\n \"display_name\": \"Key\",\n \"type\": \"string\",\n \"description\": \"Key name\",\n },\n {\n \"name\": \"value\",\n \"display_name\": \"Value\",\n \"load_from_db\": True,\n \"type\": \"string\",\n \"description\": \"Value of the header\",\n },\n ],\n value={},\n input_types=[\"Data\", \"JSON\"],\n ),\n DropdownInput(\n name=\"tool\",\n display_name=\"Tool\",\n options=[],\n value=\"\",\n info=\"Select the tool to execute\",\n show=False,\n required=True,\n real_time_refresh=True,\n refresh_button=True,\n ),\n MessageTextInput(\n name=\"tool_placeholder\",\n display_name=\"Tool Placeholder\",\n info=\"Placeholder for the tool\",\n value=\"\",\n show=False,\n tool_mode=False,\n ),\n ]\n\n outputs = [\n Output(display_name=\"Response\", name=\"response\", method=\"build_output\"),\n ]\n\n async def _validate_schema_inputs(self, tool_obj) -> list[InputTypes]:\n \"\"\"Validate and process schema inputs for a tool.\"\"\"\n try:\n if not tool_obj or not hasattr(tool_obj, \"args_schema\"):\n msg = \"Invalid tool object or missing input schema\"\n raise ValueError(msg)\n\n flat_schema = flatten_schema(tool_obj.args_schema.schema())\n input_schema = create_input_schema_from_json_schema(flat_schema)\n if not input_schema:\n msg = f\"Empty input schema for tool '{tool_obj.name}'\"\n raise ValueError(msg)\n\n schema_inputs = schema_to_langflow_inputs(input_schema)\n if not schema_inputs:\n msg = f\"No input parameters defined for tool '{tool_obj.name}'\"\n await logger.awarning(msg)\n return []\n\n except Exception as e:\n msg = f\"Error validating schema inputs: {e!s}\"\n await logger.aexception(msg)\n raise ValueError(msg) from e\n else:\n return schema_inputs\n\n async def update_tool_list(self, mcp_server_value=None):\n # Accepts mcp_server_value as dict {name, config} or uses self.mcp_server\n mcp_server = mcp_server_value if mcp_server_value is not None else getattr(self, \"mcp_server\", None)\n server_name = None\n server_config_from_value = None\n if isinstance(mcp_server, dict):\n server_name = mcp_server.get(\"name\")\n server_config_from_value = mcp_server.get(\"config\")\n else:\n server_name = mcp_server\n if not server_name:\n self.tools = []\n return [], {\"name\": server_name, \"config\": server_config_from_value}\n\n # Check if caching is enabled, default to False\n use_cache = getattr(self, \"use_cache\", False)\n\n # Use shared cache if available and caching is enabled\n cached = None\n if use_cache:\n servers_cache = safe_cache_get(self._shared_component_cache, \"servers\", {})\n cached = servers_cache.get(server_name) if isinstance(servers_cache, dict) else None\n\n if cached is not None:\n try:\n self.tools = cached[\"tools\"]\n self.tool_names = cached[\"tool_names\"]\n self._tool_cache = cached[\"tool_cache\"]\n server_config_from_value = cached[\"config\"]\n except (TypeError, KeyError, AttributeError) as e:\n # Handle corrupted cache data by clearing it and continuing to fetch fresh tools\n msg = f\"Unable to use cached data for MCP Server{server_name}: {e}\"\n await logger.awarning(msg)\n # Clear the corrupted cache entry\n current_servers_cache = safe_cache_get(self._shared_component_cache, \"servers\", {})\n if isinstance(current_servers_cache, dict) and server_name in current_servers_cache:\n current_servers_cache.pop(server_name)\n safe_cache_set(self._shared_component_cache, \"servers\", current_servers_cache)\n else:\n return self.tools, {\"name\": server_name, \"config\": server_config_from_value}\n\n try:\n # Try to fetch from database first to ensure we have the latest config\n # This ensures database updates (like editing a server) take effect\n try:\n from langflow.api.v2.mcp import get_server\n from langflow.services.database.models.user.crud import get_user_by_id\n\n from lfx.services.deps import get_settings_service\n except ImportError as e:\n msg = (\n \"Langflow MCP server functionality is not available. \"\n \"This feature requires the full Langflow installation.\"\n )\n raise ImportError(msg) from e\n\n server_config_from_db = None\n async with session_scope() as db:\n if not self.user_id:\n msg = \"User ID is required for fetching MCP tools.\"\n raise ValueError(msg)\n current_user = await get_user_by_id(db, self.user_id)\n\n # Try to get server config from DB/API\n server_config_from_db = await get_server(\n server_name,\n current_user,\n db,\n storage_service=get_storage_service(),\n settings_service=get_settings_service(),\n )\n\n # Resolve config with proper precedence: DB takes priority, falls back to value\n server_config = resolve_mcp_config(\n server_name=server_name,\n server_config_from_value=server_config_from_value,\n server_config_from_db=server_config_from_db,\n )\n\n if not server_config:\n self.tools = []\n return [], {\"name\": server_name, \"config\": server_config}\n\n # Add verify_ssl option to server config if not present\n if \"verify_ssl\" not in server_config:\n verify_ssl = getattr(self, \"verify_ssl\", True)\n server_config[\"verify_ssl\"] = verify_ssl\n\n # Merge headers from component input with server config headers\n # Component headers take precedence over server config headers\n component_headers = getattr(self, \"headers\", None)\n if component_headers:\n # Convert list of {\"key\": k, \"value\": v}, Data objects, or dicts to dict\n component_headers_dict = {}\n\n # TableInput.validate_value normalizes single items to lists\n items = component_headers if isinstance(component_headers, list) else [component_headers]\n\n for item in items:\n if not item:\n continue\n\n # Case 1: Data object (Langflow standard)\n if hasattr(item, \"data\") and isinstance(item.data, dict):\n data = item.data\n if \"key\" in data and \"value\" in data:\n component_headers_dict[str(data[\"key\"])] = str(data[\"value\"])\n else:\n # Fallback: merge all keys from Data object (excluding internal keys)\n for k, v in data.items():\n if k not in (\"text_key\", \"default_value\"):\n component_headers_dict[str(k)] = str(v)\n\n # Case 2: Dictionary (Table row or direct JSON)\n elif isinstance(item, dict):\n if \"key\" in item and \"value\" in item:\n component_headers_dict[str(item[\"key\"])] = str(item[\"value\"])\n else:\n # Fallback: merge all keys\n for k, v in item.items():\n component_headers_dict[str(k)] = str(v)\n\n # Case 3: Message object\n elif hasattr(item, \"text\") and isinstance(item.text, str):\n try:\n parsed = json.loads(item.text)\n if isinstance(parsed, dict):\n for k, v in parsed.items():\n component_headers_dict[str(k)] = str(v)\n except json.JSONDecodeError:\n pass\n\n if component_headers_dict:\n existing_headers = server_config.get(\"headers\", {}) or {}\n # Ensure existing_headers is a dict (convert from list if needed)\n if isinstance(existing_headers, list):\n existing_dict = {}\n for item in existing_headers:\n if isinstance(item, dict) and \"key\" in item and \"value\" in item:\n existing_dict[item[\"key\"]] = item[\"value\"]\n existing_headers = existing_dict\n merged_headers = {**existing_headers, **component_headers_dict}\n server_config[\"headers\"] = merged_headers\n # Get request_variables from graph context for global variable resolution\n request_variables = None\n if hasattr(self, \"graph\") and self.graph and hasattr(self.graph, \"context\"):\n request_variables = self.graph.context.get(\"request_variables\")\n\n # Only load global variables from database if we have headers that might use them\n # This avoids unnecessary database queries when headers are empty\n has_headers = server_config.get(\"headers\") and len(server_config.get(\"headers\", {})) > 0\n if not request_variables and has_headers:\n try:\n from lfx.services.deps import get_variable_service\n\n variable_service = get_variable_service()\n if variable_service:\n async with session_scope() as db:\n request_variables = await variable_service.get_all_decrypted_variables(\n user_id=self.user_id, session=db\n )\n except Exception as e: # noqa: BLE001\n await logger.awarning(f\"Failed to load global variables for MCP component: {e}\")\n\n _, tool_list, tool_cache = await update_tools(\n server_name=server_name,\n server_config=server_config,\n mcp_stdio_client=self.stdio_client,\n mcp_streamable_http_client=self.streamable_http_client,\n request_variables=request_variables,\n )\n\n self.tool_names = [tool.name for tool in tool_list if hasattr(tool, \"name\")]\n self._tool_cache = tool_cache\n self.tools = tool_list\n\n # Cache the result only if caching is enabled\n if use_cache:\n cache_data = {\n \"tools\": tool_list,\n \"tool_names\": self.tool_names,\n \"tool_cache\": tool_cache,\n \"config\": server_config,\n }\n\n # Safely update the servers cache\n current_servers_cache = safe_cache_get(self._shared_component_cache, \"servers\", {})\n if isinstance(current_servers_cache, dict):\n current_servers_cache[server_name] = cache_data\n safe_cache_set(self._shared_component_cache, \"servers\", current_servers_cache)\n\n except (TimeoutError, asyncio.TimeoutError) as e:\n msg = f\"Timeout updating tool list: {e!s}\"\n await logger.aexception(msg)\n raise TimeoutError(msg) from e\n except Exception as e:\n msg = f\"Error updating tool list: {e!s}\"\n await logger.aexception(msg)\n raise ValueError(msg) from e\n else:\n return tool_list, {\"name\": server_name, \"config\": server_config}\n\n async def update_build_config(self, build_config: dict, field_value: str, field_name: str | None = None) -> dict:\n \"\"\"Toggle the visibility of connection-specific fields based on the selected mode.\"\"\"\n try:\n if field_name == \"tool\":\n try:\n # Always refresh tools when cache is disabled, or when tools list is empty\n # This ensures database edits are reflected immediately when cache is disabled\n use_cache = getattr(self, \"use_cache\", False)\n if len(self.tools) == 0 or not use_cache:\n try:\n self.tools, build_config[\"mcp_server\"][\"value\"] = await self.update_tool_list()\n build_config[\"tool\"][\"options\"] = [tool.name for tool in self.tools]\n build_config[\"tool\"][\"placeholder\"] = \"Select a tool\"\n except (TimeoutError, asyncio.TimeoutError) as e:\n msg = f\"Timeout updating tool list: {e!s}\"\n await logger.aexception(msg)\n if not build_config[\"tools_metadata\"][\"show\"]:\n build_config[\"tool\"][\"show\"] = True\n build_config[\"tool\"][\"options\"] = []\n build_config[\"tool\"][\"value\"] = \"\"\n build_config[\"tool\"][\"placeholder\"] = \"Timeout on MCP server\"\n else:\n build_config[\"tool\"][\"show\"] = False\n except ValueError:\n if not build_config[\"tools_metadata\"][\"show\"]:\n build_config[\"tool\"][\"show\"] = True\n build_config[\"tool\"][\"options\"] = []\n build_config[\"tool\"][\"value\"] = \"\"\n build_config[\"tool\"][\"placeholder\"] = \"Error on MCP Server\"\n else:\n build_config[\"tool\"][\"show\"] = False\n\n if field_value == \"\":\n return build_config\n tool_obj = None\n for tool in self.tools:\n if tool.name == field_value:\n tool_obj = tool\n break\n if tool_obj is None:\n msg = f\"Tool {field_value} not found in available tools: {self.tools}\"\n await logger.awarning(msg)\n return build_config\n await self._update_tool_config(build_config, field_value)\n except Exception as e:\n build_config[\"tool\"][\"options\"] = []\n msg = f\"Failed to update tools: {e!s}\"\n raise ValueError(msg) from e\n else:\n return build_config\n elif field_name == \"mcp_server\":\n if not field_value:\n build_config[\"tool\"][\"show\"] = False\n build_config[\"tool\"][\"options\"] = []\n build_config[\"tool\"][\"value\"] = \"\"\n build_config[\"tool\"][\"placeholder\"] = \"\"\n build_config[\"tool_placeholder\"][\"tool_mode\"] = False\n self.remove_non_default_keys(build_config)\n return build_config\n\n build_config[\"tool_placeholder\"][\"tool_mode\"] = True\n\n current_server_name = field_value.get(\"name\") if isinstance(field_value, dict) else field_value\n _last_selected_server = safe_cache_get(self._shared_component_cache, \"last_selected_server\", \"\")\n # Only treat as a server change if there was a previous server selection.\n # Cold cache (_last_selected_server=\"\") on initial flow load is NOT a server change —\n # the user didn't switch anything, the backend just hasn't seen this component yet.\n server_changed = bool(_last_selected_server and current_server_name != _last_selected_server)\n\n # Determine if \"Tool Mode\" is active by checking if the tool dropdown is hidden.\n is_in_tool_mode = build_config[\"tools_metadata\"][\"show\"]\n\n # Get use_cache setting to determine if we should use cached data\n use_cache = getattr(self, \"use_cache\", False)\n\n # Fast path: if server didn't change and we already have options, keep them as-is\n # BUT only if caching is enabled, we're in tool mode, or it's the initial load\n existing_options = build_config.get(\"tool\", {}).get(\"options\") or []\n if not server_changed and existing_options:\n # In non-tool mode with cache disabled, skip the fast path to force refresh\n # BUT on initial load (cold cache), always preserve saved options from the flow\n if not is_in_tool_mode and not use_cache and _last_selected_server:\n pass # Continue to refresh logic below (user-initiated with cache disabled)\n else:\n if not is_in_tool_mode:\n build_config[\"tool\"][\"show\"] = True\n safe_cache_set(self._shared_component_cache, \"last_selected_server\", current_server_name)\n return build_config\n\n # To avoid unnecessary updates, only proceed if the server has actually changed\n # OR if caching is disabled (to force refresh in non-tool mode)\n if (_last_selected_server in (current_server_name, \"\")) and build_config[\"tool\"][\"show\"] and use_cache:\n if current_server_name:\n servers_cache = safe_cache_get(self._shared_component_cache, \"servers\", {})\n if isinstance(servers_cache, dict):\n cached = servers_cache.get(current_server_name)\n if cached is not None and cached.get(\"tool_names\"):\n cached_tools = cached[\"tool_names\"]\n current_tools = build_config[\"tool\"][\"options\"]\n if current_tools == cached_tools:\n return build_config\n else:\n return build_config\n safe_cache_set(self._shared_component_cache, \"last_selected_server\", current_server_name)\n\n # When cache is disabled, clear any cached data for this server\n # This ensures we always fetch fresh data from the database\n if not use_cache and current_server_name:\n servers_cache = safe_cache_get(self._shared_component_cache, \"servers\", {})\n if isinstance(servers_cache, dict) and current_server_name in servers_cache:\n servers_cache.pop(current_server_name)\n safe_cache_set(self._shared_component_cache, \"servers\", servers_cache)\n\n # Check if tools are already cached for this server before clearing\n cached_tools = None\n if current_server_name and use_cache:\n servers_cache = safe_cache_get(self._shared_component_cache, \"servers\", {})\n if isinstance(servers_cache, dict):\n cached = servers_cache.get(current_server_name)\n if cached is not None:\n try:\n cached_tools = cached[\"tools\"]\n self.tools = cached_tools\n self.tool_names = cached[\"tool_names\"]\n self._tool_cache = cached[\"tool_cache\"]\n except (TypeError, KeyError, AttributeError) as e:\n # Handle corrupted cache data by ignoring it\n msg = f\"Unable to use cached data for MCP Server,{current_server_name}: {e}\"\n await logger.awarning(msg)\n cached_tools = None\n\n # Clear tools when cache is disabled OR when we don't have cached tools\n # This ensures fresh tools are fetched after database edits\n if not cached_tools or not use_cache:\n self.tools = [] # Clear previous tools to force refresh\n\n # Clear previous tool inputs if:\n # 1. Server actually changed\n # 2. Cache is disabled (meaning tool list will be refreshed)\n if server_changed or not use_cache:\n self.remove_non_default_keys(build_config)\n\n # Only show the tool dropdown if not in tool_mode\n if not is_in_tool_mode:\n build_config[\"tool\"][\"show\"] = True\n if cached_tools:\n # Use cached tools to populate options immediately\n build_config[\"tool\"][\"options\"] = [tool.name for tool in cached_tools]\n build_config[\"tool\"][\"placeholder\"] = \"Select a tool\"\n else:\n # Actually fetch tools now instead of deferring to a frontend callback.\n # The frontend has no reliable mechanism to trigger a second\n # update_build_config call for the \"tool\" field after this response,\n # so we must populate the options here.\n try:\n self.tools, build_config[\"mcp_server\"][\"value\"] = await self.update_tool_list(\n mcp_server_value=field_value\n )\n build_config[\"tool\"][\"options\"] = [tool.name for tool in self.tools]\n build_config[\"tool\"][\"placeholder\"] = \"Select a tool\"\n except (TimeoutError, asyncio.TimeoutError) as e:\n msg = f\"Timeout loading tools for MCP server: {e!s}\"\n await logger.awarning(msg)\n build_config[\"tool\"][\"options\"] = []\n build_config[\"tool\"][\"placeholder\"] = \"Timeout on MCP server\"\n except (ValueError, ImportError, ConnectionError, OSError, RuntimeError) as e:\n msg = f\"Error loading tools for MCP server: {e!s}\"\n await logger.awarning(msg)\n build_config[\"tool\"][\"options\"] = []\n build_config[\"tool\"][\"placeholder\"] = \"Error on MCP Server\"\n # Force a value refresh only when the user genuinely switched servers.\n # server_changed is only True for real user-initiated changes (not initial load).\n if server_changed:\n build_config[\"tool\"][\"value\"] = uuid.uuid4()\n else:\n # Keep the tool dropdown hidden if in tool_mode\n self._not_load_actions = True\n build_config[\"tool\"][\"show\"] = False\n\n elif field_name == \"tool_mode\":\n build_config[\"tool\"][\"placeholder\"] = \"\"\n build_config[\"tool\"][\"show\"] = not bool(field_value) and bool(build_config[\"mcp_server\"])\n self.remove_non_default_keys(build_config)\n self.tool = build_config[\"tool\"][\"value\"]\n if field_value:\n self._not_load_actions = True\n else:\n build_config[\"tool\"][\"value\"] = uuid.uuid4()\n build_config[\"tool\"][\"show\"] = True\n # Fetch tools immediately instead of showing \"Loading tools...\"\n try:\n self.tools, build_config[\"mcp_server\"][\"value\"] = await self.update_tool_list()\n build_config[\"tool\"][\"options\"] = [tool.name for tool in self.tools]\n build_config[\"tool\"][\"placeholder\"] = \"Select a tool\"\n except (TimeoutError, asyncio.TimeoutError) as e:\n msg = f\"Timeout loading tools when toggling tool mode: {e!s}\"\n await logger.awarning(msg)\n build_config[\"tool\"][\"options\"] = []\n build_config[\"tool\"][\"placeholder\"] = \"Timeout on MCP server\"\n except (ValueError, ImportError, ConnectionError, OSError, RuntimeError) as e:\n msg = f\"Error loading tools when toggling tool mode: {e!s}\"\n await logger.awarning(msg)\n build_config[\"tool\"][\"options\"] = []\n build_config[\"tool\"][\"placeholder\"] = \"Error on MCP Server\"\n elif field_name == \"tools_metadata\":\n self._not_load_actions = False\n\n except Exception as e:\n msg = f\"Error in update_build_config: {e!s}\"\n await logger.aexception(msg)\n raise ValueError(msg) from e\n else:\n return build_config\n\n def get_inputs_for_all_tools(self, tools: list) -> dict:\n \"\"\"Get input schemas for all tools.\"\"\"\n inputs = {}\n for tool in tools:\n if not tool or not hasattr(tool, \"name\"):\n continue\n try:\n flat_schema = flatten_schema(tool.args_schema.schema())\n input_schema = create_input_schema_from_json_schema(flat_schema)\n langflow_inputs = schema_to_langflow_inputs(input_schema)\n inputs[tool.name] = langflow_inputs\n except (AttributeError, ValueError, TypeError, KeyError) as e:\n msg = f\"Error getting inputs for tool {getattr(tool, 'name', 'unknown')}: {e!s}\"\n logger.exception(msg)\n continue\n return inputs\n\n def remove_non_default_keys(self, build_config: dict) -> None:\n \"\"\"Remove non-default keys from the build config.\"\"\"\n for key in list(build_config.keys()):\n if key not in self.default_keys:\n build_config.pop(key)\n\n async def _update_tool_config(self, build_config: dict, tool_name: str) -> None:\n \"\"\"Update tool configuration with proper error handling.\"\"\"\n if not self.tools:\n self.tools, build_config[\"mcp_server\"][\"value\"] = await self.update_tool_list()\n\n if not tool_name:\n return\n\n tool_obj = next((tool for tool in self.tools if tool.name == tool_name), None)\n if not tool_obj:\n msg = f\"Tool {tool_name} not found in available tools: {self.tools}\"\n self.remove_non_default_keys(build_config)\n build_config[\"tool\"][\"value\"] = \"\"\n await logger.awarning(msg)\n return\n\n try:\n # Store current values before removing inputs (only for the current tool)\n current_values = {}\n for key, value in build_config.items():\n if key not in self.default_keys and isinstance(value, dict) and \"value\" in value:\n current_values[key] = value[\"value\"]\n\n # Remove ALL non-default keys (all previous tool inputs)\n self.remove_non_default_keys(build_config)\n\n # Get and validate new inputs for the selected tool\n self.schema_inputs = await self._validate_schema_inputs(tool_obj)\n if not self.schema_inputs:\n msg = f\"No input parameters to configure for tool '{tool_name}'\"\n await logger.ainfo(msg)\n return\n\n # Add new inputs to build config for the selected tool only\n for schema_input in self.schema_inputs:\n if not schema_input or not hasattr(schema_input, \"name\"):\n msg = \"Invalid schema input detected, skipping\"\n await logger.awarning(msg)\n continue\n\n try:\n name = schema_input.name\n input_dict = schema_input.to_dict()\n input_dict.setdefault(\"value\", None)\n input_dict.setdefault(\"required\", True)\n\n build_config[name] = input_dict\n\n # Preserve existing value if the parameter name exists in current_values\n if name in current_values:\n build_config[name][\"value\"] = current_values[name]\n\n except (AttributeError, KeyError, TypeError) as e:\n msg = f\"Error processing schema input {schema_input}: {e!s}\"\n await logger.aexception(msg)\n continue\n except ValueError as e:\n msg = f\"Schema validation error for tool {tool_name}: {e!s}\"\n await logger.aexception(msg)\n self.schema_inputs = []\n return\n except (AttributeError, KeyError, TypeError) as e:\n msg = f\"Error updating tool config: {e!s}\"\n await logger.aexception(msg)\n raise ValueError(msg) from e\n\n async def build_output(self) -> DataFrame:\n \"\"\"Build output with improved error handling and validation.\"\"\"\n try:\n self.tools, _ = await self.update_tool_list()\n if self.tool != \"\":\n # Set session context for persistent MCP sessions using Langflow session ID\n session_context = self._get_session_context()\n if session_context:\n self.stdio_client.set_session_context(session_context)\n self.streamable_http_client.set_session_context(session_context)\n exec_tool = self._tool_cache[self.tool]\n tool_args = self.get_inputs_for_all_tools(self.tools)[self.tool]\n kwargs = {}\n for arg in tool_args:\n value = getattr(self, arg.name, None)\n if value is not None:\n if isinstance(value, Message):\n kwargs[arg.name] = value.text\n else:\n kwargs[arg.name] = value\n\n unflattened_kwargs = maybe_unflatten_dict(kwargs)\n\n output = await exec_tool.coroutine(**unflattened_kwargs)\n tool_content = []\n for item in output.content:\n item_dict = item.model_dump()\n item_dict = self.process_output_item(item_dict)\n tool_content.append(item_dict)\n\n if isinstance(tool_content, list) and all(isinstance(x, dict) for x in tool_content):\n return DataFrame(tool_content)\n return DataFrame(data=tool_content)\n return DataFrame(data=[{\"error\": \"You must select a tool\"}])\n except Exception as e:\n msg = f\"Error in build_output: {e!s}\"\n await logger.aexception(msg)\n raise ValueError(msg) from e\n\n def process_output_item(self, item_dict):\n \"\"\"Process the output of a tool.\"\"\"\n if item_dict.get(\"type\") == \"text\":\n text = item_dict.get(\"text\")\n try:\n parsed = json.loads(text)\n # Ensure we always return a dictionary for DataFrame compatibility\n if isinstance(parsed, dict):\n return parsed\n # Wrap non-dict parsed values in a dictionary\n return {\"text\": text, \"parsed_value\": parsed, \"type\": \"text\"} # noqa: TRY300\n except json.JSONDecodeError:\n return item_dict\n return item_dict\n\n def _get_session_context(self) -> str | None:\n \"\"\"Get the Langflow session ID for MCP session caching.\"\"\"\n # Try to get session ID from the component's execution context\n if hasattr(self, \"graph\") and hasattr(self.graph, \"session_id\"):\n session_id = self.graph.session_id\n # Include server name to ensure different servers get different sessions\n server_name = \"\"\n mcp_server = getattr(self, \"mcp_server\", None)\n if isinstance(mcp_server, dict):\n server_name = mcp_server.get(\"name\", \"\")\n elif mcp_server:\n server_name = str(mcp_server)\n return f\"{session_id}_{server_name}\" if session_id else None\n return None\n\n async def _get_tools(self):\n \"\"\"Get cached tools or update if necessary.\"\"\"\n mcp_server = getattr(self, \"mcp_server\", None)\n if not self._not_load_actions:\n tools, _ = await self.update_tool_list(mcp_server)\n return tools\n return []\n"},- "input_value": {- "_input_type": "MultilineInput",+ "headers": {+ "_input_type": "TableInput",+ "advanced": true,+ "display_name": "Headers",+ "dynamic": false,+ "info": "HTTP headers to include with MCP server requests. Useful for authentication (e.g., Authorization header). These headers override any headers configured in the MCP server settings.",+ "input_types": [+ "Data",+ "JSON"+ ],+ "is_list": true,+ "list_add_label": "Add More",+ "load_from_db": false,+ "name": "headers",+ "override_skip": false,+ "placeholder": "",+ "required": false,+ "show": true,+ "table_icon": "Table",+ "table_schema": [+ {+ "description": "Key name",+ "display_name": "Key",+ "formatter": "text",+ "name": "key",+ "type": "string"+ },+ {+ "description": "Value of the header",+ "display_name": "Value",+ "formatter": "text",+ "load_from_db": true,+ "name": "value",+ "type": "string"+ }+ ],+ "title_case": false,+ "tool_mode": false,+ "trace_as_metadata": true,+ "track_in_telemetry": false,+ "trigger_icon": "Table",+ "trigger_text": "Open table",+ "type": "table",+ "value": [+ {+ "": "",+ "key": "X-Langflow-Global-Var-JWT",+ "value": "JWT"+ },+ {+ "key": "X-Langflow-Global-Var-OPENAI_API_KEY",+ "value": "OPENAI_API_KEY"+ },+ {+ "key": "X-Langflow-Global-Var-OPENSEARCH_URL",+ "value": "OPENSEARCH_URL"+ },+ {+ "key": "X-Langflow-Global-Var-OWNER",+ "value": "OWNER"+ },+ {+ "key": "X-Langflow-Global-Var-OWNER_NAME",+ "value": "OWNER_NAME"+ },+ {+ "key": "X-Langflow-Global-Var-OWNER_EMAIL",+ "value": "OWNER_EMAIL"+ },+ {+ "key": "X-Langflow-Global-Var-CONNECTOR_TYPE",+ "value": "CONNECTOR_TYPE"+ },+ {+ "key": "X-Langflow-Global-Var-OPENSEARCH_INDEX_NAME",+ "value": "OPENSEARCH_INDEX_NAME"+ },+ {+ "key": "X-Langflow-Global-Var-WATSONX_PROJECT_ID",+ "value": "WATSONX_PROJECT_ID"+ },+ {+ "key": "X-Langflow-Global-Var-WATSONX_APIKEY",+ "value": "WATSONX_APIKEY"+ },+ {+ "key": "X-Langflow-Global-Var-SELECTED_EMBEDDING_MODEL",+ "value": "SELECTED_EMBEDDING_MODEL"+ }+ ]+ },+ "is_refresh": false,+ "mcp_server": {+ "_input_type": "McpInput","advanced": false,- "ai_enabled": false,- "copy_field": false,- "display_name": "Text",+ "display_name": "MCP Server","dynamic": false,- "info": "Text to be passed as input.",+ "info": "Select the MCP Server that will be used by this component",+ "load_from_db": false,+ "name": "mcp_server",+ "override_skip": false,+ "placeholder": "",+ "real_time_refresh": true,+ "required": false,+ "show": true,+ "title_case": false,+ "trace_as_metadata": true,+ "track_in_telemetry": false,+ "type": "mcp",+ "value": {+ "config": {},+ "name": "lf-starter_project"+ }+ },+ "tool": {+ "_input_type": "DropdownInput",+ "advanced": false,+ "combobox": false,+ "dialog_inputs": {},+ "display_name": "Tool",+ "dynamic": false,+ "external_options": {},+ "info": "Select the tool to execute",+ "name": "tool",+ "options": [+ "opensearch_url_ingestion_flow"+ ],+ "options_metadata": [],+ "override_skip": false,+ "placeholder": "",+ "real_time_refresh": true,+ "refresh_button": true,+ "required": true,+ "show": false,+ "title_case": false,+ "toggle": false,+ "tool_mode": false,+ "trace_as_metadata": true,+ "track_in_telemetry": true,+ "type": "str",+ "value": ""+ },+ "tool_placeholder": {+ "_input_type": "MessageTextInput",+ "advanced": false,+ "display_name": "Tool Placeholder",+ "dynamic": false,+ "info": "Placeholder for the tool","input_types": ["Message"],"list": false,"list_add_label": "Add More",- "load_from_db": true,- "multiline": false,- "name": "input_value",+ "load_from_db": false,+ "name": "tool_placeholder","override_skip": false,- "password": true,"placeholder": "","required": false,- "show": true,+ "show": false,"title_case": false,- "tool_mode": false,+ "tool_mode": true,"trace_as_input": true,"trace_as_metadata": true,"track_in_telemetry": false,"type": "str",- "value": "OPENRAG-QUERY-FILTER"+ "value": ""},- "is_refresh": false,- "use_global_variable": {+ "tools_metadata": {+ "_input_type": "ToolsInput",+ "advanced": false,+ "display_name": "Actions",+ "dynamic": false,+ "info": "Modify tool names and descriptions to help agents understand when to use each tool.",+ "is_list": true,+ "list_add_label": "Add More",+ "name": "tools_metadata",+ "override_skip": false,+ "placeholder": "",+ "real_time_refresh": true,+ "required": false,+ "show": true,+ "title_case": false,+ "tool_mode": false,+ "trace_as_metadata": true,+ "track_in_telemetry": false,+ "type": "tools",+ "value": [+ {+ "args": {+ "input_value": {+ "anyOf": [+ {+ "type": "string"+ },+ {+ "type": "null"+ }+ ],+ "default": null,+ "description": "Text to be passed as input.",+ "title": "Input Value"+ }+ },+ "description": "This flow is to ingest the URL to open search.",+ "display_description": "This flow is to ingest the URL to open search.",+ "display_name": "opensearch_url_ingestion_flow",+ "name": "opensearch_url_ingestion_flow",+ "readonly": false,+ "status": true,+ "tags": [+ "opensearch_url_ingestion_flow"+ ]+ }+ ]+ },+ "use_cache": {"_input_type": "BoolInput","advanced": true,- "display_name": "Use Global Variable",+ "display_name": "Use Cached Server","dynamic": false,- "info": "Enable to select from global variables (shows globe icon). Disables multiline editing.",+ "info": "Enable caching of MCP Server and tools to improve performance. Disable to always fetch fresh tools and server updates.","list": false,"list_add_label": "Add More",- "name": "use_global_variable",+ "name": "use_cache",+ "override_skip": false,+ "placeholder": "",+ "required": false,+ "show": true,+ "title_case": false,+ "tool_mode": false,+ "trace_as_metadata": true,+ "track_in_telemetry": true,+ "type": "bool",+ "value": false+ },+ "verify_ssl": {+ "_input_type": "BoolInput",+ "advanced": true,+ "display_name": "Verify SSL Certificate",+ "dynamic": false,+ "info": "Enable SSL certificate verification for HTTPS connections. Disable only for development/testing with self-signed certificates.",+ "list": false,+ "list_add_label": "Add More",+ "name": "verify_ssl","override_skip": false,"placeholder": "",- "real_time_refresh": true,"required": false,"show": true,"title_case": false,@@ -5189,29 +5386,29 @@"value": true}},- "tool_mode": false+ "tool_mode": true},"showNode": true,- "type": "TextInput"+ "type": "MCPTools"},"dragging": false,- "id": "TextInput-i0a3P",+ "id": "MCPTools-uu7m3","measured": {- "height": 207,+ "height": 287,"width": 320},"position": {- "x": 471.417983121568,- "y": 2170.275430066397+ "x": 1499.1989099237799,+ "y": 1358.0838292705346},"selected": false,"type": "genericNode"}],"viewport": {- "x": 133.83977425348485,- "y": -95.52024475877101,- "zoom": 0.3072620380156274+ "x": -144.06609500883735,+ "y": -221.7218791332906,+ "zoom": 0.3639973872497736}},"description": "OpenRAG OpenSearch Agent",diff --git a/src/api/chat.py b/src/api/chat.pyindex f30b2b586..4437b81b6 100644--- a/src/api/chat.py+++ b/src/api/chat.py@@ -101,6 +101,9 @@ async def langflow_endpoint(previous_response_id=body.previous_response_id,stream=True,filter_id=body.filter_id,+ owner=user.user_id,+ owner_name=user.name,+ owner_email=user.email,),media_type="text/event-stream",headers={@@ -118,6 +121,9 @@ async def langflow_endpoint(previous_response_id=body.previous_response_id,stream=False,filter_id=body.filter_id,+ owner=user.user_id,+ owner_name=user.name,+ owner_email=user.email,)return JSONResponse(result)diff --git a/src/api/settings.py b/src/api/settings.pyindex 297e74edf..f6ba3595c 100644--- a/src/api/settings.py+++ b/src/api/settings.py@@ -1242,7 +1242,7 @@ async def onboarding(await _update_langflow_global_variables(current_config, flows_service=flows_service)if body.embedding_provider or body.embedding_model:- await _update_mcp_servers_with_provider_credentials(current_config, session_manager=session_manager, flows_service=flows_service)+ await _update_mcp_server_urls(current_config, session_manager=session_manager, flows_service=flows_service)if body.llm_provider or body.llm_model or body.embedding_provider or body.embedding_model:await _update_langflow_model_values(current_config, flows_service, embedding_model=body.embedding_model, embedding_provider=body.embedding_provider, llm_model=body.llm_model, llm_provider=body.llm_provider)@@ -1569,7 +1569,7 @@ async def _run_async_post_save_langflow_updates(# Update LLM client credentials when embedding selection changesif update_mcp_servers:- await _update_mcp_servers_with_provider_credentials(+ await _update_mcp_server_urls(current_config, session_manager, flows_service=flows_service)@@ -1590,40 +1590,17 @@ async def _run_async_post_save_langflow_updates(logger.error(f"Failed to update Langflow settings asynchronously: {str(e)}")-async def _update_mcp_servers_with_provider_credentials(config, session_manager = None, flows_service=None):- # Update MCP servers with provider credentials+async def _update_mcp_server_urls(config, session_manager=None, flows_service=None):+ """Update MCP server URLs (patch localhost and convert to streamable HTTP)."""try:from services.langflow_mcp_service import LangflowMCPService- from utils.langflow_headers import build_mcp_global_vars_from_configmcp_service = LangflowMCPService()-- # Build global vars using utility function- mcp_global_vars = await build_mcp_global_vars_from_config(config, flows_service=flows_service)-- # In no-auth mode, add the anonymous JWT token and user details- if is_no_auth_mode() and session_manager:- from session_manager import AnonymousUser-- # Create/get anonymous JWT for no-auth mode- anonymous_jwt = session_manager.get_effective_jwt_token(None, None)- if anonymous_jwt:- mcp_global_vars["JWT"] = anonymous_jwt-- # Add anonymous user details- anonymous_user = AnonymousUser()- mcp_global_vars["OWNER"] = anonymous_user.user_id # "anonymous"- mcp_global_vars["OWNER_NAME"] = f'"{anonymous_user.name}"' # "Anonymous User" (quoted)- mcp_global_vars["OWNER_EMAIL"] = anonymous_user.email # "anonymous@localhost"-- logger.debug("Added anonymous JWT and user details to MCP servers for no-auth mode")-- if mcp_global_vars:- result = await mcp_service.update_mcp_servers_with_global_vars(mcp_global_vars)- logger.info("Updated MCP servers with provider credentials after settings change", **result)+ result = await mcp_service.update_all_mcp_server_urls()+ logger.info("Updated MCP server URLs after settings change", **result)except Exception as mcp_error:- logger.warning(f"Failed to update MCP servers after settings change: {str(mcp_error)}")+ logger.warning(f"Failed to update MCP server URLs after settings change: {str(mcp_error)}")# Don't fail the entire settings update if MCP update fails@@ -1784,10 +1761,8 @@ async def reapply_all_settings(session_manager = None):logger.info("Reapplying all settings to Langflow flows and global variables")- if config.knowledge.embedding_model or config.knowledge.embedding_provider:- await _update_mcp_servers_with_provider_credentials(config, session_manager, flows_service=flows_service)- else:- logger.info("No embedding model or provider configured, skipping MCP server update")+ # Update MCP server URLs (patch localhost and convert to streamable HTTP)+ await _update_mcp_server_urls(config, session_manager, flows_service=flows_service)# Update all Langflow settings using helper functionstry:diff --git a/src/api/upload.py b/src/api/upload.pyindex cf34bd1bb..460a69492 100644--- a/src/api/upload.py+++ b/src/api/upload.py@@ -124,6 +124,12 @@ async def upload_context(doc_result = await document_service.process_upload_context(file, filename)+ from config.settings import is_no_auth_mode+ is_no_auth = is_no_auth_mode()+ owner_user_id = user.user_id if (user and not is_no_auth) else None+ owner_name = user.name if user else None+ owner_email = user.email if user else None+response_text, response_id = await chat_service.upload_context_chat(doc_result["content"],filename,@@ -131,6 +137,9 @@ async def upload_context(jwt_token=jwt_token,previous_response_id=previous_response_id,endpoint=endpoint,+ owner=owner_user_id,+ owner_name=owner_name,+ owner_email=owner_email,)response_data = {diff --git a/src/api/v1/chat.py b/src/api/v1/chat.pyindex 1a27804cd..a4f653e94 100644--- a/src/api/v1/chat.py+++ b/src/api/v1/chat.py@@ -128,6 +128,9 @@ async def chat_create_endpoint(previous_response_id=body.chat_id,stream=True,filter_id=body.filter_id,+ owner=user.user_id,+ owner_name=user.name,+ owner_email=user.email,)chat_id_container = {}return StreamingResponse(@@ -143,6 +146,9 @@ async def chat_create_endpoint(previous_response_id=body.chat_id,stream=False,filter_id=body.filter_id,+ owner=user.user_id,+ owner_name=user.name,+ owner_email=user.email,)return JSONResponse({"response": result.get("response", ""),diff --git a/src/config/settings.py b/src/config/settings.pyindex 3025c2091..75a97b2d5 100644--- a/src/config/settings.py+++ b/src/config/settings.py@@ -192,6 +192,8 @@ API_KEYS_INDEX_BODY = {},}+MCP_URL_PATTERNS = ("/mcp", "/streamable", "/api/v2/mcp")+# Convenience base URL for Langflow REST APILANGFLOW_BASE_URL = f"{LANGFLOW_URL}/api/v1"diff --git a/src/main.py b/src/main.pyindex 5b7ae3ffa..2a189b86f 100644--- a/src/main.py+++ b/src/main.py@@ -1178,70 +1178,13 @@ async def _ingest_default_documents_openrag()return task_id--async def _update_mcp_servers_with_provider_credentials(services):- """Update MCP servers with provider credentials at startup.-- This is especially important for no-auth mode where users don't go through- the OAuth login flow that would normally set these credentials.- """+async def _update_mcp_server_urls(langflow_mcp_service):+ """Update MCP server URLs (patch localhost and convert to streamable HTTP)."""try:- auth_service = services.get("auth_service")- session_manager = services.get("session_manager")-- if not auth_service or not auth_service.langflow_mcp_service:- logger.debug("MCP service not available, skipping credential update")- return-- config = get_openrag_config()-- # Build global vars with provider credentials using utility function- from utils.langflow_headers import build_mcp_global_vars_from_config-- flows_service = services.get("flows_service")- global_vars = await build_mcp_global_vars_from_config(- config, flows_service=flows_service- )-- # In no-auth mode, add the anonymous JWT token and user details- if is_no_auth_mode() and session_manager:- from session_manager import AnonymousUser-- # Create/get anonymous JWT for no-auth mode- anonymous_jwt = session_manager.get_effective_jwt_token(None, None)- if anonymous_jwt:- global_vars["JWT"] = anonymous_jwt-- # Add anonymous user details- anonymous_user = AnonymousUser()- global_vars["OWNER"] = anonymous_user.user_id # "anonymous"- global_vars["OWNER_NAME"] = (- f'"{anonymous_user.name}"' # "Anonymous User" (quoted for spaces)- )- global_vars["OWNER_EMAIL"] = anonymous_user.email # "anonymous@localhost"-- logger.info(- "Added anonymous JWT and user details to MCP servers for no-auth mode"- )-- if global_vars:- result = await auth_service.langflow_mcp_service.update_mcp_servers_with_global_vars(- global_vars- )- logger.info(- "Updated MCP servers with provider credentials at startup", **result- )- else:- logger.debug(- "No provider credentials configured, skipping MCP server update"- )-- except Exception as e:- logger.error(- "Failed to update MCP servers with provider credentials at startup",- error=str(e),- )- # Don't fail startup if MCP update fails+ result = await langflow_mcp_service.update_all_mcp_server_urls()+ logger.info("Updated MCP server URLs after settings change", **result)+ except Exception as mcp_error:+ logger.warning(f"Failed to update MCP server URLs after settings change: {str(mcp_error)}")async def startup_tasks(services):@@ -1347,8 +1290,8 @@ async def startup_tasks(services):except Exception as e:logger.error("OpenRAG docs startup refresh failed", error=str(e))- # Update MCP servers with provider credentials (especially important for no-auth mode)- await _update_mcp_servers_with_provider_credentials(services)+ # Update MCP server URLs (patch localhost and convert to streamable HTTP)+ await _update_mcp_server_urls(services["langflow_mcp_service"])# Ensure all configured flows exist in Langflow (create-only, never overwrites).# This replaces LANGFLOW_LOAD_FLOWS_PATH, which performed a blind upsert on@@ -1443,6 +1386,7 @@ async def initialize_services():knowledge_filter_service = KnowledgeFilterService(session_manager)monitor_service = MonitorService(session_manager)langflow_file_service = LangflowFileService(flows_service=flows_service)+ langflow_mcp_service = LangflowMCPService()# Initialize both connector serviceslangflow_connector_service = LangflowConnectorService(@@ -1470,7 +1414,7 @@ async def initialize_services():session_manager,connector_service,flows_service,- langflow_mcp_service=LangflowMCPService(),+ langflow_mcp_service=langflow_mcp_service,)# Load persisted connector connections at startup so webhooks and syncs@@ -1516,6 +1460,7 @@ async def initialize_services():"monitor_service": monitor_service,"session_manager": session_manager,"api_key_service": api_key_service,+ "langflow_mcp_service": langflow_mcp_service,}diff --git a/src/services/auth_service.py b/src/services/auth_service.pyindex 810adb0a9..50ffdda75 100644--- a/src/services/auth_service.py+++ b/src/services/auth_service.py@@ -5,7 +5,7 @@ import httpximport loggingfrom datetime import datetime, timedeltafrom typing import Optional-import asyncio+import osfrom config.settings import OAUTH_BROKER_URL, WEBHOOK_BASE_URL, is_no_auth_modefrom fastapi import HTTPException@@ -37,7 +37,7 @@ class AuthService:self.used_auth_codes = set() # Track used authorization codesself.flows_service = flows_serviceself.langflow_mcp_service = langflow_mcp_service- self._background_tasks = set()+async def init_oauth(self,@@ -376,51 +376,8 @@ class AuthService:token_data["access_token"])- # Best-effort: update Langflow MCP servers to include user's JWT and owner headers- try:- if (- self.langflow_mcp_service- and isinstance(jwt_token, str)- and jwt_token.strip()- ):- global_vars = {"JWT": jwt_token}- global_vars["CONNECTOR_TYPE_URL"] = "url"- if user_info:- if user_info.get("id"):- global_vars["OWNER"] = user_info.get("id")- if user_info.get("name"):- # OWNER_NAME may contain spaces, which can cause issues in headers.- # Alternative: URL-encode the owner name to preserve spaces and special characters.- owner_name = user_info.get("name")- if owner_name:- global_vars["OWNER_NAME"] = str(f'"{owner_name}"')- if user_info.get("email"):- global_vars["OWNER_EMAIL"] = user_info.get("email")-- # Add provider credentials to MCP servers using utility function- from config.settings import get_openrag_config- from utils.langflow_headers import build_mcp_global_vars_from_config-- config = get_openrag_config()- provider_vars = await build_mcp_global_vars_from_config(- config, flows_service=self.flows_service- )- # Merge provider credentials with user info- global_vars.update(provider_vars)- # Run in background to avoid delaying login flow- task = asyncio.create_task(- self.langflow_mcp_service.update_mcp_servers_with_global_vars(- global_vars- )- )- # Keep reference until done to avoid premature GC- self._background_tasks.add(task)- task.add_done_callback(self._background_tasks.discard)- except Exception:- # Do not block login on MCP update issues- passresponse_data = {"status": "authenticated",diff --git a/src/services/chat_service.py b/src/services/chat_service.pyindex 1e2dab9db..45bca90d1 100644--- a/src/services/chat_service.py+++ b/src/services/chat_service.py@@ -57,6 +57,9 @@ class ChatService:previous_response_id: str = None,stream: bool = False,filter_id: str = None,+ owner: str = None,+ owner_name: str = None,+ owner_email: str = None,):"""Handle Langflow chat requests"""if not prompt:@@ -68,7 +71,11 @@ class ChatService:)# Prepare extra headers for JWT authentication and embedding model- extra_headers = {}+ extra_headers = {+ "X-Langflow-Global-Var-OWNER": str(owner) if owner else "",+ "X-Langflow-Global-Var-OWNER_NAME": str(owner_name) if owner_name else "",+ "X-Langflow-Global-Var-OWNER_EMAIL": str(owner_email) if owner_email else "",+ }if jwt_token:extra_headers["X-LANGFLOW-GLOBAL-VAR-JWT"] = jwt_token@@ -312,13 +319,20 @@ class ChatService:jwt_token: str = None,previous_response_id: str = None,endpoint: str = "langflow",+ owner: str = None,+ owner_name: str = None,+ owner_email: str = None,):"""Send document content as user message to get proper response_id"""document_prompt = f"I'm uploading a document called '{filename}'. Here is its content:\n\n{document_content}\n\nPlease confirm you've received this document and are ready to answer questions about it."if endpoint == "langflow":# Prepare extra headers for JWT authentication and embedding model- extra_headers = {}+ extra_headers = {+ "X-Langflow-Global-Var-OWNER": str(owner) if owner else "",+ "X-Langflow-Global-Var-OWNER_NAME": str(owner_name) if owner_name else "",+ "X-Langflow-Global-Var-OWNER_EMAIL": str(owner_email) if owner_email else "",+ }if jwt_token:extra_headers["X-LANGFLOW-GLOBAL-VAR-JWT"] = jwt_tokendiff --git a/src/services/langflow_mcp_service.py b/src/services/langflow_mcp_service.pyindex e19c3f01b..9197b116d 100644--- a/src/services/langflow_mcp_service.py+++ b/src/services/langflow_mcp_service.py@@ -1,3 +1,4 @@+from config.settings import MCP_URL_PATTERNSfrom typing import List, Dict, Anyfrom tenacity import (@@ -58,105 +59,6 @@ class LangflowMCPService:response.raise_for_status()return response.json()- def _upsert_jwt_header_in_args(self, args: List[str], jwt_token: str) -> List[str]:- """Ensure args contains a header triplet for X-Langflow-Global-Var-JWT with the provided JWT.-- Args are expected in the pattern: [..., "--headers", key, value, ...].- If the header exists, update its value; otherwise append the triplet at the end.- """- if not isinstance(args, list):- return [- "mcp-proxy",- "--headers",- "X-Langflow-Global-Var-JWT",- jwt_token,- ]-- updated_args = list(args)- i = 0- found_index = -1- while i < len(updated_args):- token = updated_args[i]- if token == "--headers" and i + 2 < len(updated_args):- header_key = updated_args[i + 1]- if (- isinstance(header_key, str)- and header_key.lower() == "x-langflow-global-var-jwt".lower()- ):- found_index = i- break- i += 3- continue- i += 1-- if found_index >= 0:- # Replace existing value at found_index + 2- if found_index + 2 < len(updated_args):- updated_args[found_index + 2] = jwt_token- else:- # Malformed existing header triplet; make sure to append a value- updated_args.append(jwt_token)- else:- updated_args.extend(- [- "--headers",- "X-Langflow-Global-Var-JWT",- jwt_token,- ]- )-- return updated_args-- def _upsert_global_var_headers_in_args(- self, args: List[str], global_vars: Dict[str, str]- ) -> List[str]:- """Ensure args contains header triplets for X-Langflow-Global-Var-{key} with the provided global variables.-- Args are expected in the pattern: [..., "--headers", key, value, ...].- If a header exists, update its value; otherwise append the triplet at the end.- """- if not isinstance(args, list):- updated_args = ["mcp-proxy"]- else:- updated_args = list(args)-- for var_key, var_value in global_vars.items():- header_name = f"X-Langflow-Global-Var-{var_key}"-- i = 0- found_index = -1- while i < len(updated_args):- token = updated_args[i]- if token == "--headers" and i + 2 < len(updated_args):- header_key = updated_args[i + 1]- if (- isinstance(header_key, str)- and header_key.lower() == header_name.lower()- ):- found_index = i- break- i += 3- continue- i += 1-- if found_index >= 0:- # Replace existing value at found_index + 2- if found_index + 2 < len(updated_args):- updated_args[found_index + 2] = var_value- else:- # Malformed existing header triplet; make sure to append a value- updated_args.append(var_value)- else:- updated_args.extend(- [- "--headers",- header_name,- var_value,- ]- )-- return updated_args-def _parse_stdio_args(self, args: List[str]) -> tuple[str | None, Dict[str, str]]:"""Extract URL and headers from stdio args.@@ -205,7 +107,7 @@ class LangflowMCPService:Returns True if:- Server has 'command' field (stdio mode)- - Args contain a URL ending with /mcp or /streamable+ - Args contain a URL (starting with http:// or https://)"""if not server_config.get("command"):return False@@ -218,13 +120,9 @@ class LangflowMCPService:for arg in args:if not isinstance(arg, str):continue- if not (arg.startswith("http://") or arg.startswith("https://")):- continue- # Check URL path endings- if arg.rstrip("/").endswith("/mcp") or arg.rstrip("/").endswith(- "/streamable"- ):- return True+ if arg.startswith("http://") or arg.startswith("https://"):+ if any(arg.rstrip("/").endswith(pat) or pat in arg for pat in MCP_URL_PATTERNS):+ return Truereturn False@@ -232,36 +130,6 @@ class LangflowMCPService:"""Check if server is in streamable HTTP mode (has url field)."""return bool(server_config.get("url"))- def _upsert_global_var_headers_in_dict(- self, headers: Dict[str, str] | None, global_vars: Dict[str, str]- ) -> Dict[str, str]:- """Upsert global var headers into a headers dictionary (for streamable HTTP mode).-- Creates X-Langflow-Global-Var-{key} headers in the dictionary.- Case-insensitive matching for existing headers.- """- if headers is None:- headers = {}- else:- headers = dict(headers)-- for var_key, var_value in global_vars.items():- header_name = f"X-Langflow-Global-Var-{var_key}"-- # Find existing header with case-insensitive match- existing_key = None- for key in headers:- if key.lower() == header_name.lower():- existing_key = key- break-- if existing_key:- headers[existing_key] = var_value- else:- headers[header_name] = var_value-- return headers-def _patch_url_with_langflow_url(self, url: str) -> str:"""Patch the URL to include the Langflow URL.@@ -285,162 +153,70 @@ class LangflowMCPService:logger.debug(f"Patched URL: {url}")return url- async def patch_mcp_server_args_with_global_vars(- self, server_name: str, global_vars: Dict[str, Any]- ) -> bool:- """Patch a single MCP server to include/update multiple X-Langflow-Global-Var-* headers.+ async def patch_mcp_server_url(self, server_name: str) -> str:+ """Patch a single MCP server to update the Langflow URL and convert to streamable HTTP if applicable.++ Only updates the URL (replacing localhost references with the configured LANGFLOW_URL).+ If the server is in stdio mode and eligible, converts it to streamable HTTP mode.+ Headers are never modified.- Supports both stdio mode (command/args) and streamable HTTP mode (url/headers).- Only non-empty values are applied. Keys are uppercased to match existing conventions (e.g., JWT).+ Returns 'patched', 'skipped', or 'failed'."""try:- if not isinstance(global_vars, dict) or not global_vars:- return True # Nothing to do-- # Sanitize and normalize keys/values- sanitized: Dict[str, str] = {}- for k, v in global_vars.items():- if v is None:- continue- v_str = str(v).strip()- if not v_str:- continue- sanitized[k.upper()] = v_str-- if not sanitized:- return True-- # Fetch server config oncecurrent = await self.get_mcp_server(server_name)- # In IBM Auth mode, convert stdio to streamable HTTP inline if eligible- from config.settings import IBM_AUTH_ENABLED-- if IBM_AUTH_ENABLED and self._is_convertible_to_streamable_http(current):+ if self._is_convertible_to_streamable_http(current):+ # Convert stdio to streamable HTTP: extract URL from args, patch itargs = current.get("args", [])url, headers = self._parse_stdio_args(args)if url:- # Build streamable HTTP payload with converted config + new headers- updated_headers = self._upsert_global_var_headers_in_dict(- headers, sanitized- )- payload = {"url": self._patch_url_with_langflow_url(url), "headers": updated_headers}- mode = "streamable_http"+ payload = {"url": self._patch_url_with_langflow_url(url), "headers": headers}+ mode = "streamable_http (converted)"logger.info(- "Converting MCP server to streamable HTTP with headers",+ "Converting MCP server to streamable HTTP",server_name=server_name,)else:- # Fallback to stdio mode if URL extraction failed- command = current.get("command")- updated_args = self._upsert_global_var_headers_in_args(- args, sanitized+ # Cannot extract URL — leave as-is+ logger.debug(+ "Could not extract URL from stdio args, skipping",+ server_name=server_name,)- payload = {"command": command, "args": updated_args}- mode = "stdio"+ return "skipped"elif self._is_streamable_http_mode(current):- # Already in streamable HTTP mode: update headers dictionary+ # Already streamable HTTP: only patch the URL, keep headers untouchedurl = current.get("url")- headers = current.get("headers", {})- updated_headers = self._upsert_global_var_headers_in_dict(- headers, sanitized- )- payload = {"url": url, "headers": updated_headers}+ patched_url = self._patch_url_with_langflow_url(url)+ if patched_url == url:+ # URL unchanged — nothing to do+ logger.debug(+ "MCP server URL unchanged, skipping patch",+ server_name=server_name,+ )+ return "skipped"+ payload = {"url": patched_url}mode = "streamable_http"else:- # Stdio mode: update args list- command = current.get("command")+ # Stdio mode, not convertible — patch URL in args if presentargs = current.get("args", [])- updated_args = self._upsert_global_var_headers_in_args(args, sanitized)- payload = {"command": command, "args": updated_args}- mode = "stdio"-- response = await clients.langflow_request(- method="PATCH",- endpoint=f"/api/v2/mcp/servers/{server_name}",- json=payload,- )- if response.status_code in (200, 201):- logger.info(- "Patched MCP server with global-var headers",- server_name=server_name,- mode=mode,- applied_keys=list(sanitized.keys()),- )- return True- else:- logger.warning(- "Failed to patch MCP server with global vars",- server_name=server_name,- mode=mode,- status_code=response.status_code,- body=response.text,- )- return False- except Exception as e:- logger.error(- "Exception while patching MCP server with global vars",- server_name=server_name,- error=str(e),- )- return False-- async def update_mcp_servers_with_global_vars(- self, global_vars: Dict[str, Any]- ) -> Dict[str, Any]:- """Fetch all MCP servers and ensure each includes provided global-var headers in args.-- Returns a summary dict with counts.- """- servers = await self.list_mcp_servers()- if not servers:- return {"updated": 0, "failed": 0, "total": 0}-- updated = 0- failed = 0- for server in servers:- name = server.get("name") or server.get("server") or server.get("id")- if not name:- continue- ok = await self.patch_mcp_server_args_with_global_vars(name, global_vars)- if ok:- updated += 1- else:- failed += 1-- summary = {"updated": updated, "failed": failed, "total": len(servers)}- if failed == 0:- logger.info("MCP servers updated with global-var headers", **summary)- else:- logger.warning("MCP servers update (global vars) had failures", **summary)- return summary-- async def patch_mcp_server_args_with_jwt(- self, server_name: str, jwt_token: str- ) -> bool:- """Patch a single MCP server to include/update the JWT header.-- Supports both stdio mode (command/args) and streamable HTTP mode (url/headers).- """- try:- current = await self.get_mcp_server(server_name)-- # Detect server mode and build appropriate payload- if self._is_streamable_http_mode(current):- # Streamable HTTP mode: update headers dictionary- url = current.get("url")- headers = current.get("headers", {})- updated_headers = self._upsert_global_var_headers_in_dict(- headers, {"JWT": jwt_token}- )- payload = {"url": url, "headers": updated_headers}- mode = "streamable_http"- else:- # Stdio mode: update args list+ patched_args = list(args)+ url_patched = False+ for i, arg in enumerate(patched_args):+ if isinstance(arg, str) and (+ arg.startswith("http://") or arg.startswith("https://")+ ):+ new_url = self._patch_url_with_langflow_url(arg)+ if new_url != arg:+ patched_args[i] = new_url+ url_patched = True+ if not url_patched:+ logger.debug(+ "No URL to patch in stdio args, skipping",+ server_name=server_name,+ )+ return "skipped"command = current.get("command")- args = current.get("args", [])- updated_args = self._upsert_jwt_header_in_args(args, jwt_token)- payload = {"command": command, "args": updated_args}+ payload = {"command": command, "args": patched_args}mode = "stdio"response = await clients.langflow_request(@@ -450,157 +226,56 @@ class LangflowMCPService:)if response.status_code in (200, 201):logger.info(- "Patched MCP server with JWT header",+ "Patched MCP server URL",server_name=server_name,mode=mode,)- return True+ return "patched"else:logger.warning(- "Failed to patch MCP server",+ "Failed to patch MCP server URL",server_name=server_name,mode=mode,status_code=response.status_code,body=response.text,)- return False+ return "failed"except Exception as e:logger.error(- "Exception while patching MCP server",+ "Exception while patching MCP server URL",server_name=server_name,error=str(e),)- return False+ return "failed"- async def update_mcp_servers_with_jwt(self, jwt_token: str) -> Dict[str, Any]:- """Fetch all MCP servers and ensure each includes the JWT header in args.+ async def update_all_mcp_server_urls(self) -> Dict[str, Any]:+ """Fetch all MCP servers and update their URLs (replacing localhost with LANGFLOW_URL).+ Also converts eligible stdio servers to streamable HTTP mode.Returns a summary dict with counts."""servers = await self.list_mcp_servers()if not servers:- return {"updated": 0, "failed": 0, "total": 0}+ return {"patched": 0, "skipped": 0, "failed": 0, "total": 0}- updated = 0- failed = 0+ patched_count = 0+ skipped_count = 0+ failed_count = 0for server in servers:name = server.get("name") or server.get("server") or server.get("id")if not name:continue- ok = await self.patch_mcp_server_args_with_jwt(name, jwt_token)- if ok:- updated += 1+ ok = await self.patch_mcp_server_url(name)+ if ok == "patched":+ patched_count += 1+ elif ok == "skipped":+ skipped_count += 1else:- failed += 1-- summary = {"updated": updated, "failed": failed, "total": len(servers)}- if failed == 0:- logger.info("MCP servers updated with JWT header", **summary)- else:- logger.warning("MCP servers update had failures", **summary)- return summary-- async def convert_server_to_streamable_http(self, server_name: str) -> bool:- """Convert a stdio MCP server to streamable HTTP format.-- 1. Fetch current server config- 2. Check if convertible (stdio with URL ending in /mcp or /streamable)- 3. Extract URL and headers from args- 4. PATCH server with {url, headers} format- """- try:- current = await self.get_mcp_server(server_name)+ failed_count += 1- if not self._is_convertible_to_streamable_http(current):- logger.debug(- "Server not convertible to streamable HTTP",- server_name=server_name,- )- return False-- args = current.get("args", [])- url, headers = self._parse_stdio_args(args)-- if not url:- logger.warning(- "Could not extract URL from stdio args",- server_name=server_name,- args=args,- )- return False-- payload = {"url": url, "headers": headers}- response = await clients.langflow_request(- method="PATCH",- endpoint=f"/api/v2/mcp/servers/{server_name}",- json=payload,- )- if response.status_code in (200, 201):- logger.info(- "Converted MCP server to streamable HTTP",- server_name=server_name,- url=url,- headers_count=len(headers),- )- return True- else:- logger.warning(- "Failed to convert MCP server to streamable HTTP",- server_name=server_name,- status_code=response.status_code,- body=response.text,- )- return False- except Exception as e:- logger.error(- "Exception while converting MCP server to streamable HTTP",- server_name=server_name,- error=str(e),- )- return False-- async def convert_all_servers_to_streamable_http(self) -> Dict[str, Any]:- """Convert all eligible stdio servers to streamable HTTP.-- A server is eligible if:- - It has a 'command' field (stdio mode)- - First arg is a URL ending with /mcp or /streamable-- Returns summary: {converted, skipped, failed, total}- """- servers = await self.list_mcp_servers()- if not servers:- return {"converted": 0, "skipped": 0, "failed": 0, "total": 0}-- converted = 0- skipped = 0- failed = 0-- for server in servers:- name = server.get("name") or server.get("server") or server.get("id")- if not name:- continue-- if not self._is_convertible_to_streamable_http(server):- skipped += 1- continue-- ok = await self.convert_server_to_streamable_http(name)- if ok:- converted += 1- else:- failed += 1-- summary = {- "converted": converted,- "skipped": skipped,- "failed": failed,- "total": len(servers),- }- if failed == 0:- logger.info(- "MCP servers conversion to streamable HTTP completed", **summary- )+ summary = {"patched": patched_count, "skipped": skipped_count, "failed": failed_count, "total": len(servers)}+ if failed_count == 0:+ logger.info("MCP servers URL update completed", **summary)else:- logger.warning("MCP servers conversion had failures", **summary)+ logger.warning("MCP servers URL update had failures", **summary)return summarydiff --git a/src/utils/langflow_headers.py b/src/utils/langflow_headers.pyindex bef62945b..12c24325d 100644--- a/src/utils/langflow_headers.py+++ b/src/utils/langflow_headers.py@@ -73,59 +73,4 @@ async def add_provider_credentials_to_headers(headers.update(build_ibm_opensearch_vars(jwt_token, prefix="X-LANGFLOW-GLOBAL-VAR-"))-async def build_mcp_global_vars_from_config(- config,- flows_service=None,- jwt_token: str = None,-) -> Dict[str, str]:- """Build MCP global variables dictionary from OpenRAG configuration.-- Args:- config: OpenRAGConfig object containing provider configurations- flows_service: Optional FlowsService instance to resolve Ollama URLs.- jwt_token: Optional credential string (``'Basic <b64>'`` or ``'Bearer <jwt>'``).- When IBM_AUTH_ENABLED, injected as global variables. Basic credentials- additionally provide OPENSEARCH_USERNAME and OPENSEARCH_PASSWORD.-- Returns:- Dictionary of global variables for MCP servers (without X-Langflow-Global-Var prefix)- """- global_vars = {}-- # Add OpenAI credentials- if config.providers.openai.api_key:- global_vars["OPENAI_API_KEY"] = config.providers.openai.api_key-- # Add Anthropic credentials- if config.providers.anthropic.api_key:- global_vars["ANTHROPIC_API_KEY"] = config.providers.anthropic.api_key-- # Add WatsonX credentials- if config.providers.watsonx.api_key:- global_vars["WATSONX_APIKEY"] = config.providers.watsonx.api_key-- if config.providers.watsonx.project_id:- global_vars["WATSONX_PROJECT_ID"] = config.providers.watsonx.project_id-- # Add Ollama endpoint (with localhost transformation)- if config.providers.ollama.endpoint:- if flows_service:- ollama_endpoint = await flows_service.resolve_ollama_url(config.providers.ollama.endpoint)- else:- ollama_endpoint = transform_localhost_url(config.providers.ollama.endpoint)- global_vars["OLLAMA_BASE_URL"] = ollama_endpoint-- # Add selected embedding model- if config.knowledge.embedding_model:- global_vars["SELECTED_EMBEDDING_MODEL"] = config.knowledge.embedding_model-- # Inject OpenSearch URL so MCP servers always use the correct endpoint- from config.settings import LANGFLOW_OPENSEARCH_HOST, LANGFLOW_OPENSEARCH_PORT- global_vars["OPENSEARCH_URL"] = f"https://{LANGFLOW_OPENSEARCH_HOST}:{LANGFLOW_OPENSEARCH_PORT}"-- # IBM mode: inject OpenSearch Basic credentials as separate global vars- from config.settings import IBM_AUTH_ENABLED- if IBM_AUTH_ENABLED and jwt_token:- global_vars.update(build_ibm_opensearch_vars(jwt_token, prefix=""))- return global_varsdiff --git a/tests/integration/core/test_mcp_url_ingest.py b/tests/integration/core/test_mcp_url_ingest.pynew file mode 100644index 000000000..73e1695aa--- /dev/null+++ b/tests/integration/core/test_mcp_url_ingest.py@@ -0,0 +1,153 @@+import asyncio+import json+import os+from typing import Any++import pytest+++OPENRAG_MCP_SERVER_NAME = "lf-starter_project"+LANGFLOW_GLOBAL_VAR_PREFIX = "x-langflow-global-var-"+++async def _wait_for_langflow_client(timeout_s: float = 60.0):+ from config.settings import clients++ await clients.initialize()+ deadline = asyncio.get_event_loop().time() + timeout_s+ while asyncio.get_event_loop().time() < deadline:+ langflow_client = await clients.ensure_langflow_client()+ if langflow_client is not None:+ return langflow_client+ await asyncio.sleep(1.0)+ return None+++def _server_name(server: dict[str, Any]) -> str | None:+ return server.get("name") or server.get("server") or server.get("id")+++def _extract_server_urls(server_config: dict[str, Any]) -> list[str]:+ urls = []+ url = server_config.get("url")+ if isinstance(url, str):+ urls.append(url)++ args = server_config.get("args", [])+ if isinstance(args, list):+ urls.extend(+ arg+ for arg in args+ if isinstance(arg, str)+ and (arg.startswith("http://") or arg.startswith("https://"))+ )+ return urls+++def _extract_server_headers(server_config: dict[str, Any]) -> dict[str, str]:+ headers = {}++ raw_headers = server_config.get("headers")+ if isinstance(raw_headers, dict):+ headers.update(+ {+ str(key): str(value)+ for key, value in raw_headers.items()+ if value is not None+ }+ )++ args = server_config.get("args", [])+ if isinstance(args, list):+ i = 0+ while i < len(args):+ if args[i] == "--headers" and i + 2 < len(args):+ headers[str(args[i + 1])] = str(args[i + 2])+ i += 3+ else:+ i += 1++ return headers+++def _assert_no_persisted_langflow_globals(headers: dict[str, str]) -> None:+ persisted_global_headers = [+ key for key in headers if key.lower().startswith(LANGFLOW_GLOBAL_VAR_PREFIX)+ ]+ assert not persisted_global_headers, (+ "MCP server config must not persist Langflow global-var headers: "+ f"{persisted_global_headers}"+ )+++async def test_openrag_mcp_server_url_is_patched_without_persisting_request_globals():+ from config.settings import LANGFLOW_URL+ from services.langflow_mcp_service import LangflowMCPService++ langflow_client = await _wait_for_langflow_client()+ assert langflow_client is not None, (+ "Langflow client not initialized. Provide LANGFLOW_KEY or enable "+ "superuser auto-login for integration tests."+ )++ mcp_service = LangflowMCPService()+ await mcp_service.update_all_mcp_server_urls()++ servers = await mcp_service.list_mcp_servers()+ server_names = [_server_name(server) for server in servers]+ assert OPENRAG_MCP_SERVER_NAME in server_names, (+ f"Expected OpenRAG MCP server {OPENRAG_MCP_SERVER_NAME!r}; "+ f"found {server_names}"+ )++ server_config = await mcp_service.get_mcp_server(OPENRAG_MCP_SERVER_NAME)+ urls = _extract_server_urls(server_config)+ assert urls, f"MCP server has no configured URL: {server_config}"++ expected_base = (LANGFLOW_URL or os.environ.get("LANGFLOW_URL", "")).rstrip("/")+ if expected_base and "localhost" not in expected_base:+ assert any(url.startswith(expected_base) for url in urls), (+ f"MCP server URLs were not rewritten to LANGFLOW_URL={expected_base!r}: "+ f"{urls}"+ )++ _assert_no_persisted_langflow_globals(_extract_server_headers(server_config))+++async def test_loaded_agent_flow_routes_request_globals_into_mcp_headers():+ from config.settings import LANGFLOW_CHAT_FLOW_ID, clients++ langflow_client = await _wait_for_langflow_client()+ assert langflow_client is not None, (+ "Langflow client not initialized. Provide LANGFLOW_KEY or enable "+ "superuser auto-login for integration tests."+ )+ assert LANGFLOW_CHAT_FLOW_ID, "LANGFLOW_CHAT_FLOW_ID is required"++ response = await clients.langflow_request(+ "GET",+ f"/api/v1/flows/{LANGFLOW_CHAT_FLOW_ID}",+ )+ response.raise_for_status()+ flow_text = json.dumps(response.json())++ assert "opensearch_url_ingestion_flow" in flow_text+ assert OPENRAG_MCP_SERVER_NAME in flow_text+ assert '"name": "headers"' in flow_text++ for global_var_name in [+ "JWT",+ "OPENAI_API_KEY",+ "OPENSEARCH_URL",+ "OWNER",+ "OWNER_EMAIL",+ "OWNER_NAME",+ "SELECTED_EMBEDDING_MODEL",+ "WATSONX_APIKEY",+ "WATSONX_PROJECT_ID",+ "OPENSEARCH_INDEX_NAME",+ "CONNECTOR_TYPE",+ ]:+ assert f"X-Langflow-Global-Var-{global_var_name}" in flow_text