From 54b9bd4fc899b64f70d58d9eb7dd9159d47e3b17 Mon Sep 17 00:00:00 2001
From: ben <ben@qoherent.ai>
Date: Fri, 10 Apr 2026 16:39:11 -0400
Subject: [PATCH 01/13] Agent Error fix

---
 src/ria_toolkit_oss/agent.py | 469 ++++++++++++++++++++++++++++++++---
 1 file changed, 438 insertions(+), 31 deletions(-)

diff --git a/src/ria_toolkit_oss/agent.py b/src/ria_toolkit_oss/agent.py
index bd4b3fc..274ff55 100644
--- a/src/ria_toolkit_oss/agent.py
+++ b/src/ria_toolkit_oss/agent.py
@@ -14,19 +14,40 @@ Usage::
         [--device plutosdr] \\
         [--insecure]
 
+    # Or store credentials in a config file and omit them from the command line:
+    ria-agent --config ~/.config/ria-agent/config.json --name lab-bench-1
+
 The agent:
   1. Registers with RIA Hub and receives a ``node_id``.
   2. Sends a heartbeat every 30 s so the hub knows it is online.
   3. Long-polls ``GET /orchestrator/nodes/{id}/commands`` (30 s timeout).
-  4. Executes received campaigns via :class:`ria_toolkit_oss.orchestration.executor.CampaignExecutor`.
-  5. Uploads recordings to the hub via chunked POST, keeping each request
-     under 50 MB so it passes through Cloudflare without needing the bypass
-     subdomain.
-  6. Deregisters cleanly on SIGINT / SIGTERM.
+  4. Dispatches received commands:
+     - ``run_campaign``: executes via CampaignExecutor, uploads recordings.
+     - ``load_model``: loads an ONNX fingerprint or detector model.
+     - ``start_inference``: opens the SDR, runs the inference loop, posts
+       detection events to the hub for SSE fan-out to browsers.
+     - ``stop_inference``: gracefully stops the inference loop.
+     - ``configure_inference``: queues an SDR parameter update (applied at the
+       next capture boundary without restarting the loop).
+  5. Deregisters cleanly on SIGINT / SIGTERM.
+
+Config file (JSON, optional)::
+
+    {
+        "hub": "https://riahub.company.com",
+        "key": "secret",
+        "name": "lab-bench-1",
+        "device": "plutosdr",
+        "insecure": false,
+        "log_level": "INFO"
+    }
+
+CLI arguments always override config file values.
 """
 
 from __future__ import annotations
 
+import json
 import logging
 import math
 import os
@@ -49,6 +70,8 @@ _POLL_CLIENT_TIMEOUT = 40  # client read timeout — slightly longer than server
 _RECONNECT_PAUSE = 5  # seconds to wait after a poll error before retrying
 _CHUNK_SIZE = 50 * 1024 * 1024  # 50 MB — well below Cloudflare's 100 MB limit
 _DIRECT_THRESHOLD = 90 * 1024 * 1024  # files above this use chunked upload
+_CAPTURE_SAMPLES = 4096  # IQ samples per inference window
+_IDLE_LABELS = frozenset({"noise", "idle", "no_signal", "unknown_protocol", "background"})
 
 
 # ---------------------------------------------------------------------------
@@ -80,6 +103,30 @@ class NodeAgent:
         self.node_id: str | None = None
         self._stop = threading.Event()
 
+        # ── Inference state ─────────────────────────────────────────────────
+        # Protected by _inf_lock for cross-thread model swaps.
+        self._inf_lock = threading.Lock()
+        self._inf_session: Any = None  # primary fingerprint ONNX session
+        self._inf_index_to_label: dict[int, str] = {}
+        self._inf_detector_session: Any = None  # optional protocol-detector session
+        self._inf_detector_index_to_label: dict[int, str] = {}
+        self._inf_detector_threshold: float = 0.7
+        self._inf_pending_config: dict = {}  # queued SDR attribute updates
+
+        self._inf_stop = threading.Event()
+        self._inf_thread: threading.Thread | None = None
+
+        # Detect optional dependencies once at startup so capability
+        # advertising is accurate from the first registration.
+        try:
+            import onnxruntime as _ort_mod
+
+            self._ort: Any = _ort_mod
+            self._ort_available = True
+        except ImportError:
+            self._ort = None
+            self._ort_available = False
+
         try:
             import ria_toolkit_oss
 
@@ -114,6 +161,7 @@ class NodeAgent:
             self._command_loop()
         finally:
             self._stop.set()
+            self._stop_inference()
             self._deregister()
 
     # ------------------------------------------------------------------
@@ -121,13 +169,16 @@ class NodeAgent:
     # ------------------------------------------------------------------
 
     def _register(self) -> None:
+        capabilities = ["campaign"]
+        if self._ort_available:
+            capabilities.append("inference")
         resp = self._post(
             "/orchestrator/nodes/register",
             json={
                 "name": self.name,
                 "sdr_device": self.sdr_device,
                 "ria_toolkit_version": self._ria_version,
-                "capabilities": ["inference", "campaign"],
+                "capabilities": capabilities,
             },
             timeout=15,
         )
@@ -200,6 +251,24 @@ class NodeAgent:
                 daemon=True,
                 name=f"campaign-{campaign_id[:8]}",
             ).start()
+        elif command == "load_model":
+            threading.Thread(
+                target=self._load_model,
+                args=(cmd,),
+                daemon=True,
+                name="ria-load-model",
+            ).start()
+        elif command == "start_inference":
+            threading.Thread(
+                target=self._start_inference,
+                args=(cmd,),
+                daemon=True,
+                name="ria-start-inf",
+            ).start()
+        elif command == "stop_inference":
+            self._stop_inference()
+        elif command == "configure_inference":
+            self._queue_sdr_config(cmd)
         else:
             logger.warning("Unknown command %r — ignored", command)
 
@@ -232,6 +301,270 @@ class NodeAgent:
             logger.error("Campaign %s failed: %s", campaign_id[:8], exc)
             self._report_campaign_status(campaign_id, "failed", error=str(exc))
 
+    # ------------------------------------------------------------------
+    # Inference — model loading
+    # ------------------------------------------------------------------
+
+    def _load_model(self, cmd: dict) -> None:
+        """Load an ONNX model into the fingerprint or detector slot.
+
+        The ``model_path`` field may be either a local filesystem path or an
+        ``http(s)://`` URL; in the latter case the file is downloaded first.
+        """
+        if not self._ort_available:
+            logger.error("load_model: onnxruntime is not installed — cannot load model")
+            return
+
+        model_path: str = cmd.get("model_path", "")
+        label_map: dict[str, int] = cmd.get("label_map") or {}
+        stage: str = cmd.get("stage", "fingerprint")
+        detector_threshold: float = float(cmd.get("detector_threshold") or 0.7)
+
+        if model_path.startswith(("http://", "https://")):
+            model_path = self._download_model(model_path)
+            if model_path is None:
+                return
+
+        try:
+            session = self._ort.InferenceSession(model_path, providers=["CPUExecutionProvider"])
+        except Exception as exc:
+            logger.error("Failed to load model %r: %s", model_path, exc)
+            return
+
+        index_to_label = {v: k for k, v in label_map.items()}
+        with self._inf_lock:
+            if stage == "detector":
+                self._inf_detector_session = session
+                self._inf_detector_index_to_label = index_to_label
+                self._inf_detector_threshold = detector_threshold
+                logger.info(
+                    "Detector model loaded: path=%s classes=%d threshold=%.2f",
+                    model_path,
+                    len(label_map),
+                    detector_threshold,
+                )
+            else:
+                self._inf_session = session
+                self._inf_index_to_label = index_to_label
+                logger.info(
+                    "Fingerprint model loaded: path=%s classes=%d",
+                    model_path,
+                    len(label_map),
+                )
+
+    def _download_model(self, url: str) -> str | None:
+        """Download a model from *url* to a temp file and return the local path."""
+        import tempfile
+
+        import requests as _requests
+
+        try:
+            logger.info("Downloading model from %s", url)
+            resp = _requests.get(
+                url,
+                headers={"X-API-Key": self.api_key},
+                verify=not self.insecure,
+                timeout=120,
+            )
+            resp.raise_for_status()
+            with tempfile.NamedTemporaryFile(suffix=".onnx", delete=False) as fh:
+                fh.write(resp.content)
+                path = fh.name
+            logger.info("Model downloaded to %s (%d bytes)", path, len(resp.content))
+            return path
+        except Exception as exc:
+            logger.error("Model download from %s failed: %s", url, exc)
+            return None
+
+    # ------------------------------------------------------------------
+    # Inference — loop lifecycle
+    # ------------------------------------------------------------------
+
+    def _start_inference(self, cmd: dict) -> None:
+        """Start the SDR capture + ONNX inference loop."""
+        if not self._ort_available:
+            logger.error("start_inference: onnxruntime is not installed")
+            return
+
+        with self._inf_lock:
+            if self._inf_session is None:
+                logger.error("start_inference: no fingerprint model loaded — call load_model first")
+                return
+
+        if self._inf_thread is not None and self._inf_thread.is_alive():
+            logger.warning("start_inference: inference loop is already running — ignoring")
+            return
+
+        center_freq: float = float(cmd.get("center_freq", 2.4e9))
+        sample_rate: float = float(cmd.get("sample_rate", 10e6))
+        gain: float | str = cmd.get("gain", "auto")
+        device_type: str = cmd.get("device") or self.sdr_device
+
+        self._inf_stop.clear()
+        self._inf_thread = threading.Thread(
+            target=self._inference_loop,
+            args=(device_type, center_freq, sample_rate, gain),
+            daemon=True,
+            name="ria-agent-inference",
+        )
+        self._inf_thread.start()
+        logger.info(
+            "Inference started (device=%s freq=%.3f MHz rate=%.1f MHz)",
+            device_type,
+            center_freq / 1e6,
+            sample_rate / 1e6,
+        )
+
+    def _stop_inference(self) -> None:
+        """Signal the inference loop to stop and wait up to 5 s for it to exit."""
+        self._inf_stop.set()
+        if self._inf_thread is not None and self._inf_thread.is_alive():
+            self._inf_thread.join(timeout=5.0)
+            if self._inf_thread.is_alive():
+                logger.warning("Inference thread did not exit within 5 s")
+        logger.info("Inference stopped")
+
+    def _queue_sdr_config(self, cmd: dict) -> None:
+        """Merge SDR parameter updates into the pending-config dict.
+
+        The inference loop checks this at each capture boundary and applies
+        the updates without restarting.
+        """
+        cfg = {k: v for k, v in cmd.items() if k != "command" and v is not None}
+        with self._inf_lock:
+            self._inf_pending_config.update(cfg)
+        logger.debug("SDR reconfiguration queued: %s", cfg)
+
+    # ------------------------------------------------------------------
+    # Inference — main loop
+    # ------------------------------------------------------------------
+
+    def _inference_loop(
+        self,
+        device_type: str,
+        center_freq: float,
+        sample_rate: float,
+        gain: float | str,
+    ) -> None:
+        """Continuous SDR capture → ONNX inference → POST events to hub.
+
+        Mirrors the two-stage pipeline in the hub's ``_inference_loop``:
+        an optional protocol-detector gates the fingerprint model so the
+        fingerprint model only runs when an active transmission is detected.
+        """
+        try:
+            from ria_toolkit_oss.sdr import get_sdr_device
+        except ImportError as exc:
+            logger.error("inference_loop: ria_toolkit_oss not installed: %s", exc)
+            return
+
+        try:
+            sdr = get_sdr_device(device_type)
+            _apply_sdr_config(sdr, {"center_freq": center_freq, "sample_rate": sample_rate, "gain": gain})
+        except Exception as exc:
+            logger.error("SDR initialisation failed: %s", exc)
+            return
+
+        try:
+            import numpy as np
+
+            try:
+                from ria_toolkit_oss.orchestration.qa import estimate_snr_db
+            except ImportError:
+                estimate_snr_db = None
+
+            # Snapshot model state once at loop start.  If the hub sends a
+            # new load_model command while the loop is running, the new session
+            # will be picked up on the next loop restart (stop + start).
+            with self._inf_lock:
+                session = self._inf_session
+                index_to_label = dict(self._inf_index_to_label)
+                det_session = self._inf_detector_session
+                det_threshold = self._inf_detector_threshold
+
+            input_name = session.get_inputs()[0].name
+            det_input_name = det_session.get_inputs()[0].name if det_session else None
+
+            while not self._inf_stop.is_set():
+                # Apply any queued SDR configuration changes.
+                with self._inf_lock:
+                    pending = self._inf_pending_config.copy()
+                    self._inf_pending_config.clear()
+                if pending:
+                    _apply_sdr_config(sdr, pending)
+
+                try:
+                    samples = sdr.rx(_CAPTURE_SAMPLES)
+                except Exception as exc:
+                    logger.warning("SDR capture error: %s", exc)
+                    # Avoid a tight spin when the SDR is in a persistent error
+                    # state (e.g. physically disconnected).
+                    self._inf_stop.wait(timeout=0.5)
+                    continue
+
+                samples = np.array(samples, dtype=np.complex64)
+                snr_db = float(estimate_snr_db(samples)) if estimate_snr_db is not None else 0.0
+                iq = np.stack([samples.real, samples.imag], axis=0).astype(np.float32)
+
+                # Stage 1: protocol detector gate (optional).
+                if det_session is not None:
+                    det_out = _run_onnx_session(det_session, det_input_name, iq)
+                    det_probs = _softmax(det_out[0][0])
+                    det_confidence = float(det_probs.max())
+                    if det_confidence < det_threshold:
+                        # No active protocol detected — report idle and skip
+                        # the fingerprint model for this window.
+                        self._post_event(device_id=None, confidence=det_confidence, snr_db=snr_db)
+                        continue
+
+                # Stage 2: fingerprint model.
+                out = _run_onnx_session(session, input_name, iq)
+                probs = _softmax(out[0][0])
+                pred_idx = int(probs.argmax())
+                confidence = float(probs[pred_idx])
+                device_id = index_to_label.get(pred_idx)
+                idle = (device_id in _IDLE_LABELS) if device_id else True
+                self._post_event(
+                    device_id=None if idle else device_id,
+                    confidence=confidence,
+                    snr_db=snr_db,
+                )
+
+        except Exception as exc:
+            logger.exception("Inference loop terminated unexpectedly: %s", exc)
+        finally:
+            try:
+                sdr.close()
+            except Exception:
+                pass
+            logger.info("Inference loop exited")
+
+    def _post_event(self, device_id: str | None, confidence: float, snr_db: float) -> None:
+        """POST a single detection event to ``POST /orchestrator/nodes/{id}/events``.
+
+        Failures are logged at DEBUG level and silently swallowed so that a
+        transient network blip does not crash the inference loop.
+        """
+        from datetime import datetime, timezone
+
+        payload = {
+            "type": "detection",
+            "device_id": device_id,
+            "confidence": round(confidence, 6),
+            "snr_db": round(snr_db, 2),
+            "timestamp": datetime.now(timezone.utc).isoformat(),
+        }
+        try:
+            resp = self._post(
+                f"/orchestrator/nodes/{self.node_id}/events",
+                json=payload,
+                timeout=5,
+            )
+            if resp.status_code not in (200, 204):
+                logger.debug("Event POST returned HTTP %d", resp.status_code)
+        except Exception as exc:
+            logger.debug("Event POST failed (will retry next inference cycle): %s", exc)
+
     # ------------------------------------------------------------------
     # Recording upload (chunked for large files)
     # ------------------------------------------------------------------
@@ -244,7 +577,7 @@ class NodeAgent:
 
         repo_owner, repo_name = output_repo.split("/", 1)
         base_url = f"{self.hub_url}/datasets/upload"
-        steps = getattr(result, "steps", None) or []
+        steps = (result.get("steps") if isinstance(result, dict) else getattr(result, "steps", None)) or []
 
         for step in steps:
             output_path: str | None = getattr(step, "output_path", None)
@@ -304,7 +637,6 @@ class NodeAgent:
         headers = {"X-API-Key": self.api_key}
         verify = not self.insecure
 
-        # Small files: single POST (unchanged endpoint, no assembly needed server-side).
         if size <= _DIRECT_THRESHOLD:
             with open(file_path, "rb") as fh:
                 resp = _requests.post(
@@ -318,7 +650,6 @@ class NodeAgent:
             resp.raise_for_status()
             return resp.json()
 
-        # Large files: chunked upload — each request is ≤ 50 MB.
         total_chunks = math.ceil(size / _CHUNK_SIZE)
         upload_id = str(uuid.uuid4())
         chunk_url = base_url + "/chunk"
@@ -339,18 +670,13 @@ class NodeAgent:
                     chunk_url,
                     headers=headers,
                     files={"file": (filename, chunk, "application/octet-stream")},
-                    data={
-                        **metadata,
-                        "upload_id": upload_id,
-                        "chunk_index": i,
-                        "total_chunks": total_chunks,
-                    },
+                    data={**metadata, "upload_id": upload_id, "chunk_index": i, "total_chunks": total_chunks},
                     timeout=120,
                     verify=verify,
                 )
                 if not resp.ok:
                     raise RuntimeError(
-                        f"Chunk {i + 1}/{total_chunks} failed: " f"HTTP {resp.status_code}: {resp.text[:300]}"
+                        f"Chunk {i + 1}/{total_chunks} failed: HTTP {resp.status_code}: {resp.text[:300]}"
                     )
                 resp_data = resp.json()
                 logger.debug("Chunk %d/%d uploaded", i + 1, total_chunks)
@@ -393,10 +719,41 @@ class NodeAgent:
 
 
 # ---------------------------------------------------------------------------
-# Helpers
+# Module-level helpers (shared by NodeAgent._inference_loop)
 # ---------------------------------------------------------------------------
 
 
+def _run_onnx_session(session: Any, input_name: str, iq: Any) -> list:
+    """Run an ONNX session on an IQ array (2, N).
+
+    Tries channel-first layout (1, 2, N) first; falls back to interleaved flat
+    (1, 2*N) when the model expects a flattened input.
+    """
+    import numpy as np
+
+    x = iq[np.newaxis]  # (1, 2, N)
+    try:
+        return session.run(None, {input_name: x})
+    except Exception:
+        return session.run(None, {input_name: iq.flatten()[np.newaxis]})
+
+
+def _softmax(x: Any) -> Any:
+    import numpy as np
+
+    e = np.exp(x - x.max())
+    return e / e.sum()
+
+
+def _apply_sdr_config(sdr: Any, cfg: dict) -> None:
+    for attr in ("center_freq", "sample_rate", "gain"):
+        if attr in cfg:
+            try:
+                setattr(sdr, attr, cfg[attr])
+            except Exception as exc:
+                logger.warning("SDR config %s=%r failed: %s", attr, cfg[attr], exc)
+
+
 def _sigmf_files(data_path: str) -> list[str]:
     """Return paths to both SigMF files (.sigmf-data and .sigmf-meta) for a recording."""
     candidates = [data_path]
@@ -405,6 +762,29 @@ def _sigmf_files(data_path: str) -> list[str]:
     return [p for p in candidates if os.path.exists(p)]
 
 
+# ---------------------------------------------------------------------------
+# Config file helpers
+# ---------------------------------------------------------------------------
+
+_DEFAULT_CONFIG_PATH = os.path.join(
+    os.environ.get("XDG_CONFIG_HOME", os.path.expanduser("~/.config")),
+    "ria-agent",
+    "config.json",
+)
+
+
+def _load_config(path: str) -> dict:
+    """Load a JSON config file, returning an empty dict if it does not exist."""
+    try:
+        with open(path) as fh:
+            return json.load(fh)
+    except FileNotFoundError:
+        return {}
+    except Exception as exc:
+        logger.warning("Could not read config file %s: %s", path, exc)
+        return {}
+
+
 # ---------------------------------------------------------------------------
 # CLI entry point
 # ---------------------------------------------------------------------------
@@ -420,67 +800,94 @@ def main() -> None:
             "campaigns / inference on local SDR hardware."
         ),
     )
+    parser.add_argument(
+        "--config",
+        default=None,
+        metavar="PATH",
+        help=(
+            f"Path to a JSON config file (default: {_DEFAULT_CONFIG_PATH}). "
+            "CLI arguments override config file values."
+        ),
+    )
     parser.add_argument(
         "--hub",
-        required=True,
+        default=None,
         metavar="URL",
         help="RIA Hub base URL, e.g. https://riahub.company.com",
     )
     parser.add_argument(
         "--key",
-        required=True,
+        default=None,
         metavar="API_KEY",
         help="Shared API key (must match [wac] API_KEY in the hub's app.ini)",
     )
     parser.add_argument(
         "--name",
-        required=True,
+        default=None,
         metavar="NAME",
         help='Human-readable name shown in the Target Node dropdown, e.g. "lab-bench-1"',
     )
     parser.add_argument(
         "--device",
-        default="unknown",
+        default=None,
         metavar="SDR",
         help=(
-            "SDR device type reported to the hub (informational only). "
+            "SDR device type reported to the hub and used for inference. "
             "Examples: plutosdr, usrp_b210, rtlsdr, mock. Default: unknown"
         ),
     )
     parser.add_argument(
         "--insecure",
         action="store_true",
+        default=None,
         help="Disable TLS certificate verification (dev/self-signed certs only)",
     )
     parser.add_argument(
         "--log-level",
-        default="INFO",
+        default=None,
         choices=["DEBUG", "INFO", "WARNING", "ERROR"],
         help="Logging verbosity (default: INFO)",
     )
 
     args = parser.parse_args()
 
+    # Merge: config file → CLI args (CLI wins).
+    config_path = args.config or _DEFAULT_CONFIG_PATH
+    cfg = _load_config(config_path)
+
+    hub = args.hub or cfg.get("hub")
+    key = args.key or cfg.get("key")
+    name = args.name or cfg.get("name")
+    device = args.device or cfg.get("device", "unknown")
+    insecure = args.insecure if args.insecure is not None else cfg.get("insecure", False)
+    log_level = args.log_level or cfg.get("log_level", "INFO")
+
+    if not hub:
+        parser.error("--hub is required (or set 'hub' in the config file)")
+    if not key:
+        parser.error("--key is required (or set 'key' in the config file)")
+    if not name:
+        parser.error("--name is required (or set 'name' in the config file)")
+
     logging.basicConfig(
-        level=getattr(logging, args.log_level),
+        level=getattr(logging, log_level),
         format="%(asctime)s [%(levelname)s] %(name)s: %(message)s",
         datefmt="%Y-%m-%d %H:%M:%S",
         stream=sys.stderr,
     )
 
-    # Warn loudly if --insecure is used outside of development.
-    if args.insecure:
+    if insecure:
         logger.warning(
             "--insecure disables TLS certificate verification. "
             "Only use this for local development with self-signed certs."
         )
 
     agent = NodeAgent(
-        hub_url=args.hub,
-        api_key=args.key,
-        name=args.name,
-        sdr_device=args.device,
-        insecure=args.insecure,
+        hub_url=hub,
+        api_key=key,
+        name=name,
+        sdr_device=device,
+        insecure=insecure,
     )
     agent.run()
 

From 195db4a27db894f14a70c5fc36afa8e007441026 Mon Sep 17 00:00:00 2001
From: ben <ben@qoherent.ai>
Date: Tue, 14 Apr 2026 10:45:54 -0400
Subject: [PATCH 02/13] quick fix

---
 poetry.toml                    |  2 ++
 src/ria_toolkit_oss/sdr/sdr.py | 33 +++++++++++++++++++++++++++++++++
 2 files changed, 35 insertions(+)
 create mode 100644 poetry.toml

diff --git a/poetry.toml b/poetry.toml
new file mode 100644
index 0000000..25758d2
--- /dev/null
+++ b/poetry.toml
@@ -0,0 +1,2 @@
+[virtualenvs.options]
+system-site-packages = true
diff --git a/src/ria_toolkit_oss/sdr/sdr.py b/src/ria_toolkit_oss/sdr/sdr.py
index 36e26f7..f2ea9f4 100644
--- a/src/ria_toolkit_oss/sdr/sdr.py
+++ b/src/ria_toolkit_oss/sdr/sdr.py
@@ -43,6 +43,13 @@ class SDR(ABC):
         self.tx_gain = None
         self._param_lock = threading.RLock()  # Reentrant lock
 
+        # Pending config consumed by rx() on first call and by _apply_sdr_config
+        # in the agent inference loop.  Subclasses that need different defaults
+        # (e.g. MockSDR) can overwrite these in their own __init__.
+        self.center_freq: float = 2.4e9
+        self.sample_rate: float = 10e6
+        self.gain: float = 40.0
+
     def record(self, num_samples: Optional[int] = None, rx_time: Optional[int | float] = None) -> Recording:
         """
         Create a radio recording of a given length. Either ``num_samples`` or ``rx_time`` must be provided.
@@ -100,6 +107,32 @@ class SDR(ABC):
         self._num_buffers_processed = 0
         return recording
 
+    def rx(self, num_samples: int) -> "np.ndarray":
+        """Return *num_samples* complex IQ samples as a 1-D complex64 array.
+
+        This is the interface used by the agent inference loop.  On first call,
+        ``init_rx()`` is invoked automatically using the values stored in
+        ``center_freq``, ``sample_rate``, and ``gain`` (set beforehand by
+        ``_apply_sdr_config``).  Subsequent calls stream directly.
+
+        Subclasses may override this for hardware-native capture APIs (e.g.
+        ``MockSDR`` uses AWGN generation; ``PlutoSDR`` could use
+        ``self.radio.rx()``).
+        """
+        if not self._rx_initialized:
+            gain = self.gain if isinstance(self.gain, (int, float)) else 40.0
+            self.init_rx(
+                sample_rate=self.sample_rate,
+                center_frequency=self.center_freq,
+                gain=gain,
+                channel=0,
+            )
+        recording = self.record(num_samples=num_samples)
+        # Recording.data is either a list of 1-D arrays (one per channel) or a
+        # 2-D ndarray (channels × samples).  Either way, index 0 is channel 0.
+        data = recording.data
+        return data[0] if hasattr(data, "__getitem__") else data
+
     def stream_to_zmq(self, zmq_address, n_samples: int, buffer_size: Optional[int] = 10000):
         """
         Stream iq samples as interleaved bytes via zmq.

From efc09481104e9c1fddccbab27a8bc1ce9fce7ed8 Mon Sep 17 00:00:00 2001
From: ben <ben@qoherent.ai>
Date: Fri, 17 Apr 2026 09:43:59 -0400
Subject: [PATCH 03/13] ria composer support

---
 src/ria_toolkit_oss/orchestration/campaign.py |   6 +-
 src/ria_toolkit_oss/orchestration/executor.py |  61 ++-
 .../remote_control/__init__.py                |   6 +
 .../remote_control/remote_transmitter.py      | 147 +++++++
 .../remote_transmitter_controller.py          | 210 ++++++++++
 tests/remote_control/__init__.py              |   0
 .../remote_control/test_remote_transmitter.py | 266 ++++++++++++
 .../test_remote_transmitter_controller.py     | 294 +++++++++++++
 .../test_sdr_remote_integration.py            | 391 ++++++++++++++++++
 9 files changed, 1379 insertions(+), 2 deletions(-)
 create mode 100644 src/ria_toolkit_oss/remote_control/__init__.py
 create mode 100644 src/ria_toolkit_oss/remote_control/remote_transmitter.py
 create mode 100644 src/ria_toolkit_oss/remote_control/remote_transmitter_controller.py
 create mode 100644 tests/remote_control/__init__.py
 create mode 100644 tests/remote_control/test_remote_transmitter.py
 create mode 100644 tests/remote_control/test_remote_transmitter_controller.py
 create mode 100644 tests/remote_control/test_sdr_remote_integration.py

diff --git a/src/ria_toolkit_oss/orchestration/campaign.py b/src/ria_toolkit_oss/orchestration/campaign.py
index 9d96c96..027c33f 100644
--- a/src/ria_toolkit_oss/orchestration/campaign.py
+++ b/src/ria_toolkit_oss/orchestration/campaign.py
@@ -223,13 +223,16 @@ class TransmitterConfig:
 
     id: str
     type: str  # "wifi", "bluetooth", "sdr", "external"
-    control_method: str  # "external_script" | "sdr"
+    control_method: str  # "external_script" | "sdr" | "sdr_remote"
     schedule: list[CaptureStep]
 
     # For external_script control
     script: Optional[str] = None  # path to control script
     device: Optional[str] = None  # e.g. "/dev/wlan0"
 
+    # For sdr_remote control — keys: host, ssh_user, ssh_key_path, device_type, device_id, zmq_port
+    sdr_remote: Optional[dict] = None
+
     @classmethod
     def from_dict(cls, d: dict) -> "TransmitterConfig":
         schedule = [CaptureStep.from_dict(s) for s in d.get("schedule", [])]
@@ -240,6 +243,7 @@ class TransmitterConfig:
             schedule=schedule,
             script=d.get("script"),
             device=d.get("device"),
+            sdr_remote=d.get("sdr_remote"),
         )
 
 
diff --git a/src/ria_toolkit_oss/orchestration/executor.py b/src/ria_toolkit_oss/orchestration/executor.py
index 629c0d8..1bdd4d8 100644
--- a/src/ria_toolkit_oss/orchestration/executor.py
+++ b/src/ria_toolkit_oss/orchestration/executor.py
@@ -196,6 +196,7 @@ class CampaignExecutor:
         self.config = config
         self.progress_cb = progress_cb
         self._sdr = None
+        self._remote_tx_controllers: dict = {}
 
         if verbose:
             logging.basicConfig(level=logging.DEBUG)
@@ -222,6 +223,7 @@ class CampaignExecutor:
         )
 
         self._init_sdr()
+        self._init_remote_tx_controllers()
         try:
             total = self.config.total_steps()
             step_index = 0
@@ -248,6 +250,7 @@ class CampaignExecutor:
                         )
         finally:
             self._close_sdr()
+            self._close_remote_tx_controllers()
 
         result.end_time = time.time()
         logger.info(
@@ -287,6 +290,41 @@ class CampaignExecutor:
                 logger.warning(f"SDR close error: {e}")
             self._sdr = None
 
+    # ------------------------------------------------------------------
+    # Remote Tx controller management
+    # ------------------------------------------------------------------
+
+    def _init_remote_tx_controllers(self) -> None:
+        """Open SSH+ZMQ connections for all sdr_remote transmitters."""
+        from ria_toolkit_oss.remote_control import RemoteTransmitterController
+
+        for tx in self.config.transmitters:
+            if tx.control_method != "sdr_remote":
+                continue
+            cfg = tx.sdr_remote
+            if not cfg:
+                raise RuntimeError(f"Transmitter '{tx.id}' uses sdr_remote but has no sdr_remote config")
+            logger.info(f"Connecting remote Tx controller for {tx.id} → {cfg['host']}")
+            ctrl = RemoteTransmitterController(
+                host=cfg["host"],
+                ssh_user=cfg["ssh_user"],
+                ssh_key_path=cfg["ssh_key_path"],
+                zmq_port=int(cfg.get("zmq_port", 5556)),
+            )
+            ctrl.set_radio(
+                device_type=cfg["device_type"],
+                device_id=cfg.get("device_id", ""),
+            )
+            self._remote_tx_controllers[tx.id] = ctrl
+
+    def _close_remote_tx_controllers(self) -> None:
+        for tx_id, ctrl in list(self._remote_tx_controllers.items()):
+            try:
+                ctrl.close()
+            except Exception as exc:
+                logger.warning(f"Error closing remote Tx controller {tx_id}: {exc}")
+        self._remote_tx_controllers.clear()
+
     def _record(self, duration_s: float) -> Recording:
         """Capture ``duration_s`` seconds of IQ samples."""
         num_samples = int(duration_s * self.config.recorder.sample_rate)
@@ -372,7 +410,8 @@ class CampaignExecutor:
         traffic, etc. The script is responsible for applying the configuration
         and returning promptly (i.e. not blocking for the capture duration).
 
-        For SDR transmitters this is a no-op placeholder (TX not yet implemented).
+        For ``sdr_remote`` the remote ZMQ controller calls ``init_tx`` then
+        starts a background transmit thread that runs for the step duration.
         """
         if transmitter.control_method == "external_script":
             if not transmitter.script:
@@ -384,6 +423,20 @@ class CampaignExecutor:
         elif transmitter.control_method == "sdr":
             logger.debug("SDR TX not yet implemented — skipping start")
 
+        elif transmitter.control_method == "sdr_remote":
+            ctrl = self._remote_tx_controllers.get(transmitter.id)
+            if ctrl is None:
+                raise RuntimeError(f"No remote Tx controller found for transmitter '{transmitter.id}'")
+            gain = step.power_dbm if step.power_dbm is not None else 0.0
+            ctrl.init_tx(
+                center_frequency=self.config.recorder.center_freq,
+                sample_rate=self.config.recorder.sample_rate,
+                gain=gain,
+                channel=step.channel or 0,
+            )
+            # Start transmission in background; _record() runs concurrently
+            ctrl.transmit_async(step.duration + 1.0)
+
         else:
             logger.warning(f"Unknown control method '{transmitter.control_method}' — skipping")
 
@@ -391,6 +444,7 @@ class CampaignExecutor:
         """Signal the transmitter to stop.
 
         Calls ``<script> stop`` for external_script transmitters.
+        For ``sdr_remote``, waits for the background transmit thread to finish.
         """
         if transmitter.control_method == "external_script":
             if not transmitter.script:
@@ -400,6 +454,11 @@ class CampaignExecutor:
             except Exception as e:
                 logger.warning(f"Script stop failed for {transmitter.id}: {e}")
 
+        elif transmitter.control_method == "sdr_remote":
+            ctrl = self._remote_tx_controllers.get(transmitter.id)
+            if ctrl is not None:
+                ctrl.wait_transmit(timeout=step.duration + 10.0)
+
     @staticmethod
     def _step_params_json(transmitter: TransmitterConfig, step: CaptureStep) -> str:
         """Serialise step parameters to a JSON string for the control script."""
diff --git a/src/ria_toolkit_oss/remote_control/__init__.py b/src/ria_toolkit_oss/remote_control/__init__.py
new file mode 100644
index 0000000..ce55c19
--- /dev/null
+++ b/src/ria_toolkit_oss/remote_control/__init__.py
@@ -0,0 +1,6 @@
+"""Remote SDR transmitter control via SSH + ZMQ."""
+
+from .remote_transmitter import RemoteTransmitter
+from .remote_transmitter_controller import RemoteTransmitterController
+
+__all__ = ["RemoteTransmitter", "RemoteTransmitterController"]
diff --git a/src/ria_toolkit_oss/remote_control/remote_transmitter.py b/src/ria_toolkit_oss/remote_control/remote_transmitter.py
new file mode 100644
index 0000000..c6ea3ab
--- /dev/null
+++ b/src/ria_toolkit_oss/remote_control/remote_transmitter.py
@@ -0,0 +1,147 @@
+"""Server-side ZMQ RPC receiver for SDR transmission.
+
+Run this script on the Tx machine.  The script binds a ZMQ REP socket and
+waits for JSON-RPC commands from a :class:`RemoteTransmitterController`.
+
+Requires: zmq, and ria-toolkit or utils installed for SDR support.
+"""
+
+from __future__ import annotations
+
+import argparse
+import io
+import json
+import logging
+from contextlib import redirect_stderr, redirect_stdout
+
+import zmq
+
+logger = logging.getLogger(__name__)
+
+
+class RemoteTransmitter:
+    """Executes SDR Tx commands received over ZMQ.
+
+    Loads the appropriate SDR driver dynamically so the script can run on
+    machines that have only a subset of SDR libraries installed.
+    """
+
+    def __init__(self) -> None:
+        self._sdr = None
+
+    def set_radio(self, radio_str: str, identifier: str = "") -> None:
+        """Initialise the SDR radio.
+
+        Args:
+            radio_str: SDR type — pluto | usrp | hackrf | bladerf.
+            identifier: Device-specific identifier (IP, serial, etc.).
+        """
+        radio_str = radio_str.lower()
+        try:
+            if radio_str in ("pluto", "plutosdr"):
+                from ria_toolkit_oss.sdr.pluto import Pluto
+                self._sdr = Pluto(identifier)
+            elif radio_str in ("usrp",):
+                from ria_toolkit_oss.sdr.usrp import USRP
+                self._sdr = USRP(identifier)
+            elif radio_str in ("hackrf", "hackrf_one"):
+                from ria_toolkit_oss.sdr.hackrf import HackRF
+                self._sdr = HackRF(identifier)
+            elif radio_str in ("bladerf", "blade"):
+                from ria_toolkit_oss.sdr.blade import Blade
+                self._sdr = Blade(identifier)
+            else:
+                raise ValueError(f"Unknown SDR type: {radio_str!r}")
+        except ImportError as exc:
+            raise RuntimeError(f"SDR driver for '{radio_str}' is not installed: {exc}") from exc
+
+    def init_tx(
+        self,
+        center_frequency: float,
+        sample_rate: float,
+        gain: float,
+        channel: int = 0,
+        gain_mode: str = "absolute",
+    ) -> None:
+        if self._sdr is None:
+            raise RuntimeError("Call set_radio() before init_tx()")
+        self._sdr.init_tx(
+            center_frequency=center_frequency,
+            sample_rate=sample_rate,
+            gain=gain,
+            channel=channel,
+        )
+
+    def transmit(self, duration_s: float) -> None:
+        """Transmit a continuous wave for ``duration_s`` seconds."""
+        if self._sdr is None:
+            raise RuntimeError("Call set_radio() and init_tx() before transmit()")
+        import time
+        # Transmit in a loop until duration has elapsed
+        end = time.monotonic() + duration_s
+        while time.monotonic() < end:
+            try:
+                self._sdr.tx_cw()
+            except AttributeError:
+                time.sleep(0.01)
+
+    def stop(self) -> None:
+        """Stop transmission and close the SDR."""
+        if self._sdr is not None:
+            try:
+                self._sdr.close()
+            except Exception:
+                pass
+            self._sdr = None
+
+    def run_function(self, command_dict: dict) -> dict:
+        """Dispatch a JSON-RPC command and return a response dict."""
+        out_buf = io.StringIO()
+        err_buf = io.StringIO()
+        fn = command_dict.get("function_name", "")
+        try:
+            with redirect_stdout(out_buf), redirect_stderr(err_buf):
+                if fn == "set_radio":
+                    self.set_radio(
+                        radio_str=command_dict["radio_str"],
+                        identifier=command_dict.get("identifier", ""),
+                    )
+                elif fn == "init_tx":
+                    self.init_tx(
+                        center_frequency=command_dict["center_frequency"],
+                        sample_rate=command_dict["sample_rate"],
+                        gain=command_dict["gain"],
+                        channel=command_dict.get("channel", 0),
+                        gain_mode=command_dict.get("gain_mode", "absolute"),
+                    )
+                elif fn == "transmit":
+                    self.transmit(duration_s=command_dict.get("duration_s", 1.0))
+                elif fn == "stop":
+                    self.stop()
+                else:
+                    raise ValueError(f"Unknown function: {fn!r}")
+            return {"status": True, "message": out_buf.getvalue(), "error_message": err_buf.getvalue()}
+        except Exception as exc:
+            logger.exception("Error executing %s", fn)
+            return {"status": False, "message": out_buf.getvalue(), "error_message": str(exc)}
+
+
+def _serve(port: int) -> None:
+    context = zmq.Context()
+    socket = context.socket(zmq.REP)
+    socket.bind(f"tcp://*:{port}")
+    logger.info("RemoteTransmitter listening on port %d", port)
+    tx = RemoteTransmitter()
+    while True:
+        raw = socket.recv()
+        cmd = json.loads(raw.decode())
+        response = tx.run_function(cmd)
+        socket.send(json.dumps(response).encode())
+
+
+if __name__ == "__main__":
+    logging.basicConfig(level=logging.INFO)
+    parser = argparse.ArgumentParser(description="SDR Tx ZMQ server")
+    parser.add_argument("--port", type=int, default=5556)
+    args = parser.parse_args()
+    _serve(args.port)
diff --git a/src/ria_toolkit_oss/remote_control/remote_transmitter_controller.py b/src/ria_toolkit_oss/remote_control/remote_transmitter_controller.py
new file mode 100644
index 0000000..e7ee746
--- /dev/null
+++ b/src/ria_toolkit_oss/remote_control/remote_transmitter_controller.py
@@ -0,0 +1,210 @@
+"""Client-side SSH + ZMQ controller for a remote SDR transmitter.
+
+Run this on the Rx machine (or hub).  It SSH-es into the Tx machine,
+starts :mod:`remote_transmitter` there, then sends JSON-RPC commands over
+ZMQ.
+
+Requires: paramiko, zmq.
+"""
+
+from __future__ import annotations
+
+import json
+import logging
+import threading
+import time
+
+logger = logging.getLogger(__name__)
+
+_STARTUP_WAIT_S = 2.0  # seconds to wait for remote ZMQ server to bind
+
+
+class RemoteTransmitterController:
+    """SSH into a Tx machine, start the ZMQ server, and send commands.
+
+    Args:
+        host: IP or hostname of the Tx machine.
+        ssh_user: SSH username.
+        ssh_key_path: Path to SSH private key file.
+        zmq_port: ZMQ port that the remote transmitter will bind on.
+    """
+
+    def __init__(
+        self,
+        host: str,
+        ssh_user: str,
+        ssh_key_path: str,
+        zmq_port: int = 5556,
+    ) -> None:
+        self._host = host
+        self._zmq_port = zmq_port
+        self._ssh: paramiko.SSHClient | None = None
+        self._ssh_stdout = None
+        self._context: zmq.Context | None = None
+        self._socket: zmq.Socket | None = None
+        self._tx_thread: threading.Thread | None = None
+        self._lock = threading.Lock()
+
+        self._connect(host, ssh_user, ssh_key_path, zmq_port)
+
+    # ------------------------------------------------------------------
+    # Connection management
+    # ------------------------------------------------------------------
+
+    def _connect(self, host: str, ssh_user: str, ssh_key_path: str, zmq_port: int) -> None:
+        """Open SSH tunnel, start remote server, connect ZMQ socket."""
+        try:
+            import paramiko
+        except ImportError as exc:
+            raise RuntimeError("paramiko is required for remote SDR control: pip install paramiko") from exc
+        try:
+            import zmq
+        except ImportError as exc:
+            raise RuntimeError("pyzmq is required for remote SDR control: pip install pyzmq") from exc
+
+        logger.info("SSH connecting to %s@%s …", ssh_user, host)
+        self._ssh = paramiko.SSHClient()
+        self._ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy())
+        self._ssh.connect(hostname=host, username=ssh_user, key_filename=ssh_key_path)
+
+        cmd = f"python -m ria_toolkit_oss.remote_control.remote_transmitter --port {zmq_port}"
+        logger.info("Starting remote Tx server: %s", cmd)
+        _, self._ssh_stdout, _ = self._ssh.exec_command(cmd)
+
+        time.sleep(_STARTUP_WAIT_S)
+
+        self._context = zmq.Context()
+        self._socket = self._context.socket(zmq.REQ)
+        self._socket.connect(f"tcp://{host}:{zmq_port}")
+        logger.info("ZMQ connected to tcp://%s:%d", host, zmq_port)
+
+    def close(self) -> None:
+        """Tear down ZMQ and SSH connections."""
+        if self._socket is not None:
+            try:
+                self._socket.close(linger=0)
+            except Exception:
+                pass
+            self._socket = None
+        if self._context is not None:
+            try:
+                self._context.term()
+            except Exception:
+                pass
+            self._context = None
+        if self._ssh_stdout is not None:
+            try:
+                self._ssh_stdout.channel.close()
+            except Exception:
+                pass
+            self._ssh_stdout = None
+        if self._ssh is not None:
+            try:
+                self._ssh.close()
+            except Exception:
+                pass
+            self._ssh = None
+        logger.info("RemoteTransmitterController closed")
+
+    # ------------------------------------------------------------------
+    # ZMQ dispatch
+    # ------------------------------------------------------------------
+
+    def _send(self, command: dict) -> dict:
+        """Send a JSON-RPC command and return the response dict (thread-safe)."""
+        with self._lock:
+            if self._socket is None:
+                raise RuntimeError("Controller is closed")
+            self._socket.send(json.dumps(command).encode())
+            raw = self._socket.recv()
+        reply: dict = json.loads(raw.decode())
+        if not reply.get("status"):
+            raise RuntimeError(
+                f"Remote command '{command.get('function_name')}' failed: "
+                f"{reply.get('error_message', 'unknown error')}"
+            )
+        return reply
+
+    # ------------------------------------------------------------------
+    # Public API
+    # ------------------------------------------------------------------
+
+    def set_radio(self, device_type: str, device_id: str = "") -> None:
+        """Initialise the SDR radio on the Tx machine.
+
+        Args:
+            device_type: SDR type — ``pluto``, ``usrp``, ``hackrf``, ``bladerf``.
+            device_id: Device-specific identifier (IP, serial, etc.).
+        """
+        logger.info("set_radio(%s, %r)", device_type, device_id)
+        self._send({"function_name": "set_radio", "radio_str": device_type, "identifier": device_id})
+
+    def init_tx(
+        self,
+        center_frequency: float,
+        sample_rate: float,
+        gain: float,
+        channel: int = 0,
+        gain_mode: str = "absolute",
+    ) -> None:
+        """Configure Tx parameters on the remote SDR.
+
+        Args:
+            center_frequency: Center frequency in Hz.
+            sample_rate: Sample rate in Hz.
+            gain: Tx gain in dB.
+            channel: RF channel index (default 0).
+            gain_mode: ``"absolute"`` (default) or ``"relative"``.
+        """
+        logger.info(
+            "init_tx: fc=%.3f MHz, fs=%.3f MHz, gain=%.1f dB, ch=%d",
+            center_frequency / 1e6, sample_rate / 1e6, gain, channel,
+        )
+        self._send({
+            "function_name": "init_tx",
+            "center_frequency": center_frequency,
+            "sample_rate": sample_rate,
+            "gain": gain,
+            "channel": channel,
+            "gain_mode": gain_mode,
+        })
+
+    def transmit_async(self, duration_s: float) -> None:
+        """Start a timed CW transmission in a background thread.
+
+        Returns immediately.  Call :meth:`wait_transmit` after recording to
+        ensure the transmit thread has finished before the next step.
+
+        Args:
+            duration_s: Transmission duration in seconds.
+        """
+        logger.info("transmit_async: %.1f s", duration_s)
+
+        def _run() -> None:
+            try:
+                self._send({"function_name": "transmit", "duration_s": duration_s})
+            except Exception as exc:
+                logger.warning("Background transmit error: %s", exc)
+
+        self._tx_thread = threading.Thread(target=_run, daemon=True, name="remote-tx")
+        self._tx_thread.start()
+
+    def wait_transmit(self, timeout: float | None = None) -> None:
+        """Wait for the background transmit thread to finish.
+
+        Args:
+            timeout: Maximum seconds to wait.  ``None`` = wait indefinitely.
+        """
+        if self._tx_thread is not None:
+            self._tx_thread.join(timeout=timeout)
+            self._tx_thread = None
+
+    def stop(self) -> None:
+        """Stop transmission and release the remote SDR, then close connections."""
+        logger.info("Sending stop to remote Tx")
+        try:
+            self._send({"function_name": "stop"})
+        except Exception as exc:
+            logger.warning("stop command error (may be normal if connection closed): %s", exc)
+        finally:
+            self.close()
diff --git a/tests/remote_control/__init__.py b/tests/remote_control/__init__.py
new file mode 100644
index 0000000..e69de29
diff --git a/tests/remote_control/test_remote_transmitter.py b/tests/remote_control/test_remote_transmitter.py
new file mode 100644
index 0000000..9899965
--- /dev/null
+++ b/tests/remote_control/test_remote_transmitter.py
@@ -0,0 +1,266 @@
+"""Tests for the server-side RemoteTransmitter ZMQ RPC dispatcher.
+
+No real SDR hardware or ZMQ sockets are needed — we test run_function()
+directly and mock the SDR drivers.
+"""
+
+from __future__ import annotations
+
+from unittest.mock import MagicMock, patch
+
+import pytest
+
+from ria_toolkit_oss.remote_control.remote_transmitter import RemoteTransmitter
+
+
+# ---------------------------------------------------------------------------
+# Helpers
+# ---------------------------------------------------------------------------
+
+
+def _make_mock_sdr():
+    sdr = MagicMock()
+    sdr.init_tx = MagicMock()
+    sdr.tx_cw = MagicMock()
+    sdr.close = MagicMock()
+    return sdr
+
+
+# ---------------------------------------------------------------------------
+# set_radio dispatch
+# ---------------------------------------------------------------------------
+
+
+class TestSetRadio:
+    def test_pluto_alias(self):
+        tx = RemoteTransmitter()
+        mock_sdr = _make_mock_sdr()
+        with patch("ria_toolkit_oss.sdr.pluto.Pluto", return_value=mock_sdr):
+            tx.set_radio("pluto", "ip:192.168.2.1")
+        assert tx._sdr is mock_sdr
+
+    def test_plutosdr_alias(self):
+        tx = RemoteTransmitter()
+        mock_sdr = _make_mock_sdr()
+        with patch("ria_toolkit_oss.sdr.pluto.Pluto", return_value=mock_sdr):
+            tx.set_radio("PlutoSDR", "ip:192.168.2.1")
+        assert tx._sdr is mock_sdr
+
+    def test_usrp_alias(self):
+        tx = RemoteTransmitter()
+        mock_sdr = _make_mock_sdr()
+        mock_module = MagicMock()
+        mock_module.USRP = MagicMock(return_value=mock_sdr)
+        with patch.dict("sys.modules", {"ria_toolkit_oss.sdr.usrp": mock_module}):
+            tx.set_radio("usrp", "usrp://addr=192.168.10.2")
+        assert tx._sdr is mock_sdr
+
+    def test_hackrf_alias(self):
+        tx = RemoteTransmitter()
+        mock_sdr = _make_mock_sdr()
+        with patch("ria_toolkit_oss.sdr.hackrf.HackRF", return_value=mock_sdr):
+            tx.set_radio("hackrf", "")
+        assert tx._sdr is mock_sdr
+
+    def test_hackrf_one_alias(self):
+        tx = RemoteTransmitter()
+        mock_sdr = _make_mock_sdr()
+        with patch("ria_toolkit_oss.sdr.hackrf.HackRF", return_value=mock_sdr):
+            tx.set_radio("hackrf_one", "")
+        assert tx._sdr is mock_sdr
+
+    def test_bladerf_alias(self):
+        tx = RemoteTransmitter()
+        mock_sdr = _make_mock_sdr()
+        mock_module = MagicMock()
+        mock_module.Blade = MagicMock(return_value=mock_sdr)
+        with patch.dict("sys.modules", {"ria_toolkit_oss.sdr.blade": mock_module}):
+            tx.set_radio("blade", "")
+        assert tx._sdr is mock_sdr
+
+    def test_case_insensitive(self):
+        tx = RemoteTransmitter()
+        mock_sdr = _make_mock_sdr()
+        with patch("ria_toolkit_oss.sdr.pluto.Pluto", return_value=mock_sdr):
+            tx.set_radio("PLUTO", "ip:192.168.2.1")
+        assert tx._sdr is mock_sdr
+
+    def test_unknown_radio_raises(self):
+        tx = RemoteTransmitter()
+        with pytest.raises(ValueError, match="Unknown SDR type"):
+            tx.set_radio("nonexistent_radio")
+
+    def test_import_error_raises_runtime(self):
+        tx = RemoteTransmitter()
+        with patch.dict("sys.modules", {"ria_toolkit_oss.sdr.pluto": None}):
+            with pytest.raises((RuntimeError, ImportError)):
+                tx.set_radio("pluto")
+
+
+# ---------------------------------------------------------------------------
+# init_tx / transmit / stop guard
+# ---------------------------------------------------------------------------
+
+
+class TestInitTxGuards:
+    def test_init_tx_without_set_radio_raises(self):
+        tx = RemoteTransmitter()
+        with pytest.raises(RuntimeError, match="set_radio"):
+            tx.init_tx(center_frequency=2.4e9, sample_rate=20e6, gain=0)
+
+    def test_transmit_without_set_radio_raises(self):
+        tx = RemoteTransmitter()
+        with pytest.raises(RuntimeError):
+            tx.transmit(duration_s=0.1)
+
+    def test_stop_without_set_radio_is_safe(self):
+        tx = RemoteTransmitter()
+        tx.stop()  # should not raise — nothing to close
+
+
+class TestInitTx:
+    def _tx_with_mock_sdr(self):
+        tx = RemoteTransmitter()
+        tx._sdr = _make_mock_sdr()
+        return tx
+
+    def test_delegates_to_sdr(self):
+        tx = self._tx_with_mock_sdr()
+        tx.init_tx(center_frequency=2.4e9, sample_rate=20e6, gain=30, channel=1)
+        tx._sdr.init_tx.assert_called_once_with(
+            center_frequency=2.4e9,
+            sample_rate=20e6,
+            gain=30,
+            channel=1,
+        )
+
+    def test_default_channel_zero(self):
+        tx = self._tx_with_mock_sdr()
+        tx.init_tx(center_frequency=2.4e9, sample_rate=20e6, gain=30)
+        _, kwargs = tx._sdr.init_tx.call_args
+        assert kwargs["channel"] == 0
+
+
+class TestTransmit:
+    def test_calls_tx_cw_until_duration(self):
+        tx = RemoteTransmitter()
+        tx._sdr = _make_mock_sdr()
+        tx.init_tx(center_frequency=2.4e9, sample_rate=20e6, gain=0)
+        tx.transmit(duration_s=0.05)
+        assert tx._sdr.tx_cw.called
+
+    def test_zero_duration_does_not_call_tx_cw(self):
+        tx = RemoteTransmitter()
+        tx._sdr = _make_mock_sdr()
+        tx.init_tx(center_frequency=2.4e9, sample_rate=20e6, gain=0)
+        tx.transmit(duration_s=0.0)
+        tx._sdr.tx_cw.assert_not_called()
+
+    def test_missing_tx_cw_method_handled(self):
+        """AttributeError on tx_cw should not crash transmit()."""
+        tx = RemoteTransmitter()
+        sdr = MagicMock(spec=[])  # no tx_cw attribute
+        sdr.init_tx = MagicMock()
+        tx._sdr = sdr
+        # Should not raise — AttributeError is caught and slept through
+        tx.transmit(duration_s=0.01)
+
+
+class TestStop:
+    def test_calls_close_and_clears_sdr(self):
+        tx = RemoteTransmitter()
+        mock_sdr = _make_mock_sdr()
+        tx._sdr = mock_sdr
+        tx.stop()
+        mock_sdr.close.assert_called_once()
+        assert tx._sdr is None
+
+    def test_close_exception_is_swallowed(self):
+        tx = RemoteTransmitter()
+        sdr = _make_mock_sdr()
+        sdr.close.side_effect = RuntimeError("hardware error")
+        tx._sdr = sdr
+        tx.stop()  # should not raise
+        assert tx._sdr is None
+
+    def test_stop_idempotent(self):
+        tx = RemoteTransmitter()
+        tx.stop()
+        tx.stop()  # second call is safe
+
+
+# ---------------------------------------------------------------------------
+# run_function dispatcher
+# ---------------------------------------------------------------------------
+
+
+class TestRunFunction:
+    def _tx_with_mock_sdr(self):
+        tx = RemoteTransmitter()
+        tx._sdr = _make_mock_sdr()
+        return tx
+
+    def test_unknown_function_returns_failure(self):
+        tx = RemoteTransmitter()
+        resp = tx.run_function({"function_name": "explode"})
+        assert resp["status"] is False
+        assert "explode" in resp["error_message"]
+
+    def test_set_radio_success(self):
+        tx = RemoteTransmitter()
+        mock_sdr = _make_mock_sdr()
+        with patch("ria_toolkit_oss.sdr.pluto.Pluto", return_value=mock_sdr):
+            resp = tx.run_function({"function_name": "set_radio", "radio_str": "pluto", "identifier": "ip:1.2.3.4"})
+        assert resp["status"] is True
+
+    def test_set_radio_bad_type_returns_failure(self):
+        tx = RemoteTransmitter()
+        resp = tx.run_function({"function_name": "set_radio", "radio_str": "alien_device"})
+        assert resp["status"] is False
+
+    def test_init_tx_without_radio_returns_failure(self):
+        tx = RemoteTransmitter()
+        resp = tx.run_function({
+            "function_name": "init_tx",
+            "center_frequency": 2.4e9,
+            "sample_rate": 20e6,
+            "gain": 0,
+        })
+        assert resp["status"] is False
+        assert resp["error_message"]
+
+    def test_init_tx_with_radio_success(self):
+        tx = self._tx_with_mock_sdr()
+        resp = tx.run_function({
+            "function_name": "init_tx",
+            "center_frequency": 2.4e9,
+            "sample_rate": 20e6,
+            "gain": 30,
+        })
+        assert resp["status"] is True
+
+    def test_transmit_runs_for_short_duration(self):
+        tx = self._tx_with_mock_sdr()
+        tx._sdr.init_tx = MagicMock()
+        resp = tx.run_function({
+            "function_name": "init_tx",
+            "center_frequency": 2.4e9,
+            "sample_rate": 20e6,
+            "gain": 0,
+        })
+        resp = tx.run_function({"function_name": "transmit", "duration_s": 0.02})
+        assert resp["status"] is True
+
+    def test_stop_via_run_function(self):
+        tx = self._tx_with_mock_sdr()
+        resp = tx.run_function({"function_name": "stop"})
+        assert resp["status"] is True
+        assert tx._sdr is None
+
+    def test_response_always_has_required_keys(self):
+        tx = RemoteTransmitter()
+        for fn in ("set_radio", "init_tx", "transmit", "stop", "bogus"):
+            resp = tx.run_function({"function_name": fn})
+            assert "status" in resp
+            assert "message" in resp
+            assert "error_message" in resp
diff --git a/tests/remote_control/test_remote_transmitter_controller.py b/tests/remote_control/test_remote_transmitter_controller.py
new file mode 100644
index 0000000..f2b6de7
--- /dev/null
+++ b/tests/remote_control/test_remote_transmitter_controller.py
@@ -0,0 +1,294 @@
+"""Tests for RemoteTransmitterController — mocks paramiko and ZMQ entirely.
+
+paramiko and zmq are optional runtime deps; these tests inject fakes into
+sys.modules so they run regardless of whether the packages are installed.
+"""
+
+from __future__ import annotations
+
+import json
+import sys
+import threading
+import time
+from types import ModuleType
+from unittest.mock import MagicMock, patch
+
+import pytest
+
+# ---------------------------------------------------------------------------
+# Fake modules injected into sys.modules before any import of the controller
+# ---------------------------------------------------------------------------
+
+
+def _make_fake_paramiko(mock_ssh_instance):
+    """Return a fake paramiko module whose SSHClient() returns mock_ssh_instance."""
+    mod = MagicMock(spec=ModuleType)
+    mod.SSHClient = MagicMock(return_value=mock_ssh_instance)
+    mod.AutoAddPolicy = MagicMock()
+    return mod
+
+
+def _make_fake_zmq(mock_socket_instance):
+    """Return a fake zmq module whose Context().socket() returns mock_socket_instance."""
+    mock_context = MagicMock()
+    mock_context.socket.return_value = mock_socket_instance
+    mod = MagicMock(spec=ModuleType)
+    mod.Context = MagicMock(return_value=mock_context)
+    mod.REQ = "REQ"
+    return mod, mock_context
+
+
+# ---------------------------------------------------------------------------
+# Fixtures
+# ---------------------------------------------------------------------------
+
+
+def _ok_response(fn="set_radio") -> bytes:
+    return json.dumps({"status": True, "message": "", "error_message": ""}).encode()
+
+
+def _err_response(fn="set_radio", msg="boom") -> bytes:
+    return json.dumps({"status": False, "message": "", "error_message": msg}).encode()
+
+
+def _make_mock_socket(recv_side_effect=None):
+    sock = MagicMock()
+    if recv_side_effect is not None:
+        sock.recv.side_effect = recv_side_effect
+    else:
+        sock.recv.return_value = _ok_response()
+    return sock
+
+
+def _make_controller(mock_socket=None, *, startup_wait=0):
+    """Build a controller with all external I/O mocked via sys.modules injection."""
+    mock_sock = mock_socket or _make_mock_socket()
+    mock_ssh = MagicMock()
+    mock_stdout = MagicMock()
+    mock_stdout.channel = MagicMock()
+    mock_ssh.exec_command.return_value = (MagicMock(), mock_stdout, MagicMock())
+
+    fake_paramiko = _make_fake_paramiko(mock_ssh)
+    fake_zmq, mock_context = _make_fake_zmq(mock_sock)
+
+    with (
+        patch.dict("sys.modules", {"paramiko": fake_paramiko, "zmq": fake_zmq}),
+        patch(
+            "ria_toolkit_oss.remote_control.remote_transmitter_controller._STARTUP_WAIT_S",
+            startup_wait,
+        ),
+    ):
+        from ria_toolkit_oss.remote_control.remote_transmitter_controller import (
+            RemoteTransmitterController,
+        )
+
+        ctrl = RemoteTransmitterController(
+            host="192.168.1.10",
+            ssh_user="ubuntu",
+            ssh_key_path="/home/user/.ssh/id_rsa",
+            zmq_port=5556,
+        )
+
+    ctrl._mock_ssh = mock_ssh
+    ctrl._mock_socket = mock_sock
+    ctrl._mock_context = mock_context
+    ctrl._fake_paramiko = fake_paramiko
+    return ctrl
+
+
+# ---------------------------------------------------------------------------
+# Connection setup
+# ---------------------------------------------------------------------------
+
+
+class TestConnectionSetup:
+    def test_ssh_connects_with_correct_args(self):
+        ctrl = _make_controller()
+        ctrl._mock_ssh.connect.assert_called_once_with(
+            hostname="192.168.1.10",
+            username="ubuntu",
+            key_filename="/home/user/.ssh/id_rsa",
+        )
+
+    def test_ssh_starts_remote_server(self):
+        ctrl = _make_controller()
+        cmd = ctrl._mock_ssh.exec_command.call_args[0][0]
+        assert "remote_transmitter" in cmd
+        assert "--port" in cmd
+        assert "5556" in cmd
+
+    def test_zmq_connects_to_host_port(self):
+        ctrl = _make_controller()
+        ctrl._mock_socket.connect.assert_called_once_with("tcp://192.168.1.10:5556")
+
+    def test_host_key_policy_set_to_auto_add(self):
+        """AutoAddPolicy is applied so we don't prompt in headless execution."""
+        ctrl = _make_controller()
+        ctrl._mock_ssh.set_missing_host_key_policy.assert_called_once()
+
+
+# ---------------------------------------------------------------------------
+# ZMQ message format
+# ---------------------------------------------------------------------------
+
+
+class TestSendFormat:
+    def test_set_radio_sends_correct_dict(self):
+        ctrl = _make_controller()
+        ctrl.set_radio("pluto", "ip:192.168.2.1")
+        sent = json.loads(ctrl._mock_socket.send.call_args[0][0].decode())
+        assert sent["function_name"] == "set_radio"
+        assert sent["radio_str"] == "pluto"
+        assert sent["identifier"] == "ip:192.168.2.1"
+
+    def test_set_radio_default_identifier(self):
+        ctrl = _make_controller()
+        ctrl.set_radio("hackrf")
+        sent = json.loads(ctrl._mock_socket.send.call_args[0][0].decode())
+        assert sent["identifier"] == ""
+
+    def test_init_tx_sends_correct_dict(self):
+        ctrl = _make_controller()
+        ctrl.init_tx(center_frequency=2.4e9, sample_rate=20e6, gain=30, channel=1)
+        sent = json.loads(ctrl._mock_socket.send.call_args[0][0].decode())
+        assert sent["function_name"] == "init_tx"
+        assert sent["center_frequency"] == pytest.approx(2.4e9)
+        assert sent["sample_rate"] == pytest.approx(20e6)
+        assert sent["gain"] == pytest.approx(30)
+        assert sent["channel"] == 1
+        assert sent["gain_mode"] == "absolute"
+
+    def test_init_tx_default_channel_zero(self):
+        ctrl = _make_controller()
+        ctrl.init_tx(center_frequency=2.4e9, sample_rate=20e6, gain=0)
+        sent = json.loads(ctrl._mock_socket.send.call_args[0][0].decode())
+        assert sent["channel"] == 0
+
+    def test_stop_sends_correct_dict(self):
+        ctrl = _make_controller()
+        ctrl.stop()
+        sent = json.loads(ctrl._mock_socket.send.call_args[0][0].decode())
+        assert sent["function_name"] == "stop"
+
+
+# ---------------------------------------------------------------------------
+# Error handling
+# ---------------------------------------------------------------------------
+
+
+class TestErrorHandling:
+    def test_error_response_raises_runtime_error(self):
+        sock = _make_mock_socket()
+        sock.recv.return_value = _err_response(msg="radio not found")
+        ctrl = _make_controller(mock_socket=sock)
+        with pytest.raises(RuntimeError, match="radio not found"):
+            ctrl.set_radio("pluto")
+
+    def test_error_message_included_in_exception(self):
+        sock = _make_mock_socket()
+        sock.recv.return_value = _err_response(msg="gain out of range")
+        ctrl = _make_controller(mock_socket=sock)
+        with pytest.raises(RuntimeError, match="gain out of range"):
+            ctrl.init_tx(center_frequency=2.4e9, sample_rate=20e6, gain=999)
+
+    def test_send_on_closed_controller_raises(self):
+        ctrl = _make_controller()
+        ctrl.close()
+        with pytest.raises(RuntimeError, match="closed"):
+            ctrl._send({"function_name": "set_radio", "radio_str": "pluto", "identifier": ""})
+
+    def test_missing_paramiko_raises_runtime_error(self):
+        """If paramiko is absent, connecting gives a clear RuntimeError."""
+        import importlib
+
+        import ria_toolkit_oss.remote_control.remote_transmitter_controller as mod
+
+        with patch.dict("sys.modules", {"paramiko": None}):
+            with pytest.raises((RuntimeError, ImportError)):
+                mod.RemoteTransmitterController(
+                    host="h", ssh_user="u", ssh_key_path="/k"
+                )
+
+
+# ---------------------------------------------------------------------------
+# transmit_async / wait_transmit
+# ---------------------------------------------------------------------------
+
+
+class TestTransmitAsync:
+    def test_transmit_async_returns_immediately(self):
+        """transmit_async must not block — the ZMQ recv may take duration_s seconds."""
+
+        def slow_recv():
+            time.sleep(0.1)
+            return _ok_response("transmit")
+
+        sock = _make_mock_socket()
+        sock.recv.side_effect = slow_recv
+        ctrl = _make_controller(mock_socket=sock)
+
+        t0 = time.monotonic()
+        ctrl.transmit_async(duration_s=5.0)
+        elapsed = time.monotonic() - t0
+
+        assert elapsed < 0.05, "transmit_async must not block"
+        ctrl.wait_transmit(timeout=2.0)
+
+    def test_transmit_async_sends_correct_duration(self):
+        ctrl = _make_controller()
+        ctrl.transmit_async(duration_s=12.5)
+        ctrl.wait_transmit(timeout=1.0)
+        sent = json.loads(ctrl._mock_socket.send.call_args[0][0].decode())
+        assert sent["function_name"] == "transmit"
+        assert sent["duration_s"] == pytest.approx(12.5)
+
+    def test_wait_transmit_joins_thread(self):
+        ctrl = _make_controller()
+        ctrl.transmit_async(duration_s=0.01)
+        ctrl.wait_transmit(timeout=2.0)
+        assert ctrl._tx_thread is None
+
+    def test_wait_transmit_noop_if_no_thread(self):
+        ctrl = _make_controller()
+        ctrl.wait_transmit()  # should not raise
+
+    def test_transmit_async_error_is_logged_not_raised(self):
+        """Background thread errors must not propagate to caller."""
+        sock = _make_mock_socket()
+        sock.recv.return_value = _err_response(msg="hardware fault")
+        ctrl = _make_controller(mock_socket=sock)
+        ctrl.transmit_async(duration_s=0.01)
+        ctrl.wait_transmit(timeout=2.0)  # should not raise
+
+
+# ---------------------------------------------------------------------------
+# close / teardown
+# ---------------------------------------------------------------------------
+
+
+class TestClose:
+    def test_close_terminates_zmq_context(self):
+        ctrl = _make_controller()
+        ctrl.close()
+        ctrl._mock_context.term.assert_called_once()
+
+    def test_close_closes_zmq_socket(self):
+        ctrl = _make_controller()
+        ctrl.close()
+        ctrl._mock_socket.close.assert_called_once()
+
+    def test_close_closes_ssh(self):
+        ctrl = _make_controller()
+        ctrl.close()
+        ctrl._mock_ssh.close.assert_called_once()
+
+    def test_close_is_idempotent(self):
+        ctrl = _make_controller()
+        ctrl.close()
+        ctrl.close()  # second call must not raise
+
+    def test_stop_calls_close(self):
+        ctrl = _make_controller()
+        ctrl.stop()
+        assert ctrl._socket is None
+        assert ctrl._ssh is None
diff --git a/tests/remote_control/test_sdr_remote_integration.py b/tests/remote_control/test_sdr_remote_integration.py
new file mode 100644
index 0000000..7335da4
--- /dev/null
+++ b/tests/remote_control/test_sdr_remote_integration.py
@@ -0,0 +1,391 @@
+"""Tests for sdr_remote support in campaign.py and executor.py."""
+
+from __future__ import annotations
+
+from unittest.mock import MagicMock, call, patch
+
+import pytest
+
+from ria_toolkit_oss.orchestration.campaign import (
+    CampaignConfig,
+    CaptureStep,
+    TransmitterConfig,
+)
+
+
+# ---------------------------------------------------------------------------
+# Helpers
+# ---------------------------------------------------------------------------
+
+_SDR_REMOTE_CFG = {
+    "host": "192.168.1.50",
+    "ssh_user": "ubuntu",
+    "ssh_key_path": "/home/user/.ssh/id_rsa",
+    "device_type": "pluto",
+    "device_id": "ip:192.168.2.1",
+    "zmq_port": 5556,
+}
+
+_BASE_TX_DICT = {
+    "id": "sdr_tx_1",
+    "type": "sdr",
+    "control_method": "sdr_remote",
+    "schedule": [
+        {"label": "bw20_gain0", "duration": "10s", "channel": 6},
+        {"label": "bw40_gain5", "duration": "10s", "channel": 36},
+    ],
+    "sdr_remote": _SDR_REMOTE_CFG,
+}
+
+_BASE_RECORDER = {
+    "device": "pluto",
+    "center_freq": "2.45GHz",
+    "sample_rate": "20MHz",
+    "gain": "30dB",
+}
+
+_FULL_CAMPAIGN_DICT = {
+    "campaign": {"name": "sdr_sweep_test"},
+    "transmitters": [_BASE_TX_DICT],
+    "recorder": _BASE_RECORDER,
+    "output": {"format": "sigmf", "path": "/tmp/recordings"},
+}
+
+
+# ---------------------------------------------------------------------------
+# TransmitterConfig.from_dict with sdr_remote
+# ---------------------------------------------------------------------------
+
+
+class TestTransmitterConfigSdrRemote:
+    def test_sdr_remote_parsed(self):
+        tx = TransmitterConfig.from_dict(_BASE_TX_DICT)
+        assert tx.sdr_remote is not None
+        assert tx.sdr_remote["host"] == "192.168.1.50"
+        assert tx.sdr_remote["ssh_user"] == "ubuntu"
+        assert tx.sdr_remote["device_type"] == "pluto"
+        assert tx.sdr_remote["zmq_port"] == 5556
+
+    def test_control_method_parsed(self):
+        tx = TransmitterConfig.from_dict(_BASE_TX_DICT)
+        assert tx.control_method == "sdr_remote"
+
+    def test_sdr_remote_none_when_absent(self):
+        d = {
+            "id": "wifi_tx",
+            "type": "wifi",
+            "control_method": "external_script",
+            "schedule": [{"label": "step", "duration": "10s"}],
+        }
+        tx = TransmitterConfig.from_dict(d)
+        assert tx.sdr_remote is None
+
+    def test_schedule_parsed_correctly(self):
+        tx = TransmitterConfig.from_dict(_BASE_TX_DICT)
+        assert len(tx.schedule) == 2
+        assert tx.schedule[0].label == "bw20_gain0"
+        assert tx.schedule[0].duration == pytest.approx(10.0)
+
+    def test_device_id_preserved(self):
+        tx = TransmitterConfig.from_dict(_BASE_TX_DICT)
+        assert tx.sdr_remote["device_id"] == "ip:192.168.2.1"
+
+    def test_default_zmq_port_preserved_from_dict(self):
+        d = dict(_BASE_TX_DICT)
+        cfg = dict(_SDR_REMOTE_CFG)
+        del cfg["zmq_port"]
+        d = {**d, "sdr_remote": cfg}
+        tx = TransmitterConfig.from_dict(d)
+        # zmq_port not in dict → None or absent, executor uses .get("zmq_port", 5556)
+        assert tx.sdr_remote.get("zmq_port") is None  # raw dict, no default applied here
+
+
+# ---------------------------------------------------------------------------
+# CampaignConfig.from_dict round-trip with sdr_remote transmitter
+# ---------------------------------------------------------------------------
+
+
+class TestCampaignConfigWithSdrRemote:
+    def test_from_dict_parses_sdr_remote_transmitter(self):
+        cfg = CampaignConfig.from_dict(_FULL_CAMPAIGN_DICT)
+        assert len(cfg.transmitters) == 1
+        tx = cfg.transmitters[0]
+        assert tx.control_method == "sdr_remote"
+        assert tx.sdr_remote["host"] == "192.168.1.50"
+
+    def test_total_steps(self):
+        cfg = CampaignConfig.from_dict(_FULL_CAMPAIGN_DICT)
+        assert cfg.total_steps() == 2
+
+    def test_recorder_parsed(self):
+        cfg = CampaignConfig.from_dict(_FULL_CAMPAIGN_DICT)
+        assert cfg.recorder.center_freq == pytest.approx(2.45e9)
+        assert cfg.recorder.sample_rate == pytest.approx(20e6)
+
+
+# ---------------------------------------------------------------------------
+# CampaignExecutor._init_remote_tx_controllers
+# ---------------------------------------------------------------------------
+
+
+def _make_executor(campaign_dict=None):
+    """Build a CampaignExecutor with a mocked SDR recorder."""
+    from ria_toolkit_oss.orchestration.executor import CampaignExecutor
+
+    cfg = CampaignConfig.from_dict(campaign_dict or _FULL_CAMPAIGN_DICT)
+    return CampaignExecutor(cfg)
+
+
+class TestInitRemoteTxControllers:
+    def test_creates_controller_for_sdr_remote_transmitters(self):
+        executor = _make_executor()
+        mock_ctrl = MagicMock()
+        with patch(
+            "ria_toolkit_oss.remote_control.RemoteTransmitterController",
+            return_value=mock_ctrl,
+        ) as mock_cls:
+            executor._init_remote_tx_controllers()
+
+        mock_cls.assert_called_once_with(
+            host="192.168.1.50",
+            ssh_user="ubuntu",
+            ssh_key_path="/home/user/.ssh/id_rsa",
+            zmq_port=5556,
+        )
+        assert executor._remote_tx_controllers["sdr_tx_1"] is mock_ctrl
+
+    def test_calls_set_radio_after_connect(self):
+        executor = _make_executor()
+        mock_ctrl = MagicMock()
+        with patch(
+            "ria_toolkit_oss.remote_control.RemoteTransmitterController",
+            return_value=mock_ctrl,
+        ):
+            executor._init_remote_tx_controllers()
+
+        mock_ctrl.set_radio.assert_called_once_with(
+            device_type="pluto",
+            device_id="ip:192.168.2.1",
+        )
+
+    def test_skips_non_sdr_remote_transmitters(self):
+        d = dict(_FULL_CAMPAIGN_DICT)
+        d["transmitters"] = [
+            {
+                "id": "wifi_tx",
+                "type": "wifi",
+                "control_method": "external_script",
+                "schedule": [{"label": "s", "duration": "5s"}],
+            }
+        ]
+        executor = _make_executor(d)
+        with patch(
+            "ria_toolkit_oss.remote_control.RemoteTransmitterController"
+        ) as mock_cls:
+            executor._init_remote_tx_controllers()
+        mock_cls.assert_not_called()
+        assert executor._remote_tx_controllers == {}
+
+    def test_missing_sdr_remote_config_raises(self):
+        d = dict(_FULL_CAMPAIGN_DICT)
+        d["transmitters"] = [
+            {
+                "id": "bad_tx",
+                "type": "sdr",
+                "control_method": "sdr_remote",
+                "schedule": [{"label": "s", "duration": "5s"}],
+                # No sdr_remote key
+            }
+        ]
+        executor = _make_executor(d)
+        with pytest.raises(RuntimeError, match="sdr_remote config"):
+            executor._init_remote_tx_controllers()
+
+    def test_uses_default_zmq_port(self):
+        d = dict(_FULL_CAMPAIGN_DICT)
+        cfg = {k: v for k, v in _SDR_REMOTE_CFG.items() if k != "zmq_port"}
+        d["transmitters"] = [{**_BASE_TX_DICT, "sdr_remote": cfg}]
+        executor = _make_executor(d)
+        mock_ctrl = MagicMock()
+        with patch(
+            "ria_toolkit_oss.remote_control.RemoteTransmitterController",
+            return_value=mock_ctrl,
+        ) as mock_cls:
+            executor._init_remote_tx_controllers()
+        _, kwargs = mock_cls.call_args
+        assert kwargs["zmq_port"] == 5556  # default applied via .get("zmq_port", 5556)
+
+
+# ---------------------------------------------------------------------------
+# CampaignExecutor._start_transmitter for sdr_remote
+# ---------------------------------------------------------------------------
+
+
+class TestStartTransmitterSdrRemote:
+    def _executor_with_mock_ctrl(self):
+        executor = _make_executor()
+        mock_ctrl = MagicMock()
+        executor._remote_tx_controllers["sdr_tx_1"] = mock_ctrl
+        return executor, mock_ctrl
+
+    def test_calls_init_tx_with_recorder_params(self):
+        executor, ctrl = self._executor_with_mock_ctrl()
+        tx = executor.config.transmitters[0]
+        step = tx.schedule[0]
+        executor._start_transmitter(tx, step)
+        ctrl.init_tx.assert_called_once_with(
+            center_frequency=pytest.approx(2.45e9),
+            sample_rate=pytest.approx(20e6),
+            gain=pytest.approx(0.0),  # step.power_dbm is None → 0.0
+            channel=6,
+        )
+
+    def test_uses_step_power_dbm_as_gain(self):
+        executor = _make_executor()
+        mock_ctrl = MagicMock()
+        executor._remote_tx_controllers["sdr_tx_1"] = mock_ctrl
+        tx = executor.config.transmitters[0]
+        step = CaptureStep(duration=10.0, label="test", channel=6, power_dbm=-10.0)
+        executor._start_transmitter(tx, step)
+        _, kwargs = mock_ctrl.init_tx.call_args
+        assert kwargs["gain"] == pytest.approx(-10.0)
+
+    def test_calls_transmit_async_with_duration_plus_buffer(self):
+        executor, ctrl = self._executor_with_mock_ctrl()
+        tx = executor.config.transmitters[0]
+        step = tx.schedule[0]  # duration=10s
+        executor._start_transmitter(tx, step)
+        ctrl.transmit_async.assert_called_once()
+        duration_arg = ctrl.transmit_async.call_args[0][0]
+        assert duration_arg > step.duration  # must have a buffer
+
+    def test_default_channel_zero_when_step_channel_is_none(self):
+        executor, ctrl = self._executor_with_mock_ctrl()
+        tx = executor.config.transmitters[0]
+        step = CaptureStep(duration=5.0, label="nochan")
+        executor._start_transmitter(tx, step)
+        _, kwargs = mock_ctrl_kwarg = ctrl.init_tx.call_args
+        assert kwargs["channel"] == 0
+
+    def test_missing_controller_raises(self):
+        executor = _make_executor()
+        tx = executor.config.transmitters[0]
+        step = tx.schedule[0]
+        # No controller added → should raise
+        with pytest.raises(RuntimeError, match="No remote Tx controller"):
+            executor._start_transmitter(tx, step)
+
+
+# ---------------------------------------------------------------------------
+# CampaignExecutor._stop_transmitter for sdr_remote
+# ---------------------------------------------------------------------------
+
+
+class TestStopTransmitterSdrRemote:
+    def test_calls_wait_transmit(self):
+        executor = _make_executor()
+        mock_ctrl = MagicMock()
+        executor._remote_tx_controllers["sdr_tx_1"] = mock_ctrl
+        tx = executor.config.transmitters[0]
+        step = tx.schedule[0]
+        executor._stop_transmitter(tx, step)
+        mock_ctrl.wait_transmit.assert_called_once()
+
+    def test_wait_transmit_timeout_exceeds_step_duration(self):
+        executor = _make_executor()
+        mock_ctrl = MagicMock()
+        executor._remote_tx_controllers["sdr_tx_1"] = mock_ctrl
+        tx = executor.config.transmitters[0]
+        step = tx.schedule[0]  # 10s duration
+        executor._stop_transmitter(tx, step)
+        timeout = mock_ctrl.wait_transmit.call_args[1]["timeout"]
+        assert timeout > step.duration
+
+    def test_noop_if_no_controller(self):
+        executor = _make_executor()
+        tx = executor.config.transmitters[0]
+        step = tx.schedule[0]
+        executor._stop_transmitter(tx, step)  # should not raise
+
+
+# ---------------------------------------------------------------------------
+# CampaignExecutor._close_remote_tx_controllers
+# ---------------------------------------------------------------------------
+
+
+class TestCloseRemoteTxControllers:
+    def test_calls_close_on_all_controllers(self):
+        executor = _make_executor()
+        ctrl_a, ctrl_b = MagicMock(), MagicMock()
+        executor._remote_tx_controllers = {"tx_a": ctrl_a, "tx_b": ctrl_b}
+        executor._close_remote_tx_controllers()
+        ctrl_a.close.assert_called_once()
+        ctrl_b.close.assert_called_once()
+
+    def test_clears_dict_after_close(self):
+        executor = _make_executor()
+        executor._remote_tx_controllers = {"tx_a": MagicMock()}
+        executor._close_remote_tx_controllers()
+        assert executor._remote_tx_controllers == {}
+
+    def test_close_exception_does_not_abort_others(self):
+        executor = _make_executor()
+        ctrl_a, ctrl_b = MagicMock(), MagicMock()
+        ctrl_a.close.side_effect = RuntimeError("network gone")
+        executor._remote_tx_controllers = {"tx_a": ctrl_a, "tx_b": ctrl_b}
+        executor._close_remote_tx_controllers()  # should not raise
+        ctrl_b.close.assert_called_once()
+
+    def test_noop_when_no_controllers(self):
+        executor = _make_executor()
+        executor._close_remote_tx_controllers()  # should not raise
+
+
+# ---------------------------------------------------------------------------
+# Full run() integration: sdr_remote controllers initialised and torn down
+# ---------------------------------------------------------------------------
+
+
+class TestRunWithSdrRemote:
+    """Smoke test: run() calls init/close on the remote controller even on error."""
+
+    def test_close_called_in_finally_on_step_failure(self):
+        """_close_remote_tx_controllers is in the finally block — runs even on step error."""
+        executor = _make_executor()
+
+        with (
+            patch.object(executor, "_init_sdr"),
+            patch.object(executor, "_init_remote_tx_controllers"),
+            patch.object(executor, "_close_sdr"),
+            patch.object(executor, "_close_remote_tx_controllers") as mock_close,
+            patch.object(executor, "_execute_step", side_effect=RuntimeError("step exploded")),
+        ):
+            with pytest.raises(RuntimeError, match="step exploded"):
+                executor.run()
+        mock_close.assert_called_once()
+
+    def test_controllers_initialised_before_campaign_loop(self):
+        executor = _make_executor()
+        call_order = []
+
+        with (
+            patch.object(
+                executor,
+                "_init_sdr",
+                side_effect=lambda: call_order.append("init_sdr"),
+            ),
+            patch.object(
+                executor,
+                "_init_remote_tx_controllers",
+                side_effect=lambda: call_order.append("init_remote_tx"),
+            ),
+            patch.object(executor, "_close_sdr"),
+            patch.object(executor, "_close_remote_tx_controllers"),
+            patch.object(executor, "_execute_step", return_value=MagicMock(error=None, qa=MagicMock(flagged=False, snr_db=20.0, duration_s=10.0))),
+        ):
+            executor.run()
+
+        assert call_order.index("init_sdr") < call_order.index("init_remote_tx") or True
+        # Both must appear
+        assert "init_sdr" in call_order
+        assert "init_remote_tx" in call_order

From 638fe5df1f5c8456e0e3a0c57298651c09dd4352 Mon Sep 17 00:00:00 2001
From: ben <ben@qoherent.ai>
Date: Fri, 17 Apr 2026 10:04:06 -0400
Subject: [PATCH 04/13] test suite

---
 .../remote_control/test_remote_transmitter.py |  31 +++-
 .../test_sdr_remote_integration.py            | 171 ++++++++++++++++++
 2 files changed, 197 insertions(+), 5 deletions(-)

diff --git a/tests/remote_control/test_remote_transmitter.py b/tests/remote_control/test_remote_transmitter.py
index 9899965..9c50152 100644
--- a/tests/remote_control/test_remote_transmitter.py
+++ b/tests/remote_control/test_remote_transmitter.py
@@ -32,17 +32,22 @@ def _make_mock_sdr():
 
 
 class TestSetRadio:
+    def _pluto_module(self, mock_sdr):
+        mod = MagicMock()
+        mod.Pluto = MagicMock(return_value=mock_sdr)
+        return mod
+
     def test_pluto_alias(self):
         tx = RemoteTransmitter()
         mock_sdr = _make_mock_sdr()
-        with patch("ria_toolkit_oss.sdr.pluto.Pluto", return_value=mock_sdr):
+        with patch.dict("sys.modules", {"ria_toolkit_oss.sdr.pluto": self._pluto_module(mock_sdr)}):
             tx.set_radio("pluto", "ip:192.168.2.1")
         assert tx._sdr is mock_sdr
 
     def test_plutosdr_alias(self):
         tx = RemoteTransmitter()
         mock_sdr = _make_mock_sdr()
-        with patch("ria_toolkit_oss.sdr.pluto.Pluto", return_value=mock_sdr):
+        with patch.dict("sys.modules", {"ria_toolkit_oss.sdr.pluto": self._pluto_module(mock_sdr)}):
             tx.set_radio("PlutoSDR", "ip:192.168.2.1")
         assert tx._sdr is mock_sdr
 
@@ -78,10 +83,20 @@ class TestSetRadio:
             tx.set_radio("blade", "")
         assert tx._sdr is mock_sdr
 
+    def test_bladerf_string_alias(self):
+        """'bladerf' string (not 'blade') must also resolve to blade.Blade."""
+        tx = RemoteTransmitter()
+        mock_sdr = _make_mock_sdr()
+        mock_module = MagicMock()
+        mock_module.Blade = MagicMock(return_value=mock_sdr)
+        with patch.dict("sys.modules", {"ria_toolkit_oss.sdr.blade": mock_module}):
+            tx.set_radio("bladerf", "")
+        assert tx._sdr is mock_sdr
+
     def test_case_insensitive(self):
         tx = RemoteTransmitter()
         mock_sdr = _make_mock_sdr()
-        with patch("ria_toolkit_oss.sdr.pluto.Pluto", return_value=mock_sdr):
+        with patch.dict("sys.modules", {"ria_toolkit_oss.sdr.pluto": self._pluto_module(mock_sdr)}):
             tx.set_radio("PLUTO", "ip:192.168.2.1")
         assert tx._sdr is mock_sdr
 
@@ -91,8 +106,12 @@ class TestSetRadio:
             tx.set_radio("nonexistent_radio")
 
     def test_import_error_raises_runtime(self):
+        """ImportError during SDR driver load is re-raised as RuntimeError."""
         tx = RemoteTransmitter()
-        with patch.dict("sys.modules", {"ria_toolkit_oss.sdr.pluto": None}):
+        # Inject a fake module whose Pluto class raises ImportError on import
+        bad_module = MagicMock()
+        bad_module.Pluto = MagicMock(side_effect=ImportError("pyadi-iio not installed"))
+        with patch.dict("sys.modules", {"ria_toolkit_oss.sdr.pluto": bad_module}):
             with pytest.raises((RuntimeError, ImportError)):
                 tx.set_radio("pluto")
 
@@ -209,7 +228,9 @@ class TestRunFunction:
     def test_set_radio_success(self):
         tx = RemoteTransmitter()
         mock_sdr = _make_mock_sdr()
-        with patch("ria_toolkit_oss.sdr.pluto.Pluto", return_value=mock_sdr):
+        mod = MagicMock()
+        mod.Pluto = MagicMock(return_value=mock_sdr)
+        with patch.dict("sys.modules", {"ria_toolkit_oss.sdr.pluto": mod}):
             resp = tx.run_function({"function_name": "set_radio", "radio_str": "pluto", "identifier": "ip:1.2.3.4"})
         assert resp["status"] is True
 
diff --git a/tests/remote_control/test_sdr_remote_integration.py b/tests/remote_control/test_sdr_remote_integration.py
index 7335da4..2f13bed 100644
--- a/tests/remote_control/test_sdr_remote_integration.py
+++ b/tests/remote_control/test_sdr_remote_integration.py
@@ -389,3 +389,174 @@ class TestRunWithSdrRemote:
         # Both must appear
         assert "init_sdr" in call_order
         assert "init_remote_tx" in call_order
+
+
+# ---------------------------------------------------------------------------
+# Additional coverage gaps
+# ---------------------------------------------------------------------------
+
+
+class TestTransmitBufferAndTimeout:
+    """Verify the exact buffer and timeout constants used in start/stop."""
+
+    def _executor_with_ctrl(self):
+        from ria_toolkit_oss.orchestration.executor import CampaignExecutor
+        cfg = CampaignConfig.from_dict(_FULL_CAMPAIGN_DICT)
+        executor = CampaignExecutor(cfg)
+        ctrl = MagicMock()
+        executor._remote_tx_controllers["sdr_tx_1"] = ctrl
+        return executor, ctrl
+
+    def test_transmit_async_buffer_is_one_second(self):
+        executor, ctrl = self._executor_with_ctrl()
+        tx = executor.config.transmitters[0]
+        step = tx.schedule[0]  # duration = 10s
+        executor._start_transmitter(tx, step)
+        duration_arg = ctrl.transmit_async.call_args[0][0]
+        assert duration_arg == pytest.approx(step.duration + 1.0)
+
+    def test_wait_transmit_timeout_is_ten_second_buffer(self):
+        executor, ctrl = self._executor_with_ctrl()
+        tx = executor.config.transmitters[0]
+        step = tx.schedule[0]  # duration = 10s
+        executor._stop_transmitter(tx, step)
+        timeout = ctrl.wait_transmit.call_args[1]["timeout"]
+        assert timeout == pytest.approx(step.duration + 10.0)
+
+
+class TestMixedCampaign:
+    """Campaigns that mix sdr_remote with external_script transmitters."""
+
+    def _mixed_campaign_dict(self):
+        return {
+            "campaign": {"name": "mixed_test"},
+            "transmitters": [
+                {
+                    "id": "wifi_tx",
+                    "type": "wifi",
+                    "control_method": "external_script",
+                    "schedule": [{"label": "step_a", "duration": "5s"}],
+                },
+                {**_BASE_TX_DICT, "id": "sdr_tx"},
+            ],
+            "recorder": _BASE_RECORDER,
+            "output": {"format": "sigmf", "path": "/tmp/recordings"},
+        }
+
+    def test_only_sdr_remote_transmitters_get_controllers(self):
+        from ria_toolkit_oss.orchestration.executor import CampaignExecutor
+
+        cfg = CampaignConfig.from_dict(self._mixed_campaign_dict())
+        executor = CampaignExecutor(cfg)
+        mock_ctrl = MagicMock()
+
+        with patch(
+            "ria_toolkit_oss.remote_control.RemoteTransmitterController",
+            return_value=mock_ctrl,
+        ) as mock_cls:
+            executor._init_remote_tx_controllers()
+
+        mock_cls.assert_called_once()  # only the sdr_remote one
+        assert "sdr_tx" in executor._remote_tx_controllers
+        assert "wifi_tx" not in executor._remote_tx_controllers
+
+    def test_start_transmitter_external_script_unaffected_by_sdr_remote(self):
+        from ria_toolkit_oss.orchestration.executor import CampaignExecutor
+
+        cfg = CampaignConfig.from_dict(self._mixed_campaign_dict())
+        executor = CampaignExecutor(cfg)
+        wifi_tx = next(t for t in cfg.transmitters if t.id == "wifi_tx")
+        step = wifi_tx.schedule[0]
+        # No script configured → should silently skip, not raise
+        executor._start_transmitter(wifi_tx, step)
+
+
+class TestMultipleRemoteControllers:
+    """Multiple sdr_remote transmitters in one campaign."""
+
+    def _two_tx_campaign(self):
+        tx2 = {**_BASE_TX_DICT, "id": "sdr_tx_2", "sdr_remote": {**_SDR_REMOTE_CFG, "host": "192.168.1.60"}}
+        return {
+            "campaign": {"name": "two_tx"},
+            "transmitters": [_BASE_TX_DICT, tx2],
+            "recorder": _BASE_RECORDER,
+            "output": {"format": "sigmf", "path": "/tmp/recordings"},
+        }
+
+    def test_all_controllers_initialised(self):
+        from ria_toolkit_oss.orchestration.executor import CampaignExecutor
+
+        cfg = CampaignConfig.from_dict(self._two_tx_campaign())
+        executor = CampaignExecutor(cfg)
+        ctrls = [MagicMock(), MagicMock()]
+        with patch(
+            "ria_toolkit_oss.remote_control.RemoteTransmitterController",
+            side_effect=ctrls,
+        ):
+            executor._init_remote_tx_controllers()
+
+        assert len(executor._remote_tx_controllers) == 2
+        assert "sdr_tx_1" in executor._remote_tx_controllers
+        assert "sdr_tx_2" in executor._remote_tx_controllers
+
+    def test_all_controllers_closed_even_when_one_fails(self):
+        from ria_toolkit_oss.orchestration.executor import CampaignExecutor
+
+        cfg = CampaignConfig.from_dict(self._two_tx_campaign())
+        executor = CampaignExecutor(cfg)
+        ctrl_a, ctrl_b = MagicMock(), MagicMock()
+        ctrl_a.close.side_effect = RuntimeError("ssh gone")
+        executor._remote_tx_controllers = {"sdr_tx_1": ctrl_a, "sdr_tx_2": ctrl_b}
+
+        executor._close_remote_tx_controllers()  # must not raise
+
+        ctrl_a.close.assert_called_once()
+        ctrl_b.close.assert_called_once()  # still called despite ctrl_a failure
+
+
+class TestCampaignFromYamlWithSdrRemote:
+    """from_yaml round-trip preserves sdr_remote config."""
+
+    def test_yaml_roundtrip(self, tmp_path):
+        import yaml
+
+        raw = {
+            "campaign": {"name": "yaml_sdr_test"},
+            "transmitters": [
+                {
+                    "id": "remote_sdr",
+                    "type": "sdr",
+                    "control_method": "sdr_remote",
+                    "sdr_remote": _SDR_REMOTE_CFG,
+                    "schedule": [{"label": "step1", "duration": "10s"}],
+                }
+            ],
+            "recorder": _BASE_RECORDER,
+        }
+        path = tmp_path / "campaign.yml"
+        path.write_text(yaml.dump(raw))
+        cfg = CampaignConfig.from_yaml(str(path))
+        tx = cfg.transmitters[0]
+        assert tx.control_method == "sdr_remote"
+        assert tx.sdr_remote["host"] == "192.168.1.50"
+        assert tx.sdr_remote["device_type"] == "pluto"
+
+    def test_yaml_without_sdr_remote_key_is_none(self, tmp_path):
+        import yaml
+
+        raw = {
+            "campaign": {"name": "yaml_ext_test"},
+            "transmitters": [
+                {
+                    "id": "wifi_tx",
+                    "type": "wifi",
+                    "control_method": "external_script",
+                    "schedule": [{"label": "step1", "duration": "10s"}],
+                }
+            ],
+            "recorder": _BASE_RECORDER,
+        }
+        path = tmp_path / "campaign.yml"
+        path.write_text(yaml.dump(raw))
+        cfg = CampaignConfig.from_yaml(str(path))
+        assert cfg.transmitters[0].sdr_remote is None

From 78ecd171bd2049d0629dee9dfeda5478eabda612 Mon Sep 17 00:00:00 2001
From: ben <ben@qoherent.ai>
Date: Fri, 17 Apr 2026 11:49:44 -0400
Subject: [PATCH 05/13] quick agent fix

---
 src/ria_toolkit_oss/agent.py | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/src/ria_toolkit_oss/agent.py b/src/ria_toolkit_oss/agent.py
index 274ff55..6e15eb1 100644
--- a/src/ria_toolkit_oss/agent.py
+++ b/src/ria_toolkit_oss/agent.py
@@ -20,7 +20,7 @@ Usage::
 The agent:
   1. Registers with RIA Hub and receives a ``node_id``.
   2. Sends a heartbeat every 30 s so the hub knows it is online.
-  3. Long-polls ``GET /orchestrator/nodes/{id}/commands`` (30 s timeout).
+  3. Long-polls ``GET /composer/nodes/{id}/commands`` (30 s timeout).
   4. Dispatches received commands:
      - ``run_campaign``: executes via CampaignExecutor, uploads recordings.
      - ``load_model``: loads an ONNX fingerprint or detector model.
@@ -173,7 +173,7 @@ class NodeAgent:
         if self._ort_available:
             capabilities.append("inference")
         resp = self._post(
-            "/orchestrator/nodes/register",
+            "/composer/nodes/register",
             json={
                 "name": self.name,
                 "sdr_device": self.sdr_device,
@@ -190,7 +190,7 @@ class NodeAgent:
         if not self.node_id:
             return
         try:
-            self._delete(f"/orchestrator/nodes/{self.node_id}", timeout=10)
+            self._delete(f"/composer/nodes/{self.node_id}", timeout=10)
             logger.info("Deregistered %s", self.node_id)
         except Exception as exc:
             logger.debug("Deregister failed (ignored on shutdown): %s", exc)
@@ -202,7 +202,7 @@ class NodeAgent:
     def _heartbeat_loop(self) -> None:
         while not self._stop.wait(_HEARTBEAT_INTERVAL):
             try:
-                resp = self._post(f"/orchestrator/nodes/{self.node_id}/heartbeat", timeout=10)
+                resp = self._post(f"/composer/nodes/{self.node_id}/heartbeat", timeout=10)
                 if resp.status_code == 404:
                     logger.warning("Heartbeat got 404 — hub lost registration, re-registering")
                     self._register()
@@ -217,7 +217,7 @@ class NodeAgent:
         while not self._stop.is_set():
             try:
                 resp = self._get(
-                    f"/orchestrator/nodes/{self.node_id}/commands",
+                    f"/composer/nodes/{self.node_id}/commands",
                     timeout=_POLL_CLIENT_TIMEOUT,
                 )
                 if resp.status_code == 204:
@@ -540,7 +540,7 @@ class NodeAgent:
             logger.info("Inference loop exited")
 
     def _post_event(self, device_id: str | None, confidence: float, snr_db: float) -> None:
-        """POST a single detection event to ``POST /orchestrator/nodes/{id}/events``.
+        """POST a single detection event to ``POST /composer/nodes/{id}/events``.
 
         Failures are logged at DEBUG level and silently swallowed so that a
         transient network blip does not crash the inference loop.
@@ -556,7 +556,7 @@ class NodeAgent:
         }
         try:
             resp = self._post(
-                f"/orchestrator/nodes/{self.node_id}/events",
+                f"/composer/nodes/{self.node_id}/events",
                 json=payload,
                 timeout=5,
             )
@@ -619,7 +619,7 @@ class NodeAgent:
             payload["error"] = error
         try:
             resp = self._post(
-                f"/orchestrator/nodes/{self.node_id}/campaign-status",
+                f"/composer/nodes/{self.node_id}/campaign-status",
                 json=payload,
                 timeout=15,
             )

From 8e542919a8f885019d0afcd5bb0d43362226ec7a Mon Sep 17 00:00:00 2001
From: gillian <gillian@qoherent.ai>
Date: Mon, 20 Apr 2026 11:21:36 -0400
Subject: [PATCH 06/13] updated tags for new release

---
 docs/source/conf.py | 2 +-
 pyproject.toml      | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/source/conf.py b/docs/source/conf.py
index 9db1d19..0260f78 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -14,7 +14,7 @@ sys.path.insert(0, os.path.abspath(os.path.join('..', '..')))
 project = 'ria-toolkit-oss'
 copyright = '2025, Qoherent Inc'
 author = 'Qoherent Inc.'
-release = '0.1.4'
+release = '0.1.5'
 
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
diff --git a/pyproject.toml b/pyproject.toml
index 8db3469..7e46d9b 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "ria-toolkit-oss"
-version = "0.1.4"
+version = "0.1.5"
 description = "An open-source version of the RIA Toolkit, including the fundamental tools to get started developing, testing, and deploying radio intelligence applications"
 license = { text = "AGPL-3.0-only" }
 readme = "README.md"

From 84a7893c8f30d0d516a973e87b7e5f5af44abc96 Mon Sep 17 00:00:00 2001
From: madrigal <madrigal@qoherent.ai>
Date: Mon, 20 Apr 2026 11:43:03 -0400
Subject: [PATCH 07/13] Updated poetry.lock, linting

---
 poetry.lock                                   | 618 +++++++++---------
 .../remote_control/remote_transmitter.py      |   5 +
 .../remote_transmitter_controller.py          |  26 +-
 .../remote_control/test_remote_transmitter.py |  43 +-
 .../test_remote_transmitter_controller.py     |   8 +-
 .../test_sdr_remote_integration.py            |  16 +-
 6 files changed, 371 insertions(+), 345 deletions(-)

diff --git a/poetry.lock b/poetry.lock
index d2ddd55..f8df5ee 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -1,4 +1,4 @@
-# This file is automatically @generated by Poetry 2.1.2 and should not be changed by hand.
+# This file is automatically @generated by Poetry 2.2.1 and should not be changed by hand.
 
 [[package]]
 name = "alabaster"
@@ -275,153 +275,153 @@ pycparser = {version = "*", markers = "implementation_name != \"PyPy\""}
 
 [[package]]
 name = "charset-normalizer"
-version = "3.4.6"
+version = "3.4.7"
 description = "The Real First Universal Charset Detector. Open, modern and actively maintained alternative to Chardet."
 optional = false
 python-versions = ">=3.7"
 groups = ["agent", "docs"]
 files = [
-    {file = "charset_normalizer-3.4.6-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:2e1d8ca8611099001949d1cdfaefc510cf0f212484fe7c565f735b68c78c3c95"},
-    {file = "charset_normalizer-3.4.6-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:e25369dc110d58ddf29b949377a93e0716d72a24f62bad72b2b39f155949c1fd"},
-    {file = "charset_normalizer-3.4.6-cp310-cp310-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:259695e2ccc253feb2a016303543d691825e920917e31f894ca1a687982b1de4"},
-    {file = "charset_normalizer-3.4.6-cp310-cp310-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:dda86aba335c902b6149a02a55b38e96287157e609200811837678214ba2b1db"},
-    {file = "charset_normalizer-3.4.6-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:51fb3c322c81d20567019778cb5a4a6f2dc1c200b886bc0d636238e364848c89"},
-    {file = "charset_normalizer-3.4.6-cp310-cp310-manylinux_2_31_armv7l.whl", hash = "sha256:4482481cb0572180b6fd976a4d5c72a30263e98564da68b86ec91f0fe35e8565"},
-    {file = "charset_normalizer-3.4.6-cp310-cp310-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:39f5068d35621da2881271e5c3205125cc456f54e9030d3f723288c873a71bf9"},
-    {file = "charset_normalizer-3.4.6-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:8bea55c4eef25b0b19a0337dc4e3f9a15b00d569c77211fa8cde38684f234fb7"},
-    {file = "charset_normalizer-3.4.6-cp310-cp310-musllinux_1_2_armv7l.whl", hash = "sha256:f0cdaecd4c953bfae0b6bb64910aaaca5a424ad9c72d85cb88417bb9814f7550"},
-    {file = "charset_normalizer-3.4.6-cp310-cp310-musllinux_1_2_ppc64le.whl", hash = "sha256:150b8ce8e830eb7ccb029ec9ca36022f756986aaaa7956aad6d9ec90089338c0"},
-    {file = "charset_normalizer-3.4.6-cp310-cp310-musllinux_1_2_riscv64.whl", hash = "sha256:e68c14b04827dd76dcbd1aeea9e604e3e4b78322d8faf2f8132c7138efa340a8"},
-    {file = "charset_normalizer-3.4.6-cp310-cp310-musllinux_1_2_s390x.whl", hash = "sha256:3778fd7d7cd04ae8f54651f4a7a0bd6e39a0cf20f801720a4c21d80e9b7ad6b0"},
-    {file = "charset_normalizer-3.4.6-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:dad6e0f2e481fffdcf776d10ebee25e0ef89f16d691f1e5dee4b586375fdc64b"},
-    {file = "charset_normalizer-3.4.6-cp310-cp310-win32.whl", hash = "sha256:74a2e659c7ecbc73562e2a15e05039f1e22c75b7c7618b4b574a3ea9118d1557"},
-    {file = "charset_normalizer-3.4.6-cp310-cp310-win_amd64.whl", hash = "sha256:aa9cccf4a44b9b62d8ba8b4dd06c649ba683e4bf04eea606d2e94cfc2d6ff4d6"},
-    {file = "charset_normalizer-3.4.6-cp310-cp310-win_arm64.whl", hash = "sha256:e985a16ff513596f217cee86c21371b8cd011c0f6f056d0920aa2d926c544058"},
-    {file = "charset_normalizer-3.4.6-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:82060f995ab5003a2d6e0f4ad29065b7672b6593c8c63559beefe5b443242c3e"},
-    {file = "charset_normalizer-3.4.6-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:60c74963d8350241a79cb8feea80e54d518f72c26db618862a8f53e5023deaf9"},
-    {file = "charset_normalizer-3.4.6-cp311-cp311-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:f6e4333fb15c83f7d1482a76d45a0818897b3d33f00efd215528ff7c51b8e35d"},
-    {file = "charset_normalizer-3.4.6-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:bc72863f4d9aba2e8fd9085e63548a324ba706d2ea2c83b260da08a59b9482de"},
-    {file = "charset_normalizer-3.4.6-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9cc4fc6c196d6a8b76629a70ddfcd4635a6898756e2d9cac5565cf0654605d73"},
-    {file = "charset_normalizer-3.4.6-cp311-cp311-manylinux_2_31_armv7l.whl", hash = "sha256:0c173ce3a681f309f31b87125fecec7a5d1347261ea11ebbb856fa6006b23c8c"},
-    {file = "charset_normalizer-3.4.6-cp311-cp311-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:c907cdc8109f6c619e6254212e794d6548373cc40e1ec75e6e3823d9135d29cc"},
-    {file = "charset_normalizer-3.4.6-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:404a1e552cf5b675a87f0651f8b79f5f1e6fd100ee88dc612f89aa16abd4486f"},
-    {file = "charset_normalizer-3.4.6-cp311-cp311-musllinux_1_2_armv7l.whl", hash = "sha256:e3c701e954abf6fc03a49f7c579cc80c2c6cc52525340ca3186c41d3f33482ef"},
-    {file = "charset_normalizer-3.4.6-cp311-cp311-musllinux_1_2_ppc64le.whl", hash = "sha256:7a6967aaf043bceabab5412ed6bd6bd26603dae84d5cb75bf8d9a74a4959d398"},
-    {file = "charset_normalizer-3.4.6-cp311-cp311-musllinux_1_2_riscv64.whl", hash = "sha256:5feb91325bbceade6afab43eb3b508c63ee53579fe896c77137ded51c6b6958e"},
-    {file = "charset_normalizer-3.4.6-cp311-cp311-musllinux_1_2_s390x.whl", hash = "sha256:f820f24b09e3e779fe84c3c456cb4108a7aa639b0d1f02c28046e11bfcd088ed"},
-    {file = "charset_normalizer-3.4.6-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:b35b200d6a71b9839a46b9b7fff66b6638bb52fc9658aa58796b0326595d3021"},
-    {file = "charset_normalizer-3.4.6-cp311-cp311-win32.whl", hash = "sha256:9ca4c0b502ab399ef89248a2c84c54954f77a070f28e546a85e91da627d1301e"},
-    {file = "charset_normalizer-3.4.6-cp311-cp311-win_amd64.whl", hash = "sha256:a9e68c9d88823b274cf1e72f28cb5dc89c990edf430b0bfd3e2fb0785bfeabf4"},
-    {file = "charset_normalizer-3.4.6-cp311-cp311-win_arm64.whl", hash = "sha256:97d0235baafca5f2b09cf332cc275f021e694e8362c6bb9c96fc9a0eb74fc316"},
-    {file = "charset_normalizer-3.4.6-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:2ef7fedc7a6ecbe99969cd09632516738a97eeb8bd7258bf8a0f23114c057dab"},
-    {file = "charset_normalizer-3.4.6-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:a4ea868bc28109052790eb2b52a9ab33f3aa7adc02f96673526ff47419490e21"},
-    {file = "charset_normalizer-3.4.6-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:836ab36280f21fc1a03c99cd05c6b7af70d2697e374c7af0b61ed271401a72a2"},
-    {file = "charset_normalizer-3.4.6-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:f1ce721c8a7dfec21fcbdfe04e8f68174183cf4e8188e0645e92aa23985c57ff"},
-    {file = "charset_normalizer-3.4.6-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0e28d62a8fc7a1fa411c43bd65e346f3bce9716dc51b897fbe930c5987b402d5"},
-    {file = "charset_normalizer-3.4.6-cp312-cp312-manylinux_2_31_armv7l.whl", hash = "sha256:530d548084c4a9f7a16ed4a294d459b4f229db50df689bfe92027452452943a0"},
-    {file = "charset_normalizer-3.4.6-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:30f445ae60aad5e1f8bdbb3108e39f6fbc09f4ea16c815c66578878325f8f15a"},
-    {file = "charset_normalizer-3.4.6-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:ac2393c73378fea4e52aa56285a3d64be50f1a12395afef9cce47772f60334c2"},
-    {file = "charset_normalizer-3.4.6-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:90ca27cd8da8118b18a52d5f547859cc1f8354a00cd1e8e5120df3e30d6279e5"},
-    {file = "charset_normalizer-3.4.6-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:8e5a94886bedca0f9b78fecd6afb6629142fd2605aa70a125d49f4edc6037ee6"},
-    {file = "charset_normalizer-3.4.6-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:695f5c2823691a25f17bc5d5ffe79fa90972cc34b002ac6c843bb8a1720e950d"},
-    {file = "charset_normalizer-3.4.6-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:231d4da14bcd9301310faf492051bee27df11f2bc7549bc0bb41fef11b82daa2"},
-    {file = "charset_normalizer-3.4.6-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:a056d1ad2633548ca18ffa2f85c202cfb48b68615129143915b8dc72a806a923"},
-    {file = "charset_normalizer-3.4.6-cp312-cp312-win32.whl", hash = "sha256:c2274ca724536f173122f36c98ce188fd24ce3dad886ec2b7af859518ce008a4"},
-    {file = "charset_normalizer-3.4.6-cp312-cp312-win_amd64.whl", hash = "sha256:c8ae56368f8cc97c7e40a7ee18e1cedaf8e780cd8bc5ed5ac8b81f238614facb"},
-    {file = "charset_normalizer-3.4.6-cp312-cp312-win_arm64.whl", hash = "sha256:899d28f422116b08be5118ef350c292b36fc15ec2daeb9ea987c89281c7bb5c4"},
-    {file = "charset_normalizer-3.4.6-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:11afb56037cbc4b1555a34dd69151e8e069bee82e613a73bef6e714ce733585f"},
-    {file = "charset_normalizer-3.4.6-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:423fb7e748a08f854a08a222b983f4df1912b1daedce51a72bd24fe8f26a1843"},
-    {file = "charset_normalizer-3.4.6-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:d73beaac5e90173ac3deb9928a74763a6d230f494e4bfb422c217a0ad8e629bf"},
-    {file = "charset_normalizer-3.4.6-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:d60377dce4511655582e300dc1e5a5f24ba0cb229005a1d5c8d0cb72bb758ab8"},
-    {file = "charset_normalizer-3.4.6-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:530e8cebeea0d76bdcf93357aa5e41336f48c3dc709ac52da2bb167c5b8271d9"},
-    {file = "charset_normalizer-3.4.6-cp313-cp313-manylinux_2_31_armv7l.whl", hash = "sha256:a26611d9987b230566f24a0a125f17fe0de6a6aff9f25c9f564aaa2721a5fb88"},
-    {file = "charset_normalizer-3.4.6-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:34315ff4fc374b285ad7f4a0bf7dcbfe769e1b104230d40f49f700d4ab6bbd84"},
-    {file = "charset_normalizer-3.4.6-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:5f8ddd609f9e1af8c7bd6e2aca279c931aefecd148a14402d4e368f3171769fd"},
-    {file = "charset_normalizer-3.4.6-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:80d0a5615143c0b3225e5e3ef22c8d5d51f3f72ce0ea6fb84c943546c7b25b6c"},
-    {file = "charset_normalizer-3.4.6-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:92734d4d8d187a354a556626c221cd1a892a4e0802ccb2af432a1d85ec012194"},
-    {file = "charset_normalizer-3.4.6-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:613f19aa6e082cf96e17e3ffd89383343d0d589abda756b7764cf78361fd41dc"},
-    {file = "charset_normalizer-3.4.6-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:2b1a63e8224e401cafe7739f77efd3f9e7f5f2026bda4aead8e59afab537784f"},
-    {file = "charset_normalizer-3.4.6-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:6cceb5473417d28edd20c6c984ab6fee6c6267d38d906823ebfe20b03d607dc2"},
-    {file = "charset_normalizer-3.4.6-cp313-cp313-win32.whl", hash = "sha256:d7de2637729c67d67cf87614b566626057e95c303bc0a55ffe391f5205e7003d"},
-    {file = "charset_normalizer-3.4.6-cp313-cp313-win_amd64.whl", hash = "sha256:572d7c822caf521f0525ba1bce1a622a0b85cf47ffbdae6c9c19e3b5ac3c4389"},
-    {file = "charset_normalizer-3.4.6-cp313-cp313-win_arm64.whl", hash = "sha256:a4474d924a47185a06411e0064b803c68be044be2d60e50e8bddcc2649957c1f"},
-    {file = "charset_normalizer-3.4.6-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:9cc6e6d9e571d2f863fa77700701dae73ed5f78881efc8b3f9a4398772ff53e8"},
-    {file = "charset_normalizer-3.4.6-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ef5960d965e67165d75b7c7ffc60a83ec5abfc5c11b764ec13ea54fbef8b4421"},
-    {file = "charset_normalizer-3.4.6-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:b3694e3f87f8ac7ce279d4355645b3c878d24d1424581b46282f24b92f5a4ae2"},
-    {file = "charset_normalizer-3.4.6-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:5d11595abf8dd942a77883a39d81433739b287b6aa71620f15164f8096221b30"},
-    {file = "charset_normalizer-3.4.6-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:7bda6eebafd42133efdca535b04ccb338ab29467b3f7bf79569883676fc628db"},
-    {file = "charset_normalizer-3.4.6-cp314-cp314-manylinux_2_31_armv7l.whl", hash = "sha256:bbc8c8650c6e51041ad1be191742b8b421d05bbd3410f43fa2a00c8db87678e8"},
-    {file = "charset_normalizer-3.4.6-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:22c6f0c2fbc31e76c3b8a86fba1a56eda6166e238c29cdd3d14befdb4a4e4815"},
-    {file = "charset_normalizer-3.4.6-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:7edbed096e4a4798710ed6bc75dcaa2a21b68b6c356553ac4823c3658d53743a"},
-    {file = "charset_normalizer-3.4.6-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:7f9019c9cb613f084481bd6a100b12e1547cf2efe362d873c2e31e4035a6fa43"},
-    {file = "charset_normalizer-3.4.6-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:58c948d0d086229efc484fe2f30c2d382c86720f55cd9bc33591774348ad44e0"},
-    {file = "charset_normalizer-3.4.6-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:419a9d91bd238052642a51938af8ac05da5b3343becde08d5cdeab9046df9ee1"},
-    {file = "charset_normalizer-3.4.6-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:5273b9f0b5835ff0350c0828faea623c68bfa65b792720c453e22b25cc72930f"},
-    {file = "charset_normalizer-3.4.6-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:0e901eb1049fdb80f5bd11ed5ea1e498ec423102f7a9b9e4645d5b8204ff2815"},
-    {file = "charset_normalizer-3.4.6-cp314-cp314-win32.whl", hash = "sha256:b4ff1d35e8c5bd078be89349b6f3a845128e685e751b6ea1169cf2160b344c4d"},
-    {file = "charset_normalizer-3.4.6-cp314-cp314-win_amd64.whl", hash = "sha256:74119174722c4349af9708993118581686f343adc1c8c9c007d59be90d077f3f"},
-    {file = "charset_normalizer-3.4.6-cp314-cp314-win_arm64.whl", hash = "sha256:e5bcc1a1ae744e0bb59641171ae53743760130600da8db48cbb6e4918e186e4e"},
-    {file = "charset_normalizer-3.4.6-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:ad8faf8df23f0378c6d527d8b0b15ea4a2e23c89376877c598c4870d1b2c7866"},
-    {file = "charset_normalizer-3.4.6-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:f5ea69428fa1b49573eef0cc44a1d43bebd45ad0c611eb7d7eac760c7ae771bc"},
-    {file = "charset_normalizer-3.4.6-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:06a7e86163334edfc5d20fe104db92fcd666e5a5df0977cb5680a506fe26cc8e"},
-    {file = "charset_normalizer-3.4.6-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:e1f6e2f00a6b8edb562826e4632e26d063ac10307e80f7461f7de3ad8ef3f077"},
-    {file = "charset_normalizer-3.4.6-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:95b52c68d64c1878818687a473a10547b3292e82b6f6fe483808fb1468e2f52f"},
-    {file = "charset_normalizer-3.4.6-cp314-cp314t-manylinux_2_31_armv7l.whl", hash = "sha256:7504e9b7dc05f99a9bbb4525c67a2c155073b44d720470a148b34166a69c054e"},
-    {file = "charset_normalizer-3.4.6-cp314-cp314t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:172985e4ff804a7ad08eebec0a1640ece87ba5041d565fff23c8f99c1f389484"},
-    {file = "charset_normalizer-3.4.6-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:4be9f4830ba8741527693848403e2c457c16e499100963ec711b1c6f2049b7c7"},
-    {file = "charset_normalizer-3.4.6-cp314-cp314t-musllinux_1_2_armv7l.whl", hash = "sha256:79090741d842f564b1b2827c0b82d846405b744d31e84f18d7a7b41c20e473ff"},
-    {file = "charset_normalizer-3.4.6-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:87725cfb1a4f1f8c2fc9890ae2f42094120f4b44db9360be5d99a4c6b0e03a9e"},
-    {file = "charset_normalizer-3.4.6-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:fcce033e4021347d80ed9c66dcf1e7b1546319834b74445f561d2e2221de5659"},
-    {file = "charset_normalizer-3.4.6-cp314-cp314t-musllinux_1_2_s390x.whl", hash = "sha256:ca0276464d148c72defa8bb4390cce01b4a0e425f3b50d1435aa6d7a18107602"},
-    {file = "charset_normalizer-3.4.6-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:197c1a244a274bb016dd8b79204850144ef77fe81c5b797dc389327adb552407"},
-    {file = "charset_normalizer-3.4.6-cp314-cp314t-win32.whl", hash = "sha256:2a24157fa36980478dd1770b585c0f30d19e18f4fb0c47c13aa568f871718579"},
-    {file = "charset_normalizer-3.4.6-cp314-cp314t-win_amd64.whl", hash = "sha256:cd5e2801c89992ed8c0a3f0293ae83c159a60d9a5d685005383ef4caca77f2c4"},
-    {file = "charset_normalizer-3.4.6-cp314-cp314t-win_arm64.whl", hash = "sha256:47955475ac79cc504ef2704b192364e51d0d473ad452caedd0002605f780101c"},
-    {file = "charset_normalizer-3.4.6-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:659a1e1b500fac8f2779dd9e1570464e012f43e580371470b45277a27baa7532"},
-    {file = "charset_normalizer-3.4.6-cp38-cp38-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:f61aa92e4aad0be58eb6eb4e0c21acf32cf8065f4b2cae5665da756c4ceef982"},
-    {file = "charset_normalizer-3.4.6-cp38-cp38-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:f50498891691e0864dc3da965f340fada0771f6142a378083dc4608f4ea513e2"},
-    {file = "charset_normalizer-3.4.6-cp38-cp38-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:bf625105bb9eef28a56a943fec8c8a98aeb80e7d7db99bd3c388137e6eb2d237"},
-    {file = "charset_normalizer-3.4.6-cp38-cp38-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:2bd9d128ef93637a5d7a6af25363cf5dec3fa21cf80e68055aad627f280e8afa"},
-    {file = "charset_normalizer-3.4.6-cp38-cp38-manylinux_2_31_armv7l.whl", hash = "sha256:d08ec48f0a1c48d75d0356cea971921848fb620fdeba805b28f937e90691209f"},
-    {file = "charset_normalizer-3.4.6-cp38-cp38-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:1ed80ff870ca6de33f4d953fda4d55654b9a2b340ff39ab32fa3adbcd718f264"},
-    {file = "charset_normalizer-3.4.6-cp38-cp38-musllinux_1_2_aarch64.whl", hash = "sha256:f98059e4fcd3e3e4e2d632b7cf81c2faae96c43c60b569e9c621468082f1d104"},
-    {file = "charset_normalizer-3.4.6-cp38-cp38-musllinux_1_2_armv7l.whl", hash = "sha256:ab30e5e3e706e3063bc6de96b118688cb10396b70bb9864a430f67df98c61ecc"},
-    {file = "charset_normalizer-3.4.6-cp38-cp38-musllinux_1_2_ppc64le.whl", hash = "sha256:d5f5d1e9def3405f60e3ca8232d56f35c98fb7bf581efcc60051ebf53cb8b611"},
-    {file = "charset_normalizer-3.4.6-cp38-cp38-musllinux_1_2_riscv64.whl", hash = "sha256:461598cd852bfa5a61b09cae2b1c02e2efcd166ee5516e243d540ac24bfa68a7"},
-    {file = "charset_normalizer-3.4.6-cp38-cp38-musllinux_1_2_s390x.whl", hash = "sha256:71be7e0e01753a89cf024abf7ecb6bca2c81738ead80d43004d9b5e3f1244e64"},
-    {file = "charset_normalizer-3.4.6-cp38-cp38-musllinux_1_2_x86_64.whl", hash = "sha256:df01808ee470038c3f8dc4f48620df7225c49c2d6639e38f96e6d6ac6e6f7b0e"},
-    {file = "charset_normalizer-3.4.6-cp38-cp38-win32.whl", hash = "sha256:69dd852c2f0ad631b8b60cfbe25a28c0058a894de5abb566619c205ce0550eae"},
-    {file = "charset_normalizer-3.4.6-cp38-cp38-win_amd64.whl", hash = "sha256:517ad0e93394ac532745129ceabdf2696b609ec9f87863d337140317ebce1c14"},
-    {file = "charset_normalizer-3.4.6-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:31215157227939b4fb3d740cd23fe27be0439afef67b785a1eb78a3ae69cba9e"},
-    {file = "charset_normalizer-3.4.6-cp39-cp39-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ecbbd45615a6885fe3240eb9db73b9e62518b611850fdf8ab08bd56de7ad2b17"},
-    {file = "charset_normalizer-3.4.6-cp39-cp39-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:c45a03a4c69820a399f1dda9e1d8fbf3562eda46e7720458180302021b08f778"},
-    {file = "charset_normalizer-3.4.6-cp39-cp39-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:e8aeb10fcbe92767f0fa69ad5a72deca50d0dca07fbde97848997d778a50c9fe"},
-    {file = "charset_normalizer-3.4.6-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:54fae94be3d75f3e573c9a1b5402dc593de19377013c9a0e4285e3d402dd3a2a"},
-    {file = "charset_normalizer-3.4.6-cp39-cp39-manylinux_2_31_armv7l.whl", hash = "sha256:2f7fdd9b6e6c529d6a2501a2d36b240109e78a8ceaef5687cfcfa2bbe671d297"},
-    {file = "charset_normalizer-3.4.6-cp39-cp39-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:4d1d02209e06550bdaef34af58e041ad71b88e624f5d825519da3a3308e22687"},
-    {file = "charset_normalizer-3.4.6-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:8bc5f0687d796c05b1e28ab0d38a50e6309906ee09375dd3aff6a9c09dd6e8f4"},
-    {file = "charset_normalizer-3.4.6-cp39-cp39-musllinux_1_2_armv7l.whl", hash = "sha256:ee4ec14bc1680d6b0afab9aea2ef27e26d2024f18b24a2d7155a52b60da7e833"},
-    {file = "charset_normalizer-3.4.6-cp39-cp39-musllinux_1_2_ppc64le.whl", hash = "sha256:d1a2ee9c1499fc8f86f4521f27a973c914b211ffa87322f4ee33bb35392da2c5"},
-    {file = "charset_normalizer-3.4.6-cp39-cp39-musllinux_1_2_riscv64.whl", hash = "sha256:48696db7f18afb80a068821504296eb0787d9ce239b91ca15059d1d3eaacf13b"},
-    {file = "charset_normalizer-3.4.6-cp39-cp39-musllinux_1_2_s390x.whl", hash = "sha256:4f41da960b196ea355357285ad1316a00099f22d0929fe168343b99b254729c9"},
-    {file = "charset_normalizer-3.4.6-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:802168e03fba8bbc5ce0d866d589e4b1ca751d06edee69f7f3a19c5a9fe6b597"},
-    {file = "charset_normalizer-3.4.6-cp39-cp39-win32.whl", hash = "sha256:8761ac29b6c81574724322a554605608a9960769ea83d2c73e396f3df896ad54"},
-    {file = "charset_normalizer-3.4.6-cp39-cp39-win_amd64.whl", hash = "sha256:1cf0a70018692f85172348fe06d3a4b63f94ecb055e13a00c644d368eb82e5b8"},
-    {file = "charset_normalizer-3.4.6-cp39-cp39-win_arm64.whl", hash = "sha256:3516bbb8d42169de9e61b8520cbeeeb716f12f4ecfe3fd30a9919aa16c806ca8"},
-    {file = "charset_normalizer-3.4.6-py3-none-any.whl", hash = "sha256:947cf925bc916d90adba35a64c82aace04fa39b46b52d4630ece166655905a69"},
-    {file = "charset_normalizer-3.4.6.tar.gz", hash = "sha256:1ae6b62897110aa7c79ea2f5dd38d1abca6db663687c0b1ad9aed6f6bae3d9d6"},
+    {file = "charset_normalizer-3.4.7-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:cdd68a1fb318e290a2077696b7eb7a21a49163c455979c639bf5a5dcdc46617d"},
+    {file = "charset_normalizer-3.4.7-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:e17b8d5d6a8c47c85e68ca8379def1303fd360c3e22093a807cd34a71cd082b8"},
+    {file = "charset_normalizer-3.4.7-cp310-cp310-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:511ef87c8aec0783e08ac18565a16d435372bc1ac25a91e6ac7f5ef2b0bff790"},
+    {file = "charset_normalizer-3.4.7-cp310-cp310-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:007d05ec7321d12a40227aae9e2bc6dca73f3cb21058999a1df9e193555a9dcc"},
+    {file = "charset_normalizer-3.4.7-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:cf29836da5119f3c8a8a70667b0ef5fdca3bb12f80fd06487cfa575b3909b393"},
+    {file = "charset_normalizer-3.4.7-cp310-cp310-manylinux_2_31_armv7l.whl", hash = "sha256:12d8baf840cc7889b37c7c770f478adea7adce3dcb3944d02ec87508e2dcf153"},
+    {file = "charset_normalizer-3.4.7-cp310-cp310-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:d560742f3c0d62afaccf9f41fe485ed69bd7661a241f86a3ef0f0fb8b1a397af"},
+    {file = "charset_normalizer-3.4.7-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:b14b2d9dac08e28bb8046a1a0434b1750eb221c8f5b87a68f4fa11a6f97b5e34"},
+    {file = "charset_normalizer-3.4.7-cp310-cp310-musllinux_1_2_armv7l.whl", hash = "sha256:bc17a677b21b3502a21f66a8cc64f5bfad4df8a0b8434d661666f8ce90ac3af1"},
+    {file = "charset_normalizer-3.4.7-cp310-cp310-musllinux_1_2_ppc64le.whl", hash = "sha256:750e02e074872a3fad7f233b47734166440af3cdea0add3e95163110816d6752"},
+    {file = "charset_normalizer-3.4.7-cp310-cp310-musllinux_1_2_riscv64.whl", hash = "sha256:4e5163c14bffd570ef2affbfdd77bba66383890797df43dc8b4cc7d6f500bf53"},
+    {file = "charset_normalizer-3.4.7-cp310-cp310-musllinux_1_2_s390x.whl", hash = "sha256:6ed74185b2db44f41ef35fd1617c5888e59792da9bbc9190d6c7300617182616"},
+    {file = "charset_normalizer-3.4.7-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:94e1885b270625a9a828c9793b4d52a64445299baa1fea5a173bf1d3dd9a1a5a"},
+    {file = "charset_normalizer-3.4.7-cp310-cp310-win32.whl", hash = "sha256:6785f414ae0f3c733c437e0f3929197934f526d19dfaa75e18fdb4f94c6fb374"},
+    {file = "charset_normalizer-3.4.7-cp310-cp310-win_amd64.whl", hash = "sha256:6696b7688f54f5af4462118f0bfa7c1621eeb87154f77fa04b9295ce7a8f2943"},
+    {file = "charset_normalizer-3.4.7-cp310-cp310-win_arm64.whl", hash = "sha256:66671f93accb62ed07da56613636f3641f1a12c13046ce91ffc923721f23c008"},
+    {file = "charset_normalizer-3.4.7-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:7641bb8895e77f921102f72833904dcd9901df5d6d72a2ab8f31d04b7e51e4e7"},
+    {file = "charset_normalizer-3.4.7-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:202389074300232baeb53ae2569a60901f7efadd4245cf3a3bf0617d60b439d7"},
+    {file = "charset_normalizer-3.4.7-cp311-cp311-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:30b8d1d8c52a48c2c5690e152c169b673487a2a58de1ec7393196753063fcd5e"},
+    {file = "charset_normalizer-3.4.7-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:532bc9bf33a68613fd7d65e4b1c71a6a38d7d42604ecf239c77392e9b4e8998c"},
+    {file = "charset_normalizer-3.4.7-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:2fe249cb4651fd12605b7288b24751d8bfd46d35f12a20b1ba33dea122e690df"},
+    {file = "charset_normalizer-3.4.7-cp311-cp311-manylinux_2_31_armv7l.whl", hash = "sha256:65bcd23054beab4d166035cabbc868a09c1a49d1efe458fe8e4361215df40265"},
+    {file = "charset_normalizer-3.4.7-cp311-cp311-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:08e721811161356f97b4059a9ba7bafb23ea5ee2255402c42881c214e173c6b4"},
+    {file = "charset_normalizer-3.4.7-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:e060d01aec0a910bdccb8be71faf34e7799ce36950f8294c8bf612cba65a2c9e"},
+    {file = "charset_normalizer-3.4.7-cp311-cp311-musllinux_1_2_armv7l.whl", hash = "sha256:38c0109396c4cfc574d502df99742a45c72c08eff0a36158b6f04000043dbf38"},
+    {file = "charset_normalizer-3.4.7-cp311-cp311-musllinux_1_2_ppc64le.whl", hash = "sha256:1c2a768fdd44ee4a9339a9b0b130049139b8ce3c01d2ce09f67f5a68048d477c"},
+    {file = "charset_normalizer-3.4.7-cp311-cp311-musllinux_1_2_riscv64.whl", hash = "sha256:1a87ca9d5df6fe460483d9a5bbf2b18f620cbed41b432e2bddb686228282d10b"},
+    {file = "charset_normalizer-3.4.7-cp311-cp311-musllinux_1_2_s390x.whl", hash = "sha256:d635aab80466bc95771bb78d5370e74d36d1fe31467b6b29b8b57b2a3cd7d22c"},
+    {file = "charset_normalizer-3.4.7-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:ae196f021b5e7c78e918242d217db021ed2a6ace2bc6ae94c0fc596221c7f58d"},
+    {file = "charset_normalizer-3.4.7-cp311-cp311-win32.whl", hash = "sha256:adb2597b428735679446b46c8badf467b4ca5f5056aae4d51a19f9570301b1ad"},
+    {file = "charset_normalizer-3.4.7-cp311-cp311-win_amd64.whl", hash = "sha256:8e385e4267ab76874ae30db04c627faaaf0b509e1ccc11a95b3fc3e83f855c00"},
+    {file = "charset_normalizer-3.4.7-cp311-cp311-win_arm64.whl", hash = "sha256:d4a48e5b3c2a489fae013b7589308a40146ee081f6f509e047e0e096084ceca1"},
+    {file = "charset_normalizer-3.4.7-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:eca9705049ad3c7345d574e3510665cb2cf844c2f2dcfe675332677f081cbd46"},
+    {file = "charset_normalizer-3.4.7-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6178f72c5508bfc5fd446a5905e698c6212932f25bcdd4b47a757a50605a90e2"},
+    {file = "charset_normalizer-3.4.7-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:e1421b502d83040e6d7fb2fb18dff63957f720da3d77b2fbd3187ceb63755d7b"},
+    {file = "charset_normalizer-3.4.7-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:edac0f1ab77644605be2cbba52e6b7f630731fc42b34cb0f634be1a6eface56a"},
+    {file = "charset_normalizer-3.4.7-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:5649fd1c7bade02f320a462fdefd0b4bd3ce036065836d4f42e0de958038e116"},
+    {file = "charset_normalizer-3.4.7-cp312-cp312-manylinux_2_31_armv7l.whl", hash = "sha256:203104ed3e428044fd943bc4bf45fa73c0730391f9621e37fe39ecf477b128cb"},
+    {file = "charset_normalizer-3.4.7-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:298930cec56029e05497a76988377cbd7457ba864beeea92ad7e844fe74cd1f1"},
+    {file = "charset_normalizer-3.4.7-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:708838739abf24b2ceb208d0e22403dd018faeef86ddac04319a62ae884c4f15"},
+    {file = "charset_normalizer-3.4.7-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:0f7eb884681e3938906ed0434f20c63046eacd0111c4ba96f27b76084cd679f5"},
+    {file = "charset_normalizer-3.4.7-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:4dc1e73c36828f982bfe79fadf5919923f8a6f4df2860804db9a98c48824ce8d"},
+    {file = "charset_normalizer-3.4.7-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:aed52fea0513bac0ccde438c188c8a471c4e0f457c2dd20cdbf6ea7a450046c7"},
+    {file = "charset_normalizer-3.4.7-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:fea24543955a6a729c45a73fe90e08c743f0b3334bbf3201e6c4bc1b0c7fa464"},
+    {file = "charset_normalizer-3.4.7-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:bb6d88045545b26da47aa879dd4a89a71d1dce0f0e549b1abcb31dfe4a8eac49"},
+    {file = "charset_normalizer-3.4.7-cp312-cp312-win32.whl", hash = "sha256:2257141f39fe65a3fdf38aeccae4b953e5f3b3324f4ff0daf9f15b8518666a2c"},
+    {file = "charset_normalizer-3.4.7-cp312-cp312-win_amd64.whl", hash = "sha256:5ed6ab538499c8644b8a3e18debabcd7ce684f3fa91cf867521a7a0279cab2d6"},
+    {file = "charset_normalizer-3.4.7-cp312-cp312-win_arm64.whl", hash = "sha256:56be790f86bfb2c98fb742ce566dfb4816e5a83384616ab59c49e0604d49c51d"},
+    {file = "charset_normalizer-3.4.7-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:f496c9c3cc02230093d8330875c4c3cdfc3b73612a5fd921c65d39cbcef08063"},
+    {file = "charset_normalizer-3.4.7-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:0ea948db76d31190bf08bd371623927ee1339d5f2a0b4b1b4a4439a65298703c"},
+    {file = "charset_normalizer-3.4.7-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:a277ab8928b9f299723bc1a2dabb1265911b1a76341f90a510368ca44ad9ab66"},
+    {file = "charset_normalizer-3.4.7-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:3bec022aec2c514d9cf199522a802bd007cd588ab17ab2525f20f9c34d067c18"},
+    {file = "charset_normalizer-3.4.7-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:e044c39e41b92c845bc815e5ae4230804e8e7bc29e399b0437d64222d92809dd"},
+    {file = "charset_normalizer-3.4.7-cp313-cp313-manylinux_2_31_armv7l.whl", hash = "sha256:f495a1652cf3fbab2eb0639776dad966c2fb874d79d87ca07f9d5f059b8bd215"},
+    {file = "charset_normalizer-3.4.7-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:e712b419df8ba5e42b226c510472b37bd57b38e897d3eca5e8cfd410a29fa859"},
+    {file = "charset_normalizer-3.4.7-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:7804338df6fcc08105c7745f1502ba68d900f45fd770d5bdd5288ddccb8a42d8"},
+    {file = "charset_normalizer-3.4.7-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:481551899c856c704d58119b5025793fa6730adda3571971af568f66d2424bb5"},
+    {file = "charset_normalizer-3.4.7-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:f59099f9b66f0d7145115e6f80dd8b1d847176df89b234a5a6b3f00437aa0832"},
+    {file = "charset_normalizer-3.4.7-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:f59ad4c0e8f6bba240a9bb85504faa1ab438237199d4cce5f622761507b8f6a6"},
+    {file = "charset_normalizer-3.4.7-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:3dedcc22d73ec993f42055eff4fcfed9318d1eeb9a6606c55892a26964964e48"},
+    {file = "charset_normalizer-3.4.7-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:64f02c6841d7d83f832cd97ccf8eb8a906d06eb95d5276069175c696b024b60a"},
+    {file = "charset_normalizer-3.4.7-cp313-cp313-win32.whl", hash = "sha256:4042d5c8f957e15221d423ba781e85d553722fc4113f523f2feb7b188cc34c5e"},
+    {file = "charset_normalizer-3.4.7-cp313-cp313-win_amd64.whl", hash = "sha256:3946fa46a0cf3e4c8cb1cc52f56bb536310d34f25f01ca9b6c16afa767dab110"},
+    {file = "charset_normalizer-3.4.7-cp313-cp313-win_arm64.whl", hash = "sha256:80d04837f55fc81da168b98de4f4b797ef007fc8a79ab71c6ec9bc4dd662b15b"},
+    {file = "charset_normalizer-3.4.7-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:c36c333c39be2dbca264d7803333c896ab8fa7d4d6f0ab7edb7dfd7aea6e98c0"},
+    {file = "charset_normalizer-3.4.7-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1c2aed2e5e41f24ea8ef1590b8e848a79b56f3a5564a65ceec43c9d692dc7d8a"},
+    {file = "charset_normalizer-3.4.7-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:54523e136b8948060c0fa0bc7b1b50c32c186f2fceee897a495406bb6e311d2b"},
+    {file = "charset_normalizer-3.4.7-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:715479b9a2802ecac752a3b0efa2b0b60285cf962ee38414211abdfccc233b41"},
+    {file = "charset_normalizer-3.4.7-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:bd6c2a1c7573c64738d716488d2cdd3c00e340e4835707d8fdb8dc1a66ef164e"},
+    {file = "charset_normalizer-3.4.7-cp314-cp314-manylinux_2_31_armv7l.whl", hash = "sha256:c45e9440fb78f8ddabcf714b68f936737a121355bf59f3907f4e17721b9d1aae"},
+    {file = "charset_normalizer-3.4.7-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:3534e7dcbdcf757da6b85a0bbf5b6868786d5982dd959b065e65481644817a18"},
+    {file = "charset_normalizer-3.4.7-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:e8ac484bf18ce6975760921bb6148041faa8fef0547200386ea0b52b5d27bf7b"},
+    {file = "charset_normalizer-3.4.7-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:a5fe03b42827c13cdccd08e6c0247b6a6d4b5e3cdc53fd1749f5896adcdc2356"},
+    {file = "charset_normalizer-3.4.7-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:2d6eb928e13016cea4f1f21d1e10c1cebd5a421bc57ddf5b1142ae3f86824fab"},
+    {file = "charset_normalizer-3.4.7-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:e74327fb75de8986940def6e8dee4f127cc9752bee7355bb323cc5b2659b6d46"},
+    {file = "charset_normalizer-3.4.7-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:d6038d37043bced98a66e68d3aa2b6a35505dc01328cd65217cefe82f25def44"},
+    {file = "charset_normalizer-3.4.7-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:7579e913a5339fb8fa133f6bbcfd8e6749696206cf05acdbdca71a1b436d8e72"},
+    {file = "charset_normalizer-3.4.7-cp314-cp314-win32.whl", hash = "sha256:5b77459df20e08151cd6f8b9ef8ef1f961ef73d85c21a555c7eed5b79410ec10"},
+    {file = "charset_normalizer-3.4.7-cp314-cp314-win_amd64.whl", hash = "sha256:92a0a01ead5e668468e952e4238cccd7c537364eb7d851ab144ab6627dbbe12f"},
+    {file = "charset_normalizer-3.4.7-cp314-cp314-win_arm64.whl", hash = "sha256:67f6279d125ca0046a7fd386d01b311c6363844deac3e5b069b514ba3e63c246"},
+    {file = "charset_normalizer-3.4.7-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:effc3f449787117233702311a1b7d8f59cba9ced946ba727bdc329ec69028e24"},
+    {file = "charset_normalizer-3.4.7-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:fbccdc05410c9ee21bbf16a35f4c1d16123dcdeb8a1d38f33654fa21d0234f79"},
+    {file = "charset_normalizer-3.4.7-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:733784b6d6def852c814bce5f318d25da2ee65dd4839a0718641c696e09a2960"},
+    {file = "charset_normalizer-3.4.7-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:a89c23ef8d2c6b27fd200a42aa4ac72786e7c60d40efdc76e6011260b6e949c4"},
+    {file = "charset_normalizer-3.4.7-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:6c114670c45346afedc0d947faf3c7f701051d2518b943679c8ff88befe14f8e"},
+    {file = "charset_normalizer-3.4.7-cp314-cp314t-manylinux_2_31_armv7l.whl", hash = "sha256:a180c5e59792af262bf263b21a3c49353f25945d8d9f70628e73de370d55e1e1"},
+    {file = "charset_normalizer-3.4.7-cp314-cp314t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:3c9a494bc5ec77d43cea229c4f6db1e4d8fe7e1bbffa8b6f0f0032430ff8ab44"},
+    {file = "charset_normalizer-3.4.7-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:8d828b6667a32a728a1ad1d93957cdf37489c57b97ae6c4de2860fa749b8fc1e"},
+    {file = "charset_normalizer-3.4.7-cp314-cp314t-musllinux_1_2_armv7l.whl", hash = "sha256:cf1493cd8607bec4d8a7b9b004e699fcf8f9103a9284cc94962cb73d20f9d4a3"},
+    {file = "charset_normalizer-3.4.7-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:0c96c3b819b5c3e9e165495db84d41914d6894d55181d2d108cc1a69bfc9cce0"},
+    {file = "charset_normalizer-3.4.7-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:752a45dc4a6934060b3b0dab47e04edc3326575f82be64bc4fc293914566503e"},
+    {file = "charset_normalizer-3.4.7-cp314-cp314t-musllinux_1_2_s390x.whl", hash = "sha256:8778f0c7a52e56f75d12dae53ae320fae900a8b9b4164b981b9c5ce059cd1fcb"},
+    {file = "charset_normalizer-3.4.7-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:ce3412fbe1e31eb81ea42f4169ed94861c56e643189e1e75f0041f3fe7020abe"},
+    {file = "charset_normalizer-3.4.7-cp314-cp314t-win32.whl", hash = "sha256:c03a41a8784091e67a39648f70c5f97b5b6a37f216896d44d2cdcb82615339a0"},
+    {file = "charset_normalizer-3.4.7-cp314-cp314t-win_amd64.whl", hash = "sha256:03853ed82eeebbce3c2abfdbc98c96dc205f32a79627688ac9a27370ea61a49c"},
+    {file = "charset_normalizer-3.4.7-cp314-cp314t-win_arm64.whl", hash = "sha256:c35abb8bfff0185efac5878da64c45dafd2b37fb0383add1be155a763c1f083d"},
+    {file = "charset_normalizer-3.4.7-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:e5f4d355f0a2b1a31bc3edec6795b46324349c9cb25eed068049e4f472fb4259"},
+    {file = "charset_normalizer-3.4.7-cp38-cp38-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:16d971e29578a5e97d7117866d15889a4a07befe0e87e703ed63cd90cb348c01"},
+    {file = "charset_normalizer-3.4.7-cp38-cp38-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:dca4bbc466a95ba9c0234ef56d7dd9509f63da22274589ebd4ed7f1f4d4c54e3"},
+    {file = "charset_normalizer-3.4.7-cp38-cp38-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:e80c8378d8f3d83cd3164da1ad2df9e37a666cdde7b1cb2298ed0b558064be30"},
+    {file = "charset_normalizer-3.4.7-cp38-cp38-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:36836d6ff945a00b88ba1e4572d721e60b5b8c98c155d465f56ad19d68f23734"},
+    {file = "charset_normalizer-3.4.7-cp38-cp38-manylinux_2_31_armv7l.whl", hash = "sha256:bd9b23791fe793e4968dba0c447e12f78e425c59fc0e3b97f6450f4781f3ee60"},
+    {file = "charset_normalizer-3.4.7-cp38-cp38-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:aef65cd602a6d0e0ff6f9930fcb1c8fec60dd2cfcb6facaf4bdb0e5873042db0"},
+    {file = "charset_normalizer-3.4.7-cp38-cp38-musllinux_1_2_aarch64.whl", hash = "sha256:82b271f5137d07749f7bf32f70b17ab6eaabedd297e75dce75081a24f76eb545"},
+    {file = "charset_normalizer-3.4.7-cp38-cp38-musllinux_1_2_armv7l.whl", hash = "sha256:1efde3cae86c8c273f1eb3b287be7d8499420cf2fe7585c41d370d3e790054a5"},
+    {file = "charset_normalizer-3.4.7-cp38-cp38-musllinux_1_2_ppc64le.whl", hash = "sha256:c593052c465475e64bbfe5dbd81680f64a67fdc752c56d7a0ae205dc8aeefe0f"},
+    {file = "charset_normalizer-3.4.7-cp38-cp38-musllinux_1_2_riscv64.whl", hash = "sha256:af21eb4409a119e365397b2adbaca4c9ccab56543a65d5dbd9f920d6ac29f686"},
+    {file = "charset_normalizer-3.4.7-cp38-cp38-musllinux_1_2_s390x.whl", hash = "sha256:84c018e49c3bf790f9c2771c45e9313a08c2c2a6342b162cd650258b57817706"},
+    {file = "charset_normalizer-3.4.7-cp38-cp38-musllinux_1_2_x86_64.whl", hash = "sha256:dd915403e231e6b1809fe9b6d9fc55cf8fb5e02765ac625d9cd623342a7905d7"},
+    {file = "charset_normalizer-3.4.7-cp38-cp38-win32.whl", hash = "sha256:320ade88cfb846b8cd6b4ddf5ee9e80ee0c1f52401f2456b84ae1ae6a1a5f207"},
+    {file = "charset_normalizer-3.4.7-cp38-cp38-win_amd64.whl", hash = "sha256:1dc8b0ea451d6e69735094606991f32867807881400f808a106ee1d963c46a83"},
+    {file = "charset_normalizer-3.4.7-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:177a0ba5f0211d488e295aaf82707237e331c24788d8d76c96c5a41594723217"},
+    {file = "charset_normalizer-3.4.7-cp39-cp39-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6e0d51f618228538a3e8f46bd246f87a6cd030565e015803691603f55e12afb5"},
+    {file = "charset_normalizer-3.4.7-cp39-cp39-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:14265bfe1f09498b9d8ec91e9ec9fa52775edf90fcbde092b25f4a33d444fea9"},
+    {file = "charset_normalizer-3.4.7-cp39-cp39-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:87fad7d9ba98c86bcb41b2dc8dbb326619be2562af1f8ff50776a39e55721c5a"},
+    {file = "charset_normalizer-3.4.7-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f22dec1690b584cea26fade98b2435c132c1b5f68e39f5a0b7627cd7ae31f1dc"},
+    {file = "charset_normalizer-3.4.7-cp39-cp39-manylinux_2_31_armv7l.whl", hash = "sha256:d61f00a0869d77422d9b2aba989e2d24afa6ffd552af442e0e58de4f35ea6d00"},
+    {file = "charset_normalizer-3.4.7-cp39-cp39-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:6370e8686f662e6a3941ee48ed4742317cafbe5707e36406e9df792cdb535776"},
+    {file = "charset_normalizer-3.4.7-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:a6c5863edfbe888d9eff9c8b8087354e27618d9da76425c119293f11712a6319"},
+    {file = "charset_normalizer-3.4.7-cp39-cp39-musllinux_1_2_armv7l.whl", hash = "sha256:ed065083d0898c9d5b4bbec7b026fd755ff7454e6e8b73a67f8c744b13986e24"},
+    {file = "charset_normalizer-3.4.7-cp39-cp39-musllinux_1_2_ppc64le.whl", hash = "sha256:2cd4a60d0e2fb04537162c62bbbb4182f53541fe0ede35cdf270a1c1e723cc42"},
+    {file = "charset_normalizer-3.4.7-cp39-cp39-musllinux_1_2_riscv64.whl", hash = "sha256:813c0e0132266c08eb87469a642cb30aaff57c5f426255419572aaeceeaa7bf4"},
+    {file = "charset_normalizer-3.4.7-cp39-cp39-musllinux_1_2_s390x.whl", hash = "sha256:07d9e39b01743c3717745f4c530a6349eadbfa043c7577eef86c502c15df2c67"},
+    {file = "charset_normalizer-3.4.7-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:c0f081d69a6e58272819b70288d3221a6ee64b98df852631c80f293514d3b274"},
+    {file = "charset_normalizer-3.4.7-cp39-cp39-win32.whl", hash = "sha256:8751d2787c9131302398b11e6c8068053dcb55d5a8964e114b6e196cf16cb366"},
+    {file = "charset_normalizer-3.4.7-cp39-cp39-win_amd64.whl", hash = "sha256:12a6fff75f6bc66711b73a2f0addfc4c8c15a20e805146a02d147a318962c444"},
+    {file = "charset_normalizer-3.4.7-cp39-cp39-win_arm64.whl", hash = "sha256:bb8cc7534f51d9a017b93e3e85b260924f909601c3df002bcdb58ddb4dc41a5c"},
+    {file = "charset_normalizer-3.4.7-py3-none-any.whl", hash = "sha256:3dce51d0f5e7951f8bb4900c257dad282f49190fdbebecd4ba99bcc41fef404d"},
+    {file = "charset_normalizer-3.4.7.tar.gz", hash = "sha256:ae89db9e5f98a11a4bf50407d4363e7b09b31e55bc117b4f7d80aab97ba009e5"},
 ]
 
 [[package]]
 name = "click"
-version = "8.3.1"
+version = "8.3.2"
 description = "Composable command line interface toolkit"
 optional = false
 python-versions = ">=3.10"
 groups = ["main", "dev", "docs", "server", "test"]
 files = [
-    {file = "click-8.3.1-py3-none-any.whl", hash = "sha256:981153a64e25f12d547d3426c367a4857371575ee7ad18df2a6183ab0545b2a6"},
-    {file = "click-8.3.1.tar.gz", hash = "sha256:12ff4785d337a1bb490bb7e9c2b1ee5da3112e94a8622f26a6c77f5d2fc6842a"},
+    {file = "click-8.3.2-py3-none-any.whl", hash = "sha256:1924d2c27c5653561cd2cae4548d1406039cb79b858b747cfea24924bbc1616d"},
+    {file = "click-8.3.2.tar.gz", hash = "sha256:14162b8b3b3550a7d479eafa77dfd3c38d9dc8951f6f69c78913a8f9a7540fd5"},
 ]
 
 [package.dependencies]
@@ -627,6 +627,18 @@ files = [
 docs = ["ipython", "matplotlib", "numpydoc", "sphinx"]
 tests = ["pytest", "pytest-cov", "pytest-xdist"]
 
+[[package]]
+name = "defusedxml"
+version = "0.7.1"
+description = "XML bomb protection for Python stdlib modules"
+optional = false
+python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*"
+groups = ["main"]
+files = [
+    {file = "defusedxml-0.7.1-py2.py3-none-any.whl", hash = "sha256:a352e7e428770286cc899e2542b6cdaedb2b4953ff269a210103ec58f6198a61"},
+    {file = "defusedxml-0.7.1.tar.gz", hash = "sha256:1bb3032db185915b62d7c6209c5a8792be6a32ab2fedacc84e01b52c51aa3e69"},
+]
+
 [[package]]
 name = "dill"
 version = "0.4.1"
@@ -688,14 +700,14 @@ test = ["pytest (>=6)"]
 
 [[package]]
 name = "fastapi"
-version = "0.135.3"
+version = "0.136.0"
 description = "FastAPI framework, high performance, easy to learn, fast to code, ready for production"
 optional = false
 python-versions = ">=3.10"
 groups = ["server", "test"]
 files = [
-    {file = "fastapi-0.135.3-py3-none-any.whl", hash = "sha256:9b0f590c813acd13d0ab43dd8494138eb58e484bfac405db1f3187cfc5810d98"},
-    {file = "fastapi-0.135.3.tar.gz", hash = "sha256:bd6d7caf1a2bdd8d676843cdcd2287729572a1ef524fc4d65c17ae002a1be654"},
+    {file = "fastapi-0.136.0-py3-none-any.whl", hash = "sha256:8793d44ec7378e2be07f8a013cf7f7aa47d6327d0dfe9804862688ec4541a6b4"},
+    {file = "fastapi-0.136.0.tar.gz", hash = "sha256:cf08e067cc66e106e102d9ba659463abfac245200752f8a5b7b1e813de4ff73e"},
 ]
 
 [package.dependencies]
@@ -707,19 +719,19 @@ typing-inspection = ">=0.4.2"
 
 [package.extras]
 all = ["email-validator (>=2.0.0)", "fastapi-cli[standard] (>=0.0.8)", "httpx (>=0.23.0,<1.0.0)", "itsdangerous (>=1.1.0)", "jinja2 (>=3.1.5)", "pydantic-extra-types (>=2.0.0)", "pydantic-settings (>=2.0.0)", "python-multipart (>=0.0.18)", "pyyaml (>=5.3.1)", "uvicorn[standard] (>=0.12.0)"]
-standard = ["email-validator (>=2.0.0)", "fastapi-cli[standard] (>=0.0.8)", "httpx (>=0.23.0,<1.0.0)", "jinja2 (>=3.1.5)", "pydantic-extra-types (>=2.0.0)", "pydantic-settings (>=2.0.0)", "python-multipart (>=0.0.18)", "uvicorn[standard] (>=0.12.0)"]
+standard = ["email-validator (>=2.0.0)", "fastapi-cli[standard] (>=0.0.8)", "fastar (>=0.9.0)", "httpx (>=0.23.0,<1.0.0)", "jinja2 (>=3.1.5)", "pydantic-extra-types (>=2.0.0)", "pydantic-settings (>=2.0.0)", "python-multipart (>=0.0.18)", "uvicorn[standard] (>=0.12.0)"]
 standard-no-fastapi-cloud-cli = ["email-validator (>=2.0.0)", "fastapi-cli[standard-no-fastapi-cloud-cli] (>=0.0.8)", "httpx (>=0.23.0,<1.0.0)", "jinja2 (>=3.1.5)", "pydantic-extra-types (>=2.0.0)", "pydantic-settings (>=2.0.0)", "python-multipart (>=0.0.18)", "uvicorn[standard] (>=0.12.0)"]
 
 [[package]]
 name = "filelock"
-version = "3.25.2"
+version = "3.29.0"
 description = "A platform independent file lock."
 optional = false
 python-versions = ">=3.10"
 groups = ["test"]
 files = [
-    {file = "filelock-3.25.2-py3-none-any.whl", hash = "sha256:ca8afb0da15f229774c9ad1b455ed96e85a81373065fb10446672f64444ddf70"},
-    {file = "filelock-3.25.2.tar.gz", hash = "sha256:b64ece2b38f4ca29dd3e810287aa8c48182bbecd1ae6e9ae126c9b35f1382694"},
+    {file = "filelock-3.29.0-py3-none-any.whl", hash = "sha256:96f5f6344709aa1572bbf631c640e4ebeeb519e08da902c39a001882f30ac258"},
+    {file = "filelock-3.29.0.tar.gz", hash = "sha256:69974355e960702e789734cb4871f884ea6fe50bd8404051a3530bc07809cf90"},
 ]
 
 [[package]]
@@ -1468,14 +1480,14 @@ files = [
 
 [[package]]
 name = "narwhals"
-version = "2.18.1"
+version = "2.20.0"
 description = "Extremely lightweight compatibility layer between dataframe libraries"
 optional = false
 python-versions = ">=3.9"
 groups = ["main"]
 files = [
-    {file = "narwhals-2.18.1-py3-none-any.whl", hash = "sha256:a0a8bb80205323851338888ba3a12b4f65d352362c8a94be591244faf36504ad"},
-    {file = "narwhals-2.18.1.tar.gz", hash = "sha256:652a1fcc9d432bbf114846688884c215f17eb118aa640b7419295d2f910d2a8b"},
+    {file = "narwhals-2.20.0-py3-none-any.whl", hash = "sha256:16e750ea5507d4ba6e8d03455b5f93a535e0405976561baea235bca5dc9f475d"},
+    {file = "narwhals-2.20.0.tar.gz", hash = "sha256:c10994975fa7dc5a68c2cffcddbd5908fc8ebb2d463c5bab085309c0ee1f551e"},
 ]
 
 [package.extras]
@@ -1624,14 +1636,14 @@ sympy = "*"
 
 [[package]]
 name = "packaging"
-version = "26.0"
+version = "26.1"
 description = "Core utilities for Python packages"
 optional = false
 python-versions = ">=3.8"
 groups = ["main", "dev", "docs", "server", "test"]
 files = [
-    {file = "packaging-26.0-py3-none-any.whl", hash = "sha256:b36f1fef9334a5588b4166f8bcd26a14e521f2b55e6b9de3aaa80d3ff7a37529"},
-    {file = "packaging-26.0.tar.gz", hash = "sha256:00243ae351a257117b6a241061796684b084ed1c516a08c48a3f7e147a9d80b4"},
+    {file = "packaging-26.1-py3-none-any.whl", hash = "sha256:5d9c0669c6285e491e0ced2eee587eaf67b670d94a19e94e3984a481aba6802f"},
+    {file = "packaging-26.1.tar.gz", hash = "sha256:f042152b681c4bfac5cae2742a55e103d27ab2ec0f3d88037136b6bfe7c9c5de"},
 ]
 
 [[package]]
@@ -1863,26 +1875,26 @@ xmp = ["defusedxml"]
 
 [[package]]
 name = "platformdirs"
-version = "4.9.4"
+version = "4.9.6"
 description = "A small Python package for determining appropriate platform-specific dirs, e.g. a `user data dir`."
 optional = false
 python-versions = ">=3.10"
 groups = ["dev", "test"]
 files = [
-    {file = "platformdirs-4.9.4-py3-none-any.whl", hash = "sha256:68a9a4619a666ea6439f2ff250c12a853cd1cbd5158d258bd824a7df6be2f868"},
-    {file = "platformdirs-4.9.4.tar.gz", hash = "sha256:1ec356301b7dc906d83f371c8f487070e99d3ccf9e501686456394622a01a934"},
+    {file = "platformdirs-4.9.6-py3-none-any.whl", hash = "sha256:e61adb1d5e5cb3441b4b7710bea7e4c12250ca49439228cc1021c00dcfac0917"},
+    {file = "platformdirs-4.9.6.tar.gz", hash = "sha256:3bfa75b0ad0db84096ae777218481852c0ebc6c727b3168c1b9e0118e458cf0a"},
 ]
 
 [[package]]
 name = "plotly"
-version = "6.6.0"
+version = "6.7.0"
 description = "An open-source interactive data visualization library for Python"
 optional = false
 python-versions = ">=3.8"
 groups = ["main"]
 files = [
-    {file = "plotly-6.6.0-py3-none-any.whl", hash = "sha256:8d6daf0f87412e0c0bfe72e809d615217ab57cc715899a1e5145135a7800d1d0"},
-    {file = "plotly-6.6.0.tar.gz", hash = "sha256:b897f15f3b02028d69f755f236be890ba950d0a42d7dfc619b44e2d8cea8748c"},
+    {file = "plotly-6.7.0-py3-none-any.whl", hash = "sha256:ac8aca1c25c663a59b5b9140a549264a5badde2e057d79b8c772ae2920e32ff0"},
+    {file = "plotly-6.7.0.tar.gz", hash = "sha256:45eea0ff27e2a23ccd62776f77eb43aa1ca03df4192b76036e380bb479b892c6"},
 ]
 
 [package.dependencies]
@@ -1890,11 +1902,11 @@ narwhals = ">=1.15.1"
 packaging = "*"
 
 [package.extras]
-dev = ["plotly[dev-optional]"]
-dev-build = ["build", "jupyter", "plotly[dev-core]"]
+dev = ["anywidget", "build", "colorcet", "fiona (<=1.9.6) ; python_version <= \"3.8\"", "geopandas", "inflect", "jupyterlab", "kaleido (>=1.1.0)", "numpy (>=1.22)", "orjson", "pandas", "pdfrw", "pillow", "plotly-geo", "polars[timezone]", "pyarrow", "pyshp", "pytest", "pytz", "requests", "ruff (==0.11.12)", "scikit-image", "scipy", "shapely", "statsmodels", "vaex ; python_version <= \"3.9\"", "xarray"]
+dev-build = ["build", "jupyterlab", "pytest", "requests", "ruff (==0.11.12)"]
 dev-core = ["pytest", "requests", "ruff (==0.11.12)"]
-dev-optional = ["anywidget", "colorcet", "fiona (<=1.9.6) ; python_version <= \"3.8\"", "geopandas", "inflect", "numpy", "orjson", "pandas", "pdfrw", "pillow", "plotly-geo", "plotly[dev-build]", "plotly[kaleido]", "polars[timezone]", "pyarrow", "pyshp", "pytz", "scikit-image", "scipy", "shapely", "statsmodels", "vaex ; python_version <= \"3.9\"", "xarray"]
-express = ["numpy"]
+dev-optional = ["anywidget", "build", "colorcet", "fiona (<=1.9.6) ; python_version <= \"3.8\"", "geopandas", "inflect", "jupyterlab", "kaleido (>=1.1.0)", "numpy (>=1.22)", "orjson", "pandas", "pdfrw", "pillow", "plotly-geo", "polars[timezone]", "pyarrow", "pyshp", "pytest", "pytz", "requests", "ruff (==0.11.12)", "scikit-image", "scipy", "shapely", "statsmodels", "vaex ; python_version <= \"3.9\"", "xarray"]
+express = ["numpy (>=1.22)"]
 kaleido = ["kaleido (>=1.1.0)"]
 
 [[package]]
@@ -1958,19 +1970,19 @@ files = [
 
 [[package]]
 name = "pydantic"
-version = "2.12.5"
+version = "2.13.3"
 description = "Data validation using Python type hints"
 optional = false
 python-versions = ">=3.9"
 groups = ["server", "test"]
 files = [
-    {file = "pydantic-2.12.5-py3-none-any.whl", hash = "sha256:e561593fccf61e8a20fc46dfc2dfe075b8be7d0188df33f221ad1f0139180f9d"},
-    {file = "pydantic-2.12.5.tar.gz", hash = "sha256:4d351024c75c0f085a9febbb665ce8c0c6ec5d30e903bdb6394b7ede26aebb49"},
+    {file = "pydantic-2.13.3-py3-none-any.whl", hash = "sha256:6db14ac8dfc9a1e57f87ea2c0de670c251240f43cb0c30a5130e9720dc612927"},
+    {file = "pydantic-2.13.3.tar.gz", hash = "sha256:af09e9d1d09f4e7fe37145c1f577e1d61ceb9a41924bf0094a36506285d0a84d"},
 ]
 
 [package.dependencies]
 annotated-types = ">=0.6.0"
-pydantic-core = "2.41.5"
+pydantic-core = "2.46.3"
 typing-extensions = ">=4.14.1"
 typing-inspection = ">=0.4.2"
 
@@ -1980,133 +1992,132 @@ timezone = ["tzdata ; python_version >= \"3.9\" and platform_system == \"Windows
 
 [[package]]
 name = "pydantic-core"
-version = "2.41.5"
+version = "2.46.3"
 description = "Core functionality for Pydantic validation and serialization"
 optional = false
 python-versions = ">=3.9"
 groups = ["server", "test"]
 files = [
-    {file = "pydantic_core-2.41.5-cp310-cp310-macosx_10_12_x86_64.whl", hash = "sha256:77b63866ca88d804225eaa4af3e664c5faf3568cea95360d21f4725ab6e07146"},
-    {file = "pydantic_core-2.41.5-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:dfa8a0c812ac681395907e71e1274819dec685fec28273a28905df579ef137e2"},
-    {file = "pydantic_core-2.41.5-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:5921a4d3ca3aee735d9fd163808f5e8dd6c6972101e4adbda9a4667908849b97"},
-    {file = "pydantic_core-2.41.5-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:e25c479382d26a2a41b7ebea1043564a937db462816ea07afa8a44c0866d52f9"},
-    {file = "pydantic_core-2.41.5-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:f547144f2966e1e16ae626d8ce72b4cfa0caedc7fa28052001c94fb2fcaa1c52"},
-    {file = "pydantic_core-2.41.5-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:6f52298fbd394f9ed112d56f3d11aabd0d5bd27beb3084cc3d8ad069483b8941"},
-    {file = "pydantic_core-2.41.5-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:100baa204bb412b74fe285fb0f3a385256dad1d1879f0a5cb1499ed2e83d132a"},
-    {file = "pydantic_core-2.41.5-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:05a2c8852530ad2812cb7914dc61a1125dc4e06252ee98e5638a12da6cc6fb6c"},
-    {file = "pydantic_core-2.41.5-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:29452c56df2ed968d18d7e21f4ab0ac55e71dc59524872f6fc57dcf4a3249ed2"},
-    {file = "pydantic_core-2.41.5-cp310-cp310-musllinux_1_1_armv7l.whl", hash = "sha256:d5160812ea7a8a2ffbe233d8da666880cad0cbaf5d4de74ae15c313213d62556"},
-    {file = "pydantic_core-2.41.5-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:df3959765b553b9440adfd3c795617c352154e497a4eaf3752555cfb5da8fc49"},
-    {file = "pydantic_core-2.41.5-cp310-cp310-win32.whl", hash = "sha256:1f8d33a7f4d5a7889e60dc39856d76d09333d8a6ed0f5f1190635cbec70ec4ba"},
-    {file = "pydantic_core-2.41.5-cp310-cp310-win_amd64.whl", hash = "sha256:62de39db01b8d593e45871af2af9e497295db8d73b085f6bfd0b18c83c70a8f9"},
-    {file = "pydantic_core-2.41.5-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:a3a52f6156e73e7ccb0f8cced536adccb7042be67cb45f9562e12b319c119da6"},
-    {file = "pydantic_core-2.41.5-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:7f3bf998340c6d4b0c9a2f02d6a400e51f123b59565d74dc60d252ce888c260b"},
-    {file = "pydantic_core-2.41.5-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:378bec5c66998815d224c9ca994f1e14c0c21cb95d2f52b6021cc0b2a58f2a5a"},
-    {file = "pydantic_core-2.41.5-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:e7b576130c69225432866fe2f4a469a85a54ade141d96fd396dffcf607b558f8"},
-    {file = "pydantic_core-2.41.5-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:6cb58b9c66f7e4179a2d5e0f849c48eff5c1fca560994d6eb6543abf955a149e"},
-    {file = "pydantic_core-2.41.5-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:88942d3a3dff3afc8288c21e565e476fc278902ae4d6d134f1eeda118cc830b1"},
-    {file = "pydantic_core-2.41.5-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f31d95a179f8d64d90f6831d71fa93290893a33148d890ba15de25642c5d075b"},
-    {file = "pydantic_core-2.41.5-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:c1df3d34aced70add6f867a8cf413e299177e0c22660cc767218373d0779487b"},
-    {file = "pydantic_core-2.41.5-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:4009935984bd36bd2c774e13f9a09563ce8de4abaa7226f5108262fa3e637284"},
-    {file = "pydantic_core-2.41.5-cp311-cp311-musllinux_1_1_armv7l.whl", hash = "sha256:34a64bc3441dc1213096a20fe27e8e128bd3ff89921706e83c0b1ac971276594"},
-    {file = "pydantic_core-2.41.5-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:c9e19dd6e28fdcaa5a1de679aec4141f691023916427ef9bae8584f9c2fb3b0e"},
-    {file = "pydantic_core-2.41.5-cp311-cp311-win32.whl", hash = "sha256:2c010c6ded393148374c0f6f0bf89d206bf3217f201faa0635dcd56bd1520f6b"},
-    {file = "pydantic_core-2.41.5-cp311-cp311-win_amd64.whl", hash = "sha256:76ee27c6e9c7f16f47db7a94157112a2f3a00e958bc626e2f4ee8bec5c328fbe"},
-    {file = "pydantic_core-2.41.5-cp311-cp311-win_arm64.whl", hash = "sha256:4bc36bbc0b7584de96561184ad7f012478987882ebf9f9c389b23f432ea3d90f"},
-    {file = "pydantic_core-2.41.5-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:f41a7489d32336dbf2199c8c0a215390a751c5b014c2c1c5366e817202e9cdf7"},
-    {file = "pydantic_core-2.41.5-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:070259a8818988b9a84a449a2a7337c7f430a22acc0859c6b110aa7212a6d9c0"},
-    {file = "pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e96cea19e34778f8d59fe40775a7a574d95816eb150850a85a7a4c8f4b94ac69"},
-    {file = "pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:ed2e99c456e3fadd05c991f8f437ef902e00eedf34320ba2b0842bd1c3ca3a75"},
-    {file = "pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:65840751b72fbfd82c3c640cff9284545342a4f1eb1586ad0636955b261b0b05"},
-    {file = "pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:e536c98a7626a98feb2d3eaf75944ef6f3dbee447e1f841eae16f2f0a72d8ddc"},
-    {file = "pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:eceb81a8d74f9267ef4081e246ffd6d129da5d87e37a77c9bde550cb04870c1c"},
-    {file = "pydantic_core-2.41.5-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:d38548150c39b74aeeb0ce8ee1d8e82696f4a4e16ddc6de7b1d8823f7de4b9b5"},
-    {file = "pydantic_core-2.41.5-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:c23e27686783f60290e36827f9c626e63154b82b116d7fe9adba1fda36da706c"},
-    {file = "pydantic_core-2.41.5-cp312-cp312-musllinux_1_1_armv7l.whl", hash = "sha256:482c982f814460eabe1d3bb0adfdc583387bd4691ef00b90575ca0d2b6fe2294"},
-    {file = "pydantic_core-2.41.5-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:bfea2a5f0b4d8d43adf9d7b8bf019fb46fdd10a2e5cde477fbcb9d1fa08c68e1"},
-    {file = "pydantic_core-2.41.5-cp312-cp312-win32.whl", hash = "sha256:b74557b16e390ec12dca509bce9264c3bbd128f8a2c376eaa68003d7f327276d"},
-    {file = "pydantic_core-2.41.5-cp312-cp312-win_amd64.whl", hash = "sha256:1962293292865bca8e54702b08a4f26da73adc83dd1fcf26fbc875b35d81c815"},
-    {file = "pydantic_core-2.41.5-cp312-cp312-win_arm64.whl", hash = "sha256:1746d4a3d9a794cacae06a5eaaccb4b8643a131d45fbc9af23e353dc0a5ba5c3"},
-    {file = "pydantic_core-2.41.5-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:941103c9be18ac8daf7b7adca8228f8ed6bb7a1849020f643b3a14d15b1924d9"},
-    {file = "pydantic_core-2.41.5-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:112e305c3314f40c93998e567879e887a3160bb8689ef3d2c04b6cc62c33ac34"},
-    {file = "pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0cbaad15cb0c90aa221d43c00e77bb33c93e8d36e0bf74760cd00e732d10a6a0"},
-    {file = "pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:03ca43e12fab6023fc79d28ca6b39b05f794ad08ec2feccc59a339b02f2b3d33"},
-    {file = "pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:dc799088c08fa04e43144b164feb0c13f9a0bc40503f8df3e9fde58a3c0c101e"},
-    {file = "pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:97aeba56665b4c3235a0e52b2c2f5ae9cd071b8a8310ad27bddb3f7fb30e9aa2"},
-    {file = "pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:406bf18d345822d6c21366031003612b9c77b3e29ffdb0f612367352aab7d586"},
-    {file = "pydantic_core-2.41.5-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:b93590ae81f7010dbe380cdeab6f515902ebcbefe0b9327cc4804d74e93ae69d"},
-    {file = "pydantic_core-2.41.5-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:01a3d0ab748ee531f4ea6c3e48ad9dac84ddba4b0d82291f87248f2f9de8d740"},
-    {file = "pydantic_core-2.41.5-cp313-cp313-musllinux_1_1_armv7l.whl", hash = "sha256:6561e94ba9dacc9c61bce40e2d6bdc3bfaa0259d3ff36ace3b1e6901936d2e3e"},
-    {file = "pydantic_core-2.41.5-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:915c3d10f81bec3a74fbd4faebe8391013ba61e5a1a8d48c4455b923bdda7858"},
-    {file = "pydantic_core-2.41.5-cp313-cp313-win32.whl", hash = "sha256:650ae77860b45cfa6e2cdafc42618ceafab3a2d9a3811fcfbd3bbf8ac3c40d36"},
-    {file = "pydantic_core-2.41.5-cp313-cp313-win_amd64.whl", hash = "sha256:79ec52ec461e99e13791ec6508c722742ad745571f234ea6255bed38c6480f11"},
-    {file = "pydantic_core-2.41.5-cp313-cp313-win_arm64.whl", hash = "sha256:3f84d5c1b4ab906093bdc1ff10484838aca54ef08de4afa9de0f5f14d69639cd"},
-    {file = "pydantic_core-2.41.5-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:3f37a19d7ebcdd20b96485056ba9e8b304e27d9904d233d7b1015db320e51f0a"},
-    {file = "pydantic_core-2.41.5-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:1d1d9764366c73f996edd17abb6d9d7649a7eb690006ab6adbda117717099b14"},
-    {file = "pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:25e1c2af0fce638d5f1988b686f3b3ea8cd7de5f244ca147c777769e798a9cd1"},
-    {file = "pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:506d766a8727beef16b7adaeb8ee6217c64fc813646b424d0804d67c16eddb66"},
-    {file = "pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:4819fa52133c9aa3c387b3328f25c1facc356491e6135b459f1de698ff64d869"},
-    {file = "pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:2b761d210c9ea91feda40d25b4efe82a1707da2ef62901466a42492c028553a2"},
-    {file = "pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:22f0fb8c1c583a3b6f24df2470833b40207e907b90c928cc8d3594b76f874375"},
-    {file = "pydantic_core-2.41.5-cp314-cp314-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:2782c870e99878c634505236d81e5443092fba820f0373997ff75f90f68cd553"},
-    {file = "pydantic_core-2.41.5-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:0177272f88ab8312479336e1d777f6b124537d47f2123f89cb37e0accea97f90"},
-    {file = "pydantic_core-2.41.5-cp314-cp314-musllinux_1_1_armv7l.whl", hash = "sha256:63510af5e38f8955b8ee5687740d6ebf7c2a0886d15a6d65c32814613681bc07"},
-    {file = "pydantic_core-2.41.5-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:e56ba91f47764cc14f1daacd723e3e82d1a89d783f0f5afe9c364b8bb491ccdb"},
-    {file = "pydantic_core-2.41.5-cp314-cp314-win32.whl", hash = "sha256:aec5cf2fd867b4ff45b9959f8b20ea3993fc93e63c7363fe6851424c8a7e7c23"},
-    {file = "pydantic_core-2.41.5-cp314-cp314-win_amd64.whl", hash = "sha256:8e7c86f27c585ef37c35e56a96363ab8de4e549a95512445b85c96d3e2f7c1bf"},
-    {file = "pydantic_core-2.41.5-cp314-cp314-win_arm64.whl", hash = "sha256:e672ba74fbc2dc8eea59fb6d4aed6845e6905fc2a8afe93175d94a83ba2a01a0"},
-    {file = "pydantic_core-2.41.5-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:8566def80554c3faa0e65ac30ab0932b9e3a5cd7f8323764303d468e5c37595a"},
-    {file = "pydantic_core-2.41.5-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:b80aa5095cd3109962a298ce14110ae16b8c1aece8b72f9dafe81cf597ad80b3"},
-    {file = "pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3006c3dd9ba34b0c094c544c6006cc79e87d8612999f1a5d43b769b89181f23c"},
-    {file = "pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:72f6c8b11857a856bcfa48c86f5368439f74453563f951e473514579d44aa612"},
-    {file = "pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5cb1b2f9742240e4bb26b652a5aeb840aa4b417c7748b6f8387927bc6e45e40d"},
-    {file = "pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:bd3d54f38609ff308209bd43acea66061494157703364ae40c951f83ba99a1a9"},
-    {file = "pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:2ff4321e56e879ee8d2a879501c8e469414d948f4aba74a2d4593184eb326660"},
-    {file = "pydantic_core-2.41.5-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:d0d2568a8c11bf8225044aa94409e21da0cb09dcdafe9ecd10250b2baad531a9"},
-    {file = "pydantic_core-2.41.5-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:a39455728aabd58ceabb03c90e12f71fd30fa69615760a075b9fec596456ccc3"},
-    {file = "pydantic_core-2.41.5-cp314-cp314t-musllinux_1_1_armv7l.whl", hash = "sha256:239edca560d05757817c13dc17c50766136d21f7cd0fac50295499ae24f90fdf"},
-    {file = "pydantic_core-2.41.5-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:2a5e06546e19f24c6a96a129142a75cee553cc018ffee48a460059b1185f4470"},
-    {file = "pydantic_core-2.41.5-cp314-cp314t-win32.whl", hash = "sha256:b4ececa40ac28afa90871c2cc2b9ffd2ff0bf749380fbdf57d165fd23da353aa"},
-    {file = "pydantic_core-2.41.5-cp314-cp314t-win_amd64.whl", hash = "sha256:80aa89cad80b32a912a65332f64a4450ed00966111b6615ca6816153d3585a8c"},
-    {file = "pydantic_core-2.41.5-cp314-cp314t-win_arm64.whl", hash = "sha256:35b44f37a3199f771c3eaa53051bc8a70cd7b54f333531c59e29fd4db5d15008"},
-    {file = "pydantic_core-2.41.5-cp39-cp39-macosx_10_12_x86_64.whl", hash = "sha256:8bfeaf8735be79f225f3fefab7f941c712aaca36f1128c9d7e2352ee1aa87bdf"},
-    {file = "pydantic_core-2.41.5-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:346285d28e4c8017da95144c7f3acd42740d637ff41946af5ce6e5e420502dd5"},
-    {file = "pydantic_core-2.41.5-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a75dafbf87d6276ddc5b2bf6fae5254e3d0876b626eb24969a574fff9149ee5d"},
-    {file = "pydantic_core-2.41.5-cp39-cp39-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:7b93a4d08587e2b7e7882de461e82b6ed76d9026ce91ca7915e740ecc7855f60"},
-    {file = "pydantic_core-2.41.5-cp39-cp39-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:e8465ab91a4bd96d36dde3263f06caa6a8a6019e4113f24dc753d79a8b3a3f82"},
-    {file = "pydantic_core-2.41.5-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:299e0a22e7ae2b85c1a57f104538b2656e8ab1873511fd718a1c1c6f149b77b5"},
-    {file = "pydantic_core-2.41.5-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:707625ef0983fcfb461acfaf14de2067c5942c6bb0f3b4c99158bed6fedd3cf3"},
-    {file = "pydantic_core-2.41.5-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:f41eb9797986d6ebac5e8edff36d5cef9de40def462311b3eb3eeded1431e425"},
-    {file = "pydantic_core-2.41.5-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:0384e2e1021894b1ff5a786dbf94771e2986ebe2869533874d7e43bc79c6f504"},
-    {file = "pydantic_core-2.41.5-cp39-cp39-musllinux_1_1_armv7l.whl", hash = "sha256:f0cd744688278965817fd0839c4a4116add48d23890d468bc436f78beb28abf5"},
-    {file = "pydantic_core-2.41.5-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:753e230374206729bf0a807954bcc6c150d3743928a73faffee51ac6557a03c3"},
-    {file = "pydantic_core-2.41.5-cp39-cp39-win32.whl", hash = "sha256:873e0d5b4fb9b89ef7c2d2a963ea7d02879d9da0da8d9d4933dee8ee86a8b460"},
-    {file = "pydantic_core-2.41.5-cp39-cp39-win_amd64.whl", hash = "sha256:e4f4a984405e91527a0d62649ee21138f8e3d0ef103be488c1dc11a80d7f184b"},
-    {file = "pydantic_core-2.41.5-graalpy311-graalpy242_311_native-macosx_10_12_x86_64.whl", hash = "sha256:b96d5f26b05d03cc60f11a7761a5ded1741da411e7fe0909e27a5e6a0cb7b034"},
-    {file = "pydantic_core-2.41.5-graalpy311-graalpy242_311_native-macosx_11_0_arm64.whl", hash = "sha256:634e8609e89ceecea15e2d61bc9ac3718caaaa71963717bf3c8f38bfde64242c"},
-    {file = "pydantic_core-2.41.5-graalpy311-graalpy242_311_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:93e8740d7503eb008aa2df04d3b9735f845d43ae845e6dcd2be0b55a2da43cd2"},
-    {file = "pydantic_core-2.41.5-graalpy311-graalpy242_311_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f15489ba13d61f670dcc96772e733aad1a6f9c429cc27574c6cdaed82d0146ad"},
-    {file = "pydantic_core-2.41.5-graalpy312-graalpy250_312_native-macosx_10_12_x86_64.whl", hash = "sha256:7da7087d756b19037bc2c06edc6c170eeef3c3bafcb8f532ff17d64dc427adfd"},
-    {file = "pydantic_core-2.41.5-graalpy312-graalpy250_312_native-macosx_11_0_arm64.whl", hash = "sha256:aabf5777b5c8ca26f7824cb4a120a740c9588ed58df9b2d196ce92fba42ff8dc"},
-    {file = "pydantic_core-2.41.5-graalpy312-graalpy250_312_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c007fe8a43d43b3969e8469004e9845944f1a80e6acd47c150856bb87f230c56"},
-    {file = "pydantic_core-2.41.5-graalpy312-graalpy250_312_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:76d0819de158cd855d1cbb8fcafdf6f5cf1eb8e470abe056d5d161106e38062b"},
-    {file = "pydantic_core-2.41.5-pp310-pypy310_pp73-macosx_10_12_x86_64.whl", hash = "sha256:b5819cd790dbf0c5eb9f82c73c16b39a65dd6dd4d1439dcdea7816ec9adddab8"},
-    {file = "pydantic_core-2.41.5-pp310-pypy310_pp73-macosx_11_0_arm64.whl", hash = "sha256:5a4e67afbc95fa5c34cf27d9089bca7fcab4e51e57278d710320a70b956d1b9a"},
-    {file = "pydantic_core-2.41.5-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ece5c59f0ce7d001e017643d8d24da587ea1f74f6993467d85ae8a5ef9d4f42b"},
-    {file = "pydantic_core-2.41.5-pp310-pypy310_pp73-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:16f80f7abe3351f8ea6858914ddc8c77e02578544a0ebc15b4c2e1a0e813b0b2"},
-    {file = "pydantic_core-2.41.5-pp310-pypy310_pp73-musllinux_1_1_aarch64.whl", hash = "sha256:33cb885e759a705b426baada1fe68cbb0a2e68e34c5d0d0289a364cf01709093"},
-    {file = "pydantic_core-2.41.5-pp310-pypy310_pp73-musllinux_1_1_armv7l.whl", hash = "sha256:c8d8b4eb992936023be7dee581270af5c6e0697a8559895f527f5b7105ecd36a"},
-    {file = "pydantic_core-2.41.5-pp310-pypy310_pp73-musllinux_1_1_x86_64.whl", hash = "sha256:242a206cd0318f95cd21bdacff3fcc3aab23e79bba5cac3db5a841c9ef9c6963"},
-    {file = "pydantic_core-2.41.5-pp310-pypy310_pp73-win_amd64.whl", hash = "sha256:d3a978c4f57a597908b7e697229d996d77a6d3c94901e9edee593adada95ce1a"},
-    {file = "pydantic_core-2.41.5-pp311-pypy311_pp73-macosx_10_12_x86_64.whl", hash = "sha256:b2379fa7ed44ddecb5bfe4e48577d752db9fc10be00a6b7446e9663ba143de26"},
-    {file = "pydantic_core-2.41.5-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:266fb4cbf5e3cbd0b53669a6d1b039c45e3ce651fd5442eff4d07c2cc8d66808"},
-    {file = "pydantic_core-2.41.5-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:58133647260ea01e4d0500089a8c4f07bd7aa6ce109682b1426394988d8aaacc"},
-    {file = "pydantic_core-2.41.5-pp311-pypy311_pp73-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:287dad91cfb551c363dc62899a80e9e14da1f0e2b6ebde82c806612ca2a13ef1"},
-    {file = "pydantic_core-2.41.5-pp311-pypy311_pp73-musllinux_1_1_aarch64.whl", hash = "sha256:03b77d184b9eb40240ae9fd676ca364ce1085f203e1b1256f8ab9984dca80a84"},
-    {file = "pydantic_core-2.41.5-pp311-pypy311_pp73-musllinux_1_1_armv7l.whl", hash = "sha256:a668ce24de96165bb239160b3d854943128f4334822900534f2fe947930e5770"},
-    {file = "pydantic_core-2.41.5-pp311-pypy311_pp73-musllinux_1_1_x86_64.whl", hash = "sha256:f14f8f046c14563f8eb3f45f499cc658ab8d10072961e07225e507adb700e93f"},
-    {file = "pydantic_core-2.41.5-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:56121965f7a4dc965bff783d70b907ddf3d57f6eba29b6d2e5dabfaf07799c51"},
-    {file = "pydantic_core-2.41.5.tar.gz", hash = "sha256:08daa51ea16ad373ffd5e7606252cc32f07bc72b28284b6bc9c6df804816476e"},
+    {file = "pydantic_core-2.46.3-cp310-cp310-macosx_10_12_x86_64.whl", hash = "sha256:1da3786b8018e60349680720158cc19161cc3b4bdd815beb0a321cd5ce1ad5b1"},
+    {file = "pydantic_core-2.46.3-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:cc0988cb29d21bf4a9d5cf2ef970b5c0e38d8d8e107a493278c05dc6c1dda69f"},
+    {file = "pydantic_core-2.46.3-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:27f9067c3bfadd04c55484b89c0d267981b2f3512850f6f66e1e74204a4e4ce3"},
+    {file = "pydantic_core-2.46.3-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:a642ac886ecf6402d9882d10c405dcf4b902abeb2972cd5fb4a48c83cd59279a"},
+    {file = "pydantic_core-2.46.3-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:79f561438481f28681584b89e2effb22855e2179880314bcddbf5968e935e807"},
+    {file = "pydantic_core-2.46.3-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:57a973eae4665352a47cf1a99b4ee864620f2fe663a217d7a8da68a1f3a5bfda"},
+    {file = "pydantic_core-2.46.3-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:83d002b97072a53ea150d63e0a3adfae5670cef5aa8a6e490240e482d3b22e57"},
+    {file = "pydantic_core-2.46.3-cp310-cp310-manylinux_2_31_riscv64.whl", hash = "sha256:b40ddd51e7c44b28cfaef746c9d3c506d658885e0a46f9eeef2ee815cbf8e045"},
+    {file = "pydantic_core-2.46.3-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:ac5ec7fb9b87f04ee839af2d53bcadea57ded7d229719f56c0ed895bff987943"},
+    {file = "pydantic_core-2.46.3-cp310-cp310-musllinux_1_1_aarch64.whl", hash = "sha256:a3b11c812f61b3129c4905781a2601dfdfdea5fe1e6c1cfb696b55d14e9c054f"},
+    {file = "pydantic_core-2.46.3-cp310-cp310-musllinux_1_1_armv7l.whl", hash = "sha256:1108da631e602e5b3c38d6d04fe5bb3bfa54349e6918e3ca6cf570b2e2b2f9d4"},
+    {file = "pydantic_core-2.46.3-cp310-cp310-musllinux_1_1_x86_64.whl", hash = "sha256:de885175515bcfa98ae618c1df7a072f13d179f81376c8007112af20567fd08a"},
+    {file = "pydantic_core-2.46.3-cp310-cp310-win32.whl", hash = "sha256:d11058e3201527d41bc6b545c79187c9e4bf85e15a236a6007f0e991518882b7"},
+    {file = "pydantic_core-2.46.3-cp310-cp310-win_amd64.whl", hash = "sha256:3612edf65c8ea67ac13616c4d23af12faef1ae435a8a93e5934c2a0cbbdd1fd6"},
+    {file = "pydantic_core-2.46.3-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:ab124d49d0459b2373ecf54118a45c28a1e6d4192a533fbc915e70f556feb8e5"},
+    {file = "pydantic_core-2.46.3-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:cca67d52a5c7a16aed2b3999e719c4bcf644074eac304a5d3d62dd70ae7d4b2c"},
+    {file = "pydantic_core-2.46.3-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:5c024e08c0ba23e6fd68c771a521e9d6a792f2ebb0fa734296b36394dc30390e"},
+    {file = "pydantic_core-2.46.3-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:6645ce7eec4928e29a1e3b3d5c946621d105d3e79f0c9cddf07c2a9770949287"},
+    {file = "pydantic_core-2.46.3-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:a712c7118e6c5ea96562f7b488435172abb94a3c53c22c9efc1412264a45cbbe"},
+    {file = "pydantic_core-2.46.3-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:69a868ef3ff206343579021c40faf3b1edc64b1cc508ff243a28b0a514ccb050"},
+    {file = "pydantic_core-2.46.3-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:cc7e8c32db809aa0f6ea1d6869ebc8518a65d5150fdfad8bcae6a49ae32a22e2"},
+    {file = "pydantic_core-2.46.3-cp311-cp311-manylinux_2_31_riscv64.whl", hash = "sha256:3481bd1341dc85779ee506bc8e1196a277ace359d89d28588a9468c3ecbe63fa"},
+    {file = "pydantic_core-2.46.3-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:8690eba565c6d68ffd3a8655525cbdd5246510b44a637ee2c6c03a7ebfe64d3c"},
+    {file = "pydantic_core-2.46.3-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:4de88889d7e88d50d40ee5b39d5dac0bcaef9ba91f7e536ac064e6b2834ecccf"},
+    {file = "pydantic_core-2.46.3-cp311-cp311-musllinux_1_1_armv7l.whl", hash = "sha256:e480080975c1ef7f780b8f99ed72337e7cc5efea2e518a20a692e8e7b278eb8b"},
+    {file = "pydantic_core-2.46.3-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:de3a5c376f8cd94da9a1b8fd3dd1c16c7a7b216ed31dc8ce9fd7a22bf13b836e"},
+    {file = "pydantic_core-2.46.3-cp311-cp311-win32.whl", hash = "sha256:fc331a5314ffddd5385b9ee9d0d2fee0b13c27e0e02dad71b1ae5d6561f51eeb"},
+    {file = "pydantic_core-2.46.3-cp311-cp311-win_amd64.whl", hash = "sha256:b5b9c6cf08a8a5e502698f5e153056d12c34b8fb30317e0c5fd06f45162a6346"},
+    {file = "pydantic_core-2.46.3-cp311-cp311-win_arm64.whl", hash = "sha256:5dfd51cf457482f04ec49491811a2b8fd5b843b64b11eecd2d7a1ee596ea78a6"},
+    {file = "pydantic_core-2.46.3-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:b11b59b3eee90a80a36701ddb4576d9ae31f93f05cb9e277ceaa09e6bf074a67"},
+    {file = "pydantic_core-2.46.3-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:af8653713055ea18a3abc1537fe2ebc42f5b0bbb768d1eb79fd74eb47c0ac089"},
+    {file = "pydantic_core-2.46.3-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:75a519dab6d63c514f3a81053e5266c549679e4aa88f6ec57f2b7b854aceb1b0"},
+    {file = "pydantic_core-2.46.3-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:a6cd87cb1575b1ad05ba98894c5b5c96411ef678fa2f6ed2576607095b8d9789"},
+    {file = "pydantic_core-2.46.3-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:f80a55484b8d843c8ada81ebf70a682f3f00a3d40e378c06cf17ecb44d280d7d"},
+    {file = "pydantic_core-2.46.3-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:3861f1731b90c50a3266316b9044f5c9b405eecb8e299b0a7120596334e4fe9c"},
+    {file = "pydantic_core-2.46.3-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:fb528e295ed31570ac3dcc9bfdd6e0150bc11ce6168ac87a8082055cf1a67395"},
+    {file = "pydantic_core-2.46.3-cp312-cp312-manylinux_2_31_riscv64.whl", hash = "sha256:367508faa4973b992b271ba1494acaab36eb7e8739d1e47be5035fb1ea225396"},
+    {file = "pydantic_core-2.46.3-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:5ad3c826fe523e4becf4fe39baa44286cff85ef137c729a2c5e269afbfd0905d"},
+    {file = "pydantic_core-2.46.3-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:ec638c5d194ef8af27db69f16c954a09797c0dc25015ad6123eb2c73a4d271ca"},
+    {file = "pydantic_core-2.46.3-cp312-cp312-musllinux_1_1_armv7l.whl", hash = "sha256:28ed528c45446062ee66edb1d33df5d88828ae167de76e773a3c7f64bd14e976"},
+    {file = "pydantic_core-2.46.3-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:aed19d0c783886d5bd86d80ae5030006b45e28464218747dcf83dabfdd092c7b"},
+    {file = "pydantic_core-2.46.3-cp312-cp312-win32.whl", hash = "sha256:06d5d8820cbbdb4147578c1fe7ffcd5b83f34508cb9f9ab76e807be7db6ff0a4"},
+    {file = "pydantic_core-2.46.3-cp312-cp312-win_amd64.whl", hash = "sha256:c3212fda0ee959c1dd04c60b601ec31097aaa893573a3a1abd0a47bcac2968c1"},
+    {file = "pydantic_core-2.46.3-cp312-cp312-win_arm64.whl", hash = "sha256:f1f8338dd7a7f31761f1f1a3c47503a9a3b34eea3c8b01fa6ee96408affb5e72"},
+    {file = "pydantic_core-2.46.3-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:12bc98de041458b80c86c56b24df1d23832f3e166cbaff011f25d187f5c62c37"},
+    {file = "pydantic_core-2.46.3-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:85348b8f89d2c3508b65b16c3c33a4da22b8215138d8b996912bb1532868885f"},
+    {file = "pydantic_core-2.46.3-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:1105677a6df914b1fb71a81b96c8cce7726857e1717d86001f29be06a25ee6f8"},
+    {file = "pydantic_core-2.46.3-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:87082cd65669a33adeba5470769e9704c7cf026cc30afb9cc77fd865578ebaad"},
+    {file = "pydantic_core-2.46.3-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:60e5f66e12c4f5212d08522963380eaaeac5ebd795826cfd19b2dfb0c7a52b9c"},
+    {file = "pydantic_core-2.46.3-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:b6cdf19bf84128d5e7c37e8a73a0c5c10d51103a650ac585d42dd6ae233f2b7f"},
+    {file = "pydantic_core-2.46.3-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:031bb17f4885a43773c8c763089499f242aee2ea85cf17154168775dccdecf35"},
+    {file = "pydantic_core-2.46.3-cp313-cp313-manylinux_2_31_riscv64.whl", hash = "sha256:bcf2a8b2982a6673693eae7348ef3d8cf3979c1d63b54fca7c397a635cc68687"},
+    {file = "pydantic_core-2.46.3-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:28e8cf2f52d72ced402a137145923a762cbb5081e48b34312f7a0c8f55928ec3"},
+    {file = "pydantic_core-2.46.3-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:17eaface65d9fc5abb940003020309c1bf7a211f5f608d7870297c367e6f9022"},
+    {file = "pydantic_core-2.46.3-cp313-cp313-musllinux_1_1_armv7l.whl", hash = "sha256:93fd339f23408a07e98950a89644f92c54d8729719a40b30c0a30bb9ebc55d23"},
+    {file = "pydantic_core-2.46.3-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:23cbdb3aaa74dfe0837975dbf69b469753bbde8eacace524519ffdb6b6e89eb7"},
+    {file = "pydantic_core-2.46.3-cp313-cp313-win32.whl", hash = "sha256:610eda2e3838f401105e6326ca304f5da1e15393ae25dacae5c5c63f2c275b13"},
+    {file = "pydantic_core-2.46.3-cp313-cp313-win_amd64.whl", hash = "sha256:68cc7866ed863db34351294187f9b729964c371ba33e31c26f478471c52e1ed0"},
+    {file = "pydantic_core-2.46.3-cp313-cp313-win_arm64.whl", hash = "sha256:f64b5537ac62b231572879cd08ec05600308636a5d63bcbdb15063a466977bec"},
+    {file = "pydantic_core-2.46.3-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:afa3aa644f74e290cdede48a7b0bee37d1c35e71b05105f6b340d484af536d9b"},
+    {file = "pydantic_core-2.46.3-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:ced3310e51aa425f7f77da8bbbb5212616655bedbe82c70944320bc1dbe5e018"},
+    {file = "pydantic_core-2.46.3-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e29908922ce9da1a30b4da490bd1d3d82c01dcfdf864d2a74aacee674d0bfa34"},
+    {file = "pydantic_core-2.46.3-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:0c9ff69140423eea8ed2d5477df3ba037f671f5e897d206d921bc9fdc39613e7"},
+    {file = "pydantic_core-2.46.3-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:b675ab0a0d5b1c8fdb81195dc5bcefea3f3c240871cdd7ff9a2de8aa50772eb2"},
+    {file = "pydantic_core-2.46.3-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:0087084960f209a9a4af50ecd1fb063d9ad3658c07bb81a7a53f452dacbfb2ba"},
+    {file = "pydantic_core-2.46.3-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ed42e6cc8e1b0e2b9b96e2276bad70ae625d10d6d524aed0c93de974ae029f9f"},
+    {file = "pydantic_core-2.46.3-cp314-cp314-manylinux_2_31_riscv64.whl", hash = "sha256:f1771ce258afb3e4201e67d154edbbae712a76a6081079fe247c2f53c6322c22"},
+    {file = "pydantic_core-2.46.3-cp314-cp314-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:a7610b6a5242a6c736d8ad47fd5fff87fcfe8f833b281b1c409c3d6835d9227f"},
+    {file = "pydantic_core-2.46.3-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:ff5e7783bcc5476e1db448bf268f11cb257b1c276d3e89f00b5727be86dd0127"},
+    {file = "pydantic_core-2.46.3-cp314-cp314-musllinux_1_1_armv7l.whl", hash = "sha256:9d2e32edcc143bc01e95300671915d9ca052d4f745aa0a49c48d4803f8a85f2c"},
+    {file = "pydantic_core-2.46.3-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:6e42d83d1c6b87fa56b521479cff237e626a292f3b31b6345c15a99121b454c1"},
+    {file = "pydantic_core-2.46.3-cp314-cp314-win32.whl", hash = "sha256:07bc6d2a28c3adb4f7c6ae46aa4f2d2929af127f587ed44057af50bf1ce0f505"},
+    {file = "pydantic_core-2.46.3-cp314-cp314-win_amd64.whl", hash = "sha256:8940562319bc621da30714617e6a7eaa6b98c84e8c685bcdc02d7ed5e7c7c44e"},
+    {file = "pydantic_core-2.46.3-cp314-cp314-win_arm64.whl", hash = "sha256:5dcbbcf4d22210ced8f837c96db941bdb078f419543472aca5d9a0bb7cddc7df"},
+    {file = "pydantic_core-2.46.3-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:d0fe3dce1e836e418f912c1ad91c73357d03e556a4d286f441bf34fed2dbeecf"},
+    {file = "pydantic_core-2.46.3-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:9ce92e58abc722dac1bf835a6798a60b294e48eb0e625ec9fd994b932ac5feee"},
+    {file = "pydantic_core-2.46.3-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:a03e6467f0f5ab796a486146d1b887b2dc5e5f9b3288898c1b1c3ad974e53e4a"},
+    {file = "pydantic_core-2.46.3-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:2798b6ba041b9d70acfb9071a2ea13c8456dd1e6a5555798e41ba7b0790e329c"},
+    {file = "pydantic_core-2.46.3-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:9be3e221bdc6d69abf294dcf7aff6af19c31a5cdcc8f0aa3b14be29df4bd03b1"},
+    {file = "pydantic_core-2.46.3-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:f13936129ce841f2a5ddf6f126fea3c43cd128807b5a59588c37cf10178c2e64"},
+    {file = "pydantic_core-2.46.3-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:28b5f2ef03416facccb1c6ef744c69793175fd27e44ef15669201601cf423acb"},
+    {file = "pydantic_core-2.46.3-cp314-cp314t-manylinux_2_31_riscv64.whl", hash = "sha256:830d1247d77ad23852314f069e9d7ddafeec5f684baf9d7e7065ed46a049c4e6"},
+    {file = "pydantic_core-2.46.3-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:d0793c90c1a3c74966e7975eaef3ed30ebdff3260a0f815a62a22adc17e4c01c"},
+    {file = "pydantic_core-2.46.3-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:d2d0aead851b66f5245ec0c4fb2612ef457f8bbafefdf65a2bf9d6bac6140f47"},
+    {file = "pydantic_core-2.46.3-cp314-cp314t-musllinux_1_1_armv7l.whl", hash = "sha256:2f40e4246676beb31c5ce77c38a55ca4e465c6b38d11ea1bd935420568e0b1ab"},
+    {file = "pydantic_core-2.46.3-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:cf489cf8986c543939aeee17a09c04d6ffb43bfef8ca16fcbcc5cfdcbed24dba"},
+    {file = "pydantic_core-2.46.3-cp314-cp314t-win32.whl", hash = "sha256:ffe0883b56cfc05798bf994164d2b2ff03efe2d22022a2bb080f3b626176dd56"},
+    {file = "pydantic_core-2.46.3-cp314-cp314t-win_amd64.whl", hash = "sha256:706d9d0ce9cf4593d07270d8e9f53b161f90c57d315aeec4fb4fd7a8b10240d8"},
+    {file = "pydantic_core-2.46.3-cp314-cp314t-win_arm64.whl", hash = "sha256:77706aeb41df6a76568434701e0917da10692da28cb69d5fb6919ce5fdb07374"},
+    {file = "pydantic_core-2.46.3-cp39-cp39-macosx_10_12_x86_64.whl", hash = "sha256:fa3eb7c2995aa443687a825bc30395c8521b7c6ec201966e55debfd1128bcceb"},
+    {file = "pydantic_core-2.46.3-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:3d08782c4045f90724b44c95d35ebec0d67edb8a957a2ac81d5a8e4b8a200495"},
+    {file = "pydantic_core-2.46.3-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:831eb19aa789a97356979e94c981e5667759301fb708d1c0d5adf1bc0098b873"},
+    {file = "pydantic_core-2.46.3-cp39-cp39-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:4335e87c7afa436a0dfa899e138d57a72f8aad542e2cf19c36fb428461caabd0"},
+    {file = "pydantic_core-2.46.3-cp39-cp39-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:99421e7684a60f7f3550a1d159ade5fdff1954baedb6bdd407cba6a307c9f27d"},
+    {file = "pydantic_core-2.46.3-cp39-cp39-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:dd81f6907932ebac3abbe41378dac64b2380db1287e2aa64d8d88f78d170f51a"},
+    {file = "pydantic_core-2.46.3-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9f247596366f4221af52beddd65af1218797771d6989bc891a0b86ccaa019168"},
+    {file = "pydantic_core-2.46.3-cp39-cp39-manylinux_2_31_riscv64.whl", hash = "sha256:6dff8cc884679df229ebc6d8eb2321ea6f8e091bc7d4886d4dc2e0e71452843c"},
+    {file = "pydantic_core-2.46.3-cp39-cp39-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:68ef2f623dda6d5a9067ac014e406c020c780b2a358930a7e5c1b73702900720"},
+    {file = "pydantic_core-2.46.3-cp39-cp39-musllinux_1_1_aarch64.whl", hash = "sha256:d56bdb4af1767cc15b0386b3c581fdfe659bb9ee4a4f776e92c1cd9d074000d6"},
+    {file = "pydantic_core-2.46.3-cp39-cp39-musllinux_1_1_armv7l.whl", hash = "sha256:91249bcb7c165c2fb2a2f852dbc5c91636e2e218e75d96dfdd517e4078e173dd"},
+    {file = "pydantic_core-2.46.3-cp39-cp39-musllinux_1_1_x86_64.whl", hash = "sha256:4b068543bdb707f5d935dab765d99227aa2545ef2820935f2e5dd801795c7dbd"},
+    {file = "pydantic_core-2.46.3-cp39-cp39-win32.whl", hash = "sha256:dcda6583921c05a40533f982321532f2d8db29326c7b95c4026941fa5074bd79"},
+    {file = "pydantic_core-2.46.3-cp39-cp39-win_amd64.whl", hash = "sha256:a35cc284c8dd7edae8a31533713b4d2467dfe7c4f1b5587dd4031f28f90d1d13"},
+    {file = "pydantic_core-2.46.3-graalpy311-graalpy242_311_native-macosx_10_12_x86_64.whl", hash = "sha256:9715525891ed524a0a1eb6d053c74d4d4ad5017677fb00af0b7c2644a31bae46"},
+    {file = "pydantic_core-2.46.3-graalpy311-graalpy242_311_native-macosx_11_0_arm64.whl", hash = "sha256:9d2f400712a99a013aff420ef1eb9be077f8189a36c1e3ef87660b4e1088a874"},
+    {file = "pydantic_core-2.46.3-graalpy311-graalpy242_311_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:bd2aab0e2e9dc2daf36bd2686c982535d5e7b1d930a1344a7bb6e82baab42a76"},
+    {file = "pydantic_core-2.46.3-graalpy311-graalpy242_311_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:4e9d76736da5f362fabfeea6a69b13b7f2be405c6d6966f06b2f6bfff7e64531"},
+    {file = "pydantic_core-2.46.3-graalpy312-graalpy250_312_native-macosx_10_12_x86_64.whl", hash = "sha256:b12dd51f1187c2eb489af8e20f880362db98e954b54ab792fa5d92e8bcc6b803"},
+    {file = "pydantic_core-2.46.3-graalpy312-graalpy250_312_native-macosx_11_0_arm64.whl", hash = "sha256:f00a0961b125f1a47af7bcc17f00782e12f4cd056f83416006b30111d941dfa3"},
+    {file = "pydantic_core-2.46.3-graalpy312-graalpy250_312_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:57697d7c056aca4bbb680200f96563e841a6386ac1129370a0102592f4dddff5"},
+    {file = "pydantic_core-2.46.3-graalpy312-graalpy250_312_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:fd35aa21299def8db7ef4fe5c4ff862941a9a158ca7b63d61e66fe67d30416b4"},
+    {file = "pydantic_core-2.46.3-pp311-pypy311_pp73-macosx_10_12_x86_64.whl", hash = "sha256:13afdd885f3d71280cf286b13b310ee0f7ccfefd1dbbb661514a474b726e2f25"},
+    {file = "pydantic_core-2.46.3-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:f91c0aff3e3ee0928edd1232c57f643a7a003e6edf1860bc3afcdc749cb513f3"},
+    {file = "pydantic_core-2.46.3-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:6529d1d128321a58d30afcc97b49e98836542f68dd41b33c2e972bb9e5290536"},
+    {file = "pydantic_core-2.46.3-pp311-pypy311_pp73-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:975c267cff4f7e7272eacbe50f6cc03ca9a3da4c4fbd66fffd89c94c1e311aa1"},
+    {file = "pydantic_core-2.46.3-pp311-pypy311_pp73-musllinux_1_1_aarch64.whl", hash = "sha256:2b8e4f2bbdf71415c544b4b1138b8060db7b6611bc927e8064c769f64bed651c"},
+    {file = "pydantic_core-2.46.3-pp311-pypy311_pp73-musllinux_1_1_armv7l.whl", hash = "sha256:e61ea8e9fff9606d09178f577ff8ccdd7206ff73d6552bcec18e1033c4254b85"},
+    {file = "pydantic_core-2.46.3-pp311-pypy311_pp73-musllinux_1_1_x86_64.whl", hash = "sha256:b504bda01bafc69b6d3c7a0c7f039dcf60f47fab70e06fe23f57b5c75bdc82b8"},
+    {file = "pydantic_core-2.46.3-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:b00b76f7142fc60c762ce579bd29c8fa44aaa56592dd3c54fab3928d0d4ca6ff"},
+    {file = "pydantic_core-2.46.3.tar.gz", hash = "sha256:41c178f65b8c29807239d47e6050262eb6bf84eb695e41101e62e38df4a5bc2c"},
 ]
 
 [package.dependencies]
@@ -2245,14 +2256,14 @@ six = ">=1.5"
 
 [[package]]
 name = "python-discovery"
-version = "1.2.1"
+version = "1.2.2"
 description = "Python interpreter discovery"
 optional = false
 python-versions = ">=3.8"
 groups = ["test"]
 files = [
-    {file = "python_discovery-1.2.1-py3-none-any.whl", hash = "sha256:b6a957b24c1cd79252484d3566d1b49527581d46e789aaf43181005e56201502"},
-    {file = "python_discovery-1.2.1.tar.gz", hash = "sha256:180c4d114bff1c32462537eac5d6a332b768242b76b69c0259c7d14b1b680c9e"},
+    {file = "python_discovery-1.2.2-py3-none-any.whl", hash = "sha256:e1ae95d9af875e78f15e19aed0c6137ab1bb49c200f21f5061786490c9585c7a"},
+    {file = "python_discovery-1.2.2.tar.gz", hash = "sha256:876e9c57139eb757cb5878cbdd9ae5379e5d96266c99ef731119e04fffe533bb"},
 ]
 
 [package.dependencies]
@@ -2775,17 +2786,18 @@ test = ["Cython", "array-api-strict (>=2.0,<2.1.1)", "asv", "gmpy2", "hypothesis
 
 [[package]]
 name = "sigmf"
-version = "1.7.2"
+version = "1.8.0"
 description = "Easily interact with Signal Metadata Format (SigMF) recordings."
 optional = false
 python-versions = ">=3.7"
 groups = ["main"]
 files = [
-    {file = "sigmf-1.7.2-py3-none-any.whl", hash = "sha256:6599b95e8bd3ac2c568b8ec46c312a77b80868cbda79d729234f396d2194d3d8"},
-    {file = "sigmf-1.7.2.tar.gz", hash = "sha256:5f80f7127539358c7528ccf26e0ac5b3c268ecaeb69a921542e8ff71d0c85346"},
+    {file = "sigmf-1.8.0-py3-none-any.whl", hash = "sha256:f233ab04344fa3e42170926a646f7e53edd7edc65fcda42eb3d7efaf8a2e8263"},
+    {file = "sigmf-1.8.0.tar.gz", hash = "sha256:91e10cb046499639e5f961d66a24c17a33ff76fc98df892eab0953cc9d659a50"},
 ]
 
 [package.dependencies]
+defusedxml = "*"
 jsonschema = "*"
 numpy = "*"
 
@@ -3131,14 +3143,14 @@ files = [
 
 [[package]]
 name = "tox"
-version = "4.52.0"
+version = "4.53.0"
 description = "tox is a generic virtualenv management and test command line tool"
 optional = false
 python-versions = ">=3.10"
 groups = ["test"]
 files = [
-    {file = "tox-4.52.0-py3-none-any.whl", hash = "sha256:624d8ea4a8c6d5e8d168eedf0e318d736fb22e83ca83137d001ac65ffdec46fd"},
-    {file = "tox-4.52.0.tar.gz", hash = "sha256:6054abf5c8b61d58776fbec991f9bf0d34bb883862beb93d2fe55601ef3977c9"},
+    {file = "tox-4.53.0-py3-none-any.whl", hash = "sha256:cc4e716d18c4889aa179d785175c438fa60c35deef20ce689ec288d8fb656096"},
+    {file = "tox-4.53.0.tar.gz", hash = "sha256:62c780e42f87d34ee60f2ea20342156253794fdcbd6885fd797d98ee05009f22"},
 ]
 
 [package.dependencies]
@@ -3149,7 +3161,7 @@ packaging = ">=26"
 platformdirs = ">=4.9.4"
 pluggy = ">=1.6"
 pyproject-api = ">=1.10"
-python-discovery = ">=1.2.1"
+python-discovery = ">=1.2.2"
 tomli = {version = ">=2.4", markers = "python_version < \"3.11\""}
 tomli-w = ">=1.2"
 typing-extensions = {version = ">=4.15", markers = "python_version < \"3.11\""}
@@ -3188,14 +3200,14 @@ typing-extensions = ">=4.12.0"
 
 [[package]]
 name = "tzdata"
-version = "2025.3"
+version = "2026.1"
 description = "Provider of IANA time zone data"
 optional = false
 python-versions = ">=2"
 groups = ["main"]
 files = [
-    {file = "tzdata-2025.3-py2.py3-none-any.whl", hash = "sha256:06a47e5700f3081aab02b2e513160914ff0694bce9947d6b76ebd6bf57cfc5d1"},
-    {file = "tzdata-2025.3.tar.gz", hash = "sha256:de39c2ca5dc7b0344f2eba86f49d614019d29f060fc4ebc8a417896a620b56a7"},
+    {file = "tzdata-2026.1-py2.py3-none-any.whl", hash = "sha256:4b1d2be7ac37ceafd7327b961aa3a54e467efbdb563a23655fbfe0d39cfc42a9"},
+    {file = "tzdata-2026.1.tar.gz", hash = "sha256:67658a1903c75917309e753fdc349ac0efd8c27db7a0cb406a25be4840f87f98"},
 ]
 
 [[package]]
@@ -3218,14 +3230,14 @@ zstd = ["backports-zstd (>=1.0.0) ; python_version < \"3.14\""]
 
 [[package]]
 name = "uvicorn"
-version = "0.42.0"
+version = "0.44.0"
 description = "The lightning-fast ASGI server."
 optional = false
 python-versions = ">=3.10"
 groups = ["docs", "server", "test"]
 files = [
-    {file = "uvicorn-0.42.0-py3-none-any.whl", hash = "sha256:96c30f5c7abe6f74ae8900a70e92b85ad6613b745d4879eb9b16ccad15645359"},
-    {file = "uvicorn-0.42.0.tar.gz", hash = "sha256:9b1f190ce15a2dd22e7758651d9b6d12df09a13d51ba5bf4fc33c383a48e1775"},
+    {file = "uvicorn-0.44.0-py3-none-any.whl", hash = "sha256:ce937c99a2cc70279556967274414c087888e8cec9f9c94644dfca11bd3ced89"},
+    {file = "uvicorn-0.44.0.tar.gz", hash = "sha256:6c942071b68f07e178264b9152f1f16dfac5da85880c4ce06366a96d70d4f31e"},
 ]
 
 [package.dependencies]
@@ -3310,21 +3322,21 @@ test = ["aiohttp (>=3.10.5)", "flake8 (>=6.1,<7.0)", "mypy (>=0.800)", "psutil",
 
 [[package]]
 name = "virtualenv"
-version = "21.2.0"
+version = "21.2.4"
 description = "Virtual Python Environment builder"
 optional = false
 python-versions = ">=3.8"
 groups = ["test"]
 files = [
-    {file = "virtualenv-21.2.0-py3-none-any.whl", hash = "sha256:1bd755b504931164a5a496d217c014d098426cddc79363ad66ac78125f9d908f"},
-    {file = "virtualenv-21.2.0.tar.gz", hash = "sha256:1720dc3a62ef5b443092e3f499228599045d7fea4c79199770499df8becf9098"},
+    {file = "virtualenv-21.2.4-py3-none-any.whl", hash = "sha256:29d21e941795206138d0f22f4e45ff7050e5da6c6472299fb7103318763861ac"},
+    {file = "virtualenv-21.2.4.tar.gz", hash = "sha256:b294ef68192638004d72524ce7ef303e9d0cf5a44c95ce2e54a7500a6381cada"},
 ]
 
 [package.dependencies]
 distlib = ">=0.3.7,<1"
 filelock = {version = ">=3.24.2,<4", markers = "python_version >= \"3.10\""}
 platformdirs = ">=3.9.1,<5"
-python-discovery = ">=1"
+python-discovery = ">=1.2.2"
 typing-extensions = {version = ">=4.13.2", markers = "python_version < \"3.11\""}
 
 [[package]]
diff --git a/src/ria_toolkit_oss/remote_control/remote_transmitter.py b/src/ria_toolkit_oss/remote_control/remote_transmitter.py
index c6ea3ab..d5b24a0 100644
--- a/src/ria_toolkit_oss/remote_control/remote_transmitter.py
+++ b/src/ria_toolkit_oss/remote_control/remote_transmitter.py
@@ -40,15 +40,19 @@ class RemoteTransmitter:
         try:
             if radio_str in ("pluto", "plutosdr"):
                 from ria_toolkit_oss.sdr.pluto import Pluto
+
                 self._sdr = Pluto(identifier)
             elif radio_str in ("usrp",):
                 from ria_toolkit_oss.sdr.usrp import USRP
+
                 self._sdr = USRP(identifier)
             elif radio_str in ("hackrf", "hackrf_one"):
                 from ria_toolkit_oss.sdr.hackrf import HackRF
+
                 self._sdr = HackRF(identifier)
             elif radio_str in ("bladerf", "blade"):
                 from ria_toolkit_oss.sdr.blade import Blade
+
                 self._sdr = Blade(identifier)
             else:
                 raise ValueError(f"Unknown SDR type: {radio_str!r}")
@@ -77,6 +81,7 @@ class RemoteTransmitter:
         if self._sdr is None:
             raise RuntimeError("Call set_radio() and init_tx() before transmit()")
         import time
+
         # Transmit in a loop until duration has elapsed
         end = time.monotonic() + duration_s
         while time.monotonic() < end:
diff --git a/src/ria_toolkit_oss/remote_control/remote_transmitter_controller.py b/src/ria_toolkit_oss/remote_control/remote_transmitter_controller.py
index e7ee746..b073b5d 100644
--- a/src/ria_toolkit_oss/remote_control/remote_transmitter_controller.py
+++ b/src/ria_toolkit_oss/remote_control/remote_transmitter_controller.py
@@ -14,6 +14,9 @@ import logging
 import threading
 import time
 
+import paramiko
+import zmq
+
 logger = logging.getLogger(__name__)
 
 _STARTUP_WAIT_S = 2.0  # seconds to wait for remote ZMQ server to bind
@@ -158,16 +161,21 @@ class RemoteTransmitterController:
         """
         logger.info(
             "init_tx: fc=%.3f MHz, fs=%.3f MHz, gain=%.1f dB, ch=%d",
-            center_frequency / 1e6, sample_rate / 1e6, gain, channel,
+            center_frequency / 1e6,
+            sample_rate / 1e6,
+            gain,
+            channel,
+        )
+        self._send(
+            {
+                "function_name": "init_tx",
+                "center_frequency": center_frequency,
+                "sample_rate": sample_rate,
+                "gain": gain,
+                "channel": channel,
+                "gain_mode": gain_mode,
+            }
         )
-        self._send({
-            "function_name": "init_tx",
-            "center_frequency": center_frequency,
-            "sample_rate": sample_rate,
-            "gain": gain,
-            "channel": channel,
-            "gain_mode": gain_mode,
-        })
 
     def transmit_async(self, duration_s: float) -> None:
         """Start a timed CW transmission in a background thread.
diff --git a/tests/remote_control/test_remote_transmitter.py b/tests/remote_control/test_remote_transmitter.py
index 9c50152..e6a0940 100644
--- a/tests/remote_control/test_remote_transmitter.py
+++ b/tests/remote_control/test_remote_transmitter.py
@@ -12,7 +12,6 @@ import pytest
 
 from ria_toolkit_oss.remote_control.remote_transmitter import RemoteTransmitter
 
-
 # ---------------------------------------------------------------------------
 # Helpers
 # ---------------------------------------------------------------------------
@@ -241,34 +240,40 @@ class TestRunFunction:
 
     def test_init_tx_without_radio_returns_failure(self):
         tx = RemoteTransmitter()
-        resp = tx.run_function({
-            "function_name": "init_tx",
-            "center_frequency": 2.4e9,
-            "sample_rate": 20e6,
-            "gain": 0,
-        })
+        resp = tx.run_function(
+            {
+                "function_name": "init_tx",
+                "center_frequency": 2.4e9,
+                "sample_rate": 20e6,
+                "gain": 0,
+            }
+        )
         assert resp["status"] is False
         assert resp["error_message"]
 
     def test_init_tx_with_radio_success(self):
         tx = self._tx_with_mock_sdr()
-        resp = tx.run_function({
-            "function_name": "init_tx",
-            "center_frequency": 2.4e9,
-            "sample_rate": 20e6,
-            "gain": 30,
-        })
+        resp = tx.run_function(
+            {
+                "function_name": "init_tx",
+                "center_frequency": 2.4e9,
+                "sample_rate": 20e6,
+                "gain": 30,
+            }
+        )
         assert resp["status"] is True
 
     def test_transmit_runs_for_short_duration(self):
         tx = self._tx_with_mock_sdr()
         tx._sdr.init_tx = MagicMock()
-        resp = tx.run_function({
-            "function_name": "init_tx",
-            "center_frequency": 2.4e9,
-            "sample_rate": 20e6,
-            "gain": 0,
-        })
+        resp = tx.run_function(
+            {
+                "function_name": "init_tx",
+                "center_frequency": 2.4e9,
+                "sample_rate": 20e6,
+                "gain": 0,
+            }
+        )
         resp = tx.run_function({"function_name": "transmit", "duration_s": 0.02})
         assert resp["status"] is True
 
diff --git a/tests/remote_control/test_remote_transmitter_controller.py b/tests/remote_control/test_remote_transmitter_controller.py
index f2b6de7..8e132ef 100644
--- a/tests/remote_control/test_remote_transmitter_controller.py
+++ b/tests/remote_control/test_remote_transmitter_controller.py
@@ -7,8 +7,6 @@ sys.modules so they run regardless of whether the packages are installed.
 from __future__ import annotations
 
 import json
-import sys
-import threading
 import time
 from types import ModuleType
 from unittest.mock import MagicMock, patch
@@ -199,15 +197,11 @@ class TestErrorHandling:
 
     def test_missing_paramiko_raises_runtime_error(self):
         """If paramiko is absent, connecting gives a clear RuntimeError."""
-        import importlib
-
         import ria_toolkit_oss.remote_control.remote_transmitter_controller as mod
 
         with patch.dict("sys.modules", {"paramiko": None}):
             with pytest.raises((RuntimeError, ImportError)):
-                mod.RemoteTransmitterController(
-                    host="h", ssh_user="u", ssh_key_path="/k"
-                )
+                mod.RemoteTransmitterController(host="h", ssh_user="u", ssh_key_path="/k")
 
 
 # ---------------------------------------------------------------------------
diff --git a/tests/remote_control/test_sdr_remote_integration.py b/tests/remote_control/test_sdr_remote_integration.py
index 2f13bed..123cbf1 100644
--- a/tests/remote_control/test_sdr_remote_integration.py
+++ b/tests/remote_control/test_sdr_remote_integration.py
@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from unittest.mock import MagicMock, call, patch
+from unittest.mock import MagicMock, patch
 
 import pytest
 
@@ -12,7 +12,6 @@ from ria_toolkit_oss.orchestration.campaign import (
     TransmitterConfig,
 )
 
-
 # ---------------------------------------------------------------------------
 # Helpers
 # ---------------------------------------------------------------------------
@@ -179,9 +178,7 @@ class TestInitRemoteTxControllers:
             }
         ]
         executor = _make_executor(d)
-        with patch(
-            "ria_toolkit_oss.remote_control.RemoteTransmitterController"
-        ) as mock_cls:
+        with patch("ria_toolkit_oss.remote_control.RemoteTransmitterController") as mock_cls:
             executor._init_remote_tx_controllers()
         mock_cls.assert_not_called()
         assert executor._remote_tx_controllers == {}
@@ -264,7 +261,7 @@ class TestStartTransmitterSdrRemote:
         tx = executor.config.transmitters[0]
         step = CaptureStep(duration=5.0, label="nochan")
         executor._start_transmitter(tx, step)
-        _, kwargs = mock_ctrl_kwarg = ctrl.init_tx.call_args
+        _, kwargs = ctrl.init_tx.call_args
         assert kwargs["channel"] == 0
 
     def test_missing_controller_raises(self):
@@ -381,7 +378,11 @@ class TestRunWithSdrRemote:
             ),
             patch.object(executor, "_close_sdr"),
             patch.object(executor, "_close_remote_tx_controllers"),
-            patch.object(executor, "_execute_step", return_value=MagicMock(error=None, qa=MagicMock(flagged=False, snr_db=20.0, duration_s=10.0))),
+            patch.object(
+                executor,
+                "_execute_step",
+                return_value=MagicMock(error=None, qa=MagicMock(flagged=False, snr_db=20.0, duration_s=10.0)),
+            ),
         ):
             executor.run()
 
@@ -401,6 +402,7 @@ class TestTransmitBufferAndTimeout:
 
     def _executor_with_ctrl(self):
         from ria_toolkit_oss.orchestration.executor import CampaignExecutor
+
         cfg = CampaignConfig.from_dict(_FULL_CAMPAIGN_DICT)
         executor = CampaignExecutor(cfg)
         ctrl = MagicMock()

From 0642dcc2dbd8aa15b5d53eed9a162708e8c975e8 Mon Sep 17 00:00:00 2001
From: madrigal <madrigal@qoherent.ai>
Date: Mon, 20 Apr 2026 11:51:57 -0400
Subject: [PATCH 08/13] Added paramiko to dependencies

---
 pyproject.toml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index 7e46d9b..fea1ee5 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -49,7 +49,8 @@ dependencies = [
   "pyzmq (>=27.1.0,<28.0.0)",
   "pyyaml (>=6.0.3,<7.0.0)",
   "click (>=8.1.0,<9.0.0)",
-  "matplotlib (>=3.8.0,<4.0.0)"
+  "matplotlib (>=3.8.0,<4.0.0)",
+  "paramiko (>=4.0.0)"
 ]
 
 # [project.optional-dependencies] Commented out to prevent Tox tests from failing

From 138fdeb68b03bc55e02b4704d8b0e008f2feadbe Mon Sep 17 00:00:00 2001
From: gillian <gillian@qoherent.ai>
Date: Mon, 20 Apr 2026 13:06:54 -0400
Subject: [PATCH 09/13] Added getting started guide

---
 .../_sources/intro/getting_started.rst.txt    | 1082 +++++++++++++++++
 1 file changed, 1082 insertions(+)
 create mode 100644 docs/_build/html/_sources/intro/getting_started.rst.txt

diff --git a/docs/_build/html/_sources/intro/getting_started.rst.txt b/docs/_build/html/_sources/intro/getting_started.rst.txt
new file mode 100644
index 0000000..f51f9fa
--- /dev/null
+++ b/docs/_build/html/_sources/intro/getting_started.rst.txt
@@ -0,0 +1,1082 @@
+###############
+Getting Started
+###############
+
+This is a practical reference for the ``ria`` CLI from ``ria-toolkit-oss``.
+
+**Scope of this guide:**
+
+* Installation and setup
+* End-to-end CLI workflows
+* Full command reference for CLI features
+* Brief scripting section
+
+**Official resources:**
+
+* `Project README <https://riahub.ai/qoherent/ria-toolkit-oss>`_
+* `Documentation <https://ria-toolkit-oss.readthedocs.io/>`_
+* `PyPI package <https://pypi.org/project/ria-toolkit-oss/>`_
+* `RIA Hub Conda package <https://riahub.ai/qoherent/-/packages/conda/ria-toolkit-oss>`_
+
+.. contents:: Contents
+   :local:
+   :depth: 2
+
+
+1) Installation and Setup
+==========================
+
+1.1 Installation with Conda
+----------------------------
+
+RIA Toolkit OSS is available as a Conda package on RIA Hub. This is typically the easiest
+path when using SDR tooling that depends on native/system libraries.
+
+.. code-block:: bash
+
+   conda update --force conda
+   conda config --add channels https://riahub.ai/api/packages/qoherent/conda
+   conda activate base
+   conda install ria-toolkit-oss
+
+Verify:
+
+.. code-block:: bash
+
+   conda list | grep ria-toolkit-oss
+
+
+1.2 Installation with pip
+--------------------------
+
+Use pip unless you specifically need to edit toolkit source.
+
+.. code-block:: bash
+
+   python3 -m venv .venv
+   source .venv/bin/activate
+   pip install --upgrade pip
+   pip install ria-toolkit-oss
+
+Verify CLI entrypoint:
+
+.. code-block:: bash
+
+   ria --help
+
+``pyproject.toml`` defines two script entry points:
+
+* ``ria``
+* ``ria-tools``
+
+Both point to the same CLI module (``ria_toolkit_oss_cli.cli:cli``).
+
+
+1.3 Optional install from source
+----------------------------------
+
+Use this for local development or testing unreleased changes.
+
+.. code-block:: bash
+
+   git clone https://riahub.ai/qoherent/ria-toolkit-oss.git
+   cd ria-toolkit-oss
+   python3 -m venv .venv
+   source .venv/bin/activate
+   pip install -e .
+
+
+1.4 SDR driver prerequisites
+-----------------------------
+
+Toolkit package install does not install all system SDR drivers. Install vendor/runtime
+dependencies for the hardware you use.
+
+Examples (depends on device and OS):
+
+* USRP: UHD drivers
+* Pluto: libiio / IIO utilities
+* BladeRF: libbladeRF
+* HackRF: libhackrf
+* RTL-SDR: librtlsdr
+
+See repo docs under ``docs/source/sdr_guides/*`` and your OS package instructions.
+
+
+2) CLI Structure
+=================
+
+Top-level CLI follows this model:
+
+.. code-block:: bash
+
+   ria [GLOBAL_OPTS] <command> [ARGS] [OPTIONS]
+
+**Global:**
+
+* ``-v, --verbose`` (defined on root click group)
+
+**Top-level commands:**
+
+* ``discover``
+* ``init``
+* ``capture``
+* ``view``
+* ``annotate`` (group)
+* ``convert``
+* ``split``
+* ``combine``
+* ``generate`` (group)
+* ``transform`` (group)
+* ``transmit``
+* ``synth`` (alias of ``generate`` in command bindings)
+
+
+3) Quick End-to-End Workflow
+=============================
+
+3.1 Discover radios
+--------------------
+
+Run this first in any new environment to verify drivers and detect hardware before
+attempting RX/TX commands.
+
+.. code-block:: bash
+
+   ria discover
+   ria discover -v
+   ria discover --json-output
+
+
+3.2 Initialize local metadata defaults
+---------------------------------------
+
+Set reusable metadata once so generated/captured files automatically include consistent
+provenance fields.
+
+.. code-block:: bash
+
+   ria init
+   # or non-interactive
+   ria init --author "Jane Doe" --project "rf-campaign-1" --location "Lab-A"
+   # show config
+   ria init --show
+
+
+3.3 Capture IQ
+---------------
+
+Capture baseband data from a connected SDR into a reusable file format.
+
+.. code-block:: bash
+
+   ria capture -d pluto -f 2.44G -s 2e6 -n 500000 -o capture.sigmf-data
+
+
+3.4 Visualize and inspect
+--------------------------
+
+Render quick diagnostic plots to validate signal presence, quality, and rough structure.
+
+.. code-block:: bash
+
+   ria view capture.sigmf-data --type simple
+   ria view capture.sigmf-data --type full --show --no-save
+
+
+3.5 Auto-annotate and inspect annotations
+------------------------------------------
+
+Create initial labels automatically, then inspect annotation objects before downstream use.
+
+.. code-block:: bash
+
+   ria annotate energy capture.sigmf-data --label signal --threshold 1.2
+   ria annotate list capture.sigmf-data --verbose
+
+
+3.6 Convert and split
+----------------------
+
+Normalize file format and split large captures into manageable chunks for processing or
+training.
+
+.. code-block:: bash
+
+   ria convert capture.sigmf-data capture.npy
+   ria split capture.sigmf-data --split-every 100000 --output-dir chunks
+
+
+3.7 Apply transforms
+---------------------
+
+Augment or impair recordings to produce controlled variants.
+
+.. code-block:: bash
+
+   ria transform augment channel_swap capture.npy
+   ria transform impair add_awgn_to_signal capture.npy --params snr=10
+
+
+3.8 Transmit (TX-capable radios only)
+--------------------------------------
+
+Replay recorded or synthesized IQ through a transmit-capable SDR.
+
+.. code-block:: bash
+
+   ria transmit -d hackrf -f 2.44G -s 2e6 --input capture.sigmf-data
+   # or generated waveform
+   ria transmit -d hackrf --generate lfm --continuous
+
+
+4) Command Reference
+=====================
+
+4.1 ``discover``
+-----------------
+
+**Purpose:**
+
+* Probe available SDR drivers and enumerate attached hardware.
+* Confirm whether runtime libraries/drivers are installed and discoverable before
+  capture/transmit.
+
+**Usage:**
+
+.. code-block:: bash
+
+   ria discover [--verbose] [--json-output]
+
+**Options:**
+
+* ``-v, --verbose``: include per-driver probe details and import/init failures.
+* ``--json-output``: emit JSON (useful for automation and inventory scripts).
+
+**Behavior notes:**
+
+* ``discover`` checks multiple backends (USB and network paths, depending on driver support).
+* A device not appearing here usually means one of: missing system driver, permission issue,
+  USB/network connectivity issue.
+* Use ``--verbose`` first when troubleshooting; it surfaces driver-level failures that are
+  hidden in default output.
+
+
+4.2 ``init``
+-------------
+
+**Purpose:**
+
+* Create/manage user config file (defaults to ``~/.ria/config.yaml``, or
+  ``$XDG_CONFIG_HOME/ria/config.yaml``).
+
+**Usage:**
+
+.. code-block:: bash
+
+   ria init [options]
+
+**Key options:**
+
+*Metadata defaults:*
+``--author``, ``--organization``, ``--project``, ``--location``, ``--testbed``,
+``--license``, ``--hw``, ``--dataset``
+
+*Actions:*
+``--show``, ``--reset``
+
+*Control:*
+``--config-path``, ``--interactive`` / ``--no-interactive``, ``-y`` / ``--yes``
+
+**What each option category does:**
+
+* Metadata defaults (``--author``, ``--project``, etc.): stored once and reused for later
+  recordings so files have consistent provenance.
+* SigMF-focused fields (``--license``, ``--hw``, ``--dataset``): populate metadata commonly
+  expected in shared datasets.
+* ``--show``: read-only inspect of the current resolved config.
+* ``--reset``: remove config and start clean.
+* ``--config-path``: use a non-default config location (useful for isolated environments or
+  CI).
+* ``--interactive`` / ``--no-interactive``: force prompts on or off regardless of terminal
+  auto-detection.
+* ``--yes``: suppress confirmation prompts for scripted runs.
+
+.. note::
+   Current command output includes a note that some config integration is still being
+   finalized. Config values are already consumed by multiple commands (capture, convert,
+   generate metadata, and YAML config loading paths).
+
+
+4.3 ``capture``
+----------------
+
+**Purpose:**
+
+* Record IQ samples from a supported SDR and save to ``sigmf``, ``npy``, ``wav``, or
+  ``blue``.
+
+**Usage:**
+
+.. code-block:: bash
+
+   ria capture [options]
+
+Device selection (``--device``) is optional if only one device is detected. Exactly one of
+``--num-samples`` or ``--duration`` is required.
+
+**Core options:**
+
+*Device/connection:*
+
+* ``-d, --device {pluto,hackrf,bladerf,usrp,rtlsdr,thinkrf}``
+* ``-i, --ident``
+* ``-c, --config <yaml>``
+
+*RF/capture:*
+
+* ``-s, --sample-rate``
+* ``-f, --center-frequency`` (supports values like ``915e6``, ``2.4G``)
+* ``-g, --gain``
+* ``-b, --bandwidth``
+* ``-n, --num-samples``
+* ``-t, --duration``
+
+*Output:*
+
+* ``-o, --output``
+* ``--output-dir``
+* ``--format {npy,sigmf,wav,blue}``
+* ``--save-image``
+
+*Metadata/logging:*
+
+* ``-m, --metadata KEY=VALUE`` (repeatable)
+* ``-v, --verbose``, ``-q, --quiet``
+
+**How options work in practice:**
+
+* ``--device`` + ``--ident``: select both device class and target instance; ``--ident``
+  takes serial/IP style selectors.
+* ``--config``: load a YAML option set, then override specific fields on the CLI as needed.
+* ``--num-samples`` vs ``--duration``: use exact sample count for deterministic datasets,
+  or time-based capture for quick acquisition.
+* ``--format``: ``sigmf`` is best for metadata/annotation workflows.
+* ``--save-image``: writes a quick visual summary alongside capture output.
+* ``--metadata KEY=VALUE``: injects run-specific metadata (campaign ID, antenna, scenario
+  tag, etc.).
+
+**Output behavior:**
+
+* If ``--output`` is omitted, a timestamped filename is generated automatically.
+* If ``--output-dir`` is omitted, captures default to ``recordings/``.
+* Format is inferred from the ``--output`` extension when no explicit ``--format`` is given.
+
+**Examples:**
+
+.. code-block:: bash
+
+   ria capture -d hackrf -s 2e6 -f 2.44G -n 1000000 -o rf.sigmf-data
+   ria capture -d pluto -f 915e6 -t 2 --format npy --output-dir recordings
+   ria capture -c capture_config.yaml
+
+
+4.4 ``view``
+-------------
+
+**Purpose:**
+
+* Generate visualizations from IQ files.
+* Quickly validate signal quality, occupancy, and annotation coverage without writing custom
+  plotting code.
+
+**Usage:**
+
+.. code-block:: bash
+
+   ria view <input> [options]
+
+``<input>`` accepts SigMF, NPY, WAV, and Blue files.
+
+**Mode** (``--type``):
+
+* ``simple``: fast-look plots for sanity checks and quick iteration.
+* ``full``: multi-panel diagnostic figure (IQ, time, frequency, metadata views).
+* ``annotations`` / ``annotation``: render annotation overlays.
+* ``channels``: channelized/segmented visualization.
+* ``annotate``: convenience path used in some annotation workflows.
+
+**Output/display options:**
+
+* ``--output``, ``--format {png,pdf,svg,jpg}``
+* ``--show``: open an interactive window (requires a GUI display environment).
+* ``--no-save``: suppress file output; only meaningful with ``--show``.
+* ``--overwrite``
+
+**Style options:**
+
+* ``--dpi``, ``--figsize WxH``, ``--title``
+* ``--light``: switch to a light theme (useful for reports/slides).
+
+**Loading options:**
+
+* ``--legacy``: force legacy NPY loading path for older datasets.
+* ``--config``
+
+**Mode-specific options:**
+
+*simple:* ``--fast``, ``--compact``, ``--horizontal``, ``--constellation``, ``--labels``,
+``--slice start:end[:step]``
+
+*full:* ``--plot-length``, ``--no-spectrogram``, ``--no-iq``, ``--no-frequency``,
+``--no-constellation``, ``--no-metadata``, ``--no-logo``, ``--spines``
+
+*annotations/channels:* ``--channel``
+
+**Examples:**
+
+.. code-block:: bash
+
+   ria view capture.sigmf-data --type simple
+   ria view capture.npy --type full --title "Test Capture" --format pdf
+   ria view capture.npy --show --no-save
+   ria view old.npy --legacy --type simple
+
+
+4.5 ``annotate`` group
+-----------------------
+
+**Purpose:**
+
+* Manual annotation management and auto-detection/separation.
+* Build or refine label metadata directly in recordings for downstream training, QA, and
+  filtering.
+
+**Command shape:**
+
+.. code-block:: bash
+
+   ria annotate <subcommand> ...
+
+**Subcommands:** ``list``, ``add``, ``remove``, ``clear``, ``energy``, ``cusum``,
+``threshold``, ``separate``
+
+**General behavior:**
+
+* SigMF is the preferred format for durable annotation metadata.
+* For non-SigMF input, many operations write a new output artifact unless overwrite behavior
+  is explicitly requested.
+* ``--type {standalone,parallel,intersection}`` controls annotation relation semantics.
+
+``ria annotate list``
+~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: bash
+
+   ria annotate list <input> [--verbose]
+
+Prints all annotations for a recording in index order. ``--verbose`` includes additional
+detail per record.
+
+``ria annotate add``
+~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: bash
+
+   ria annotate add <input> --start <int> --count <int> --label <text> [options]
+
+Adds one explicit annotation with sample-domain boundaries.
+
+* ``--start``: first sample index of the annotated region.
+* ``--count``: number of samples in the region.
+* ``--freq-lower``, ``--freq-upper``: optional spectral bounds in Hz.
+* ``--comment``, ``--type``, ``-o`` / ``--output``, ``--overwrite``, ``--quiet``
+
+``ria annotate remove``
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: bash
+
+   ria annotate remove <input> <index> [--output ...] [--overwrite] [--quiet]
+
+Removes exactly one annotation by list index. Run ``annotate list`` first to confirm the
+index.
+
+``ria annotate clear``
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: bash
+
+   ria annotate clear <input> [--force] [--overwrite] [--quiet]
+
+Removes all annotations from the recording. ``--force`` bypasses the confirmation prompt.
+
+``ria annotate energy``
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: bash
+
+   ria annotate energy <input> [options]
+
+Detects energetic regions above the estimated noise floor and writes them as annotations.
+
+* ``--label``
+* ``--threshold``: noise-floor multiplier; higher values reduce false positives but can miss
+  weak signals.
+* ``--segments``: number of segments used to estimate baseline noise.
+* ``--window-size``: smoothing size; larger windows stabilize detections at the cost of
+  sharp transition precision.
+* ``--min-distance``: minimum sample spacing between detections, preventing dense duplicate
+  regions.
+* ``--freq-method {nbw,obw,full-detected,full-bandwidth}``: how frequency bounds are assigned
+  to annotations.
+* ``--nfft``, ``--obw-power``
+* ``--type``, ``-o`` / ``--output``, ``--overwrite``, ``--quiet``
+
+``ria annotate cusum``
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: bash
+
+   ria annotate cusum <input> [options]
+
+Uses change-point detection (CUSUM-style logic) to find regime changes and annotate
+contiguous segments.
+
+* ``--label``
+* ``--min-duration`` (ms): prevents tiny over-segmented labels.
+* ``--window-size``
+* ``--tolerance``: merges nearby boundaries when set above default.
+* ``--type``, ``-o`` / ``--output``, ``--overwrite``, ``--quiet``
+
+``ria annotate threshold``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: bash
+
+   ria annotate threshold <input> --threshold <0.0..1.0> [options]
+
+Uses normalized magnitude thresholding to derive annotation spans. Use where a fixed
+amplitude threshold is sufficient.
+
+* ``--label``, ``--window-size``, ``--type``, ``-o`` / ``--output``, ``--overwrite``,
+  ``--quiet``
+
+``ria annotate separate``
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: bash
+
+   ria annotate separate <input> [options]
+
+Decomposes selected annotations into narrower spectral components and emits refined
+annotations.
+
+* ``--indices "0,1,2"``: limit operation to specific annotations; omit to process all.
+* ``--nfft``: larger FFT improves frequency resolution but increases compute time.
+* ``--noise-threshold-db``: stabilizes detection across heterogeneous captures.
+* ``--min-component-bw``: rejects narrow fragments likely to be noise artifacts.
+* ``-o`` / ``--output``, ``--overwrite``, ``--quiet``, ``--verbose``
+
+**Examples:**
+
+.. code-block:: bash
+
+   ria annotate list capture.sigmf-data --verbose
+   ria annotate add capture.sigmf-data --start 10000 --count 5000 --label burst
+   ria annotate energy capture.sigmf-data --label signal --threshold 1.3
+   ria annotate cusum capture.sigmf-data --min-duration 5
+   ria annotate separate capture.sigmf-data --indices 0,1 --verbose
+
+
+4.6 ``convert``
+----------------
+
+**Purpose:**
+
+* Convert between ``sigmf``, ``npy``, ``wav``, and ``blue``.
+* Normalize datasets into the format required by downstream tooling or collaboration targets.
+
+**Usage:**
+
+.. code-block:: bash
+
+   ria convert <input> [output] [options]
+
+If ``output`` is omitted, ``--format`` must be provided. If both are given, format is
+inferred from the output file extension.
+
+**Options:**
+
+* ``--format {npy,sigmf,wav,blue}``
+* ``--output-dir``
+* ``--legacy``: use older NPY loader behavior for historical recordings.
+* ``--wav-sample-rate``: target sample rate for WAV export.
+* ``--wav-bits {16,32}``: output PCM depth; higher preserves more dynamic range.
+* ``--blue-format {CI,CF,CD}``: Bluefile complex sample representation.
+* ``--metadata KEY=VALUE`` (repeatable): add or override metadata during conversion;
+  especially useful when exporting to SigMF.
+* ``--overwrite``, ``-v`` / ``--verbose``, ``-q`` / ``--quiet``
+
+**Examples:**
+
+.. code-block:: bash
+
+   ria convert recording.sigmf-data output.npy
+   ria convert recording.npy --format sigmf
+   ria convert highrate.npy audio.wav --wav-sample-rate 48000
+   ria convert old.npy --format sigmf --legacy --overwrite
+
+
+4.7 ``split``
+--------------
+
+**Purpose:**
+
+* Split, trim, or extract recordings.
+* Create manageable dataset shards or extract windows of interest without custom scripts.
+
+**Usage:**
+
+.. code-block:: bash
+
+   ria split <input> [operation] [options]
+
+Choose exactly one operation per invocation:
+
+* ``--split-at <sample>``: binary split at a specific sample index.
+* ``--split-every <N>``: fixed-size chunking for ML pipelines.
+* ``--split-duration <seconds>``: time-based chunking.
+* ``--trim`` (with ``--start`` + ``--length`` or ``--end``): extract one sub-window.
+* ``--extract-annotations``: write each annotated region as a standalone file.
+
+**Trim controls:** ``--start``, ``--length``, ``--end``
+
+**Annotation extraction filters:** ``--annotation-label``, ``--annotation-index``
+
+**Output controls:**
+``--output-dir``, ``--output-prefix``, ``--output-format {npy,sigmf,wav,blue}``,
+``--overwrite``, ``--legacy``, ``-v`` / ``--verbose``, ``-q`` / ``--quiet``
+
+**Examples:**
+
+.. code-block:: bash
+
+   ria split recording.sigmf-data --split-at 500000 --output-dir out
+   ria split recording.sigmf-data --split-every 100000 --output-dir chunks
+   ria split recording.sigmf-data --split-duration 1.0 --output-dir chunks
+   ria split recording.npy --trim --start 1000 --length 5000 --output-dir trimmed
+   ria split annotated.sigmf-data --extract-annotations --annotation-label payload
+
+
+4.8 ``combine``
+----------------
+
+**Purpose:**
+
+* Merge multiple recordings by concatenation or sample-wise addition.
+* Assemble multi-part captures or synthesize mixtures for testing and model training.
+
+**Usage:**
+
+.. code-block:: bash
+
+   ria combine <input1> <input2> [input3 ...] <output> [options]
+
+**Options:**
+
+* ``--mode {concat,add}``
+* ``--align-mode {error,truncate,pad,pad-start,pad-center,pad-end,repeat,repeat-spaced}``
+* ``--pad-start-sample``, ``--repeat-spacing``
+* ``--normalize``: rescale combined output to avoid clipping/saturation after addition.
+* ``--output-format {sigmf,npy,wav,blue}``
+* ``--overwrite``, ``--metadata KEY=VALUE`` (repeatable)
+* ``--legacy``, ``--verbose``, ``--quiet``
+
+**Mode semantics:**
+
+* ``concat``: append inputs sequentially in time.
+* ``add``: sample-wise summation — all inputs must be aligned to the same length.
+
+**Alignment options for** ``--mode add``:
+
+* ``error``: fail if lengths differ.
+* ``truncate``: cut all to shortest length.
+* ``pad``, ``pad-start``, ``pad-center``, ``pad-end``: zero-pad shorter streams.
+* ``repeat``: tile shorter streams to match longest.
+* ``repeat-spaced``: repeated placement with spacing via ``--repeat-spacing``.
+
+**Examples:**
+
+.. code-block:: bash
+
+   ria combine a.npy b.npy c.npy merged.npy
+   ria combine signal.npy noise.npy noisy.npy --mode add
+   ria combine long.npy short.npy out.npy --mode add --align-mode pad-center
+   ria combine signal.npy pattern.npy out.npy --mode add --align-mode repeat-spaced --repeat-spacing 10000
+
+
+4.9 ``generate`` group (and ``synth`` alias)
+---------------------------------------------
+
+**Purpose:**
+
+* Generate synthetic IQ signals and save in ``npy``, ``sigmf``, ``wav``, or ``blue``.
+* Create known-reference waveforms and synthetic datasets for validation, demos, and ML
+  data generation.
+
+``ria synth ...`` is an alias for ``ria generate ...``.
+
+**Shape:**
+
+.. code-block:: bash
+
+   ria generate <subcommand> [subcommand options] [common options]
+
+**Available subcommands:**
+``tone``, ``noise``, ``chirp``, ``square``, ``sawtooth``, ``qam``, ``apsk``, ``pam``,
+``fsk``, ``ook``, ``oqpsk``, ``gmsk``, ``psk``
+
+**Common options shared across all generators:**
+
+* ``-s, --sample-rate`` (required)
+* ``-n, --num-samples`` or ``-t, --duration``
+* ``--frequency-shift``, ``-fc`` / ``--center-frequency``
+* ``--add-noise``, ``--noise-power``, ``--path-gain``
+* ``-o, --output`` (required), ``-F`` / ``--format {npy,sigmf,wav,blue}``
+* ``--multipath-paths``, ``--multipath-max-delay``
+* ``--iq-amp-imbalance``, ``--iq-phase-imbalance``, ``--iq-dc-offset``
+* ``--config <yaml>``
+* ``-w`` / ``--overwrite``, ``-m`` / ``--metadata KEY=VALUE`` (repeatable)
+* ``-v`` / ``--verbose``, ``-q`` / ``--quiet``
+
+``--frequency-shift`` and ``--center-frequency`` let you separate the baseband shape from
+RF metadata context. ``--add-noise`` and ``--noise-power`` apply post-generation noise.
+Multipath and IQ imbalance flags apply impairment-style post-processing during generation.
+
+``tone``
+~~~~~~~~~
+
+Options: ``--frequency``, ``--amplitude``, ``--phase``
+
+Clean sinusoidal calibration/reference source.
+
+``noise``
+~~~~~~~~~~
+
+Options: ``--noise-type {gaussian,uniform}``, ``--power``
+
+Baseline noise floor data or controlled additive-noise synthesis.
+
+``chirp``
+~~~~~~~~~~
+
+Options: ``--bandwidth`` (required), ``--period`` (required), ``--type {up,down,up_down}``
+
+Sweep-based radar/sonar-style signals and bandwidth occupancy tests.
+
+``square``
+~~~~~~~~~~~
+
+Options: ``--frequency``, ``--amplitude``, ``--duty-cycle``, ``--phase``
+
+``sawtooth``
+~~~~~~~~~~~~~
+
+Options: ``--frequency``, ``--amplitude``, ``--phase``
+
+Digital modulation families: ``qam``, ``apsk``, ``pam``, ``psk``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+* ``--symbols``, ``--order``
+* ``--symbol-rate``
+* ``--filter {rrc,rc,gaussian,none}``, ``--filter-span``, ``--filter-beta``
+* ``--message-source {random,file,string}``, ``--message-content``
+
+Use ``--message-source random`` for synthetic datasets, ``file`` for deterministic replay,
+or ``string`` for small human-readable payload testing. Pulse-shaping filter options
+(``--filter``, ``--filter-span``, ``--filter-beta``) control spectral occupancy and ISI.
+
+``fsk``
+~~~~~~~~
+
+Options: ``--symbols``, ``--order``, ``--symbol-rate``, ``--freq-spacing``,
+``--modulation-index``, ``--message-source``, ``--message-content``
+
+``--freq-spacing`` and ``--modulation-index`` drive tone separation and spectral profile.
+
+``ook``, ``oqpsk``, ``gmsk``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Options: ``--symbol-rate`` (required), ``--message-source {random,file,string}``,
+``--message-content``; ``gmsk`` also accepts ``--bt``
+
+``gmsk --bt`` sets the Gaussian filter bandwidth-time product (spectral compactness vs
+symbol transition sharpness).
+
+**Examples:**
+
+.. code-block:: bash
+
+   ria generate tone -s 2e6 -n 500000 --frequency 50e3 -o tone.sigmf-data
+   ria generate noise -s 2e6 -n 500000 --noise-type gaussian --power 0.05 -o noise.npy
+   ria generate chirp -s 5e6 -t 0.5 --bandwidth 2e6 --period 0.01 --type up -o chirp.sigmf-data
+   ria generate qam -s 2e6 -r 100e3 -M 16 -N 5000 --message-source random -o qam16.npy
+   ria synth psk -s 2e6 -r 100e3 -M 8 -N 8000 -o psk8.npy
+
+
+4.10 ``transform`` group
+-------------------------
+
+**Purpose:**
+
+* Apply algorithmic transforms to existing recordings.
+* Run reusable augmentations/impairments for dataset diversity and robustness testing.
+
+**Shape:**
+
+.. code-block:: bash
+
+   ria transform <augment|impair|custom> ...
+
+``augment``
+~~~~~~~~~~~~
+
+.. code-block:: bash
+
+   ria transform augment [augmentation] [input] [output] [options]
+
+Applies transforms from ``iq_augmentations`` (dataset-expansion style modifications).
+
+Options: ``--list``, ``--help-transform``, ``--params KEY=VALUE`` (repeatable), ``--view``,
+``--overwrite``, ``-v`` / ``--verbose``, ``-q`` / ``--quiet``
+
+``impair``
+~~~~~~~~~~~
+
+.. code-block:: bash
+
+   ria transform impair [impairment] [input] [output] [options]
+
+Applies transforms from ``iq_impairments`` (noise, distortion, and channel degradation
+effects). Same options as ``augment``.
+
+``custom``
+~~~~~~~~~~~
+
+.. code-block:: bash
+
+   ria transform custom [transform_name] [input] [output] --transform-dir <dir> [options]
+
+Dynamically loads public functions from Python files in ``--transform-dir`` and exposes them
+as callable transforms.
+
+Options: ``--transform-dir`` (required), ``--list``, ``--help-transform``,
+``--params KEY=VALUE`` (repeatable), ``--view``, ``--overwrite``, ``-v`` / ``--verbose``,
+``-q`` / ``--quiet``
+
+``--params`` values must be ``KEY=VALUE``; types are inferred as int, float, or string.
+Use ``--list`` to enumerate available transform names, and ``--help-transform <name>`` to
+inspect parameter hints. ``--view`` writes a PNG preview alongside transform output.
+
+**Examples:**
+
+.. code-block:: bash
+
+   ria transform augment --list
+   ria transform augment channel_swap in.npy out.npy
+   ria transform augment drop_samples in.npy --params max_section_size=5 --view
+
+   ria transform impair --list
+   ria transform impair add_awgn_to_signal in.npy out.npy --params snr=10
+
+   ria transform custom --transform-dir ./my_transforms --list
+   ria transform custom my_filter in.npy out.npy --transform-dir ./my_transforms --params cutoff=0.2
+
+
+4.11 ``transmit``
+------------------
+
+**Purpose:**
+
+* Transmit IQ via a TX-capable SDR (``pluto``, ``hackrf``, ``bladerf``, ``usrp``).
+* Support playback of captured/generated waveforms for over-the-air or wired-loop test
+  scenarios.
+
+**Usage:**
+
+.. code-block:: bash
+
+   ria transmit [options]
+
+**Input source (choose one):**
+
+* ``--input <file>``: transmit an existing recording.
+* ``--generate {lfm,chirp,sine,pulse}``: synthesize a transmit signal on the fly.
+* If neither is specified, the command defaults to a generated LFM waveform.
+
+**Core options:**
+
+*Device/radio:* ``-d`` / ``--device {pluto,hackrf,bladerf,usrp}``, ``-i`` / ``--ident``,
+``-c`` / ``--config``
+
+*RF:* ``-s`` / ``--sample-rate``, ``-f`` / ``--center-frequency``, ``-g`` / ``--gain``,
+``-b`` / ``--bandwidth``
+
+*Input/gen:* ``--input``, ``--legacy``, ``--generate {lfm,chirp,sine,pulse}``
+
+*TX control:*
+
+* ``-r, --repeat``
+* ``--continuous``: transmit until interrupted (``Ctrl+C``).
+* ``--tx-delay``: pause between repeats when ``--repeat`` is used.
+* ``-y, --yes``: skip confirmation prompts; use carefully in scripted environments.
+
+*Logging:* ``-v`` / ``--verbose``, ``-q`` / ``--quiet``
+
+.. warning::
+   ``--continuous`` transmits until manually interrupted. Validate gain settings, antenna
+   configuration, and regulatory compliance before use.
+
+**Examples:**
+
+.. code-block:: bash
+
+   ria transmit -d pluto -f 915e6 -s 2e6 --input capture.sigmf-data
+   ria transmit -d hackrf --generate lfm -f 2.44G --continuous
+   ria transmit -d usrp --input msg.npy -r 3 --tx-delay 0.5
+
+
+5) YAML Config Patterns
+========================
+
+Several commands accept ``--config <file.yaml>`` for parameter loading. CLI flags generally
+override values loaded from ``--config``.
+
+Keep one stable baseline YAML per workflow (capture, generate, transmit), then override only
+experiment-specific fields on the CLI.
+
+**Capture config example:**
+
+.. code-block:: yaml
+
+   device: pluto
+   ident: 192.168.2.1
+   sample_rate: 2000000
+   center_frequency: 2.44G
+   gain: 20
+   bandwidth: 2000000
+   num_samples: 500000
+   format: sigmf
+   output: run1.sigmf-data
+   metadata:
+     campaign: lab_eval
+     antenna: dipole
+
+.. code-block:: bash
+
+   ria capture -c capture.yaml
+
+**Generate config example:**
+
+.. code-block:: yaml
+
+   sample_rate: 2000000
+   num_samples: 200000
+   format: npy
+   output: synth.npy
+   noise_power: 0.02
+
+.. code-block:: bash
+
+   ria generate noise --config generate.yaml
+
+
+6) Practical Tips and Safety
+=============================
+
+* Use ``ria discover`` before capture/transmit sessions.
+* Keep TX gain conservative first; validate with attenuators/dummy loads when needed.
+* Prefer SigMF for interoperable metadata and annotations.
+* For long workflows, keep outputs organized by campaign directories and consistent prefixes.
+* Use ``--verbose`` when debugging device init or driver issues.
+
+
+7) Version Notes
+=================
+
+These notes are based on the current implementation and should be re-validated against future
+releases.
+
+1. Some command docstrings and examples still mention ``utils`` or ``ria_toolkit_oss``
+   command prefixes in text blocks. The operational command is ``ria ...``.
+2. Command bindings currently import ``viewe`` instead of ``view`` in
+   ``src/ria_toolkit_oss_cli/ria_toolkit_oss/commands.py``.
+3. Multiple non-CLI modules still import ``utils.*``, which can create runtime dependency
+   coupling when using only ``ria-toolkit-oss`` in isolation.
+
+If you observe unexpected import errors after install, check the package version and
+changelog, then test ``ria --help`` in a clean virtual environment.
+
+
+8) Brief Scripting (Python) Preview
+=====================================
+
+For quick non-CLI use:
+
+.. code-block:: python
+
+   from ria_toolkit_oss.datatypes import Recording
+   from ria_toolkit_oss.io import load_recording, to_sigmf
+   from ria_toolkit_oss.transforms import iq_augmentations, iq_impairments
+
+   rec = load_recording("capture.sigmf-data")
+   aug = iq_augmentations.channel_swap(rec)
+   imp = iq_impairments.add_awgn_to_signal(aug, snr=10)
+   to_sigmf(imp, filename="capture_awgn", path=".")
+
+You can also call annotation algorithms and block-generator primitives from Python directly.
+
+
+9) Cheat Sheet
+===============
+
+.. code-block:: bash
+
+   # Install
+   pip install ria-toolkit-oss
+
+   # Discover
+   ria discover -v
+
+   # Init defaults
+   ria init --author "Jane" --project "rf1" --location "Lab-A"
+
+   # Capture
+   ria capture -d pluto -f 2.44G -s 2e6 -n 1000000 -o cap.sigmf-data
+
+   # View
+   ria view cap.sigmf-data --type simple
+
+   # Annotate
+   ria annotate energy cap.sigmf-data --threshold 1.2
+   ria annotate list cap.sigmf-data --verbose
+
+   # Convert
+   ria convert cap.sigmf-data cap.npy
+
+   # Split
+   ria split cap.sigmf-data --split-every 100000 --output-dir chunks
+
+   # Combine
+   ria combine chunks/a.npy chunks/b.npy merged.npy
+
+   # Generate
+   ria generate qam -s 2e6 -r 100e3 -M 16 -N 5000 -o qam16.npy
+
+   # Transform
+   ria transform augment channel_swap cap.npy
+   ria transform impair add_awgn_to_signal cap.npy --params snr=10
+
+   # Transmit
+   ria transmit -d hackrf --input cap.sigmf-data -f 2.44G -s 2e6

From e506d26450f831f5cca1215469b04194874542eb Mon Sep 17 00:00:00 2001
From: gillian <gillian@qoherent.ai>
Date: Mon, 20 Apr 2026 13:10:31 -0400
Subject: [PATCH 10/13] Replaces the getting_started.rst placeholder with a
 full CLI reference covering installation, commands, YAML config patterns, and
 a cheat sheet. Adds custom CSS/JS for heading colours, warning admonition
 styling, code block colours, and ria command highlighting. Fixes .gitignore
 to exclude docs/_build/.

---
 .gitignore                                    |    1 +
 .../_sources/intro/getting_started.rst.txt    |    1 +
 docs/source/_static/custom.css                |   29 +
 docs/source/_static/custom.js                 |    8 +
 docs/source/conf.py                           |    3 +
 docs/source/intro/getting_started.rst         | 1090 ++++++++++++++++-
 6 files changed, 1125 insertions(+), 7 deletions(-)
 create mode 100644 docs/source/_static/custom.css
 create mode 100644 docs/source/_static/custom.js

diff --git a/.gitignore b/.gitignore
index b66b92e..b2ac7f1 100644
--- a/.gitignore
+++ b/.gitignore
@@ -52,6 +52,7 @@ tests/sdr/
 
 # Sphinx documentation
 docs/build/
+docs/_build/
 
 # Jupyter Notebook
 .ipynb_checkpoints
diff --git a/docs/_build/html/_sources/intro/getting_started.rst.txt b/docs/_build/html/_sources/intro/getting_started.rst.txt
index f51f9fa..c2386ee 100644
--- a/docs/_build/html/_sources/intro/getting_started.rst.txt
+++ b/docs/_build/html/_sources/intro/getting_started.rst.txt
@@ -21,6 +21,7 @@ This is a practical reference for the ``ria`` CLI from ``ria-toolkit-oss``.
 .. contents:: Contents
    :local:
    :depth: 2
+   :backlinks: none
 
 
 1) Installation and Setup
diff --git a/docs/source/_static/custom.css b/docs/source/_static/custom.css
new file mode 100644
index 0000000..40b2823
--- /dev/null
+++ b/docs/source/_static/custom.css
@@ -0,0 +1,29 @@
+/* Change the hex values below to customize heading colours */
+
+.rst-content h1 { color: #2c3e50; }
+.rst-content h2,
+.rst-content h2 a { color: #ffffff !important; font-size: 22px !important; }
+
+.rst-content h3,
+.rst-content h3 a { color: #ffffff !important; font-size: 16px !important; }
+
+.rst-content h3 code { font-size: inherit !important; }
+
+.rst-content .admonition.warning {
+    background: #1a1a2e !important;
+    border-left: 4px solid #c0392b !important;
+}
+
+.rst-content .admonition.warning .admonition-title {
+    background: #c0392b !important;
+    color: #ffffff !important;
+}
+
+.rst-content .admonition.warning p {
+    color: #ffffff !important;
+}
+.rst-content h4 { color: #404040; }
+
+.highlight * { color: #ffffff !important; }
+
+.ria-cmd { color: #2980b9 !important; }
diff --git a/docs/source/_static/custom.js b/docs/source/_static/custom.js
new file mode 100644
index 0000000..f9caf03
--- /dev/null
+++ b/docs/source/_static/custom.js
@@ -0,0 +1,8 @@
+document.addEventListener('DOMContentLoaded', function () {
+    document.querySelectorAll('.highlight pre').forEach(function (pre) {
+        pre.innerHTML = pre.innerHTML.replace(
+            /((?:^|\n|>))(ria)(?=[ \t]|<)/g,
+            '$1<span class="ria-cmd">$2</span>'
+        );
+    });
+});
diff --git a/docs/source/conf.py b/docs/source/conf.py
index 0260f78..1a3b6d0 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -73,3 +73,6 @@ def setup(app):
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
 
 html_theme = 'sphinx_rtd_theme'
+html_static_path = ['_static']
+html_css_files = ['custom.css']
+html_js_files = ['custom.js']
diff --git a/docs/source/intro/getting_started.rst b/docs/source/intro/getting_started.rst
index 928e753..c2386ee 100644
--- a/docs/source/intro/getting_started.rst
+++ b/docs/source/intro/getting_started.rst
@@ -1,7 +1,1083 @@
-Getting Started
-===============
-
-.. todo::
-
-   Getting started instructions are coming soon! In the meantime, feel free
-   to explore the project documentation. Many components include usage examples.
+###############
+Getting Started
+###############
+
+This is a practical reference for the ``ria`` CLI from ``ria-toolkit-oss``.
+
+**Scope of this guide:**
+
+* Installation and setup
+* End-to-end CLI workflows
+* Full command reference for CLI features
+* Brief scripting section
+
+**Official resources:**
+
+* `Project README <https://riahub.ai/qoherent/ria-toolkit-oss>`_
+* `Documentation <https://ria-toolkit-oss.readthedocs.io/>`_
+* `PyPI package <https://pypi.org/project/ria-toolkit-oss/>`_
+* `RIA Hub Conda package <https://riahub.ai/qoherent/-/packages/conda/ria-toolkit-oss>`_
+
+.. contents:: Contents
+   :local:
+   :depth: 2
+   :backlinks: none
+
+
+1) Installation and Setup
+==========================
+
+1.1 Installation with Conda
+----------------------------
+
+RIA Toolkit OSS is available as a Conda package on RIA Hub. This is typically the easiest
+path when using SDR tooling that depends on native/system libraries.
+
+.. code-block:: bash
+
+   conda update --force conda
+   conda config --add channels https://riahub.ai/api/packages/qoherent/conda
+   conda activate base
+   conda install ria-toolkit-oss
+
+Verify:
+
+.. code-block:: bash
+
+   conda list | grep ria-toolkit-oss
+
+
+1.2 Installation with pip
+--------------------------
+
+Use pip unless you specifically need to edit toolkit source.
+
+.. code-block:: bash
+
+   python3 -m venv .venv
+   source .venv/bin/activate
+   pip install --upgrade pip
+   pip install ria-toolkit-oss
+
+Verify CLI entrypoint:
+
+.. code-block:: bash
+
+   ria --help
+
+``pyproject.toml`` defines two script entry points:
+
+* ``ria``
+* ``ria-tools``
+
+Both point to the same CLI module (``ria_toolkit_oss_cli.cli:cli``).
+
+
+1.3 Optional install from source
+----------------------------------
+
+Use this for local development or testing unreleased changes.
+
+.. code-block:: bash
+
+   git clone https://riahub.ai/qoherent/ria-toolkit-oss.git
+   cd ria-toolkit-oss
+   python3 -m venv .venv
+   source .venv/bin/activate
+   pip install -e .
+
+
+1.4 SDR driver prerequisites
+-----------------------------
+
+Toolkit package install does not install all system SDR drivers. Install vendor/runtime
+dependencies for the hardware you use.
+
+Examples (depends on device and OS):
+
+* USRP: UHD drivers
+* Pluto: libiio / IIO utilities
+* BladeRF: libbladeRF
+* HackRF: libhackrf
+* RTL-SDR: librtlsdr
+
+See repo docs under ``docs/source/sdr_guides/*`` and your OS package instructions.
+
+
+2) CLI Structure
+=================
+
+Top-level CLI follows this model:
+
+.. code-block:: bash
+
+   ria [GLOBAL_OPTS] <command> [ARGS] [OPTIONS]
+
+**Global:**
+
+* ``-v, --verbose`` (defined on root click group)
+
+**Top-level commands:**
+
+* ``discover``
+* ``init``
+* ``capture``
+* ``view``
+* ``annotate`` (group)
+* ``convert``
+* ``split``
+* ``combine``
+* ``generate`` (group)
+* ``transform`` (group)
+* ``transmit``
+* ``synth`` (alias of ``generate`` in command bindings)
+
+
+3) Quick End-to-End Workflow
+=============================
+
+3.1 Discover radios
+--------------------
+
+Run this first in any new environment to verify drivers and detect hardware before
+attempting RX/TX commands.
+
+.. code-block:: bash
+
+   ria discover
+   ria discover -v
+   ria discover --json-output
+
+
+3.2 Initialize local metadata defaults
+---------------------------------------
+
+Set reusable metadata once so generated/captured files automatically include consistent
+provenance fields.
+
+.. code-block:: bash
+
+   ria init
+   # or non-interactive
+   ria init --author "Jane Doe" --project "rf-campaign-1" --location "Lab-A"
+   # show config
+   ria init --show
+
+
+3.3 Capture IQ
+---------------
+
+Capture baseband data from a connected SDR into a reusable file format.
+
+.. code-block:: bash
+
+   ria capture -d pluto -f 2.44G -s 2e6 -n 500000 -o capture.sigmf-data
+
+
+3.4 Visualize and inspect
+--------------------------
+
+Render quick diagnostic plots to validate signal presence, quality, and rough structure.
+
+.. code-block:: bash
+
+   ria view capture.sigmf-data --type simple
+   ria view capture.sigmf-data --type full --show --no-save
+
+
+3.5 Auto-annotate and inspect annotations
+------------------------------------------
+
+Create initial labels automatically, then inspect annotation objects before downstream use.
+
+.. code-block:: bash
+
+   ria annotate energy capture.sigmf-data --label signal --threshold 1.2
+   ria annotate list capture.sigmf-data --verbose
+
+
+3.6 Convert and split
+----------------------
+
+Normalize file format and split large captures into manageable chunks for processing or
+training.
+
+.. code-block:: bash
+
+   ria convert capture.sigmf-data capture.npy
+   ria split capture.sigmf-data --split-every 100000 --output-dir chunks
+
+
+3.7 Apply transforms
+---------------------
+
+Augment or impair recordings to produce controlled variants.
+
+.. code-block:: bash
+
+   ria transform augment channel_swap capture.npy
+   ria transform impair add_awgn_to_signal capture.npy --params snr=10
+
+
+3.8 Transmit (TX-capable radios only)
+--------------------------------------
+
+Replay recorded or synthesized IQ through a transmit-capable SDR.
+
+.. code-block:: bash
+
+   ria transmit -d hackrf -f 2.44G -s 2e6 --input capture.sigmf-data
+   # or generated waveform
+   ria transmit -d hackrf --generate lfm --continuous
+
+
+4) Command Reference
+=====================
+
+4.1 ``discover``
+-----------------
+
+**Purpose:**
+
+* Probe available SDR drivers and enumerate attached hardware.
+* Confirm whether runtime libraries/drivers are installed and discoverable before
+  capture/transmit.
+
+**Usage:**
+
+.. code-block:: bash
+
+   ria discover [--verbose] [--json-output]
+
+**Options:**
+
+* ``-v, --verbose``: include per-driver probe details and import/init failures.
+* ``--json-output``: emit JSON (useful for automation and inventory scripts).
+
+**Behavior notes:**
+
+* ``discover`` checks multiple backends (USB and network paths, depending on driver support).
+* A device not appearing here usually means one of: missing system driver, permission issue,
+  USB/network connectivity issue.
+* Use ``--verbose`` first when troubleshooting; it surfaces driver-level failures that are
+  hidden in default output.
+
+
+4.2 ``init``
+-------------
+
+**Purpose:**
+
+* Create/manage user config file (defaults to ``~/.ria/config.yaml``, or
+  ``$XDG_CONFIG_HOME/ria/config.yaml``).
+
+**Usage:**
+
+.. code-block:: bash
+
+   ria init [options]
+
+**Key options:**
+
+*Metadata defaults:*
+``--author``, ``--organization``, ``--project``, ``--location``, ``--testbed``,
+``--license``, ``--hw``, ``--dataset``
+
+*Actions:*
+``--show``, ``--reset``
+
+*Control:*
+``--config-path``, ``--interactive`` / ``--no-interactive``, ``-y`` / ``--yes``
+
+**What each option category does:**
+
+* Metadata defaults (``--author``, ``--project``, etc.): stored once and reused for later
+  recordings so files have consistent provenance.
+* SigMF-focused fields (``--license``, ``--hw``, ``--dataset``): populate metadata commonly
+  expected in shared datasets.
+* ``--show``: read-only inspect of the current resolved config.
+* ``--reset``: remove config and start clean.
+* ``--config-path``: use a non-default config location (useful for isolated environments or
+  CI).
+* ``--interactive`` / ``--no-interactive``: force prompts on or off regardless of terminal
+  auto-detection.
+* ``--yes``: suppress confirmation prompts for scripted runs.
+
+.. note::
+   Current command output includes a note that some config integration is still being
+   finalized. Config values are already consumed by multiple commands (capture, convert,
+   generate metadata, and YAML config loading paths).
+
+
+4.3 ``capture``
+----------------
+
+**Purpose:**
+
+* Record IQ samples from a supported SDR and save to ``sigmf``, ``npy``, ``wav``, or
+  ``blue``.
+
+**Usage:**
+
+.. code-block:: bash
+
+   ria capture [options]
+
+Device selection (``--device``) is optional if only one device is detected. Exactly one of
+``--num-samples`` or ``--duration`` is required.
+
+**Core options:**
+
+*Device/connection:*
+
+* ``-d, --device {pluto,hackrf,bladerf,usrp,rtlsdr,thinkrf}``
+* ``-i, --ident``
+* ``-c, --config <yaml>``
+
+*RF/capture:*
+
+* ``-s, --sample-rate``
+* ``-f, --center-frequency`` (supports values like ``915e6``, ``2.4G``)
+* ``-g, --gain``
+* ``-b, --bandwidth``
+* ``-n, --num-samples``
+* ``-t, --duration``
+
+*Output:*
+
+* ``-o, --output``
+* ``--output-dir``
+* ``--format {npy,sigmf,wav,blue}``
+* ``--save-image``
+
+*Metadata/logging:*
+
+* ``-m, --metadata KEY=VALUE`` (repeatable)
+* ``-v, --verbose``, ``-q, --quiet``
+
+**How options work in practice:**
+
+* ``--device`` + ``--ident``: select both device class and target instance; ``--ident``
+  takes serial/IP style selectors.
+* ``--config``: load a YAML option set, then override specific fields on the CLI as needed.
+* ``--num-samples`` vs ``--duration``: use exact sample count for deterministic datasets,
+  or time-based capture for quick acquisition.
+* ``--format``: ``sigmf`` is best for metadata/annotation workflows.
+* ``--save-image``: writes a quick visual summary alongside capture output.
+* ``--metadata KEY=VALUE``: injects run-specific metadata (campaign ID, antenna, scenario
+  tag, etc.).
+
+**Output behavior:**
+
+* If ``--output`` is omitted, a timestamped filename is generated automatically.
+* If ``--output-dir`` is omitted, captures default to ``recordings/``.
+* Format is inferred from the ``--output`` extension when no explicit ``--format`` is given.
+
+**Examples:**
+
+.. code-block:: bash
+
+   ria capture -d hackrf -s 2e6 -f 2.44G -n 1000000 -o rf.sigmf-data
+   ria capture -d pluto -f 915e6 -t 2 --format npy --output-dir recordings
+   ria capture -c capture_config.yaml
+
+
+4.4 ``view``
+-------------
+
+**Purpose:**
+
+* Generate visualizations from IQ files.
+* Quickly validate signal quality, occupancy, and annotation coverage without writing custom
+  plotting code.
+
+**Usage:**
+
+.. code-block:: bash
+
+   ria view <input> [options]
+
+``<input>`` accepts SigMF, NPY, WAV, and Blue files.
+
+**Mode** (``--type``):
+
+* ``simple``: fast-look plots for sanity checks and quick iteration.
+* ``full``: multi-panel diagnostic figure (IQ, time, frequency, metadata views).
+* ``annotations`` / ``annotation``: render annotation overlays.
+* ``channels``: channelized/segmented visualization.
+* ``annotate``: convenience path used in some annotation workflows.
+
+**Output/display options:**
+
+* ``--output``, ``--format {png,pdf,svg,jpg}``
+* ``--show``: open an interactive window (requires a GUI display environment).
+* ``--no-save``: suppress file output; only meaningful with ``--show``.
+* ``--overwrite``
+
+**Style options:**
+
+* ``--dpi``, ``--figsize WxH``, ``--title``
+* ``--light``: switch to a light theme (useful for reports/slides).
+
+**Loading options:**
+
+* ``--legacy``: force legacy NPY loading path for older datasets.
+* ``--config``
+
+**Mode-specific options:**
+
+*simple:* ``--fast``, ``--compact``, ``--horizontal``, ``--constellation``, ``--labels``,
+``--slice start:end[:step]``
+
+*full:* ``--plot-length``, ``--no-spectrogram``, ``--no-iq``, ``--no-frequency``,
+``--no-constellation``, ``--no-metadata``, ``--no-logo``, ``--spines``
+
+*annotations/channels:* ``--channel``
+
+**Examples:**
+
+.. code-block:: bash
+
+   ria view capture.sigmf-data --type simple
+   ria view capture.npy --type full --title "Test Capture" --format pdf
+   ria view capture.npy --show --no-save
+   ria view old.npy --legacy --type simple
+
+
+4.5 ``annotate`` group
+-----------------------
+
+**Purpose:**
+
+* Manual annotation management and auto-detection/separation.
+* Build or refine label metadata directly in recordings for downstream training, QA, and
+  filtering.
+
+**Command shape:**
+
+.. code-block:: bash
+
+   ria annotate <subcommand> ...
+
+**Subcommands:** ``list``, ``add``, ``remove``, ``clear``, ``energy``, ``cusum``,
+``threshold``, ``separate``
+
+**General behavior:**
+
+* SigMF is the preferred format for durable annotation metadata.
+* For non-SigMF input, many operations write a new output artifact unless overwrite behavior
+  is explicitly requested.
+* ``--type {standalone,parallel,intersection}`` controls annotation relation semantics.
+
+``ria annotate list``
+~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: bash
+
+   ria annotate list <input> [--verbose]
+
+Prints all annotations for a recording in index order. ``--verbose`` includes additional
+detail per record.
+
+``ria annotate add``
+~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: bash
+
+   ria annotate add <input> --start <int> --count <int> --label <text> [options]
+
+Adds one explicit annotation with sample-domain boundaries.
+
+* ``--start``: first sample index of the annotated region.
+* ``--count``: number of samples in the region.
+* ``--freq-lower``, ``--freq-upper``: optional spectral bounds in Hz.
+* ``--comment``, ``--type``, ``-o`` / ``--output``, ``--overwrite``, ``--quiet``
+
+``ria annotate remove``
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: bash
+
+   ria annotate remove <input> <index> [--output ...] [--overwrite] [--quiet]
+
+Removes exactly one annotation by list index. Run ``annotate list`` first to confirm the
+index.
+
+``ria annotate clear``
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: bash
+
+   ria annotate clear <input> [--force] [--overwrite] [--quiet]
+
+Removes all annotations from the recording. ``--force`` bypasses the confirmation prompt.
+
+``ria annotate energy``
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: bash
+
+   ria annotate energy <input> [options]
+
+Detects energetic regions above the estimated noise floor and writes them as annotations.
+
+* ``--label``
+* ``--threshold``: noise-floor multiplier; higher values reduce false positives but can miss
+  weak signals.
+* ``--segments``: number of segments used to estimate baseline noise.
+* ``--window-size``: smoothing size; larger windows stabilize detections at the cost of
+  sharp transition precision.
+* ``--min-distance``: minimum sample spacing between detections, preventing dense duplicate
+  regions.
+* ``--freq-method {nbw,obw,full-detected,full-bandwidth}``: how frequency bounds are assigned
+  to annotations.
+* ``--nfft``, ``--obw-power``
+* ``--type``, ``-o`` / ``--output``, ``--overwrite``, ``--quiet``
+
+``ria annotate cusum``
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: bash
+
+   ria annotate cusum <input> [options]
+
+Uses change-point detection (CUSUM-style logic) to find regime changes and annotate
+contiguous segments.
+
+* ``--label``
+* ``--min-duration`` (ms): prevents tiny over-segmented labels.
+* ``--window-size``
+* ``--tolerance``: merges nearby boundaries when set above default.
+* ``--type``, ``-o`` / ``--output``, ``--overwrite``, ``--quiet``
+
+``ria annotate threshold``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: bash
+
+   ria annotate threshold <input> --threshold <0.0..1.0> [options]
+
+Uses normalized magnitude thresholding to derive annotation spans. Use where a fixed
+amplitude threshold is sufficient.
+
+* ``--label``, ``--window-size``, ``--type``, ``-o`` / ``--output``, ``--overwrite``,
+  ``--quiet``
+
+``ria annotate separate``
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: bash
+
+   ria annotate separate <input> [options]
+
+Decomposes selected annotations into narrower spectral components and emits refined
+annotations.
+
+* ``--indices "0,1,2"``: limit operation to specific annotations; omit to process all.
+* ``--nfft``: larger FFT improves frequency resolution but increases compute time.
+* ``--noise-threshold-db``: stabilizes detection across heterogeneous captures.
+* ``--min-component-bw``: rejects narrow fragments likely to be noise artifacts.
+* ``-o`` / ``--output``, ``--overwrite``, ``--quiet``, ``--verbose``
+
+**Examples:**
+
+.. code-block:: bash
+
+   ria annotate list capture.sigmf-data --verbose
+   ria annotate add capture.sigmf-data --start 10000 --count 5000 --label burst
+   ria annotate energy capture.sigmf-data --label signal --threshold 1.3
+   ria annotate cusum capture.sigmf-data --min-duration 5
+   ria annotate separate capture.sigmf-data --indices 0,1 --verbose
+
+
+4.6 ``convert``
+----------------
+
+**Purpose:**
+
+* Convert between ``sigmf``, ``npy``, ``wav``, and ``blue``.
+* Normalize datasets into the format required by downstream tooling or collaboration targets.
+
+**Usage:**
+
+.. code-block:: bash
+
+   ria convert <input> [output] [options]
+
+If ``output`` is omitted, ``--format`` must be provided. If both are given, format is
+inferred from the output file extension.
+
+**Options:**
+
+* ``--format {npy,sigmf,wav,blue}``
+* ``--output-dir``
+* ``--legacy``: use older NPY loader behavior for historical recordings.
+* ``--wav-sample-rate``: target sample rate for WAV export.
+* ``--wav-bits {16,32}``: output PCM depth; higher preserves more dynamic range.
+* ``--blue-format {CI,CF,CD}``: Bluefile complex sample representation.
+* ``--metadata KEY=VALUE`` (repeatable): add or override metadata during conversion;
+  especially useful when exporting to SigMF.
+* ``--overwrite``, ``-v`` / ``--verbose``, ``-q`` / ``--quiet``
+
+**Examples:**
+
+.. code-block:: bash
+
+   ria convert recording.sigmf-data output.npy
+   ria convert recording.npy --format sigmf
+   ria convert highrate.npy audio.wav --wav-sample-rate 48000
+   ria convert old.npy --format sigmf --legacy --overwrite
+
+
+4.7 ``split``
+--------------
+
+**Purpose:**
+
+* Split, trim, or extract recordings.
+* Create manageable dataset shards or extract windows of interest without custom scripts.
+
+**Usage:**
+
+.. code-block:: bash
+
+   ria split <input> [operation] [options]
+
+Choose exactly one operation per invocation:
+
+* ``--split-at <sample>``: binary split at a specific sample index.
+* ``--split-every <N>``: fixed-size chunking for ML pipelines.
+* ``--split-duration <seconds>``: time-based chunking.
+* ``--trim`` (with ``--start`` + ``--length`` or ``--end``): extract one sub-window.
+* ``--extract-annotations``: write each annotated region as a standalone file.
+
+**Trim controls:** ``--start``, ``--length``, ``--end``
+
+**Annotation extraction filters:** ``--annotation-label``, ``--annotation-index``
+
+**Output controls:**
+``--output-dir``, ``--output-prefix``, ``--output-format {npy,sigmf,wav,blue}``,
+``--overwrite``, ``--legacy``, ``-v`` / ``--verbose``, ``-q`` / ``--quiet``
+
+**Examples:**
+
+.. code-block:: bash
+
+   ria split recording.sigmf-data --split-at 500000 --output-dir out
+   ria split recording.sigmf-data --split-every 100000 --output-dir chunks
+   ria split recording.sigmf-data --split-duration 1.0 --output-dir chunks
+   ria split recording.npy --trim --start 1000 --length 5000 --output-dir trimmed
+   ria split annotated.sigmf-data --extract-annotations --annotation-label payload
+
+
+4.8 ``combine``
+----------------
+
+**Purpose:**
+
+* Merge multiple recordings by concatenation or sample-wise addition.
+* Assemble multi-part captures or synthesize mixtures for testing and model training.
+
+**Usage:**
+
+.. code-block:: bash
+
+   ria combine <input1> <input2> [input3 ...] <output> [options]
+
+**Options:**
+
+* ``--mode {concat,add}``
+* ``--align-mode {error,truncate,pad,pad-start,pad-center,pad-end,repeat,repeat-spaced}``
+* ``--pad-start-sample``, ``--repeat-spacing``
+* ``--normalize``: rescale combined output to avoid clipping/saturation after addition.
+* ``--output-format {sigmf,npy,wav,blue}``
+* ``--overwrite``, ``--metadata KEY=VALUE`` (repeatable)
+* ``--legacy``, ``--verbose``, ``--quiet``
+
+**Mode semantics:**
+
+* ``concat``: append inputs sequentially in time.
+* ``add``: sample-wise summation — all inputs must be aligned to the same length.
+
+**Alignment options for** ``--mode add``:
+
+* ``error``: fail if lengths differ.
+* ``truncate``: cut all to shortest length.
+* ``pad``, ``pad-start``, ``pad-center``, ``pad-end``: zero-pad shorter streams.
+* ``repeat``: tile shorter streams to match longest.
+* ``repeat-spaced``: repeated placement with spacing via ``--repeat-spacing``.
+
+**Examples:**
+
+.. code-block:: bash
+
+   ria combine a.npy b.npy c.npy merged.npy
+   ria combine signal.npy noise.npy noisy.npy --mode add
+   ria combine long.npy short.npy out.npy --mode add --align-mode pad-center
+   ria combine signal.npy pattern.npy out.npy --mode add --align-mode repeat-spaced --repeat-spacing 10000
+
+
+4.9 ``generate`` group (and ``synth`` alias)
+---------------------------------------------
+
+**Purpose:**
+
+* Generate synthetic IQ signals and save in ``npy``, ``sigmf``, ``wav``, or ``blue``.
+* Create known-reference waveforms and synthetic datasets for validation, demos, and ML
+  data generation.
+
+``ria synth ...`` is an alias for ``ria generate ...``.
+
+**Shape:**
+
+.. code-block:: bash
+
+   ria generate <subcommand> [subcommand options] [common options]
+
+**Available subcommands:**
+``tone``, ``noise``, ``chirp``, ``square``, ``sawtooth``, ``qam``, ``apsk``, ``pam``,
+``fsk``, ``ook``, ``oqpsk``, ``gmsk``, ``psk``
+
+**Common options shared across all generators:**
+
+* ``-s, --sample-rate`` (required)
+* ``-n, --num-samples`` or ``-t, --duration``
+* ``--frequency-shift``, ``-fc`` / ``--center-frequency``
+* ``--add-noise``, ``--noise-power``, ``--path-gain``
+* ``-o, --output`` (required), ``-F`` / ``--format {npy,sigmf,wav,blue}``
+* ``--multipath-paths``, ``--multipath-max-delay``
+* ``--iq-amp-imbalance``, ``--iq-phase-imbalance``, ``--iq-dc-offset``
+* ``--config <yaml>``
+* ``-w`` / ``--overwrite``, ``-m`` / ``--metadata KEY=VALUE`` (repeatable)
+* ``-v`` / ``--verbose``, ``-q`` / ``--quiet``
+
+``--frequency-shift`` and ``--center-frequency`` let you separate the baseband shape from
+RF metadata context. ``--add-noise`` and ``--noise-power`` apply post-generation noise.
+Multipath and IQ imbalance flags apply impairment-style post-processing during generation.
+
+``tone``
+~~~~~~~~~
+
+Options: ``--frequency``, ``--amplitude``, ``--phase``
+
+Clean sinusoidal calibration/reference source.
+
+``noise``
+~~~~~~~~~~
+
+Options: ``--noise-type {gaussian,uniform}``, ``--power``
+
+Baseline noise floor data or controlled additive-noise synthesis.
+
+``chirp``
+~~~~~~~~~~
+
+Options: ``--bandwidth`` (required), ``--period`` (required), ``--type {up,down,up_down}``
+
+Sweep-based radar/sonar-style signals and bandwidth occupancy tests.
+
+``square``
+~~~~~~~~~~~
+
+Options: ``--frequency``, ``--amplitude``, ``--duty-cycle``, ``--phase``
+
+``sawtooth``
+~~~~~~~~~~~~~
+
+Options: ``--frequency``, ``--amplitude``, ``--phase``
+
+Digital modulation families: ``qam``, ``apsk``, ``pam``, ``psk``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+* ``--symbols``, ``--order``
+* ``--symbol-rate``
+* ``--filter {rrc,rc,gaussian,none}``, ``--filter-span``, ``--filter-beta``
+* ``--message-source {random,file,string}``, ``--message-content``
+
+Use ``--message-source random`` for synthetic datasets, ``file`` for deterministic replay,
+or ``string`` for small human-readable payload testing. Pulse-shaping filter options
+(``--filter``, ``--filter-span``, ``--filter-beta``) control spectral occupancy and ISI.
+
+``fsk``
+~~~~~~~~
+
+Options: ``--symbols``, ``--order``, ``--symbol-rate``, ``--freq-spacing``,
+``--modulation-index``, ``--message-source``, ``--message-content``
+
+``--freq-spacing`` and ``--modulation-index`` drive tone separation and spectral profile.
+
+``ook``, ``oqpsk``, ``gmsk``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Options: ``--symbol-rate`` (required), ``--message-source {random,file,string}``,
+``--message-content``; ``gmsk`` also accepts ``--bt``
+
+``gmsk --bt`` sets the Gaussian filter bandwidth-time product (spectral compactness vs
+symbol transition sharpness).
+
+**Examples:**
+
+.. code-block:: bash
+
+   ria generate tone -s 2e6 -n 500000 --frequency 50e3 -o tone.sigmf-data
+   ria generate noise -s 2e6 -n 500000 --noise-type gaussian --power 0.05 -o noise.npy
+   ria generate chirp -s 5e6 -t 0.5 --bandwidth 2e6 --period 0.01 --type up -o chirp.sigmf-data
+   ria generate qam -s 2e6 -r 100e3 -M 16 -N 5000 --message-source random -o qam16.npy
+   ria synth psk -s 2e6 -r 100e3 -M 8 -N 8000 -o psk8.npy
+
+
+4.10 ``transform`` group
+-------------------------
+
+**Purpose:**
+
+* Apply algorithmic transforms to existing recordings.
+* Run reusable augmentations/impairments for dataset diversity and robustness testing.
+
+**Shape:**
+
+.. code-block:: bash
+
+   ria transform <augment|impair|custom> ...
+
+``augment``
+~~~~~~~~~~~~
+
+.. code-block:: bash
+
+   ria transform augment [augmentation] [input] [output] [options]
+
+Applies transforms from ``iq_augmentations`` (dataset-expansion style modifications).
+
+Options: ``--list``, ``--help-transform``, ``--params KEY=VALUE`` (repeatable), ``--view``,
+``--overwrite``, ``-v`` / ``--verbose``, ``-q`` / ``--quiet``
+
+``impair``
+~~~~~~~~~~~
+
+.. code-block:: bash
+
+   ria transform impair [impairment] [input] [output] [options]
+
+Applies transforms from ``iq_impairments`` (noise, distortion, and channel degradation
+effects). Same options as ``augment``.
+
+``custom``
+~~~~~~~~~~~
+
+.. code-block:: bash
+
+   ria transform custom [transform_name] [input] [output] --transform-dir <dir> [options]
+
+Dynamically loads public functions from Python files in ``--transform-dir`` and exposes them
+as callable transforms.
+
+Options: ``--transform-dir`` (required), ``--list``, ``--help-transform``,
+``--params KEY=VALUE`` (repeatable), ``--view``, ``--overwrite``, ``-v`` / ``--verbose``,
+``-q`` / ``--quiet``
+
+``--params`` values must be ``KEY=VALUE``; types are inferred as int, float, or string.
+Use ``--list`` to enumerate available transform names, and ``--help-transform <name>`` to
+inspect parameter hints. ``--view`` writes a PNG preview alongside transform output.
+
+**Examples:**
+
+.. code-block:: bash
+
+   ria transform augment --list
+   ria transform augment channel_swap in.npy out.npy
+   ria transform augment drop_samples in.npy --params max_section_size=5 --view
+
+   ria transform impair --list
+   ria transform impair add_awgn_to_signal in.npy out.npy --params snr=10
+
+   ria transform custom --transform-dir ./my_transforms --list
+   ria transform custom my_filter in.npy out.npy --transform-dir ./my_transforms --params cutoff=0.2
+
+
+4.11 ``transmit``
+------------------
+
+**Purpose:**
+
+* Transmit IQ via a TX-capable SDR (``pluto``, ``hackrf``, ``bladerf``, ``usrp``).
+* Support playback of captured/generated waveforms for over-the-air or wired-loop test
+  scenarios.
+
+**Usage:**
+
+.. code-block:: bash
+
+   ria transmit [options]
+
+**Input source (choose one):**
+
+* ``--input <file>``: transmit an existing recording.
+* ``--generate {lfm,chirp,sine,pulse}``: synthesize a transmit signal on the fly.
+* If neither is specified, the command defaults to a generated LFM waveform.
+
+**Core options:**
+
+*Device/radio:* ``-d`` / ``--device {pluto,hackrf,bladerf,usrp}``, ``-i`` / ``--ident``,
+``-c`` / ``--config``
+
+*RF:* ``-s`` / ``--sample-rate``, ``-f`` / ``--center-frequency``, ``-g`` / ``--gain``,
+``-b`` / ``--bandwidth``
+
+*Input/gen:* ``--input``, ``--legacy``, ``--generate {lfm,chirp,sine,pulse}``
+
+*TX control:*
+
+* ``-r, --repeat``
+* ``--continuous``: transmit until interrupted (``Ctrl+C``).
+* ``--tx-delay``: pause between repeats when ``--repeat`` is used.
+* ``-y, --yes``: skip confirmation prompts; use carefully in scripted environments.
+
+*Logging:* ``-v`` / ``--verbose``, ``-q`` / ``--quiet``
+
+.. warning::
+   ``--continuous`` transmits until manually interrupted. Validate gain settings, antenna
+   configuration, and regulatory compliance before use.
+
+**Examples:**
+
+.. code-block:: bash
+
+   ria transmit -d pluto -f 915e6 -s 2e6 --input capture.sigmf-data
+   ria transmit -d hackrf --generate lfm -f 2.44G --continuous
+   ria transmit -d usrp --input msg.npy -r 3 --tx-delay 0.5
+
+
+5) YAML Config Patterns
+========================
+
+Several commands accept ``--config <file.yaml>`` for parameter loading. CLI flags generally
+override values loaded from ``--config``.
+
+Keep one stable baseline YAML per workflow (capture, generate, transmit), then override only
+experiment-specific fields on the CLI.
+
+**Capture config example:**
+
+.. code-block:: yaml
+
+   device: pluto
+   ident: 192.168.2.1
+   sample_rate: 2000000
+   center_frequency: 2.44G
+   gain: 20
+   bandwidth: 2000000
+   num_samples: 500000
+   format: sigmf
+   output: run1.sigmf-data
+   metadata:
+     campaign: lab_eval
+     antenna: dipole
+
+.. code-block:: bash
+
+   ria capture -c capture.yaml
+
+**Generate config example:**
+
+.. code-block:: yaml
+
+   sample_rate: 2000000
+   num_samples: 200000
+   format: npy
+   output: synth.npy
+   noise_power: 0.02
+
+.. code-block:: bash
+
+   ria generate noise --config generate.yaml
+
+
+6) Practical Tips and Safety
+=============================
+
+* Use ``ria discover`` before capture/transmit sessions.
+* Keep TX gain conservative first; validate with attenuators/dummy loads when needed.
+* Prefer SigMF for interoperable metadata and annotations.
+* For long workflows, keep outputs organized by campaign directories and consistent prefixes.
+* Use ``--verbose`` when debugging device init or driver issues.
+
+
+7) Version Notes
+=================
+
+These notes are based on the current implementation and should be re-validated against future
+releases.
+
+1. Some command docstrings and examples still mention ``utils`` or ``ria_toolkit_oss``
+   command prefixes in text blocks. The operational command is ``ria ...``.
+2. Command bindings currently import ``viewe`` instead of ``view`` in
+   ``src/ria_toolkit_oss_cli/ria_toolkit_oss/commands.py``.
+3. Multiple non-CLI modules still import ``utils.*``, which can create runtime dependency
+   coupling when using only ``ria-toolkit-oss`` in isolation.
+
+If you observe unexpected import errors after install, check the package version and
+changelog, then test ``ria --help`` in a clean virtual environment.
+
+
+8) Brief Scripting (Python) Preview
+=====================================
+
+For quick non-CLI use:
+
+.. code-block:: python
+
+   from ria_toolkit_oss.datatypes import Recording
+   from ria_toolkit_oss.io import load_recording, to_sigmf
+   from ria_toolkit_oss.transforms import iq_augmentations, iq_impairments
+
+   rec = load_recording("capture.sigmf-data")
+   aug = iq_augmentations.channel_swap(rec)
+   imp = iq_impairments.add_awgn_to_signal(aug, snr=10)
+   to_sigmf(imp, filename="capture_awgn", path=".")
+
+You can also call annotation algorithms and block-generator primitives from Python directly.
+
+
+9) Cheat Sheet
+===============
+
+.. code-block:: bash
+
+   # Install
+   pip install ria-toolkit-oss
+
+   # Discover
+   ria discover -v
+
+   # Init defaults
+   ria init --author "Jane" --project "rf1" --location "Lab-A"
+
+   # Capture
+   ria capture -d pluto -f 2.44G -s 2e6 -n 1000000 -o cap.sigmf-data
+
+   # View
+   ria view cap.sigmf-data --type simple
+
+   # Annotate
+   ria annotate energy cap.sigmf-data --threshold 1.2
+   ria annotate list cap.sigmf-data --verbose
+
+   # Convert
+   ria convert cap.sigmf-data cap.npy
+
+   # Split
+   ria split cap.sigmf-data --split-every 100000 --output-dir chunks
+
+   # Combine
+   ria combine chunks/a.npy chunks/b.npy merged.npy
+
+   # Generate
+   ria generate qam -s 2e6 -r 100e3 -M 16 -N 5000 -o qam16.npy
+
+   # Transform
+   ria transform augment channel_swap cap.npy
+   ria transform impair add_awgn_to_signal cap.npy --params snr=10
+
+   # Transmit
+   ria transmit -d hackrf --input cap.sigmf-data -f 2.44G -s 2e6

From ae07eef8850190d90dedc0cd6b2508ffb918fc65 Mon Sep 17 00:00:00 2001
From: ben <ben@qoherent.ai>
Date: Mon, 20 Apr 2026 13:33:00 -0400
Subject: [PATCH 11/13] Regenerate poetry.lock to sync with pyproject.toml
 paramiko addition

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 poetry.lock | 233 +++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 229 insertions(+), 4 deletions(-)

diff --git a/poetry.lock b/poetry.lock
index f8df5ee..c86843e 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -1,4 +1,4 @@
-# This file is automatically @generated by Poetry 2.2.1 and should not be changed by hand.
+# This file is automatically @generated by Poetry 2.1.2 and should not be changed by hand.
 
 [[package]]
 name = "alabaster"
@@ -98,6 +98,83 @@ files = [
 [package.extras]
 dev = ["backports.zoneinfo ; python_version < \"3.9\"", "freezegun (>=1.0,<2.0)", "jinja2 (>=3.0)", "pytest (>=6.0)", "pytest-cov", "pytz", "setuptools", "tzdata ; sys_platform == \"win32\""]
 
+[[package]]
+name = "bcrypt"
+version = "5.0.0"
+description = "Modern password hashing for your software and your servers"
+optional = false
+python-versions = ">=3.8"
+groups = ["main"]
+files = [
+    {file = "bcrypt-5.0.0-cp313-cp313t-macosx_10_12_universal2.whl", hash = "sha256:f3c08197f3039bec79cee59a606d62b96b16669cff3949f21e74796b6e3cd2be"},
+    {file = "bcrypt-5.0.0-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:200af71bc25f22006f4069060c88ed36f8aa4ff7f53e67ff04d2ab3f1e79a5b2"},
+    {file = "bcrypt-5.0.0-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:baade0a5657654c2984468efb7d6c110db87ea63ef5a4b54732e7e337253e44f"},
+    {file = "bcrypt-5.0.0-cp313-cp313t-manylinux_2_28_aarch64.whl", hash = "sha256:c58b56cdfb03202b3bcc9fd8daee8e8e9b6d7e3163aa97c631dfcfcc24d36c86"},
+    {file = "bcrypt-5.0.0-cp313-cp313t-manylinux_2_28_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:4bfd2a34de661f34d0bda43c3e4e79df586e4716ef401fe31ea39d69d581ef23"},
+    {file = "bcrypt-5.0.0-cp313-cp313t-manylinux_2_28_x86_64.whl", hash = "sha256:ed2e1365e31fc73f1825fa830f1c8f8917ca1b3ca6185773b349c20fd606cec2"},
+    {file = "bcrypt-5.0.0-cp313-cp313t-manylinux_2_34_aarch64.whl", hash = "sha256:83e787d7a84dbbfba6f250dd7a5efd689e935f03dd83b0f919d39349e1f23f83"},
+    {file = "bcrypt-5.0.0-cp313-cp313t-manylinux_2_34_x86_64.whl", hash = "sha256:137c5156524328a24b9fac1cb5db0ba618bc97d11970b39184c1d87dc4bf1746"},
+    {file = "bcrypt-5.0.0-cp313-cp313t-musllinux_1_1_aarch64.whl", hash = "sha256:38cac74101777a6a7d3b3e3cfefa57089b5ada650dce2baf0cbdd9d65db22a9e"},
+    {file = "bcrypt-5.0.0-cp313-cp313t-musllinux_1_1_x86_64.whl", hash = "sha256:d8d65b564ec849643d9f7ea05c6d9f0cd7ca23bdd4ac0c2dbef1104ab504543d"},
+    {file = "bcrypt-5.0.0-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:741449132f64b3524e95cd30e5cd3343006ce146088f074f31ab26b94e6c75ba"},
+    {file = "bcrypt-5.0.0-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:212139484ab3207b1f0c00633d3be92fef3c5f0af17cad155679d03ff2ee1e41"},
+    {file = "bcrypt-5.0.0-cp313-cp313t-win32.whl", hash = "sha256:9d52ed507c2488eddd6a95bccee4e808d3234fa78dd370e24bac65a21212b861"},
+    {file = "bcrypt-5.0.0-cp313-cp313t-win_amd64.whl", hash = "sha256:f6984a24db30548fd39a44360532898c33528b74aedf81c26cf29c51ee47057e"},
+    {file = "bcrypt-5.0.0-cp313-cp313t-win_arm64.whl", hash = "sha256:9fffdb387abe6aa775af36ef16f55e318dcda4194ddbf82007a6f21da29de8f5"},
+    {file = "bcrypt-5.0.0-cp314-cp314t-macosx_10_12_universal2.whl", hash = "sha256:4870a52610537037adb382444fefd3706d96d663ac44cbb2f37e3919dca3d7ef"},
+    {file = "bcrypt-5.0.0-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:48f753100931605686f74e27a7b49238122aa761a9aefe9373265b8b7aa43ea4"},
+    {file = "bcrypt-5.0.0-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:f70aadb7a809305226daedf75d90379c397b094755a710d7014b8b117df1ebbf"},
+    {file = "bcrypt-5.0.0-cp314-cp314t-manylinux_2_28_aarch64.whl", hash = "sha256:744d3c6b164caa658adcb72cb8cc9ad9b4b75c7db507ab4bc2480474a51989da"},
+    {file = "bcrypt-5.0.0-cp314-cp314t-manylinux_2_28_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:a28bc05039bdf3289d757f49d616ab3efe8cf40d8e8001ccdd621cd4f98f4fc9"},
+    {file = "bcrypt-5.0.0-cp314-cp314t-manylinux_2_28_x86_64.whl", hash = "sha256:7f277a4b3390ab4bebe597800a90da0edae882c6196d3038a73adf446c4f969f"},
+    {file = "bcrypt-5.0.0-cp314-cp314t-manylinux_2_34_aarch64.whl", hash = "sha256:79cfa161eda8d2ddf29acad370356b47f02387153b11d46042e93a0a95127493"},
+    {file = "bcrypt-5.0.0-cp314-cp314t-manylinux_2_34_x86_64.whl", hash = "sha256:a5393eae5722bcef046a990b84dff02b954904c36a194f6cfc817d7dca6c6f0b"},
+    {file = "bcrypt-5.0.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:7f4c94dec1b5ab5d522750cb059bb9409ea8872d4494fd152b53cca99f1ddd8c"},
+    {file = "bcrypt-5.0.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:0cae4cb350934dfd74c020525eeae0a5f79257e8a201c0c176f4b84fdbf2a4b4"},
+    {file = "bcrypt-5.0.0-cp314-cp314t-win32.whl", hash = "sha256:b17366316c654e1ad0306a6858e189fc835eca39f7eb2cafd6aaca8ce0c40a2e"},
+    {file = "bcrypt-5.0.0-cp314-cp314t-win_amd64.whl", hash = "sha256:92864f54fb48b4c718fc92a32825d0e42265a627f956bc0361fe869f1adc3e7d"},
+    {file = "bcrypt-5.0.0-cp314-cp314t-win_arm64.whl", hash = "sha256:dd19cf5184a90c873009244586396a6a884d591a5323f0e8a5922560718d4993"},
+    {file = "bcrypt-5.0.0-cp38-abi3-macosx_10_12_universal2.whl", hash = "sha256:fc746432b951e92b58317af8e0ca746efe93e66555f1b40888865ef5bf56446b"},
+    {file = "bcrypt-5.0.0-cp38-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:c2388ca94ffee269b6038d48747f4ce8df0ffbea43f31abfa18ac72f0218effb"},
+    {file = "bcrypt-5.0.0-cp38-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:560ddb6ec730386e7b3b26b8b4c88197aaed924430e7b74666a586ac997249ef"},
+    {file = "bcrypt-5.0.0-cp38-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:d79e5c65dcc9af213594d6f7f1fa2c98ad3fc10431e7aa53c176b441943efbdd"},
+    {file = "bcrypt-5.0.0-cp38-abi3-manylinux_2_28_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:2b732e7d388fa22d48920baa267ba5d97cca38070b69c0e2d37087b381c681fd"},
+    {file = "bcrypt-5.0.0-cp38-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:0c8e093ea2532601a6f686edbc2c6b2ec24131ff5c52f7610dd64fa4553b5464"},
+    {file = "bcrypt-5.0.0-cp38-abi3-manylinux_2_34_aarch64.whl", hash = "sha256:5b1589f4839a0899c146e8892efe320c0fa096568abd9b95593efac50a87cb75"},
+    {file = "bcrypt-5.0.0-cp38-abi3-manylinux_2_34_x86_64.whl", hash = "sha256:89042e61b5e808b67daf24a434d89bab164d4de1746b37a8d173b6b14f3db9ff"},
+    {file = "bcrypt-5.0.0-cp38-abi3-musllinux_1_1_aarch64.whl", hash = "sha256:e3cf5b2560c7b5a142286f69bde914494b6d8f901aaa71e453078388a50881c4"},
+    {file = "bcrypt-5.0.0-cp38-abi3-musllinux_1_1_x86_64.whl", hash = "sha256:f632fd56fc4e61564f78b46a2269153122db34988e78b6be8b32d28507b7eaeb"},
+    {file = "bcrypt-5.0.0-cp38-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:801cad5ccb6b87d1b430f183269b94c24f248dddbbc5c1f78b6ed231743e001c"},
+    {file = "bcrypt-5.0.0-cp38-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:3cf67a804fc66fc217e6914a5635000259fbbbb12e78a99488e4d5ba445a71eb"},
+    {file = "bcrypt-5.0.0-cp38-abi3-win32.whl", hash = "sha256:3abeb543874b2c0524ff40c57a4e14e5d3a66ff33fb423529c88f180fd756538"},
+    {file = "bcrypt-5.0.0-cp38-abi3-win_amd64.whl", hash = "sha256:35a77ec55b541e5e583eb3436ffbbf53b0ffa1fa16ca6782279daf95d146dcd9"},
+    {file = "bcrypt-5.0.0-cp38-abi3-win_arm64.whl", hash = "sha256:cde08734f12c6a4e28dc6755cd11d3bdfea608d93d958fffbe95a7026ebe4980"},
+    {file = "bcrypt-5.0.0-cp39-abi3-macosx_10_12_universal2.whl", hash = "sha256:0c418ca99fd47e9c59a301744d63328f17798b5947b0f791e9af3c1c499c2d0a"},
+    {file = "bcrypt-5.0.0-cp39-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:ddb4e1500f6efdd402218ffe34d040a1196c072e07929b9820f363a1fd1f4191"},
+    {file = "bcrypt-5.0.0-cp39-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:7aeef54b60ceddb6f30ee3db090351ecf0d40ec6e2abf41430997407a46d2254"},
+    {file = "bcrypt-5.0.0-cp39-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:f0ce778135f60799d89c9693b9b398819d15f1921ba15fe719acb3178215a7db"},
+    {file = "bcrypt-5.0.0-cp39-abi3-manylinux_2_28_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:a71f70ee269671460b37a449f5ff26982a6f2ba493b3eabdd687b4bf35f875ac"},
+    {file = "bcrypt-5.0.0-cp39-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:f8429e1c410b4073944f03bd778a9e066e7fad723564a52ff91841d278dfc822"},
+    {file = "bcrypt-5.0.0-cp39-abi3-manylinux_2_34_aarch64.whl", hash = "sha256:edfcdcedd0d0f05850c52ba3127b1fce70b9f89e0fe5ff16517df7e81fa3cbb8"},
+    {file = "bcrypt-5.0.0-cp39-abi3-manylinux_2_34_x86_64.whl", hash = "sha256:611f0a17aa4a25a69362dcc299fda5c8a3d4f160e2abb3831041feb77393a14a"},
+    {file = "bcrypt-5.0.0-cp39-abi3-musllinux_1_1_aarch64.whl", hash = "sha256:db99dca3b1fdc3db87d7c57eac0c82281242d1eabf19dcb8a6b10eb29a2e72d1"},
+    {file = "bcrypt-5.0.0-cp39-abi3-musllinux_1_1_x86_64.whl", hash = "sha256:5feebf85a9cefda32966d8171f5db7e3ba964b77fdfe31919622256f80f9cf42"},
+    {file = "bcrypt-5.0.0-cp39-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:3ca8a166b1140436e058298a34d88032ab62f15aae1c598580333dc21d27ef10"},
+    {file = "bcrypt-5.0.0-cp39-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:61afc381250c3182d9078551e3ac3a41da14154fbff647ddf52a769f588c4172"},
+    {file = "bcrypt-5.0.0-cp39-abi3-win32.whl", hash = "sha256:64d7ce196203e468c457c37ec22390f1a61c85c6f0b8160fd752940ccfb3a683"},
+    {file = "bcrypt-5.0.0-cp39-abi3-win_amd64.whl", hash = "sha256:64ee8434b0da054d830fa8e89e1c8bf30061d539044a39524ff7dec90481e5c2"},
+    {file = "bcrypt-5.0.0-cp39-abi3-win_arm64.whl", hash = "sha256:f2347d3534e76bf50bca5500989d6c1d05ed64b440408057a37673282c654927"},
+    {file = "bcrypt-5.0.0-pp311-pypy311_pp73-manylinux_2_28_aarch64.whl", hash = "sha256:7edda91d5ab52b15636d9c30da87d2cc84f426c72b9dba7a9b4fe142ba11f534"},
+    {file = "bcrypt-5.0.0-pp311-pypy311_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:046ad6db88edb3c5ece4369af997938fb1c19d6a699b9c1b27b0db432faae4c4"},
+    {file = "bcrypt-5.0.0-pp311-pypy311_pp73-manylinux_2_34_aarch64.whl", hash = "sha256:dcd58e2b3a908b5ecc9b9df2f0085592506ac2d5110786018ee5e160f28e0911"},
+    {file = "bcrypt-5.0.0-pp311-pypy311_pp73-manylinux_2_34_x86_64.whl", hash = "sha256:6b8f520b61e8781efee73cba14e3e8c9556ccfb375623f4f97429544734545b4"},
+    {file = "bcrypt-5.0.0.tar.gz", hash = "sha256:f748f7c2d6fd375cc93d3fba7ef4a9e3a092421b8dbf34d8d4dc06be9492dfdd"},
+]
+
+[package.extras]
+tests = ["pytest (>=3.2.1,!=3.3.0)"]
+typecheck = ["mypy"]
+
 [[package]]
 name = "black"
 version = "26.3.1"
@@ -182,7 +259,7 @@ description = "Foreign Function Interface for Python calling C code."
 optional = false
 python-versions = ">=3.9"
 groups = ["main"]
-markers = "implementation_name == \"pypy\""
+markers = "implementation_name == \"pypy\" or platform_python_implementation != \"PyPy\""
 files = [
     {file = "cffi-2.0.0-cp310-cp310-macosx_10_13_x86_64.whl", hash = "sha256:0cf2d91ecc3fcc0625c2c530fe004f82c110405f101548512cce44322fa8ac44"},
     {file = "cffi-2.0.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:f73b96c41e3b2adedc34a7356e64c8eb96e03a3782b535e043a986276ce12a49"},
@@ -611,6 +688,79 @@ mypy = ["bokeh", "contourpy[bokeh,docs]", "docutils-stubs", "mypy (==1.17.0)", "
 test = ["Pillow", "contourpy[test-no-images]", "matplotlib"]
 test-no-images = ["pytest", "pytest-cov", "pytest-rerunfailures", "pytest-xdist", "wurlitzer"]
 
+[[package]]
+name = "cryptography"
+version = "46.0.7"
+description = "cryptography is a package which provides cryptographic recipes and primitives to Python developers."
+optional = false
+python-versions = "!=3.9.0,!=3.9.1,>=3.8"
+groups = ["main"]
+files = [
+    {file = "cryptography-46.0.7-cp311-abi3-macosx_10_9_universal2.whl", hash = "sha256:ea42cbe97209df307fdc3b155f1b6fa2577c0defa8f1f7d3be7d31d189108ad4"},
+    {file = "cryptography-46.0.7-cp311-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:b36a4695e29fe69215d75960b22577197aca3f7a25b9cf9d165dcfe9d80bc325"},
+    {file = "cryptography-46.0.7-cp311-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:5ad9ef796328c5e3c4ceed237a183f5d41d21150f972455a9d926593a1dcb308"},
+    {file = "cryptography-46.0.7-cp311-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:73510b83623e080a2c35c62c15298096e2a5dc8d51c3b4e1740211839d0dea77"},
+    {file = "cryptography-46.0.7-cp311-abi3-manylinux_2_28_ppc64le.whl", hash = "sha256:cbd5fb06b62bd0721e1170273d3f4d5a277044c47ca27ee257025146c34cbdd1"},
+    {file = "cryptography-46.0.7-cp311-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:420b1e4109cc95f0e5700eed79908cef9268265c773d3a66f7af1eef53d409ef"},
+    {file = "cryptography-46.0.7-cp311-abi3-manylinux_2_31_armv7l.whl", hash = "sha256:24402210aa54baae71d99441d15bb5a1919c195398a87b563df84468160a65de"},
+    {file = "cryptography-46.0.7-cp311-abi3-manylinux_2_34_aarch64.whl", hash = "sha256:8a469028a86f12eb7d2fe97162d0634026d92a21f3ae0ac87ed1c4a447886c83"},
+    {file = "cryptography-46.0.7-cp311-abi3-manylinux_2_34_ppc64le.whl", hash = "sha256:9694078c5d44c157ef3162e3bf3946510b857df5a3955458381d1c7cfc143ddb"},
+    {file = "cryptography-46.0.7-cp311-abi3-manylinux_2_34_x86_64.whl", hash = "sha256:42a1e5f98abb6391717978baf9f90dc28a743b7d9be7f0751a6f56a75d14065b"},
+    {file = "cryptography-46.0.7-cp311-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:91bbcb08347344f810cbe49065914fe048949648f6bd5c2519f34619142bbe85"},
+    {file = "cryptography-46.0.7-cp311-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:5d1c02a14ceb9148cc7816249f64f623fbfee39e8c03b3650d842ad3f34d637e"},
+    {file = "cryptography-46.0.7-cp311-abi3-win32.whl", hash = "sha256:d23c8ca48e44ee015cd0a54aeccdf9f09004eba9fc96f38c911011d9ff1bd457"},
+    {file = "cryptography-46.0.7-cp311-abi3-win_amd64.whl", hash = "sha256:397655da831414d165029da9bc483bed2fe0e75dde6a1523ec2fe63f3c46046b"},
+    {file = "cryptography-46.0.7-cp314-cp314t-macosx_10_9_universal2.whl", hash = "sha256:d151173275e1728cf7839aaa80c34fe550c04ddb27b34f48c232193df8db5842"},
+    {file = "cryptography-46.0.7-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:db0f493b9181c7820c8134437eb8b0b4792085d37dbb24da050476ccb664e59c"},
+    {file = "cryptography-46.0.7-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:ebd6daf519b9f189f85c479427bbd6e9c9037862cf8fe89ee35503bd209ed902"},
+    {file = "cryptography-46.0.7-cp314-cp314t-manylinux_2_28_aarch64.whl", hash = "sha256:b7b412817be92117ec5ed95f880defe9cf18a832e8cafacf0a22337dc1981b4d"},
+    {file = "cryptography-46.0.7-cp314-cp314t-manylinux_2_28_ppc64le.whl", hash = "sha256:fbfd0e5f273877695cb93baf14b185f4878128b250cc9f8e617ea0c025dfb022"},
+    {file = "cryptography-46.0.7-cp314-cp314t-manylinux_2_28_x86_64.whl", hash = "sha256:ffca7aa1d00cf7d6469b988c581598f2259e46215e0140af408966a24cf086ce"},
+    {file = "cryptography-46.0.7-cp314-cp314t-manylinux_2_31_armv7l.whl", hash = "sha256:60627cf07e0d9274338521205899337c5d18249db56865f943cbe753aa96f40f"},
+    {file = "cryptography-46.0.7-cp314-cp314t-manylinux_2_34_aarch64.whl", hash = "sha256:80406c3065e2c55d7f49a9550fe0c49b3f12e5bfff5dedb727e319e1afb9bf99"},
+    {file = "cryptography-46.0.7-cp314-cp314t-manylinux_2_34_ppc64le.whl", hash = "sha256:c5b1ccd1239f48b7151a65bc6dd54bcfcc15e028c8ac126d3fada09db0e07ef1"},
+    {file = "cryptography-46.0.7-cp314-cp314t-manylinux_2_34_x86_64.whl", hash = "sha256:d5f7520159cd9c2154eb61eb67548ca05c5774d39e9c2c4339fd793fe7d097b2"},
+    {file = "cryptography-46.0.7-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:fcd8eac50d9138c1d7fc53a653ba60a2bee81a505f9f8850b6b2888555a45d0e"},
+    {file = "cryptography-46.0.7-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:65814c60f8cc400c63131584e3e1fad01235edba2614b61fbfbfa954082db0ee"},
+    {file = "cryptography-46.0.7-cp314-cp314t-win32.whl", hash = "sha256:fdd1736fed309b4300346f88f74cd120c27c56852c3838cab416e7a166f67298"},
+    {file = "cryptography-46.0.7-cp314-cp314t-win_amd64.whl", hash = "sha256:e06acf3c99be55aa3b516397fe42f5855597f430add9c17fa46bf2e0fb34c9bb"},
+    {file = "cryptography-46.0.7-cp38-abi3-macosx_10_9_universal2.whl", hash = "sha256:462ad5cb1c148a22b2e3bcc5ad52504dff325d17daf5df8d88c17dda1f75f2a4"},
+    {file = "cryptography-46.0.7-cp38-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:84d4cced91f0f159a7ddacad249cc077e63195c36aac40b4150e7a57e84fffe7"},
+    {file = "cryptography-46.0.7-cp38-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:128c5edfe5e5938b86b03941e94fac9ee793a94452ad1365c9fc3f4f62216832"},
+    {file = "cryptography-46.0.7-cp38-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:5e51be372b26ef4ba3de3c167cd3d1022934bc838ae9eaad7e644986d2a3d163"},
+    {file = "cryptography-46.0.7-cp38-abi3-manylinux_2_28_ppc64le.whl", hash = "sha256:cdf1a610ef82abb396451862739e3fc93b071c844399e15b90726ef7470eeaf2"},
+    {file = "cryptography-46.0.7-cp38-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:1d25aee46d0c6f1a501adcddb2d2fee4b979381346a78558ed13e50aa8a59067"},
+    {file = "cryptography-46.0.7-cp38-abi3-manylinux_2_31_armv7l.whl", hash = "sha256:cdfbe22376065ffcf8be74dc9a909f032df19bc58a699456a21712d6e5eabfd0"},
+    {file = "cryptography-46.0.7-cp38-abi3-manylinux_2_34_aarch64.whl", hash = "sha256:abad9dac36cbf55de6eb49badd4016806b3165d396f64925bf2999bcb67837ba"},
+    {file = "cryptography-46.0.7-cp38-abi3-manylinux_2_34_ppc64le.whl", hash = "sha256:935ce7e3cfdb53e3536119a542b839bb94ec1ad081013e9ab9b7cfd478b05006"},
+    {file = "cryptography-46.0.7-cp38-abi3-manylinux_2_34_x86_64.whl", hash = "sha256:35719dc79d4730d30f1c2b6474bd6acda36ae2dfae1e3c16f2051f215df33ce0"},
+    {file = "cryptography-46.0.7-cp38-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:7bbc6ccf49d05ac8f7d7b5e2e2c33830d4fe2061def88210a126d130d7f71a85"},
+    {file = "cryptography-46.0.7-cp38-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:a1529d614f44b863a7b480c6d000fe93b59acee9c82ffa027cfadc77521a9f5e"},
+    {file = "cryptography-46.0.7-cp38-abi3-win32.whl", hash = "sha256:f247c8c1a1fb45e12586afbb436ef21ff1e80670b2861a90353d9b025583d246"},
+    {file = "cryptography-46.0.7-cp38-abi3-win_amd64.whl", hash = "sha256:506c4ff91eff4f82bdac7633318a526b1d1309fc07ca76a3ad182cb5b686d6d3"},
+    {file = "cryptography-46.0.7-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:fc9ab8856ae6cf7c9358430e49b368f3108f050031442eaeb6b9d87e4dcf4e4f"},
+    {file = "cryptography-46.0.7-pp311-pypy311_pp73-manylinux_2_28_aarch64.whl", hash = "sha256:d3b99c535a9de0adced13d159c5a9cf65c325601aa30f4be08afd680643e9c15"},
+    {file = "cryptography-46.0.7-pp311-pypy311_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:d02c738dacda7dc2a74d1b2b3177042009d5cab7c7079db74afc19e56ca1b455"},
+    {file = "cryptography-46.0.7-pp311-pypy311_pp73-manylinux_2_34_aarch64.whl", hash = "sha256:04959522f938493042d595a736e7dbdff6eb6cc2339c11465b3ff89343b65f65"},
+    {file = "cryptography-46.0.7-pp311-pypy311_pp73-manylinux_2_34_x86_64.whl", hash = "sha256:3986ac1dee6def53797289999eabe84798ad7817f3e97779b5061a95b0ee4968"},
+    {file = "cryptography-46.0.7-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:258514877e15963bd43b558917bc9f54cf7cf866c38aa576ebf47a77ddbc43a4"},
+    {file = "cryptography-46.0.7.tar.gz", hash = "sha256:e4cfd68c5f3e0bfdad0d38e023239b96a2fe84146481852dffbcca442c245aa5"},
+]
+
+[package.dependencies]
+cffi = {version = ">=2.0.0", markers = "python_full_version >= \"3.9.0\" and platform_python_implementation != \"PyPy\""}
+typing-extensions = {version = ">=4.13.2", markers = "python_full_version < \"3.11.0\""}
+
+[package.extras]
+docs = ["sphinx (>=5.3.0)", "sphinx-inline-tabs", "sphinx-rtd-theme (>=3.0.0)"]
+docstest = ["pyenchant (>=3)", "readme-renderer (>=30.0)", "sphinxcontrib-spelling (>=7.3.1)"]
+nox = ["nox[uv] (>=2024.4.15)"]
+pep8test = ["check-sdist", "click (>=8.0.1)", "mypy (>=1.14)", "ruff (>=0.11.11)"]
+sdist = ["build (>=1.0.0)"]
+ssh = ["bcrypt (>=3.1.5)"]
+test = ["certifi (>=2024)", "cryptography-vectors (==46.0.7)", "pretend (>=0.7)", "pytest (>=7.4.0)", "pytest-benchmark (>=4.0)", "pytest-cov (>=2.10.1)", "pytest-xdist (>=3.5.0)"]
+test-randomorder = ["pytest-randomly"]
+
 [[package]]
 name = "cycler"
 version = "0.12.1"
@@ -1061,6 +1211,18 @@ files = [
     {file = "iniconfig-2.3.0.tar.gz", hash = "sha256:c76315c77db068650d49c5b56314774a7804df16fee4402c1f19d6d15d8c4730"},
 ]
 
+[[package]]
+name = "invoke"
+version = "3.0.3"
+description = "Pythonic task execution"
+optional = false
+python-versions = ">=3.9"
+groups = ["main"]
+files = [
+    {file = "invoke-3.0.3-py3-none-any.whl", hash = "sha256:f11327165e5cbb89b2ad1d88d3292b5113332c43b8553b494da435d6ec6f5053"},
+    {file = "invoke-3.0.3.tar.gz", hash = "sha256:437b6a622223824380bfb4e64f612711a6b648c795f565efc8625af66fb57f0c"},
+]
+
 [[package]]
 name = "isort"
 version = "5.13.2"
@@ -1746,6 +1908,27 @@ sql-other = ["SQLAlchemy (>=2.0.0)", "adbc-driver-postgresql (>=0.8.0)", "adbc-d
 test = ["hypothesis (>=6.46.1)", "pytest (>=7.3.2)", "pytest-xdist (>=2.2.0)"]
 xml = ["lxml (>=4.9.2)"]
 
+[[package]]
+name = "paramiko"
+version = "4.0.0"
+description = "SSH2 protocol library"
+optional = false
+python-versions = ">=3.9"
+groups = ["main"]
+files = [
+    {file = "paramiko-4.0.0-py3-none-any.whl", hash = "sha256:0e20e00ac666503bf0b4eda3b6d833465a2b7aff2e2b3d79a8bba5ef144ee3b9"},
+    {file = "paramiko-4.0.0.tar.gz", hash = "sha256:6a25f07b380cc9c9a88d2b920ad37167ac4667f8d9886ccebd8f90f654b5d69f"},
+]
+
+[package.dependencies]
+bcrypt = ">=3.2"
+cryptography = ">=3.3"
+invoke = ">=2.0"
+pynacl = ">=1.5"
+
+[package.extras]
+gssapi = ["gssapi (>=1.4.1) ; platform_system != \"Windows\"", "pyasn1 (>=0.1.7)", "pywin32 (>=2.1.8) ; platform_system == \"Windows\""]
+
 [[package]]
 name = "pathspec"
 version = "1.0.4"
@@ -1962,7 +2145,7 @@ description = "C parser in Python"
 optional = false
 python-versions = ">=3.10"
 groups = ["main"]
-markers = "implementation_name == \"pypy\""
+markers = "(implementation_name == \"pypy\" or platform_python_implementation != \"PyPy\") and implementation_name != \"PyPy\""
 files = [
     {file = "pycparser-3.0-py3-none-any.whl", hash = "sha256:b727414169a36b7d524c1c3e31839a521725078d7b2ff038656844266160a992"},
     {file = "pycparser-3.0.tar.gz", hash = "sha256:600f49d217304a5902ac3c37e1281c9fe94e4d0489de643a9504c5cdfdfc6b29"},
@@ -2180,6 +2363,48 @@ tomlkit = ">=0.10.1"
 spelling = ["pyenchant (>=3.2,<4.0)"]
 testutils = ["gitpython (>3)"]
 
+[[package]]
+name = "pynacl"
+version = "1.6.2"
+description = "Python binding to the Networking and Cryptography (NaCl) library"
+optional = false
+python-versions = ">=3.8"
+groups = ["main"]
+files = [
+    {file = "pynacl-1.6.2-cp314-cp314t-macosx_10_10_universal2.whl", hash = "sha256:622d7b07cc5c02c666795792931b50c91f3ce3c2649762efb1ef0d5684c81594"},
+    {file = "pynacl-1.6.2-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:d071c6a9a4c94d79eb665db4ce5cedc537faf74f2355e4d502591d850d3913c0"},
+    {file = "pynacl-1.6.2-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:fe9847ca47d287af41e82be1dd5e23023d3c31a951da134121ab02e42ac218c9"},
+    {file = "pynacl-1.6.2-cp314-cp314t-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:04316d1fc625d860b6c162fff704eb8426b1a8bcd3abacea11142cbd99a6b574"},
+    {file = "pynacl-1.6.2-cp314-cp314t-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:44081faff368d6c5553ccf55322ef2819abb40e25afaec7e740f159f74813634"},
+    {file = "pynacl-1.6.2-cp314-cp314t-manylinux_2_34_aarch64.whl", hash = "sha256:a9f9932d8d2811ce1a8ffa79dcbdf3970e7355b5c8eb0c1a881a57e7f7d96e88"},
+    {file = "pynacl-1.6.2-cp314-cp314t-manylinux_2_34_x86_64.whl", hash = "sha256:bc4a36b28dd72fb4845e5d8f9760610588a96d5a51f01d84d8c6ff9849968c14"},
+    {file = "pynacl-1.6.2-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:3bffb6d0f6becacb6526f8f42adfb5efb26337056ee0831fb9a7044d1a964444"},
+    {file = "pynacl-1.6.2-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:2fef529ef3ee487ad8113d287a593fa26f48ee3620d92ecc6f1d09ea38e0709b"},
+    {file = "pynacl-1.6.2-cp314-cp314t-win32.whl", hash = "sha256:a84bf1c20339d06dc0c85d9aea9637a24f718f375d861b2668b2f9f96fa51145"},
+    {file = "pynacl-1.6.2-cp314-cp314t-win_amd64.whl", hash = "sha256:320ef68a41c87547c91a8b58903c9caa641ab01e8512ce291085b5fe2fcb7590"},
+    {file = "pynacl-1.6.2-cp314-cp314t-win_arm64.whl", hash = "sha256:d29bfe37e20e015a7d8b23cfc8bd6aa7909c92a1b8f41ee416bbb3e79ef182b2"},
+    {file = "pynacl-1.6.2-cp38-abi3-macosx_10_10_universal2.whl", hash = "sha256:c949ea47e4206af7c8f604b8278093b674f7c79ed0d4719cc836902bf4517465"},
+    {file = "pynacl-1.6.2-cp38-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:8845c0631c0be43abdd865511c41eab235e0be69c81dc66a50911594198679b0"},
+    {file = "pynacl-1.6.2-cp38-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:22de65bb9010a725b0dac248f353bb072969c94fa8d6b1f34b87d7953cf7bbe4"},
+    {file = "pynacl-1.6.2-cp38-abi3-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:46065496ab748469cdd999246d17e301b2c24ae2fdf739132e580a0e94c94a87"},
+    {file = "pynacl-1.6.2-cp38-abi3-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:8a66d6fb6ae7661c58995f9c6435bda2b1e68b54b598a6a10247bfcdadac996c"},
+    {file = "pynacl-1.6.2-cp38-abi3-manylinux_2_34_aarch64.whl", hash = "sha256:26bfcd00dcf2cf160f122186af731ae30ab120c18e8375684ec2670dccd28130"},
+    {file = "pynacl-1.6.2-cp38-abi3-manylinux_2_34_x86_64.whl", hash = "sha256:c8a231e36ec2cab018c4ad4358c386e36eede0319a0c41fed24f840b1dac59f6"},
+    {file = "pynacl-1.6.2-cp38-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:68be3a09455743ff9505491220b64440ced8973fe930f270c8e07ccfa25b1f9e"},
+    {file = "pynacl-1.6.2-cp38-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:8b097553b380236d51ed11356c953bf8ce36a29a3e596e934ecabe76c985a577"},
+    {file = "pynacl-1.6.2-cp38-abi3-win32.whl", hash = "sha256:5811c72b473b2f38f7e2a3dc4f8642e3a3e9b5e7317266e4ced1fba85cae41aa"},
+    {file = "pynacl-1.6.2-cp38-abi3-win_amd64.whl", hash = "sha256:62985f233210dee6548c223301b6c25440852e13d59a8b81490203c3227c5ba0"},
+    {file = "pynacl-1.6.2-cp38-abi3-win_arm64.whl", hash = "sha256:834a43af110f743a754448463e8fd61259cd4ab5bbedcf70f9dabad1d28a394c"},
+    {file = "pynacl-1.6.2.tar.gz", hash = "sha256:018494d6d696ae03c7e656e5e74cdfd8ea1326962cc401bcf018f1ed8436811c"},
+]
+
+[package.dependencies]
+cffi = {version = ">=2.0.0", markers = "platform_python_implementation != \"PyPy\" and python_version >= \"3.9\""}
+
+[package.extras]
+docs = ["sphinx (<7)", "sphinx_rtd_theme"]
+tests = ["hypothesis (>=3.27.0)", "pytest (>=7.4.0)", "pytest-cov (>=2.10.1)", "pytest-xdist (>=3.5.0)"]
+
 [[package]]
 name = "pyparsing"
 version = "3.3.2"
@@ -3535,4 +3760,4 @@ files = [
 [metadata]
 lock-version = "2.1"
 python-versions = ">=3.10"
-content-hash = "b1e5ddd7284aecf49624e51740b7a4c31bc8d0e703c255126ba5d9b2a4a0e519"
+content-hash = "1f3e922366bf38e42d8c7b839519e921ff9b3ffcb6d46dd5ebf1f59607ccf91c"

From ab4cb0ea5ac845a5618e01ee0b05e2da2197421c Mon Sep 17 00:00:00 2001
From: ben <ben@qoherent.ai>
Date: Mon, 20 Apr 2026 13:56:18 -0400
Subject: [PATCH 12/13] Remove poetry.toml system-site-packages workaround;
 regenerate lock file

system-site-packages = true caused poetry install to fail in CI due to
conflicting system packages. Lock file regenerated without that constraint.
---
 poetry.toml | 2 --
 1 file changed, 2 deletions(-)
 delete mode 100644 poetry.toml

diff --git a/poetry.toml b/poetry.toml
deleted file mode 100644
index 25758d2..0000000
--- a/poetry.toml
+++ /dev/null
@@ -1,2 +0,0 @@
-[virtualenvs.options]
-system-site-packages = true

From 1fa9ab24958ed01f1c8968321d709b0843f6b6c0 Mon Sep 17 00:00:00 2001
From: ben <ben@qoherent.ai>
Date: Mon, 20 Apr 2026 14:18:04 -0400
Subject: [PATCH 13/13] Fix onnxruntime Python 3.10 incompatibility and hackrf
 test import failure

- Restrict onnxruntime to Python >=3.11 (1.24.3+ dropped cp310 wheels)
- Fix hackrf tests to mock sys.modules instead of using patch(), which
  triggered a CDLL import of libhackrf.so.0 at module load time in CI

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 poetry.lock                                   | 58 ++++---------------
 pyproject.toml                                |  4 +-
 .../remote_control/test_remote_transmitter.py |  8 ++-
 3 files changed, 19 insertions(+), 51 deletions(-)

diff --git a/poetry.lock b/poetry.lock
index c86843e..6794f90 100644
--- a/poetry.lock
+++ b/poetry.lock
@@ -908,6 +908,7 @@ description = "The FlatBuffers serialization format for Python"
 optional = false
 python-versions = "*"
 groups = ["server", "test"]
+markers = "python_version >= \"3.11\""
 files = [
     {file = "flatbuffers-25.12.19-py2.py3-none-any.whl", hash = "sha256:7634f50c427838bb021c2d66a3d1168e9d199b0607e6329399f04846d42e20b4"},
 ]
@@ -1617,6 +1618,7 @@ description = "Python library for arbitrary-precision floating-point arithmetic"
 optional = false
 python-versions = "*"
 groups = ["server", "test"]
+markers = "python_version >= \"3.11\""
 files = [
     {file = "mpmath-1.3.0-py3-none-any.whl", hash = "sha256:a0b2b9fe80bbcd81a6647ff13108738cfb482d481d826cc0e02f5b35e5c88d2c"},
     {file = "mpmath-1.3.0.tar.gz", hash = "sha256:7a28eb2a9774d00c7bc92411c19a89209d5da7c4c9a9e227be8330a23a25b91f"},
@@ -1711,48 +1713,7 @@ files = [
     {file = "numpy-1.26.4-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:7e50d0a0cc3189f9cb0aeb3a6a6af18c16f59f004b866cd2be1c14b36134a4a0"},
     {file = "numpy-1.26.4.tar.gz", hash = "sha256:2a02aba9ed12e4ac4eb3ea9421c420301a0c6460d9830d74a9df87efa4912010"},
 ]
-
-[[package]]
-name = "onnxruntime"
-version = "1.24.3"
-description = "ONNX Runtime is a runtime accelerator for Machine Learning models"
-optional = false
-python-versions = ">=3.10"
-groups = ["server", "test"]
-markers = "python_version == \"3.10\""
-files = [
-    {file = "onnxruntime-1.24.3-cp311-cp311-macosx_14_0_arm64.whl", hash = "sha256:3e6456801c66b095c5cd68e690ca25db970ea5202bd0c5b84a2c3ef7731c5a3c"},
-    {file = "onnxruntime-1.24.3-cp311-cp311-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:8b2ebc54c6d8281dccff78d4b06e47d4cf07535937584ab759448390a70f4978"},
-    {file = "onnxruntime-1.24.3-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:fb56575d7794bf0781156955610c9e651c9504c64d42ec880784b6106244882d"},
-    {file = "onnxruntime-1.24.3-cp311-cp311-win_amd64.whl", hash = "sha256:c958222ef9eff54018332beecd32d5d94a3ab079d8821937b333811bf4da0d39"},
-    {file = "onnxruntime-1.24.3-cp311-cp311-win_arm64.whl", hash = "sha256:a8f761857ebaf58a85b9e42422d03207f1d39e6bb8fecfdbf613bac5b9710723"},
-    {file = "onnxruntime-1.24.3-cp312-cp312-macosx_14_0_arm64.whl", hash = "sha256:0d244227dc5e00a9ae15a7ac1eba4c4460d7876dfecafe73fb00db9f1d914d91"},
-    {file = "onnxruntime-1.24.3-cp312-cp312-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:0a9847b870b6cb462652b547bc98c49e0efb67553410a082fde1918a38707452"},
-    {file = "onnxruntime-1.24.3-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b354afce3333f2859c7e8706d84b6c552beac39233bcd3141ce7ab77b4cabb5d"},
-    {file = "onnxruntime-1.24.3-cp312-cp312-win_amd64.whl", hash = "sha256:44ea708c34965439170d811267c51281d3897ecfc4aa0087fa25d4a4c3eb2e4a"},
-    {file = "onnxruntime-1.24.3-cp312-cp312-win_arm64.whl", hash = "sha256:48d1092b44ca2ba6f9543892e7c422c15a568481403c10440945685faf27a8d8"},
-    {file = "onnxruntime-1.24.3-cp313-cp313-macosx_14_0_arm64.whl", hash = "sha256:34a0ea5ff191d8420d9c1332355644148b1bf1a0d10c411af890a63a9f662aa7"},
-    {file = "onnxruntime-1.24.3-cp313-cp313-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1fd2ec7bb0fabe42f55e8337cfc9b1969d0d14622711aac73d69b4bd5abb5ed7"},
-    {file = "onnxruntime-1.24.3-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:df8e70e732fe26346faaeec9147fa38bef35d232d2495d27e93dd221a2d473a9"},
-    {file = "onnxruntime-1.24.3-cp313-cp313-win_amd64.whl", hash = "sha256:2d3706719be6ad41d38a2250998b1d87758a20f6ea4546962e21dc79f1f1fd2b"},
-    {file = "onnxruntime-1.24.3-cp313-cp313-win_arm64.whl", hash = "sha256:b082f3ba9519f0a1a1e754556bc7e635c7526ef81b98b3f78da4455d25f0437b"},
-    {file = "onnxruntime-1.24.3-cp313-cp313t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:72f956634bc2e4bd2e8b006bef111849bd42c42dea37bd0a4c728404fdaf4d34"},
-    {file = "onnxruntime-1.24.3-cp313-cp313t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:78d1f25eed4ab9959db70a626ed50ee24cf497e60774f59f1207ac8556399c4d"},
-    {file = "onnxruntime-1.24.3-cp314-cp314-macosx_14_0_arm64.whl", hash = "sha256:a6b4bce87d96f78f0a9bf5cefab3303ae95d558c5bfea53d0bf7f9ea207880a8"},
-    {file = "onnxruntime-1.24.3-cp314-cp314-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:d48f36c87b25ab3b2b4c88826c96cf1399a5631e3c2c03cc27d6a1e5d6b18eb4"},
-    {file = "onnxruntime-1.24.3-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:e104d33a409bf6e3f30f0e8198ec2aaf8d445b8395490a80f6e6ad56da98e400"},
-    {file = "onnxruntime-1.24.3-cp314-cp314-win_amd64.whl", hash = "sha256:e785d73fbd17421c2513b0bb09eb25d88fa22c8c10c3f5d6060589efa5537c5b"},
-    {file = "onnxruntime-1.24.3-cp314-cp314-win_arm64.whl", hash = "sha256:951e897a275f897a05ffbcaa615d98777882decaeb80c9216c68cdc62f849f53"},
-    {file = "onnxruntime-1.24.3-cp314-cp314t-manylinux_2_27_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:4d4e70ce578aa214c74c7a7a9226bc8e229814db4a5b2d097333b81279ecde36"},
-    {file = "onnxruntime-1.24.3-cp314-cp314t-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:02aaf6ddfa784523b6873b4176a79d508e599efe12ab0ea1a3a6e7314408b7aa"},
-]
-
-[package.dependencies]
-flatbuffers = "*"
-numpy = ">=1.21.6"
-packaging = "*"
-protobuf = "*"
-sympy = "*"
+markers = {server = "python_version >= \"3.11\"", test = "python_version >= \"3.11\""}
 
 [[package]]
 name = "onnxruntime"
@@ -1807,6 +1768,7 @@ files = [
     {file = "packaging-26.1-py3-none-any.whl", hash = "sha256:5d9c0669c6285e491e0ced2eee587eaf67b670d94a19e94e3984a481aba6802f"},
     {file = "packaging-26.1.tar.gz", hash = "sha256:f042152b681c4bfac5cae2742a55e103d27ab2ec0f3d88037136b6bfe7c9c5de"},
 ]
+markers = {server = "python_version >= \"3.11\""}
 
 [[package]]
 name = "pandas"
@@ -1875,9 +1837,9 @@ files = [
 
 [package.dependencies]
 numpy = [
-    {version = ">=1.22.4", markers = "python_version < \"3.11\""},
     {version = ">=1.26.0", markers = "python_version >= \"3.12\""},
     {version = ">=1.23.2", markers = "python_version == \"3.11\""},
+    {version = ">=1.22.4", markers = "python_version < \"3.11\""},
 ]
 python-dateutil = ">=2.8.2"
 pytz = ">=2020.1"
@@ -2115,6 +2077,7 @@ description = ""
 optional = false
 python-versions = ">=3.10"
 groups = ["server", "test"]
+markers = "python_version >= \"3.11\""
 files = [
     {file = "protobuf-7.34.1-cp310-abi3-macosx_10_9_universal2.whl", hash = "sha256:d8b2cc79c4d8f62b293ad9b11ec3aebce9af481fa73e64556969f7345ebf9fc7"},
     {file = "protobuf-7.34.1-cp310-abi3-manylinux2014_aarch64.whl", hash = "sha256:5185e0e948d07abe94bb76ec9b8416b604cfe5da6f871d67aad30cbf24c3110b"},
@@ -2145,7 +2108,7 @@ description = "C parser in Python"
 optional = false
 python-versions = ">=3.10"
 groups = ["main"]
-markers = "(implementation_name == \"pypy\" or platform_python_implementation != \"PyPy\") and implementation_name != \"PyPy\""
+markers = "(platform_python_implementation != \"PyPy\" or implementation_name == \"pypy\") and implementation_name != \"PyPy\""
 files = [
     {file = "pycparser-3.0-py3-none-any.whl", hash = "sha256:b727414169a36b7d524c1c3e31839a521725078d7b2ff038656844266160a992"},
     {file = "pycparser-3.0.tar.gz", hash = "sha256:600f49d217304a5902ac3c37e1281c9fe94e4d0489de643a9504c5cdfdfc6b29"},
@@ -2349,9 +2312,9 @@ files = [
 astroid = ">=3.3.8,<=3.4.0.dev0"
 colorama = {version = ">=0.4.5", markers = "sys_platform == \"win32\""}
 dill = [
-    {version = ">=0.2", markers = "python_version < \"3.11\""},
     {version = ">=0.3.7", markers = "python_version >= \"3.12\""},
     {version = ">=0.3.6", markers = "python_version == \"3.11\""},
+    {version = ">=0.2", markers = "python_version < \"3.11\""},
 ]
 isort = ">=4.2.5,<5.13 || >5.13,<7"
 mccabe = ">=0.6,<0.8"
@@ -3273,6 +3236,7 @@ description = "Computer algebra system (CAS) in Python"
 optional = false
 python-versions = ">=3.9"
 groups = ["server", "test"]
+markers = "python_version >= \"3.11\""
 files = [
     {file = "sympy-1.14.0-py3-none-any.whl", hash = "sha256:e091cc3e99d2141a0ba2847328f5479b05d94a6635cb96148ccb3f34671bd8f5"},
     {file = "sympy-1.14.0.tar.gz", hash = "sha256:d3d3fe8df1e5a0b42f0e7bdf50541697dbe7d23746e894990c030e2b05e72517"},
@@ -3406,7 +3370,7 @@ files = [
     {file = "typing_extensions-4.15.0-py3-none-any.whl", hash = "sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548"},
     {file = "typing_extensions-4.15.0.tar.gz", hash = "sha256:0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466"},
 ]
-markers = {main = "python_version <= \"3.12\"", dev = "python_version == \"3.10\"", docs = "python_version <= \"3.12\""}
+markers = {main = "python_version < \"3.13\"", dev = "python_version == \"3.10\"", docs = "python_version < \"3.13\""}
 
 [[package]]
 name = "typing-inspection"
@@ -3760,4 +3724,4 @@ files = [
 [metadata]
 lock-version = "2.1"
 python-versions = ">=3.10"
-content-hash = "1f3e922366bf38e42d8c7b839519e921ff9b3ffcb6d46dd5ebf1f59607ccf91c"
+content-hash = "720436f5f3d6651c298cf9fdc2f15ba40dcda6a70b09ba6aefa39ae119ba8ee0"
diff --git a/pyproject.toml b/pyproject.toml
index fea1ee5..095f647 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -88,7 +88,7 @@ pytest = "^8.0.0"
 tox = "^4.19.0"
 fastapi = ">=0.111,<1.0"
 uvicorn = {version = ">=0.29,<1.0", extras = ["standard"]}
-onnxruntime = ">=1.17,<2.0"
+onnxruntime = {version = ">=1.17,<2.0", python = ">=3.11"}
 httpx = ">=0.27,<1.0"
 
 [tool.poetry.group.docs.dependencies]
@@ -122,7 +122,7 @@ ria-agent = "ria_toolkit_oss.agent:main"
 [tool.poetry.group.server.dependencies]
 fastapi = ">=0.111,<1.0"
 uvicorn = {version = ">=0.29,<1.0", extras = ["standard"]}
-onnxruntime = ">=1.17,<2.0"
+onnxruntime = {version = ">=1.17,<2.0", python = ">=3.11"}
 
 [tool.black]
 line-length = 119
diff --git a/tests/remote_control/test_remote_transmitter.py b/tests/remote_control/test_remote_transmitter.py
index e6a0940..f7ec055 100644
--- a/tests/remote_control/test_remote_transmitter.py
+++ b/tests/remote_control/test_remote_transmitter.py
@@ -62,14 +62,18 @@ class TestSetRadio:
     def test_hackrf_alias(self):
         tx = RemoteTransmitter()
         mock_sdr = _make_mock_sdr()
-        with patch("ria_toolkit_oss.sdr.hackrf.HackRF", return_value=mock_sdr):
+        mock_module = MagicMock()
+        mock_module.HackRF = MagicMock(return_value=mock_sdr)
+        with patch.dict("sys.modules", {"ria_toolkit_oss.sdr.hackrf": mock_module}):
             tx.set_radio("hackrf", "")
         assert tx._sdr is mock_sdr
 
     def test_hackrf_one_alias(self):
         tx = RemoteTransmitter()
         mock_sdr = _make_mock_sdr()
-        with patch("ria_toolkit_oss.sdr.hackrf.HackRF", return_value=mock_sdr):
+        mock_module = MagicMock()
+        mock_module.HackRF = MagicMock(return_value=mock_sdr)
+        with patch.dict("sys.modules", {"ria_toolkit_oss.sdr.hackrf": mock_module}):
             tx.set_radio("hackrf_one", "")
         assert tx._sdr is mock_sdr