feat: settings config

.env.example

@@ -27,6 +27,12 @@ ADMIN_PASSWORD=
 # Per-client-IP global rate limit (requests / minute). 0 disables.
 RATE_LIMIT_PER_MINUTE=60
 
+# --- Service enablement ---
+# Which API groups are mounted is controlled by services.yaml at the project
+# root (set enabled: true/false per service, e.g. google:sheets_api). Point
+# this at a different file to override.
+# SERVICES_CONFIG_PATH=./services.yaml
+
 # --- URL shortener ---
 URL_SHORTENER_SECRET=change-me
 URL_SHORTENER_BASE=http://localhost:7860/api/v1

.gitignore

@@ -137,3 +137,4 @@ ddl/
 scripts/
 docs/API_DESCRIPTION.md
 docs/planning/
+postman

app/api/server.py

@@ -18,7 +18,12 @@ from app.api.whatsapp import (
     get_whatsapp_health,
     router as whatsapp_router,
 )
-from app.config import get_settings
+from app.config import (
+    disabled_services,
+    enabled_services,
+    get_settings,
+    is_service_enabled,
+)
 from app.core.auth.deps import init_auth_db
 from app.core.database import pool_manager
 from app.core.logger import get_logger
@@ -91,6 +96,11 @@ async def _self_ping():
 
 @asynccontextmanager
 async def lifespan(app: FastAPI):
+    for service in enabled_services():
+        _logger.info("%s-service is enabled", service.replace(":", "-"))
+    for service in disabled_services():
+        _logger.warning("%s-service is disabled", service.replace(":", "-"))
+
     if not _settings.supabase_url or not _settings.supabase_service_role_key:
         _logger.error(
             "Supabase not configured! Set SUPABASE_URL and "
@@ -269,11 +279,12 @@ def create_application() -> FastAPI:
         dependencies=[Depends(_api_rate_limit)],
     )
 
-    app.include_router(
-        whatsapp_router,
-        prefix="/api/whatsapp",
-        dependencies=[Depends(_api_rate_limit)],
-    )
+    if is_service_enabled("whatsapp:service"):
+        app.include_router(
+            whatsapp_router,
+            prefix="/api/whatsapp",
+            dependencies=[Depends(_api_rate_limit)],
+        )
 
     @app.get("/", include_in_schema=False)
     async def root(request: Request):

app/api/v1/router.py

@@ -36,37 +36,46 @@ from app.api.v1 import (
     webhook_socket,
 )
 from app.api.verify import router as verify_router
+from app.config import is_service_enabled
 
 api_v1_router = APIRouter()
