dspy-contextfetch 0.1.0__py3-none-any.whl

dspy_contextfetch/__init__.py

@@ -0,0 +1,46 @@
+"""ContextFetch web search and page reading as DSPy tools.
+
+Plain functions, so they work anywhere DSPy takes a tool: `dspy.ReAct(sig, tools=[web_search, read_page])`
+or `dspy.Tool(web_search)`. The API key comes from the CONTEXTFETCH_API_KEY environment variable; without
+one, requests use the keyless tier.
+"""
+
+from __future__ import annotations
+
+from contextfetch import ContextFetch
+
+__all__ = ["read_page", "web_search"]
+
+
+def web_search(
+    query: str,
+    num_results: int = 5,
+    include_domains: list[str] | None = None,
+    start_published_date: str | None = None,
+) -> str:
+    """Search the web. Returns the top results as Markdown: title, URL, published date and the parts of
+    each page relevant to the query. num_results is 1 to 25; include_domains limits results to those
+    domains; start_published_date (YYYY-MM-DD) keeps only pages published on or after that date."""
+    response = ContextFetch().search(
+        query,
+        num_results=num_results,
+        include_domains=include_domains,
+        start_published_date=start_published_date,
+        pruned_context=True,
+    )
+    results = response.get("results") or []
+    if not results:
+        return "No results found."
+    return "\n\n---\n\n".join(
+        f"Title: {r.get('title') or ''}\n"
+        f"URL: {r.get('url', '')}\n"
+        f"Published: {r.get('publishedDate') or 'unknown'}\n\n"
+        f"{r.get('prunedContext') or ''}"
+        for r in results
+    )
+
+
+def read_page(url: str, query: str | None = None) -> str:
+    """Read a web page and return its content as Markdown. With query, return only the parts of the page
+    relevant to that question."""
+    return ContextFetch().read(url, query=query).markdown

dspy_contextfetch-0.1.0.dist-info/METADATA

@@ -0,0 +1,49 @@
+Metadata-Version: 2.5
+Name: dspy-contextfetch
+Version: 0.1.0
+Summary: ContextFetch web search and page reading as DSPy tools
+Project-URL: Homepage, https://contextfetch.dev
+Project-URL: Source, https://github.com/lachy3433/dspy-contextfetch
+Author: ContextFetch
+License-Expression: MIT
+License-File: LICENSE
+Keywords: agents,contextfetch,dspy,tools,web search
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Requires-Dist: contextfetch<1.0.0,>=0.1.0
+Description-Content-Type: text/markdown
+
+# dspy-contextfetch
+
+[ContextFetch](https://contextfetch.dev) web search and page reading as [DSPy](https://dspy.ai) tools.
+
+```bash
+pip install dspy-contextfetch
+export CONTEXTFETCH_API_KEY="..."   # optional: without a key, requests use the keyless tier
+```
+
+```python
+import dspy
+from dspy_contextfetch import read_page, web_search
+
+dspy.configure(lm=dspy.LM("openai/gpt-4o-mini"))
+agent = dspy.ReAct("question -> answer", tools=[web_search, read_page])
+print(agent(question="What does asyncio.TaskGroup do when a task fails?").answer)
+```
+
+- `web_search(query, num_results=5, include_domains=None, start_published_date=None)`: the top results as
+  Markdown, each with title, URL, published date and the parts of the page relevant to the query.
+- `read_page(url, query=None)`: one page as Markdown; with `query`, only the parts relevant to it.
+
+Both are plain functions over the [`contextfetch`](https://pypi.org/project/contextfetch/) SDK, so they also
+work with `dspy.Tool(...)` or called directly. Errors from the API raise `contextfetch.ContextFetchError`.
+
+## Tests
+
+```bash
+uv run --group test pytest
+```
+
+The live test runs when `~/.contextfetch_smoke_key` exists.

dspy_contextfetch-0.1.0.dist-info/RECORD

@@ -0,0 +1,5 @@
+dspy_contextfetch/__init__.py,sha256=UyeMJWTXsIGO3oioB0r-0iibCDd4M-xKUgJai-VJPP4,1710
+dspy_contextfetch-0.1.0.dist-info/METADATA,sha256=HOW5C53Yfdt7EWUmtVhVI9GpUZT9dLZKBLNvngJo93c,1805
+dspy_contextfetch-0.1.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+dspy_contextfetch-0.1.0.dist-info/licenses/LICENSE,sha256=RqQqv3BiTnGfaC6tdJ9oSSRKa0fzw4e7wxJwAR9Bab4,1073
+dspy_contextfetch-0.1.0.dist-info/RECORD,,

dspy_contextfetch-0.1.0.dist-info/WHEEL

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

dspy_contextfetch-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2026 ContextFetch
+
+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.