unique-search-proxy 2026.26.0.dev8__tar.gz → 2026.26.0.dev9__tar.gz

unique_search_proxy-2026.26.0.dev9/PKG-INFO

@@ -0,0 +1,326 @@
+Metadata-Version: 2.3
+Name: unique-search-proxy
+Version: 2026.26.0.dev9
+Summary: Web Search Proxy implementation
+Author: ThePhilAz
+Author-email: ThePhilAz <rami.azouz@philico.com>
+Requires-Dist: fastapi>=0.115.0,<1.0.0
+Requires-Dist: starlette>=0.41.0,<1.0.0
+Requires-Dist: uvicorn[standard]>=0.32.0,<1.0.0
+Requires-Dist: pydantic>=2.12.5,<3.0.0
+Requires-Dist: httpx>=0.28.0,<0.29.0
+Requires-Dist: python-dotenv>=1.2.1,<2.0.0
+Requires-Dist: pydantic-settings>=2.12.0,<3.0.0
+Requires-Dist: markdownify>=0.14.1,<1
+Requires-Dist: azure-ai-projects>=1.0.0,<2
+Requires-Dist: azure-identity>=1.25.0,<2
+Requires-Dist: azure-core>=1.36.0,<2
+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: unique-toolkit[monitoring]>=2026.26.0.dev11,<2026.26.0rc0
+Requires-Dist: unique-search-proxy-core>=2026.26.0.dev5,<2026.26.0rc0
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# unique-search-proxy (client)
+
+Part of [Unique Search Proxy](../README.md) · PyPI: `unique-search-proxy` · Helm: `unique-search-proxy`
+
+---
+
+## 1. What this package is
+
+**The client is the proxy pod.** It is the only deployable service in the stack — a FastAPI application that owns secrets, outbound networking, provider adapters, and observability.
+
+Platform services do not talk to Google or Tavily directly. They call this server's HTTP API (usually via the [SDK](../unique_search_proxy_sdk/README.md)). Shared types and config models come from [core](../unique_search_proxy_core/README.md).
+
+| Package | Question it answers |
+|---------|---------------------|
+| [Core](../unique_search_proxy_core/README.md) | *What* can be configured and *what* does a valid request/response look like? |
+| **Client** (this) | *How* are provider calls executed at runtime? |
+| [SDK](../unique_search_proxy_sdk/README.md) | *How* do callers reach the proxy over HTTP? |
+
+---
+
+## 2. Role in the system
+
+```mermaid
+flowchart LR
+    SDK["unique_search_proxy_sdk"]
+    Client["unique_search_proxy_client\n(this package)"]
+    Core["unique_search_proxy_core"]
+    Pool["HttpClientPool"]
+    Providers["Google · Brave · Bing · …"]
+
+    SDK -->|"POST /v1/*"| Client
+    Client --> Core
+    Client --> Pool
+    Pool --> Providers
+    Client --> Providers
+```
+
+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.
+
+---
+
+## 3. Internal architecture
+
+Requests flow through four layers inside the FastAPI app:
+
+```mermaid
+flowchart TB
+    subgraph client_pkg["unique_search_proxy_client.web"]
+        API["api/ — route handlers"]
+        Reg["core/registry.py — provider lookup"]
+        Svc["core/*/service.py — provider adapters"]
+        Pool["core/client/ — HttpClientPool"]
+        Settings["settings/ — env & secrets"]
+        Mon["monitoring/ — Prometheus"]
+    end
+
+    API --> Reg
+    Reg --> Svc
+    Svc --> Pool
+    Svc --> Settings
+    API --> Mon
+```
+
+| Layer | Path | Responsibility |
+|-------|------|----------------|
+| **Entry** | `app.py` | App factory, lifespan (start/stop pool), router mount |
+| **API** | `api/health.py`, `api/v1/*.py` | Validate body via core models, dispatch, record metrics |
+| **Registry** | `core/registry.py`, `core/providers.py` | Register built-in engines/crawlers at startup |
+| **Services** | `core/search_engines/`, `core/agent_engines/`, `core/crawlers/` | Provider-specific HTTP/SDK calls, response curation |
+| **Egress** | `core/client/service.py` | Shared httpx client (optional corporate proxy / mTLS) |
+| **Settings** | `settings/providers/*`, `settings/client.py` | Per-provider credentials; unset → `NOT_PROVIDED` → 503 |
+| **Monitoring** | `monitoring/` | Search / agent / crawl latency and error counters |
+| **Deploy** | `deploy/` | Dockerfile, Helm chart, uvicorn entrypoint |
+
+Built-in providers register in `register_builtin_providers()` during `create_app()`.
+
+---
+
+## 4. HTTP API
+
+| Endpoint | Description |
+|----------|-------------|
+| `GET /health` | Liveness |
+| `GET /ready` | Readiness (httpx pool + registered providers) |
+| `GET /v1/configuration/providers` | Registered search engine, agent engine, and crawler ids |
+| `POST /v1/search` | Standard search (flat body: `engine`, `query`, provider params, `timeout`) |
+| `POST /v1/agent-search` | Grounded agent search — opaque `answer` + `raw` |
+| `POST /v1/agent-search/stream` | Same, streamed as SSE (`delta` + `done`) |
+| `POST /v1/crawl` | Crawl URLs (flat body: `crawler`, `urls`, `timeout`, …) |
+| `GET /metrics` | Prometheus (when enabled) |
+| `/docs` | Swagger UI with preset examples |
+
+OpenAPI spec: `openapi.json` (input for [SDK codegen](../unique_search_proxy_sdk/README.md)).
+
+---
+
+## 5. Providers
+
+### 5.1 Summary
+
+| Provider | Type | Upstream | Credentials |
+|----------|------|----------|-------------|
+| Google | Search | Custom Search JSON API | `GOOGLE_SEARCH_API_KEY`, `GOOGLE_SEARCH_ENGINE_ID` |
+| Brave | Search | Brave Search API | `BRAVE_SEARCH_API_KEY` |
+| Perplexity | Search | Perplexity API | `PERPLEXITY_SEARCH_API_KEY` |
+| Bing | Agent | Azure AI Projects grounding | `BING_AGENT_*` |
+| VertexAI | Agent | Google GenAI + grounding | `VERTEXAI_AGENT_*` or ADC |
+| Basic | Crawl | Direct httpx + HTML/PDF processors | (none) |
+| Tavily | Crawl | Tavily extract API | `TAVILY_API_KEY` |
+| Jina | Crawl | Jina Reader API | `JINA_API_KEY` |
+| Firecrawl | Crawl | Firecrawl scrape (with polling) | `FIRECRAWL_API_KEY` |
+
+Unconfigured providers return **503** `ENGINE_NOT_CONFIGURED` with missing env var names. `GET /v1/configuration/providers` lists what is registered in the running pod.
+
+### 5.2 Search (`POST /v1/search`)
+
+Flat request — tooling merges deployment config with LLM args in **core** before calling the proxy:
+
+```json
+{
+  "engine": "google",
+  "query": "example query",
+  "fetchSize": 10,
+  "gl": "de",
+  "dateRestrict": "d7",
+  "timeout": 30
+}
+```
+
+Response includes **curated** normalised results and opaque **raw** provider payload:
+
+```json
+{
+  "engine": "google",
+  "query": "example query",
+  "raw": { "pages": [{ "pageIndex": 1, "response": {} }] },
+  "curated": [
+    { "url": "https://example.com", "title": "Example", "snippet": "...", "content": "" }
+  ]
+}
+```
+
+### 5.3 Agent search (`POST /v1/agent-search`)
+
+Thin egress — proxy returns opaque agent text; callers own parsing and citation extraction:
+
+```json
+{
+  "engine": "bing",
+  "query": "latest EU AI Act timeline",
+  "generationInstructions": "...",
+  "fetchSize": 5,
+  "timeout": 120
+}
+```
+
+Streaming (`/v1/agent-search/stream`) emits SSE `{ "type": "delta", "text": "..." }` chunks and a terminal `{ "type": "done", "response": { … } }`.
+
+### 5.4 Crawl (`POST /v1/crawl`)
+
+Per-URL outcomes — one URL failing does not fail the batch:
+
+```json
+{
+  "urls": ["https://example.com"],
+  "crawler": "Basic",
+  "timeout": 30
+}
+```
+
+Crawler discriminators: `Basic`, `Tavily`, `Jina`, `Firecrawl`.
+
+### 5.5 Errors
+
+Structured envelope on all non-2xx responses:
+
+```json
+{
+  "error": {
+    "code": "ENGINE_NOT_CONFIGURED",
+    "message": "Provider is not configured. Set environment variable(s): GOOGLE_SEARCH_API_KEY",
+    "retryable": false
+  }
+}
+```
+
+Error types are defined in [core](../unique_search_proxy_core/README.md) and raised by the [SDK](../unique_search_proxy_sdk/README.md) on the caller side.
+
+---
+
+## 6. Configuration
+
+Settings use pydantic-settings with per-provider env vars. Copy `.env.example` to `.env` for an annotated template.
+
+| Component | Prefix / vars | Example |
+|-----------|---------------|---------|
+| Google search | (none) | `GOOGLE_SEARCH_API_KEY`, `GOOGLE_SEARCH_ENGINE_ID` |
+| Brave search | (none) | `BRAVE_SEARCH_API_KEY`, `BRAVE_SEARCH_API_ENDPOINT` |
+| Perplexity | (none) | `PERPLEXITY_SEARCH_API_KEY` |
+| Tavily | `TAVILY_` | `TAVILY_API_KEY` |
+| Jina | `JINA_` | `JINA_API_KEY`, `JINA_DEPLOYMENT` |
+| Firecrawl | `FIRECRAWL_` | `FIRECRAWL_API_KEY`, `FIRECRAWL_API_VERSION` |
+| Bing agent | `BING_AGENT_` | `BING_AGENT_ENDPOINT`, `BING_AGENT_BING_RESOURCE_CONNECTION_STRING` |
+| VertexAI agent | `VERTEXAI_AGENT_` | `VERTEXAI_AGENT_SERVICE_ACCOUNT_CREDENTIALS` (optional) |
+| HTTP client | `HTTP_CLIENT_` | `HTTP_CLIENT_PROXY_HOST`, `HTTP_CLIENT_POOL_TIMEOUT_SECONDS` |
+| Prometheus | `PROMETHEUS_` | `PROMETHEUS_ENABLED` |
+| Container | (shell) | `HOST`, `PORT`, `WORKERS`, `LOG_LEVEL` |
+
+With `WORKERS > 1`, the entrypoint sets `PROMETHEUS_MULTIPROC_DIR` for correct metric aggregation.
+
+---
+
+## 7. Quick start
+
+**Prerequisites:** Python 3.12+, uv
+
+```bash
+uv sync
+cp .env.example .env
+# Edit .env: set GOOGLE_SEARCH_API_KEY and GOOGLE_SEARCH_ENGINE_ID for live /v1/search
+```
+
+```bash
+uv run python -m unique_search_proxy_client.web.app
+# or
+uv run uvicorn unique_search_proxy_client.web.app:app --reload --port 2349
+```
+
+Call from Python via the [SDK](../unique_search_proxy_sdk/README.md):
+
+```python
+from unique_search_proxy_sdk import UniqueSearchProxyClient
+
+async with UniqueSearchProxyClient("http://localhost:2349") as client:
+    result = await client.search.search("unique ag", engine="google", fetchSize=10)
+```
+
+Regenerate SDK after API changes:
+
+```bash
+uv run python scripts/generate_sdk.py
+```
+
+---
+
+## 8. Dev testing
+
+1. Start the server and configure `.env`.
+2. **Swagger** — `/docs` → **Try it out** on `/v1/search` or `/v1/crawl` → pick an **Examples** preset.
+3. **CLI** — same presets from the terminal:
+
+```bash
+uv run python scripts/try_presets.py list
+uv run python scripts/try_presets.py run google_minimal
+uv run python scripts/try_presets.py run-all --kind crawl
+uv run python scripts/try_presets.py run google_minimal --base-url http://127.0.0.1:8080
+```
+
+Presets live in `web/presets/` (shared with Swagger examples). Add `--strict` to exit non-zero on any non-2xx response.
+
+---
+
+## 9. Project structure
+
+```
+unique_search_proxy_client/
+├── openapi.json              # Exported spec (SDK codegen input)
+├── scripts/
+│   ├── generate_sdk.py
+│   └── try_presets.py
+├── deploy/                   # Dockerfile, Helm chart
+├── tests/
+└── unique_search_proxy_client/web/
+    ├── app.py
+    ├── api/                  # health + v1 routes
+    ├── core/                 # registry, services, HttpClientPool
+    ├── settings/             # env & provider credentials
+    ├── monitoring/
+    └── presets/
+```
+
+---
+
+## 10. Development
+
+```bash
+uv run ruff check .
+uv run ruff format .
+uv run pytest
+uv run basedpyright
+```
+
+---
+
+## License
+
+Proprietary — Unique AG

