ateve 0.2.1__tar.gz → 0.2.2__tar.gz

{ateve-0.2.1 → ateve-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ateve
-Version: 0.2.1
+Version: 0.2.2
 Summary: Official Python SDK for the Ateve Search API
 Project-URL: Homepage, https://ateve.ai
 Project-URL: Documentation, https://ateve.ai/docs
@@ -81,24 +81,32 @@ decisions remain caller-owned.
 
 ## Search contract limits
 
-Use `max_results` (1–100, default 10); `limit` and `offset` have been removed.
-`ContentOptions.snippet` is optional and defaults to `True`. To retrieve full
-text, pass `content=ContentOptions(text=TextOptions())`, or configure
+Use `max_results` to set the maximum number of results (1–100, default 10).
+`limit` and `offset` have been removed. Both synchronous and asynchronous
+clients accept `content` and `max_results`, or a `SearchRequest` instance.
+
+Snippets are always returned and cannot be disabled. To request full text, pass
+`content=ContentOptions(text=TextOptions())`. To customize the output, use
 `TextOptions(max_characters=8000, format=ContentFormat.MARKDOWN)`.
-`format` accepts `"text"` (default) or `"markdown"`. Omitting `text` does not
-request full text. `max_characters` remains a strict positive signed 32-bit
-integer; its server default is 5000 per result, applied after format conversion.
-Use `content=ContentOptions(highlights=True)` to receive query-relevant excerpts
-in `SearchResult.highlights` (`list[str]`, or `None` when absent). Highlights
-default to `False` and can coexist with snippets and full text. They focus on
-evidence that directly supports answers, reducing unrelated information compared
-with snippets. `summary` has been removed from `ContentOptions`; `favicon`
-remains optional. Both synchronous and asynchronous clients accept `content`
-and `max_results`, or a `SearchRequest` instance.
-
-Both formats return content in `SearchResult.text`. It defaults to `None` when
-absent or when extraction fails; `model_fields_set` distinguishes those cases.
-Snippets may coexist with text; set `ContentOptions(snippet=False)` to omit
-them. Obsolete answer, usage, news/video, query tuning and raw content/summary
-response fields and models have been removed. Unknown response
-fields continue to be retained by Pydantic for forward compatibility.
+`format` accepts `ContentFormat.TEXT` (default) or `ContentFormat.MARKDOWN`.
+Full text is requested only when `text` is supplied. `max_characters` must be a
+strict positive signed 32-bit integer. The server default is 5,000 characters
+per result, applied after format conversion. Both formats return content in
+`SearchResult.text`, which is `None` when absent or when extraction fails.
+`model_fields_set` distinguishes those cases. Full text is returned alongside
+snippets.
+
+Highlights are optional and disabled by default. Set
+`content=ContentOptions(highlights=True)` to return concise, query-relevant
+excerpts in addition to snippets. `SearchResult.highlights` is a `list[str]`, or
+`None` when the field is absent. Highlights can coexist with snippets and full text.
+
+For token-efficient workflows, your agent can prioritize highlights when building
+model context and supplement them with snippets when additional context is needed.
+When the API returns both fields, token savings depend on which content your
+agent passes to the model.
+
+`summary` and the snippet toggle have been removed from `ContentOptions`.
+`favicon` remains optional under `content`. Obsolete answer, usage, news/video,
+query tuning, and raw content/summary response fields and models have been removed.
+Unknown response fields continue to be retained by Pydantic for forward compatibility.

{ateve-0.2.1 → ateve-0.2.2}/README.md

@@ -55,24 +55,32 @@ decisions remain caller-owned.
 
 ## Search contract limits
 
-Use `max_results` (1–100, default 10); `limit` and `offset` have been removed.
-`ContentOptions.snippet` is optional and defaults to `True`. To retrieve full
-text, pass `content=ContentOptions(text=TextOptions())`, or configure
+Use `max_results` to set the maximum number of results (1–100, default 10).
+`limit` and `offset` have been removed. Both synchronous and asynchronous
+clients accept `content` and `max_results`, or a `SearchRequest` instance.
+
+Snippets are always returned and cannot be disabled. To request full text, pass
+`content=ContentOptions(text=TextOptions())`. To customize the output, use
 `TextOptions(max_characters=8000, format=ContentFormat.MARKDOWN)`.
-`format` accepts `"text"` (default) or `"markdown"`. Omitting `text` does not
-request full text. `max_characters` remains a strict positive signed 32-bit
-integer; its server default is 5000 per result, applied after format conversion.
-Use `content=ContentOptions(highlights=True)` to receive query-relevant excerpts
-in `SearchResult.highlights` (`list[str]`, or `None` when absent). Highlights
-default to `False` and can coexist with snippets and full text. They focus on
-evidence that directly supports answers, reducing unrelated information compared
-with snippets. `summary` has been removed from `ContentOptions`; `favicon`
-remains optional. Both synchronous and asynchronous clients accept `content`
-and `max_results`, or a `SearchRequest` instance.
-
-Both formats return content in `SearchResult.text`. It defaults to `None` when
-absent or when extraction fails; `model_fields_set` distinguishes those cases.
-Snippets may coexist with text; set `ContentOptions(snippet=False)` to omit
-them. Obsolete answer, usage, news/video, query tuning and raw content/summary
-response fields and models have been removed. Unknown response
-fields continue to be retained by Pydantic for forward compatibility.
+`format` accepts `ContentFormat.TEXT` (default) or `ContentFormat.MARKDOWN`.
+Full text is requested only when `text` is supplied. `max_characters` must be a
+strict positive signed 32-bit integer. The server default is 5,000 characters
+per result, applied after format conversion. Both formats return content in
+`SearchResult.text`, which is `None` when absent or when extraction fails.
+`model_fields_set` distinguishes those cases. Full text is returned alongside
+snippets.
+
+Highlights are optional and disabled by default. Set
+`content=ContentOptions(highlights=True)` to return concise, query-relevant
+excerpts in addition to snippets. `SearchResult.highlights` is a `list[str]`, or
+`None` when the field is absent. Highlights can coexist with snippets and full text.
+
+For token-efficient workflows, your agent can prioritize highlights when building
+model context and supplement them with snippets when additional context is needed.
+When the API returns both fields, token savings depend on which content your
+agent passes to the model.
+
+`summary` and the snippet toggle have been removed from `ContentOptions`.
+`favicon` remains optional under `content`. Obsolete answer, usage, news/video,
+query tuning, and raw content/summary response fields and models have been removed.
+Unknown response fields continue to be retained by Pydantic for forward compatibility.

{ateve-0.2.1 → ateve-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ateve"
-version = "0.2.1"
+version = "0.2.2"
 description = "Official Python SDK for the Ateve Search API"
 readme = "README.md"
 requires-python = ">=3.11"

ateve-0.2.2/src/ateve/_version.py

@@ -0,0 +1 @@
+__version__ = "0.2.2"

{ateve-0.2.1 → ateve-0.2.2}/src/ateve/models.py

@@ -87,7 +87,6 @@ class TextOptions(RequestModel):
 
 
 class ContentOptions(RequestModel):
-    snippet: Optional[bool] = Field(default=True)
     highlights: Optional[bool] = Field(default=False)
     text: Optional[TextOptions] = None
     favicon: Optional[bool] = None

{ateve-0.2.1 → ateve-0.2.2}/tests/test_client.py

@@ -57,7 +57,7 @@ def test_sync_golden_contract_and_wire_names() -> None:
         date_range="2026-01-01..2026-06-30",
         locale=LocaleSettings(mkt="US", language="en"),
         content=ContentOptions(
-            snippet=False, highlights=True,
+            highlights=True,
             text=TextOptions(format=ContentFormat.MARKDOWN, max_characters=5000)
         ),
         safe_search=False,
@@ -67,7 +67,7 @@ def test_sync_golden_contract_and_wire_names() -> None:
     assert payload["date_range"] == "2026-01-01..2026-06-30"
     assert payload["safe_search"] is False
     assert payload["max_results"] == 20
-    assert payload["content"]["snippet"] is False
+    assert "snippet" not in payload["content"]
     assert payload["content"]["highlights"] is True
     assert not {"limit", "offset", "contents"}.intersection(payload)
     assert payload["content"]["text"]["max_characters"] == 5000
@@ -345,7 +345,7 @@ def test_sync_and_async_send_new_defaults_and_nested_text_options() -> None:
             AsyncAteve("sk_test", http_client=transport) as client,
         ):
             response = await client.search(
-                "q", max_results=100, content=ContentOptions(snippet=False, highlights=True)
+                "q", max_results=100, content=ContentOptions(highlights=True)
             )
             assert response.results[0].highlights == GOLDEN_RESPONSE["results"][0]["highlights"]
             await client.search(
@@ -358,12 +358,12 @@ def test_sync_and_async_send_new_defaults_and_nested_text_options() -> None:
         {
             "query": "q",
             "max_results": 10,
-            "content": {"snippet": True, "highlights": False, "text": {"format": "text"}},
+            "content": {"highlights": False, "text": {"format": "text"}},
         },
-        {"query": "q", "max_results": 100, "content": {"snippet": False, "highlights": True}},
+        {"query": "q", "max_results": 100, "content": {"highlights": True}},
         {
             "query": "q",
             "max_results": 10,
-            "content": {"snippet": True, "highlights": False, "text": {"format": "text"}},
+            "content": {"highlights": False, "text": {"format": "text"}},
         },
     ]

{ateve-0.2.1 → ateve-0.2.2}/tests/test_models.py

@@ -25,6 +25,8 @@ def test_request_models_preserve_validation_and_frozen_configuration() -> None:
         request.query = "changed"
     with pytest.raises(ValidationError):
         TextOptions(max_characters=True)
+    with pytest.raises(ValidationError, match="snippet"):
+        ContentOptions.model_validate({"snippet": False})
 
 
 def test_response_models_preserve_defaults_nulls_extra_fields_and_dates() -> None:
@@ -54,7 +56,6 @@ def test_request_lists_are_snapshots_and_wire_names_stay_snake_case() -> None:
 
 def test_request_defaults_and_nested_text_activation() -> None:
     assert SearchRequest(query="q").max_results == 10
-    assert ContentOptions().snippet is True
     assert ContentOptions().highlights is False
     assert ContentOptions().text is None
     assert TextOptions().format == ContentFormat.TEXT
@@ -62,10 +63,7 @@ def test_request_defaults_and_nested_text_activation() -> None:
     assert request.model_dump(mode="json", exclude_none=True) == {
         "query": "q",
         "max_results": 10,
-        "content": {"snippet": True, "highlights": False, "text": {"format": "text"}},
-    }
-    assert ContentOptions(snippet=False).model_dump(exclude_none=True) == {
-        "snippet": False, "highlights": False
+        "content": {"highlights": False, "text": {"format": "text"}},
     }
     assert ContentOptions(highlights=True).highlights is True
 

ateve-0.2.1/src/ateve/_version.py

@@ -1 +0,0 @@
-__version__ = "0.2.1"