unique-search-proxy 2026.30.0.dev0__tar.gz → 2026.30.0.dev2__tar.gz

{unique_search_proxy-2026.30.0.dev0 → unique_search_proxy-2026.30.0.dev2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: unique-search-proxy
-Version: 2026.30.0.dev0
+Version: 2026.30.0.dev2
 Summary: Web Search Proxy implementation
 Author: ThePhilAz
 Author-email: ThePhilAz <rami.azouz@philico.com>
@@ -19,8 +19,8 @@ Requires-Dist: certifi>=2025.11.12,<2027
 Requires-Dist: google-genai>=1.73.0,<2
 Requires-Dist: google-auth>=2.43.0,<3
 Requires-Dist: jinja2>=3.1.6,<4
-Requires-Dist: unique-toolkit[monitoring]>=2026.30.0.dev0,<2026.30.0rc0
-Requires-Dist: unique-search-proxy-core>=2026.30.0.dev0,<2026.30.0rc0
+Requires-Dist: unique-toolkit[monitoring]>=2026.30.0.dev10,<2026.30.0rc0
+Requires-Dist: unique-search-proxy-core>=2026.30.0.dev2,<2026.30.0rc0
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 
@@ -65,7 +65,7 @@ System overview → [../README.md](../README.md)
 
 **What the client owns:** HTTP routes, provider registry, credential loading, httpx egress pool, Prometheus, Docker/Helm deployment.
 
-**What it does not own:** Deployment config JSON Schema, LLM call-schema projection, config/invocation merge — those live in core and run in caller processes.
+**What it does not own:** Deployment config JSON Schema, LLM exposed-params derivation, config/invocation merge — those live in core (as config-class methods) and run in caller processes.
 
 ---
 

{unique_search_proxy-2026.30.0.dev0 → unique_search_proxy-2026.30.0.dev2}/README.md

@@ -39,7 +39,7 @@ System overview → [../README.md](../README.md)
 
 **What the client owns:** HTTP routes, provider registry, credential loading, httpx egress pool, Prometheus, Docker/Helm deployment.
 
-**What it does not own:** Deployment config JSON Schema, LLM call-schema projection, config/invocation merge — those live in core and run in caller processes.
+**What it does not own:** Deployment config JSON Schema, LLM exposed-params derivation, config/invocation merge — those live in core (as config-class methods) and run in caller processes.
 
 ---
 

{unique_search_proxy-2026.30.0.dev0 → unique_search_proxy-2026.30.0.dev2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "unique-search-proxy"
-version = "2026.30.0.dev0"
+version = "2026.30.0.dev2"
 description = "Web Search Proxy implementation"
 authors = [{ name = "ThePhilAz", email = "rami.azouz@philico.com" }]
 readme = "README.md"
@@ -21,8 +21,8 @@ dependencies = [
     "google-genai>=1.73.0,<2",
     "google-auth>=2.43.0,<3",
     "jinja2>=3.1.6,<4",
-    "unique-toolkit[monitoring]>=2026.30.0.dev0,<2026.30.0rc0",
-    "unique-search-proxy-core>=2026.30.0.dev0,<2026.30.0rc0",
+    "unique-toolkit[monitoring]>=2026.30.0.dev10,<2026.30.0rc0",
+    "unique-search-proxy-core>=2026.30.0.dev2,<2026.30.0rc0",
 ]
 
 [dependency-groups]

{unique_search_proxy-2026.30.0.dev0 → unique_search_proxy-2026.30.0.dev2}/unique_search_proxy_client/web/core/search_engines/__init__.py

@@ -10,10 +10,7 @@ from unique_search_proxy_client.web.core.search_engines.descriptor import (
     SearchEngineDescriptor,
 )
 from unique_search_proxy_client.web.core.search_engines.factory import (
-    get_request_model_for_engine,
     get_search_engine_service,
-    resolve_engine_call,
-    resolve_engine_request,
 )
 from unique_search_proxy_client.web.core.search_engines.google.service import (
     GoogleSearchService,
@@ -61,9 +58,6 @@ __all__ = [
     "PerplexitySearchService",
     "SearchEngineDescriptor",
     "SearchEngineType",
-    "get_request_model_for_engine",
     "get_search_engine_service",
     "register_builtin_search_engines",
-    "resolve_engine_call",
-    "resolve_engine_request",
 ]

{unique_search_proxy-2026.30.0.dev0 → unique_search_proxy-2026.30.0.dev2}/unique_search_proxy_client/web/core/search_engines/brave/__init__.py

@@ -1,7 +1,4 @@
-from unique_search_proxy_core.search_engines.brave.schema import (
-    BraveConfig,
-    brave_request_model,
-)
+from unique_search_proxy_core.search_engines.brave.schema import BraveConfig
 
 from unique_search_proxy_client.web.core.search_engines.brave.query_params import (
     build_brave_query_params,
@@ -14,5 +11,4 @@ __all__ = [
     "BraveConfig",
     "BraveSearchService",
     "build_brave_query_params",
-    "brave_request_model",
 ]

{unique_search_proxy-2026.30.0.dev0 → unique_search_proxy-2026.30.0.dev2}/unique_search_proxy_client/web/core/search_engines/brave/query_params.py

@@ -15,12 +15,11 @@ def build_brave_query_params(
     page: PageRequest,
 ) -> dict[str, Any]:
     """Assemble the Brave Web Search API query string from the derived request."""
-    config = BraveConfig()
     return {
         "q": query,
         "count": page.count,
         "offset": page.offset,
-        **config.provider_query_params_from(request, by_alias=False),
+        **BraveConfig.provider_query_params(request, by_alias=False),
     }
 
 

{unique_search_proxy-2026.30.0.dev0 → unique_search_proxy-2026.30.0.dev2}/unique_search_proxy_client/web/core/search_engines/brave/service.py

@@ -19,7 +19,6 @@ from unique_search_proxy_core.search_engines.base import (
     get_search_engine_mode,
 )
 from unique_search_proxy_core.search_engines.brave.schema import (
-    BraveConfig,
     BraveSearchRequest,
 )
 
@@ -160,20 +159,6 @@ class BraveSearchService(SearchEngineService[BraveSearchRequest]):
             )
         return results
 
-    @staticmethod
-    def llm_call_schema(
-        config: BraveConfig,
-        *,
-        strict_required: bool = True,
-    ) -> type[Any]:
-        from unique_search_proxy_core.projection import build_llm_call_model
-
-        return build_llm_call_model(
-            BraveConfig,
-            config,
-            strict_required=strict_required,
-        )
-
 
 def _brave_headers(api_key: str) -> dict[str, str]:
     return {

{unique_search_proxy-2026.30.0.dev0 → unique_search_proxy-2026.30.0.dev2}/unique_search_proxy_client/web/core/search_engines/descriptor.py

@@ -4,7 +4,6 @@ from dataclasses import dataclass
 from typing import TYPE_CHECKING, Any
 
 from pydantic import BaseModel
-from unique_search_proxy_core.projection import build_request_model
 
 if TYPE_CHECKING:
     from unique_search_proxy_core.search_engines.base import SearchEngine
@@ -16,8 +15,3 @@ class SearchEngineDescriptor:
 
     config_model: type[BaseModel]
     service_cls: type[SearchEngine[Any]]
-
-    @property
-    def request_model(self) -> type[BaseModel]:
-        """``POST /v1/search`` body derived from ``config_model``."""
-        return build_request_model(self.config_model)

unique_search_proxy-2026.30.0.dev2/unique_search_proxy_client/web/core/search_engines/factory.py

@@ -0,0 +1,40 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any
+
+from unique_search_proxy_core.search_engines.base import SearchEngine, SearchEngineType
+
+from unique_search_proxy_client.web.core.search_engines.brave.service import (
+    BraveSearchService,
+)
+from unique_search_proxy_client.web.core.search_engines.google.service import (
+    GoogleSearchService,
+)
+from unique_search_proxy_client.web.core.search_engines.perplexity.service import (
+    PerplexitySearchService,
+)
+
+if TYPE_CHECKING:
+    from httpx import AsyncClient
+
+
+def get_search_engine_service(
+    engine: SearchEngineType,
+    *,
+    http_client: AsyncClient | None = None,
+) -> SearchEngine[Any]:
+    """Instantiate a search engine by registered id (deployment secrets from env)."""
+    match engine:
+        case SearchEngineType.GOOGLE:
+            return GoogleSearchService(http_client=http_client)
+        case SearchEngineType.BRAVE:
+            return BraveSearchService(http_client=http_client)
+        case SearchEngineType.PERPLEXITY:
+            return PerplexitySearchService(http_client=http_client)
+        case _:
+            raise ValueError(f"Unsupported search engine: {engine}")
+
+
+__all__ = [
+    "get_search_engine_service",
+]

{unique_search_proxy-2026.30.0.dev0 → unique_search_proxy-2026.30.0.dev2}/unique_search_proxy_client/web/core/search_engines/google/__init__.py

@@ -1,7 +1,4 @@
-from unique_search_proxy_core.search_engines.google.schema import (
-    GoogleConfig,
-    google_request_model,
-)
+from unique_search_proxy_core.search_engines.google.schema import GoogleConfig
 
 from unique_search_proxy_client.web.core.search_engines.google.query_params import (
     build_google_query_params,
@@ -14,5 +11,4 @@ __all__ = [
     "GoogleConfig",
     "GoogleSearchService",
     "build_google_query_params",
-    "google_request_model",
 ]

{unique_search_proxy-2026.30.0.dev0 → unique_search_proxy-2026.30.0.dev2}/unique_search_proxy_client/web/core/search_engines/google/query_params.py

@@ -17,14 +17,13 @@ def build_google_query_params(
     page: PageRequest,
 ) -> dict[str, Any]:
     """Assemble the Google API query string from the derived request + credentials."""
-    config = GoogleConfig()
     return {
         "q": query,
         "cx": search_engine_id,
         "key": api_key,
         "start": page.offset,
         "num": page.count,
-        **config.provider_query_params_from(request),
+        **GoogleConfig.provider_query_params(request),
     }
 
 

{unique_search_proxy-2026.30.0.dev0 → unique_search_proxy-2026.30.0.dev2}/unique_search_proxy_client/web/core/search_engines/google/service.py

@@ -19,7 +19,6 @@ from unique_search_proxy_core.search_engines.base import (
     get_search_engine_mode,
 )
 from unique_search_proxy_core.search_engines.google.schema import (
-    GoogleConfig,
     GoogleSearchRequest,
 )
 
@@ -154,18 +153,3 @@ class GoogleSearchService(SearchEngineService[GoogleSearchRequest]):
                 ),
             )
         return results
-
-    @staticmethod
-    def llm_call_schema(
-        config: GoogleConfig,
-        *,
-        strict_required: bool = True,
-    ) -> type[Any]:
-
-        from unique_search_proxy_core.projection import build_llm_call_model
-
-        return build_llm_call_model(
-            GoogleConfig,
-            config,
-            strict_required=strict_required,
-        )

{unique_search_proxy-2026.30.0.dev0 → unique_search_proxy-2026.30.0.dev2}/unique_search_proxy_client/web/core/search_engines/perplexity/__init__.py

@@ -1,7 +1,4 @@
-from unique_search_proxy_core.search_engines.perplexity.schema import (
-    PerplexityConfig,
-    perplexity_request_model,
-)
+from unique_search_proxy_core.search_engines.perplexity.schema import PerplexityConfig
 
 from unique_search_proxy_client.web.core.search_engines.perplexity.request_body import (
     build_perplexity_request_body,
@@ -14,5 +11,4 @@ __all__ = [
     "PerplexityConfig",
     "PerplexitySearchService",
     "build_perplexity_request_body",
-    "perplexity_request_model",
 ]

{unique_search_proxy-2026.30.0.dev0 → unique_search_proxy-2026.30.0.dev2}/unique_search_proxy_client/web/core/search_engines/perplexity/request_body.py

@@ -18,7 +18,6 @@ def build_perplexity_request_body(
     request: BaseModel,
 ) -> dict[str, Any]:
     """Assemble the Perplexity Search API JSON body from the derived request."""
-    config = PerplexityConfig()
     fetch_size = getattr(request, "fetch_size", PERPLEXITY_MAX_RESULTS)
     max_results = min(fetch_size, PERPLEXITY_MAX_RESULTS)
     if fetch_size > PERPLEXITY_MAX_RESULTS:
@@ -29,11 +28,29 @@ def build_perplexity_request_body(
             fetch_size,
             max_results,
         )
+    params = _apply_perplexity_api_rules(
+        PerplexityConfig.provider_query_params(request, by_alias=False),
+    )
     return {
         "query": query,
         "max_results": max_results,
-        **config.provider_query_params_from(request, by_alias=False),
+        **params,
     }
 
 
+def _apply_perplexity_api_rules(params: dict[str, Any]) -> dict[str, Any]:
+    """Enforce Perplexity API parameter constraints on the outgoing body.
+
+    The API rejects ``search_context_size`` when an explicit token limit
+    (``max_tokens`` / ``max_tokens_per_page``) is set, so the context size is
+    dropped in that case.
+    """
+    if (
+        params.get("max_tokens") is not None
+        or params.get("max_tokens_per_page") is not None
+    ):
+        params.pop("search_context_size", None)
+    return params
+
+
 __all__ = ["PERPLEXITY_MAX_RESULTS", "build_perplexity_request_body"]

{unique_search_proxy-2026.30.0.dev0 → unique_search_proxy-2026.30.0.dev2}/unique_search_proxy_client/web/core/search_engines/perplexity/service.py

@@ -19,7 +19,6 @@ from unique_search_proxy_core.search_engines.base import (
     get_search_engine_mode,
 )
 from unique_search_proxy_core.search_engines.perplexity.schema import (
-    PerplexityConfig,
     PerplexitySearchRequest,
 )
 
@@ -119,20 +118,6 @@ class PerplexitySearchService(SearchEngineService[PerplexitySearchRequest]):
             )
         return results
 
-    @staticmethod
-    def llm_call_schema(
-        config: PerplexityConfig,
-        *,
-        strict_required: bool = True,
-    ) -> type[Any]:
-        from unique_search_proxy_core.projection import build_llm_call_model
-
-        return build_llm_call_model(
-            PerplexityConfig,
-            config,
-            strict_required=strict_required,
-        )
-
 
 def _perplexity_headers(api_key: str) -> dict[str, str]:
     return {

unique_search_proxy-2026.30.0.dev0/unique_search_proxy_client/web/core/search_engines/factory.py

@@ -1,89 +0,0 @@
-from __future__ import annotations
-
-from typing import TYPE_CHECKING, Any
-
-from pydantic import BaseModel
-from unique_search_proxy_core.search_engines.base import SearchEngine, SearchEngineType
-from unique_search_proxy_core.search_engines.config_types import SearchEngineConfigTypes
-from unique_search_proxy_core.search_engines.params import merge_config_and_invocation
-
-from unique_search_proxy_client.web.core.search_engines.brave.service import (
-    BraveSearchService,
-)
-from unique_search_proxy_client.web.core.search_engines.google.service import (
-    GoogleSearchService,
-)
-from unique_search_proxy_client.web.core.search_engines.perplexity.service import (
-    PerplexitySearchService,
-)
-
-if TYPE_CHECKING:
-    from httpx import AsyncClient
-
-
-def get_search_engine_service(
-    engine: SearchEngineType,
-    *,
-    http_client: AsyncClient | None = None,
-) -> SearchEngine[Any]:
-    """Instantiate a search engine by registered id (deployment secrets from env)."""
-    match engine:
-        case SearchEngineType.GOOGLE:
-            return GoogleSearchService(http_client=http_client)
-        case SearchEngineType.BRAVE:
-            return BraveSearchService(http_client=http_client)
-        case SearchEngineType.PERPLEXITY:
-            return PerplexitySearchService(http_client=http_client)
-        case _:
-            raise ValueError(f"Unsupported search engine: {engine}")
-
-
-def resolve_engine_request(
-    config: SearchEngineConfigTypes,
-    invocation: dict[str, object],
-) -> BaseModel:
-    """Merge deployment config defaults with a partial request dict (callers / tests)."""
-    match config.engine:
-        case SearchEngineType.GOOGLE:
-            return merge_config_and_invocation(
-                config,
-                dict(invocation),
-                engine=SearchEngineType.GOOGLE,
-            )
-        case SearchEngineType.BRAVE:
-            return merge_config_and_invocation(
-                config,
-                dict(invocation),
-                engine=SearchEngineType.BRAVE,
-            )
-        case SearchEngineType.PERPLEXITY:
-            return merge_config_and_invocation(
-                config,
-                dict(invocation),
-                engine=SearchEngineType.PERPLEXITY,
-            )
-        case _:
-            raise ValueError(f"Unsupported search engine: {config.engine}")
-
-
-def get_request_model_for_engine(engine_id: str) -> type[BaseModel]:
-    from unique_search_proxy_client.web.core.registry import (
-        get_search_engine_descriptor,
-    )
-
-    descriptor = get_search_engine_descriptor(engine_id)
-    if descriptor is None:
-        raise ValueError(f"No descriptor for search engine: {engine_id}")
-    return descriptor.request_model
-
-
-# Backward-compatible alias
-resolve_engine_call = resolve_engine_request
-
-
-__all__ = [
-    "get_request_model_for_engine",
-    "get_search_engine_service",
-    "resolve_engine_call",
-    "resolve_engine_request",
-]