-api_v1_router.include_router(auth.router, tags=["Authentication"])
-api_v1_router.include_router(convert.router, tags=["Convert"])
-api_v1_router.include_router(batch.router, tags=["Batch"])
-api_v1_router.include_router(system.router, tags=["System"])
-api_v1_router.include_router(database.router, tags=["Database"])
-api_v1_router.include_router(embeddings.router, tags=["Embeddings"])
-api_v1_router.include_router(code_executor.router, tags=["Code Executor"])
-api_v1_router.include_router(verify_router, prefix="/verify", tags=["Verify"])
-api_v1_router.include_router(reconcile.router, tags=["Reconcile"])
-api_v1_router.include_router(scheduler.router, tags=["Scheduler"])
-api_v1_router.include_router(scraper.router, tags=["Web Scraping"])
-api_v1_router.include_router(web_search.router, tags=["Web Search"])
-api_v1_router.include_router(sql_validator.router, tags=["SQL Validator"])
-api_v1_router.include_router(semantic_router.router, tags=["Semantic Router"])
-api_v1_router.include_router(token_counter.router, tags=["Token Counter"])
-api_v1_router.include_router(token_generator.router, tags=["Token Generator"])
-api_v1_router.include_router(chat.router, tags=["Chat"])
-api_v1_router.include_router(vector_stores.router, tags=["Vector Stores"])
-api_v1_router.include_router(webhook_socket.router, tags=["Webhook / Socket"])
-api_v1_router.include_router(csv_analysis.router, tags=["CSV Analysis"])
-api_v1_router.include_router(google_maps.router, tags=["Google Maps"])
-api_v1_router.include_router(google_oauth.router, tags=["Google OAuth"])
-api_v1_router.include_router(scopes.router, tags=["Google Scopes"])
-api_v1_router.include_router(gcs.router, tags=["Google Cloud Storage"])
-api_v1_router.include_router(gmail.router, tags=["Gmail"])
-api_v1_router.include_router(sheets.router, tags=["Google Sheets"])
-api_v1_router.include_router(media_convert.router, tags=["Media-to-Media Conversion"])
-api_v1_router.include_router(json_extract.router, tags=["JSON Extractor"])
-api_v1_router.include_router(keys_extract.router, prefix="/json", tags=["Keys Extractor"])
-api_v1_router.include_router(qr_decoder.router, tags=["QR Decoder"])
-api_v1_router.include_router(qr_generator.router, tags=["QR Generator"])
-api_v1_router.include_router(url_shortener.router, tags=["URL Shortener"])
+
+
+def _include(router: APIRouter, service_path: str, **kwargs) -> None:
+    """Mount a router only when its service is enabled in services.yaml."""
+    if is_service_enabled(service_path):
+        api_v1_router.include_router(router, **kwargs)
+
+
+_include(auth.router, "auth", tags=["Authentication"])
+_include(convert.router, "convert", tags=["Convert"])
+_include(batch.router, "batch", tags=["Batch"])
+_include(system.router, "system", tags=["System"])
+_include(database.router, "database", tags=["Database"])
+_include(embeddings.router, "embeddings", tags=["Embeddings"])
+_include(code_executor.router, "code_executor", tags=["Code Executor"])
+_include(verify_router, "verify", prefix="/verify", tags=["Verify"])
+_include(reconcile.router, "reconcile", tags=["Reconcile"])
+_include(scheduler.router, "scheduler", tags=["Scheduler"])
+_include(scraper.router, "scraper", tags=["Web Scraping"])
+_include(web_search.router, "web_search", tags=["Web Search"])
+_include(sql_validator.router, "sql_validator", tags=["SQL Validator"])
+_include(semantic_router.router, "semantic_router", tags=["Semantic Router"])
+_include(token_counter.router, "token_counter", tags=["Token Counter"])
+_include(token_generator.router, "token_generator", tags=["Token Generator"])
+_include(chat.router, "chat", tags=["Chat"])
+_include(vector_stores.router, "vector_stores", tags=["Vector Stores"])
+_include(webhook_socket.router, "webhook_socket", tags=["Webhook / Socket"])
+_include(csv_analysis.router, "csv_analysis", tags=["CSV Analysis"])
+_include(google_maps.router, "google:maps", tags=["Google Maps"])
+_include(google_oauth.router, "google:oauth", tags=["Google OAuth"])
+_include(scopes.router, "google:scopes", tags=["Google Scopes"])
+_include(gcs.router, "google:cloud_storage", tags=["Google Cloud Storage"])
+_include(gmail.router, "google:gmail", tags=["Gmail"])
+_include(sheets.router, "google:sheets_api", tags=["Google Sheets"])
+_include(media_convert.router, "media_convert", tags=["Media-to-Media Conversion"])
+_include(json_extract.router, "json_extract", tags=["JSON Extractor"])
+_include(keys_extract.router, "keys_extract", prefix="/json", tags=["Keys Extractor"])
+_include(qr_decoder.router, "qr_decoder", tags=["QR Decoder"])
+_include(qr_generator.router, "qr_generator", tags=["QR Generator"])
+_include(url_shortener.router, "url_shortener", tags=["URL Shortener"])

app/config.py

@@ -1,7 +1,11 @@
 from __future__ import annotations
 
+import os
 from functools import lru_cache
-from typing import Optional
+from pathlib import Path
+from typing import Dict, Optional
+
+import yaml
 
 from pydantic import Field
 from pydantic_settings import BaseSettings, SettingsConfigDict
@@ -272,3 +276,74 @@ def get_settings() -> Settings:
                 + ". Set strong values in your environment (see .env.example)."
             )
     return settings
