lfx-exa 0.1.0__py3-none-any.whl

lfx_exa/__init__.py

@@ -0,0 +1,18 @@
+"""lfx-exa: Exa Search bundle.
+
+This package is the distribution unit ``lfx-exa``.  At runtime
+Langflow's loader discovers ``extension.json`` shipped alongside this
+``__init__.py`` and registers ``ExaSearchToolkit`` under the namespaced
+ID ``ext:exa:ExaSearchToolkit@official``.
+
+Graduated out of the manifest-less ``lfx-bundles`` metapackage when the
+component was modernized onto the ``exa-py`` SDK (the metapackage copy
+still used the deprecated ``metaphor-python`` client).  The bundle name
+(``exa``) and class name are unchanged, so the canonical component ID --
+and every migration-table entry pointing at it -- is stable across the
+move.
+"""
+
+from lfx_exa.components.exa.exa_search import ExaSearchToolkit
+
+__all__ = ["ExaSearchToolkit"]

lfx_exa/components/exa/__init__.py

@@ -0,0 +1,3 @@
+from .exa_search import ExaSearchToolkit
+
+__all__ = ["ExaSearchToolkit"]

lfx_exa/components/exa/exa_search.py

@@ -0,0 +1,213 @@
+from exa_py import Exa
+from langchain_core.tools import tool
+from lfx.custom.custom_component.component import Component
+from lfx.field_typing import Tool
+from lfx.io import (
+    BoolInput,
+    DropdownInput,
+    IntInput,
+    MessageTextInput,
+    Output,
+    SecretStrInput,
+)
+
+EXA_INTEGRATION_NAME = "langflow-integration"
+
+
+class ExaSearchToolkit(Component):
+    display_name = "Exa Search"
+    description = "Exa search and contents tools for agents and MCP clients."
+    documentation = "https://docs.exa.ai/reference/getting-started"
+    beta = True
+    name = "ExaSearch"
+    icon = "ExaSearch"
+
+    inputs = [
+        SecretStrInput(
+            name="exa_api_key",
+            display_name="Exa API Key",
+            info="Get one at https://dashboard.exa.ai/api-keys",
+            password=True,
+        ),
+        # Kept for backward compatibility with flows saved before the field
+        # was renamed. Hidden from the UI; users should fill in `exa_api_key`.
+        SecretStrInput(
+            name="metaphor_api_key",
+            display_name="Metaphor API Key (legacy)",
+            info="Deprecated. Use Exa API Key instead.",
+            password=True,
+            advanced=True,
+            show=False,
+        ),
+        DropdownInput(
+            name="search_type",
+            display_name="Search type",
+            options=["auto", "fast", "instant", "deep"],
+            value="auto",
+            info="Latency vs. depth tradeoff. `auto` is recommended for most use cases.",
+        ),
+        IntInput(
+            name="search_num_results",
+            display_name="Number of results",
+            value=10,
+        ),
+        BoolInput(
+            name="include_highlights",
+            display_name="Include highlights",
+            value=True,
+            advanced=True,
+            info="Token-efficient extracts of the most relevant text per result. Recommended default.",
+        ),
+        IntInput(
+            name="highlights_max_characters",
+            display_name="Highlights max characters",
+            value=0,
+            advanced=True,
+            info="Optional cap on the length of each highlight, in characters. 0 leaves it at Exa's default.",
+        ),
+        BoolInput(
+            name="include_text",
+            display_name="Include full text",
+            value=False,
+            advanced=True,
+            info="Return full page text. Off by default; prefer highlights for token efficiency.",
+        ),
+        DropdownInput(
+            name="category",
+            display_name="Category",
+            options=[
+                "",
+                "company",
+                "people",
+                "research paper",
+                "news",
+                "personal site",
+                "financial report",
+            ],
+            value="",
+            advanced=True,
+            info="Restrict to a specific Exa data category. Leave empty for general web search.",
+        ),
+        IntInput(
+            name="max_age_hours",
+            display_name="Max age (hours)",
+            value=0,
+            advanced=True,
+            info=(
+                "Max age of cached content (in hours) before refetching. "
+                "0 = always refetch. -1 = never refetch (use cache only)."
+            ),
+        ),
+        MessageTextInput(
+            name="include_domains",
+            display_name="Include domains",
+            value="",
+            advanced=True,
+            info="Comma-separated allowlist of domains.",
+        ),
+        MessageTextInput(
+            name="exclude_domains",
+            display_name="Exclude domains",
+            value="",
+            advanced=True,
+            info="Comma-separated denylist of domains.",
+        ),
+        MessageTextInput(
+            name="start_published_date",
+            display_name="Start published date",
+            value="",
+            advanced=True,
+            info="ISO date (YYYY-MM-DD). Only return results published on or after this date.",
+        ),
+        MessageTextInput(
+            name="end_published_date",
+            display_name="End published date",
+            value="",
+            advanced=True,
+            info="ISO date (YYYY-MM-DD). Only return results published on or before this date.",
+        ),
+    ]
+
+    outputs = [
+        Output(name="tools", display_name="Tools", method="build_toolkit"),
+    ]
+
+    def _resolved_api_key(self) -> str:
+        key = self.exa_api_key or self.metaphor_api_key
+        if not key:
+            msg = "Exa API key is required. Set the Exa API Key input."
+            raise ValueError(msg)
+        return key
+
+    def _build_client(self) -> Exa:
+        client = Exa(api_key=self._resolved_api_key())
+        client.headers["x-exa-integration"] = EXA_INTEGRATION_NAME
+        return client
+
+    def _highlights_value(self) -> bool | dict | None:
+        if not self.include_highlights:
+            return None
+        if self.highlights_max_characters and self.highlights_max_characters > 0:
+            return {"max_characters": self.highlights_max_characters}
+        return True
+
+    def _contents(self) -> dict | None:
+        contents: dict = {}
+        highlights = self._highlights_value()
+        if highlights is not None:
+            contents["highlights"] = highlights
+        if self.include_text:
+            contents["text"] = True
+        if self.max_age_hours and self.max_age_hours != 0:
+            contents["max_age_hours"] = self.max_age_hours
+        return contents or None
+
+    @staticmethod
+    def _split_csv(raw: str) -> list[str] | None:
+        items = [s.strip() for s in (raw or "").split(",") if s.strip()]
+        return items or None
+
+    def build_toolkit(self) -> Tool:
+        client = self._build_client()
+        contents = self._contents()
+        category = self.category or None
+        include_domains = self._split_csv(self.include_domains)
+        exclude_domains = self._split_csv(self.exclude_domains)
+        start_published_date = (self.start_published_date or "").strip() or None
+        end_published_date = (self.end_published_date or "").strip() or None
+
+        @tool
+        def search(query: str):
+            """Search the web with Exa and return results with optional highlights."""
+            kwargs: dict = {
+                "type": self.search_type,
+                "num_results": self.search_num_results,
+            }
+            if contents is not None:
+                kwargs["contents"] = contents
+            if category:
+                kwargs["category"] = category
+            if include_domains:
+                kwargs["include_domains"] = include_domains
+            if exclude_domains:
+                kwargs["exclude_domains"] = exclude_domains
+            if start_published_date:
+                kwargs["start_published_date"] = start_published_date
+            if end_published_date:
+                kwargs["end_published_date"] = end_published_date
+            return client.search(query, **kwargs)
+
+        @tool
+        def get_contents(ids: list[str]):
+            """Fetch contents (highlights and/or text) for result IDs returned by `search`."""
+            kwargs: dict = {}
+            highlights = self._highlights_value()
+            if highlights is not None:
+                kwargs["highlights"] = highlights
+            if self.include_text:
+                kwargs["text"] = True
+            if self.max_age_hours and self.max_age_hours != 0:
+                kwargs["max_age_hours"] = self.max_age_hours
+            return client.get_contents(ids, **kwargs)
+
+        return [search, get_contents]

