homesec 0.1.1__py3-none-any.whl → 1.0.0__py3-none-any.whl

homesec/maintenance/cleanup_clips.py

@@ -62,7 +62,7 @@ class _Counts:
     delete_errors: int = 0
     state_errors: int = 0
 
-    def __add__(self, other: "_Counts") -> "_Counts":
+    def __add__(self, other: _Counts) -> _Counts:
         return _Counts(
             scanned_rows=self.scanned_rows + other.scanned_rows,
             candidates=self.candidates + other.candidates,
@@ -206,8 +206,7 @@ async def run_cleanup(opts: CleanupOptions) -> None:
             candidates: list[tuple[str, ClipStateData, datetime]] = [
                 (clip_id, state, created_at)
                 for clip_id, state, created_at in rows
-                if state.filter_result is not None
-                and not state.filter_result.detected_classes
+                if state.filter_result is not None and not state.filter_result.detected_classes
             ]
             totals = totals + _Counts(candidates=len(candidates))
 

homesec/models/__init__.py

@@ -5,11 +5,11 @@ from homesec.models.clip import Clip, ClipStateData, _resolve_forward_refs
 from homesec.models.config import (
     AlertPolicyConfig,
     AlertPolicyOverrides,
-    DefaultAlertPolicySettings,
     CameraConfig,
     CameraSourceConfig,
     ConcurrencyConfig,
     Config,
+    DefaultAlertPolicySettings,
     DropboxStorageConfig,
     HealthConfig,
     LocalStorageConfig,

homesec/models/alert.py

@@ -3,10 +3,12 @@
 from __future__ import annotations
 
 from datetime import datetime
+
 from pydantic import BaseModel
 
 from homesec.models.vlm import RiskLevel, SequenceAnalysis
 
+
 class AlertDecision(BaseModel):
     """Decision whether to send an alert for a clip."""
 

homesec/models/clip.py

@@ -64,8 +64,15 @@ class ClipStateData(BaseModel):
 # Resolve forward references after imports are available
 def _resolve_forward_refs() -> None:
     """Resolve forward references in ClipStateData."""
+    # Explicitly import types to make them available for model_rebuild
     from homesec.models.alert import AlertDecision
     from homesec.models.filter import FilterResult
     from homesec.models.vlm import AnalysisResult
 
-    ClipStateData.model_rebuild()
+    ClipStateData.model_rebuild(
+        _types_namespace={
+            "FilterResult": FilterResult,
+            "AnalysisResult": AnalysisResult,
+            "AlertDecision": AlertDecision,
+        }
+    )

homesec/models/config.py

@@ -9,10 +9,8 @@ from pydantic import BaseModel, Field, model_validator
 from homesec.models.filter import FilterConfig
 from homesec.models.source import FtpSourceConfig, LocalFolderSourceConfig, RTSPSourceConfig
 from homesec.models.vlm import (
-    OpenAILLMConfig,
     RiskLevel,
     VLMConfig,
-    VLMPreprocessConfig,
 )
 
 
@@ -40,7 +38,7 @@ class AlertPolicyConfig(BaseModel):
     config: dict[str, object] = Field(default_factory=dict)
 
     @model_validator(mode="after")
-    def _validate_alert_policy(self) -> "AlertPolicyConfig":
+    def _validate_alert_policy(self) -> AlertPolicyConfig:
         if self.backend == "default":
             DefaultAlertPolicySettings.model_validate(self.config)
         return self
@@ -86,7 +84,7 @@ class StorageConfig(BaseModel):
     paths: StoragePathsConfig = Field(default_factory=StoragePathsConfig)
 
     @model_validator(mode="after")
-    def _validate_builtin_backends(self) -> "StorageConfig":
+    def _validate_builtin_backends(self) -> StorageConfig:
         """Validate that built-in backends have their required config.
 
         Third-party backends are validated later in create_storage().
@@ -117,7 +115,7 @@ class StateStoreConfig(BaseModel):
     dsn: str | None = None
 
     @model_validator(mode="after")
-    def _validate_backend(self) -> "StateStoreConfig":
+    def _validate_backend(self) -> StateStoreConfig:
         if not (self.dsn_env or self.dsn):
             raise ValueError("state_store.dsn_env or state_store.dsn required for postgres")
         return self
@@ -174,7 +172,7 @@ class SendGridEmailConfig(BaseModel):
         "<p><strong>Activity:</strong> {activity_type}</p>"
         "<p><strong>Reason:</strong> {notify_reason}</p>"
         "<p><strong>Summary:</strong> {summary}</p>"
-        "<p><strong>View:</strong> <a href=\"{view_url}\">{view_url}</a></p>"
+        '<p><strong>View:</strong> <a href="{view_url}">{view_url}</a></p>'
         "<p><strong>Storage:</strong> {storage_uri}</p>"
         "<p><strong>Time:</strong> {ts}</p>"
         "<p><strong>Upload failed:</strong> {upload_failed}</p>"
@@ -186,7 +184,7 @@ class SendGridEmailConfig(BaseModel):
     api_base: str = "https://api.sendgrid.com/v3"
 
     @model_validator(mode="after")
-    def _validate_templates(self) -> "SendGridEmailConfig":
+    def _validate_templates(self) -> SendGridEmailConfig:
         if not self.text_template and not self.html_template:
             raise ValueError("sendgrid_email requires at least one of text_template/html_template")
         return self
@@ -245,9 +243,7 @@ class CameraSourceConfig(BaseModel):
             return data
         source_type = data.get("type")
         raw_config = data.get("config")
-        if isinstance(
-            raw_config, (RTSPSourceConfig, LocalFolderSourceConfig, FtpSourceConfig)
-        ):
+        if isinstance(raw_config, (RTSPSourceConfig, LocalFolderSourceConfig, FtpSourceConfig)):
             return data
 
         config_data = raw_config or {}
@@ -262,7 +258,7 @@ class CameraSourceConfig(BaseModel):
         return updated
 
     @model_validator(mode="after")
-    def _validate_source_config(self) -> "CameraSourceConfig":
+    def _validate_source_config(self) -> CameraSourceConfig:
         match self.type:
             case "rtsp":
                 if not isinstance(self.config, RTSPSourceConfig):
@@ -308,13 +304,13 @@ class Config(BaseModel):
     per_camera_alert: dict[str, AlertPolicyOverrides] = Field(default_factory=dict)
 
     @model_validator(mode="after")
-    def _validate_notifiers(self) -> "Config":
+    def _validate_notifiers(self) -> Config:
         if not self.notifiers:
             raise ValueError("notifiers must include at least one notifier")
         return self
 
     @model_validator(mode="after")
-    def _validate_builtin_plugin_configs(self) -> "Config":
+    def _validate_builtin_plugin_configs(self) -> Config:
         """Validate built-in plugin configs for early error detection.
 
         Third-party plugin configs are validated later during plugin loading.

homesec/models/events.py

@@ -12,6 +12,7 @@ from homesec.models.filter import FilterResult
 
 class ClipEvent(BaseModel):
     """Base class for all clip lifecycle events."""
+
     id: int | None = None
     clip_id: str
     timestamp: datetime
@@ -53,6 +54,7 @@ class ClipRecheckedEvent(ClipEvent):
 
 class UploadStartedEvent(ClipEvent):
     """Upload to storage backend started."""
+
     event_type: Literal["upload_started"] = "upload_started"
     dest_key: str
     attempt: int
@@ -60,6 +62,7 @@ class UploadStartedEvent(ClipEvent):
 
 class UploadCompletedEvent(ClipEvent):
     """Upload to storage backend completed successfully."""
+
     event_type: Literal["upload_completed"] = "upload_completed"
     storage_uri: str
     view_url: str | None
@@ -69,6 +72,7 @@ class UploadCompletedEvent(ClipEvent):
 
 class UploadFailedEvent(ClipEvent):
     """Upload to storage backend failed."""
+
     event_type: Literal["upload_failed"] = "upload_failed"
     attempt: int
     error_message: str
@@ -78,12 +82,14 @@ class UploadFailedEvent(ClipEvent):
 
 class FilterStartedEvent(ClipEvent):
     """Object detection filter started."""
+
     event_type: Literal["filter_started"] = "filter_started"
     attempt: int
 
 
 class FilterCompletedEvent(ClipEvent):
     """Object detection filter completed."""
+
     event_type: Literal["filter_completed"] = "filter_completed"
     detected_classes: list[str]
     confidence: float
@@ -95,6 +101,7 @@ class FilterCompletedEvent(ClipEvent):
 
 class FilterFailedEvent(ClipEvent):
     """Object detection filter failed."""
+
     event_type: Literal["filter_failed"] = "filter_failed"
     attempt: int
     error_message: str
@@ -104,12 +111,14 @@ class FilterFailedEvent(ClipEvent):
 
 class VLMStartedEvent(ClipEvent):
     """VLM analysis started."""
+
     event_type: Literal["vlm_started"] = "vlm_started"
     attempt: int
 
 
 class VLMCompletedEvent(ClipEvent):
     """VLM analysis completed."""
+
     event_type: Literal["vlm_completed"] = "vlm_completed"
     risk_level: str
     activity_type: str
@@ -123,6 +132,7 @@ class VLMCompletedEvent(ClipEvent):
 
 class VLMFailedEvent(ClipEvent):
     """VLM analysis failed."""
+
     event_type: Literal["vlm_failed"] = "vlm_failed"
     attempt: int
     error_message: str
@@ -132,12 +142,14 @@ class VLMFailedEvent(ClipEvent):
 
 class VLMSkippedEvent(ClipEvent):
     """VLM analysis skipped (no trigger classes detected)."""
+
     event_type: Literal["vlm_skipped"] = "vlm_skipped"
     reason: str
 
 
 class AlertDecisionMadeEvent(ClipEvent):
     """Alert policy decision made."""
+
     event_type: Literal["alert_decision_made"] = "alert_decision_made"
     should_notify: bool
     reason: str
@@ -147,6 +159,7 @@ class AlertDecisionMadeEvent(ClipEvent):
 
 class NotificationSentEvent(ClipEvent):
     """Notification sent successfully."""
+
     event_type: Literal["notification_sent"] = "notification_sent"
     notifier_name: str
     dedupe_key: str
@@ -155,6 +168,7 @@ class NotificationSentEvent(ClipEvent):
 
 class NotificationFailedEvent(ClipEvent):
     """Notification send failed."""
+
     event_type: Literal["notification_failed"] = "notification_failed"
     notifier_name: str
     error_message: str

homesec/models/filter.py

@@ -2,9 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Literal
-
-from pydantic import BaseModel, Field, model_validator
+from pydantic import BaseModel, Field
 
 
 class FilterResult(BaseModel):

homesec/models/vlm.py

@@ -4,8 +4,7 @@ from __future__ import annotations
 
 from typing import Literal
 
-from pydantic import BaseModel, Field, model_validator
-
+from pydantic import BaseModel, Field
 
 RiskLevel = Literal["low", "medium", "high", "critical"]
 

homesec/pipeline/core.py

@@ -16,8 +16,8 @@ from homesec.models.clip import Clip
 from homesec.models.config import Config
 from homesec.models.filter import FilterResult
 from homesec.models.vlm import AnalysisResult
-from homesec.repository import ClipRepository
 from homesec.plugins.notifiers.multiplex import NotifierEntry
+from homesec.repository import ClipRepository
 from homesec.storage_paths import build_clip_path
 
 if TYPE_CHECKING:
@@ -42,7 +42,7 @@ class UploadOutcome:
 
 class ClipPipeline:
     """Orchestrates clip processing through all pipeline stages.
-    
+
     Implements error-as-value pattern: stage methods return Result | Error
     instead of raising. This enables partial failures (e.g., upload fails
     but filter+notify still run).
@@ -56,7 +56,7 @@ class ClipPipeline:
         filter_plugin: ObjectFilter,
         vlm_plugin: VLMAnalyzer,
         notifier: Notifier,
-        alert_policy: "AlertPolicy",
+        alert_policy: AlertPolicy,
         notifier_entries: list[NotifierEntry] | None = None,
     ) -> None:
         """Initialize pipeline with all dependencies."""
@@ -66,9 +66,7 @@ class ClipPipeline:
         self._filter = filter_plugin
         self._vlm = vlm_plugin
         self._notifier = notifier
-        self._notifier_entries = self._resolve_notifier_entries(
-            notifier, notifier_entries
-        )
+        self._notifier_entries = self._resolve_notifier_entries(notifier, notifier_entries)
         self._alert_policy = alert_policy
 
         # Track in-flight processing
@@ -79,7 +77,7 @@ class ClipPipeline:
         self._sem_upload = asyncio.Semaphore(config.concurrency.upload_workers)
         self._sem_filter = asyncio.Semaphore(config.concurrency.filter_workers)
         self._sem_vlm = asyncio.Semaphore(config.concurrency.vlm_workers)
-        
+
         # Event loop for thread-safe callback handling
         self._loop: asyncio.AbstractEventLoop | None = None
 
@@ -95,7 +93,7 @@ class ClipPipeline:
 
     def set_event_loop(self, loop: asyncio.AbstractEventLoop) -> None:
         """Set event loop for thread-safe callback handling.
-        
+
         Must be called before registering with ClipSource if source
         runs in a different thread.
         """
@@ -119,7 +117,7 @@ class ClipPipeline:
 
     def on_new_clip(self, clip: Clip) -> None:
         """Callback for ClipSource when new clip is ready.
-        
+
         Thread-safe: can be called from any thread. Uses stored event loop
         if available, otherwise tries to get current loop.
         """
@@ -146,7 +144,7 @@ class ClipPipeline:
 
     async def _process_clip(self, clip: Clip) -> None:
         """Process a single clip through all stages.
-        
+
         Flow:
         1. Parallel: upload + filter
         2. Conditional: VLM (if filter detects trigger classes)
@@ -214,9 +212,7 @@ class ClipPipeline:
                             analysis_result.activity_type,
                         )
                     case _:
-                        raise TypeError(
-                            f"Unexpected VLM result type: {type(vlm_result).__name__}"
-                        )
+                        raise TypeError(f"Unexpected VLM result type: {type(vlm_result).__name__}")
             else:
                 await self._repository.record_vlm_skipped(
                     clip.clip_id,
@@ -286,8 +282,7 @@ class ClipPipeline:
         op: Callable[[], Awaitable[TResult]],
         on_attempt_start: Callable[[int], Awaitable[None]] | None = None,
         on_attempt_success: Callable[[TResult, int, int], Awaitable[None]] | None = None,
-        on_attempt_failure: Callable[[Exception, int, bool, int], Awaitable[None]]
-        | None = None,
+        on_attempt_failure: Callable[[Exception, int, bool, int], Awaitable[None]] | None = None,
     ) -> TResult:
         """Run stage with retry logic and event emission."""
         max_attempts = max(1, int(self._config.retry.max_attempts))
@@ -432,9 +427,7 @@ class ClipPipeline:
 
         async def attempt() -> AnalysisResult:
             async with self._sem_vlm:
-                return await self._vlm.analyze(
-                    clip.local_path, filter_result, self._config.vlm
-                )
+                return await self._vlm.analyze(clip.local_path, filter_result, self._config.vlm)
 
         async def on_attempt_start(attempt_num: int) -> None:
             await self._repository.record_vlm_started(clip.clip_id, attempt=attempt_num)
@@ -501,10 +494,7 @@ class ClipPipeline:
             vlm_failed=vlm_failed,
         )
 