+
+
+# ---------------------------------------------------------------------------
+# Service / API enablement
+#
+# Per-service on/off switches are defined in `services.yaml` at the project
+# root (override the location with SERVICES_CONFIG_PATH). The YAML is nested,
+# e.g.:
+#
+#   google:
+#     sheets_api:
+#       enabled: true
+#
+# and is addressed in code by its colon-joined path, e.g.
+# `is_service_enabled("google:sheets_api")`. Entries missing from the file
+# default to enabled so the API surface never silently shrinks.
+# ---------------------------------------------------------------------------
+
+_DEFAULT_SERVICES_CONFIG = Path(__file__).resolve().parent.parent / "services.yaml"
+
+
+def _services_config_path() -> Path:
+    return Path(os.environ.get("SERVICES_CONFIG_PATH") or _DEFAULT_SERVICES_CONFIG)
+
+
+def _flatten_service_config(node: Dict[str, object], prefix: str = "") -> Dict[str, bool]:
+    """Flatten nested YAML {group: {service: {enabled: bool}}} into paths.
+
+    Returns a map of "group:service" -> enabled flag. Keys without an
+    `enabled` field are skipped (so arbitrary metadata can live alongside).
+    """
+    flattened: Dict[str, bool] = {}
+    for key, value in node.items():
+        path = f"{prefix}:{key}" if prefix else key
+        if isinstance(value, dict):
+            if "enabled" in value:
+                flattened[path] = bool(value.get("enabled", True))
+            else:
+                flattened.update(_flatten_service_config(value, path))
+    return flattened
+
+
+@lru_cache(maxsize=1)
+def get_services_config() -> Dict[str, bool]:
+    """Load and flatten services.yaml into {"google:sheets_api": True, ...}."""
+    config_path = _services_config_path()
+    if not config_path.exists():
+        return {}
+    try:
+        with open(config_path, "r", encoding="utf-8") as handle:
+            raw = yaml.safe_load(handle) or {}
+    except Exception:
+        return {}
+    if not isinstance(raw, dict):
+        return {}
+    return _flatten_service_config(raw)
+
+
+def is_service_enabled(service_path: str) -> bool:
+    """Return True if the named service is enabled (missing entries default on)."""
+    return get_services_config().get(service_path, True)
+
+
+def enabled_services() -> list[str]:
+    """Colon-joined paths of all explicitly-enabled services, sorted."""
+    return sorted(path for path, enabled in get_services_config().items() if enabled)
+
+
+def disabled_services() -> list[str]:
+    """Colon-joined paths of all explicitly-disabled services, sorted."""
+    return sorted(path for path, enabled in get_services_config().items() if not enabled)

pyproject.toml

@@ -16,6 +16,7 @@ dependencies = [
     "uvicorn[standard]>=0.30",
     "pydantic>=2.7",
     "pydantic-settings>=2.0.0",
+    "PyYAML>=6.0.0",
     "python-multipart>=0.0.9",
     "httpx>=0.27",
     "youtube-transcript-api>=1.2.4",

requirements.txt

@@ -6,6 +6,7 @@ pydantic-settings==2.6.1
 python-multipart==0.0.20
 httpx==0.28.1
 aiohttp==3.11.13
+PyYAML==6.0.2
 
 # --- Media / file processing ---
 numpy==2.2.6

services.yaml

@@ -0,0 +1,107 @@
+# ------------------------------------------------------------------
+# AgentDeck Backend - service / API enablement config
+#
+# This file controls which API service groups are enabled at startup.
+# Services marked `enabled: true` are mounted and their routes registered;
+# services marked `enabled: false` are NOT mounted (requests return 404)
+# and are logged as disabled. Missing entries default to enabled.
+#
+# The path style used by code is e.g. "google:sheets_api" (colons join the
+# nested keys). Override the file location with SERVICES_CONFIG_PATH.
+# ------------------------------------------------------------------
+
+auth:
+  enabled: true
+
+convert:
+  enabled: true
+
+batch:
+  enabled: true
+
+system:
+  enabled: true
+
+database:
+  enabled: true
+
+embeddings:
+  enabled: true
+
+code_executor:
+  enabled: true
+
+verify:
+  enabled: true
+
+reconcile:
+  enabled: true
+
+scheduler:
+  enabled: true
+
+scraper:
+  enabled: true
+
+web_search:
+  enabled: true
+
+sql_validator:
+  enabled: true
+
+semantic_router:
+  enabled: true
+
+token_counter:
+  enabled: true
+
+token_generator:
+  enabled: true
+
+chat:
+  enabled: true
+
+vector_stores:
+  enabled: true
+
+webhook_socket:
+  enabled: true
+
+csv_analysis:
+  enabled: true
+
+google:
+  maps:
+    enabled: true
+  oauth:
+    enabled: true
+  scopes:
+    enabled: true
+  cloud_storage:
+    enabled: true
+  gmail:
+    enabled: true
+  sheets_api:
+    enabled: true
+
+media_convert:
+  enabled: true
+
+json_extract:
+  enabled: true
+
+keys_extract:
+  enabled: true
+
+qr_decoder:
+  enabled: true
+
+qr_generator:
+  enabled: true
+
+url_shortener:
+  enabled: true
+
+whatsapp:
+  service:
+    enabled: true