unique-search-proxy-sdk 2026.44.0.dev3__tar.gz → 2026.44.0.dev5__tar.gz

{unique_search_proxy_sdk-2026.44.0.dev3 → unique_search_proxy_sdk-2026.44.0.dev5}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.3
 Name: unique-search-proxy-sdk
-Version: 2026.44.0.dev3
+Version: 2026.44.0.dev5
 Summary: Async HTTP client for the Unique Search Proxy API
 Author: ThePhilAz
 Author-email: ThePhilAz <rami.azouz@philico.com>
 Requires-Dist: attrs>=24.3.0,<26
 Requires-Dist: httpx>=0.28.0,<0.29.0
 Requires-Dist: pydantic>=2.12.5,<3.0.0
-Requires-Dist: unique-search-proxy-core>=2026.44.0.dev5,<2026.44.0rc0
+Requires-Dist: unique-search-proxy-core>=2026.44.0.dev10,<2026.44.0rc0
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 

{unique_search_proxy_sdk-2026.44.0.dev3 → unique_search_proxy_sdk-2026.44.0.dev5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "unique-search-proxy-sdk"
-version = "2026.44.0.dev3"
+version = "2026.44.0.dev5"
 description = "Async HTTP client for the Unique Search Proxy API"
 authors = [{ name = "ThePhilAz", email = "rami.azouz@philico.com" }]
 readme = "README.md"
@@ -9,7 +9,7 @@ dependencies = [
     "attrs>=24.3.0,<26",
     "httpx>=0.28.0,<0.29.0",
     "pydantic>=2.12.5,<3.0.0",
-    "unique-search-proxy-core>=2026.44.0.dev5,<2026.44.0rc0",
+    "unique-search-proxy-core>=2026.44.0.dev10,<2026.44.0rc0",
 ]
 
 [dependency-groups]

{unique_search_proxy_sdk-2026.44.0.dev3 → unique_search_proxy_sdk-2026.44.0.dev5}/unique_search_proxy_sdk/_generated/models/__init__.py

@@ -1,6 +1,7 @@
 """Contains all the data models used in inputs/outputs"""
 
 from .agent_search_response import AgentSearchResponse
+from .answer_span_citation import AnswerSpanCitation
 from .basic_crawl_request import BasicCrawlRequest
 from .bing_agent_search_request import BingAgentSearchRequest
 from .bing_agent_search_request_freshness_type_0 import (
@@ -60,6 +61,7 @@ from .web_search_result import WebSearchResult
 
 __all__ = (
     "AgentSearchResponse",
+    "AnswerSpanCitation",
     "BasicCrawlRequest",
     "BingAgentSearchRequest",
     "BingAgentSearchRequestFreshnessType0",

{unique_search_proxy_sdk-2026.44.0.dev3 → unique_search_proxy_sdk-2026.44.0.dev5}/unique_search_proxy_sdk/_generated/models/agent_search_response.py

@@ -1,13 +1,17 @@
 from __future__ import annotations
 
 from collections.abc import Mapping
-from typing import Any, TypeVar
+from typing import TYPE_CHECKING, Any, TypeVar
 
 from attrs import define as _attrs_define
 from attrs import field as _attrs_field
 
 from ..types import UNSET, Unset
 
+if TYPE_CHECKING:
+    from ..models.answer_span_citation import AnswerSpanCitation
+
+
 T = TypeVar("T", bound="AgentSearchResponse")
 
 
@@ -15,19 +19,23 @@ T = TypeVar("T", bound="AgentSearchResponse")
 class AgentSearchResponse:
     """Result of an agent-based (grounded) search.
 
-    Thin egress contract: opaque ``answer`` text from the provider plus ``raw``
-    for debugging. Consumers interpret ``answer`` (JSON parsing, citations, etc.).
+    Thin egress contract: opaque ``answer`` text from the provider, the
+    citations the provider attached to it, and ``raw`` for debugging. Consumers
+    interpret ``answer`` (JSON parsing, mapping citations, etc.).
 
         Attributes:
             engine (str):
             query (str):
             answer (str | Unset): Agent response text as returned by the provider (opaque to the proxy) Default: ''.
+            citations (list[AnswerSpanCitation] | Unset): Sources cited in the answer. Only Grounding with Bing Search
+                reports citations; other engines return an empty list.
             raw (Any | Unset): Opaque provider payload
     """
 
     engine: str
     query: str
     answer: str | Unset = ""
+    citations: list[AnswerSpanCitation] | Unset = UNSET
     raw: Any | Unset = UNSET
     additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
 
@@ -38,6 +46,13 @@ class AgentSearchResponse:
 
         answer = self.answer
 
+        citations: list[dict[str, Any]] | Unset = UNSET
+        if not isinstance(self.citations, Unset):
+            citations = []
+            for citations_item_data in self.citations:
+                citations_item = citations_item_data.to_dict()
+                citations.append(citations_item)
+
         raw = self.raw
 
         field_dict: dict[str, Any] = {}
@@ -50,6 +65,8 @@ class AgentSearchResponse:
         )
         if answer is not UNSET:
             field_dict["answer"] = answer
+        if citations is not UNSET:
+            field_dict["citations"] = citations
         if raw is not UNSET:
             field_dict["raw"] = raw
 
@@ -57,6 +74,8 @@ class AgentSearchResponse:
 
     @classmethod
     def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        from ..models.answer_span_citation import AnswerSpanCitation
+
         d = dict(src_dict)
         engine = d.pop("engine")
 
@@ -64,12 +83,22 @@ class AgentSearchResponse:
 
         answer = d.pop("answer", UNSET)
 
+        _citations = d.pop("citations", UNSET)
+        citations: list[AnswerSpanCitation] | Unset = UNSET
+        if _citations is not UNSET:
+            citations = []
+            for citations_item_data in _citations:
+                citations_item = AnswerSpanCitation.from_dict(citations_item_data)
+
+                citations.append(citations_item)
+
         raw = d.pop("raw", UNSET)
 
         agent_search_response = cls(
             engine=engine,
             query=query,
             answer=answer,
+            citations=citations,
             raw=raw,
         )
 

unique_search_proxy_sdk-2026.44.0.dev5/unique_search_proxy_sdk/_generated/models/answer_span_citation.py

@@ -0,0 +1,132 @@
+from __future__ import annotations
+
+from collections.abc import Mapping
+from typing import Any, TypeVar, cast
+
+from attrs import define as _attrs_define
+from attrs import field as _attrs_field
+
+from ..types import UNSET, Unset
+
+T = TypeVar("T", bound="AnswerSpanCitation")
+
+
+@_attrs_define
+class AnswerSpanCitation:
+    """A source cited at a specific span of the answer text.
+
+    Grounding with Bing Search reports these as ``url_citation`` annotations:
+    the agent writes a marker such as ``【4:0†source】`` into its answer, and
+    Foundry attaches the source to that marker's character span.
+
+        Attributes:
+            url (str): URL of the cited source
+            marker (str): Answer text between start_index and end_index
+            start_index (int): Character offset in the answer where the marker starts
+            end_index (int): Character offset in the answer just past the marker
+            title (None | str | Unset): Title of the cited source
+            output_item_id (None | str | Unset): Output item the citation is attached to, if the provider reports one
+    """
+
+    url: str
+    marker: str
+    start_index: int
+    end_index: int
+    title: None | str | Unset = UNSET
+    output_item_id: None | str | Unset = UNSET
+    additional_properties: dict[str, Any] = _attrs_field(init=False, factory=dict)
+
+    def to_dict(self) -> dict[str, Any]:
+        url = self.url
+
+        marker = self.marker
+
+        start_index = self.start_index
+
+        end_index = self.end_index
+
+        title: None | str | Unset
+        if isinstance(self.title, Unset):
+            title = UNSET
+        else:
+            title = self.title
+
+        output_item_id: None | str | Unset
+        if isinstance(self.output_item_id, Unset):
+            output_item_id = UNSET
+        else:
+            output_item_id = self.output_item_id
+
+        field_dict: dict[str, Any] = {}
+        field_dict.update(self.additional_properties)
+        field_dict.update(
+            {
+                "url": url,
+                "marker": marker,
+                "startIndex": start_index,
+                "endIndex": end_index,
+            }
+        )
+        if title is not UNSET:
+            field_dict["title"] = title
+        if output_item_id is not UNSET:
+            field_dict["outputItemId"] = output_item_id
+
+        return field_dict
+
+    @classmethod
+    def from_dict(cls: type[T], src_dict: Mapping[str, Any]) -> T:
+        d = dict(src_dict)
+        url = d.pop("url")
+
+        marker = d.pop("marker")
+
+        start_index = d.pop("startIndex")
+
+        end_index = d.pop("endIndex")
+
+        def _parse_title(data: object) -> None | str | Unset:
+            if data is None:
+                return data
+            if isinstance(data, Unset):
+                return data
+            return cast(None | str | Unset, data)
+
+        title = _parse_title(d.pop("title", UNSET))
+
+        def _parse_output_item_id(data: object) -> None | str | Unset:
+            if data is None:
+                return data
+            if isinstance(data, Unset):
+                return data
+            return cast(None | str | Unset, data)
+
+        output_item_id = _parse_output_item_id(d.pop("outputItemId", UNSET))
+
+        answer_span_citation = cls(
+            url=url,
+            marker=marker,
+            start_index=start_index,
+            end_index=end_index,
+            title=title,
+            output_item_id=output_item_id,
+        )
+
+        answer_span_citation.additional_properties = d
+        return answer_span_citation
+
+    @property
+    def additional_keys(self) -> list[str]:
+        return list(self.additional_properties.keys())
+
+    def __getitem__(self, key: str) -> Any:
+        return self.additional_properties[key]
+
+    def __setitem__(self, key: str, value: Any) -> None:
+        self.additional_properties[key] = value
+
+    def __delitem__(self, key: str) -> None:
+        del self.additional_properties[key]
+
+    def __contains__(self, key: str) -> bool:
+        return key in self.additional_properties

{unique_search_proxy_sdk-2026.44.0.dev3 → unique_search_proxy_sdk-2026.44.0.dev5}/unique_search_proxy_sdk/errors.py

@@ -12,6 +12,7 @@ from unique_search_proxy_core.errors import (
     ForbiddenTargetError,
     ProxyError,
     RateLimitedError,
+    ResponseTooLargeError,
     UpstreamError,
     UpstreamTimeoutError,
     ValidationProxyError,
@@ -28,6 +29,7 @@ _CODE_TO_EXCEPTION: dict[str, type[ProxyError]] = {
     ProxyErrorCode.ENGINE_NOT_CONFIGURED.value: EngineNotConfiguredError,
     ProxyErrorCode.UPSTREAM_TIMEOUT.value: UpstreamTimeoutError,
     ProxyErrorCode.EMPTY_SEARCH_RESULTS.value: EmptySearchResultsError,
+    ProxyErrorCode.RESPONSE_TOO_LARGE.value: ResponseTooLargeError,
 }