lfx-nightly 0.1.12.dev14__py3-none-any.whl → 0.1.12.dev16__py3-none-any.whl

lfx/components/tools/__init__.py

@@ -9,8 +9,6 @@ from lfx.components._importing import import_mod
 
 if TYPE_CHECKING:
     from .calculator import CalculatorToolComponent
-    from .google_search_api import GoogleSearchAPIComponent
-    from .google_serper_api import GoogleSerperAPIComponent
     from .python_code_structured_tool import PythonCodeStructuredTool
     from .python_repl import PythonREPLToolComponent
     from .search_api import SearchAPIComponent
@@ -23,8 +21,6 @@ if TYPE_CHECKING:
 
 _dynamic_imports = {
     "CalculatorToolComponent": "calculator",
-    "GoogleSearchAPIComponent": "google_search_api",
-    "GoogleSerperAPIComponent": "google_serper_api",
     "PythonCodeStructuredTool": "python_code_structured_tool",
     "PythonREPLToolComponent": "python_repl",
     "SearchAPIComponent": "search_api",
@@ -38,8 +34,6 @@ _dynamic_imports = {
 
 __all__ = [
     "CalculatorToolComponent",
-    "GoogleSearchAPIComponent",
-    "GoogleSerperAPIComponent",
     "PythonCodeStructuredTool",
     "PythonREPLToolComponent",
     "SearXNGToolComponent",

lfx/components/tools/calculator.py

@@ -13,11 +13,12 @@ from lfx.schema.data import Data
 
 
 class CalculatorToolComponent(LCToolComponent):
-    display_name = "Calculator [DEPRECATED]"
+    display_name = "Calculator"
     description = "Perform basic arithmetic operations on a given expression."
     icon = "calculator"
     name = "CalculatorTool"
     legacy = True
+    replacement = ["helpers.CalculatorComponent"]
 
     inputs = [
         MessageTextInput(

lfx/components/tools/python_code_structured_tool.py

@@ -37,6 +37,7 @@ class PythonCodeStructuredTool(LCToolComponent):
     icon = "Python"
     field_order = ["name", "description", "tool_code", "return_direct", "tool_function"]
     legacy: bool = True
+    replacement = ["processing.PythonREPLComponent"]
 
     inputs = [
         MultilineInput(

lfx/components/tools/python_repl.py

@@ -13,11 +13,12 @@ from lfx.schema.data import Data
 
 
 class PythonREPLToolComponent(LCToolComponent):
-    display_name = "Python REPL [DEPRECATED]"
+    display_name = "Python REPL"
     description = "A tool for running Python code in a REPL environment."
     name = "PythonREPLTool"
     icon = "Python"
     legacy = True
+    replacement = ["processing.PythonREPLComponent"]
 
     inputs = [
         StrInput(

lfx/components/tools/search_api.py

@@ -11,12 +11,13 @@ from lfx.schema.data import Data
 
 
 class SearchAPIComponent(LCToolComponent):
-    display_name: str = "Search API [DEPRECATED]"
+    display_name: str = "Search API"
     description: str = "Call the searchapi.io API with result limiting"
     name = "SearchAPI"
     documentation: str = "https://www.searchapi.io/docs/google"
     icon = "SearchAPI"
     legacy = True
+    replacement = ["searchapi.SearchComponent"]
 
     inputs = [
         MessageTextInput(name="engine", display_name="Engine", value="google"),

lfx/components/tools/serp_api.py

@@ -30,11 +30,12 @@ class SerpAPISchema(BaseModel):
 
 
 class SerpAPIComponent(LCToolComponent):
-    display_name = "Serp Search API [DEPRECATED]"
+    display_name = "Serp Search API"
     description = "Call Serp Search API with result limiting"
     name = "SerpAPI"
     icon = "SerpSearch"
     legacy = True
+    replacement = ["serpapi.Serp"]
 
     inputs = [
         SecretStrInput(name="serpapi_api_key", display_name="SerpAPI API Key", required=True),

lfx/components/tools/tavily_search_tool.py

@@ -81,6 +81,7 @@ Note: Check 'Advanced' for all options.
     name = "TavilyAISearch"
     documentation = "https://docs.tavily.com/"
     legacy = True
+    replacement = ["tavily.TavilySearchComponent"]
 
     inputs = [
         SecretStrInput(

lfx/components/tools/wikidata_api.py

@@ -53,11 +53,12 @@ class WikidataAPIWrapper(BaseModel):
 
 
 class WikidataAPIComponent(LCToolComponent):
-    display_name = "Wikidata API [Deprecated]"
+    display_name = "Wikidata API"
     description = "Performs a search using the Wikidata API."
     name = "WikidataAPI"
     icon = "Wikipedia"
     legacy = True
+    replacement = ["wikipedia.WikidataComponent"]
 
     inputs = [
         MultilineInput(

lfx/components/tools/wikipedia_api.py

@@ -10,11 +10,12 @@ from lfx.schema.data import Data
 
 
 class WikipediaAPIComponent(LCToolComponent):
-    display_name = "Wikipedia API [Deprecated]"
+    display_name = "Wikipedia API"
     description = "Call Wikipedia API."
     name = "WikipediaAPI"
     icon = "Wikipedia"
     legacy = True
+    replacement = ["wikipedia.WikipediaComponent"]
 
     inputs = [
         MultilineInput(

lfx/components/tools/yahoo_finance.py

@@ -48,12 +48,13 @@ class YahooFinanceSchema(BaseModel):
 
 
 class YfinanceToolComponent(LCToolComponent):
-    display_name = "Yahoo! Finance [DEPRECATED]"
+    display_name = "Yahoo! Finance"
     description = """Uses [yfinance](https://pypi.org/project/yfinance/) (unofficial package) \
 to access financial data and market information from Yahoo! Finance."""
     icon = "trending-up"
     name = "YahooFinanceTool"
     legacy = True
+    replacement = ["yahoosearch.YfinanceComponent"]
 
     inputs = [
         MessageTextInput(

lfx/components/twelvelabs/video_embeddings.py

@@ -85,7 +85,7 @@ class TwelveLabsVideoEmbeddingsComponent(LCEmbeddingsModel):
     icon = "TwelveLabs"
     documentation = "https://github.com/twelvelabs-io/twelvelabs-developer-experience/blob/main/integrations/Langflow/TWELVE_LABS_COMPONENTS_README.md"
     inputs = [
-        SecretStrInput(name="api_key", display_name="API Key", required=True),
+        SecretStrInput(name="api_key", display_name="TwelveLabs API Key", required=True),
         DropdownInput(
             name="model_name",
             display_name="Model",

lfx/components/upstash/upstash.py

@@ -27,7 +27,7 @@ class UpstashVectorStoreComponent(LCVectorStoreComponent):
         ),
         SecretStrInput(
             name="index_token",
-            display_name="Index Token",
+            display_name="Upstash Index Token",
             info="The token for the Upstash index.",
             required=True,
         ),

lfx/components/vectorstores/astradb_graph.py

@@ -1,7 +1,7 @@
 import os
 
 import orjson
-from astrapy.admin import parse_api_endpoint
+from langchain_core.documents import Document
 
 from lfx.base.vectorstores.model import LCVectorStoreComponent, check_cached_vector_store
 from lfx.helpers.data import docs_to_data
@@ -16,6 +16,7 @@ from lfx.inputs.inputs import (
     StrInput,
 )
 from lfx.schema.data import Data
+from lfx.serialization import serialize
 
 
 class AstraDBGraphVectorStoreComponent(LCVectorStoreComponent):
@@ -174,6 +175,7 @@ class AstraDBGraphVectorStoreComponent(LCVectorStoreComponent):
     @check_cached_vector_store
     def build_vector_store(self):
         try:
+            from astrapy.admin import parse_api_endpoint
             from langchain_astradb import AstraDBGraphVectorStore
             from langchain_astradb.utils.astradb import SetupMode
         except ImportError as e:
@@ -236,6 +238,11 @@ class AstraDBGraphVectorStoreComponent(LCVectorStoreComponent):
                 msg = "Vector Store Inputs must be Data objects."
                 raise TypeError(msg)
 
+        # Serialize metadata to handle Properties objects and other non-JSON serializable types
+        documents = [
+            Document(page_content=doc.page_content, metadata=serialize(doc.metadata, to_str=True)) for doc in documents
+        ]
+
         if documents:
             self.log(f"Adding {len(documents)} documents to the Vector Store.")
             try:

lfx/components/vectorstores/local_db.py

@@ -22,6 +22,7 @@ class LocalDBComponent(LCVectorStoreComponent):
     name = "LocalDB"
     icon = "database"
     legacy = True
+    replacement = ["knowledgebases.KnowledgeRetrieval", "knowledgebases.KnowledgeIngestion"]
 
     inputs = [
         TabInput(

lfx/components/vectorstores/weaviate.py

@@ -15,7 +15,7 @@ class WeaviateVectorStoreComponent(LCVectorStoreComponent):
 
     inputs = [
         StrInput(name="url", display_name="Weaviate URL", value="http://localhost:8080", required=True),
-        SecretStrInput(name="api_key", display_name="API Key", required=False),
+        SecretStrInput(name="api_key", display_name="Weaviate API Key", required=False),
         StrInput(
             name="index_name",
             display_name="Index Name",

lfx/components/wolframalpha/wolfram_alpha_api.py

@@ -22,7 +22,7 @@ topics, delivering structured responses."""
         MultilineInput(
             name="input_value", display_name="Input Query", info="Example query: 'What is the population of France?'"
         ),
-        SecretStrInput(name="app_id", display_name="App ID", required=True),
+        SecretStrInput(name="app_id", display_name="WolframAlpha App ID", required=True),
     ]
 
     icon = "WolframAlphaAPI"

lfx/components/zep/zep.py

@@ -9,10 +9,11 @@ class ZepChatMemory(LCChatMemoryComponent):
     name = "ZepChatMemory"
     icon = "ZepMemory"
     legacy = True
+    replacement = ["helpers.Memory"]
 
     inputs = [
         MessageTextInput(name="url", display_name="Zep URL", info="URL of the Zep instance."),
-        SecretStrInput(name="api_key", display_name="API Key", info="API Key for the Zep instance."),
+        SecretStrInput(name="api_key", display_name="Zep API Key", info="API Key for the Zep instance."),
         DropdownInput(
             name="api_base_path",
             display_name="API Base Path",

lfx/custom/attributes.py

@@ -69,6 +69,7 @@ ATTR_FUNC_MAPPING: dict[str, Callable] = {
     "description": getattr_return_str,
     "beta": getattr_return_bool,
     "legacy": getattr_return_bool,
+    "replacement": getattr_return_list_of_str,
     "documentation": getattr_return_str,
     "priority": getattr_return_int,
     "icon": validate_icon,

lfx/custom/validate.py

@@ -281,7 +281,7 @@ def create_class(code, class_name):
         error_message = "\n".join([message[1] if len(message) > 1 else message[0] for message in messages])
         raise ValueError(error_message) from e
     except Exception as e:
-        msg = f"Error creating class: {e!s}"
+        msg = f"Error creating class. {type(e).__name__}({e!s})."
         raise ValueError(msg) from e
 
 

lfx/graph/graph/base.py

@@ -102,6 +102,9 @@ class Graph:
         self.vertices_to_run: set[str] = set()
         self.stop_vertex: str | None = None
         self.inactive_vertices: set = set()
+        # Conditional routing system (separate from ACTIVE/INACTIVE cycle management)
+        self.conditionally_excluded_vertices: set = set()  # Vertices excluded by conditional routing
+        self.conditional_exclusion_sources: dict[str, set[str]] = {}  # Maps source vertex -> excluded vertices
         self.edges: list[CycleEdge] = []
         self.vertices: list[Vertex] = []
         self.run_manager = RunnableVerticesManager()
@@ -966,6 +969,59 @@ class Graph:
             vertices_to_run=self.vertices_to_run,
         )
 
+    def exclude_branch_conditionally(self, vertex_id: str, output_name: str | None = None) -> None:
+        """Marks a branch as conditionally excluded (for conditional routing).
+
+        This system is separate from the ACTIVE/INACTIVE state used for cycle management:
+        - ACTIVE/INACTIVE: Reset after each cycle iteration to allow cycles to continue
+        - Conditional exclusion: Persists until explicitly cleared by the same source vertex
+
+        Used by ConditionalRouter to ensure only one branch executes per condition evaluation.
+        If this vertex has previously excluded branches, they are cleared first to allow
+        re-evaluation on subsequent iterations (e.g., in cycles where condition may change).
+
+        Args:
+            vertex_id: The source vertex making the exclusion decision
+            output_name: The output name to follow when excluding downstream vertices
+        """
+        # Clear any previous exclusions from this source vertex
+        if vertex_id in self.conditional_exclusion_sources:
+            previous_exclusions = self.conditional_exclusion_sources[vertex_id]
+            self.conditionally_excluded_vertices -= previous_exclusions
+            del self.conditional_exclusion_sources[vertex_id]
+
+        # Now exclude the new branch
+        visited: set[str] = set()
+        excluded: set[str] = set()
+        self._exclude_branch_conditionally(vertex_id, visited, excluded, output_name, skip_first=True)
+
+        # Track which vertices this source excluded
+        if excluded:
+            self.conditional_exclusion_sources[vertex_id] = excluded
+
+    def _exclude_branch_conditionally(
+        self, vertex_id: str, visited: set, excluded: set, output_name: str | None = None, *, skip_first: bool = False
+    ) -> None:
+        """Recursively excludes vertices in a branch for conditional routing."""
+        if vertex_id in visited:
+            return
+        visited.add(vertex_id)
+
+        # Don't exclude the first vertex (the router itself)
+        if not skip_first:
+            self.conditionally_excluded_vertices.add(vertex_id)
+            excluded.add(vertex_id)
+
+        for child_id in self.parent_child_map[vertex_id]:
+            # If we're at the router (skip_first=True) and have an output_name,
+            # only follow edges from that specific output
+            if skip_first and output_name:
+                edge = self.get_edge(vertex_id, child_id)
+                if edge and edge.source_handle.name != output_name:
+                    continue
+            # After the first level, exclude all descendants
+            self._exclude_branch_conditionally(child_id, visited, excluded, output_name=None, skip_first=False)
+
     def get_edge(self, source_id: str, target_id: str) -> CycleEdge | None:
         """Returns the edge between two vertices."""
         for edge in self.edges:
@@ -2135,6 +2191,9 @@ class Graph:
 
     def is_vertex_runnable(self, vertex_id: str) -> bool:
         """Returns whether a vertex is runnable."""
+        # Check if vertex is conditionally excluded (for conditional routing)
+        if vertex_id in self.conditionally_excluded_vertices:
+            return False
         is_active = self.get_vertex(vertex_id).is_active()
         is_loop = self.get_vertex(vertex_id).is_loop
         return self.run_manager.is_vertex_runnable(vertex_id, is_active=is_active, is_loop=is_loop)
@@ -2167,10 +2226,8 @@ class Graph:
             if predecessor_id in visited:
                 return
             visited.add(predecessor_id)
-            predecessor_vertex = self.get_vertex(predecessor_id)
-            is_active = predecessor_vertex.is_active()
-            is_loop = predecessor_vertex.is_loop
-            if self.run_manager.is_vertex_runnable(predecessor_id, is_active=is_active, is_loop=is_loop):
+
+            if self.is_vertex_runnable(predecessor_id):
                 runnable_vertices.append(predecessor_id)
             else:
                 for pred_pred_id in self.run_manager.run_predecessors.get(predecessor_id, []):

lfx/inputs/inputs.py

@@ -493,6 +493,7 @@ class DropdownInput(BaseInputMixin, DropDownMixin, MetadataTraceMixin, ToolModeM
     options_metadata: list[dict[str, Any]] = Field(default_factory=list)
     combobox: CoalesceBool = False
     dialog_inputs: dict[str, Any] = Field(default_factory=dict)
+    external_options: dict[str, Any] = Field(default_factory=dict)
     toggle: bool = False
     toggle_disable: bool | None = None
     toggle_value: bool | None = None

lfx/log/logger.py

@@ -218,9 +218,11 @@ def configure(
     if os.getenv("LANGFLOW_LOG_LEVEL", "").upper() in VALID_LOG_LEVELS and log_level is None:
         log_level = os.getenv("LANGFLOW_LOG_LEVEL")
 
-    requested_min_level = LOG_LEVEL_MAP.get(
-        (log_level or os.getenv("LANGFLOW_LOG_LEVEL", "ERROR")).upper(), logging.ERROR
-    )
+    log_level_str = os.getenv("LANGFLOW_LOG_LEVEL", "ERROR")
+    if log_level is not None:
+        log_level_str = log_level
+
+    requested_min_level = LOG_LEVEL_MAP.get(log_level_str.upper(), logging.ERROR)
     if current_min_level == requested_min_level:
         return
 
@@ -243,20 +245,38 @@ def configure(
         structlog.contextvars.merge_contextvars,
         structlog.processors.add_log_level,
         structlog.processors.TimeStamper(fmt="iso"),
-        add_serialized,
-        remove_exception_in_production,
-        buffer_writer,
     ]
 
+    # Add callsite information only when LANGFLOW_DEV is set
+    if DEV:
+        processors.append(
+            structlog.processors.CallsiteParameterAdder(
+                parameters=[
+                    structlog.processors.CallsiteParameter.FILENAME,
+                    structlog.processors.CallsiteParameter.FUNC_NAME,
+                    structlog.processors.CallsiteParameter.LINENO,
+                ]
+            )
+        )
+
+    processors.extend(
+        [
+            add_serialized,
+            remove_exception_in_production,
+            buffer_writer,
+        ]
+    )
+
     # Configure output based on environment
     if log_env.lower() == "container" or log_env.lower() == "container_json":
         processors.append(structlog.processors.JSONRenderer())
     elif log_env.lower() == "container_csv":
-        processors.append(
-            structlog.processors.KeyValueRenderer(
-                key_order=["timestamp", "level", "module", "event"], drop_missing=True
-            )
-        )
+        # Include callsite fields in key order when DEV is enabled
+        key_order = ["timestamp", "level", "event"]
+        if DEV:
+            key_order += ["filename", "func_name", "lineno"]
+
+        processors.append(structlog.processors.KeyValueRenderer(key_order=key_order, drop_missing=True))
     else:
         # Use rich console for pretty printing based on environment variable
         log_stdout_pretty = os.getenv("LANGFLOW_PRETTY_LOGS", "true").lower() == "true"

lfx/schema/message.py

@@ -11,7 +11,7 @@ from uuid import UUID
 
 from fastapi.encoders import jsonable_encoder
 from langchain_core.load import load
-from langchain_core.messages import AIMessage, BaseMessage, HumanMessage, SystemMessage
+from langchain_core.messages import AIMessage, BaseMessage, HumanMessage, SystemMessage, ToolMessage
 from langchain_core.prompts.chat import BaseChatPromptTemplate, ChatPromptTemplate
 from langchain_core.prompts.prompt import PromptTemplate
 from pydantic import BaseModel, ConfigDict, Field, ValidationError, field_serializer, field_validator
@@ -158,6 +158,9 @@ class Message(Data):
         elif lc_message.type == "system":
             sender = "System"
             sender_name = "System"
+        elif lc_message.type == "tool":
+            sender = "Tool"
+            sender_name = "Tool"
         else:
             sender = lc_message.type
             sender_name = lc_message.type
@@ -222,6 +225,8 @@ class Message(Data):
                     messages.append(SystemMessage(content=message.get("content")))
                 case _ if message.get("type") == "ai":
                     messages.append(AIMessage(content=message.get("content")))
+                case _ if message.get("type") == "tool":
+                    messages.append(ToolMessage(content=message.get("content")))
 
         self.prompt["kwargs"]["messages"] = messages
         return load(self.prompt)

lfx/schema/schema.py

@@ -2,6 +2,7 @@ from collections.abc import Generator
 from enum import Enum
 from typing import TYPE_CHECKING, Literal
 
+from pandas import Series
 from pydantic import BaseModel, ConfigDict, Field
 from typing_extensions import TypedDict
 
@@ -84,6 +85,9 @@ def get_message(payload):
     if message is None and isinstance(payload, dict | str | Data):
         message = payload.data if isinstance(payload, Data) else payload
 
+    if isinstance(message, Series):
+        return message if not message.empty else payload
+
     return message or payload
 
 

lfx/services/__init__.py

@@ -8,12 +8,15 @@ from .interfaces import (
     VariableServiceProtocol,
 )
 from .manager import ServiceManager
+from .mcp_composer import MCPComposerService, MCPComposerServiceFactory
 from .session import NoopSession
 
 __all__ = [
     "CacheServiceProtocol",
     "ChatServiceProtocol",
     "DatabaseServiceProtocol",
+    "MCPComposerService",
+    "MCPComposerServiceFactory",
     "NoopSession",
     "ServiceManager",
     "SettingsServiceProtocol",

lfx/services/mcp_composer/__init__.py

@@ -0,0 +1,6 @@
+"""MCP Composer service for Langflow."""
+
+from lfx.services.mcp_composer.factory import MCPComposerServiceFactory
+from lfx.services.mcp_composer.service import MCPComposerService
+
+__all__ = ["MCPComposerService", "MCPComposerServiceFactory"]

lfx/services/mcp_composer/factory.py

@@ -0,0 +1,16 @@
+"""Factory for creating MCP Composer service instances."""
+
+from lfx.services.factory import ServiceFactory
+from lfx.services.mcp_composer.service import MCPComposerService
+
+
+class MCPComposerServiceFactory(ServiceFactory):
+    """Factory for creating MCP Composer service instances."""
+
+    def __init__(self):
+        super().__init__()
+        self.service_class = MCPComposerService
+
+    def create(self, **kwargs):  # noqa: ARG002
+        """Create a new MCP Composer service instance."""
+        return MCPComposerService()