mdb-engine 0.2.1__py3-none-any.whl → 0.2.3__py3-none-any.whl

mdb_engine/core/manifest.py

@@ -32,7 +32,8 @@ For Scale:
 import asyncio
 import hashlib
 import logging
-from typing import Any, Awaitable, Callable, Dict, List, Optional, Tuple
+from collections.abc import Awaitable, Callable
+from typing import Any
 
 from jsonschema import SchemaError, ValidationError, validate
 
@@ -48,10 +49,10 @@ from ..constants import (
 logger = logging.getLogger(__name__)
 
 # Schema registry: maps version -> schema definition
-SCHEMA_REGISTRY: Dict[str, Dict[str, Any]] = {}
+SCHEMA_REGISTRY: dict[str, dict[str, Any]] = {}
 
 # Validation cache: maps (manifest_hash, version) -> validation_result
-_validation_cache: Dict[str, Tuple[bool, Optional[str], Optional[List[str]]]] = {}
+_validation_cache: dict[str, tuple[bool, str | None, list[str] | None]] = {}
 _cache_lock = asyncio.Lock()
 
 
@@ -86,7 +87,7 @@ def _convert_tuples_to_lists(obj: Any) -> Any:
         return obj
 
 
-def _get_manifest_hash(manifest_data: Dict[str, Any]) -> str:
+def _get_manifest_hash(manifest_data: dict[str, Any]) -> str:
     """Generate a hash for manifest caching."""
     import json
 
@@ -2083,7 +2084,7 @@ SCHEMA_REGISTRY["default"] = MANIFEST_SCHEMA_V2
 MANIFEST_SCHEMA = MANIFEST_SCHEMA_V2  # Backward compatibility
 
 
-def get_schema_version(manifest_data: Dict[str, Any]) -> str:
+def get_schema_version(manifest_data: dict[str, Any]) -> str:
     """
     Detect schema version from manifest.
 
@@ -2096,7 +2097,7 @@ def get_schema_version(manifest_data: Dict[str, Any]) -> str:
     Raises:
         ValueError: If schema version format is invalid
     """
-    version: Optional[str] = manifest_data.get("schema_version")
+    version: str | None = manifest_data.get("schema_version")
     if version:
         # Validate version format
         if not isinstance(version, str) or not version.replace(".", "").isdigit():
@@ -2118,8 +2119,8 @@ def get_schema_version(manifest_data: Dict[str, Any]) -> str:
 
 
 def migrate_manifest(
-    manifest_data: Dict[str, Any], target_version: str = CURRENT_SCHEMA_VERSION
-) -> Dict[str, Any]:
+    manifest_data: dict[str, Any], target_version: str = CURRENT_SCHEMA_VERSION
+) -> dict[str, Any]:
     """
     Migrate manifest from one schema version to another.
 
@@ -2168,7 +2169,7 @@ def migrate_manifest(
     return migrated
 
 
-def get_schema_for_version(version: str) -> Dict[str, Any]:
+def get_schema_for_version(version: str) -> dict[str, Any]:
     """
     Get schema definition for a specific version.
 
@@ -2201,8 +2202,8 @@ def get_schema_for_version(version: str) -> Dict[str, Any]:
 
 
 async def _validate_manifest_async(
-    manifest_data: Dict[str, Any], use_cache: bool = True
-) -> Tuple[bool, Optional[str], Optional[List[str]]]:
+    manifest_data: dict[str, Any], use_cache: bool = True
+) -> tuple[bool, str | None, list[str] | None]:
     """
     Validate a manifest against the JSON Schema with versioning and caching support.
 
@@ -2329,8 +2330,8 @@ def clear_validation_cache():
 
 
 async def validate_manifests_parallel(
-    manifests: List[Dict[str, Any]], use_cache: bool = True
-) -> List[Tuple[bool, Optional[str], Optional[List[str]], Optional[str]]]:
+    manifests: list[dict[str, Any]], use_cache: bool = True
+) -> list[tuple[bool, str | None, list[str] | None, str | None]]:
     """
     Validate multiple manifests in parallel for scale.
 
