unique_web_search 2026.38.0.dev0__tar.gz → 2026.38.0.dev2__tar.gz

{unique_web_search-2026.38.0.dev0 → unique_web_search-2026.38.0.dev2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: unique-web-search
-Version: 2026.38.0.dev0
+Version: 2026.38.0.dev2
 Summary: 
 Author: Andreas Hauri, Gustav Hartz, Rami Azouz
 Author-email: Andreas Hauri <andreas@unique.ch>, Gustav Hartz <gustav.hartz.ext@unique.ch>, Rami Azouz <rami.ext@unique.ch>
@@ -16,7 +16,7 @@ Requires-Dist: tavily-python>=0.7.11,<1
 Requires-Dist: unidecode>=1.4.0,<2
 Requires-Dist: azure-ai-projects>=2.3,<3
 Requires-Dist: azure-identity>=1.25.0,<2
-Requires-Dist: unique-toolkit[monitoring]>=2026.38.0.dev0,<2026.38.0rc0
+Requires-Dist: unique-toolkit[monitoring]>=2026.38.0.dev11,<2026.38.0rc0
 Requires-Dist: azure-core>=1.36.0,<2
 Requires-Dist: google-cloud-aiplatform>=1.128.0,<2
 Requires-Dist: google-auth>=2.43.0,<3
@@ -25,8 +25,8 @@ Requires-Dist: rapidfuzz>=3.0.0,<4
 Requires-Dist: httpx>=0.28.1
 Requires-Dist: certifi>=2025.11.12
 Requires-Dist: jinja2>=3.1.6
-Requires-Dist: unique-search-proxy-core>=2026.38.0.dev0,<2026.38.0rc0
-Requires-Dist: unique-search-proxy-sdk>=2026.38.0.dev0,<2026.38.0rc0
+Requires-Dist: unique-search-proxy-core>=2026.38.0.dev3,<2026.38.0rc0
+Requires-Dist: unique-search-proxy-sdk>=2026.38.0.dev2,<2026.38.0rc0
 Requires-Dist: openai>=1.105.0,<3
 Requires-Python: >=3.12, <4.0
 Description-Content-Type: text/markdown
@@ -75,7 +75,7 @@ An upstream AI agent / grounded model searches and returns opaque text that this
 
 | Engine | Proxy | Notes |
 |--------|-------|-------|
-| Bing (Azure AI Foundry grounding) | legacy + proxy | Configurable `requires_scraping`; `market` / `setLang` / `freshness` are `ExposableParam` knobs |
+| Bing (Azure AI Foundry grounding) | legacy + proxy | Configurable `requires_scraping`; fixed `market` / `freshness` chosen by an admin, with `market` falling back to `BING_AGENT_DEFAULT_MARKET` |
 | VertexAI (Gemini grounding) | legacy + proxy | Configurable `requires_scraping` |
 
 Bing's grounding knobs are baked into the hashed Foundry agent name, so changing

{unique_web_search-2026.38.0.dev0 → unique_web_search-2026.38.0.dev2}/README.md

@@ -42,7 +42,7 @@ An upstream AI agent / grounded model searches and returns opaque text that this
 
 | Engine | Proxy | Notes |
 |--------|-------|-------|
-| Bing (Azure AI Foundry grounding) | legacy + proxy | Configurable `requires_scraping`; `market` / `setLang` / `freshness` are `ExposableParam` knobs |
+| Bing (Azure AI Foundry grounding) | legacy + proxy | Configurable `requires_scraping`; fixed `market` / `freshness` chosen by an admin, with `market` falling back to `BING_AGENT_DEFAULT_MARKET` |
 | VertexAI (Gemini grounding) | legacy + proxy | Configurable `requires_scraping` |
 
 Bing's grounding knobs are baked into the hashed Foundry agent name, so changing

{unique_web_search-2026.38.0.dev0 → unique_web_search-2026.38.0.dev2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "unique_web_search"
-version = "2026.38.0.dev0"
+version = "2026.38.0.dev2"
 description = ""
 readme = "README.md"
 requires-python = ">=3.12,<4.0"
@@ -22,7 +22,7 @@ dependencies = [
     "unidecode>=1.4.0,<2",
     "azure-ai-projects>=2.3,<3",
     "azure-identity>=1.25.0,<2",
-    "unique-toolkit[monitoring]>=2026.38.0.dev0,<2026.38.0rc0",
+    "unique-toolkit[monitoring]>=2026.38.0.dev11,<2026.38.0rc0",
     "azure-core>=1.36.0,<2",
     "google-cloud-aiplatform>=1.128.0,<2",
     "google-auth>=2.43.0,<3",
@@ -31,8 +31,8 @@ dependencies = [
     "httpx>=0.28.1",
     "certifi>=2025.11.12",
     "jinja2>=3.1.6",
-    "unique-search-proxy-core>=2026.38.0.dev0,<2026.38.0rc0",
-    "unique-search-proxy-sdk>=2026.38.0.dev0,<2026.38.0rc0",
+    "unique-search-proxy-core>=2026.38.0.dev3,<2026.38.0rc0",
+    "unique-search-proxy-sdk>=2026.38.0.dev2,<2026.38.0rc0",
     "openai>=1.105.0,<3",
 ]
 

{unique_web_search-2026.38.0.dev0 → unique_web_search-2026.38.0.dev2}/src/unique_web_search/services/search_engine/README.md

@@ -151,8 +151,39 @@ CUSTOM_WEB_SEARCH_API_HEADERS='{"Authorization": "Bearer ..."}'
 
 | Field | Notes |
 |-------|-------|
-| `fetch_size` | Bing result count |
-| `market`, `set_lang`, `freshness` | `ExposableParam`; `market` / `set_lang` restricted to Bing's documented codes; forwarded to `BingGroundingSearchConfiguration` |
+| `fetch_size` | Bing result count (`count` on the tool configuration) |
+| `market` | Region **and** language Bing favours (Bing `mkt`). A bias, not a filter — other regions can still appear |
+| `freshness` | Recency cut-off applied to every search in the space (Bing `freshness`): `Day` / `Week` / `Month` |
+
+Both are optional **fixed** values an admin picks for the whole space and are
+never offered to the LLM, and both are restricted to Bing's documented values so
+they render as one dropdown each; blank values are omitted so Bing applies its
+own defaults.
+
+`freshness` also accepts absolute days and ranges (`2026-01-01..2026-03-31`),
+which we deliberately do **not** offer: pinned space-wide, an absolute window
+freezes the space to a range that rots the day after it is saved. Presets only
+also keep the admin schema fully enumerated, so a typo cannot save.
+
+`BingGroundingSearchConfiguration` also accepts `setLang`, which we deliberately
+do **not** expose: it only localizes the labels Bing puts around results, so an
+admin reading "language" would set it expecting French results and leave `mkt`
+unset. Beyond these, Bing grounding has no `safeSearch`, `responseFilter`, or
+`answerCount`, so `count` / `market` / `freshness` is the whole useful surface.
+
+Spaces saved on 2026.36 hold an `ExposableParam` `{expose, value}` object under
+both keys. node-chat data migration
+`20260908120000_drop_bing_grounding_exposable_params` deletes them, and
+`BingAgentConfig` reads that shape as unset for rows the migration has not
+reached — an invalid tool config disables the whole tool silently, so tolerating
+it is not optional. The migration deletes rather than unwraps, which keeps a
+rollback to 2026.36 valid.
+
+A blank `market` falls back to the `BING_AGENT_DEFAULT_MARKET` environment
+variable (below), so a deployment serving a single country pins its market once
+instead of per space. With neither set, `mkt` is left off the call entirely and
+Bing may favour the region where the underlying Microsoft Foundry resource is
+deployed.
 
 Bing bakes the tool configuration into the *agent version*, so these knobs take
 part in the hashed agent name (`unique-grounding-with-bing-<hash>`): changing one
@@ -162,7 +193,8 @@ provisions a new agent version instead of reusing a mismatched one.
 AZURE_AI_PROJECT_ENDPOINT=...
 AZURE_AI_AGENT_ID=...          # optional; empty → auto-provision
 AZURE_IDENTITY_CREDENTIAL_TYPE=workload  # or default
-BING_AGENT_MARKET={"default": "fr-CH", "enforce": false}  # optional environment default
+# Market applied to spaces that fix none; omit to send no market at all.
+BING_AGENT_DEFAULT_MARKET=fr-FR
 ```
 
 ### VertexAI (Grounding with VertexAI)

{unique_web_search-2026.38.0.dev0 → unique_web_search-2026.38.0.dev2}/src/unique_web_search/services/search_engine/bing.py

@@ -1,5 +1,5 @@
 import asyncio
-from typing import override
+from typing import Any, override
 
 from pydantic import Field
 from unique_search_proxy_core.agent_engines.base import AgentEngineType
@@ -7,10 +7,8 @@ from unique_search_proxy_core.agent_engines.bing.grounding import (
     BingGroundingConfiguration,
 )
 from unique_search_proxy_core.agent_engines.bing.schema import BingAgentConfig
+from unique_search_proxy_core.agent_engines.bing.settings import resolve_market
 from unique_search_proxy_core.context import LOCAL_REQUEST_CONTEXT, RequestContext
-from unique_search_proxy_core.param_policy.exposable_param import (
-    resolve_exposable_value,
-)
 from unique_search_proxy_core.param_policy.exposed_params import ExposedParams
 from unique_toolkit._common.default_language_model import DEFAULT_LANGUAGE_MODEL
 from unique_toolkit._common.validators import LMI, get_LMI_default_field
@@ -88,25 +86,27 @@ class BingSearch(SearchEngine[BingSearchConfig]):
     def requires_scraping(self) -> bool:
         return self.config.requires_scraping
 
-    def _grounding_configuration(
-        self,
-        params: ExposedParams | None,
-    ) -> BingGroundingConfiguration:
-        """Resolve the Bing tool knobs from deployment defaults + LLM overrides."""
-        overrides = params.model_dump(exclude_none=True) if params else {}
-
-        def knob(field_name: str) -> str | None:
-            if field_name in overrides:
-                return overrides[field_name]
-            return resolve_exposable_value(getattr(self.config, field_name))
-
+    def _grounding_configuration(self) -> BingGroundingConfiguration:
+        """The Bing tool knobs this space has fixed, with the market resolved."""
         return BingGroundingConfiguration(
             fetch_size=self.config.fetch_size,
-            market=knob("market"),
-            set_lang=knob("set_lang"),
-            freshness=knob("freshness"),
+            market=resolve_market(self.config.market),
+            freshness=self.config.freshness,
         )
 
+    @override
+    def _agent_proxy_invocation(
+        self,
+        engine: AgentEngineType,
+        params: ExposedParams | None,
+    ) -> dict[str, Any]:
+        """Resolve the market here too, so the env default works on either service."""
+        invocation = super()._agent_proxy_invocation(engine, params)
+        market = resolve_market(invocation.get("market"))
+        if market is not None:
+            invocation["market"] = market
+        return invocation
+
     @override
     async def _legacy_search(
         self,
@@ -119,7 +119,7 @@ class BingSearch(SearchEngine[BingSearchConfig]):
             search_results = await create_and_process_run(
                 agent_client,
                 query=query,
-                grounding=self._grounding_configuration(params),
+                grounding=self._grounding_configuration(),
                 response_parsers_strategies=self.response_parsers,
                 generation_instructions=self.config.generation_instructions,
             )

{unique_web_search-2026.38.0.dev0 → unique_web_search-2026.38.0.dev2}/src/unique_web_search/services/search_engine/utils/grounding/bing/runner.py

@@ -138,7 +138,6 @@ def get_bing_grounding_tool(
                     project_connection_id=connection_id,
                     count=grounding.fetch_size,
                     market=grounding.market,
-                    set_lang=grounding.set_lang,
                     freshness=grounding.freshness,
                 )
             ]