unique-search-proxy 2026.24.0.dev3__tar.gz → 2026.26.0.dev1__tar.gz

unique_search_proxy-2026.26.0.dev1/PKG-INFO

@@ -0,0 +1,275 @@
+Metadata-Version: 2.3
+Name: unique-search-proxy
+Version: 2026.26.0.dev1
+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: unique-toolkit[monitoring]>=2026.26.0.dev1,<2026.26.0rc0
+Requires-Dist: unique-search-proxy-core>=2026.26.0.dev0,<2026.26.0rc0
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# Unique Search Proxy
+
+Unified web egress proxy for search engines and crawlers. **Three publishable packages** in this repo:
+
+| PyPI name | Module | Role |
+|-----------|--------|------|
+| `unique-search-proxy` | `unique_search_proxy_client.web` | FastAPI server (proxy pod) |
+| `unique-search-proxy-sdk` | `unique_search_proxy_sdk` | Async HTTP client for callers |
+| `unique-search-proxy-core` | `unique_search_proxy_core` | Shared Pydantic types (no FastAPI) |
+
+```mermaid
+flowchart LR
+  subgraph caller["Caller pod"]
+    SDK["unique_search_proxy_sdk"]
+  end
+  subgraph proxy["Proxy pod"]
+    API["unique_search_proxy_client.web"]
+    Pool["HttpClientPool"]
+  end
+  Core["unique_search_proxy_core"]
+  Internet["Google / public web"]
+  SDK --> Core
+  API --> Core
+  SDK -->|"POST /v1/search"| API
+  API --> Pool
+  Pool --> Internet
+```
+
+- **Server** owns registry, secrets, Prometheus, and egress (`HttpClientPool`).
+- **SDK** wraps the [OpenAPI](http://localhost:2349/docs) contract; depends on **core** for `GoogleConfig`, errors, etc.
+- **Core** is server-free and safe to install without FastAPI/uvicorn.
+
+## Quick Start
+
+### Prerequisites
+
+- Python 3.12+
+- uv for dependency management
+
+### Installation
+
+```bash
+uv sync
+cp .env.example .env
+# Edit .env: set GOOGLE_SEARCH_API_KEY and GOOGLE_SEARCH_ENGINE_ID for live /v1/search
+```
+
+### Running
+
+```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
+```
+
+## Python SDK (`unique-search-proxy-sdk`)
+
+Workspace path: `connectors/unique_search_proxy/unique_search_proxy_sdk/`. Generated from the server OpenAPI spec via [openapi-python-client](https://github.com/openapi-generators/openapi-python-client).
+
+| Path | Role |
+|------|------|
+| `unique_search_proxy_sdk/_generated/` | Regenerated httpx client + attrs models |
+| `unique_search_proxy_sdk/client.py` | `UniqueSearchProxyClient` facade |
+| `connectors/unique_search_proxy/unique_search_proxy_client/openapi.json` | Exported spec (codegen input) |
+
+### Regenerate after API changes
+
+```bash
+cd connectors/unique_search_proxy/unique_search_proxy_client
+uv sync
+uv run python scripts/generate_sdk.py
+```
+
+### Usage
+
+```python
+from unique_search_proxy_sdk import UniqueSearchProxyClient
+
+async with UniqueSearchProxyClient("http://unique-search-proxy:2349") as client:
+    await client.health()
+    result = await client.search.search("unique ag", engine="google", fetchSize=10)
+    crawl = await client.crawl.crawl(["https://example.com"], crawler="basic")
+
+    # Low-level: one generated function per route
+    raw = client.openapi  # OpenAPIClient from _generated
+```
+
+| Facade method | HTTP |
+|---------------|------|
+| `health()` | `GET /health` |
+| `ready()` | `GET /ready` |
+| `search.search(...)` | `POST /v1/search` |
+| `crawl.crawl(...)` | `POST /v1/crawl` |
+
+Deployment config JSON Schema, defaults, and LLM call-schema projection live in **`unique_search_proxy_core`** (not HTTP). Assistants-core and tooling import those helpers directly.
+
+Non-success responses raise the same `ProxyError` subclasses as the service. Generated request/response models live under `sdk._generated.models`.
+
+For tests, pass an `httpx.AsyncClient` with `ASGITransport(app=create_app())` and run the app lifespan so in-app egress is initialized.
+
+### Other OpenAPI codegen tools
+
+| Tool | Notes |
+|------|--------|
+| [OpenAPI Generator](https://github.com/OpenAPITools/openapi-generator) | Broad language support; verbose Python output |
+| [openapi-python-client](https://github.com/openapi-generators/openapi-python-client) | **Used here** — async httpx + attrs |
+| [datamodel-code-generator](https://github.com/koxudaxi/datamodel-code-generator) | Pydantic models only |
+| [Kiota](https://github.com/microsoft/kiota) | Multi-language SDKs |
+
+## API (application)
+
+| Endpoint | Description |
+|----------|-------------|
+| `GET /health` | Liveness |
+| `GET /ready` | Readiness (httpx pool + registered providers) |
+| `GET /v1/configuration/providers` | Registered search engine and crawler ids |
+| `POST /v1/search` | Execute search (flat request: `engine`, `query`, provider params, `timeout`) |
+| `POST /v1/crawl` | Crawl URLs via configured crawler (flat request: `crawler`, `urls`, `timeout`, …) |
+| `GET /metrics` | Prometheus scrape endpoint (when enabled) |
+| `/docs` | OpenAPI (Swagger UI) — use **Try it out** and the request-body **Examples** dropdown on `/v1/search` and `/v1/crawl` |
+
+Set `ENABLED=false` on monitoring settings (`PrometheusSettings`) to disable metrics. With `WORKERS > 1`, the entrypoint sets `PROMETHEUS_MULTIPROC_DIR` for correct aggregation across uvicorn workers.
+
+Settings are colocated with each component and use env prefixes:
+
+| Component | Prefix / vars | Example |
+|-----------|----------------|---------|
+| Google search | (no prefix) | `GOOGLE_SEARCH_API_KEY`, `GOOGLE_SEARCH_ENGINE_ID` |
+| HTTP client | `HTTP_CLIENT_` | `HTTP_CLIENT_PROXY_HOST`, `HTTP_CLIENT_POOL_TIMEOUT_SECONDS` |
+| Prometheus | `PROMETHEUS_` | `PROMETHEUS_ENABLED` |
+| Container entrypoint | (shell) | `HOST`, `PORT`, `WORKERS`, `LOG_LEVEL`, `PROMETHEUS_MULTIPROC_DIR` |
+
+Copy `.example.env` to `.env` for a annotated template of all settings. Shared helpers live in `web/settings/`.
+
+### Runtime discovery (`GET /v1/configuration/providers`)
+
+Lists search engine and crawler ids registered in the proxy pod (depends on env/secrets). Use this for health checks and capability discovery at runtime.
+
+Deployment config JSON Schema, defaults, and LLM call-schema projection are **core library** concerns — import from `unique_search_proxy_core.providers.schema` and `unique_search_proxy_core.search_engines.call_schema` (or the crawl equivalents). Assistants-core embeds those shapes in tool manifests rather than calling extra HTTP routes on the proxy.
+
+### Search (`POST /v1/search`)
+
+Flat request body: all execution fields at the top level (`engine`, `query`, optional provider knobs, `timeout`). Tooling merges deployment config with LLM invocation in **core** (`merge_config_and_invocation`) before calling the proxy.
+
+```json
+{
+  "engine": "google",
+  "query": "example query",
+  "fetchSize": 10,
+  "gl": "de",
+  "dateRestrict": "d7",
+  "timeout": 30
+}
+```
+
+- **`engine`**: registered search engine id (discriminator)
+- **`query`**, **`fetchSize`**, optional provider knobs, **`timeout`**: flat execution payload on `POST /v1/search`
+- **Deployment config** (`ExposableParam` with `expose` + `value`): resolved in core before building the flat search request — not a separate HTTP surface on the proxy
+- **LLM call schema**: `unique_search_proxy_core.search_engines.call_schema.resolve_search_call_schema(...)` with optional `strict=False` for nullable exposed fields
+
+Response:
+
+```json
+{
+  "engine": "google",
+  "query": "example query",
+  "raw": {
+    "pages": [
+      {
+        "pageIndex": 1,
+        "offset": 1,
+        "requestedCount": 10,
+        "response": {}
+      }
+    ]
+  },
+  "curated": [
+    {
+      "url": "https://example.com",
+      "title": "Example",
+      "snippet": "...",
+      "content": ""
+    }
+  ]
+}
+```
+
+### Crawl (`POST /v1/crawl`)
+
+```json
+{
+  "urls": ["https://example.com"],
+  "crawler": "basic",
+  "timeout": 30
+}
+```
+
+### Errors
+
+Non-2xx responses use a structured envelope:
+
+```json
+{
+  "error": {
+    "code": "ENGINE_NOT_CONFIGURED",
+    "message": "Engine 'google' is not registered or not configured",
+    "engine": "google",
+    "retryable": false
+  }
+}
+```
+
+## Project Structure
+
+```
+connectors/unique_search_proxy/
+├── unique_search_proxy/
+│   ├── sdk/                    # HTTP SDK (callers → proxy API)
+│   │   ├── _generated/         # openapi-python-client output (regenerate via scripts/)
+│   │   ├── client.py           # UniqueSearchProxyClient facade
+│   │   ├── converters.py       # App Pydantic config → generated models
+│   │   └── errors.py           # Maps API error envelope → ProxyError
+│   ├── openapi.json            # Exported OpenAPI (codegen input)
+│   ├── scripts/generate_sdk.py
+│   └── web/                    # FastAPI application (proxy pod)
+│       ├── app.py              # App factory + lifespan (HttpClientPool)
+│       ├── settings/
+│       ├── api/
+│       │   ├── health.py
+│       │   └── v1/
+│       │       ├── configuration.py
+│       │       ├── search.py
+│       │       └── crawl.py
+│       ├── monitoring/
+│       └── core/
+│           ├── client/         # Egress pool — application only, not SDK
+│           ├── search_engines/
+│           └── crawlers/
+├── tests/
+└── deploy/
+```
+
+Engines and crawlers register via `web/core/registry.py` at application startup.
+
+## 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.dev1/README.md

@@ -0,0 +1,256 @@
+# Unique Search Proxy
+
+Unified web egress proxy for search engines and crawlers. **Three publishable packages** in this repo:
+
+| PyPI name | Module | Role |
+|-----------|--------|------|
+| `unique-search-proxy` | `unique_search_proxy_client.web` | FastAPI server (proxy pod) |
+| `unique-search-proxy-sdk` | `unique_search_proxy_sdk` | Async HTTP client for callers |
+| `unique-search-proxy-core` | `unique_search_proxy_core` | Shared Pydantic types (no FastAPI) |
+
+```mermaid
+flowchart LR
+  subgraph caller["Caller pod"]
+    SDK["unique_search_proxy_sdk"]
+  end
+  subgraph proxy["Proxy pod"]
+    API["unique_search_proxy_client.web"]
+    Pool["HttpClientPool"]
+  end
+  Core["unique_search_proxy_core"]
+  Internet["Google / public web"]
+  SDK --> Core
+  API --> Core
+  SDK -->|"POST /v1/search"| API
+  API --> Pool
+  Pool --> Internet
+```
+
+- **Server** owns registry, secrets, Prometheus, and egress (`HttpClientPool`).
+- **SDK** wraps the [OpenAPI](http://localhost:2349/docs) contract; depends on **core** for `GoogleConfig`, errors, etc.
+- **Core** is server-free and safe to install without FastAPI/uvicorn.
+
+## Quick Start
+
+### Prerequisites
+
+- Python 3.12+
+- uv for dependency management
+
+### Installation
+
+```bash
+uv sync
+cp .env.example .env
+# Edit .env: set GOOGLE_SEARCH_API_KEY and GOOGLE_SEARCH_ENGINE_ID for live /v1/search
+```
+
+### Running
+
+```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
+```
+
+## Python SDK (`unique-search-proxy-sdk`)
+
+Workspace path: `connectors/unique_search_proxy/unique_search_proxy_sdk/`. Generated from the server OpenAPI spec via [openapi-python-client](https://github.com/openapi-generators/openapi-python-client).
+
+| Path | Role |
+|------|------|
+| `unique_search_proxy_sdk/_generated/` | Regenerated httpx client + attrs models |
+| `unique_search_proxy_sdk/client.py` | `UniqueSearchProxyClient` facade |
+| `connectors/unique_search_proxy/unique_search_proxy_client/openapi.json` | Exported spec (codegen input) |
+
+### Regenerate after API changes
+
+```bash
+cd connectors/unique_search_proxy/unique_search_proxy_client
+uv sync
+uv run python scripts/generate_sdk.py
+```
+
+### Usage
+
+```python
+from unique_search_proxy_sdk import UniqueSearchProxyClient
+
+async with UniqueSearchProxyClient("http://unique-search-proxy:2349") as client:
+    await client.health()
+    result = await client.search.search("unique ag", engine="google", fetchSize=10)
+    crawl = await client.crawl.crawl(["https://example.com"], crawler="basic")
+
+    # Low-level: one generated function per route
+    raw = client.openapi  # OpenAPIClient from _generated
+```
+
+| Facade method | HTTP |
+|---------------|------|
+| `health()` | `GET /health` |
+| `ready()` | `GET /ready` |
+| `search.search(...)` | `POST /v1/search` |
+| `crawl.crawl(...)` | `POST /v1/crawl` |
+
+Deployment config JSON Schema, defaults, and LLM call-schema projection live in **`unique_search_proxy_core`** (not HTTP). Assistants-core and tooling import those helpers directly.
+
+Non-success responses raise the same `ProxyError` subclasses as the service. Generated request/response models live under `sdk._generated.models`.
+
+For tests, pass an `httpx.AsyncClient` with `ASGITransport(app=create_app())` and run the app lifespan so in-app egress is initialized.
+
+### Other OpenAPI codegen tools
+
+| Tool | Notes |
+|------|--------|
+| [OpenAPI Generator](https://github.com/OpenAPITools/openapi-generator) | Broad language support; verbose Python output |
+| [openapi-python-client](https://github.com/openapi-generators/openapi-python-client) | **Used here** — async httpx + attrs |
+| [datamodel-code-generator](https://github.com/koxudaxi/datamodel-code-generator) | Pydantic models only |
+| [Kiota](https://github.com/microsoft/kiota) | Multi-language SDKs |
+
+## API (application)
+
+| Endpoint | Description |
+|----------|-------------|
+| `GET /health` | Liveness |
+| `GET /ready` | Readiness (httpx pool + registered providers) |
+| `GET /v1/configuration/providers` | Registered search engine and crawler ids |
+| `POST /v1/search` | Execute search (flat request: `engine`, `query`, provider params, `timeout`) |
+| `POST /v1/crawl` | Crawl URLs via configured crawler (flat request: `crawler`, `urls`, `timeout`, …) |
+| `GET /metrics` | Prometheus scrape endpoint (when enabled) |
+| `/docs` | OpenAPI (Swagger UI) — use **Try it out** and the request-body **Examples** dropdown on `/v1/search` and `/v1/crawl` |
+
+Set `ENABLED=false` on monitoring settings (`PrometheusSettings`) to disable metrics. With `WORKERS > 1`, the entrypoint sets `PROMETHEUS_MULTIPROC_DIR` for correct aggregation across uvicorn workers.
+
+Settings are colocated with each component and use env prefixes:
+
+| Component | Prefix / vars | Example |
+|-----------|----------------|---------|
+| Google search | (no prefix) | `GOOGLE_SEARCH_API_KEY`, `GOOGLE_SEARCH_ENGINE_ID` |
+| HTTP client | `HTTP_CLIENT_` | `HTTP_CLIENT_PROXY_HOST`, `HTTP_CLIENT_POOL_TIMEOUT_SECONDS` |
+| Prometheus | `PROMETHEUS_` | `PROMETHEUS_ENABLED` |
+| Container entrypoint | (shell) | `HOST`, `PORT`, `WORKERS`, `LOG_LEVEL`, `PROMETHEUS_MULTIPROC_DIR` |
+
+Copy `.example.env` to `.env` for a annotated template of all settings. Shared helpers live in `web/settings/`.
+
+### Runtime discovery (`GET /v1/configuration/providers`)
+
+Lists search engine and crawler ids registered in the proxy pod (depends on env/secrets). Use this for health checks and capability discovery at runtime.
+
+Deployment config JSON Schema, defaults, and LLM call-schema projection are **core library** concerns — import from `unique_search_proxy_core.providers.schema` and `unique_search_proxy_core.search_engines.call_schema` (or the crawl equivalents). Assistants-core embeds those shapes in tool manifests rather than calling extra HTTP routes on the proxy.
+
+### Search (`POST /v1/search`)
+
+Flat request body: all execution fields at the top level (`engine`, `query`, optional provider knobs, `timeout`). Tooling merges deployment config with LLM invocation in **core** (`merge_config_and_invocation`) before calling the proxy.
+
+```json
+{
+  "engine": "google",
+  "query": "example query",
+  "fetchSize": 10,
+  "gl": "de",
+  "dateRestrict": "d7",
+  "timeout": 30
+}
+```
+
+- **`engine`**: registered search engine id (discriminator)
+- **`query`**, **`fetchSize`**, optional provider knobs, **`timeout`**: flat execution payload on `POST /v1/search`
+- **Deployment config** (`ExposableParam` with `expose` + `value`): resolved in core before building the flat search request — not a separate HTTP surface on the proxy
+- **LLM call schema**: `unique_search_proxy_core.search_engines.call_schema.resolve_search_call_schema(...)` with optional `strict=False` for nullable exposed fields
+
+Response:
+
+```json
+{
+  "engine": "google",
+  "query": "example query",
+  "raw": {
+    "pages": [
+      {
+        "pageIndex": 1,
+        "offset": 1,
+        "requestedCount": 10,
+        "response": {}
+      }
+    ]
+  },
+  "curated": [
+    {
+      "url": "https://example.com",
+      "title": "Example",
+      "snippet": "...",
+      "content": ""
+    }
+  ]
+}
+```
+
+### Crawl (`POST /v1/crawl`)
+
+```json
+{
+  "urls": ["https://example.com"],
+  "crawler": "basic",
+  "timeout": 30
+}
+```
+
+### Errors
+
+Non-2xx responses use a structured envelope:
+
+```json
+{
+  "error": {
+    "code": "ENGINE_NOT_CONFIGURED",
+    "message": "Engine 'google' is not registered or not configured",
+    "engine": "google",
+    "retryable": false
+  }
+}
+```
+
+## Project Structure
+
+```
+connectors/unique_search_proxy/
+├── unique_search_proxy/
+│   ├── sdk/                    # HTTP SDK (callers → proxy API)
+│   │   ├── _generated/         # openapi-python-client output (regenerate via scripts/)
+│   │   ├── client.py           # UniqueSearchProxyClient facade
+│   │   ├── converters.py       # App Pydantic config → generated models
+│   │   └── errors.py           # Maps API error envelope → ProxyError
+│   ├── openapi.json            # Exported OpenAPI (codegen input)
+│   ├── scripts/generate_sdk.py
+│   └── web/                    # FastAPI application (proxy pod)
+│       ├── app.py              # App factory + lifespan (HttpClientPool)
+│       ├── settings/
+│       ├── api/
+│       │   ├── health.py
+│       │   └── v1/
+│       │       ├── configuration.py
+│       │       ├── search.py
+│       │       └── crawl.py
+│       ├── monitoring/
+│       └── core/
+│           ├── client/         # Egress pool — application only, not SDK
+│           ├── search_engines/
+│           └── crawlers/
+├── tests/
+└── deploy/
+```
+
+Engines and crawlers register via `web/core/registry.py` at application startup.
+
+## 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.dev1/pyproject.toml

@@ -0,0 +1,111 @@
+[project]
+name = "unique-search-proxy"
+version = "2026.26.0.dev1"
+description = "Web Search Proxy implementation"
+authors = [{ name = "ThePhilAz", email = "rami.azouz@philico.com" }]
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+    "fastapi>=0.115.0,<1.0.0",
+    "starlette>=0.41.0,<1.0.0",
+    "uvicorn[standard]>=0.32.0,<1.0.0",
+    "pydantic>=2.12.5,<3.0.0",
+    "httpx>=0.28.0,<0.29.0",
+    "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.dev1,<2026.26.0rc0",
+    "unique-search-proxy-core>=2026.26.0.dev0,<2026.26.0rc0",
+]
+
+[dependency-groups]
+dev = [
+    "basedpyright>=1.39.1",
+    "openapi-python-client>=0.28.4",
+    "pytest>=9.0.3",
+    "pytest-asyncio>=1.3.0",
+    "ruff>=0.15.10",
+    "unique-search-proxy-sdk>=2026.22.0",
+]
+
+[build-system]
+requires = ["uv_build>=0.7.19,<0.8"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-root = "."
+module-name = "unique_search_proxy_client"
+
+[tool.uv]
+exclude-newer = "2 weeks"
+
+[tool.uv.exclude-newer-package]
+"unique-toolkit" = false
+
+[tool.uv.sources]
+unique-toolkit = { workspace = true }
+unique-search-proxy-core = { workspace = true }
+unique-search-proxy-sdk = { workspace = true }
+
+[tool.ruff]
+target-version = "py312"
+
+[tool.ruff.lint]
+extend-select = ["I"]
+
+[tool.basedpyright]
+typeCheckingMode = "standard"
+include = ["unique_search_proxy_client"]
+
+[tool.deptry]
+known_first_party = [
+    "unique_search_proxy_client",
+    "unique_search_proxy_core",
+    "unique_search_proxy_sdk",
+    "unique_toolkit",
+]
+
+[tool.deptry.per_rule_ignores]
+DEP002 = ["unique-toolkit", "unique-search-proxy-core"]
+DEP003 = ["unique_toolkit", "unique_search_proxy_core"]
+
+[tool.poe.tasks]
+generate-sdk = "python scripts/generate_sdk.py"
+lint = "ruff check ."
+lint-fix = "ruff check . --fix"
+format = "ruff format ."
+test = "pytest"
+typecheck = "basedpyright"
+depcheck = "deptry ."
+check-imports = "lint-imports --config pyproject.toml"
+
+[tool.pytest.ini_options]
+addopts = "--strict-markers --import-mode=importlib"
+asyncio_mode = "auto"
+markers = [
+    "ai: AI-authored or AI-generated tests",
+    "asyncio: asyncio tests",
+    "integration: integration tests that require API access or credentials",
+    "serial: tests that must run serially",
+    "unit: unit tests",
+    "verified: AI-generated tests with human verification",
+]
+filterwarnings = [
+    "ignore::DeprecationWarning",
+]
+
+[tool.importlinter]
+root_packages = [
+    "unique_search_proxy_core",
+    "unique_search_proxy_sdk",
+]
+include_external_packages = true
+
+[[tool.importlinter.contracts]]
+name = "core and sdk never import the FastAPI server"
+type = "forbidden"
+source_modules = [
+    "unique_search_proxy_core",
+    "unique_search_proxy_sdk",
+]
+forbidden_modules = ["unique_search_proxy_client"]

unique_search_proxy-2026.26.0.dev1/unique_search_proxy_client/__init__.py

@@ -0,0 +1,7 @@
+"""unique-search-proxy — FastAPI server for web search and crawl egress.
+
+HTTP SDK: install ``unique-search-proxy-sdk`` and import
+``unique_search_proxy_sdk.UniqueSearchProxyClient``.
+"""
+
+__all__: list[str] = []

unique_search_proxy-2026.26.0.dev1/unique_search_proxy_client/web/__init__.py

@@ -0,0 +1,8 @@
+"""FastAPI application layer (deployable service).
+
+Not part of the HTTP SDK. Callers should use ``unique_search_proxy_client.sdk`` to talk
+to this service over HTTP; they must not depend on ``web.core.client.HttpClientPool``
+for tool execution.
+
+Entrypoint: ``unique_search_proxy_client.web.app:create_app`` (or ``app``).
+"""

unique_search_proxy-2026.26.0.dev1/unique_search_proxy_client/web/api/__init__.py

@@ -0,0 +1,4 @@
+from unique_search_proxy_client.web.api.health import router as health_router
+from unique_search_proxy_client.web.api.v1 import v1_router
+
+__all__ = ["health_router", "v1_router"]

unique_search_proxy-2026.26.0.dev1/unique_search_proxy_client/web/api/health.py

@@ -0,0 +1,27 @@
+from __future__ import annotations
+
+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_crawlers,
+    registered_search_engines,
+)
+
+router = APIRouter(tags=["health"])
+
+
+@router.get("/health")
+async def health() -> dict[str, str]:
+    return {"status": "healthy"}
+
+
+@router.get("/ready")
+async def ready(request: Request) -> dict[str, object]:
+    pool = get_http_client_pool(request.app)
+    return {
+        "status": "ready",
+        "httpClient": "ok" if not pool.client.is_closed else "closed",
+        "searchEngines": sorted(registered_search_engines()),
+        "crawlers": sorted(registered_crawlers()),
+    }