lfx_exa/extension.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://schemas.langflow.org/extension/v1.json",
+  "id": "lfx-exa",
+  "version": "0.1.0",
+  "name": "Exa",
+  "description": "Exa web-search and contents tools (exa-py SDK) as a standalone Langflow Extension Bundle.",
+  "lfx": {
+    "compat": ["1"]
+  },
+  "bundles": [
+    {
+      "name": "exa",
+      "path": "components/exa"
+    }
+  ]
+}

lfx_exa-0.1.0.dist-info/METADATA

@@ -0,0 +1,64 @@
+Metadata-Version: 2.4
+Name: lfx-exa
+Version: 0.1.0
+Summary: Exa web-search and contents tools (exa-py SDK) as a standalone Langflow Extension Bundle.
+Project-URL: Homepage, https://github.com/langflow-ai/langflow
+Project-URL: Documentation, https://docs.langflow.org/extensions
+Project-URL: Repository, https://github.com/langflow-ai/langflow
+Author-email: Langflow <contact@langflow.org>
+License: MIT
+Keywords: bundle,exa,extension,langflow,lfx,search
+Requires-Python: <3.15,>=3.10
+Requires-Dist: exa-py<3,>=1.14
+Requires-Dist: langchain-core<2.0.0,>=1.2.28
+Requires-Dist: lfx<2.0.0,>=1.11.0.dev0
+Description-Content-Type: text/markdown
+
+# lfx-exa
+
+[Exa](https://exa.ai/) web-search and contents tools as a standalone
+Langflow Extension Bundle.
+
+## What it ships
+
+One component, registered under the `exa` bundle group:
+
+- **Exa Search** (`ExaSearchToolkit`, canonical ID
+  `ext:exa:ExaSearchToolkit@official`) — a toolkit exposing two tools for
+  a Langflow **Agent** component or MCP client:
+  - `search` — search the web with Exa (`auto` / `fast` / `instant` /
+    `deep` search types, category, domain allow/deny lists, published-date
+    range), returning token-efficient highlights by default.
+  - `get_contents` — fetch highlights and/or full text for result IDs
+    returned by `search`.
+
+The component is built on the [`exa-py`](https://pypi.org/project/exa-py/)
+SDK. It previously shipped inside the manifest-less `lfx-bundles`
+metapackage on the deprecated `metaphor-python` client; the bundle name and
+class name are unchanged, so saved flows load without migration changes.
+The legacy `metaphor_api_key` field is still honored (hidden) — new flows
+should use `exa_api_key`.
+
+## Install
+
+```bash
+pip install lfx-exa
+```
+
+`pip install langflow` already includes it.
+
+## Develop
+
+The bundle is a uv workspace member of the Langflow monorepo:
+
+```bash
+uv sync
+uv run pytest src/bundles/exa/tests -q
+uv run lfx extension validate src/bundles/exa/src/lfx_exa
+```
+
+To iterate on the component with a live palette:
+
+```bash
+uv run lfx extension dev src/bundles/exa
+```

lfx_exa-0.1.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+lfx_exa/__init__.py,sha256=fCJ7e8qjfR-0NaACIK3LzgEXGmy71cH2wtL8d5UqSKw,745
+lfx_exa/extension.json,sha256=ovBxXhdLSzNLIiMyYL18zVy8REMpazrUSVgLF9REtIg,354
+lfx_exa/components/exa/__init__.py,sha256=ESYlh6mAyXrpDIIfgf7xJy0zeMmesIMy7xV5MR-FdJY,73
+lfx_exa/components/exa/exa_search.py,sha256=VQw9rT8ezSpbiEJenVNGGJa8NJml2Xfl1n70KIgghJM,7605
+lfx_exa-0.1.0.dist-info/METADATA,sha256=Sve_kAvHnYy4qrCmaMde75MM3WKUNyXcMb_LDISsWPo,2083
+lfx_exa-0.1.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+lfx_exa-0.1.0.dist-info/entry_points.txt,sha256=Z_SqIQOZ38m0FL3NNmfJTE9TsZ1o3bl3otIhx8N9URQ,40
+lfx_exa-0.1.0.dist-info/RECORD,,

lfx_exa-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

lfx_exa-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[langflow.extensions]
+lfx-exa = lfx_exa