@@ -2344,8 +2345,8 @@ async def validate_manifests_parallel(
     """
 
     async def validate_one(
-        manifest: Dict[str, Any],
-    ) -> Tuple[bool, Optional[str], Optional[List[str]], Optional[str]]:
+        manifest: dict[str, Any],
+    ) -> tuple[bool, str | None, list[str] | None, str | None]:
         slug = manifest.get("slug", "unknown")
         is_valid, error, paths = await _validate_manifest_async(manifest, use_cache=use_cache)
         return (is_valid, error, paths, slug)
@@ -2366,8 +2367,8 @@ async def validate_manifests_parallel(
 
 
 async def validate_developer_id(
-    developer_id: str, db_validator: Optional[Callable[[str], Awaitable[bool]]] = None
-) -> Tuple[bool, Optional[str]]:
+    developer_id: str, db_validator: Callable[[str], Awaitable[bool]] | None = None
+) -> tuple[bool, str | None]:
     """
     Validate that a developer_id exists in the system and has developer role.
 
@@ -2411,10 +2412,10 @@ async def validate_developer_id(
 
 
 async def validate_manifest_with_db(
-    manifest_data: Dict[str, Any],
+    manifest_data: dict[str, Any],
     db_validator: Callable[[str], Awaitable[bool]],
     use_cache: bool = True,
-) -> Tuple[bool, Optional[str], Optional[List[str]]]:
+) -> tuple[bool, str | None, list[str] | None]:
     """
     Validate a manifest against the JSON Schema (with versioning) and check
     developer_id exists in system.
@@ -2455,8 +2456,8 @@ async def validate_manifest_with_db(
 # Public API: Synchronous wrapper for backward compatibility
 # Most callers use this synchronously, so we provide a sync wrapper
 def validate_manifest(
-    manifest_data: Dict[str, Any], use_cache: bool = True
-) -> Tuple[bool, Optional[str], Optional[List[str]]]:
+    manifest_data: dict[str, Any], use_cache: bool = True
+) -> tuple[bool, str | None, list[str] | None]:
     """
     Validate a manifest against the JSON Schema with versioning and caching
     support (synchronous wrapper).
@@ -2495,8 +2496,8 @@ def validate_manifest(
 
 
 def _validate_regular_index(
-    index_def: Dict[str, Any], collection_name: str, index_name: str
-) -> Tuple[bool, Optional[str]]:
+    index_def: dict[str, Any], collection_name: str, index_name: str
+) -> tuple[bool, str | None]:
     """Validate a regular index definition."""
     if "keys" not in index_def:
         return (
@@ -2533,8 +2534,8 @@ def _validate_regular_index(
 
 
 def _validate_ttl_index(
-    index_def: Dict[str, Any], collection_name: str, index_name: str
-) -> Tuple[bool, Optional[str]]:
+    index_def: dict[str, Any], collection_name: str, index_name: str
+) -> tuple[bool, str | None]:
     """Validate a TTL index definition."""
     if "keys" not in index_def:
         return (
@@ -2567,8 +2568,8 @@ def _validate_ttl_index(
 
 
 def _validate_partial_index(
-    index_def: Dict[str, Any], collection_name: str, index_name: str
-) -> Tuple[bool, Optional[str]]:
+    index_def: dict[str, Any], collection_name: str, index_name: str
+) -> tuple[bool, str | None]:
     """Validate a partial index definition."""
     if "keys" not in index_def:
         return (
@@ -2588,8 +2589,8 @@ def _validate_partial_index(
 
 
 def _validate_text_index(
-    index_def: Dict[str, Any], collection_name: str, index_name: str
-) -> Tuple[bool, Optional[str]]:
+    index_def: dict[str, Any], collection_name: str, index_name: str
+) -> tuple[bool, str | None]:
     """Validate a text index definition."""
     if "keys" not in index_def:
         return (
@@ -2614,8 +2615,8 @@ def _validate_text_index(
 
 
 def _validate_geospatial_index(
-    index_def: Dict[str, Any], collection_name: str, index_name: str
-) -> Tuple[bool, Optional[str]]:
+    index_def: dict[str, Any], collection_name: str, index_name: str
+) -> tuple[bool, str | None]:
     """Validate a geospatial index definition."""
     if "keys" not in index_def:
         return (
@@ -2641,8 +2642,8 @@ def _validate_geospatial_index(
 
 
 def _validate_vector_search_index(
-    index_def: Dict[str, Any], collection_name: str, index_name: str, index_type: str
-) -> Tuple[bool, Optional[str]]:
+    index_def: dict[str, Any], collection_name: str, index_name: str, index_type: str
+) -> tuple[bool, str | None]:
     """Validate a vectorSearch or search index definition."""
     if "definition" not in index_def:
         return (
@@ -2689,8 +2690,8 @@ def _validate_vector_search_index(
 
 
 def _validate_hybrid_index(
-    index_def: Dict[str, Any], collection_name: str, index_name: str
-) -> Tuple[bool, Optional[str]]:
+    index_def: dict[str, Any], collection_name: str, index_name: str
+) -> tuple[bool, str | None]:
     """Validate a hybrid index definition."""
     if "hybrid" not in index_def:
         return (
@@ -2753,8 +2754,8 @@ def _validate_hybrid_index(
 
 
 def validate_index_definition(
-    index_def: Dict[str, Any], collection_name: str, index_name: str
-) -> Tuple[bool, Optional[str]]:
+    index_def: dict[str, Any], collection_name: str, index_name: str
+) -> tuple[bool, str | None]:
     """
     Validate a single index definition with context-specific checks.
 
@@ -2797,8 +2798,8 @@ def validate_index_definition(
 
 
 def validate_managed_indexes(
-    managed_indexes: Dict[str, List[Dict[str, Any]]],
-) -> Tuple[bool, Optional[str]]:
+    managed_indexes: dict[str, list[dict[str, Any]]],
+) -> tuple[bool, str | None]:
     """
     Validate all managed indexes with collection and index context.
 
@@ -2866,8 +2867,8 @@ class ManifestValidator:
 
     @staticmethod
     def validate(
-        manifest: Dict[str, Any], use_cache: bool = True
-    ) -> Tuple[bool, Optional[str], Optional[List[str]]]:
+        manifest: dict[str, Any], use_cache: bool = True
+    ) -> tuple[bool, str | None, list[str] | None]:
         """
         Validate manifest against schema.
 
@@ -2882,8 +2883,8 @@ class ManifestValidator:
 
     @staticmethod
     async def validate_async(
-        manifest: Dict[str, Any], use_cache: bool = True
-    ) -> Tuple[bool, Optional[str], Optional[List[str]]]:
+        manifest: dict[str, Any], use_cache: bool = True
+    ) -> tuple[bool, str | None, list[str] | None]:
         """
         Validate manifest asynchronously.
 
@@ -2902,10 +2903,10 @@ class ManifestValidator:
 
     @staticmethod
     async def validate_with_db(
-        manifest: Dict[str, Any],
+        manifest: dict[str, Any],
         db_validator: Callable[[str], Awaitable[bool]],
         use_cache: bool = True,
-    ) -> Tuple[bool, Optional[str], Optional[List[str]]]:
+    ) -> tuple[bool, str | None, list[str] | None]:
         """
         Validate manifest and check developer_id exists in database.
 
@@ -2921,8 +2922,8 @@ class ManifestValidator:
 
     @staticmethod
     def validate_managed_indexes(
-        managed_indexes: Dict[str, List[Dict[str, Any]]],
-    ) -> Tuple[bool, Optional[str]]:
+        managed_indexes: dict[str, list[dict[str, Any]]],
+    ) -> tuple[bool, str | None]:
         """
         Validate managed indexes configuration.
 
@@ -2936,8 +2937,8 @@ class ManifestValidator:
 
     @staticmethod
     def validate_index_definition(
-        index_def: Dict[str, Any], collection_name: str, index_name: str
-    ) -> Tuple[bool, Optional[str]]:
+        index_def: dict[str, Any], collection_name: str, index_name: str
+    ) -> tuple[bool, str | None]:
         """
         Validate a single index definition.
 
@@ -2952,7 +2953,7 @@ class ManifestValidator:
         return validate_index_definition(index_def, collection_name, index_name)
 
     @staticmethod
-    def get_schema_version(manifest: Dict[str, Any]) -> str:
+    def get_schema_version(manifest: dict[str, Any]) -> str:
         """
             Get schema version from manifest.
 
@@ -2966,8 +2967,8 @@ class ManifestValidator:
 
     @staticmethod
     def migrate(
-        manifest: Dict[str, Any], target_version: str = CURRENT_SCHEMA_VERSION
-    ) -> Dict[str, Any]:
+        manifest: dict[str, Any], target_version: str = CURRENT_SCHEMA_VERSION
+    ) -> dict[str, Any]:
         """
         Migrate manifest to target schema version.
 
@@ -2994,7 +2995,7 @@ class ManifestParser:
     with automatic validation and migration.
     """
 
-    def __init__(self, validator: Optional[ManifestValidator] = None):
+    def __init__(self, validator: ManifestValidator | None = None):
         """
         Initialize parser.
 
@@ -3004,7 +3005,7 @@ class ManifestParser:
         self.validator = validator or ManifestValidator()
 
     @staticmethod
-    async def load_from_file(path: Any, validate: bool = True) -> Dict[str, Any]:
+    async def load_from_file(path: Any, validate: bool = True) -> dict[str, Any]:
         """
         Load and validate manifest from file.
 
@@ -3041,7 +3042,7 @@ class ManifestParser:
         return manifest_data
 
     @staticmethod
-    async def load_from_dict(data: Dict[str, Any], validate: bool = True) -> Dict[str, Any]:
+    async def load_from_dict(data: dict[str, Any], validate: bool = True) -> dict[str, Any]:
         """
         Load and validate manifest from dictionary.
 
@@ -3065,7 +3066,7 @@ class ManifestParser:
         return data.copy()
 
     @staticmethod
-    async def load_from_string(content: str, validate: bool = True) -> Dict[str, Any]:
+    async def load_from_string(content: str, validate: bool = True) -> dict[str, Any]:
         """
         Load and validate manifest from JSON string.
 
@@ -3087,8 +3088,8 @@ class ManifestParser:
 
     @staticmethod
     async def load_and_migrate(
-        manifest: Dict[str, Any], target_version: str = CURRENT_SCHEMA_VERSION
-    ) -> Dict[str, Any]:
+        manifest: dict[str, Any], target_version: str = CURRENT_SCHEMA_VERSION
+    ) -> dict[str, Any]:
         """
         Load manifest and migrate to target version.
 

mdb_engine/core/ray_integration.py

@@ -25,7 +25,8 @@ This module is part of MDB_ENGINE - MongoDB Engine.
 
 import logging
 import os
-from typing import TYPE_CHECKING, Any, Callable, Optional, TypeVar
+from collections.abc import Callable
+from typing import TYPE_CHECKING, Any, TypeVar
 
 if TYPE_CHECKING:
     pass
@@ -132,7 +133,7 @@ class AppRayActor:
             else:
                 raise
 
-    async def get_app_db(self, app_token: Optional[str] = None) -> Any:
+    async def get_app_db(self, app_token: str | None = None) -> Any:
         """
         Get scoped database for this app.
 
@@ -191,11 +192,11 @@ class AppRayActor:
 async def get_ray_actor_handle(
     app_slug: str,
     namespace: str = "modular_labs",
-    mongo_uri: Optional[str] = None,
-    db_name: Optional[str] = None,
+    mongo_uri: str | None = None,
+    db_name: str | None = None,
     create_if_missing: bool = True,
-    actor_class: Optional[type] = None,
-) -> Optional[Any]:
+    actor_class: type | None = None,
+) -> Any | None:
     """
     Get or create a Ray actor handle for an app.
 
@@ -294,7 +295,7 @@ async def get_ray_actor_handle(
 
 
 def ray_actor_decorator(
-    app_slug: Optional[str] = None,
+    app_slug: str | None = None,
     namespace: str = "modular_labs",
     isolated: bool = True,
     lifetime: str = "detached",
@@ -369,8 +370,8 @@ def ray_actor_decorator(
         def spawn(
             cls,
             *args,
-            mongo_uri: Optional[str] = None,
-            db_name: Optional[str] = None,
+            mongo_uri: str | None = None,
+            db_name: str | None = None,
             **kwargs,
         ):
             """

mdb_engine/core/seeding.py

@@ -8,7 +8,7 @@ This module is part of MDB_ENGINE - MongoDB Engine.
 
 import logging
 from datetime import datetime
-from typing import Any, Dict, List
+from typing import Any
 
 from pymongo.errors import (
     ConnectionFailure,
@@ -20,8 +20,8 @@ logger = logging.getLogger(__name__)
 
 
 async def seed_initial_data(
-    db, app_slug: str, initial_data: Dict[str, List[Dict[str, Any]]]
-) -> Dict[str, int]:
+    db, app_slug: str, initial_data: dict[str, list[dict[str, Any]]]
+) -> dict[str, int]:
     """
     Seed initial data into collections.
 

mdb_engine/core/service_initialization.py

@@ -11,7 +11,8 @@ This module is part of MDB_ENGINE - MongoDB Engine.
 """
 
 import logging
-from typing import Any, Callable, Dict, List, Optional
+from collections.abc import Callable
+from typing import Any
 
 from pymongo.errors import (
     ConnectionFailure,
@@ -50,10 +51,10 @@ class ServiceInitializer:
         self.mongo_uri = mongo_uri
         self.db_name = db_name
         self.get_scoped_db_fn = get_scoped_db_fn
-        self._memory_services: Dict[str, Any] = {}
-        self._websocket_configs: Dict[str, Dict[str, Any]] = {}
+        self._memory_services: dict[str, Any] = {}
+        self._websocket_configs: dict[str, dict[str, Any]] = {}
 
-    async def initialize_memory_service(self, slug: str, memory_config: Dict[str, Any]) -> None:
+    async def initialize_memory_service(self, slug: str, memory_config: dict[str, Any]) -> None:
         """
         Initialize Mem0 memory service for an app.
 
@@ -151,7 +152,7 @@ class ServiceInitializer:
                 exc_info=True,
             )
 
-    async def register_websockets(self, slug: str, websockets_config: Dict[str, Any]) -> None:
+    async def register_websockets(self, slug: str, websockets_config: dict[str, Any]) -> None:
         """
         Register WebSocket endpoints for an app.
 
@@ -195,7 +196,7 @@ class ServiceInitializer:
             )
 
     async def seed_initial_data(
-        self, slug: str, initial_data: Dict[str, List[Dict[str, Any]]]
+        self, slug: str, initial_data: dict[str, list[dict[str, Any]]]
     ) -> None:
         """
         Seed initial data into collections for an app.
@@ -240,7 +241,7 @@ class ServiceInitializer:
             )
 
     async def setup_observability(
-        self, slug: str, manifest: Dict[str, Any], observability_config: Dict[str, Any]
+        self, slug: str, manifest: dict[str, Any], observability_config: dict[str, Any]
     ) -> None:
         """
         Set up observability features (health checks, metrics, logging) from manifest.
@@ -296,7 +297,7 @@ class ServiceInitializer:
                 f"Could not set up observability for {slug}: {e}", exc_info=True
             )
 
-    def get_websocket_config(self, slug: str) -> Optional[Dict[str, Any]]:
+    def get_websocket_config(self, slug: str) -> dict[str, Any] | None:
         """
         Get WebSocket configuration for an app.
 
@@ -308,7 +309,7 @@ class ServiceInitializer:
         """
         return self._websocket_configs.get(slug)
 
-    def get_memory_service(self, slug: str) -> Optional[Any]:
+    def get_memory_service(self, slug: str) -> Any | None:
         """
         Get Mem0 memory service for an app.
 

mdb_engine/core/types.py

@@ -8,7 +8,7 @@ throughout the codebase.
 This module is part of MDB_ENGINE - MongoDB Engine.
 """
 
-from typing import TYPE_CHECKING, Any, Dict, List, Literal, Optional, TypedDict, Union
+from typing import TYPE_CHECKING, Any, Literal, TypedDict
 
 if TYPE_CHECKING:
     from ..memory import Mem0MemoryService
@@ -41,20 +41,20 @@ class IndexDefinitionDict(TypedDict, total=False):
         "partial",
         "hybrid",
     ]
