unique-search-proxy-sdk 2026.44.0.dev4__tar.gz → 2026.44.0.dev6__tar.gz

{unique_search_proxy_sdk-2026.44.0.dev4 → unique_search_proxy_sdk-2026.44.0.dev6}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.3
 Name: unique-search-proxy-sdk
-Version: 2026.44.0.dev4
+Version: 2026.44.0.dev6
 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.dev7,<2026.44.0rc0
+Requires-Dist: unique-search-proxy-core>=2026.44.0.dev11,<2026.44.0rc0
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 

{unique_search_proxy_sdk-2026.44.0.dev4 → unique_search_proxy_sdk-2026.44.0.dev6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "unique-search-proxy-sdk"
-version = "2026.44.0.dev4"
+version = "2026.44.0.dev6"
 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.dev7,<2026.44.0rc0",
+    "unique-search-proxy-core>=2026.44.0.dev11,<2026.44.0rc0",
 ]
 
 [dependency-groups]

{unique_search_proxy_sdk-2026.44.0.dev4 → unique_search_proxy_sdk-2026.44.0.dev6}/unique_search_proxy_sdk/_generated/api/agent_search/agent_search_stream_v1_agent_search_stream_post.py

@@ -8,7 +8,7 @@ from ...client import AuthenticatedClient, Client
 from ...models.bing_agent_search_request import BingAgentSearchRequest
 from ...models.http_validation_error import HTTPValidationError
 from ...models.vertex_ai_agent_search_request import VertexAiAgentSearchRequest