unique_search_proxy-2026.26.0.dev9/README.md

@@ -0,0 +1,301 @@
+# unique-search-proxy (client)
+
+Part of [Unique Search Proxy](../README.md) · PyPI: `unique-search-proxy` · Helm: `unique-search-proxy`
+
+---
+
+## 1. What this package is
+
+**The client is the proxy pod.** It is the only deployable service in the stack — a FastAPI application that owns secrets, outbound networking, provider adapters, and observability.
+
+Platform services do not talk to Google or Tavily directly. They call this server's HTTP API (usually via the [SDK](../unique_search_proxy_sdk/README.md)). Shared types and config models come from [core](../unique_search_proxy_core/README.md).
+
+| Package | Question it answers |
+|---------|---------------------|
+| [Core](../unique_search_proxy_core/README.md) | *What* can be configured and *what* does a valid request/response look like? |
+| **Client** (this) | *How* are provider calls executed at runtime? |
+| [SDK](../unique_search_proxy_sdk/README.md) | *How* do callers reach the proxy over HTTP? |
+
+---
+
+## 2. Role in the system
+
+```mermaid
+flowchart LR
+    SDK["unique_search_proxy_sdk"]
+    Client["unique_search_proxy_client\n(this package)"]
+    Core["unique_search_proxy_core"]
+    Pool["HttpClientPool"]
+    Providers["Google · Brave · Bing · …"]
+
+    SDK -->|"POST /v1/*"| Client
+    Client --> Core
+    Client --> Pool
+    Pool --> Providers
+    Client --> Providers
+```
+
+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.
+
+---
+
+## 3. Internal architecture
+
+Requests flow through four layers inside the FastAPI app:
+
+```mermaid
+flowchart TB
+    subgraph client_pkg["unique_search_proxy_client.web"]
+        API["api/ — route handlers"]
+        Reg["core/registry.py — provider lookup"]
+        Svc["core/*/service.py — provider adapters"]
+        Pool["core/client/ — HttpClientPool"]
+        Settings["settings/ — env & secrets"]
+        Mon["monitoring/ — Prometheus"]
+    end
+
+    API --> Reg
+    Reg --> Svc
+    Svc --> Pool
+    Svc --> Settings
+    API --> Mon
+```
+
+| Layer | Path | Responsibility |
+|-------|------|----------------|
+| **Entry** | `app.py` | App factory, lifespan (start/stop pool), router mount |
+| **API** | `api/health.py`, `api/v1/*.py` | Validate body via core models, dispatch, record metrics |
+| **Registry** | `core/registry.py`, `core/providers.py` | Register built-in engines/crawlers at startup |
+| **Services** | `core/search_engines/`, `core/agent_engines/`, `core/crawlers/` | Provider-specific HTTP/SDK calls, response curation |
+| **Egress** | `core/client/service.py` | Shared httpx client (optional corporate proxy / mTLS) |
+| **Settings** | `settings/providers/*`, `settings/client.py` | Per-provider credentials; unset → `NOT_PROVIDED` → 503 |
+| **Monitoring** | `monitoring/` | Search / agent / crawl latency and error counters |
+| **Deploy** | `deploy/` | Dockerfile, Helm chart, uvicorn entrypoint |
+
+Built-in providers register in `register_builtin_providers()` during `create_app()`.
+
+---
+
+## 4. HTTP API
+
+| Endpoint | Description |
+|----------|-------------|
+| `GET /health` | Liveness |
+| `GET /ready` | Readiness (httpx pool + registered providers) |
+| `GET /v1/configuration/providers` | Registered search engine, agent engine, and crawler ids |
+| `POST /v1/search` | Standard search (flat body: `engine`, `query`, provider params, `timeout`) |
+| `POST /v1/agent-search` | Grounded agent search — opaque `answer` + `raw` |
+| `POST /v1/agent-search/stream` | Same, streamed as SSE (`delta` + `done`) |
+| `POST /v1/crawl` | Crawl URLs (flat body: `crawler`, `urls`, `timeout`, …) |
+| `GET /metrics` | Prometheus (when enabled) |
+| `/docs` | Swagger UI with preset examples |
+
+OpenAPI spec: `openapi.json` (input for [SDK codegen](../unique_search_proxy_sdk/README.md)).
+
+---
+
+## 5. Providers
+
+### 5.1 Summary
+
+| Provider | Type | Upstream | Credentials |
+|----------|------|----------|-------------|
+| Google | Search | Custom Search JSON API | `GOOGLE_SEARCH_API_KEY`, `GOOGLE_SEARCH_ENGINE_ID` |
+| Brave | Search | Brave Search API | `BRAVE_SEARCH_API_KEY` |
+| Perplexity | Search | Perplexity API | `PERPLEXITY_SEARCH_API_KEY` |
+| Bing | Agent | Azure AI Projects grounding | `BING_AGENT_*` |
+| VertexAI | Agent | Google GenAI + grounding | `VERTEXAI_AGENT_*` or ADC |
+| Basic | Crawl | Direct httpx + HTML/PDF processors | (none) |
+| Tavily | Crawl | Tavily extract API | `TAVILY_API_KEY` |
+| Jina | Crawl | Jina Reader API | `JINA_API_KEY` |
+| Firecrawl | Crawl | Firecrawl scrape (with polling) | `FIRECRAWL_API_KEY` |
+
+Unconfigured providers return **503** `ENGINE_NOT_CONFIGURED` with missing env var names. `GET /v1/configuration/providers` lists what is registered in the running pod.
+
+### 5.2 Search (`POST /v1/search`)
+
+Flat request — tooling merges deployment config with LLM args in **core** before calling the proxy:
+
+```json
+{
+  "engine": "google",
+  "query": "example query",
+  "fetchSize": 10,
+  "gl": "de",
+  "dateRestrict": "d7",
+  "timeout": 30
+}
+```
+
+Response includes **curated** normalised results and opaque **raw** provider payload:
+
+```json
+{
+  "engine": "google",
+  "query": "example query",
+  "raw": { "pages": [{ "pageIndex": 1, "response": {} }] },
+  "curated": [
+    { "url": "https://example.com", "title": "Example", "snippet": "...", "content": "" }
+  ]
+}
+```
+
+### 5.3 Agent search (`POST /v1/agent-search`)
+
+Thin egress — proxy returns opaque agent text; callers own parsing and citation extraction:
+
+```json
+{
+  "engine": "bing",
+  "query": "latest EU AI Act timeline",
+  "generationInstructions": "...",
+  "fetchSize": 5,
+  "timeout": 120
+}
+```
+
+Streaming (`/v1/agent-search/stream`) emits SSE `{ "type": "delta", "text": "..." }` chunks and a terminal `{ "type": "done", "response": { … } }`.
+
+### 5.4 Crawl (`POST /v1/crawl`)
+
+Per-URL outcomes — one URL failing does not fail the batch:
+
+```json
+{
+  "urls": ["https://example.com"],
+  "crawler": "Basic",
+  "timeout": 30
+}
+```
+
+Crawler discriminators: `Basic`, `Tavily`, `Jina`, `Firecrawl`.
+
+### 5.5 Errors
+
+Structured envelope on all non-2xx responses:
+
+```json
+{
+  "error": {
+    "code": "ENGINE_NOT_CONFIGURED",
+    "message": "Provider is not configured. Set environment variable(s): GOOGLE_SEARCH_API_KEY",
+    "retryable": false
+  }
+}
+```
+
+Error types are defined in [core](../unique_search_proxy_core/README.md) and raised by the [SDK](../unique_search_proxy_sdk/README.md) on the caller side.
+
+---
+
+## 6. Configuration
+
+Settings use pydantic-settings with per-provider env vars. Copy `.env.example` to `.env` for an annotated template.
+
+| Component | Prefix / vars | Example |
+|-----------|---------------|---------|
+| Google search | (none) | `GOOGLE_SEARCH_API_KEY`, `GOOGLE_SEARCH_ENGINE_ID` |
+| Brave search | (none) | `BRAVE_SEARCH_API_KEY`, `BRAVE_SEARCH_API_ENDPOINT` |
+| Perplexity | (none) | `PERPLEXITY_SEARCH_API_KEY` |
+| Tavily | `TAVILY_` | `TAVILY_API_KEY` |
+| Jina | `JINA_` | `JINA_API_KEY`, `JINA_DEPLOYMENT` |
+| Firecrawl | `FIRECRAWL_` | `FIRECRAWL_API_KEY`, `FIRECRAWL_API_VERSION` |
+| Bing agent | `BING_AGENT_` | `BING_AGENT_ENDPOINT`, `BING_AGENT_BING_RESOURCE_CONNECTION_STRING` |
+| VertexAI agent | `VERTEXAI_AGENT_` | `VERTEXAI_AGENT_SERVICE_ACCOUNT_CREDENTIALS` (optional) |
+| HTTP client | `HTTP_CLIENT_` | `HTTP_CLIENT_PROXY_HOST`, `HTTP_CLIENT_POOL_TIMEOUT_SECONDS` |
+| Prometheus | `PROMETHEUS_` | `PROMETHEUS_ENABLED` |
+| Container | (shell) | `HOST`, `PORT`, `WORKERS`, `LOG_LEVEL` |
+
+With `WORKERS > 1`, the entrypoint sets `PROMETHEUS_MULTIPROC_DIR` for correct metric aggregation.
+
+---
+
+## 7. Quick start
+
+**Prerequisites:** Python 3.12+, uv
+
+```bash
+uv sync
+cp .env.example .env
+# Edit .env: set GOOGLE_SEARCH_API_KEY and GOOGLE_SEARCH_ENGINE_ID for live /v1/search
+```
+
+```bash
+uv run python -m unique_search_proxy_client.web.app
+# or
+uv run uvicorn unique_search_proxy_client.web.app:app --reload --port 2349
+```
+
+Call from Python via the [SDK](../unique_search_proxy_sdk/README.md):
+
+```python
+from unique_search_proxy_sdk import UniqueSearchProxyClient
+
+async with UniqueSearchProxyClient("http://localhost:2349") as client:
+    result = await client.search.search("unique ag", engine="google", fetchSize=10)
+```
+
+Regenerate SDK after API changes:
+
+```bash
+uv run python scripts/generate_sdk.py
+```
+
+---
+
+## 8. Dev testing
+
+1. Start the server and configure `.env`.
+2. **Swagger** — `/docs` → **Try it out** on `/v1/search` or `/v1/crawl` → pick an **Examples** preset.
+3. **CLI** — same presets from the terminal:
+
+```bash
+uv run python scripts/try_presets.py list
+uv run python scripts/try_presets.py run google_minimal
+uv run python scripts/try_presets.py run-all --kind crawl
+uv run python scripts/try_presets.py run google_minimal --base-url http://127.0.0.1:8080
+```
+
+Presets live in `web/presets/` (shared with Swagger examples). Add `--strict` to exit non-zero on any non-2xx response.
+
+---
+
+## 9. Project structure
+
+```
+unique_search_proxy_client/
+├── openapi.json              # Exported spec (SDK codegen input)
+├── scripts/
+│   ├── generate_sdk.py
+│   └── try_presets.py
+├── deploy/                   # Dockerfile, Helm chart
+├── tests/
+└── unique_search_proxy_client/web/
+    ├── app.py
+    ├── api/                  # health + v1 routes
+    ├── core/                 # registry, services, HttpClientPool
+    ├── settings/             # env & provider credentials
+    ├── monitoring/
+    └── presets/
+```
+
+---
+
+## 10. Development
+
+```bash
+uv run ruff check .
+uv run ruff format .
+uv run pytest
+uv run basedpyright
+```
+
+---
+
+## License
+
+Proprietary — Unique AG