-    keys: Union[Dict[str, Union[int, str]], List[List[Union[str, int]]]]
+    keys: dict[str, int | str] | list[list[str | int]]
     unique: bool
     sparse: bool
     background: bool
     expireAfterSeconds: int
-    partialFilterExpression: Dict[str, Any]
-    weights: Dict[str, int]  # For text indexes
+    partialFilterExpression: dict[str, Any]
+    weights: dict[str, int]  # For text indexes
     default_language: str  # For text indexes
     language_override: str  # For text indexes
     textIndexVersion: int  # For text indexes
     # Vector search specific
-    fields: List[Dict[str, Any]]  # For vectorSearch indexes
+    fields: list[dict[str, Any]]  # For vectorSearch indexes
     # Search index specific
-    mappings: Dict[str, Any]  # For search indexes
+    mappings: dict[str, Any]  # For search indexes
     # Geospatial specific
     bucketSize: float  # For geoHaystack
     # TTL specific
@@ -79,12 +79,12 @@ class AuthAuthorizationDict(TypedDict, total=False):
     model: str
     policies_collection: str
     link_users_roles: bool
-    default_roles: List[str]
+    default_roles: list[str]
     # OSO-specific
-    api_key: Optional[str]
-    url: Optional[str]
-    initial_roles: List[Dict[str, str]]
-    initial_policies: List[Dict[str, str]]
+    api_key: str | None
+    url: str | None
+    initial_roles: list[dict[str, str]]
+    initial_policies: list[dict[str, str]]
 
 
 class AuthPolicyDict(TypedDict, total=False):
