exa-py 1.14.4__tar.gz → 1.14.5__tar.gz

{exa_py-1.14.4 → exa_py-1.14.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: exa-py
-Version: 1.14.4
+Version: 1.14.5
 Summary: Python SDK for Exa API.
 Home-page: https://github.com/exa-labs/exa-py
 Author: Exa

{exa_py-1.14.4 → exa_py-1.14.5}/exa_py/api.py

@@ -166,6 +166,7 @@ CONTENTS_OPTIONS_TYPES = {
     "text": [dict, bool],
     "highlights": [dict, bool],
     "summary": [dict, bool],
+    "context": [dict, bool],
     "metadata": [dict, bool],
     "livecrawl_timeout": [int],
     "livecrawl": [LIVECRAWL_OPTIONS],
@@ -292,6 +293,16 @@ class SummaryContentsOptions(TypedDict, total=False):
     schema: JSONSchema
 
 
+class ContextContentsOptions(TypedDict, total=False):
+    """Options for retrieving aggregated context from a set of search results.
+
+    Attributes:
+        max_characters (int): The maximum number of characters to include in the context string.
+    """
+
+    max_characters: int
+
+
 class ExtrasOptions(TypedDict, total=False):
     """A class representing additional extraction fields (e.g. links, images)"""
 
@@ -807,17 +818,23 @@ class SearchResponse(Generic[T]):
         autoprompt_string (str, optional): The Exa query created by autoprompt.
         resolved_search_type (str, optional): 'neural' or 'keyword' if auto.
         auto_date (str, optional): A date for filtering if autoprompt found one.
+        context (str, optional): Combined context string when requested via contents.context.
+        statuses (List[ContentStatus], optional): Status list from get_contents.
+        cost_dollars (CostDollars, optional): Cost breakdown.
     """
 
     results: List[T]
     autoprompt_string: Optional[str]
     resolved_search_type: Optional[str]
     auto_date: Optional[str]
+    context: Optional[str] = None
     statuses: Optional[List[ContentStatus]] = None
     cost_dollars: Optional[CostDollars] = None
 
     def __str__(self):
         output = "\n\n".join(str(result) for result in self.results)
+        if self.context:
+            output += f"\nContext: {self.context}"
         if self.autoprompt_string:
             output += f"\n\nAutoprompt String: {self.autoprompt_string}"
         if self.resolved_search_type:
@@ -1254,6 +1271,7 @@ class Exa:
                 "text",
                 "highlights",
                 "summary",
+                "context",
                 "subpages",
                 "subpage_target",
                 "livecrawl",
@@ -1270,6 +1288,7 @@ class Exa:
             data["autopromptString"] if "autopromptString" in data else None,
             data["resolvedSearchType"] if "resolvedSearchType" in data else None,
             data["autoDate"] if "autoDate" in data else None,
+            context=data.get("context"),
             cost_dollars=cost_dollars,
         )
 
@@ -1414,7 +1433,6 @@ class Exa:
             options,
             {**CONTENTS_OPTIONS_TYPES, **CONTENTS_ENDPOINT_OPTIONS_TYPES},
         )
-        
         options = to_camel_case(options)
         data = self.request("/contents", options)
         cost_dollars = parse_cost_dollars(data.get("costDollars"))
@@ -1424,6 +1442,7 @@ class Exa:
             data.get("autopromptString"),
             data.get("resolvedSearchType"),
             data.get("autoDate"),
+            context=data.get("context"),
             cost_dollars=cost_dollars,
             statuses=statuses,
         )
@@ -1715,6 +1734,7 @@ class Exa:
                 "text",
                 "highlights",
                 "summary",
+                "context",
                 "subpages",
                 "subpage_target",
                 "livecrawl",
@@ -1731,6 +1751,7 @@ class Exa:
             data.get("autopromptString"),
             data.get("resolvedSearchType"),
             data.get("autoDate"),
+            context=data.get("context"),
             cost_dollars=cost_dollars,
         )
 
@@ -2067,6 +2088,7 @@ class AsyncExa(Exa):
                 "text",
                 "highlights",
                 "summary",
+                "context",
                 "subpages",
                 "subpage_target",
                 "livecrawl",
@@ -2083,6 +2105,7 @@ class AsyncExa(Exa):
             data["autopromptString"] if "autopromptString" in data else None,
             data["resolvedSearchType"] if "resolvedSearchType" in data else None,
             data["autoDate"] if "autoDate" in data else None,
+            context=data.get("context"),
             cost_dollars=cost_dollars,
         )
 
@@ -2113,6 +2136,7 @@ class AsyncExa(Exa):
             data.get("autopromptString"),
             data.get("resolvedSearchType"),
             data.get("autoDate"),
+            context=data.get("context"),
             cost_dollars=cost_dollars,
             statuses=statuses,
         )
@@ -2192,6 +2216,7 @@ class AsyncExa(Exa):
                 "text",
                 "highlights",
                 "summary",
+                "context",
                 "subpages",
                 "subpage_target",
                 "livecrawl",
@@ -2208,6 +2233,7 @@ class AsyncExa(Exa):
             data.get("autopromptString"),
             data.get("resolvedSearchType"),
             data.get("autoDate"),
+            context=data.get("context"),
             cost_dollars=cost_dollars,
         )
 

{exa_py-1.14.4 → exa_py-1.14.5}/exa_py.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: exa-py
-Version: 1.14.4
+Version: 1.14.5
 Summary: Python SDK for Exa API.
 Home-page: https://github.com/exa-labs/exa-py
 Author: Exa

{exa_py-1.14.4 → exa_py-1.14.5}/pyproject.toml

@@ -1,10 +1,3 @@
-[tool.poetry]
-name = "exa-py"
-version = "1.14.2"
-description = "Python SDK for Exa API."
-authors = ["Exa AI <hello@exa.ai>"]
-readme = "README.md"
-
 [tool.poetry.dependencies]
 python = "^3.9"
 requests = "^2.32.3"
@@ -32,7 +25,7 @@ in-project = true
 
 [project]
 name = "exa-py"
-version = "1.14.4"
+version = "1.14.5"
 description = "Python SDK for Exa API."
 readme = "README.md"
 requires-python = ">=3.9"

{exa_py-1.14.4 → exa_py-1.14.5}/tests/test_search_api.py

@@ -63,7 +63,7 @@ def test_research_client_attrs():
 def test_get_contents_live_preferred():
     exa = Exa(API_KEY)
     resp = exa.get_contents(urls=["https://techcrunch.com"], text=True, livecrawl="preferred")
-    assert isinstance(resp, exa_api.ContentResponse)
+    assert isinstance(resp, exa_api.SearchResponse)
     # statuses may be empty when cached – still fine
     assert len(resp.results) >= 1
 
@@ -104,4 +104,33 @@ def test_research_task_live():
     exa = Exa(API_KEY)
     schema = {"type": "object", "properties": {"answer": {"type": "string"}}, "required": ["answer"]}
     resp = exa.researchTask(input_instructions="Return the string 'pong'", output_schema=schema)
-    assert resp.id 
+    assert resp.id
+
+########################################
+# Live tests for new context / statuses features
+########################################
+
+@pytest.mark.skipif(not _have_real_key(), reason="EXA_API_KEY not provided")
+def test_search_and_contents_context_live():
+    """search_and_contents with context=True should return non-empty context string."""
+    exa = Exa(API_KEY)
+    resp = exa.search_and_contents("openai research", num_results=3, context=True, text=False)
+    assert resp.context is not None and isinstance(resp.context, str) and len(resp.context) > 0
+
+
+@pytest.mark.skipif(not _have_real_key(), reason="EXA_API_KEY not provided")
+def test_find_similar_and_contents_context_live():
+    """find_similar_and_contents with context flag should include context string."""
+    exa = Exa(API_KEY)
+    resp = exa.find_similar_and_contents("https://www.openai.com", num_results=3, context=True, text=False)
+    # context may be empty depending on backend, but attribute should exist (None or str)
+    assert hasattr(resp, "context")
+
+
+@pytest.mark.skipif(not _have_real_key(), reason="EXA_API_KEY not provided")
+def test_get_contents_statuses_live():
+    """get_contents should expose statuses list (possibly empty)."""
+    exa = Exa(API_KEY)
+    resp = exa.get_contents(urls=["https://techcrunch.com"], text=True, livecrawl="never")
+    # statuses attribute exists; ensure it's a list
+    assert isinstance(resp.statuses, list)