{unique_search_proxy-2026.26.0.dev8 → unique_search_proxy-2026.26.0.dev9}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "unique-search-proxy"
-version = "2026.26.0.dev8"
+version = "2026.26.0.dev9"
 description = "Web Search Proxy implementation"
 authors = [{ name = "ThePhilAz", email = "rami.azouz@philico.com" }]
 readme = "README.md"
@@ -14,8 +14,14 @@ dependencies = [
     "python-dotenv>=1.2.1,<2.0.0",
     "pydantic-settings>=2.12.0,<3.0.0",
     "markdownify>=0.14.1,<1",
-    "unique-toolkit[monitoring]>=2026.26.0.dev7,<2026.26.0rc0",
-    "unique-search-proxy-core>=2026.26.0.dev4,<2026.26.0rc0",
+    "azure-ai-projects>=1.0.0,<2",
+    "azure-identity>=1.25.0,<2",
+    "azure-core>=1.36.0,<2",
+    "certifi>=2025.11.12,<2027",
+    "google-genai>=1.73.0,<2",
+    "google-auth>=2.43.0,<3",
+    "unique-toolkit[monitoring]>=2026.26.0.dev11,<2026.26.0rc0",
+    "unique-search-proxy-core>=2026.26.0.dev5,<2026.26.0rc0",
 ]
 
 [dependency-groups]