@@ -93,12 +93,12 @@ class AuthPolicyDict(TypedDict, total=False):
     required: bool
     provider: Literal["casbin", "oso", "custom"]
     authorization: AuthAuthorizationDict
-    allowed_roles: List[str]
-    allowed_users: List[str]
-    denied_users: List[str]
-    required_permissions: List[str]
+    allowed_roles: list[str]
+    allowed_users: list[str]
+    denied_users: list[str]
+    required_permissions: list[str]
     custom_resource: str
-    custom_actions: List[Literal["access", "read", "write", "admin"]]
+    custom_actions: list[Literal["access", "read", "write", "admin"]]
     allow_anonymous: bool
     owner_can_access: bool
 
@@ -111,7 +111,7 @@ class DemoUserDict(TypedDict, total=False):
     role: str
     auto_create: bool
     link_to_platform: bool
-    extra_data: Dict[str, Any]
+    extra_data: dict[str, Any]
 
 
 class UsersConfigDict(TypedDict, total=False):
@@ -126,7 +126,7 @@ class UsersConfigDict(TypedDict, total=False):
     link_platform_users: bool
     anonymous_user_prefix: str
     user_id_field: str
-    demo_users: List[DemoUserDict]
+    demo_users: list[DemoUserDict]
     auto_link_platform_demo: bool
     demo_user_seed_strategy: Literal["auto", "manual", "disabled"]
     enable_demo_user_access: bool
