unique-search-proxy-core 2026.28.0.dev2__tar.gz → 2026.28.0.dev3__tar.gz

{unique_search_proxy_core-2026.28.0.dev2 → unique_search_proxy_core-2026.28.0.dev3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: unique-search-proxy-core
-Version: 2026.28.0.dev2
+Version: 2026.28.0.dev3
 Summary: Shared Pydantic types for the Unique Search Proxy API
 Author: ThePhilAz
 Author-email: ThePhilAz <rami.azouz@philico.com>
@@ -8,6 +8,7 @@ Requires-Dist: httpx>=0.28.0,<0.29
 Requires-Dist: pydantic>=2.12.5,<3.0.0
 Requires-Dist: pydantic-settings>=2.10.1,<3
 Requires-Dist: pyhumps>=3.8.0,<4
+Requires-Dist: unique-toolkit[monitoring]>=2026.28.0.dev12,<2026.28.0rc0
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 

{unique_search_proxy_core-2026.28.0.dev2 → unique_search_proxy_core-2026.28.0.dev3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "unique-search-proxy-core"
-version = "2026.28.0.dev2"
+version = "2026.28.0.dev3"
 description = "Shared Pydantic types for the Unique Search Proxy API"
 authors = [{ name = "ThePhilAz", email = "rami.azouz@philico.com" }]
 readme = "README.md"
@@ -10,6 +10,8 @@ dependencies = [
     "pydantic>=2.12.5,<3.0.0",
     "pydantic-settings>=2.10.1,<3",
     "pyhumps>=3.8.0,<4",
+    "unique-toolkit[monitoring]>=2026.28.0.dev12,<2026.28.0rc0",
+
 ]
 
 [dependency-groups]
@@ -59,3 +61,6 @@ depcheck = "deptry ."
 [tool.pytest.ini_options]
 addopts = "--strict-markers --import-mode=importlib"
 asyncio_mode = "auto"
+
+[tool.uv.sources]
+unique-toolkit = { workspace = true }

{unique_search_proxy_core-2026.28.0.dev2 → unique_search_proxy_core-2026.28.0.dev3}/unique_search_proxy_core/agent_engines/base.py

@@ -2,10 +2,11 @@ from __future__ import annotations
 
 from abc import ABC, abstractmethod
 from enum import StrEnum
-from typing import TYPE_CHECKING, AsyncIterator, Generic, TypeVar
+from typing import TYPE_CHECKING, Annotated, AsyncIterator, Generic, TypeVar
 
 from pydantic import BaseModel, Field
 from pydantic.json_schema import SkipJsonSchema
+from unique_toolkit._common.pydantic.rjsf_tags import RJSFMetaTag
 
 from unique_search_proxy_core.agent_engines.output_schema import AgentSearchOutput
 from unique_search_proxy_core.schema import (
@@ -47,7 +48,12 @@ class BaseAgentEngineConfig(BaseModel, Generic[T]):
     model_config = camelized_model_config
 
     engine: T
-    generation_instructions: str = Field(
+    generation_instructions: Annotated[
+        str,
+        RJSFMetaTag.StringWidget.textarea(
+            rows=10,
+        ),
+    ] = Field(
         default=DEFAULT_GENERATION_INSTRUCTIONS,
         description="Instructions injected into the grounding agent.",
     )

{unique_search_proxy_core-2026.28.0.dev2 → unique_search_proxy_core-2026.28.0.dev3}/unique_search_proxy_core/agent_engines/bing/schema.py

@@ -1,8 +1,9 @@
 from __future__ import annotations
 
-from typing import Literal
+from typing import Annotated, Literal
 
 from pydantic import BaseModel, Field
+from unique_toolkit._common.pydantic.rjsf_tags import RJSFMetaTag
 
 from unique_search_proxy_core.agent_engines.base import (
     AgentEngineType,
@@ -14,7 +15,9 @@ from unique_search_proxy_core.agent_engines.projection import build_agent_reques
 class BingAgentConfig(BaseAgentEngineConfig[Literal[AgentEngineType.BING]]):
     """Deployment + request defaults for Bing grounding via Azure AI Projects."""
 
-    engine: Literal[AgentEngineType.BING] = Field(
+    engine: Annotated[
+        Literal[AgentEngineType.BING], RJSFMetaTag.SpecialWidget.hidden()
+    ] = Field(
         default=AgentEngineType.BING,
         title="Agent engine",
         description="Provider discriminator; must be `bing` for this config.",

{unique_search_proxy_core-2026.28.0.dev2 → unique_search_proxy_core-2026.28.0.dev3}/unique_search_proxy_core/agent_engines/vertexai/schema.py

@@ -1,8 +1,9 @@
 from __future__ import annotations
 
-from typing import Literal
+from typing import Annotated, Literal
 
 from pydantic import BaseModel, Field
+from unique_toolkit._common.pydantic.rjsf_tags import RJSFMetaTag
 
 from unique_search_proxy_core.agent_engines.base import (
     AgentEngineType,
@@ -14,7 +15,9 @@ from unique_search_proxy_core.agent_engines.projection import build_agent_reques
 class VertexAIAgentConfig(BaseAgentEngineConfig[Literal[AgentEngineType.VERTEXAI]]):
     """Deployment + request defaults for Vertex AI grounding (Google GenAI)."""
 
-    engine: Literal[AgentEngineType.VERTEXAI] = Field(
+    engine: Annotated[
+        Literal[AgentEngineType.VERTEXAI], RJSFMetaTag.SpecialWidget.hidden()
+    ] = Field(
         default=AgentEngineType.VERTEXAI,
         title="Agent engine",
         description="Provider discriminator; must be `vertexai` for this config.",

{unique_search_proxy_core-2026.28.0.dev2 → unique_search_proxy_core-2026.28.0.dev3}/unique_search_proxy_core/search_engines/brave/schema.py

@@ -3,6 +3,7 @@ from __future__ import annotations
 from typing import Annotated, Literal, TypeAlias
 
 from pydantic import BaseModel, Field
+from unique_toolkit._common.pydantic.rjsf_tags import RJSFMetaTag
 
 from unique_search_proxy_core.param_policy.exposable_param import ExposableParam
 from unique_search_proxy_core.projection import build_request_model
@@ -15,9 +16,22 @@ from unique_search_proxy_core.search_engines.base import (
 BraveSafesearch: TypeAlias = Literal["off", "moderate", "strict"]
 BraveUnits: TypeAlias = Literal["metric", "imperial"]
 
-StrOrNone: TypeAlias = Annotated[str | None, DeactivatedNone]
-SafesearchOrNone: TypeAlias = Annotated[BraveSafesearch | None, DeactivatedNone]
-ResultFilterOrNone: TypeAlias = Annotated[list[str] | None, DeactivatedNone]
+GogglesOrNone: TypeAlias = (
+    Annotated[str, Field(title="String")]
+    | Annotated[list[str], Field(title="Array")]
+    | DeactivatedNone
+)
+
+BraveUnitsOrNone: TypeAlias = (
+    Annotated[BraveUnits, Field(title="Brave Units")] | DeactivatedNone
+)
+StrOrNone: TypeAlias = Annotated[str, Field(title="String")] | DeactivatedNone
+SafesearchOrNone: TypeAlias = (
+    Annotated[BraveSafesearch, Field(title="Brave Safe Search")] | DeactivatedNone
+)
+ResultFilterOrNone: TypeAlias = (
+    Annotated[list[str], Field(title="Result Filter")] | DeactivatedNone
+)
 
 ExposableStrOrNone = ExposableParam[StrOrNone]
 ExposableSafesearch = ExposableParam[SafesearchOrNone]
@@ -39,7 +53,9 @@ def _default_safesearch_exposable() -> ExposableSafesearch:
 class BraveConfig(BaseSearchEngineConfig[Literal[SearchEngineType.BRAVE]]):
     """Single source of truth for Brave deployment + derived request/LLM surfaces."""
 
-    engine: Literal[SearchEngineType.BRAVE] = Field(
+    engine: Annotated[
+        Literal[SearchEngineType.BRAVE], RJSFMetaTag.SpecialWidget.hidden()
+    ] = Field(
         default=SearchEngineType.BRAVE,
         title="Search engine",
         description="Provider discriminator; must be `brave` for this config.",
@@ -75,7 +91,7 @@ class BraveConfig(BaseSearchEngineConfig[Literal[SearchEngineType.BRAVE]]):
             "e.g. `en-US`. Distinct from `search_lang`."
         ),
     )
-    units: BraveUnits | None = Field(
+    units: BraveUnitsOrNone = Field(
         default=None,
         title="Measurement units",
         description="Measurement units for location-rich results: `metric` or `imperial`.",
@@ -90,7 +106,7 @@ class BraveConfig(BaseSearchEngineConfig[Literal[SearchEngineType.BRAVE]]):
         title="Include fetch metadata",
         description="Include fetch metadata in the Brave response.",
     )
-    goggles: str | list[str] | None = Field(
+    goggles: GogglesOrNone = Field(
         default=None,
         title="Goggles",
         description=(
@@ -99,7 +115,7 @@ class BraveConfig(BaseSearchEngineConfig[Literal[SearchEngineType.BRAVE]]):
     )
 
     country: ExposableStrOrNone = Field(
-        default_factory=_inactive_str_exposable,
+        default=_inactive_str_exposable(),
         title="Country",
         description=(
             "Two-letter ISO 3166-1 alpha-2 country code for result origin (Brave `country`). "
@@ -107,7 +123,7 @@ class BraveConfig(BaseSearchEngineConfig[Literal[SearchEngineType.BRAVE]]):
         ),
     )
     freshness: ExposableStrOrNone = Field(
-        default_factory=_inactive_str_exposable,
+        default=_inactive_str_exposable(),
         title="Freshness",
         description=(
             "Recency filter: `pd`, `pw`, `pm`, `py`, or `YYYY-MM-DDtoYYYY-MM-DD`. "
@@ -115,7 +131,7 @@ class BraveConfig(BaseSearchEngineConfig[Literal[SearchEngineType.BRAVE]]):
         ),
     )
     search_lang: ExposableStrOrNone = Field(
-        default_factory=_inactive_str_exposable,
+        default=_inactive_str_exposable(),
         alias="searchLang",
         title="Search language",
         description=(
@@ -124,7 +140,7 @@ class BraveConfig(BaseSearchEngineConfig[Literal[SearchEngineType.BRAVE]]):
         ),
     )
     safesearch: ExposableSafesearch = Field(
-        default_factory=_default_safesearch_exposable,
+        default=_default_safesearch_exposable(),
         title="Safe search",
         description=(
             "Adult content filter: `off`, `moderate` (API default), or `strict`. "
@@ -132,7 +148,7 @@ class BraveConfig(BaseSearchEngineConfig[Literal[SearchEngineType.BRAVE]]):
         ),
     )
     result_filter: ExposableResultFilter = Field(
-        default_factory=_inactive_result_filter_exposable,
+        default=_inactive_result_filter_exposable(),
         alias="resultFilter",
         title="Result filter",
         description=(

{unique_search_proxy_core-2026.28.0.dev2 → unique_search_proxy_core-2026.28.0.dev3}/unique_search_proxy_core/search_engines/google/schema.py

@@ -3,6 +3,7 @@ from __future__ import annotations
 from typing import Annotated, Literal, TypeAlias
 
 from pydantic import BaseModel, Field
+from unique_toolkit._common.pydantic.rjsf_tags import RJSFMetaTag
 
 from unique_search_proxy_core.param_policy.exposable_param import ExposableParam
 from unique_search_proxy_core.projection import build_request_model
@@ -15,10 +16,11 @@ from unique_search_proxy_core.search_engines.base import (
 GoogleSafeDefault: TypeAlias = Literal["active", "off"]
 GoogleSiteSearchFilter: TypeAlias = Literal["e", "i"]
 
-StrOrNone: TypeAlias = Annotated[str | None, DeactivatedNone]
-SiteSearchFilterOrNone: TypeAlias = Annotated[
-    GoogleSiteSearchFilter | None, DeactivatedNone
-]
+StrOrNone: TypeAlias = Annotated[str, Field(title="String")] | DeactivatedNone
+SiteSearchFilterOrNone: TypeAlias = (
+    Annotated[GoogleSiteSearchFilter, Field(title="Site Search Filter")]
+    | DeactivatedNone
+)
 
 ExposableStrOrNone = ExposableParam[StrOrNone]
 ExposableSiteSearchFilter = ExposableParam[SiteSearchFilterOrNone]
@@ -35,7 +37,9 @@ def _inactive_site_search_filter_exposable() -> ExposableSiteSearchFilter:
 class GoogleConfig(BaseSearchEngineConfig[Literal[SearchEngineType.GOOGLE]]):
     """Single source of truth for Google deployment + derived request/LLM surfaces."""
 
-    engine: Literal[SearchEngineType.GOOGLE] = Field(
+    engine: Annotated[
+        Literal[SearchEngineType.GOOGLE], RJSFMetaTag.SpecialWidget.hidden()
+    ] = Field(
         default=SearchEngineType.GOOGLE,
         title="Search engine",
         description="Provider discriminator; must be `google` for this config.",
@@ -61,7 +65,7 @@ class GoogleConfig(BaseSearchEngineConfig[Literal[SearchEngineType.GOOGLE]]):
     )
 
     gl: ExposableStrOrNone = Field(
-        default_factory=_inactive_str_exposable,
+        default=_inactive_str_exposable(),
         title="Geolocation (gl)",
         description=(
             "Two-letter ISO 3166-1 alpha-2 country code (Google `gl`). "
@@ -69,7 +73,7 @@ class GoogleConfig(BaseSearchEngineConfig[Literal[SearchEngineType.GOOGLE]]):
         ),
     )
     hl: ExposableStrOrNone = Field(
-        default_factory=_inactive_str_exposable,
+        default=_inactive_str_exposable(),
         title="Interface language (hl)",
         description=(
             "Language for snippets/UI (Google `hl`). "
@@ -77,7 +81,7 @@ class GoogleConfig(BaseSearchEngineConfig[Literal[SearchEngineType.GOOGLE]]):
         ),
     )
     lr: ExposableStrOrNone = Field(
-        default_factory=_inactive_str_exposable,
+        default=_inactive_str_exposable(),
         title="Language restrict (lr)",
         description=(
             "Document language restrict (Google `lr`), e.g. `lang_en`. "
@@ -85,7 +89,7 @@ class GoogleConfig(BaseSearchEngineConfig[Literal[SearchEngineType.GOOGLE]]):
         ),
     )
     date_restrict: ExposableStrOrNone = Field(
-        default_factory=_inactive_str_exposable,
+        default=_inactive_str_exposable(),
         alias="dateRestrict",
         title="Date restrict",
         description=(
@@ -94,7 +98,7 @@ class GoogleConfig(BaseSearchEngineConfig[Literal[SearchEngineType.GOOGLE]]):
         ),
     )
     exact_terms: ExposableStrOrNone = Field(
-        default_factory=_inactive_str_exposable,
+        default=_inactive_str_exposable(),
         alias="exactTerms",
         title="Exact terms",
         description=(
@@ -103,7 +107,7 @@ class GoogleConfig(BaseSearchEngineConfig[Literal[SearchEngineType.GOOGLE]]):
         ),
     )
     exclude_terms: ExposableStrOrNone = Field(
-        default_factory=_inactive_str_exposable,
+        default=_inactive_str_exposable(),
         alias="excludeTerms",
         title="Exclude terms",
         description=(
@@ -112,7 +116,7 @@ class GoogleConfig(BaseSearchEngineConfig[Literal[SearchEngineType.GOOGLE]]):
         ),
     )
     file_type: ExposableStrOrNone = Field(
-        default_factory=_inactive_str_exposable,
+        default=_inactive_str_exposable(),
         alias="fileType",
         title="File type",
         description=(
@@ -121,7 +125,7 @@ class GoogleConfig(BaseSearchEngineConfig[Literal[SearchEngineType.GOOGLE]]):
         ),
     )
     site_search: ExposableStrOrNone = Field(
-        default_factory=_inactive_str_exposable,
+        default=_inactive_str_exposable(),
         alias="siteSearch",
         title="Site search",
         description=(
@@ -130,7 +134,7 @@ class GoogleConfig(BaseSearchEngineConfig[Literal[SearchEngineType.GOOGLE]]):
         ),
     )
     site_search_filter: ExposableSiteSearchFilter = Field(
-        default_factory=_inactive_site_search_filter_exposable,
+        default=_inactive_site_search_filter_exposable(),
         alias="siteSearchFilter",
         title="Site search filter",
         description=(
@@ -139,7 +143,7 @@ class GoogleConfig(BaseSearchEngineConfig[Literal[SearchEngineType.GOOGLE]]):
         ),
     )
     sort: ExposableStrOrNone = Field(
-        default_factory=_inactive_str_exposable,
+        default=_inactive_str_exposable(),
         title="Sort",
         description=(
             "Sort expression (Google `sort`), e.g. `date`. "

{unique_search_proxy_core-2026.28.0.dev2 → unique_search_proxy_core-2026.28.0.dev3}/unique_search_proxy_core/search_engines/perplexity/schema.py

@@ -3,6 +3,7 @@ from __future__ import annotations
 from typing import Annotated, Literal, TypeAlias
 
 from pydantic import BaseModel, Field
+from unique_toolkit._common.pydantic.rjsf_tags import RJSFMetaTag
 
 from unique_search_proxy_core.param_policy.exposable_param import ExposableParam
 from unique_search_proxy_core.projection import build_request_model
@@ -15,19 +16,23 @@ from unique_search_proxy_core.search_engines.base import (
 PerplexitySearchContextSize: TypeAlias = Literal["low", "medium", "high"]
 PerplexityRecencyFilter: TypeAlias = Literal["hour", "day", "week", "month", "year"]
 
-
-IntOrNone: TypeAlias = Annotated[int | None, DeactivatedNone]
-
-StrOrNone: TypeAlias = Annotated[str | None, DeactivatedNone]
-SearchContextSizeOrNone: TypeAlias = Annotated[
-    PerplexitySearchContextSize | None,
-    DeactivatedNone,
-]
-RecencyFilterOrNone: TypeAlias = Annotated[
-    PerplexityRecencyFilter | None, DeactivatedNone
-]
-LanguageFilterOrNone: TypeAlias = Annotated[list[str] | None, DeactivatedNone]
-DomainFilterOrNone: TypeAlias = Annotated[list[str] | None, DeactivatedNone]
+IntOrNone: TypeAlias = (
+    Annotated[int, Field(title="Integer", ge=1, le=1_000_000)] | DeactivatedNone
+)
+StrOrNone: TypeAlias = Annotated[str, Field(title="String")] | DeactivatedNone
+SearchContextSizeOrNone: TypeAlias = (
+    Annotated[PerplexitySearchContextSize, Field(title="Search Context Size")]
+    | DeactivatedNone
+)
+RecencyFilterOrNone: TypeAlias = (
+    Annotated[PerplexityRecencyFilter, Field(title="Recency Filter")] | DeactivatedNone
+)
+LanguageFilterOrNone: TypeAlias = (
+    Annotated[list[str], Field(title="Language Filter")] | DeactivatedNone
+)
+DomainFilterOrNone: TypeAlias = (
+    Annotated[list[str], Field(title="Domain Filter")] | DeactivatedNone
+)
 
 ExposableStrOrNone = ExposableParam[StrOrNone]
 ExposableSearchContextSize = ExposableParam[SearchContextSizeOrNone]
@@ -63,7 +68,9 @@ class PerplexityConfig(BaseSearchEngineConfig[Literal[SearchEngineType.PERPLEXIT
     (``POST https://api.perplexity.ai/search``).
     """
 
-    engine: Literal[SearchEngineType.PERPLEXITY] = Field(
+    engine: Annotated[
+        Literal[SearchEngineType.PERPLEXITY], RJSFMetaTag.SpecialWidget.hidden()
+    ] = Field(
         default=SearchEngineType.PERPLEXITY,
         title="Search engine",
         description="Provider discriminator; must be `perplexity` for this config.",
@@ -71,8 +78,6 @@ class PerplexityConfig(BaseSearchEngineConfig[Literal[SearchEngineType.PERPLEXIT
 
     max_tokens: IntOrNone = Field(
         default=None,
-        ge=1,
-        le=1_000_000,
         title="Max tokens",
         description=(
             "Maximum total webpage content tokens across all results "
@@ -82,8 +87,6 @@ class PerplexityConfig(BaseSearchEngineConfig[Literal[SearchEngineType.PERPLEXIT
     )
     max_tokens_per_page: IntOrNone = Field(
         default=None,
-        ge=1,
-        le=1_000_000,
         alias="maxTokensPerPage",
         title="Max tokens per page",
         description=(
@@ -94,7 +97,7 @@ class PerplexityConfig(BaseSearchEngineConfig[Literal[SearchEngineType.PERPLEXIT
     )
 
     country: ExposableStrOrNone = Field(
-        default_factory=_inactive_str_exposable,
+        default=_inactive_str_exposable(),
         title="Country",
         description=(
             "ISO 3166-1 alpha-2 country code (Perplexity `country`, two letters). "
@@ -102,7 +105,7 @@ class PerplexityConfig(BaseSearchEngineConfig[Literal[SearchEngineType.PERPLEXIT
         ),
     )
     search_context_size: ExposableSearchContextSize = Field(
-        default_factory=_inactive_search_context_size_exposable,
+        default=_inactive_search_context_size_exposable(),
         alias="searchContextSize",
         title="Search context size",
         description=(
@@ -113,7 +116,7 @@ class PerplexityConfig(BaseSearchEngineConfig[Literal[SearchEngineType.PERPLEXIT
         ),
     )
     search_language_filter: ExposableLanguageFilter = Field(
-        default_factory=_inactive_language_filter_exposable,
+        default=_inactive_language_filter_exposable(),
         alias="searchLanguageFilter",
         title="Search language filter",
         description=(
@@ -122,7 +125,7 @@ class PerplexityConfig(BaseSearchEngineConfig[Literal[SearchEngineType.PERPLEXIT
         ),
     )
     search_domain_filter: ExposableDomainFilter = Field(
-        default_factory=_inactive_domain_filter_exposable,
+        default=_inactive_domain_filter_exposable(),
         alias="searchDomainFilter",
         title="Search domain filter",
         description=(
@@ -131,7 +134,7 @@ class PerplexityConfig(BaseSearchEngineConfig[Literal[SearchEngineType.PERPLEXIT
         ),
     )
     search_recency_filter: ExposableRecencyFilter = Field(
-        default_factory=_inactive_recency_filter_exposable,
+        default=_inactive_recency_filter_exposable(),
         alias="searchRecencyFilter",
         title="Search recency filter",
         description=(
@@ -140,7 +143,7 @@ class PerplexityConfig(BaseSearchEngineConfig[Literal[SearchEngineType.PERPLEXIT
         ),
     )
     last_updated_after_filter: ExposableStrOrNone = Field(
-        default_factory=_inactive_str_exposable,
+        default=_inactive_str_exposable(),
         alias="lastUpdatedAfterFilter",
         title="Last updated after",
         description=(
@@ -149,7 +152,7 @@ class PerplexityConfig(BaseSearchEngineConfig[Literal[SearchEngineType.PERPLEXIT
         ),
     )
     last_updated_before_filter: ExposableStrOrNone = Field(
-        default_factory=_inactive_str_exposable,
+        default=_inactive_str_exposable(),
         alias="lastUpdatedBeforeFilter",
         title="Last updated before",
         description=(
@@ -158,7 +161,7 @@ class PerplexityConfig(BaseSearchEngineConfig[Literal[SearchEngineType.PERPLEXIT
         ),
     )
     search_after_date_filter: ExposableStrOrNone = Field(
-        default_factory=_inactive_str_exposable,
+        default=_inactive_str_exposable(),
         alias="searchAfterDateFilter",
         title="Search after date",
         description=(
@@ -167,7 +170,7 @@ class PerplexityConfig(BaseSearchEngineConfig[Literal[SearchEngineType.PERPLEXIT
         ),
     )
     search_before_date_filter: ExposableStrOrNone = Field(
-        default_factory=_inactive_str_exposable,
+        default=_inactive_str_exposable(),
         alias="searchBeforeDateFilter",
         title="Search before date",
         description=(