-        tasks = [
-            self._notify_with_entry(entry, alert)
-            for entry in self._notifier_entries
-        ]
+        tasks = [self._notify_with_entry(entry, alert) for entry in self._notifier_entries]
         results = await asyncio.gather(*tasks)
 
         errors: list[NotifyError] = []
@@ -515,9 +505,7 @@ class ClipPipeline:
                 case None:
                     continue
                 case _:
-                    raise TypeError(
-                        f"Unexpected notify result type: {type(result).__name__}"
-                    )
+                    raise TypeError(f"Unexpected notify result type: {type(result).__name__}")
 
         if errors:
             return errors[0]
@@ -530,9 +518,7 @@ class ClipPipeline:
     ) -> None | NotifyError:
         notifier_name = entry.name
 
-        async def on_attempt_success(
-            _result: object, attempt_num: int, _duration_ms: int
-        ) -> None:
+        async def on_attempt_success(_result: object, attempt_num: int, _duration_ms: int) -> None:
             await self._repository.record_notification_sent(
                 alert.clip_id,
                 notifier_name=notifier_name,
@@ -609,13 +595,10 @@ class ClipPipeline:
                 storage_uri = outcome.storage_uri
                 view_url = outcome.view_url
             case _:
-                raise TypeError(
-                    f"Unexpected upload result type: {type(upload_result).__name__}"
-                )
+                raise TypeError(f"Unexpected upload result type: {type(upload_result).__name__}")
         logger.info("Upload complete for %s: %s", clip.clip_id, storage_uri)
         return storage_uri, view_url, False
 
-
     async def shutdown(self, timeout: float = 30.0) -> None:
         """Graceful shutdown of pipeline.
 

homesec/plugins/alert_policies/__init__.py

@@ -3,8 +3,9 @@
 from __future__ import annotations
 
 import logging
+from collections.abc import Callable
 from dataclasses import dataclass
-from typing import Callable, TypeVar
+from typing import TypeVar
 
 from pydantic import BaseModel
 
@@ -14,9 +15,7 @@ from homesec.models.config import AlertPolicyOverrides
 logger = logging.getLogger(__name__)
 
 
-AlertPolicyFactory = Callable[
-    [BaseModel, dict[str, AlertPolicyOverrides], list[str]], AlertPolicy
-]
+AlertPolicyFactory = Callable[[BaseModel, dict[str, AlertPolicyOverrides], list[str]], AlertPolicy]
 
 
 @dataclass(frozen=True)

homesec/plugins/alert_policies/default.py

@@ -83,8 +83,9 @@ class DefaultAlertPolicy(AlertPolicy):
 
 # Plugin registration
 from pydantic import BaseModel
-from homesec.plugins.alert_policies import AlertPolicyPlugin, alert_policy_plugin
+
 from homesec.interfaces import AlertPolicy
+from homesec.plugins.alert_policies import AlertPolicyPlugin, alert_policy_plugin
 
 
 @alert_policy_plugin(name="default")
@@ -94,7 +95,7 @@ def default_alert_policy_plugin() -> AlertPolicyPlugin:
     Returns:
         AlertPolicyPlugin for default risk-based alert policy
     """
-    from homesec.models.config import AlertPolicyOverrides, DefaultAlertPolicySettings
+    from homesec.models.config import DefaultAlertPolicySettings
 
     def factory(
         cfg: BaseModel,

homesec/plugins/alert_policies/noop.py

@@ -32,9 +32,8 @@ class NoopAlertPolicy(AlertPolicy):
 
 
 # Plugin registration
-from pydantic import BaseModel
-from homesec.plugins.alert_policies import AlertPolicyPlugin, alert_policy_plugin
 from homesec.interfaces import AlertPolicy
+from homesec.plugins.alert_policies import AlertPolicyPlugin, alert_policy_plugin
 
 
 @alert_policy_plugin(name="noop")

homesec/plugins/analyzers/__init__.py

@@ -3,8 +3,9 @@
 from __future__ import annotations
 
 import logging
+from collections.abc import Callable
 from dataclasses import dataclass
-from typing import Callable, TYPE_CHECKING, TypeVar
+from typing import TYPE_CHECKING, TypeVar
 
 from pydantic import BaseModel
 
@@ -93,9 +94,7 @@ def load_vlm_plugin(config: VLMConfig) -> VLMAnalyzer:
 
     if plugin_name not in VLM_REGISTRY:
         available = ", ".join(sorted(VLM_REGISTRY.keys()))
-        raise ValueError(
-            f"Unknown VLM plugin: '{plugin_name}'. Available: {available}"
-        )
+        raise ValueError(f"Unknown VLM plugin: '{plugin_name}'. Available: {available}")
 
     plugin = VLM_REGISTRY[plugin_name]