@@ -312,7 +312,7 @@ class MetricsConfigDict(TypedDict, total=False):
     enabled: bool
     collect_operation_metrics: bool
     collect_performance_metrics: bool
-    custom_metrics: List[str]
+    custom_metrics: list[str]
 
 
 class LoggingConfigDict(TypedDict, total=False):
@@ -341,11 +341,11 @@ class CORSConfigDict(TypedDict, total=False):
     """CORS configuration."""
 
     enabled: bool
-    allow_origins: List[str]
+    allow_origins: list[str]
     allow_credentials: bool
-    allow_methods: List[Literal["GET", "POST", "PUT", "DELETE", "PATCH", "OPTIONS", "HEAD", "*"]]
-    allow_headers: List[str]
-    expose_headers: List[str]
+    allow_methods: list[Literal["GET", "POST", "PUT", "DELETE", "PATCH", "OPTIONS", "HEAD", "*"]]
+    allow_headers: list[str]
+    expose_headers: list[str]
     max_age: int
 
 
@@ -371,22 +371,22 @@ class ManifestDict(TypedDict, total=False):
     schema_version: str
     slug: str
     name: str
-    description: Optional[str]
+    description: str | None
     status: Literal["active", "draft", "archived", "inactive"]
     auth_required: bool  # Backward compatibility
