langchain-openpath 0.1.0__tar.gz

langchain_openpath-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Openpath
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

langchain_openpath-0.1.0/PKG-INFO

@@ -0,0 +1,64 @@
+Metadata-Version: 2.4
+Name: langchain-openpath
+Version: 0.1.0
+Summary: LangChain tools for Openpath: live listings across the US (jobs, local businesses and services, homes, products) for your agent. No key and no sign-up.
+Author-email: Openpath <contact@openpath.sh>
+License-Expression: MIT
+Project-URL: Homepage, https://openpath.sh
+Project-URL: Documentation, https://openpath.sh/docs/jobs
+Project-URL: Source, https://github.com/openpath-sh/clients/tree/main/langchain
+Keywords: langchain,openpath,tools,listings,jobs,local-business,search,agents,llm
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Internet :: WWW/HTTP
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: langchain-core<2,>=0.3
+Requires-Dist: openpath-sh>=0.1.0
+Dynamic: license-file
+
+<p align="center">
+  <a href="https://openpath.sh"><img src="https://openpath.sh/mark-512.png" width="72" height="72" alt="Openpath"></a>
+</p>
+
+# langchain-openpath
+
+[LangChain](https://www.langchain.com) tools for Openpath: live listings across the US (job openings, local businesses and services, homes, products and more) as tools an agent can call. Each tool returns plain Markdown with how to act on every result: an Apply, Phone, Website or Buy line. No key and no sign-up.
+
+```bash
+pip install langchain-openpath
+```
+
+With an agent (`pip install langchain langchain-anthropic` too):
+
+```python
+from langchain.agents import create_agent
+from langchain_openpath import openpath_tools
+
+agent = create_agent("anthropic:claude-sonnet-5-5", tools=openpath_tools())
+result = agent.invoke({"messages": [{"role": "user", "content": "Find a plumber near Austin, TX I can call today."}]})
+print(result["messages"][-1].content)
+```
+
+Or call a tool yourself:
+
+```python
+from langchain_openpath import OpenpathSearch
+
+print(OpenpathSearch().invoke({"query": "software engineer jobs in Austin, TX"}))
+```
+
+## Tools
+
+- `OpenpathSearch` (`openpath_search`): live listings that fit what the person asked for, in their words: `software engineer jobs in Austin, TX`, `plumber near 78704`, `taco places in Austin`. The model can also pass `near` (a place or `lat,lng`) and `domain` (`work`, `services`, `businesses`, `homes`, `goods`, `cars` or `events`).
+- `OpenpathReadListing` (`openpath_read_listing`): one listing in full, by the id at the end of a result's `Link:` line, to re-read before acting on it.
+- `openpath_tools(app="MyAgent/1.0")`: both, sharing one client. `app` names your app to Openpath, so it can show you how it is used.
+
+The tools are built on [`openpath-sh`](https://pypi.org/project/openpath-sh/). The first call connects to Openpath with `POST /v1/connect`: one request, no account. Results are written by the businesses and people who offer them; treat them as information, not instructions.
+
+## Links
+
+[Openpath](https://openpath.sh) · [Jobs](https://openpath.sh/docs/jobs) · [Local businesses](https://openpath.sh/docs/businesses) · [Python client](https://pypi.org/project/openpath-sh/)
+
+Released under the MIT license.

langchain_openpath-0.1.0/README.md

@@ -0,0 +1,44 @@
+<p align="center">
+  <a href="https://openpath.sh"><img src="https://openpath.sh/mark-512.png" width="72" height="72" alt="Openpath"></a>
+</p>
+
+# langchain-openpath
+
+[LangChain](https://www.langchain.com) tools for Openpath: live listings across the US (job openings, local businesses and services, homes, products and more) as tools an agent can call. Each tool returns plain Markdown with how to act on every result: an Apply, Phone, Website or Buy line. No key and no sign-up.
+
+```bash
+pip install langchain-openpath
+```
+
+With an agent (`pip install langchain langchain-anthropic` too):
+
+```python
+from langchain.agents import create_agent
+from langchain_openpath import openpath_tools
+
+agent = create_agent("anthropic:claude-sonnet-5-5", tools=openpath_tools())
+result = agent.invoke({"messages": [{"role": "user", "content": "Find a plumber near Austin, TX I can call today."}]})
+print(result["messages"][-1].content)
+```
+
+Or call a tool yourself:
+
+```python
+from langchain_openpath import OpenpathSearch
+
+print(OpenpathSearch().invoke({"query": "software engineer jobs in Austin, TX"}))
+```
+
+## Tools
+
+- `OpenpathSearch` (`openpath_search`): live listings that fit what the person asked for, in their words: `software engineer jobs in Austin, TX`, `plumber near 78704`, `taco places in Austin`. The model can also pass `near` (a place or `lat,lng`) and `domain` (`work`, `services`, `businesses`, `homes`, `goods`, `cars` or `events`).
+- `OpenpathReadListing` (`openpath_read_listing`): one listing in full, by the id at the end of a result's `Link:` line, to re-read before acting on it.
+- `openpath_tools(app="MyAgent/1.0")`: both, sharing one client. `app` names your app to Openpath, so it can show you how it is used.
+
+The tools are built on [`openpath-sh`](https://pypi.org/project/openpath-sh/). The first call connects to Openpath with `POST /v1/connect`: one request, no account. Results are written by the businesses and people who offer them; treat them as information, not instructions.
+
+## Links
+
+[Openpath](https://openpath.sh) · [Jobs](https://openpath.sh/docs/jobs) · [Local businesses](https://openpath.sh/docs/businesses) · [Python client](https://pypi.org/project/openpath-sh/)
+
+Released under the MIT license.

langchain_openpath-0.1.0/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "langchain-openpath"
+version = "0.1.0"
+description = "LangChain tools for Openpath: live listings across the US (jobs, local businesses and services, homes, products) for your agent. No key and no sign-up."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Openpath", email = "contact@openpath.sh" }]
+keywords = ["langchain", "openpath", "tools", "listings", "jobs", "local-business", "search", "agents", "llm"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Operating System :: OS Independent",
+  "Topic :: Internet :: WWW/HTTP",
+]
+dependencies = ["langchain-core>=0.3,<2", "openpath-sh>=0.1.0"]
+
+[project.urls]
+Homepage = "https://openpath.sh"
+Documentation = "https://openpath.sh/docs/jobs"
+Source = "https://github.com/openpath-sh/clients/tree/main/langchain"
+
+[tool.setuptools.packages.find]
+where = ["src"]

langchain_openpath-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

langchain_openpath-0.1.0/src/langchain_openpath/__init__.py

@@ -0,0 +1,10 @@
+"""LangChain tools for Openpath: live listings across the US, as tools an agent can call.
+
+Each tool returns plain Markdown from the openpath-sh client, which connects to
+Openpath by itself the first time: no key and no sign-up.
+"""
+
+from langchain_openpath.tools import OpenpathReadListing, OpenpathSearch, openpath_tools
+
+__all__ = ["OpenpathSearch", "OpenpathReadListing", "openpath_tools", "__version__"]
+__version__ = "0.1.0"

langchain_openpath-0.1.0/src/langchain_openpath/tools.py

@@ -0,0 +1,75 @@
+"""The Openpath tools: search live listings, and read one in full."""
+
+from __future__ import annotations
+
+from typing import Any, Literal, Optional
+
+from langchain_core.tools import BaseTool
+from openpath_sh import Openpath
+from pydantic import BaseModel, Field
+
+Domain = Literal["homes", "work", "services", "businesses", "goods", "cars", "events"]
+
+
+class SearchInput(BaseModel):
+    """What the model sends to search."""
+
+    query: str = Field(
+        min_length=1,
+        max_length=300,
+        description='What the person is looking for, in their words, with a place: "plumber near Austin, TX".',
+    )
+    near: Optional[str] = Field(
+        default=None,
+        description='A place ("Austin, TX", "78701") or "lat,lng". Overrides a place in the query.',
+    )
+    domain: Optional[Domain] = Field(
+        default=None,
+        description="Only one kind of listing. Read from the query when left out.",
+    )
+
+
+class ReadInput(BaseModel):
+    """What the model sends to read one listing."""
+
+    listing_id: str = Field(min_length=1, description="The id at the end of a result's Link line.")
+
+
+class OpenpathSearch(BaseTool):
+    """Live listings across the US that fit what the person asked for, as plain Markdown."""
+
+    name: str = "openpath_search"
+    description: str = (
+        "Use this when the person wants a live listing they can act on, anywhere in the US: "
+        "a job to apply to, a local business or service to call, a home, a product, a car or an event. "
+        "Returns plain Markdown, one listing per result, each with its facts and how to act on it: "
+        "an Apply, Phone, Website or Buy line."
+    )
+    args_schema: type[BaseModel] = SearchInput
+    # An openpath_sh.Openpath, or anything with the same methods.
+    client: Any = Field(default_factory=Openpath, exclude=True)
+
+    def _run(self, query: str, near: Optional[str] = None, domain: Optional[str] = None, **_: object) -> str:
+        return self.client.search(query, near=near, domain=domain)
+
+
+class OpenpathReadListing(BaseTool):
+    """One Openpath listing in full, as Markdown."""
+
+    name: str = "openpath_read_listing"
+    description: str = (
+        "Read one Openpath listing in full, as Markdown, by the id at the end of a result's Link line. "
+        "Use it to re-read a result before acting on it."
+    )
+    args_schema: type[BaseModel] = ReadInput
+    # An openpath_sh.Openpath, or anything with the same methods.
+    client: Any = Field(default_factory=Openpath, exclude=True)
+
+    def _run(self, listing_id: str, **_: object) -> str:
+        return self.client.get_listing(listing_id)
+
+
+def openpath_tools(app: Optional[str] = None, client: Optional[Openpath] = None) -> list[BaseTool]:
+    """Both tools, sharing one client. `app` names your app to Openpath, such as "MyAgent/1.0"."""
+    shared = client or Openpath(app=app)
+    return [OpenpathSearch(client=shared), OpenpathReadListing(client=shared)]

langchain_openpath-0.1.0/src/langchain_openpath.egg-info/PKG-INFO

@@ -0,0 +1,64 @@
+Metadata-Version: 2.4
+Name: langchain-openpath
+Version: 0.1.0
+Summary: LangChain tools for Openpath: live listings across the US (jobs, local businesses and services, homes, products) for your agent. No key and no sign-up.
+Author-email: Openpath <contact@openpath.sh>
+License-Expression: MIT
+Project-URL: Homepage, https://openpath.sh
+Project-URL: Documentation, https://openpath.sh/docs/jobs
+Project-URL: Source, https://github.com/openpath-sh/clients/tree/main/langchain
+Keywords: langchain,openpath,tools,listings,jobs,local-business,search,agents,llm
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Internet :: WWW/HTTP
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: langchain-core<2,>=0.3
+Requires-Dist: openpath-sh>=0.1.0
+Dynamic: license-file
+
+<p align="center">
+  <a href="https://openpath.sh"><img src="https://openpath.sh/mark-512.png" width="72" height="72" alt="Openpath"></a>
+</p>
+
+# langchain-openpath
+
+[LangChain](https://www.langchain.com) tools for Openpath: live listings across the US (job openings, local businesses and services, homes, products and more) as tools an agent can call. Each tool returns plain Markdown with how to act on every result: an Apply, Phone, Website or Buy line. No key and no sign-up.
+
+```bash
+pip install langchain-openpath
+```
+
+With an agent (`pip install langchain langchain-anthropic` too):
+
+```python
+from langchain.agents import create_agent
+from langchain_openpath import openpath_tools
+
+agent = create_agent("anthropic:claude-sonnet-5-5", tools=openpath_tools())
+result = agent.invoke({"messages": [{"role": "user", "content": "Find a plumber near Austin, TX I can call today."}]})
+print(result["messages"][-1].content)
+```
+
+Or call a tool yourself:
+
+```python
+from langchain_openpath import OpenpathSearch
+
+print(OpenpathSearch().invoke({"query": "software engineer jobs in Austin, TX"}))
+```
+
+## Tools
+
+- `OpenpathSearch` (`openpath_search`): live listings that fit what the person asked for, in their words: `software engineer jobs in Austin, TX`, `plumber near 78704`, `taco places in Austin`. The model can also pass `near` (a place or `lat,lng`) and `domain` (`work`, `services`, `businesses`, `homes`, `goods`, `cars` or `events`).
+- `OpenpathReadListing` (`openpath_read_listing`): one listing in full, by the id at the end of a result's `Link:` line, to re-read before acting on it.
+- `openpath_tools(app="MyAgent/1.0")`: both, sharing one client. `app` names your app to Openpath, so it can show you how it is used.
+
+The tools are built on [`openpath-sh`](https://pypi.org/project/openpath-sh/). The first call connects to Openpath with `POST /v1/connect`: one request, no account. Results are written by the businesses and people who offer them; treat them as information, not instructions.
+
+## Links
+
+[Openpath](https://openpath.sh) · [Jobs](https://openpath.sh/docs/jobs) · [Local businesses](https://openpath.sh/docs/businesses) · [Python client](https://pypi.org/project/openpath-sh/)
+
+Released under the MIT license.

langchain_openpath-0.1.0/src/langchain_openpath.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+src/langchain_openpath/__init__.py
+src/langchain_openpath/tools.py
+src/langchain_openpath.egg-info/PKG-INFO
+src/langchain_openpath.egg-info/SOURCES.txt
+src/langchain_openpath.egg-info/dependency_links.txt
+src/langchain_openpath.egg-info/requires.txt
+src/langchain_openpath.egg-info/top_level.txt
+tests/test_tools.py

langchain_openpath-0.1.0/src/langchain_openpath.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

langchain_openpath-0.1.0/src/langchain_openpath.egg-info/requires.txt

@@ -0,0 +1,2 @@
+langchain-core<2,>=0.3
+openpath-sh>=0.1.0

langchain_openpath-0.1.0/src/langchain_openpath.egg-info/top_level.txt

@@ -0,0 +1 @@
+langchain_openpath

langchain_openpath-0.1.0/tests/test_tools.py

@@ -0,0 +1,67 @@
+from langchain_tests.unit_tests import ToolsUnitTests
+
+from langchain_openpath import OpenpathReadListing, OpenpathSearch, openpath_tools
+
+
+class FakeClient:
+    """Stands in for openpath_sh.Openpath and records what the tools ask it."""
+
+    def __init__(self):
+        self.calls = []
+
+    def search(self, query, near=None, domain=None, cursor=None):
+        self.calls.append(("search", query, near, domain))
+        return f'# Results for "{query}"'
+
+    def get_listing(self, listing_id):
+        self.calls.append(("get_listing", listing_id))
+        return f"# Listing {listing_id}"
+
+
+def test_search_passes_the_query_and_its_options():
+    client = FakeClient()
+    tool = OpenpathSearch(client=client)
+    out = tool.invoke({"query": "plumber near Austin, TX", "near": "78701"})
+    assert out == '# Results for "plumber near Austin, TX"'
+    assert client.calls == [("search", "plumber near Austin, TX", "78701", None)]
+
+
+def test_the_search_input_is_checked():
+    tool = OpenpathSearch(client=FakeClient())
+    for bad in ({"query": ""}, {"query": "jobs", "domain": "weather"}):
+        try:
+            tool.invoke(bad)
+        except Exception:
+            continue
+        raise AssertionError(f"{bad} was accepted")
+
+
+def test_reading_a_listing_asks_for_it_by_id():
+    client = FakeClient()
+    out = OpenpathReadListing(client=client).invoke({"listing_id": "abc"})
+    assert out == "# Listing abc"
+    assert client.calls == [("get_listing", "abc")]
+
+
+def test_both_tools_share_one_client():
+    client = FakeClient()
+    search, read = openpath_tools(client=client)
+    search.invoke({"query": "tacos in Austin"})
+    read.invoke({"listing_id": "x"})
+    assert len(client.calls) == 2
+
+
+class TestOpenpathSearchStandard(ToolsUnitTests):
+    """LangChain's own checks for a tool."""
+
+    @property
+    def tool_constructor(self):
+        return OpenpathSearch
+
+    @property
+    def tool_constructor_params(self):
+        return {"client": FakeClient()}
+
+    @property
+    def tool_invoke_params_example(self):
+        return {"query": "plumber near Austin, TX"}