Feature/ab#2263 register config message

[flonix8]

Description

• Add frame forwarding feature (sends single frame from all video sources to configurable valkey output stream at a specified interval)
• Output startup and shutdown events on a configurable valkey output stream (component level, but we assume that it will eventually converge with SAE state as a whole)

Motivation and Context

How has this been tested?

Screenshots (if appropriate):

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)

Checklist:

• My code follows the code style of this project.
• My change requires a change to the documentation.
• I have updated the documentation accordingly.

[Copilot]

Pull request overview

This PR refactors saeapi from a placeholder “SAE API” stage into a stage that (1) periodically forwards the latest frame from each local video-source Valkey stream to a backend Valkey stream, and (2) publishes lifecycle startup/shutdown EventMessages to a backend Valkey stream, with corresponding config/template/docs/test updates.

Changes:

• Replace the previous SaeApi processing loop with FrameForwarder polling + EventReporter lifecycle publishing in run_stage.
• Introduce new config structure (instance_id, separate source_valkey/backend_valkey, frame_forwarding, event_reporting) and update settings template + README accordingly.
• Add/expand smoke and unit tests for the stage, forwarding behavior (including base64/plain proto), and event reporting; update CI/container versions and the visionapi pin.

Reviewed changes

Copilot reviewed 18 out of 19 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
saeapi/stage.py	Replaces the old consumer/publisher loop with lifecycle reporting + periodic frame-forward polling thread.
saeapi/frame_forwarder.py	New component that scans source streams and forwards the latest frame to backend streams.
saeapi/event_reporter.py	New component that publishes startup/shutdown EventMessages to backend Valkey.
saeapi/config.py	Introduces new config models for Valkey endpoints, event reporting, and frame forwarding.
saeapi/saeapi.py	Removes the old placeholder SaeApi implementation.
settings.template.yaml	Updates template to the new config schema and stream naming.
README.md	Documents the new behavior, interfaces, and how to run/test.
tests/conftest.py	Adds a make_config factory to avoid relying on real settings.
tests/test_stage.py	Updates stage smoke tests to validate startup → forward → shutdown behavior.
tests/test_frame_forwarder.py	Adds unit tests for forwarding logic (latest frame, base64/plain fields).
tests/test_event_reporter.py	Adds unit tests for lifecycle event publishing.
tests/test_imports.py	Updates import smoke test to cover new top-level components.
tests/test_config.py	Updates config validation tests to match the new schema/defaults.
pyproject.toml / poetry.lock	Pins visionapi to a specific revision and updates lock contents.
Dockerfile	Updates base/build images to Python 3.14 tags.
.github/workflows/*.yaml	Updates container images and GitHub Actions versions used in workflows.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.