-    auth: Optional[AuthConfigDict]
-    token_management: Optional[TokenManagementDict]
-    data_scope: List[str]
-    pip_deps: List[str]
-    managed_indexes: Optional[ManagedIndexesDict]
-    collection_settings: Optional[Dict[str, Dict[str, Any]]]
-    websockets: Optional[WebSocketsDict]
-    embedding_config: Optional[EmbeddingConfigDict]
-    memory_config: Optional[MemoryConfigDict]
-    cors: Optional[CORSConfigDict]
-    observability: Optional[ObservabilityConfigDict]
-    initial_data: Optional[InitialDataDict]
-    developer_id: Optional[str]
+    auth: AuthConfigDict | None
+    token_management: TokenManagementDict | None
+    data_scope: list[str]
+    pip_deps: list[str]
+    managed_indexes: ManagedIndexesDict | None
+    collection_settings: dict[str, dict[str, Any]] | None
+    websockets: WebSocketsDict | None
+    embedding_config: EmbeddingConfigDict | None
+    memory_config: MemoryConfigDict | None
+    cors: CORSConfigDict | None
+    observability: ObservabilityConfigDict | None
+    initial_data: InitialDataDict | None
+    developer_id: str | None
 
 
 # ============================================================================
@@ -398,13 +398,13 @@ class HealthStatusDict(TypedDict, total=False):
     """Health status response."""
 
     status: Literal["healthy", "degraded", "unhealthy"]
-    checks: Dict[str, Dict[str, Any]]
+    checks: dict[str, dict[str, Any]]
     timestamp: str
 
 
 class MetricsDict(TypedDict, total=False):
     """Metrics response."""
 
-    operations: Dict[str, Dict[str, Any]]
-    summary: Dict[str, Any]
+    operations: dict[str, dict[str, Any]]
+    summary: dict[str, Any]
     timestamp: str