homesec 1.2.2__py3-none-any.whl → 1.2.3__py3-none-any.whl

homesec/sources/rtsp/core.py

@@ -17,9 +17,9 @@ from pathlib import Path
 
 import numpy as np
 import numpy.typing as npt
+from pydantic import BaseModel, Field, model_validator
 
 from homesec.models.clip import Clip
-from homesec.models.source.rtsp import RTSPSourceConfig
 from homesec.sources.base import ThreadedClipSource
 from homesec.sources.rtsp.clock import Clock, SystemClock
 from homesec.sources.rtsp.frame_pipeline import FfmpegFramePipeline, FramePipeline
@@ -36,6 +36,166 @@ from homesec.sources.rtsp.utils import (
 logger = logging.getLogger(__name__)
 
 
+class RTSPMotionConfig(BaseModel):
+    """Motion detection configuration."""
+
+    model_config = {"extra": "forbid"}
+
+    pixel_threshold: int = Field(
+        default=45,
+        ge=0,
+        description="Pixel intensity delta required to count a pixel as changed.",
+    )
+    min_changed_pct: float = Field(
+        default=1.0,
+        ge=0.0,
+        description="Percent of pixels that must change to trigger motion (idle state).",
+    )
+    recording_sensitivity_factor: float = Field(
+        default=2.0,
+        ge=1.0,
+        description="Factor to reduce the threshold while recording (>=1.0).",
+    )
+    blur_kernel: int = Field(
+        default=5,
+        ge=0,
+        description="Gaussian blur kernel size (odd or zero; even values are normalized).",
+    )
+
+
+class RTSPRecordingConfig(BaseModel):
+    """Recording lifecycle configuration."""
+
+    model_config = {"extra": "forbid"}
+
+    stop_delay: float = Field(
+        default=10.0,
+        ge=0.0,
+        description="Seconds to keep recording after motion stops.",
+    )
+    max_recording_s: float = Field(
+        default=60.0,
+        gt=0.0,
+        description="Maximum seconds per recording before rotating.",
+    )
+
+
+class RTSPStreamConfig(BaseModel):
+    """RTSP/ffmpeg transport configuration."""
+
+    model_config = {"extra": "forbid"}
+
+    connect_timeout_s: float = Field(
+        default=2.0,
+        ge=0.0,
+        description="RTSP connect timeout (seconds) passed to ffmpeg/ffprobe when supported.",
+    )
+    io_timeout_s: float = Field(
+        default=2.0,
+        ge=0.0,
+        description="RTSP I/O timeout (seconds) passed to ffmpeg/ffprobe when supported.",
+    )
+    ffmpeg_flags: list[str] = Field(
+        default_factory=list,
+        description="Additional ffmpeg flags appended to the command.",
+    )
+    disable_hwaccel: bool = Field(
+        default=False,
+        description="Disable hardware-accelerated decoding.",
+    )
+
+
+class RTSPReconnectConfig(BaseModel):
+    """Reconnect and fallback policy."""
+
+    model_config = {"extra": "forbid"}
+
+    max_attempts: int = Field(
+        default=0,
+        ge=0,
+        description="Max reconnect attempts (0 = retry forever).",
+    )
+    backoff_s: float = Field(
+        default=1.0,
+        ge=0.0,
+        description="Base backoff (seconds) between reconnect attempts.",
+    )
+    detect_fallback_attempts: int = Field(
+        default=3,
+        ge=0,
+        description="Failures before falling back from detect stream to main stream.",
+    )
+
+
+class RTSPRuntimeConfig(BaseModel):
+    """Runtime loop configuration."""
+
+    model_config = {"extra": "forbid"}
+
+    frame_timeout_s: float = Field(
+        default=2.0,
+        ge=0.0,
+        description="Seconds without frames before considering the pipeline stalled.",
+    )
+    frame_queue_size: int = Field(
+        default=20,
+        ge=1,
+        description="Frame queue size used by the frame reader thread.",
+    )
+    heartbeat_s: float = Field(
+        default=30.0,
+        ge=0.0,
+        description="Seconds between heartbeat logs.",
+    )
+    debug_motion: bool = Field(
+        default=False,
+        description="Enable verbose motion detection logging.",
+    )
+
+
+class RTSPSourceConfig(BaseModel):
+    """RTSP source configuration."""
+
+    model_config = {"extra": "forbid"}
+
+    camera_name: str | None = Field(
+        default=None,
+        description="Optional human-friendly camera name.",
+    )
+    rtsp_url_env: str | None = Field(
+        default=None,
+        description="Environment variable containing the RTSP URL.",
+    )
+    rtsp_url: str | None = Field(
+        default=None,
+        description="RTSP URL for the main stream.",
+    )
+    detect_rtsp_url_env: str | None = Field(
+        default=None,
+        description="Environment variable containing the detect stream RTSP URL.",
+    )
+    detect_rtsp_url: str | None = Field(
+        default=None,
+        description="RTSP URL for the detect stream.",
+    )
+    output_dir: str = Field(
+        default="./recordings",
+        description="Directory to store recordings and logs.",
+    )
+
+    motion: RTSPMotionConfig = Field(default_factory=RTSPMotionConfig)
+    recording: RTSPRecordingConfig = Field(default_factory=RTSPRecordingConfig)
+    stream: RTSPStreamConfig = Field(default_factory=RTSPStreamConfig)
+    reconnect: RTSPReconnectConfig = Field(default_factory=RTSPReconnectConfig)
+    runtime: RTSPRuntimeConfig = Field(default_factory=RTSPRuntimeConfig)
+
+    @model_validator(mode="after")
+    def _require_rtsp_url(self) -> RTSPSourceConfig:
+        if not (self.rtsp_url or self.rtsp_url_env):
+            raise ValueError("rtsp_url_env or rtsp_url required for RTSP source")
+        return self
+
+
 class RTSPRunState(str, Enum):
     IDLE = "idle"
     RECORDING = "recording"
@@ -970,7 +1130,7 @@ class RTSPSource(ThreadedClipSource):
             start_ts=start_ts,
             end_ts=end_ts,
             duration_s=duration_s,
-            source_type="rtsp",
+            source_backend="rtsp",
         )
 
         self._emit_clip(clip)

{homesec-1.2.2.dist-info → homesec-1.2.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: homesec
-Version: 1.2.2
+Version: 1.2.3
 Summary: Pluggable async home security camera pipeline with detection, VLM analysis, and alerts.
 Project-URL: Homepage, https://github.com/lan17/homesec
 Project-URL: Source, https://github.com/lan17/homesec
@@ -326,15 +326,10 @@ graph TD
 
 ## Quickstart
 
-### 30-Second Start (Docker)
-The fastest way to see it in action. Includes a pre-configured Postgres and a dummy local source.
+### Docker
+Use the included [docker-compose.yml](docker-compose.yml) (HomeSec + Postgres, pulls `leva/homesec:latest`).
 
-```bash
-git clone https://github.com/lan17/homesec.git
-cd homesec
-make up
-```
-*Modify `config/config.yaml` to add your real cameras, then restart.*
+Configure your own config.yaml and .env files as described in Manual Setup.
 
 ### Manual Setup
 For standard production usage without Docker Compose:
@@ -400,7 +395,7 @@ Best for real-world setups with flaky cameras.
 cameras:
   - name: driveway
     source:
-      type: rtsp
+      backend: rtsp
       config:
         rtsp_url_env: DRIVEWAY_RTSP_URL
         output_dir: "./recordings"
@@ -411,7 +406,7 @@ cameras:
           backoff_s: 5
 
 filter:
-  plugin: yolo
+  backend: yolo
   config:
     classes: ["person", "car"]
     min_confidence: 0.6
@@ -428,7 +423,7 @@ Uploads to Cloud but keeps analysis local.
 ```yaml
 storage:
   backend: dropbox
-  dropbox:
+  config:
     token_env: DROPBOX_TOKEN
     root: "/SecurityCam"
 

homesec-1.2.3.dist-info/RECORD

@@ -0,0 +1,73 @@
+homesec/__init__.py,sha256=i4wRlg0CV3bxbxAWL_uSqW39r_F2sTRBNbelmoYOPuA,452
+homesec/app.py,sha256=QkO_cs10_ARXS4H7fVe1scTfMDWjJPXU2hLVuCcRheA,11860
+homesec/cli.py,sha256=8I8odsgjsZpzpV2AKZNqktx7xcw7n6i_Vzr6mlpNwAM,5685
+homesec/errors.py,sha256=fBW_OdnYgqtb6u6t0YZh4tHgsiv0Pb1DiF9G6b4Vcbk,2105
+homesec/interfaces.py,sha256=O059JmSVcRVWnUspd257ReEjX1zshjoiz86lYa52nsk,9873
+homesec/logging_setup.py,sha256=Z12nzCPK04cqFHfIQgasioGfXb4TLvXJT9stzD8Dh4c,5546
+homesec/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+homesec/storage_paths.py,sha256=MGQNT_7mJS6wuTWUHZNl0hvRmSVRvNksLu_imfZOEpo,1696
+homesec/config/__init__.py,sha256=luKM0A_xT-Ky5-xmwPNA3f1EAYn9oBGCra2Inf6ATFU,538
+homesec/config/loader.py,sha256=lUpry5Ha9Kbd9Rx8SkGMSQ2xt1_-yEfBHldvstuU310,3465
+homesec/config/validation.py,sha256=z_8AN0ytFNme3cApUDwpLZYTKbmOXMsOH5y9Ca-dSJA,7056
+homesec/health/__init__.py,sha256=fbndfsLOR9aA7d_5I1mEZN0oM5IYMmcJNjOt0iaXKZc,107
+homesec/health/server.py,sha256=VP-4XmZ0K3ooFyd000AFOZohZ5R7QcnZC4n7oj0RMqI,7014
+homesec/maintenance/__init__.py,sha256=6a5W2x8oUgnoWaK374-Wq_nrOD5UDAUqUtSANaEck2M,60
+homesec/maintenance/cleanup_clips.py,sha256=H-12mY9yJcmJjh7es0vZLpif0ttj1uTNQ7aWTwEYr4I,24047
+homesec/models/__init__.py,sha256=AZZxyqdNyLqWz8Lg-1IwwEIBsFO1WNsEXNGQinMFRys,1372
+homesec/models/alert.py,sha256=cMFr4NUGygq0-m2ep0jhjzVrFKM7kN1wJON1J0XwGY4,1010
+homesec/models/clip.py,sha256=FNun9yH8gN-Z66zbrFM4FA2gbAwp8iLyOifWLL41qDY,2228
+homesec/models/config.py,sha256=jGsi65mNgfBg1qqh2Urrrt5C9bBmEL0hPX24mqwx1pU,4319
+homesec/models/enums.py,sha256=puyfL8_JQNy3RbML5vkO2vTFMjXTeRgGp7GQhok1SVQ,3446
+homesec/models/events.py,sha256=m3jQM6GrgUCiXj4pXgtaM-EBtL56qE5nqYaXrz3mMuA,4945
+homesec/models/filter.py,sha256=Jqd0nk6hygf-1rB_yjQcabcvVsavk5TY6v3K_v_Xjac,1647
+homesec/models/storage.py,sha256=63wyHdDt3QrfdsP0SmhrxtOeWRllZ1O2GPrA4jI7XmU,235
+homesec/models/vlm.py,sha256=QpwItxAm4k7DM-4GWm-L_ObdBRq4j9hOxoUJI2cTTY0,2966
+homesec/notifiers/multiplex.py,sha256=LlnwozjkMDQwz7__v7mT4AohZbiWZK39CZunamRp7FM,3676
+homesec/pipeline/__init__.py,sha256=7iil1gPFagQIM79hTtmY4gtr8Q-g4HOBI_3BA2CRVHo,131
+homesec/pipeline/core.py,sha256=IhyFNjBL-OMfpj100xv9ddH12-TQxKvi6r3E8nSE3yw,23596
+homesec/plugins/__init__.py,sha256=ex1AY_pJa9PZkr6yaneX3KgImZ-GkenTwExH2cMcF3A,1269
+homesec/plugins/registry.py,sha256=crLQ2Fidni1GNNwuaGGSg66K-e1-nvjiY-KdLTrfjlA,6564
+homesec/plugins/utils.py,sha256=a87kRYBZPnaUuvn6kRdf6N38b8aAbcPW9r-30T2rlBI,1980
+homesec/plugins/alert_policies/__init__.py,sha256=WllHQAOLF85H6DdeiJAzgNJNceaWnR5gw7ZUnZH_aDA,1405
+homesec/plugins/alert_policies/default.py,sha256=Rhm__YBYLFq-Q6whpuJMWl0ccl2mw8NMEBZ9J4DwGsA,3914
+homesec/plugins/alert_policies/noop.py,sha256=xcdyZAlQf6X_AqQWUPkRMHLK8J6d7PTXWoPbwpnSlQE,1262
+homesec/plugins/analyzers/__init__.py,sha256=Lg1DcOx4zGCDmZ4p09oDH1ZX-rxTUL_k0DLU0vvRW08,822
+homesec/plugins/analyzers/openai.py,sha256=LBXAm2MULwSxgto-y5qhVi1sEXLtFusUNLUcXz7cy5w,16280
+homesec/plugins/filters/__init__.py,sha256=IO7kSKKXPgBYNa3_a9w0wQv41orOIuUhfQ8dxOdIIBM,823
+homesec/plugins/filters/yolo.py,sha256=H1m-ZHd796EJUjwofw0WH6MBu0r_S5VprZwjulsAdW0,11705
+homesec/plugins/notifiers/__init__.py,sha256=gr9TFzVayun5DFIr92S3Iy5DtmKqVvefSKfH2-Nj-MM,932
+homesec/plugins/notifiers/mqtt.py,sha256=nMlaynpgdLYmhjg8bo2c3lw0pJCCgdBQykFbnctJ7vc,6377
+homesec/plugins/notifiers/sendgrid_email.py,sha256=lMOg7BCThbVNnlXkT8yqqw-Xb-lWbiMHT8oiww2c83Y,10614
+homesec/plugins/sources/__init__.py,sha256=DrseH7lAcRFl70sKUG9GQXWWBbPVuoE9cAsz61fZV9o,1037
+homesec/plugins/sources/ftp.py,sha256=PTz9IdjPUjRnqqYqkjYF3SRFJPkFR2lJlzMHray-u5g,847
+homesec/plugins/sources/local_folder.py,sha256=5CalSDRCijGKC_1Lk6EaZt9uZ3QuQiukrLQeupEnzlU,1221
+homesec/plugins/sources/rtsp.py,sha256=-JdbDrYo924tKetU423HWQRlHelVHXs9EPRkx94sa18,823
+homesec/plugins/storage/__init__.py,sha256=_mjmAEX7-0uDRY5v50thv6NmXyG-jpqo_Av5bCw959A,887
+homesec/plugins/storage/dropbox.py,sha256=HLkblKL4_qod8m4q7ZUiwEMYJ1reaEgZ2cw5gPOhsz8,10301
+homesec/plugins/storage/local.py,sha256=QJgd0lRX3KUSzJFAtOII7SiaIVgGKE59QSo6e7YYXG4,3317
+homesec/repository/__init__.py,sha256=6cye2uQIA2v6jeLk5D2S9y3rlkfzJH5GceqdOroF3hU,160
+homesec/repository/clip_repository.py,sha256=NrJXa4-HedO9xMnlZsckH7mi6EqeOpUb53LlE0qb2TA,17096
+homesec/sources/__init__.py,sha256=GEhd68w1BNhF09SK2rfH93RImOoyYzsPG7OW1Lrk2yE,477
+homesec/sources/base.py,sha256=dKTxJxcDwJtykWDN3WYzkW5mtkRqlOJxJLWcLy82_Zo,7582
+homesec/sources/ftp.py,sha256=PRg3oFqlUrxSbwyoayF1Fp076zJILNylLdJVUZAU_Eg,10058
+homesec/sources/local_folder.py,sha256=C6g0FGZqp-O31gEhLphLmfCtLhOlJsymY0lgMMc8dh4,9125
+homesec/sources/rtsp/__init__.py,sha256=wtBzdwzL7Cg0HyIGIpS3lBagekCAi_EYJOyCZFbT7K0,103
+homesec/sources/rtsp/clock.py,sha256=Gf-CLBfgUmxfajmZim89vmWRG14hnc7iUUBVNNiUz6w,338
+homesec/sources/rtsp/core.py,sha256=bzO5RBqQQx6rEAxLwesdZY5-Tm05MM_n9Gd-HA-cLDQ,52957
+homesec/sources/rtsp/frame_pipeline.py,sha256=cIGrH5z4WE8swoAThTl7Wu3SViNq-00YyCcKMLBrCso,11620
+homesec/sources/rtsp/hardware.py,sha256=sKCJhoVdmkDfCk2s5RL0lDPX_CuvcwlgVUESgRJK3us,4892
+homesec/sources/rtsp/motion.py,sha256=FKDa1hvD_H3uxgnQ-Z0c7MhVd6u_35cO6XKZRVrXpaY,2870
+homesec/sources/rtsp/recorder.py,sha256=fqL-zr-vtnFrDQc87zZFYeM-6JSUfMwQsc0zfR-mgy4,7009
+homesec/sources/rtsp/utils.py,sha256=aufPAP6oc39kyFAiN0HTDhdXf3bQqWSVeVWNIHx5MmI,1021
+homesec/state/__init__.py,sha256=Evt1jqTebmpJD1NUzNh3vwt5pbjDlLjQ0DgMCSAZOuM,255
+homesec/state/postgres.py,sha256=I-cXqW5cgz-hpaHc0JIv3DnIBTmGxE28P8ZxBAGabSw,17765
+homesec/telemetry/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+homesec/telemetry/db_log_handler.py,sha256=KM8g4kcOyPzFJbpGxpSzecx_hrEWY0YfpoIKygETy5k,7539
+homesec/telemetry/postgres_settings.py,sha256=EVD2_oi_KReFJvQmXxW026aurl_YD-KexT7rkbGQPHc,1198
+homesec/telemetry/db/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+homesec/telemetry/db/log_table.py,sha256=wcZLwRht7FMa0z2gf37f_RxdVTNIdDiK4i_N3c_ibwg,473
+homesec-1.2.3.dist-info/METADATA,sha256=j8zvaP62Dws7sbTz6eUB3TCYcOAX-tlHjiz0q2lWpQk,25081
+homesec-1.2.3.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+homesec-1.2.3.dist-info/entry_points.txt,sha256=8ocCj_fP1qxIuL-DVDAUiaUbEdTMX_kg_BzVrJsbQYg,45
+homesec-1.2.3.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+homesec-1.2.3.dist-info/RECORD,,

homesec/models/source/__init__.py

@@ -1,3 +0,0 @@
-"""Source configuration models."""
-
-__all__: list[str] = []

homesec/models/source/ftp.py

@@ -1,97 +0,0 @@
-"""FTP source configuration model."""
-
-from __future__ import annotations
-
-from pydantic import BaseModel, Field, field_validator
-
-
-class FtpSourceConfig(BaseModel):
-    """FTP source configuration."""
-
-    model_config = {"extra": "forbid"}
-
-    camera_name: str | None = Field(
-        default=None,
-        description="Optional human-friendly camera name.",
-    )
-    host: str = Field(
-        default="0.0.0.0",
-        description="FTP bind address.",
-    )
-    port: int = Field(
-        default=2121,
-        ge=0,
-        le=65535,
-        description="FTP listen port (0 lets the OS choose an ephemeral port).",
-    )
-    root_dir: str = Field(
-        default="./ftp_incoming",
-        description="FTP root directory for uploads.",
-    )
-    ftp_subdir: str | None = Field(
-        default=None,
-        description="Optional subdirectory under root_dir.",
-    )
-    anonymous: bool = Field(
-        default=True,
-        description="Allow anonymous FTP uploads.",
-    )
-    username_env: str | None = Field(
-        default=None,
-        description="Environment variable containing FTP username.",
-    )
-    password_env: str | None = Field(
-        default=None,
-        description="Environment variable containing FTP password.",
-    )
-    perms: str = Field(
-        default="elw",
-        description="pyftpdlib permissions string.",
-    )
-    passive_ports: str | None = Field(
-        default=None,
-        description="Passive ports range (e.g., '60000-60100' or '60000,60010').",
-    )
-    masquerade_address: str | None = Field(
-        default=None,
-        description="Optional masquerade address for passive mode.",
-    )
-    heartbeat_s: float = Field(
-        default=30.0,
-        ge=0.0,
-        description="Seconds between FTP health checks.",
-    )
-    allowed_extensions: list[str] = Field(
-        default_factory=lambda: [".mp4"],
-        description="Allowed file extensions for uploaded clips.",
-    )
-    delete_non_matching: bool = Field(
-        default=True,
-        description="Delete files with disallowed extensions.",
-    )
-    delete_incomplete: bool = Field(
-        default=True,
-        description="Delete incomplete uploads when enabled.",
-    )
-    default_duration_s: float = Field(
-        default=10.0,
-        ge=0.0,
-        description="Fallback clip duration when timestamps are missing.",
-    )
-    log_level: str = Field(
-        default="INFO",
-        description="FTP server log level.",
-    )
-
-    @field_validator("allowed_extensions")
-    @classmethod
-    def _normalize_extensions(cls, value: list[str]) -> list[str]:
-        cleaned: list[str] = []
-        for item in value:
-            ext = str(item).strip().lower()
-            if not ext:
-                continue
-            if not ext.startswith("."):
-                ext = f".{ext}"
-            cleaned.append(ext)
-        return cleaned

homesec/models/source/local_folder.py

@@ -1,30 +0,0 @@
-"""Local folder source configuration model."""
-
-from __future__ import annotations
-
-from pydantic import BaseModel, Field
-
-
-class LocalFolderSourceConfig(BaseModel):
-    """Local folder source configuration."""
-
-    model_config = {"extra": "forbid"}
-
-    camera_name: str | None = Field(
-        default=None,
-        description="Optional human-friendly camera name.",
-    )
-    watch_dir: str = Field(
-        default="recordings",
-        description="Directory to watch for new clips.",
-    )
-    poll_interval: float = Field(
-        default=1.0,
-        ge=0.0,
-        description="Polling interval in seconds.",
-    )
-    stability_threshold_s: float = Field(
-        default=3.0,
-        ge=0.0,
-        description="Seconds to wait for file size to stabilize before accepting a clip.",
-    )

homesec/models/source/rtsp.py

@@ -1,165 +0,0 @@
-"""RTSP source configuration models."""
-
-from __future__ import annotations
-
-from pydantic import BaseModel, Field, model_validator
-
-
-class RTSPMotionConfig(BaseModel):
-    """Motion detection configuration."""
-
-    model_config = {"extra": "forbid"}
-
-    pixel_threshold: int = Field(
-        default=45,
-        ge=0,
-        description="Pixel intensity delta required to count a pixel as changed.",
-    )
-    min_changed_pct: float = Field(
-        default=1.0,
-        ge=0.0,
-        description="Percent of pixels that must change to trigger motion (idle state).",
-    )
-    recording_sensitivity_factor: float = Field(
-        default=2.0,
-        ge=1.0,
-        description="Factor to reduce the threshold while recording (>=1.0).",
-    )
-    blur_kernel: int = Field(
-        default=5,
-        ge=0,
-        description="Gaussian blur kernel size (odd or zero; even values are normalized).",
-    )
-
-
-class RTSPRecordingConfig(BaseModel):
-    """Recording lifecycle configuration."""
-
-    model_config = {"extra": "forbid"}
-
-    stop_delay: float = Field(
-        default=10.0,
-        ge=0.0,
-        description="Seconds to keep recording after motion stops.",
-    )
-    max_recording_s: float = Field(
-        default=60.0,
-        gt=0.0,
-        description="Maximum seconds per recording before rotating.",
-    )
-
-
-class RTSPStreamConfig(BaseModel):
-    """RTSP/ffmpeg transport configuration."""
-
-    model_config = {"extra": "forbid"}
-
-    connect_timeout_s: float = Field(
-        default=2.0,
-        ge=0.0,
-        description="RTSP connect timeout (seconds) passed to ffmpeg/ffprobe when supported.",
-    )
-    io_timeout_s: float = Field(
-        default=2.0,
-        ge=0.0,
-        description="RTSP I/O timeout (seconds) passed to ffmpeg/ffprobe when supported.",
-    )
-    ffmpeg_flags: list[str] = Field(
-        default_factory=list,
-        description="Additional ffmpeg flags appended to the command.",
-    )
-    disable_hwaccel: bool = Field(
-        default=False,
-        description="Disable hardware-accelerated decoding.",
-    )
-
-
-class RTSPReconnectConfig(BaseModel):
-    """Reconnect and fallback policy."""
-
-    model_config = {"extra": "forbid"}
-
-    max_attempts: int = Field(
-        default=0,
-        ge=0,
-        description="Max reconnect attempts (0 = retry forever).",
-    )
-    backoff_s: float = Field(
-        default=1.0,
-        ge=0.0,
-        description="Base backoff (seconds) between reconnect attempts.",
-    )
-    detect_fallback_attempts: int = Field(
-        default=3,
-        ge=0,
-        description="Failures before falling back from detect stream to main stream.",
-    )
-
-
-class RTSPRuntimeConfig(BaseModel):
-    """Runtime loop configuration."""
-
-    model_config = {"extra": "forbid"}
-
-    frame_timeout_s: float = Field(
-        default=2.0,
-        ge=0.0,
-        description="Seconds without frames before considering the pipeline stalled.",
-    )
-    frame_queue_size: int = Field(
-        default=20,
-        ge=1,
-        description="Frame queue size used by the frame reader thread.",
-    )
-    heartbeat_s: float = Field(
-        default=30.0,
-        ge=0.0,
-        description="Seconds between heartbeat logs.",
-    )
-    debug_motion: bool = Field(
-        default=False,
-        description="Enable verbose motion detection logging.",
-    )
-
-
-class RTSPSourceConfig(BaseModel):
-    """RTSP source configuration."""
-
-    model_config = {"extra": "forbid"}
-
-    camera_name: str | None = Field(
-        default=None,
-        description="Optional human-friendly camera name.",
-    )
-    rtsp_url_env: str | None = Field(
-        default=None,
-        description="Environment variable containing the RTSP URL.",
-    )
-    rtsp_url: str | None = Field(
-        default=None,
-        description="RTSP URL for the main stream.",
-    )
-    detect_rtsp_url_env: str | None = Field(
-        default=None,
-        description="Environment variable containing the detect stream RTSP URL.",
-    )
-    detect_rtsp_url: str | None = Field(
-        default=None,
-        description="RTSP URL for the detect stream.",
-    )
-    output_dir: str = Field(
-        default="./recordings",
-        description="Directory to store recordings and logs.",
-    )
-
-    motion: RTSPMotionConfig = Field(default_factory=RTSPMotionConfig)
-    recording: RTSPRecordingConfig = Field(default_factory=RTSPRecordingConfig)
-    stream: RTSPStreamConfig = Field(default_factory=RTSPStreamConfig)
-    reconnect: RTSPReconnectConfig = Field(default_factory=RTSPReconnectConfig)
-    runtime: RTSPRuntimeConfig = Field(default_factory=RTSPRuntimeConfig)
-
-    @model_validator(mode="after")
-    def _require_rtsp_url(self) -> RTSPSourceConfig:
-        if not (self.rtsp_url or self.rtsp_url_env):
-            raise ValueError("rtsp_url_env or rtsp_url required for RTSP source")
-        return self

homesec/pipeline/alert_policy.py

@@ -1,5 +0,0 @@
-"""Alert policy implementation (re-export)."""
-
-from homesec.plugins.alert_policies.default import DefaultAlertPolicy
-
-__all__ = ["DefaultAlertPolicy"]