{unique_search_proxy-2026.26.0.dev8 → unique_search_proxy-2026.26.0.dev9}/unique_search_proxy_client/web/api/health.py

@@ -4,6 +4,7 @@ from fastapi import APIRouter, Request
 
 from unique_search_proxy_client.web.core.client import get_http_client_pool
 from unique_search_proxy_client.web.core.registry import (
+    registered_agent_engines,
     registered_crawlers,
     registered_search_engines,
 )
@@ -23,5 +24,6 @@ async def ready(request: Request) -> dict[str, object]:
         "status": "ready",
         "httpClient": "ok" if not pool.client.is_closed else "closed",
         "searchEngines": sorted(registered_search_engines()),
+        "agentEngines": sorted(registered_agent_engines()),
         "crawlers": sorted(registered_crawlers()),
     }

{unique_search_proxy-2026.26.0.dev8 → unique_search_proxy-2026.26.0.dev9}/unique_search_proxy_client/web/api/v1/__init__.py

@@ -1,5 +1,8 @@
 from fastapi import APIRouter
 
+from unique_search_proxy_client.web.api.v1.agent_search import (
+    router as agent_search_router,
+)
 from unique_search_proxy_client.web.api.v1.configuration import (
     router as configuration_router,
 )
@@ -9,6 +12,7 @@ from unique_search_proxy_client.web.api.v1.search import router as search_router
 v1_router = APIRouter(prefix="/v1")
 v1_router.include_router(configuration_router)
 v1_router.include_router(search_router)
+v1_router.include_router(agent_search_router)
 v1_router.include_router(crawl_router)
 
 __all__ = ["v1_router"]