-from ...types import Response, Unset
+from ...types import UNSET, Response, Unset
 
 
 def _get_kwargs(
@@ -17,6 +17,8 @@ def _get_kwargs(
     x_unique_company_id: str | Unset = "local",
     x_unique_user_id: str | Unset = "local",
     x_unique_chat_id: str | Unset = "local",
+    x_unique_entry_point: str | Unset = "unknown",
+    x_unique_message_id: None | str | Unset = UNSET,
 ) -> dict[str, Any]:
     headers: dict[str, Any] = {}
     if not isinstance(x_unique_company_id, Unset):
@@ -28,6 +30,12 @@ def _get_kwargs(
     if not isinstance(x_unique_chat_id, Unset):
         headers["x-unique-chat-id"] = x_unique_chat_id
 
+    if not isinstance(x_unique_entry_point, Unset):
+        headers["x-unique-entry-point"] = x_unique_entry_point
+
+    if not isinstance(x_unique_message_id, Unset):
+        headers["x-unique-message-id"] = x_unique_message_id
+
     _kwargs: dict[str, Any] = {
         "method": "post",
         "url": "/v1/agent-search/stream",
@@ -80,6 +88,8 @@ def sync_detailed(
     x_unique_company_id: str | Unset = "local",
     x_unique_user_id: str | Unset = "local",
     x_unique_chat_id: str | Unset = "local",
+    x_unique_entry_point: str | Unset = "unknown",
+    x_unique_message_id: None | str | Unset = UNSET,
 ) -> Response[Any | HTTPValidationError]:
     """Stream an agent-based grounded search (SSE)
 
@@ -87,6 +97,9 @@ def sync_detailed(
         x_unique_company_id (str | Unset): Tenant company identifier. Default: 'local'.
         x_unique_user_id (str | Unset): Tenant user identifier. Default: 'local'.
         x_unique_chat_id (str | Unset): Tenant chat or session identifier. Default: 'local'.
+        x_unique_entry_point (str | Unset): Service where the search entered the platform.
+            Default: 'unknown'.
+        x_unique_message_id (None | str | Unset): Message identifier, reserved for analytics.
         body (BingAgentSearchRequest | VertexAiAgentSearchRequest):
 
     Raises:
@@ -102,6 +115,8 @@ def sync_detailed(
         x_unique_company_id=x_unique_company_id,
         x_unique_user_id=x_unique_user_id,
         x_unique_chat_id=x_unique_chat_id,
+        x_unique_entry_point=x_unique_entry_point,
+        x_unique_message_id=x_unique_message_id,
     )
 
     response = client.get_httpx_client().request(
@@ -118,6 +133,8 @@ def sync(
     x_unique_company_id: str | Unset = "local",
     x_unique_user_id: str | Unset = "local",
     x_unique_chat_id: str | Unset = "local",
+    x_unique_entry_point: str | Unset = "unknown",
+    x_unique_message_id: None | str | Unset = UNSET,
 ) -> Any | HTTPValidationError | None:
     """Stream an agent-based grounded search (SSE)
 
@@ -125,6 +142,9 @@ def sync(
         x_unique_company_id (str | Unset): Tenant company identifier. Default: 'local'.
         x_unique_user_id (str | Unset): Tenant user identifier. Default: 'local'.
         x_unique_chat_id (str | Unset): Tenant chat or session identifier. Default: 'local'.
+        x_unique_entry_point (str | Unset): Service where the search entered the platform.
+            Default: 'unknown'.
+        x_unique_message_id (None | str | Unset): Message identifier, reserved for analytics.
         body (BingAgentSearchRequest | VertexAiAgentSearchRequest):
 
     Raises:
@@ -141,6 +161,8 @@ def sync(
         x_unique_company_id=x_unique_company_id,
         x_unique_user_id=x_unique_user_id,
         x_unique_chat_id=x_unique_chat_id,
+        x_unique_entry_point=x_unique_entry_point,
+        x_unique_message_id=x_unique_message_id,
     ).parsed
 
 
@@ -151,6 +173,8 @@ async def asyncio_detailed(
     x_unique_company_id: str | Unset = "local",
     x_unique_user_id: str | Unset = "local",
     x_unique_chat_id: str | Unset = "local",
+    x_unique_entry_point: str | Unset = "unknown",
+    x_unique_message_id: None | str | Unset = UNSET,
 ) -> Response[Any | HTTPValidationError]:
     """Stream an agent-based grounded search (SSE)
 
@@ -158,6 +182,9 @@ async def asyncio_detailed(
         x_unique_company_id (str | Unset): Tenant company identifier. Default: 'local'.
         x_unique_user_id (str | Unset): Tenant user identifier. Default: 'local'.
         x_unique_chat_id (str | Unset): Tenant chat or session identifier. Default: 'local'.
+        x_unique_entry_point (str | Unset): Service where the search entered the platform.
+            Default: 'unknown'.
+        x_unique_message_id (None | str | Unset): Message identifier, reserved for analytics.
         body (BingAgentSearchRequest | VertexAiAgentSearchRequest):
 
     Raises:
@@ -173,6 +200,8 @@ async def asyncio_detailed(
         x_unique_company_id=x_unique_company_id,
         x_unique_user_id=x_unique_user_id,
         x_unique_chat_id=x_unique_chat_id,
+        x_unique_entry_point=x_unique_entry_point,
+        x_unique_message_id=x_unique_message_id,
     )
 
     response = await client.get_async_httpx_client().request(**kwargs)
@@ -187,6 +216,8 @@ async def asyncio(
     x_unique_company_id: str | Unset = "local",
     x_unique_user_id: str | Unset = "local",
     x_unique_chat_id: str | Unset = "local",
+    x_unique_entry_point: str | Unset = "unknown",
+    x_unique_message_id: None | str | Unset = UNSET,
 ) -> Any | HTTPValidationError | None:
     """Stream an agent-based grounded search (SSE)
 
@@ -194,6 +225,9 @@ async def asyncio(
         x_unique_company_id (str | Unset): Tenant company identifier. Default: 'local'.
         x_unique_user_id (str | Unset): Tenant user identifier. Default: 'local'.
         x_unique_chat_id (str | Unset): Tenant chat or session identifier. Default: 'local'.
+        x_unique_entry_point (str | Unset): Service where the search entered the platform.
+            Default: 'unknown'.
+        x_unique_message_id (None | str | Unset): Message identifier, reserved for analytics.
         body (BingAgentSearchRequest | VertexAiAgentSearchRequest):
 
     Raises:
@@ -211,5 +245,7 @@ async def asyncio(
             x_unique_company_id=x_unique_company_id,
             x_unique_user_id=x_unique_user_id,
             x_unique_chat_id=x_unique_chat_id,
+            x_unique_entry_point=x_unique_entry_point,
+            x_unique_message_id=x_unique_message_id,
         )
     ).parsed

{unique_search_proxy_sdk-2026.44.0.dev4 → unique_search_proxy_sdk-2026.44.0.dev6}/unique_search_proxy_sdk/_generated/api/agent_search/agent_search_v1_agent_search_post.py

@@ -9,7 +9,7 @@ from ...models.agent_search_response import AgentSearchResponse
 from ...models.bing_agent_search_request import BingAgentSearchRequest
 from ...models.http_validation_error import HTTPValidationError
 from ...models.vertex_ai_agent_search_request import VertexAiAgentSearchRequest
-from ...types import Response, Unset
+from ...types import UNSET, Response, Unset
 
 
 def _get_kwargs(
@@ -18,6 +18,8 @@ def _get_kwargs(
     x_unique_company_id: str | Unset = "local",
     x_unique_user_id: str | Unset = "local",
     x_unique_chat_id: str | Unset = "local",
+    x_unique_entry_point: str | Unset = "unknown",
+    x_unique_message_id: None | str | Unset = UNSET,
 ) -> dict[str, Any]:
     headers: dict[str, Any] = {}
     if not isinstance(x_unique_company_id, Unset):
@@ -29,6 +31,12 @@ def _get_kwargs(
     if not isinstance(x_unique_chat_id, Unset):
         headers["x-unique-chat-id"] = x_unique_chat_id
 
+    if not isinstance(x_unique_entry_point, Unset):
+        headers["x-unique-entry-point"] = x_unique_entry_point
+
+    if not isinstance(x_unique_message_id, Unset):
+        headers["x-unique-message-id"] = x_unique_message_id
+
     _kwargs: dict[str, Any] = {
         "method": "post",
         "url": "/v1/agent-search",
@@ -82,6 +90,8 @@ def sync_detailed(
     x_unique_company_id: str | Unset = "local",
     x_unique_user_id: str | Unset = "local",
     x_unique_chat_id: str | Unset = "local",
+    x_unique_entry_point: str | Unset = "unknown",
+    x_unique_message_id: None | str | Unset = UNSET,
 ) -> Response[AgentSearchResponse | HTTPValidationError]:
     """Run an agent-based grounded search
 
@@ -89,6 +99,9 @@ def sync_detailed(
         x_unique_company_id (str | Unset): Tenant company identifier. Default: 'local'.
         x_unique_user_id (str | Unset): Tenant user identifier. Default: 'local'.
         x_unique_chat_id (str | Unset): Tenant chat or session identifier. Default: 'local'.
+        x_unique_entry_point (str | Unset): Service where the search entered the platform.
+            Default: 'unknown'.
+        x_unique_message_id (None | str | Unset): Message identifier, reserved for analytics.
         body (BingAgentSearchRequest | VertexAiAgentSearchRequest):
 
     Raises:
@@ -104,6 +117,8 @@ def sync_detailed(
         x_unique_company_id=x_unique_company_id,
         x_unique_user_id=x_unique_user_id,
         x_unique_chat_id=x_unique_chat_id,
+        x_unique_entry_point=x_unique_entry_point,
+        x_unique_message_id=x_unique_message_id,
     )
 
     response = client.get_httpx_client().request(
@@ -120,6 +135,8 @@ def sync(
     x_unique_company_id: str | Unset = "local",
     x_unique_user_id: str | Unset = "local",
     x_unique_chat_id: str | Unset = "local",
+    x_unique_entry_point: str | Unset = "unknown",
+    x_unique_message_id: None | str | Unset = UNSET,
 ) -> AgentSearchResponse | HTTPValidationError | None:
     """Run an agent-based grounded search
 
@@ -127,6 +144,9 @@ def sync(
         x_unique_company_id (str | Unset): Tenant company identifier. Default: 'local'.
         x_unique_user_id (str | Unset): Tenant user identifier. Default: 'local'.
         x_unique_chat_id (str | Unset): Tenant chat or session identifier. Default: 'local'.
+        x_unique_entry_point (str | Unset): Service where the search entered the platform.
+            Default: 'unknown'.
+        x_unique_message_id (None | str | Unset): Message identifier, reserved for analytics.
         body (BingAgentSearchRequest | VertexAiAgentSearchRequest):
 
     Raises:
@@ -143,6 +163,8 @@ def sync(
         x_unique_company_id=x_unique_company_id,
         x_unique_user_id=x_unique_user_id,
         x_unique_chat_id=x_unique_chat_id,
+        x_unique_entry_point=x_unique_entry_point,
+        x_unique_message_id=x_unique_message_id,
     ).parsed
 
 
@@ -153,6 +175,8 @@ async def asyncio_detailed(
     x_unique_company_id: str | Unset = "local",
     x_unique_user_id: str | Unset = "local",
     x_unique_chat_id: str | Unset = "local",
+    x_unique_entry_point: str | Unset = "unknown",
+    x_unique_message_id: None | str | Unset = UNSET,
 ) -> Response[AgentSearchResponse | HTTPValidationError]:
     """Run an agent-based grounded search
 
@@ -160,6 +184,9 @@ async def asyncio_detailed(
         x_unique_company_id (str | Unset): Tenant company identifier. Default: 'local'.
         x_unique_user_id (str | Unset): Tenant user identifier. Default: 'local'.
         x_unique_chat_id (str | Unset): Tenant chat or session identifier. Default: 'local'.
+        x_unique_entry_point (str | Unset): Service where the search entered the platform.
+            Default: 'unknown'.
+        x_unique_message_id (None | str | Unset): Message identifier, reserved for analytics.
         body (BingAgentSearchRequest | VertexAiAgentSearchRequest):
 
     Raises:
@@ -175,6 +202,8 @@ async def asyncio_detailed(
         x_unique_company_id=x_unique_company_id,
         x_unique_user_id=x_unique_user_id,
         x_unique_chat_id=x_unique_chat_id,
+        x_unique_entry_point=x_unique_entry_point,
+        x_unique_message_id=x_unique_message_id,
     )
 
     response = await client.get_async_httpx_client().request(**kwargs)
@@ -189,6 +218,8 @@ async def asyncio(
     x_unique_company_id: str | Unset = "local",
     x_unique_user_id: str | Unset = "local",
     x_unique_chat_id: str | Unset = "local",
+    x_unique_entry_point: str | Unset = "unknown",
+    x_unique_message_id: None | str | Unset = UNSET,
 ) -> AgentSearchResponse | HTTPValidationError | None:
     """Run an agent-based grounded search
 
@@ -196,6 +227,9 @@ async def asyncio(
         x_unique_company_id (str | Unset): Tenant company identifier. Default: 'local'.
         x_unique_user_id (str | Unset): Tenant user identifier. Default: 'local'.
         x_unique_chat_id (str | Unset): Tenant chat or session identifier. Default: 'local'.
+        x_unique_entry_point (str | Unset): Service where the search entered the platform.
+            Default: 'unknown'.
+        x_unique_message_id (None | str | Unset): Message identifier, reserved for analytics.
         body (BingAgentSearchRequest | VertexAiAgentSearchRequest):
 
     Raises:
@@ -213,5 +247,7 @@ async def asyncio(
             x_unique_company_id=x_unique_company_id,
             x_unique_user_id=x_unique_user_id,
             x_unique_chat_id=x_unique_chat_id,
+            x_unique_entry_point=x_unique_entry_point,
+            x_unique_message_id=x_unique_message_id,
         )
     ).parsed

{unique_search_proxy_sdk-2026.44.0.dev4 → unique_search_proxy_sdk-2026.44.0.dev6}/unique_search_proxy_sdk/_generated/api/configuration/list_providers_v1_configuration_providers_get.py

@@ -7,7 +7,7 @@ from ... import errors
 from ...client import AuthenticatedClient, Client
 from ...models.http_validation_error import HTTPValidationError
 from ...models.providers_list_response import ProvidersListResponse
-from ...types import Response, Unset
+from ...types import UNSET, Response, Unset
 
 
 def _get_kwargs(
@@ -15,6 +15,8 @@ def _get_kwargs(
     x_unique_company_id: str | Unset = "local",
     x_unique_user_id: str | Unset = "local",
     x_unique_chat_id: str | Unset = "local",
+    x_unique_entry_point: str | Unset = "unknown",
+    x_unique_message_id: None | str | Unset = UNSET,
 ) -> dict[str, Any]:
     headers: dict[str, Any] = {}
     if not isinstance(x_unique_company_id, Unset):
@@ -26,6 +28,12 @@ def _get_kwargs(
     if not isinstance(x_unique_chat_id, Unset):
         headers["x-unique-chat-id"] = x_unique_chat_id
 
+    if not isinstance(x_unique_entry_point, Unset):
+        headers["x-unique-entry-point"] = x_unique_entry_point
+
+    if not isinstance(x_unique_message_id, Unset):
+        headers["x-unique-message-id"] = x_unique_message_id
+
     _kwargs: dict[str, Any] = {
         "method": "get",
         "url": "/v1/configuration/providers",
@@ -71,6 +79,8 @@ def sync_detailed(
     x_unique_company_id: str | Unset = "local",
     x_unique_user_id: str | Unset = "local",
     x_unique_chat_id: str | Unset = "local",
+    x_unique_entry_point: str | Unset = "unknown",
+    x_unique_message_id: None | str | Unset = UNSET,
 ) -> Response[HTTPValidationError | ProvidersListResponse]:
     """List registered search engines and crawlers
 
@@ -78,6 +88,9 @@ def sync_detailed(
         x_unique_company_id (str | Unset): Tenant company identifier. Default: 'local'.
         x_unique_user_id (str | Unset): Tenant user identifier. Default: 'local'.
         x_unique_chat_id (str | Unset): Tenant chat or session identifier. Default: 'local'.
+        x_unique_entry_point (str | Unset): Service where the search entered the platform.
+            Default: 'unknown'.
+        x_unique_message_id (None | str | Unset): Message identifier, reserved for analytics.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -91,6 +104,8 @@ def sync_detailed(
         x_unique_company_id=x_unique_company_id,
         x_unique_user_id=x_unique_user_id,
         x_unique_chat_id=x_unique_chat_id,
+        x_unique_entry_point=x_unique_entry_point,
+        x_unique_message_id=x_unique_message_id,
     )
 
     response = client.get_httpx_client().request(
@@ -106,6 +121,8 @@ def sync(
     x_unique_company_id: str | Unset = "local",
     x_unique_user_id: str | Unset = "local",
     x_unique_chat_id: str | Unset = "local",
+    x_unique_entry_point: str | Unset = "unknown",
+    x_unique_message_id: None | str | Unset = UNSET,
 ) -> HTTPValidationError | ProvidersListResponse | None:
     """List registered search engines and crawlers
 
@@ -113,6 +130,9 @@ def sync(
         x_unique_company_id (str | Unset): Tenant company identifier. Default: 'local'.
         x_unique_user_id (str | Unset): Tenant user identifier. Default: 'local'.
         x_unique_chat_id (str | Unset): Tenant chat or session identifier. Default: 'local'.
+        x_unique_entry_point (str | Unset): Service where the search entered the platform.
+            Default: 'unknown'.
+        x_unique_message_id (None | str | Unset): Message identifier, reserved for analytics.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -127,6 +147,8 @@ def sync(
         x_unique_company_id=x_unique_company_id,
         x_unique_user_id=x_unique_user_id,
         x_unique_chat_id=x_unique_chat_id,
+        x_unique_entry_point=x_unique_entry_point,
+        x_unique_message_id=x_unique_message_id,
     ).parsed
 
 
@@ -136,6 +158,8 @@ async def asyncio_detailed(
     x_unique_company_id: str | Unset = "local",
     x_unique_user_id: str | Unset = "local",
     x_unique_chat_id: str | Unset = "local",
+    x_unique_entry_point: str | Unset = "unknown",
+    x_unique_message_id: None | str | Unset = UNSET,
 ) -> Response[HTTPValidationError | ProvidersListResponse]:
     """List registered search engines and crawlers
 
@@ -143,6 +167,9 @@ async def asyncio_detailed(
         x_unique_company_id (str | Unset): Tenant company identifier. Default: 'local'.
         x_unique_user_id (str | Unset): Tenant user identifier. Default: 'local'.
         x_unique_chat_id (str | Unset): Tenant chat or session identifier. Default: 'local'.
+        x_unique_entry_point (str | Unset): Service where the search entered the platform.
+            Default: 'unknown'.
+        x_unique_message_id (None | str | Unset): Message identifier, reserved for analytics.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -156,6 +183,8 @@ async def asyncio_detailed(
         x_unique_company_id=x_unique_company_id,
         x_unique_user_id=x_unique_user_id,
         x_unique_chat_id=x_unique_chat_id,
+        x_unique_entry_point=x_unique_entry_point,
+        x_unique_message_id=x_unique_message_id,
     )
 
     response = await client.get_async_httpx_client().request(**kwargs)
@@ -169,6 +198,8 @@ async def asyncio(
     x_unique_company_id: str | Unset = "local",
     x_unique_user_id: str | Unset = "local",
     x_unique_chat_id: str | Unset = "local",
+    x_unique_entry_point: str | Unset = "unknown",
+    x_unique_message_id: None | str | Unset = UNSET,
 ) -> HTTPValidationError | ProvidersListResponse | None:
     """List registered search engines and crawlers
 
@@ -176,6 +207,9 @@ async def asyncio(
         x_unique_company_id (str | Unset): Tenant company identifier. Default: 'local'.
         x_unique_user_id (str | Unset): Tenant user identifier. Default: 'local'.
         x_unique_chat_id (str | Unset): Tenant chat or session identifier. Default: 'local'.
+        x_unique_entry_point (str | Unset): Service where the search entered the platform.
+            Default: 'unknown'.
+        x_unique_message_id (None | str | Unset): Message identifier, reserved for analytics.
 
     Raises:
         errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
@@ -191,5 +225,7 @@ async def asyncio(
             x_unique_company_id=x_unique_company_id,
             x_unique_user_id=x_unique_user_id,
             x_unique_chat_id=x_unique_chat_id,
+            x_unique_entry_point=x_unique_entry_point,
+            x_unique_message_id=x_unique_message_id,
         )
     ).parsed

{unique_search_proxy_sdk-2026.44.0.dev4 → unique_search_proxy_sdk-2026.44.0.dev6}/unique_search_proxy_sdk/_generated/api/crawl/crawl_v1_crawl_post.py

@@ -11,7 +11,7 @@ from ...models.firecrawl_crawl_request import FirecrawlCrawlRequest
 from ...models.http_validation_error import HTTPValidationError
 from ...models.jina_crawl_request import JinaCrawlRequest
 from ...models.tavily_crawl_request import TavilyCrawlRequest
-from ...types import Response, Unset
+from ...types import UNSET, Response, Unset
 
 
 def _get_kwargs(
@@ -23,6 +23,8 @@ def _get_kwargs(
     x_unique_company_id: str | Unset = "local",
     x_unique_user_id: str | Unset = "local",
     x_unique_chat_id: str | Unset = "local",
+    x_unique_entry_point: str | Unset = "unknown",
+    x_unique_message_id: None | str | Unset = UNSET,
 ) -> dict[str, Any]:
     headers: dict[str, Any] = {}
     if not isinstance(x_unique_company_id, Unset):
@@ -34,6 +36,12 @@ def _get_kwargs(
     if not isinstance(x_unique_chat_id, Unset):
         headers["x-unique-chat-id"] = x_unique_chat_id
 
+    if not isinstance(x_unique_entry_point, Unset):
+        headers["x-unique-entry-point"] = x_unique_entry_point
+
+    if not isinstance(x_unique_message_id, Unset):
+        headers["x-unique-message-id"] = x_unique_message_id
+
     _kwargs: dict[str, Any] = {
         "method": "post",
         "url": "/v1/crawl",
@@ -94,6 +102,8 @@ def sync_detailed(
     x_unique_company_id: str | Unset = "local",
     x_unique_user_id: str | Unset = "local",
     x_unique_chat_id: str | Unset = "local",
+    x_unique_entry_point: str | Unset = "unknown",
+    x_unique_message_id: None | str | Unset = UNSET,
 ) -> Response[CrawlResponse | HTTPValidationError]:
     """Crawl URLs with a configured crawler
 
@@ -101,6 +111,9 @@ def sync_detailed(
         x_unique_company_id (str | Unset): Tenant company identifier. Default: 'local'.
         x_unique_user_id (str | Unset): Tenant user identifier. Default: 'local'.
         x_unique_chat_id (str | Unset): Tenant chat or session identifier. Default: 'local'.
+        x_unique_entry_point (str | Unset): Service where the search entered the platform.
+            Default: 'unknown'.
+        x_unique_message_id (None | str | Unset): Message identifier, reserved for analytics.
         body (BasicCrawlRequest | FirecrawlCrawlRequest | JinaCrawlRequest | TavilyCrawlRequest):
 
     Raises:
@@ -116,6 +129,8 @@ def sync_detailed(
         x_unique_company_id=x_unique_company_id,
         x_unique_user_id=x_unique_user_id,
         x_unique_chat_id=x_unique_chat_id,
+        x_unique_entry_point=x_unique_entry_point,
+        x_unique_message_id=x_unique_message_id,
     )
 
     response = client.get_httpx_client().request(
@@ -135,6 +150,8 @@ def sync(
     x_unique_company_id: str | Unset = "local",
     x_unique_user_id: str | Unset = "local",
     x_unique_chat_id: str | Unset = "local",
+    x_unique_entry_point: str | Unset = "unknown",
+    x_unique_message_id: None | str | Unset = UNSET,
 ) -> CrawlResponse | HTTPValidationError | None:
     """Crawl URLs with a configured crawler
 
@@ -142,6 +159,9 @@ def sync(
         x_unique_company_id (str | Unset): Tenant company identifier. Default: 'local'.
         x_unique_user_id (str | Unset): Tenant user identifier. Default: 'local'.
         x_unique_chat_id (str | Unset): Tenant chat or session identifier. Default: 'local'.
+        x_unique_entry_point (str | Unset): Service where the search entered the platform.
+            Default: 'unknown'.
+        x_unique_message_id (None | str | Unset): Message identifier, reserved for analytics.
         body (BasicCrawlRequest | FirecrawlCrawlRequest | JinaCrawlRequest | TavilyCrawlRequest):
 
     Raises:
@@ -158,6 +178,8 @@ def sync(
         x_unique_company_id=x_unique_company_id,
         x_unique_user_id=x_unique_user_id,
         x_unique_chat_id=x_unique_chat_id,
+        x_unique_entry_point=x_unique_entry_point,
+        x_unique_message_id=x_unique_message_id,
     ).parsed
 
 
@@ -171,6 +193,8 @@ async def asyncio_detailed(
     x_unique_company_id: str | Unset = "local",
     x_unique_user_id: str | Unset = "local",
     x_unique_chat_id: str | Unset = "local",
+    x_unique_entry_point: str | Unset = "unknown",
+    x_unique_message_id: None | str | Unset = UNSET,
 ) -> Response[CrawlResponse | HTTPValidationError]:
     """Crawl URLs with a configured crawler
 
@@ -178,6 +202,9 @@ async def asyncio_detailed(
         x_unique_company_id (str | Unset): Tenant company identifier. Default: 'local'.
         x_unique_user_id (str | Unset): Tenant user identifier. Default: 'local'.
         x_unique_chat_id (str | Unset): Tenant chat or session identifier. Default: 'local'.
+        x_unique_entry_point (str | Unset): Service where the search entered the platform.
+            Default: 'unknown'.
+        x_unique_message_id (None | str | Unset): Message identifier, reserved for analytics.
         body (BasicCrawlRequest | FirecrawlCrawlRequest | JinaCrawlRequest | TavilyCrawlRequest):
 
     Raises:
@@ -193,6 +220,8 @@ async def asyncio_detailed(
         x_unique_company_id=x_unique_company_id,
         x_unique_user_id=x_unique_user_id,
         x_unique_chat_id=x_unique_chat_id,
+        x_unique_entry_point=x_unique_entry_point,
+        x_unique_message_id=x_unique_message_id,
     )
 
     response = await client.get_async_httpx_client().request(**kwargs)
@@ -210,6 +239,8 @@ async def asyncio(
     x_unique_company_id: str | Unset = "local",
     x_unique_user_id: str | Unset = "local",
     x_unique_chat_id: str | Unset = "local",
+    x_unique_entry_point: str | Unset = "unknown",
+    x_unique_message_id: None | str | Unset = UNSET,
 ) -> CrawlResponse | HTTPValidationError | None:
     """Crawl URLs with a configured crawler
 
@@ -217,6 +248,9 @@ async def asyncio(
         x_unique_company_id (str | Unset): Tenant company identifier. Default: 'local'.
         x_unique_user_id (str | Unset): Tenant user identifier. Default: 'local'.
         x_unique_chat_id (str | Unset): Tenant chat or session identifier. Default: 'local'.
+        x_unique_entry_point (str | Unset): Service where the search entered the platform.
+            Default: 'unknown'.
+        x_unique_message_id (None | str | Unset): Message identifier, reserved for analytics.
         body (BasicCrawlRequest | FirecrawlCrawlRequest | JinaCrawlRequest | TavilyCrawlRequest):
 
     Raises:
@@ -234,5 +268,7 @@ async def asyncio(
             x_unique_company_id=x_unique_company_id,
             x_unique_user_id=x_unique_user_id,
             x_unique_chat_id=x_unique_chat_id,
+            x_unique_entry_point=x_unique_entry_point,
+            x_unique_message_id=x_unique_message_id,
         )
     ).parsed

{unique_search_proxy_sdk-2026.44.0.dev4 → unique_search_proxy_sdk-2026.44.0.dev6}/unique_search_proxy_sdk/_generated/api/search/search_v1_search_post.py

@@ -11,7 +11,7 @@ from ...models.google_search_request import GoogleSearchRequest
 from ...models.http_validation_error import HTTPValidationError
 from ...models.perplexity_search_request import PerplexitySearchRequest
 from ...models.search_response import SearchResponse
-from ...types import Response, Unset
+from ...types import UNSET, Response, Unset
 
 
 def _get_kwargs(
@@ -23,6 +23,8 @@ def _get_kwargs(
     x_unique_company_id: str | Unset = "local",
     x_unique_user_id: str | Unset = "local",
     x_unique_chat_id: str | Unset = "local",
+    x_unique_entry_point: str | Unset = "unknown",
+    x_unique_message_id: None | str | Unset = UNSET,
 ) -> dict[str, Any]:
     headers: dict[str, Any] = {}
     if not isinstance(x_unique_company_id, Unset):
@@ -34,6 +36,12 @@ def _get_kwargs(
     if not isinstance(x_unique_chat_id, Unset):
         headers["x-unique-chat-id"] = x_unique_chat_id
 
+    if not isinstance(x_unique_entry_point, Unset):
+        headers["x-unique-entry-point"] = x_unique_entry_point
+
+    if not isinstance(x_unique_message_id, Unset):
+        headers["x-unique-message-id"] = x_unique_message_id
+
     _kwargs: dict[str, Any] = {
         "method": "post",
         "url": "/v1/search",
@@ -94,6 +102,8 @@ def sync_detailed(
     x_unique_company_id: str | Unset = "local",
     x_unique_user_id: str | Unset = "local",
     x_unique_chat_id: str | Unset = "local",
+    x_unique_entry_point: str | Unset = "unknown",
+    x_unique_message_id: None | str | Unset = UNSET,
 ) -> Response[HTTPValidationError | SearchResponse]:
     """Run a search engine with a typed call payload
 
@@ -101,6 +111,9 @@ def sync_detailed(
         x_unique_company_id (str | Unset): Tenant company identifier. Default: 'local'.
         x_unique_user_id (str | Unset): Tenant user identifier. Default: 'local'.
         x_unique_chat_id (str | Unset): Tenant chat or session identifier. Default: 'local'.
+        x_unique_entry_point (str | Unset): Service where the search entered the platform.
+            Default: 'unknown'.
+        x_unique_message_id (None | str | Unset): Message identifier, reserved for analytics.
         body (BraveSearchRequest | CustomApiSearchRequest | GoogleSearchRequest |
             PerplexitySearchRequest):
 
@@ -117,6 +130,8 @@ def sync_detailed(
         x_unique_company_id=x_unique_company_id,
         x_unique_user_id=x_unique_user_id,
         x_unique_chat_id=x_unique_chat_id,
+        x_unique_entry_point=x_unique_entry_point,
+        x_unique_message_id=x_unique_message_id,
     )
 
     response = client.get_httpx_client().request(
@@ -136,6 +151,8 @@ def sync(
     x_unique_company_id: str | Unset = "local",
     x_unique_user_id: str | Unset = "local",
     x_unique_chat_id: str | Unset = "local",
+    x_unique_entry_point: str | Unset = "unknown",
+    x_unique_message_id: None | str | Unset = UNSET,
 ) -> HTTPValidationError | SearchResponse | None:
     """Run a search engine with a typed call payload
 
@@ -143,6 +160,9 @@ def sync(
         x_unique_company_id (str | Unset): Tenant company identifier. Default: 'local'.
         x_unique_user_id (str | Unset): Tenant user identifier. Default: 'local'.
         x_unique_chat_id (str | Unset): Tenant chat or session identifier. Default: 'local'.
+        x_unique_entry_point (str | Unset): Service where the search entered the platform.
+            Default: 'unknown'.
+        x_unique_message_id (None | str | Unset): Message identifier, reserved for analytics.
         body (BraveSearchRequest | CustomApiSearchRequest | GoogleSearchRequest |
             PerplexitySearchRequest):
 
@@ -160,6 +180,8 @@ def sync(
         x_unique_company_id=x_unique_company_id,
         x_unique_user_id=x_unique_user_id,
         x_unique_chat_id=x_unique_chat_id,
+        x_unique_entry_point=x_unique_entry_point,
+        x_unique_message_id=x_unique_message_id,
     ).parsed
 
 
@@ -173,6 +195,8 @@ async def asyncio_detailed(
     x_unique_company_id: str | Unset = "local",
     x_unique_user_id: str | Unset = "local",
     x_unique_chat_id: str | Unset = "local",
+    x_unique_entry_point: str | Unset = "unknown",
+    x_unique_message_id: None | str | Unset = UNSET,
 ) -> Response[HTTPValidationError | SearchResponse]:
     """Run a search engine with a typed call payload
 
@@ -180,6 +204,9 @@ async def asyncio_detailed(
         x_unique_company_id (str | Unset): Tenant company identifier. Default: 'local'.
         x_unique_user_id (str | Unset): Tenant user identifier. Default: 'local'.
         x_unique_chat_id (str | Unset): Tenant chat or session identifier. Default: 'local'.
+        x_unique_entry_point (str | Unset): Service where the search entered the platform.
+            Default: 'unknown'.
+        x_unique_message_id (None | str | Unset): Message identifier, reserved for analytics.
         body (BraveSearchRequest | CustomApiSearchRequest | GoogleSearchRequest |
             PerplexitySearchRequest):
 
@@ -196,6 +223,8 @@ async def asyncio_detailed(
         x_unique_company_id=x_unique_company_id,
         x_unique_user_id=x_unique_user_id,
         x_unique_chat_id=x_unique_chat_id,
+        x_unique_entry_point=x_unique_entry_point,
+        x_unique_message_id=x_unique_message_id,
     )
 
     response = await client.get_async_httpx_client().request(**kwargs)
@@ -213,6 +242,8 @@ async def asyncio(
     x_unique_company_id: str | Unset = "local",
     x_unique_user_id: str | Unset = "local",
     x_unique_chat_id: str | Unset = "local",
+    x_unique_entry_point: str | Unset = "unknown",
+    x_unique_message_id: None | str | Unset = UNSET,
 ) -> HTTPValidationError | SearchResponse | None:
     """Run a search engine with a typed call payload
 
@@ -220,6 +251,9 @@ async def asyncio(
         x_unique_company_id (str | Unset): Tenant company identifier. Default: 'local'.
         x_unique_user_id (str | Unset): Tenant user identifier. Default: 'local'.
         x_unique_chat_id (str | Unset): Tenant chat or session identifier. Default: 'local'.
+        x_unique_entry_point (str | Unset): Service where the search entered the platform.
+            Default: 'unknown'.
+        x_unique_message_id (None | str | Unset): Message identifier, reserved for analytics.
         body (BraveSearchRequest | CustomApiSearchRequest | GoogleSearchRequest |
             PerplexitySearchRequest):
 
@@ -238,5 +272,7 @@ async def asyncio(
             x_unique_company_id=x_unique_company_id,
             x_unique_user_id=x_unique_user_id,
             x_unique_chat_id=x_unique_chat_id,
+            x_unique_entry_point=x_unique_entry_point,
+            x_unique_message_id=x_unique_message_id,
         )
     ).parsed

{unique_search_proxy_sdk-2026.44.0.dev4 → unique_search_proxy_sdk-2026.44.0.dev6}/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.dev4 → unique_search_proxy_sdk-2026.44.0.dev6}/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.dev6/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.dev4 → unique_search_proxy_sdk-2026.44.0.dev6}/unique_search_proxy_sdk/_transport.py

@@ -58,16 +58,17 @@ class OpenapiTransport:
         """Per-request context kwargs for the generated ``/v1`` route helpers.
 
         The generated helpers default ``x_unique_company_id`` / ``x_unique_user_id``
-        / ``x_unique_chat_id`` to ``"local"`` and always attach them as request
-        headers. In httpx, request headers win over the client-level default
-        headers, so relying on the client-level context alone silently resets a
-        non-local context to ``"local"`` on every call. Forwarding these keeps the
-        transport's context authoritative.
+        / ``x_unique_chat_id`` to ``"local"`` and ``x_unique_entry_point`` to
+        ``"unknown"``, and always attach them as request headers. In httpx,
+        request headers win over the client-level default headers, so relying on
+        the client-level context alone silently resets a non-local context on every
+        call. Forwarding these keeps the transport's context authoritative.
         """
         return {
             "x_unique_company_id": self._context.company_id,
             "x_unique_user_id": self._context.user_id,
             "x_unique_chat_id": self._context.chat_id,
+            "x_unique_entry_point": self._context.entry_point.value,
         }
 
     async def aclose(self) -> None: